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.
634 dispositivos encontrados
-
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-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 -
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 -
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-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
-
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
-
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 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
-
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
-
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 -
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
-
HOBEIAN ZG-204ZK Moção & presenç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: Motion sensitivity Minimum range Maximum range Target distance Distance tracking Presence sensitivity Fading time Self test result LED indicator Detection delay +38
Fonte: zha-device-handlers · Pull Request #5123 · por @gilsonmandalogo · 25 de Junho, 2026 · 1 aprovação
Assinatura:_TZE200_ka8l86iu/TS06013 mais quirks para este dispositivo
-
Quirk personalizado partilhado em um problema
HOBEIAN/ZG-204ZKzha-device-handlers · problema #4837 · por @Classical-Gas · 19 de Março, 2026 · 5 aprovações -
Quirk proposto, ainda não mesclado
_TZE200_zbfmvj13/TS0601zha-device-handlers · Pull Request #5123 · por @gilsonmandalogo · 25 de Junho, 2026 · 1 aprovação -
Quirk proposto, ainda não mesclado
HOBEIAN/ZG-204ZKzha-device-handlers · Pull Request #5123 · por @gilsonmandalogo · 25 de Junho, 2026 · 1 aprovação
-
Quirk personalizado partilhado em um problema
-
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-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
-
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
-
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 -
Gledopto GL-SPI-206P Luzes e lâmpadas · também em Zigbee2MQTT · 3 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: Work mode Countdown Pixel count LED color order Chip type Do not disturb Scene Music mode Music sensitivity
Fonte: zha-device-handlers · Pull Request #5095 · por @strepto42 · 17 de Junho, 2026
Assinatura:_TZE284_gt5al3bl/TS06015 mais quirks para este dispositivo
-
Quirk personalizado partilhado em um problema
_TZE284_gt5al3bl/TS0601zha-device-handlers · problema #4610 · por @basilfx · 30 de Dezembro, 2025 -
Quirk personalizado partilhado em um problema
_TZE204_8fffc3kb/TS0601zha-device-handlers · problema #3972 · por @THK-artjom · 21 de Março, 2025 · 6 aprovações -
Quirk proposto, ainda não mesclado
_TZE204_8fffc3kb/TS0601zha-device-handlers · Pull Request #5095 · por @strepto42 · 17 de Junho, 2026 -
Quirk proposto, ainda não mesclado
_TZE204_8fffc3kb/TS0601zha-device-handlers · Pull Request #4901 · por @Rudis1261 · 3 de Abril, 2026 -
Quirk personalizado partilhado em um problema
_TZE204_8fffc3kb/TS0601zha-device-handlers · problema #3972 · por @nikakoy131 · 25 de Abril, 2025
-
Quirk personalizado partilhado em um problema
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.
