Base de datos de quirks ZHA

Un quirk enseña a ZHA cómo se comporta un dispositivo que no sigue el estándar Zigbee – sin uno, un termostato de Tuya o un sensor de Aqara suelen aparecer con entidades faltantes o incorrectas. Para cada dispositivo, ves el quirk que debes usar y de dónde proviene: uno que viene con ZHA, uno propuesto pero no aceptado aún, o un quirk personalizado compartido en el tracker de problemas.

737dispositivos con un quirk en ZHA
644propuesto
122quirks personalizados

1.036 dispositivos encontrados

Usando un quirk personalizado

  1. Dígale a ZHA dónde se guardan los quirks personalizados – en configuration.yaml: 
    zha:
  custom_quirks_path: /config/custom_zha_quirks/
  2. Crea esa carpeta y guarda el quirk como un archivo .py en ella.
  3. Reinicia Home Assistant. Si el dispositivo fue emparejado antes, reconfigúralo o elimínalo y emparejalo de nuevo para que se aplique el quirk.
  4. Compruebe que funcionó: la página del dispositivo muestra el quirk bajo la información Zigbee.

Los mantenedores de ZHA no han revisado un quirk personalizado. Elimina el archivo una vez que el quirk sea parte de una versión de Home Assistant – de lo contrario la copia vieja tiene precedencia.

Fuentes: zha-device-handlers en GitHub – la última versión, sus solicitudes de extracción abiertas y problemas. Solo se leen a qué dispositivos se aplica un quirk, qué entidades añade, quién lo compartió y cuántas personas lo aprobaron; el código permanece en GitHub. La recomendación prefiere un quirk incluido en ZHA, luego uno propuesto, luego el quirk personalizado con más aprobaciones.

Scroll al inicio