Ta integracja Home Assistant umożliwia korzystanie z urządzeń inteligentnego domu Heiman w systemie smart home. Łączy się z API chmury Heiman i wykorzystuje protokół MQTT do aktualizacji statusu urządzeń w czasie rzeczywistym.
Dzięki tej integracji użytkownicy mogą łatwo integrować urządzenia Heiman z Home Assistant i używać ich do różnych automatyzacji i monitorowania, w tym zarządzania firmware'm i kontrolowania urządzeń podrzędnych.
- English (en)
- German (deutsch) (de)
- Dutch (nederlands) (nl)
- Spanish (español) (es)
- French (français) (fr)
- Italian (italiano) (it)
- Portuguese (português) (pt)
- Russian (русский) (ru)
- Simplified Chinese (中文) (cn)
- Japanese (日本語) (ja)
- Arabic (العربية) (ar)
- Greek (Ελληνικά) (el)
- Hindi (हिन्दी) (hi)
- Polish (polski) (pl)
- Turkish (türkçe) (tr)
Jeśli brakuje jakiegoś języka, daj nam znać. Dołożymy wszelkich starań, aby go dodać.
- 🔌 Obsługa wielu urządzeń: Bramy, czujniki, przełączniki, alarmy i więcej
- ☁️ Integracja z chmurą: Połączenie przez konto Heiman z uwierzytelnianiem OAuth2
- 📡 Aktualizacje MQTT w czasie rzeczywistym: Natychmiastowe aktualizacje statusu urządzeń przez push MQTT
- 🔄 Zarządzanie firmware'm: Sprawdzaj i instaluj aktualizacje firmware'u bezpośrednio z Home Assistant
- 👨👩👧👦 Zarządzanie urządzeniami podrzędnymi: Dodawaj, usuwaj i zarządzaj urządzeniami podrzędnymi bramki przez MQTT
- 🏠 Obsługa wielu domów: Niezależne zarządzanie wieloma domami Heiman
- 🎛️ Kompleksowe encje: Czujniki, przełączniki, przyciski, selektory, czujniki binarne i encje aktualizacji
- ⚙️ Konfiguracja przez interfejs webowy: Prosta konfiguracja bez YAML
- Otwórz HACS → Integracje
- Kliknij + ODKRYWAJ I POBIERAJ REPOZYTORIA
- Wyszukaj
Heiman Homelub kliknij trzy kropki (⋮) → Niestandardowe repozytoria - Dodaj repozytorium:
https://github.com/hass-user/heiman-homez kategoriąIntegration - Kliknij POBIERZ TO REPOZYTORIUM
- Otwórz HACS → Integracje
- Znajdź Heiman Home
- Kliknij AKTUALIZUJ lub Pobierz ponownie
- Pobierz najnowszą wersję z GitHub Releases
- Rozpakuj folder
heiman_home - Skopiuj folder
heiman_homedo katalogucustom_componentsHome Assistant/config/custom_components/heiman_home/
wget -O - https://raw.githubusercontent.com/hass-user/heiman-home/main/install.sh | bash -- Uruchom ponownie Home Assistant
- Przejdź do Ustawienia → Urządzenia i usługi
- Kliknij + Dodaj integrację
- Wyszukaj
Heiman Home
- Otwórz interfejs webowy Home Assistant
- Przejdź do Ustawienia → Urządzenia i usługi
- Kliknij Dodaj integrację
- Wyszukaj
Heiman Homei wybierz je - Autoryzuj za pomocą konta Heiman (OAuth2)
- Wybierz dom, który chcesz zintegrować
- Zakończ konfigurację
Integracja używa OAuth2 do bezpiecznego uwierzytelniania:
- Kliknij Autoryzuj, aby zalogować się na konto Heiman
- Udziel wymaganych uprawnień
- Wybierz dom, który chcesz zintegrować
Możesz dodać wiele domów Heiman:
- Każdy dom tworzy osobny wpis konfiguracyjny
- Każdy dom ma niezależne zarządzanie urządzeniami
- Skonfiguruj każdy dom osobno w Urządzenia i usługi
Możesz filtrować, które urządzenia mają być zintegrowane:
- Otwórz ustawienia integracji
- Przejdź do Opcje
- Włącz/wyłącz określone urządzenia
- Zapisz zmiany
- Inteligentna brama (WS3GW-R, itp.)
- 🌐 Brama Zigbee
- 🌐 Brama WiFi
- 🌡️ Czujniki temperatury i wilgotności
- 🚪 Czujniki drzwi/okien
- 💧 Czujniki wycieku wody
- 🔥 Detektory dymu
- 💨 Czujniki gazu
- 🏃 Czujniki ruchu
- 🌞 Czujniki natężenia światła
- 🚨 Systemy alarmowe
- 🔔 Sterowanie dźwiękiem alarmu
- 🚪 Kontrola dostępu
- 🔌 Inteligentne gniazdka
- 💡 Przełączniki światła
- 🎛️ Kontrolery scen
- ️ Termostaty
- 💨 Monitory jakości powietrza
- 🔋 Urządzenia zasilane bateryjnie
- Temperatura
- Wilgotność
- Poziom baterii
- Siła sygnału (RSSI)
- Natężenie światła
- Status urządzenia
- Drzwi/okno otwarte/zamknięte
- Wykryto ruch
- Wyciek wody
- Wykryto dym
- Status sabotażu
- Ostrzeżenie o niskim poziomie baterii
- Urządzenie włącz/wyłącz
- Lampka kontrolna
- Sterowanie brzęczykiem
- Alarm włącz/wyłącz
- Aktualizuj status urządzenia
- Zdalne sprawdzanie
- Zdalna lokalizacja
- Zdalne wyciszanie
- Opcje dźwięku alarmu (Szybki beep, Średni beep, Wolny beep)
- Jednostka temperatury (°C / °F)
- Tryb pracy
- Wskaźnik poziomu sygnału
- Górny próg temperatury
- Dolny próg temperatury
- Górny próg wilgotności
- Dolny próg wilgotności
- Zakres komfortu temperaturowego
- Zakres komfortu wilgotności
- Wersja firmware'u
- Dostępne aktualizacje
- Postęp instalacji firmware'u
- Aktualizacje firmware'u są automatycznie sprawdzane podczas synchronizacji urządzeń
- Encje aktualizacji pokazują dostępne wersje firmware'u
- Porównaj zainstalowaną wersję z najnowszą dostępną wersją
- Przejdź do urządzenia w Home Assistant
- Otwórz encję Firmware
- Kliknij przycisk Zainstaluj
- Monitoruj postęp aktualizacji w czasie rzeczywistym
- Urządzenie zostanie ponownie uruchomione po zakończeniu aktualizacji
- ✅ Automatyczne wykrywanie wersji
- ✅ Monitorowanie postępu (0-100%)
- ✅ Śledzenie statusu aktualizacji
- ✅ Porównywanie wersji
- ✅ Sprawdzanie aktualizacji wsadowych
Integracja używa MQTT do natychmiastowych aktualizacji statusu urządzeń:
- Brak opóźnień pollingowych
- Natychmiastowe zmiany statusu
- Mniejsze użycie API
- Lepsza wydajność
- Automatycznie konfigurowana podczas instalacji
- Używa brokera MQTT Heiman
- Bezpieczne połączenie z TLS/SSL
- Nie wymaga ręcznej konfiguracji
- Aktualizacje właściwości urządzeń
- Status online/offline
- Zdarzenia alarmowe
- Odczyty czujników
- Zarządzanie urządzeniami podrzędnymi (rejestracja, wyrejestrowanie, wykrywanie)
Integracja oferuje kompleksowe zarządzanie urządzeniami podrzędnymi poprzez bibliotekę heiman-connect.
Cała logika zarządzania urządzeniami jest zaimplementowana w SDK, a integracja Home Assistant zapewnia prosty API do uzyskiwania dostępu do tych funkcji.
from heimanconnect import ChildDeviceManager
# Pobierz menedżer urządzeń podrzędnych z klienta API
device_manager = await api_client.async_get_child_device_manager(
user_id="your_user_id",
devices=devices_dict,
user_display_name="Your Name"
)
# Dodaj urządzenie podrzędne (zalecana metoda)
result = await device_manager.add_and_sync_device(
gateway_product_id="1733421468953686016",
gateway_device_id="1760910156165971969",
child_device_id="1768080341172985856",
child_product_id="1734821218500292608",
child_device_name="Door Sensor"
)
# Usuń urządzenie podrzędne (zalecana metoda)
result = await device_manager.remove_and_sync_device(
gateway_product_id="1733421468953686016",
gateway_device_id="1760910156165971969",
child_device_id="1768080341172985856",
product_id="1734821218500292608",
device_name="01000053"
)Aby uzyskać szczegółową dokumentację wszystkich dostępnych metod i ich parametrów, zobacz dokumentację biblioteki heiman-connect.
Włącz logowanie debugowania do rozwiązywania problemów:
# configuration.yaml
logger:
default: warning
logs:
custom_components.heiman_home: debug
heimanconnect: debug# configuration.yaml
homeassistant:
customize: !include customize.yaml
# customize.yaml
sensor.heiman_temperature:
friendly_name: "Living Room Temperature"
device_class: temperature
unit_of_measurement: "°C"
binary_sensor.heiman_door:
friendly_name: "Front Door"
device_class: door# configuration.yaml
heiman_home:
exclude_attributes:
- raw_data
- firmware_info
- configurationRęcznie zaktualizuj status urządzenia.
service: heiman_home.refresh_device
data:
device_id: "1972646416676724736"Zaktualizuj wszystkie urządzenia w integracji.
service: heiman_home.refresh_all_devices- Otwórz Narzędzia deweloperskie → Stany
- Wyszukaj swoją encję (np.
sensor.heiman_temperature) - Wyświetl wszystkie atrybuty i bieżący stan
- Włącz logowanie debugowania (zobacz Konfiguracja loggera)
- Otwórz Ustawienia → System → Logi
- Wyszukaj
heiman_homelubheimanconnect
- Sprawdź ustawienia filtrowania urządzeń
- Upewnij się, że urządzenie jest online w aplikacji Heiman
- Uruchom ponownie integrację
- Upewnij się, że urządzenie jest online
- Sprawdź kompatybilność urządzenia
- Upewnij się, że aktualizacja firmware'u jest dostępna w aplikacji Heiman
- Sprawdź połączenie internetowe
- Sprawdź dane logowania do konta Heiman
- Sprawdź logi Home Assistant pod kątem błędów
- Upewnij się, że sieć zezwala na połączenia wychodzące do
spmqtt.heiman.cn:1884 - Sprawdź ustawienia zapory sieciowej
- Uruchom ponownie Home Assistant
- Ponownie autoryzuj integrację
- Sprawdź dane logowania do konta Heiman
- Upewnij się, że konto ma dostęp do wybranego domu
- Sprawdź status połączenia MQTT w logach
- Upewnij się, że urządzenie jest online
- Spróbuj ręcznej aktualizacji przez usługę
- Wyklucz niepotrzebne atrybuty (zobacz Wykluczanie atrybutów)
- Wyłącz nieużywane encje
- Sprawdź encje ze zbyt wieloma zmianami stanu
- Zmniejsz interwał aktualizacji, jeśli to możliwe
- Filtruj nieużywane urządzenia
- Wyłącz MQTT, jeśli nie jest potrzebne (niezalecane)
heiman_home/
├── __init__.py # Inicjalizacja integracji
├── api.py # Wrapper klienta API
├── config_flow.py # Przepływ konfiguracji
├── const.py # Stałe i konfiguracja
├── coordinator.py # Koordynator aktualizacji danych
├── sensor.py # Platforma czujników
├── binary_sensor.py # Platforma czujników binarnych
├── switch.py # Platforma przełączników
├── button.py # Platforma przycisków
├── select.py # Platforma selektorów
├── number.py # Platforma numeryczna
├── update.py # Platforma aktualizacji (firmware)
├── manifest.json # Metadane integracji
└── strings.json # Tłumaczenia
Uwaga: Cała logika zarządzania urządzeniami znajduje się w bibliotece heiman-connect, a nie w tej integracji.
heiman-connect: Biblioteka Python dla API Heimanpackaging: Porównywanie wersji dla aktualizacji firmware'u
Wkład jest mile widziany! Śmiało przesyłaj:
- Raporty błędów
- Prośby o funkcje
- Obsługę urządzeń
- Tłumaczenia
- Ulepszenia dokumentacji
Ten projekt jest objęty licencją MIT - zobacz plik LICENSE po szczegóły.
- Heiman za udostępnienie platformy IoT
- Społeczność Home Assistant
- HACS za framework integracji
- Wszystkim współtwórcom i testerom
- GitHub Issues: Zgłaszanie błędów lub żądanie funkcji
- Forum społeczności Home Assistant: Dyskusje i uzyskiwanie pomocy
- Dokumentacja: Pełna dokumentacja
Ciesz się swoim inteligentnym domem z Heiman i Home Assistant! 🏠✨