ZHA-Quirk-Datenbank

Ein Quirk bringt ZHA bei, wie sich ein Gerät verhält, das sich nicht an den Zigbee-Standard hält – ohne ihn fehlen bei einem Tuya-Thermostat oder einem Aqara-Sensor oft Entitäten oder sie zeigen Falsches. Zu jedem Gerät siehst du den Quirk, den du nutzen solltest, und woher er stammt: aus ZHA selbst, als Vorschlag, der noch nicht übernommen ist, oder als Custom Quirk, den jemand im Issue-Tracker geteilt hat.

737Geräte mit Quirk in ZHA
634vorgeschlagen
123Custom Quirks

1.035 Geräte gefunden

Einen Custom Quirk nutzen

  1. ZHA mitteilen, wo Custom Quirks liegen – in der configuration.yaml:
    zha:
      custom_quirks_path: /config/custom_zha_quirks/
  2. Diesen Ordner anlegen und den Quirk als .py-Datei darin speichern.
  3. Home Assistant neu starten. War das Gerät schon gekoppelt, es neu konfigurieren oder entfernen und erneut koppeln, damit der Quirk greift.
  4. Prüfen, ob es geklappt hat: Auf der Geräteseite steht der Quirk unter „Zigbee-Info“.

Ein Custom Quirk wurde von den ZHA-Maintainern nicht geprüft. Lösche die Datei, sobald der Quirk in einem Home-Assistant-Release enthalten ist – sonst hat die alte Kopie Vorrang.

Quellen: zha-device-handlers auf GitHub – das aktuelle Release, offene Pull Requests und Issues. Gelesen wird nur, für welche Geräte ein Quirk gilt, welche Entitäten er ergänzt, wer ihn geteilt hat und wie viele zugestimmt haben; der Code bleibt auf GitHub. Die Empfehlung bevorzugt einen Quirk aus ZHA, dann einen vorgeschlagenen, dann den Custom Quirk mit den meisten Zustimmungen.

Nach oben scrollen