Przewodnik automatyzacji Home Assistant

Automatyzacje Home Assistant umożliwiają automatyczną synchronizację danych zdrowotnych z Home Assistant jako stany czujników. Ta integracja pozwala na wykorzystanie danych zdrowotnych w automatyzacjach Home Assistant, panelach i innych integracjach.

Przegląd

Automatyzacje Home Assistant wysyłają Twoje metryki zdrowotne do interfejsu API REST Home Assistant, tworząc lub aktualizując stany czujników, które mogą być używane w całej instancji Home Assistant. Dane są formatowane specjalnie dla interfejsu API /states/ Home Assistant.

Przypadki użycia:

• Wyświetlanie metryk zdrowotnych na panelach Home Assistant
• Tworzenie automatyzacji na podstawie danych zdrowotnych
• Integracja danych zdrowotnych z innymi urządzeniami inteligentnego domu
• Śledzenie trendów zdrowotnych w czasie w Home Assistant

Kluczowe funkcje:

• Automatyczne tworzenie stanów czujników
• Tylko format JSON (zoptymalizowany dla Home Assistant)
• Tylko typ danych Health Metrics
• Prosta konfiguracja URL

Ograniczenia

• Dostęp do danych zdrowotnych: Aplikacje nie mogą uzyskiwać dostępu do danych zdrowotnych, gdy iPhone jest zablokowany. Automatyzacje uruchamiają się tylko wtedy, gdy urządzenie jest odblokowane. Jest to ograniczenie Apple, którego nie można obejść. Więcej informacji

• Przetwarzanie w tle: iOS ogranicza przetwarzanie w tle, aby zachować żywotność baterii. Automatyzacje polegają na odświeżaniu aplikacji w tle i mogą nie działać natychmiast, jeśli:

  • Odświeżanie aplikacji w tle jest wyłączone dla aplikacji
  • Urządzenie jest w trybie oszczędzania energii
  • Urządzenie było nieaktywne przez dłuższy czas
  • Zasoby systemowe są ograniczone
  • Wiele aplikacji konkuruje o czas wykonania w tle

• Obsługuje tylko typ danych Health Metrics

• Tylko format JSON (nie można zmienić)

Wymagania wstępne

• Instancja Home Assistant działająca i dostępna w sieci
• Token dostępu do interfejsu API Home Assistant (Token dostępu długoterminowy)
• Łączność sieciowa z instancją Home Assistant
• Wersja Home Assistant obsługująca interfejs API REST

Konfiguracja

Przejdź do ekranu Zautomatyzowane eksporty z głównej nawigacji, następnie dotknij "Nowa automatyzacja" i wybierz "Home Assistant" jako Typ automatyzacji.

Nazwa automatyzacji

Wprowadź opisową nazwę automatyzacji. Ta nazwa zostanie użyta do wygenerowania identyfikatora encji czujnika w Home Assistant.

Uwaga: Nazwa automatyzacji zostanie przekonwertowana na małe litery z usuniętymi spacjami, aby utworzyć identyfikator encji. Na przykład "Moje dane zdrowotne" staje się hae.mojedanezdrowotne.

Powiadomienia

Skonfiguruj, kiedy chcesz otrzymywać powiadomienia:

• Powiadamiaj o aktualizacji cache - Otrzymuj powiadomienie, gdy dane w pamięci podręcznej są aktualizowane
• Powiadamiaj przy uruchomieniu - Otrzymuj powiadomienie za każdym razem, gdy automatyzacja jest wykonywana

URL Home Assistant

Wprowadź podstawowy URL instancji Home Assistant. Powinien zawierać protokół i port, jeśli nie używasz domyślnego.

Przykładowe URL:

• http://homeassistant.local:8123
• http://192.168.1.100:8123

Uwaga: URL musi być dostępny z Twojego urządzenia. Jeśli używasz HTTPS, upewnij się, że certyfikat jest ważny lub dodaj wyjątek.

Automatycznie generowany punkt końcowy

Aplikacja automatycznie generuje pełny punkt końcowy interfejsu API na podstawie nazwy automatyzacji:

{your_url}/api/states/hae.{automation_name}

Na przykład, jeśli Twój URL to http://homeassistant.local:8123 i nazwa automatyzacji to "Metryki zdrowotne", punkt końcowy będzie:

http://homeassistant.local:8123/api/states/hae.metrykizdrowotne

Ten punkt końcowy jest wyświetlany pod polem URL jako odniesienie.

Limit czasu żądania

Wybierz interwał limitu czasu dla żądań HTTP do Home Assistant.

Dostępne opcje limitu czasu:

