{"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-08-16T18:18:28","modified_gmt":"2026-08-16T21:18:28","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":"\n

Recentemente comprei um motor de persiana inteligente Nova Digital ZBCMR-01, mas ao tentar adicion\u00e1\u2011lo ao Zigbee2MQTT ele apareceu como “n\u00e3o suportado. O motivo \u00e9 simples: o modelo que comprei tem um fingerprint diferente do que est\u00e1 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\u00e7\u00e3o para que todos se beneficiem.<\/p>\n\n\n\n

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

Por que o ZBCMR-01 n\u00e3o \u00e9 reconhecido?<\/h2>\n\n\n\n

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

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

    advanced:

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

    \u00c9 prov\u00e1vel que j\u00e1 exista uma se\u00e7\u00e3o chamada “advanced”. Depois reinicie o z2m. Mais detalhes<\/a>.<\/p><\/li>\n\n\n\n

  3. Adicione o conversor externo<\/strong> \u2013 O jeito mais f\u00e1cil \u00e9 pelo frontend: Settings > Dev console > External converters. Crie um arquivo, por exemplo nova-zbcmr01.mjs<\/em>, com o seguinte conte\u00fado:

    \n\n\/\/ Nova Digital ZBCMR-01 - external converter for Zigbee2MQTT
    \n\/\/ Made by bernabauer.com
    \n\/\/ https:\/\/www.bernabauer.com\/blog\/faca-o-zbcmr-01-ser-reconhecido-pelo-zigbee2mqtt\/
    \n\/\/ Version: 1.0
    \n
    \nimport * as exposes from 'zigbee-herdsman-converters\/lib\/exposes';
    \nimport * as tuya from 'zigbee-herdsman-converters\/lib\/tuya';
    \n
    \nconst e = exposes.presets;
    \nconst ea = exposes.access;
    \n
    \n\/\/ DP1 - Control command. Values: 0=OPEN, 1=STOP, 2=CLOSE, 3=CONTINUE (never observed in practice).
    \n\/\/ Confirmed reliable for both read and write.
    \nconst coverState = {
    \n    to: (v) => {
    \n        const map = {OPEN: new tuya.Enum(0), STOP: new tuya.Enum(1), CLOSE: new tuya.Enum(2), CONTINUE: new tuya.Enum(3)};
    \n        return map[v];
    \n    },
    \n    from: (v) => {
    \n        const map = {0: 'OPEN', 1: 'STOP', 2: 'CLOSE', 3: 'CONTINUE'};
    \n        return map[v];
    \n    },
    \n};
    \n
    \n\/\/ DP3 - Direction of the last movement command. Values: 0=opening, 1=closing.
    \n\/\/ Confirmed via 14+ direct correlations. Does not indicate whether movement
    \n\/\/ is still in progress, and stays unchanged when a STOP command is sent
    \n\/\/ mid-travel (no distinct \"stopped\" value observed). Read-only.
    \nconst direction = {
    \n    from: (v) => (v === 0 ? 'opening' : 'closing'),
    \n};
    \n
    \n\/\/ DP8 - Real position report (%). Values: 0-100. Confirmed live during real
    \n\/\/ motor movement. Read-only: writing here has no effect (tested - no error,
    \n\/\/ no echo, no movement). Use DP9 to command a target position.
    \nconst coverPositionReport = {
    \n    from: (v, meta, options, publish) => {
    \n        publish({state: v === 0 ? 'CLOSE' : 'OPEN', position_report: v});
    \n        return v;
    \n    },
    \n};
    \n
    \n\/\/ DP9 - Target position command (%). Values: 0-100. Confirmed: writing here
    \n\/\/ moves the motor to the exact percentage, later reflected on DP8. Same
    \n\/\/ set\/report split as the sibling \"ZSM-01\" (Novato) device in the official
    \n\/\/ library. Listed BEFORE DP8 in tuyaDatapoints so writes to 'position' route
    \n\/\/ here (tz.datapoints picks the first array entry matching the property).
    \nconst coverPositionSet = {
    \n    to: (v) => v,
    \n};
    \n
    \n\/\/ DP11 - Inverts the cover position scale. Confirmed live: default (false)
    \n\/\/ leaves the motor as-is; writing 'false' while already false triggered a
    \n\/\/ resync that opened the motor fully. Do not write unless intentionally
    \n\/\/ changing the inversion - it moves the motor to resync.
    \nconst invertCover = {
    \n    to: (v) => v,
    \n    from: (v) => v,
    \n};
    \n
    \n\/\/ DP19 - Favorite position (%). Confirmed live: writing here does not move
    \n\/\/ the motor immediately, just stores the value (motor beeps to confirm the
    \n\/\/ save). Matches \"favorite_position\" on the sibling ZSM-01 device (same
    \n\/\/ value type: numeric 0-100, write-only). No recall\/goto trigger found for
    \n\/\/ it - not even in the official ZSM-01 definition.
    \nconst favoritePosition = {
    \n    to: (v) => v,
    \n    from: (v) => v,
    \n};
    \n
    \n\/\/ DP20 - Click control (step nudge). Values: up=0, down=1. Confirmed live:
    \n\/\/ \"down\" triggered a brief CLOSE that auto-stopped after ~1s (a small nudge),
    \n\/\/ matching \"click_control\" on the sibling ZSM-01 device. Exposed as two
    \n\/\/ single-value enums (button entities in HA) instead of one two-value enum
    \n\/\/ (which HA renders as a dropdown) - matches the cover's own open\/close buttons.
    \nconst nudgeUp = {
    \n    to: () => new tuya.Enum(0),
    \n};
    \nconst nudgeDown = {
    \n    to: () => new tuya.Enum(1),
    \n};
    \n
    \nexport default {
    \n    fingerprint: tuya.fingerprint('TS0601', ['_TZE284_5blghqkp']),
    \n    model: 'ZBCMR-01',
    \n    vendor: 'Nova Digital',
    \n    description: 'Roller Blind Motor (TS0601 batch)',
    \n    extend: [tuya.modernExtend.tuyaBase({dp: true, queryOnConfigure: true})],
    \n    exposes: [
    \n        e.cover_position().setAccess('position', ea.STATE_SET),
    \n        e.enum('direction', ea.STATE, ['opening', 'closing']).withDescription(
    \n            'DP3 - Direction of the last movement command (0=opening, 1=closing). '
    \n            + 'Does not indicate whether movement is still in progress.',
    \n        ).withHomeAssistant({icon: 'mdi:arrow-up-down-bold'}),
    \n        e.binary('invert_cover', ea.STATE_SET, true, false).withLabel('Invert Cover Position').withDescription(
    \n            \"DP11 - Inverts the cover position, false: open=100,close=0, true: open=0,close=100 \"
    \n            + \"(default false). The value must be `true` or `false`\",
    \n        ).withHomeAssistant({icon: 'mdi:swap-vertical'}),
    \n        e.numeric('favorite_position', ea.STATE_SET).withValueMin(0).withValueMax(100).withDescription(
    \n            'DP19 - Stores a favorite position (%). Does not move the motor immediately.',
    \n        ).withHomeAssistant({entityCategory: 'config'}),
    \n        e.numeric('position_report', ea.STATE).withUnit('%').withDescription(
    \n            'DP8 - Raw position report, mirrors the cover position as a standalone sensor.',
    \n        ).withHomeAssistant({icon: 'mdi:roller-shade'}),
    \n        e.enum('nudge_up', ea.STATE_SET, ['PRESS']).withLabel('Nudge up').withDescription(
    \n            'DP20 - Step nudge up: triggers a brief OPEN movement that auto-stops after ~1s.',
    \n        ).withHomeAssistant({icon: 'mdi:chevron-up'}),
    \n        e.enum('nudge_down', ea.STATE_SET, ['PRESS']).withLabel('Nudge down').withDescription(
    \n            'DP20 - Step nudge down: triggers a brief CLOSE movement that auto-stops after ~1s.',
    \n        ).withHomeAssistant({icon: 'mdi:chevron-down'}),
    \n    ],
    \n    meta: {
    \n        tuyaDatapoints: [
    \n            [1, 'state', coverState],
    \n            [3, 'direction', direction],
    \n            [9, 'position', coverPositionSet],
    \n            [8, 'position', coverPositionReport],
    \n            [11, 'invert_cover', invertCover],
    \n            [19, 'favorite_position', favoritePosition],
    \n            [20, 'nudge_up', nudgeUp],
    \n            [20, 'nudge_down', nudgeDown],
    \n        ],
    \n    },
    \n};<\/code>

    \n\n

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

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

    Ap\u00f3s seguir esses passos, seu motor deve aparecer na lista de dispositivos com as funcionalidades de abertura, fechamento, parada e controle de posi\u00e7\u00e3o. Teste cada comando e confirme que os relat\u00f3rios de estado est\u00e3o corretos.<\/p>\n\n\n\n

    Testando e ajustando<\/h2>\n\n\n\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\u00e7\u00e3o est\u00e1 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\u00e7\u00e3o invert_cover: true na configura\u00e7\u00e3o 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\n\n\n

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

    Quando tudo estiver funcionando, considere devolver \u00e0 comunidade. Abra uma pull request no reposit\u00f3rio zigbee-herdsman-converters<\/a> ou uma issue no zigbee2mqtt<\/a> com o fingerprint e a descri\u00e7\u00e3o do seu lote. Assim, o suporte ser\u00e1 integrado nas pr\u00f3ximas vers\u00f5es e voc\u00ea poder\u00e1 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_sharing_enabled":true,"jetpack_featured_media_url":"https:\/\/www.bernabauer.com\/blog\/wp-content\/uploads\/2026\/07\/faca-o-zbcmr-01-ser-reconhecido-pelo-zigbee2mqtt-featured.jpg","_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":6,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/posts\/360\/revisions"}],"predecessor-version":[{"id":377,"href":"https:\/\/www.bernabauer.com\/blog\/wp-json\/wp\/v2\/posts\/360\/revisions\/377"}],"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}]}}