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
-
Mumubiz TYZGTH4CH-D1RF 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.
Fonte: zha-device-handlers · Pull Request #5180 · por @coder999 · 16 de Julho, 2026
Assinatura:_TZ3218_ya5d6wth/TS000F -
Tuya BLE-YL01 Energia · 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: pH Total dissolved solids Electrical conductivity Salt concentration ORP level Chlorine concentration pH calibration standard pH maximum value pH minimum value EC maximum value +10
Fonte: zha-device-handlers · Pull Request #5178 · por @Niek · 14 de Julho, 2026
Assinatura:_TZE200_v1jqz5cy/TS06011 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
_TZE200_v1jqz5cy/TS0601zha-device-handlers · Pull Request #3673 · por @danielp370 · 4 de Janeiro, 2025
-
Quirk proposto, ainda não mesclado
-
Tuya TS110E_1gang_2 Interruptores de parede · também em Zigbee2MQTT · 1 relatório aberto
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:_TZ3210_ngqk6jia/TS110E3 mais quirks para este dispositivo
-
Quirk proposto, ainda não mesclado
_TZ3210_k1msuvg6/TS110Ezha-device-handlers · Pull Request #5177 · por @vitek499 · 14 de Julho, 2026 -
Quirk proposto, ainda não mesclado
_TZ3210_ngqk6jia/TS110Ezha-device-handlers · Pull Request #5177 · por @vitek499 · 14 de Julho, 2026 -
Quirk proposto, ainda não mesclado
_TZ3210_ngqk6jia/TS110Ezha-device-handlers · Pull Request #5077 · por @WBNet-Wout · 9 de Junho, 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: 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 +2
Fonte: zha-device-handlers · Pull Request #5175 · por @Swissola · 13 de Julho, 2026
Assinatura:_TZE2841000000_0ints6wl/TS0601 -
Arteco ZS-300Z 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: 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 +10
Fonte: zha-device-handlers · Pull Request #4602 · por @ehbello · 28 de Dezembro, 2025 · 3 aprovações
Assinatura:Arteco/ZS-304Z8 mais quirks para este dispositivo
-
Quirk proposto, ainda não mesclado
_TZE284_0ints6wl/TS0601zha-device-handlers · Pull Request #5175 · por @Swissola · 13 de Julho, 2026 -
Quirk proposto, ainda não mesclado
_TZE284_0ints6wl/TS0601zha-device-handlers · Pull Request #5004 · por @duncangrist · 15 de Maio, 2026 -
Quirk proposto, ainda não mesclado
_TZE284_0ints6wl/TS0601zha-device-handlers · Pull Request #4987 · por @Hafpaf · 10 de Maio, 2026 -
Quirk proposto, ainda não mesclado
_TZE284_k7p2q5d9/TS0601zha-device-handlers · Pull Request #4941 · por @delneet · 22 de Abril, 2026 -
Quirk proposto, ainda não mesclado
_TZE284_65gzcss7/TS0601zha-device-handlers · Pull Request #4941 · por @delneet · 22 de Abril, 2026 -
Quirk proposto, ainda não mesclado
_TZE284_0ints6wl/TS0601zha-device-handlers · Pull Request #4941 · por @delneet · 22 de Abril, 2026 -
Quirk proposto, ainda não mesclado
_TZE284_yzr43ayq/TS0601zha-device-handlers · Pull Request #4941 · por @delneet · 22 de Abril, 2026 -
Quirk proposto, ainda não mesclado
Arteco/ZS-304Zzha-device-handlers · Pull Request #4599 · por @andrewjswan · 25 de Dezembro, 2025
-
Quirk proposto, ainda não mesclado
-
Aqara WS-USC04 Interruptores de parede · também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:LUMI/lumi.switch.b2naus011 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
LUMI/lumi.switch.b2naus01zha-device-handlers · Pull Request #5171 · por @puddly · 12 de Julho, 2026
-
Quirk proposto, ainda não mesclado
-
Aqara WXCJKG11LM Botões & remotos · também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:LUMI/lumi.remote.b286opcn011 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
LUMI/lumi.remote.b286opcn01zha-device-handlers · Pull Request #5171 · por @puddly · 12 de Julho, 2026
-
Quirk proposto, ainda não mesclado
-
Aqara WXCJKG12LM Botões & remotos · também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:LUMI/lumi.remote.b486opcn011 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
LUMI/lumi.remote.b486opcn01zha-device-handlers · Pull Request #5171 · por @puddly · 12 de Julho, 2026
-
Quirk proposto, ainda não mesclado
-
Aqara WXCJKG13LM Botões & remotos · também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:LUMI/lumi.remote.b686opcn011 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
LUMI/lumi.remote.b686opcn01zha-device-handlers · Pull Request #5171 · por @puddly · 12 de Julho, 2026
-
Quirk proposto, ainda não mesclado
-
Aqara CTP-R01 Botões & remotos · também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:LUMI/lumi.remote.cagl021 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
LUMI/lumi.remote.cagl02zha-device-handlers · Pull Request #5169 · por @fornellas · 12 de Julho, 2026
-
Quirk proposto, ainda não mesclado
-
Aqara MFKZQ01LM Botões & remotos · também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:LUMI/lumi.sensor_cube2 mais quirks para este dispositivo
-
Quirk incluído em ZHA
LUMI/lumi.sensor_cube.aqgl01zha-device-handlers · desde zha-quirks 2.2.2 -
Quirk proposto, ainda não mesclado
LUMI/lumi.sensor_cube.aqgl01zha-device-handlers · Pull Request #5169 · por @fornellas · 12 de Julho, 2026
-
Quirk incluído em ZHA
-
SONOFF MINI-ZB1GSP 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.
Adiciona: Power Current Voltage Energy today Energy this month Export energy today Export energy this month Total energy Total export energy Daily run time +18
Fonte: zha-device-handlers · Pull Request #5155 · por @040medien · 6 de Julho, 2026 · 5 aprovações
Assinatura:SONOFF/MINI-ZB1GSP -
SONOFF MINI-ZB1GP 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: Power Current Voltage Energy today Energy this month Export energy today Export energy this month Total energy Total export energy Daily run time +18
Fonte: zha-device-handlers · Pull Request #5155 · por @040medien · 6 de Julho, 2026 · 5 aprovações
Assinatura:SONOFF/MINI-ZB1GP -
Moes GM25TEQ-TYZ-2/25 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
Fonte: zha-device-handlers · Pull Request #5154 · por @barabum0 · 6 de Julho, 2026
Assinatura:_TZE204_xtrnjaoz/TS0601 -
Tuya TS0601_thermostat_1 Termostatos & TRV · 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: Boost heating Open window detection Child lock Boost time Min temperature Max temperature Eco switch deviation Valve position Window open Error +3
Fonte: zha-device-handlers · Pull Request #5151 · por @maksimvelbaum · 6 de Julho, 2026
Assinatura:_TZE200_a4bpgplm/TS06013 mais quirks para este dispositivo
-
Quirk proposto, ainda não mesclado
_TZE200_dv8abrrz/TS0601zha-device-handlers · Pull Request #5151 · por @maksimvelbaum · 6 de Julho, 2026 -
Quirk proposto, ainda não mesclado
_TZE200_z1tyspqw/TS0601zha-device-handlers · Pull Request #5151 · por @maksimvelbaum · 6 de Julho, 2026 -
Quirk proposto, ainda não mesclado
_TZE200_bvrlmajk/TS0601zha-device-handlers · Pull Request #5151 · por @maksimvelbaum · 6 de Julho, 2026
-
Quirk proposto, ainda não mesclado
-
SONOFF ZBM5-2C-120 Interruptores de parede · também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Adiciona: Work mode Detach relay 1 Detach relay 2 Detach relay 3
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:SONOFF/ZBM5-2C-80/865 mais quirks para este dispositivo
-
Quirk incluído em ZHA
SONOFF/ZBM5-2C-120zha-device-handlers · desde zha-quirks 2.2.2 -
Quirk proposto, ainda não mesclado
SONOFF/ZBM5-2C-80/86zha-device-handlers · Pull Request #5149 · por @JuliusZet · 5 de Julho, 2026 -
Quirk proposto, ainda não mesclado
SONOFF/ZBM5-2C-120zha-device-handlers · Pull Request #5149 · por @JuliusZet · 5 de Julho, 2026 -
Quirk proposto, ainda não mesclado
SONOFF/ZBM5-2C-80/86zha-device-handlers · Pull Request #5141 · por @TheJulianJES · 3 de Julho, 2026 -
Quirk proposto, ainda não mesclado
SONOFF/ZBM5-2C-120zha-device-handlers · Pull Request #5141 · por @TheJulianJES · 3 de Julho, 2026
-
Quirk incluído em ZHA
-
SONOFF ZBM5-3C-120 Interruptores de parede · também em Zigbee2MQTT · 1 relatório aberto
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Adiciona: Work mode Detach relay 1 Detach relay 2 Detach relay 3
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:SONOFF/ZBM5-3C-80/865 mais quirks para este dispositivo
-
Quirk incluído em ZHA
SONOFF/ZBM5-3C-120zha-device-handlers · desde zha-quirks 2.2.2 -
Quirk proposto, ainda não mesclado
SONOFF/ZBM5-3C-80/86zha-device-handlers · Pull Request #5149 · por @JuliusZet · 5 de Julho, 2026 -
Quirk proposto, ainda não mesclado
SONOFF/ZBM5-3C-120zha-device-handlers · Pull Request #5149 · por @JuliusZet · 5 de Julho, 2026 -
Quirk proposto, ainda não mesclado
SONOFF/ZBM5-3C-80/86zha-device-handlers · Pull Request #5141 · por @TheJulianJES · 3 de Julho, 2026 -
Quirk proposto, ainda não mesclado
SONOFF/ZBM5-3C-120zha-device-handlers · Pull Request #5141 · por @TheJulianJES · 3 de Julho, 2026
-
Quirk incluído em ZHA
-
SONOFF ZBM5-1C-120 Interruptores de parede · também em Zigbee2MQTT
Quirk incluído em ZHA Quirk recomendado
Parte do ZHA – Home Assistant usa-o sozinho, nada para instalar.
Adiciona: Work mode Detach relay 1 Detach relay 2 Detach relay 3
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:SONOFF/ZBM5-1C-80/865 mais quirks para este dispositivo
-
Quirk incluído em ZHA
SONOFF/ZBM5-1C-120zha-device-handlers · desde zha-quirks 2.2.2 -
Quirk proposto, ainda não mesclado
SONOFF/ZBM5-1C-80/86zha-device-handlers · Pull Request #5149 · por @JuliusZet · 5 de Julho, 2026 -
Quirk proposto, ainda não mesclado
SONOFF/ZBM5-1C-120zha-device-handlers · Pull Request #5149 · por @JuliusZet · 5 de Julho, 2026 -
Quirk proposto, ainda não mesclado
SONOFF/ZBM5-1C-80/86zha-device-handlers · Pull Request #5141 · por @TheJulianJES · 3 de Julho, 2026 -
Quirk proposto, ainda não mesclado
SONOFF/ZBM5-1C-120zha-device-handlers · Pull Request #5141 · por @TheJulianJES · 3 de Julho, 2026
-
Quirk incluído em ZHA
-
Aqara TH-S04D 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.
Fonte: zha-device-handlers · Pull Request #5146 · por @mlegner · 3 de Julho, 2026 · 3 aprovações
Assinatura:Aqara/lumi.sensor_ht.agl001 -
Heiman HS1SA-E Lover 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: Remote test Rebooted count Rejoined count Reported packages
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:HEIMAN/SmokeSensor-EF2-3.01 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
HEIMAN/SmokeSensor-EF2-3.0zha-device-handlers · Pull Request #5143 · por @TheJulianJES · 3 de Julho, 2026
-
Quirk proposto, ainda não mesclado
-
Heiman HS1SA-E-PLUS 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: Heartbeat indicator Chamber contamination Self-test Fault Muted Interconnectable Buzzer manual mute Remote test Smoke level Rebooted count +2
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:HEIMAN/HS1SA-EF-3.03 mais quirks para este dispositivo
-
Quirk incluído em ZHA
HEIMAN/HS1SA-E-PLUSzha-device-handlers · desde zha-quirks 2.2.2 -
Quirk proposto, ainda não mesclado
HEIMAN/HS1SA-EF-3.0zha-device-handlers · Pull Request #5143 · por @TheJulianJES · 3 de Julho, 2026 -
Quirk proposto, ainda não mesclado
HEIMAN/HS1SA-E-PLUSzha-device-handlers · Pull Request #5143 · por @TheJulianJES · 3 de Julho, 2026
-
Quirk incluído em ZHA
-
Heiman HM-722ESY-E Plus 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: Self-test Fault Muted Interconnectable Buzzer manual mute Remote test Rebooted count Rejoined count Reported packages
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:HEIMAN/HM-722ESY-E-PLUS1 mais quirk para este dispositivo
-
Quirk proposto, ainda não mesclado
HEIMAN/HM-722ESY-E-PLUSzha-device-handlers · Pull Request #5143 · por @TheJulianJES · 3 de Julho, 2026
-
Quirk proposto, ainda não mesclado
-
HEIMAN HS1CA-E PLUS 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: Self-test Fault Muted Interconnectable Buzzer manual mute Remote test Rebooted count Rejoined count Reported packages
Fonte: zha-device-handlers · desde zha-quirks 2.2.2
Assinatura:HEIMAN/HS1CA-E PLUS3 mais quirks para este dispositivo
-
Quirk incluído em ZHA
HEIMAN/HS1CA-E-PLUSzha-device-handlers · desde zha-quirks 2.2.2 -
Quirk proposto, ainda não mesclado
HEIMAN/HS1CA-E PLUSzha-device-handlers · Pull Request #5143 · por @TheJulianJES · 3 de Julho, 2026 -
Quirk proposto, ainda não mesclado
HEIMAN/HS1CA-E-PLUSzha-device-handlers · Pull Request #5143 · por @TheJulianJES · 3 de Julho, 2026
-
Quirk incluído em ZHA
-
SONOFF SNZB-09P Fumo e segurança · 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: Alarm Sound Enable Alarm Light Enable Alarm Sound Type Alarm Volume Level Alarm Duration Siren on External Power Tamper
Fonte: zha-device-handlers · Pull Request #5136 · por @Oniums · 2 de Julho, 2026
Assinatura:SONOFF/SNZB-09P
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.
