Base de dados de quirks ZHA
Uma quirk ensina ZHA como um dispositivo que não segue o padrão Zigbee realmente se comporta – sem uma, um termostato Tuya ou um sensor Aqara muitas vezes aparece com entidades faltantes ou erradas. Para cada dispositivo que vês a quirk a usar e de onde vem: uma que vem com ZHA, uma proposta mas ainda não mesclada, ou uma quirk personalizada que pessoas partilharam no rastreador de problemas.
1.035 dispositivos encontrados
-
Aqara DWZTCGQ11LM também em Zigbee2MQTT · 1 relatório aberto
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Contact Device mode Door/window type Sensitivity Report interval Movement detection Vibration detection Fall detection Orientation detection Triple tap detection +2
Fonte: zha-device-handlers · Pull Request #5134 · por @thenoakes · 30 de Junho, 2026
Assinatura:Aqara/lumi.vibration.agl002 -
SONOFF SNZB-04PR2 Porta & janela · também em Zigbee2MQTT
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Tamper
Fonte: zha-device-handlers · Pull Request #5131 · por @phipz · 29 de Junho, 2026 · 1 aprovação
Assinatura:eWeLink/SNZB-04PR23 mais quirks para este dispositivo
-
Quirk proposto, ainda não mesclado
SONOFF/SNZB-04PR2zha-device-handlers · Pull Request #5131 · por @phipz · 29 de Junho, 2026 · 1 aprovação -
Quirk proposto, ainda não mesclado
eWeLink/SNZB-04PR2zha-device-handlers · Pull Request #4263 · por @laity-w-sudo · 14 de Agosto, 2025 -
Quirk proposto, ainda não mesclado
SONOFF/SNZB-04PR2zha-device-handlers · Pull Request #4263 · por @laity-w-sudo · 14 de Agosto, 2025
-
Quirk proposto, ainda não mesclado
-
Tuya TS0726_1_gang_scene_switch Botões & remotos · também em Zigbee2MQTT
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Backlight mode Indicator mode Power-on behavior Switch mode
Fonte: zha-device-handlers · Pull Request #5121 · por @RF1705 · 25 de Junho, 2026
Assinatura:_TZ3002_jn2x20tg/TS07261 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
_TZ3002_jn2x20tg/TS0726zha-device-handlers · Pull Request #4801 · por @rodillo69 · 1 de Março, 2026
-
Quirk proposto, ainda não mesclado
-
Tuya TS0726_2_gang_scene_switch Botões & remotos · também em Zigbee2MQTT · 1 relatório aberto
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Backlight mode Indicator mode Power-on behavior Switch mode
Fonte: zha-device-handlers · Pull Request #5121 · por @RF1705 · 25 de Junho, 2026
Assinatura:_TZ3002_zjuvw9zf/TS07261 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
_TZ3002_zjuvw9zf/TS0726zha-device-handlers · Pull Request #4801 · por @rodillo69 · 1 de Março, 2026
-
Quirk proposto, ainda não mesclado
-
Zemismart ZN-USC1U-HT Covers & blinds · também em Zigbee2MQTT
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Motor direction Set upper limit Set lower limit Delete upper limit Delete lower limit Delete all limits Motor steering Calibration time
Fonte: zha-device-handlers · Pull Request #5115 · por @tomer-cohen · 23 de Junho, 2026 · 1 aprovação
Assinatura:_TZE204_mpg22jc1/TS0601 -
SONOFF SWV-ZNU Água · também em Zigbee2MQTT
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Child lock Valve working Water shortage alarm Water leak alarm Frost protection Water shortage auto-close Water leak auto-close On time Off wait time Water shortage alarm duration +13
Fonte: zha-device-handlers · Pull Request #4927 · por @FraserKillip · 16 de Abril, 2026 · 4 aprovações
Assinatura:SONOFF/SWV-ZNU2 mais quirks para este dispositivo
-
Quirk proposto, ainda não mesclado
SONOFF/SWV-ZNUzha-device-handlers · Pull Request #5114 · por @laity-w-sudo · 23 de Junho, 2026 · 1 aprovação -
Quirk proposto, ainda não mesclado
SONOFF/SWV-ZNUzha-device-handlers · Pull Request #4993 · por @xiaoliu0001 · 12 de Maio, 2026
-
Quirk proposto, ainda não mesclado
-
SONOFF SWV-ZFU Água · também em Zigbee2MQTT
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Child lock Valve working Water shortage alarm Water leak alarm Frost protection Water shortage auto-close Water leak auto-close On time Off wait time Water shortage alarm duration +13
Fonte: zha-device-handlers · Pull Request #4927 · por @FraserKillip · 16 de Abril, 2026 · 4 aprovações
Assinatura:SONOFF/SWV-ZFU2 mais quirks para este dispositivo
-
Quirk proposto, ainda não mesclado
SONOFF/SWV-ZFUzha-device-handlers · Pull Request #5114 · por @laity-w-sudo · 23 de Junho, 2026 · 1 aprovação -
Quirk proposto, ainda não mesclado
SONOFF/SWV-ZFUzha-device-handlers · Pull Request #4993 · por @xiaoliu0001 · 12 de Maio, 2026
-
Quirk proposto, ainda não mesclado
-
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: 2.1 Capacity Units 3.1 Manual irrigation mode 3.2 Manual irrigation duration Single irrigation duration Single irrigation interval duration Single irrigation amount unit 3.3 Manual irrigation capacity 3.4 Manual irrigation capacity-failsafe time 5.1 CH1 Schedule irrigation plan index 5.2 CH1 Effective Year +58
Fonte: zha-device-handlers · Pull Request #5110 · por @yezi289 · 22 de Junho, 2026
Assinatura:SONOFF/SWV-ZF2E -
Tuya ZT08 Sensores climáticos · também em Zigbee2MQTT · 1 relatório aberto
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Temperature report interval Humidity report interval Display unit Temperature alarm Alarm temperature max Alarm temperature min Temperature sensitivity Humidity alarm Alarm humidity max Alarm humidity min +15
Fonte: zha-device-handlers · Pull Request #4941 · por @delneet · 22 de Abril, 2026
Assinatura:_TZE284_hodyryli/TS06012 mais quirks para este dispositivo
-
Quirk proposto, ainda não mesclado
_TZE284_hodyryli/TS0601zha-device-handlers · Pull Request #5094 · por @cablespaghetti · 16 de Junho, 2026 -
Quirk proposto, ainda não mesclado
_TZE284_hodyryli/TS0601zha-device-handlers · Pull Request #4520 · por @DesertRatUa · 25 de Novembro, 2025
-
Quirk proposto, ainda não mesclado
-
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Motor direction Set upper limit Set lower limit Delete upper limit Delete lower limit Delete all limits
Fonte: zha-device-handlers · Pull Request #5090 · por @nicolaspennesi · 13 de Junho, 2026
Assinatura:_TZE204_qbhze54q/TS0601 -
PushOk Hardware POK002_POK007 Sensores climáticos · também em Zigbee2MQTT
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Max moisture Soil moisture
Fonte: zha-device-handlers · Pull Request #5088 · por @FerrumLogic · 12 de Junho, 2026
Assinatura:PushOk Hardware/POK0021 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
PushOk Hardware/POK007zha-device-handlers · Pull Request #5088 · por @FerrumLogic · 12 de Junho, 2026
-
Quirk proposto, ainda não mesclado
-
PushOk Hardware POK006 Água · também em Zigbee2MQTT
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Valve status Stall time
Fonte: zha-device-handlers · Pull Request #5088 · por @FerrumLogic · 12 de Junho, 2026
Assinatura:PushOk Hardware/POK006 -
Aqara QBKG41LM Interruptores de parede · também em Zigbee2MQTT · 1 relatório aberto
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Fonte: zha-device-handlers · Pull Request #5087 · por @FerrumLogic · 12 de Junho, 2026
Assinatura:LUMI/lumi.switch.b2nc011 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
LUMI/lumi.switch.b2nc01zha-device-handlers · Pull Request #4982 · por @kiddyfurby · 7 de Maio, 2026
-
Quirk proposto, ainda não mesclado
-
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Fonte: zha-device-handlers · Pull Request #5086 · por @FerrumLogic · 12 de Junho, 2026
Assinatura:_TZ3000_kmh5qpmb/TS0202 -
Tongou TO-Q-SA1 Energia · também em Zigbee2MQTT · 2 relatórios abertos
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Device status Total energy Energy phase A Energy phase B Energy phase C Total power Total current Energy produced Total power factor Update frequency +29
Fonte: zha-device-handlers · Pull Request #5085 · por @e27182 · 11 de Junho, 2026
Assinatura:_TZE284_pglpvdar/TS06012 mais quirks para este dispositivo
-
Quirk proposto, ainda não mesclado
_TZE284_pglpvdar/TS0601zha-device-handlers · Pull Request #4807 · por @Andrew001207 · 3 de Março, 2026 -
Quirk proposto, ainda não mesclado
_TZE284_4hdbt6rn/TS0601zha-device-handlers · Pull Request #4807 · por @Andrew001207 · 3 de Março, 2026
-
Quirk proposto, ainda não mesclado
-
NEO NAS-AB02B0 Sensores climáticos · também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Adiciona: Alarm state Charging Alarm duration Siren on Tamper Alarm ringtone Enable tamper alarm Alarm mode Power type Alarm temperature min +6
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:_TZE200_d0yu2xgi/TS06013 mais quirks para este dispositivo
-
Quirk incluído em ZHA
_TYST11_d0yu2xgi/0yu2xgizha-device-handlers · desde zha-quirks 2.2.2 -
Quirk proposto, ainda não mesclado
_TZE200_d0yu2xgi/TS0601zha-device-handlers · Pull Request #5080 · por @Niek · 10 de Junho, 2026 · 1 aprovação -
Quirk proposto, ainda não mesclado
_TYST11_d0yu2xgi/0yu2xgizha-device-handlers · Pull Request #5080 · por @Niek · 10 de Junho, 2026 · 1 aprovação
-
Quirk incluído em ZHA
-
NEO NAS-AB02B2 também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Adiciona: Alarm state Charging Alarm duration Siren on Tamper Alarm ringtone Enable tamper alarm Alarm mode Power type Alarm temperature min +6
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:_TZE200_t1blo2bj/TS06015 mais quirks para este dispositivo
-
Quirk incluído em ZHA
_TZE204_t1blo2bj/TS0601zha-device-handlers · desde zha-quirks 2.2.2 -
Quirk incluído em ZHA
_TZE204_q76rtoa9/TS0601zha-device-handlers · desde zha-quirks 2.2.2 -
Quirk proposto, ainda não mesclado
_TZE200_t1blo2bj/TS0601zha-device-handlers · Pull Request #5080 · por @Niek · 10 de Junho, 2026 · 1 aprovação -
Quirk proposto, ainda não mesclado
_TZE204_t1blo2bj/TS0601zha-device-handlers · Pull Request #5080 · por @Niek · 10 de Junho, 2026 · 1 aprovação -
Quirk proposto, ainda não mesclado
_TZE204_q76rtoa9/TS0601zha-device-handlers · Pull Request #5080 · por @Niek · 10 de Junho, 2026 · 1 aprovação
-
Quirk incluído em ZHA
-
Tuya ZA03 Fumo e segurança · também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Adiciona: Alarm state Charging Alarm duration Siren on Tamper Alarm ringtone Enable tamper alarm Alarm mode Power type Alarm temperature min +6
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:_TZE204_hcxvyxa5/TS06011 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
_TZE204_hcxvyxa5/TS0601zha-device-handlers · Pull Request #5080 · por @Niek · 10 de Junho, 2026 · 1 aprovação
-
Quirk proposto, ainda não mesclado
-
NEO NAS-AB06B2 também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Adiciona: Alarm state Charging Alarm duration Siren on Tamper Alarm ringtone Enable tamper alarm Alarm mode Power type Alarm temperature min +6
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:_TZE204_nlrfgpny/TS06013 mais quirks para este dispositivo
-
Quirk incluído em ZHA
_TZE284_nlrfgpny/TS0601zha-device-handlers · desde zha-quirks 2.2.2 -
Quirk proposto, ainda não mesclado
_TZE204_nlrfgpny/TS0601zha-device-handlers · Pull Request #5080 · por @Niek · 10 de Junho, 2026 · 1 aprovação -
Quirk proposto, ainda não mesclado
_TZE284_nlrfgpny/TS0601zha-device-handlers · Pull Request #5080 · por @Niek · 10 de Junho, 2026 · 1 aprovação
-
Quirk incluído em ZHA
-
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Adiciona: Alarm state Charging Alarm duration Siren on Tamper Alarm ringtone Enable tamper alarm Alarm mode Power type Alarm temperature min +6
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:TZE200_nlrfgpny/TS06011 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
TZE200_nlrfgpny/TS0601zha-device-handlers · Pull Request #5080 · por @Niek · 10 de Junho, 2026 · 1 aprovação
-
Quirk proposto, ainda não mesclado
-
Tuya YXZBSL Fumo e segurança · também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Adiciona: Alarm state Charging Alarm duration Siren on Tamper Alarm ringtone Enable tamper alarm Alarm mode Power type Alarm temperature min +6
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:_TZE204_k7mfgaen/TS06013 mais quirks para este dispositivo
-
Quirk incluído em ZHA
_TZE204_fncxk3ob/TS0601zha-device-handlers · desde zha-quirks 2.2.2 -
Quirk proposto, ainda não mesclado
_TZE204_k7mfgaen/TS0601zha-device-handlers · Pull Request #5080 · por @Niek · 10 de Junho, 2026 · 1 aprovação -
Quirk proposto, ainda não mesclado
_TZE204_fncxk3ob/TS0601zha-device-handlers · Pull Request #5080 · por @Niek · 10 de Junho, 2026 · 1 aprovação
-
Quirk incluído em ZHA
-
Moes ZS-D1 Interruptores de parede · também em Zigbee2MQTT
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Fonte: zha-device-handlers · Pull Request #5078 · por @gordoasan · 10 de Junho, 2026
Assinatura:_TZE200_a1ovdobn/TS06011 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
_TZE284_a1ovdobn/TS0601zha-device-handlers · Pull Request #5078 · por @gordoasan · 10 de Junho, 2026
-
Quirk proposto, ainda não mesclado
-
Tuya TS110E_2gang_2 Interruptores de parede · também em Zigbee2MQTT · 2 relatórios abertos
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Fonte: zha-device-handlers · Pull Request #5077 · por @WBNet-Wout · 9 de Junho, 2026
Assinatura:_TZ3210_pagajpog/TS110E -
Quirk proposto, ainda não mesclado Quirk recomendado
Proposto à ZHA e aguardando revisão – os mantenedores verificam antes que ela se torne parte do Home Assistant.
Adiciona: Remote mode
Fonte: zha-device-handlers · Pull Request #5073 · por @Alpacay · 9 de Junho, 2026
Assinatura:Repenic Ltd./RS-R03AZG
Utilizar um quirk personalizado
-
Tell ZHA where custom quirks are kept – in configuration.yaml:
zha: custom_quirks_path: /config/custom_zha_quirks/ - Crie essa pasta e salve o quirk como um ficheiro .py nela.
- Reinicie o Home Assistant. Se o dispositivo foi emparelhado antes, reconfigure-o ou remova-o e emparelhe-o novamente para que o quirk seja aplicado.
- Check it worked: the device page shows the quirk under Zigbee info.
Um quirk personalizado não foi analisado pelos mantenedores do ZHA. Apaga o ficheiro uma vez que o quirk é parte de uma versão Home Assistant – caso contrário, a cópia antiga tem precedência.
Fontes: zha-device-handlers no GitHub – a última versão, os pedidos de pull abertos e os problemas. Apenas quais dispositivos uma quirk se aplica, quais entidades ela adiciona, quem a partilhou e quantas pessoas concordaram são lidos; o código permanece no GitHub. A recomendação prefere uma quirk que vem com a ZHA, depois uma proposta, depois a quirk personalizada com mais aprovações.
