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.

737dispositivos com um quirk em ZHA
637proposto
123quirks personalizados

1.038 dispositivos encontrados

Utilizar um quirk personalizado

  1. Tell ZHA where custom quirks are kept – in 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. 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.

Scroll to Top