• 60 sekund - Domyślne, odpowiednie dla większości instancji Home Assistant
• 300 sekund (5 minut) - Dla wolniejszych instancji Home Assistant
• 1800 sekund (30 minut) - Dla bardzo wolnego przetwarzania
• 3600 sekund (1 godzina) - Maksymalny zalecany limit czasu

Nagłówki HTTP

Dodaj nagłówki uwierzytelniania dla dostępu do interfejsu API Home Assistant. Musisz dodać nagłówek Authorization z tokenem dostępu długoterminowym.

Wymagany nagłówek:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Aby uzyskać token dostępu długoterminowy:

1. Otwórz Home Assistant
2. Przejdź do swojego profilu (kliknij swoje imię w lewym dolnym rogu)
3. Przewiń w dół do "Tokeny dostępu długoterminowego"
4. Kliknij "Utwórz token"
5. Nadaj mu nazwę (np. "Health Auto Export")
6. Skopiuj token i wklej go w polu wartości nagłówka

Opcjonalne nagłówki:
Możesz dodać dodatkowe nagłówki, jeśli jest to konieczne dla konfiguracji Home Assistant.

Aby dodać nagłówki:

1. Dotknij "Dodaj nagłówki"
2. Wprowadź klucz nagłówka w lewym polu
3. Wprowadź wartość nagłówka w prawym polu
4. Powtórz dla dodatkowych nagłówków

Ważne: Każdy klucz nagłówka musi mieć odpowiadającą wartość. Puste nagłówki będą ignorowane.

Ustawienia typu danych

Typ danych

Uwaga: Automatyzacje Home Assistant obsługują tylko typ danych Health Metrics. To ustawienie nie może być zmienione i jest automatycznie ustawione na Health Metrics.

Konfiguracja Health Metrics

Wybierz Health Metrics - Wybierz, które konkretne metryki uwzględnić. Możesz wybrać wszystkie dostępne metryki lub wybrać konkretne.

Wskazówka: Wybranie tylko potrzebnych metryk może poprawić czas przetwarzania i zmniejszyć rozmiar danych wysyłanych do Home Assistant.

Preferowane źródła - Skonfiguruj, które źródła danych mają priorytet, gdy wiele źródeł dostarcza tę samą metrykę.

Ustawienia eksportu

Format eksportu

Uwaga: Automatyzacje Home Assistant obsługują tylko format JSON. To ustawienie nie może być zmienione i jest automatycznie ustawione na JSON.

Wersja eksportu

Uwaga: Wersja eksportu nie jest dostępna dla automatyzacji Home Assistant, ponieważ format jest zoptymalizowany specjalnie dla interfejsu API stanu Home Assistant.

Zakres dat

Wybierz, kiedy dane powinny być eksportowane:

• Domyślne - Synchronizuje dane dla pełnego poprzedniego dnia plus dane do aktualnej daty i godziny
• Dzisiaj - Synchronizuje wszystkie dane dla aktualnej daty do aktualnej godziny
• Wczoraj - Synchronizuje wszystkie dane dla pełnego poprzedniego dnia

Uwaga: Automatyzacje Home Assistant nie obsługują opcji "Czas rzeczywisty", "Od ostatniej synchronizacji" lub "Ostatnie 7 dni".

Podsumuj dane

Włącz lub wyłącz Podsumuj dane dla Health Metrics.

• WŁĄCZONE - Zapewnia zagregowane podsumowania danych (domyślne)
• WYŁĄCZONE - Zapewnia zdezagregowane dane, gdy to możliwe

Uwaga: To ustawienie dotyczy tylko typu danych Health Metrics.

Grupowanie czasowe

Gdy Podsumuj dane jest włączone, wybierz, jak dane powinny być agregowane:

• Domyślne - Brak agregacji, surowe punkty danych
• Dni - Grupuje dane według dni (zalecane)

Częstotliwość synchronizacji

Skonfiguruj, jak często automatyzacja powinna synchronizować dane z Home Assistant:

Wybierz liczbę i interwał.

Testowanie i weryfikacja

Weryfikacja w Home Assistant

1. Otwórz Home Assistant
2. Przejdź do Narzędzia deweloperskie > Stany
3. Wyszukaj hae.{your_automation_name} (małe litery, bez spacji)
4. Zweryfikuj, czy stan czujnika pokazuje Twoje dane zdrowotne
5. Sprawdź znacznik czasu "Ostatnia aktualizacja", aby potwierdzić niedawne synchronizacje

Sprawdzanie dzienników Home Assistant

Jeśli dane nie pojawiają się w Home Assistant:

