58 lines
2.6 KiB
Markdown
58 lines
2.6 KiB
Markdown
# HACS-Pakete
|
|
|
|
Dieser Ordner enthält zwei getrennte, für HACS vorbereitete Paketordner:
|
|
|
|
- `sternwarte-homeassistant-integration`
|
|
- `sternwarte-homeassistant-card`
|
|
|
|
## Gedachter Einsatz
|
|
|
|
Für HACS werden Integration und Card als zwei getrennte Repositories geführt:
|
|
|
|
1. `sternwarte-homeassistant-integration`
|
|
Enthält die Home-Assistant-Integration unter `custom_components/sternwarte/`
|
|
|
|
2. `sternwarte-homeassistant-card`
|
|
Enthält die Lovelace-Card unter `dist/sternwarte-card.js`
|
|
|
|
## Nächster Schritt
|
|
|
|
Wenn ihr das später wirklich über HACS verwenden wollt, legt ihr für beide Ordner jeweils ein eigenes Git-Repository an oder kopiert den jeweiligen Inhalt in zwei getrennte GitHub-Repositories.
|
|
|
|
## Hinweis
|
|
|
|
Die Integration läuft bereits lokal. Für eine spätere Veröffentlichung sollten in `manifest.json` noch echte `documentation`- und `issue_tracker`-Links auf das spätere Repository gesetzt werden.
|
|
|
|
## Test-Home-Assistant
|
|
|
|
Für Tests gibt es eine komplette Test-Home-Assistant-Umgebung mit SMB-Zugriff unter `\\192.168.1.71`.
|
|
|
|
Über diese SMB-Freigabe besteht Zugriff auf die gesamte Test-Home-Assistant-Instanz. Für die Lovelace-Card ist dort insbesondere der Ordner `\\192.168.1.71\config\www` relevant.
|
|
|
|
- SMB-Ziel: `\\192.168.1.71`
|
|
- Card-Ordner: `\\192.168.1.71\config\www`
|
|
- Benutzer: `Eskimue`
|
|
- Passwort: `Preside`
|
|
|
|
In dieser Freigabe liegen die Card-Dateien, die Home Assistant direkt als Dashboard-Ressourcen lädt:
|
|
|
|
- `\\192.168.1.71\config\www\sternwarte-card.js`
|
|
- `\\192.168.1.71\config\www\astronomy.browser.min.js`
|
|
- `\\192.168.1.71\config\www\moon_small.png`
|
|
|
|
Arbeitsweise:
|
|
|
|
- Änderungen an der Card werden nach dem Anpassen direkt auf diese Test-Instanz kopiert.
|
|
- Relevant sind dafür in der Regel die Dateien aus `sternwarte-homeassistant-card/dist/`.
|
|
- Nach dem Kopieren muss das Home-Assistant-Frontend hart neu geladen werden, damit kein alter Browser-Cache im Weg ist.
|
|
- Für das Kopieren gibt es im Repo-Root den Helfer `deploy-test.ps1`.
|
|
- Aufruf aus dem Repo-Root: `.\deploy-test.ps1`
|
|
|
|
Wichtige Besonderheiten der Sternwarten-Card:
|
|
|
|
- Der Dämmerungsbalken arbeitet auf einer lokalen `12:00 → 12:00`-Achse.
|
|
- Die Dämmerungsphasen werden direkt aus der Sonnenhöhe bestimmt, nicht nur aus einzelnen Dawn-/Dusk-Zeitpunkten.
|
|
- Das ist wichtig für Sommerfälle ohne astronomische Nacht.
|
|
- Die Marker `Öffnen geplant` und `Schließen geplant` werden für diese Achse nach lokaler Uhrzeit eingeordnet.
|
|
- Wenn diese Marker fehlen, ist die erste Prüffrage: Wurde versehentlich wieder gegen ein echtes Datumsfenster statt gegen die `12 → 12`-Achse gerechnet?
|