HA-Struktur, Einstieg und Roadmap?

[sibbl]

Hallo zusammen,

ich bin in den letzten Tagen frisch auf das Projekt aufmerksam geworden, da ich seit einiger Zeit die Trovis 5578e in HA integrieren wollte und nun endlich dafür mal Zeit war.

Aus dem Grund habe ich seit letztem Jahr schon einige Sensoren und Switches geschrieben gehabt, die für wenige spezifische Use Cases ausreichend waren, bevor ich den sehr umfangreichen Code hier gefunden habe. Erst einmal ein großer Dank für all diese Arbeit!

Daraus ergaben sich einige Fragen:

1. ist ein Schreiben in Holdings geplant? Ich hatte konkret die Zirkulationspumpe als Switch integriert, hier ist sie nur als Read-Only-Sensor implementiert.
2. was ist das empfohlene Set-Up? Im Wiki fand ich rein gar nichts zur HA-Integration, in einigen Ordnern sind Readmes und auf z.B. die Dashboard-Snippets sind teilweise ganze Tabs, Panels, ... ohne konkrete Dokumentation wozu diese gut sind. Einen konkreten Einstieg vermisse ich aktuell. Ist so etwas geplant und wie kann man dabei helfen?
3. Die YAML-Konfiguration lässt sich momentan out of the box nicht ausführen:

homeassistant:
  packages:
    trovis:
      input_number:      !include trovis557x/input_numbers.yaml
      input_datetime:    !include trovis557x/input_datetime.yaml
      sensor main:       !include trovis557x/template_sensors.yaml
      sensor statistics: !include trovis557x/statistics.yaml
      sensor curves:     !include trovis557x/heating_curves.yaml
      template triggers: !include trovis557x/trigger_actions.yaml
      automation start:  !include trovis557x/trigger_startup.yaml
      automation update: !include trovis557x/trigger_updates.yaml

ist invalides YAML. Keys können auf diese Art keine Leerzeichen enthalten und als Keys innerhalb des "trovis"-Objekts sind meines Wissens nach nur die von HA unterstützen Werte erlaubt (d.h. 1x "sensor" und nicht "sensor main", "sensor statistics", ...). Funktioniert die aktuelle Konfig für irgendjemanden oder ging das früher mal, weshalb es so ist?

Ich würde sonst gern einen PR anbieten, der es folgendermaßen umstrukturiert und die sensor-, template- und automation-Dateien in die entsprechenden Unterordner einsortiert:

homeassistant:
  packages:
    trovis:
      input_number:      !include trovis557x/input_numbers.yaml
      input_datetime:    !include trovis557x/input_datetime.yaml
      sensor:            !include_dir_merge_list trovis557x/sensors/
      automation:        !include_dir_merge_list trovis557x/automations/
      templates:         !include_dir_merge_list trovis557x/templates/

Alles in allem würde ich mich sehr über eine grobe Roadmap oder allgemeine offene Punkte freuen, an denen man die Zusammenarbeit koordinieren könnte. Bei manchen Aussagen in Diskussionen von z.B. Februar weiß ich nicht, inwiefern diese schon überholt sind oder noch Input gefragt ist. Langfristig könnte ich mir auch eine über HACS verteilbare custom_component vorstellen, womit ich bereits Erfahrung habe.

Danke im Voraus und allen mitlesenden einen entspannten Jahresausklang!

[Tom-Bom-badil]

Hallo @sibbl,

sorry für die späte Antwort, hab im Moment viel um die Ohren und gleichzeitig 3 laufende HA Projekte.

• zu 1 - Schreiben von Registern/Coils: Ja, im zweiten Schritt.
• zu 2 - Detaillierte Doku: Wird kommen und immer weiter vorangetrieben werden - siehe Wiki als Beispiel, das mit der Zeit gewachsen ist. Ist halt noch alles Alpha, mitten im Entwickeln (steht auch so als allererster Satz in der readme.md). Es gab einige Nutzer, die wollten unbedingt gern einen Vorabstand zur eigenen Inspiration - das hier ist er. Wenn Du beginnen möchtest, detaillierter zu dokumentieren: Pull requests sind immer willkommen.
• zu 3 - "die YAML-Konfiguration lässt sich momentan out of the box nicht ausführen" sowie "Keys können auf diese Art keine Leerzeichen enthalten": Dann läuft da bei Dir was falsch. Das läuft hier so seit Monaten genau so 24/7. Das YAML wird von HA als fehlerfrei erkannt, sonst würde es gar nicht starten. Diese Vorgehensweise ist übrigens auch in der offiziellen HA Doku enthalten (siehe z.B. hier: Im Beispiel dort gibt es gleichzeitig 'light:', 'light groups:' und 'light switches:' in derselben config und auf derselben Ebene (also 3 Keys mit 'light', davon 2 mit Leerzeichen). Das wird sogar recht häufig so gemacht, hab das oft beim Stöbern in Foren und anderen Quellen so vorgefunden.

Gern können wir zusammen weiter an der sowieso von mir geplanten custom_component entwickeln, hab auch grad wieder eine für meine KWL bei HACS eingereicht. Meine freie Zeit ist aber derzeit -wie schon geschrieben- schwer planbar.

/tom