1. Otwórz Home Assistant
2. Przejdź do Ustawienia > System > Dzienniki
3. Szukaj błędów związanych z interfejsem API REST lub stanami czujników
4. Sprawdź błędy uwierzytelniania lub nieprawidłowy format danych

Rozwiązywanie problemów

Typowe problemy

Błędy uwierzytelniania

• Zweryfikuj, czy token dostępu długoterminowy jest poprawny
• Upewnij się, że nagłówek Authorization jest sformatowany jako: Bearer YOUR_TOKEN
• Sprawdź, czy token nie wygasł lub nie został odwołany
• Zweryfikuj, czy token ma odpowiednie uprawnienia w Home Assistant

Czujnik nie pojawia się w Home Assistant

• Sprawdź, czy nazwa automatyzacji nie zawiera znaków specjalnych
• Zweryfikuj format identyfikatora encji: hae.{automation_name} (małe litery, bez spacji)
• Sprawdź dzienniki Home Assistant pod kątem błędów
• Upewnij się, że żądanie interfejsu API zakończyło się sukcesem (sprawdź Dzienniki aktywności)

Dane nie są aktualizowane

• Sprawdź, czy automatyzacja jest włączona
• Przejrzyj Dzienniki aktywności pod kątem błędów
• Upewnij się o łączności sieciowej z Home Assistant

Limit czasu połączenia

• Zweryfikuj, czy Home Assistant działa i jest dostępny
• Sprawdź łączność sieciową
• Zwiększ ustawienie Limitu czasu żądania, jeśli Home Assistant odpowiada wolno
• Zweryfikuj, czy URL i port są poprawne

Komunikaty błędów

Aplikacja wyświetli komunikaty błędów, jeśli:

• URL jest nieprawidłowy lub niedostępny
• Uwierzytelnianie nie powiodło się (sprawdź nagłówek Authorization)
• Home Assistant zwraca kod statusu błędu
• Łączność sieciowa jest niedostępna

Sprawdź Dzienniki aktywności, aby uzyskać szczegółowe informacje o błędach, w tym kody statusu HTTP i komunikaty błędów z Home Assistant.

Wskazówki dotyczące integracji Home Assistant

Używanie danych zdrowotnych w automatyzacjach

Gdy Twoje dane zdrowotne są zsynchronizowane z Home Assistant, możesz używać ich w automatyzacjach:

automation:
  - alias: "Dobra jakość snu"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Świetny sen zeszłej nocy!"

Tworzenie paneli

Dodaj metryki zdrowotne do panelu Home Assistant:

1. Przejdź do panelu
2. Dodaj nową kartę
3. Wybierz typ karty "Encje" lub "Gauge"
4. Dodaj encje czujników hae.{your_automation_name}

Struktura stanu czujnika

Stan czujnika w Home Assistant zawiera:

• state: Aktualna wartość lub status
• attributes: Dodatkowe dane, w tym:
  • Informacje o znaczniku czasu
  • Struktura danych odpowiadająca wyeksportowanemu formatowi JSON
  • Informacje o jednostkach, gdy dotyczy

Wskazówki i najlepsze praktyki

1. Automatyczna synchronizacja:

   • Ładuj urządzenie i używaj Lustrzania iPhone’a
     • Podczas ładowania iOS nakłada mniej ograniczeń wydajności, więc dane mogą synchronizować się częściej
     • Dzięki Lustrzaniu iPhone’a urządzenie zachowuje się jak odblokowane. Health Auto Export może wtedy uzyskać dostęp do danych zdrowotnych i uruchamiać automatyzacje

2. Nazewnictwo:

   • Unikaj znaków specjalnych, które mogą powodować problemy

3. Wybór danych:

   • Wybierz tylko potrzebne metryki

Przeglądanie dzienników aktywności

1. Naciśnij Wyświetl dzienniki aktywności na ekranie konfiguracji automatyzacji.
2. Przejrzyj uruchomienia (pogrupowane, najnowsze pierwsze) i rozwiń zdarzenia w każdym uruchomieniu.
3. Rozróżnij ostrzeżenia (np. wolne zapytanie o dane zdrowotne) od błędy (błędy publikacji encji lub połączenia)—zobacz Przegląd automatyzacji — Dzienniki aktywności.
4. Uruchomienia Home Assistant mogą rejestrować wyniki według encji; uruchomienie może częściowo się powieść, gdy niektóre encje się aktualizują, a inne nie.
5. Udostępnij (pasek narzędzi) eksportuje pełny diagnostyczny ZIP Dzienniki zdarzeń aplikacji dla wsparcia (to samo co Ustawienia → Zaawansowane).
6. Wyczyść usuwa tylko historię aktywności tej automatyzacji.