{"id":360,"date":"2026-07-14T21:48:16","date_gmt":"2026-07-15T00:48:16","guid":{"rendered":"https:\/\/www.bernabauer.com\/blog\/faca-o-zbcmr-01-ser-reconhecido-pelo-zigbee2mqtt\/"},"modified":"2026-07-14T21:48:16","modified_gmt":"2026-07-15T00:48:16","slug":"faca-o-zbcmr-01-ser-reconhecido-pelo-zigbee2mqtt","status":"publish","type":"post","link":"https:\/\/www.bernabauer.com\/blog\/faca-o-zbcmr-01-ser-reconhecido-pelo-zigbee2mqtt\/","title":{"rendered":"Fa\u00e7a o ZBCMR-01 ser reconhecido pelo Zigbee2MQTT"},"content":{"rendered":"

Recentemente comprei um motor de persiana inteligente Nova Digital ZBCMR-01, mas ao tentar adicioná\u2011lo ao Zigbee2MQTT ele apareceu como “não suportado. O motivo é simples: o modelo que comprei tem um fingerprint diferente do que está cadastrado na base de dados do z2m. Neste post mostro como contornar o problema usando um conversor externo, passo a passo, e ainda como enviar a correção para que todos se beneficiem.<\/p>\n<\/p>\n

Se você já viu a mensagem de dispositivo não suportado, não desista: a solução está em habilitar os conversores externos e criar um arquivo pequeno que mapeia o fingerprint do seu lote.<\/p>\n

Por que o ZBCMR-01 não é reconhecido?<\/h2>\n

A página do Zigbee2MQTT para o ZBCMR-01<\/a> lista o modelo como suportado, mas o fingerprint cadastrado é zigbeeModel: TS0105 + manufacturerName: _TZE600_ogyg1y6b. Seu módulo, de um lote diferente, se identifica como TS0601 + _TZE284_5blghqkp, uma combinação que ainda não está na base de dados, portanto o z2m recusa o dispositivo mesmo sendo “o mesmo produto”.<\/p>\n

Passo a passo para adicionar o conversor externo<\/h2>\n
    \n
  1. Verifique a versão do z2m<\/strong> – Acesse Settings > About. Se estiver desatualizado, atualize (geralmente não resolve sozinho, mas vale testar). Fonte principal<\/a>.<\/li>\n
  2. Habilite conversores externos<\/strong> (necessário a partir da v2.11). Em configuration.yaml (do z2m e não do Home Assistant. Acesse por tanto o arquivo \/root\/config\/zigbee2mqtt\/configuration.yaml) confirme ou adicione:
    \n

    advanced:
       enable_external_js: true<\/p><\/blockquote>\n

    É provável que já exista uma seção chamada “advanced”. Depois reinicie o z2m. Mais detalhes<\/a>.<\/li>\n

  3. Adicione o conversor externo<\/strong> – O jeito mais fácil é pelo frontend: Settings > Dev console > External converters. Crie um arquivo, por exemplo nova-zbcmr01.mjs<\/em>, com o seguinte conteúdo:
    \n
    \n

    import * as legacy from ‘zigbee-herdsman-converters\/lib\/legacy’;
    import * as exposes from ‘zigbee-herdsman-converters\/lib\/exposes’;
    import * as tuya from ‘zigbee-herdsman-converters\/lib\/tuya’;<\/p>\n

    const e = exposes.presets;
    const ea = exposes.access;<\/p>\n

    export default {
        fingerprint: tuya.fingerprint(‘TS0601’, [‘_TZE284_5blghqkp’]),
        model: ‘ZBCMR-01’,
        vendor: ‘Nova Digital’,
        description: ‘Roller Blind Motor (lote TS0601)’,
        fromZigbee: [legacy.fromZigbee.tuya_cover],
        toZigbee: [legacy.toZigbee.tuya_cover_control],
        exposes: [e.cover_position().setAccess(‘position’, ea.STATE_SET)],
    };<\/p>\n<\/blockquote>\n

    Se preferir, salve o arquivo diretamente na pasta external_converters\/ (irmã do configuration.yaml).<\/li>\n

  4. Reinicie o z2m e repareie<\/strong> – Vá em Settings > Tools > Restart Zigbee2MQTT. Se o dispositivo já estava listado como “unsupported”, remova-o e coloque\u2011o em modo de pareamento novamente (reset físico do motor + permitir entrada na rede).<\/li>\n
  5. Teste abrir\/fechar\/parar e posição<\/strong> – Use os comandos OPEN, CLOSE, STOP e ajuste a posição com valores de 0 a 100. Caso o comportamento esteja invertido ou a posição não seja reportada, ajuste o conversor (por exemplo, invertendo a posição) ou siga o guia de descoberta de DPs para Tuya (fonte complementar 3<\/a>).<\/li>\n
  6. Depois que funcionar<\/strong> – Abra uma issue “New device support” no repositório do Zigbee2MQTT (exemplo de issue<\/a>) anexando os dados da interview, para que esse fingerprint seja incorporado oficialmente e você não precise manter o conversor externo para sempre.<\/li>\n<\/ol>\n

    \"Interface
    Foto: Markus Winkler \/ Pexels<\/a><\/figcaption><\/figure>\n<\/p>\n

    Após seguir esses passos, seu motor deve aparecer na lista de dispositivos com as funcionalidades de abertura, fechamento, parada e controle de posição. Teste cada comando e confirme que os relatórios de estado estão corretos.<\/p>\n

    Testando e ajustando<\/h2>\n

    Como os Datapoints (DPs) da Tuya podem variar entre lotes, vale observar o log do z2m enquanto aciona o motor. Se notar que a posição está invertida, basta mudar a linha exposes: [e.cover_position().setAccess(‘position’, ea.STATE_SET)] para usar exposes: [e.cover_position().setAccess(‘position’, ea.STATE_SET)] com a opção invert_cover: true na configuração do dispositivo, ou ajustar o conversor para mapear o DP correto. Se precisar de ajuda com o mapeamento de DPs, consulte o guia detalhado de suporte a novos dispositivos Tuya (fonte complementar 3<\/a>).<\/p>\n

    Contribuindo para a base oficial<\/h2>\n

    Quando tudo estiver funcionando, considere devolver à comunidade. Abra uma pull request no repositório zigbee-herdsman-converters<\/a> ou uma issue no zigbee2mqtt<\/a> com o fingerprint e a descrição do seu lote. Assim, o suporte será integrado nas próximas versões e você poderá remover o conversor externo.<\/p>\n","protected":false},"excerpt":{"rendered":"

    Aprenda a adicionar suporte ao motor de persiana ZBCMR-01 com lote TS0601 usando um conversor externo no Zigbee2MQTT e contribua para a base oficial.<\/p>\n","protected":false},"author":2,"featured_media":359,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[6],"tags":[116,117,115,114],"class_list":["post-360","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-automacao","tag-conversor-externo","tag-tuya","tag-zbcmr-01","tag-zigbee2mqtt"],"jetpack_featured_media_url":"https:\/\/www.bernabauer.com\/blog\/wp-content\/uploads\/2026\/07\/faca-o-zbcmr-01-ser-reconhecido-pelo-zigbee2mqtt-featured.jpg","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/posts\/360","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/comments?post=360"}],"version-history":[{"count":0,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/posts\/360\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/media\/359"}],"wp:attachment":[{"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/media?parent=360"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/categories?post=360"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/tags?post=360"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}