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.

786dispositivos com um quirk em ZHA
792proposto
139quirks personalizados

1.136 dispositivos encontrados

Utilizar um quirk personalizado

  1. Diz ao ZHA onde ficam os quirks próprios – no configuration.yaml: 
    zha:
  custom_quirks_path: /config/custom_zha_quirks/
  2. Crie essa pasta e salve o quirk como um ficheiro .py nela.
  3. 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.
  4. Confirma que resultou: a página do dispositivo mostra o quirk em informação Zigbee.

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.

Scroll to Top