Integracja Solar Assistant z Home Assistant przez MQTT krok po kroku

Opublikowano przez

Chcesz oglądać dane z falownika w Home Assistant i mieć możliwość wysyłania komend. Poniżej znajdziesz kompletny przewodnik, który przeprowadzi Cię przez konfigurację MQTT w Solar Assistant oraz przygotowanie brokera Mosquitto w Home Assistant. Całość jest oparta na praktycznym scenariuszu i działa bez dodatkowych wtyczek poza oficjalnymi dodatkami.

Wymagania wstępne

Potrzebujesz działającego Solar Assistant z dostępem do panelu www. Home Assistant powinien mieć możliwość instalowania dodatków. Przyda się adres IP obu urządzeń oraz dane logowania administratora do Home Assistanta.

Konfiguracja MQTT w Solar Assistant

  1. Wejdź do ustawień Solar Assistant i przewiń do sekcji MQTT.

  2. Włącz konfigurację i ustaw Topic Prefix. To nagłówek, pod którym będą publikowane tematy. Wybierz nazwę łatwą do zapamiętania i unikalną w Twojej sieci.

  3. Włącz możliwość zapisu z Home Assistanta. Dzięki temu HA może zmieniać ustawienia wspieranych urządzeń.

  4. Ustaw Unique ID. Może to być krótki, czytelny ciąg znaków. Ten identyfikator wykorzystasz także po stronie HA.

  5. Włącz Auto Discovery. Home Assistant zrozumie strukturę danych i utworzy encje automatycznie.

  6. Ustaw nazwę użytkownika i hasło do MQTT. Parametry mogą być dowolne, ale muszą zostać identycznie wpisane w konfiguracji mostka po stronie HA.

  7. Zapisz ustawienia i uruchom MQTT w Solar Assistant.

Przygotowanie Home Assistant

Instalacja dodatków

Otwórz Ustawienia i przejdź do Dodatków. Zainstaluj Samba Share. Dzięki temu dostaniesz się do katalogu share przez Eksplorator plików. Zainstaluj dodatek Mosquitto broker. Na tym brokerze zrobisz mostek do Solar Assistant.

Dostęp SMB do plików

  1. W systemie Windows otwórz Eksplorator plików i przejdź do zakładki Sieć.

  2. W pasku ścieżki wpisz \\IP_HA\share i zaloguj się danymi z konfiguracji Samba Share.

  3. Jeśli nie istnieje katalog mosquitto, utwórz go w share. Ostateczna ścieżka to share\mosquitto.

Pliki konfiguracyjne Mosquitto

W katalogu share\mosquitto umieść dwa pliki tekstowe zapisane w kodowaniu UTF-8.

Plik 1: mosquitto.conf
Zawartość:

include_dir /share/mosquitto

 

Ta linia mówi brokerowi, aby wczytał wszystkie dodatkowe pliki z katalogu share/mosquitto.

Plik 2: solarassistant.conf
Zawartość szablonu. Zastąp wartości swoimi danymi.

connection solar_assistant
address 192.168.10.41:1883
topic # in
topic solarassistant/# out
remote_username solarassistant
remote_password SolarKurdeBalans
clientid sol_as
start_type automatic
notifications false
cleansession true

 

Podstaw następujące wartości.
SA_IP to adres IP Solar Assistant.
SA_PREFIX to dokładnie ten sam Topic Prefix ustawiony w Solar Assistant.
SA_USER oraz SA_PASS to login i hasło użyte w Solar Assistant.
SA_UNIQUE_ID to identyczny Unique ID, który wpisałeś wcześniej w Solar Assistant.

Restart dodatku Mosquitto

Wróć do Home Assistanta. Otwórz dodatek Mosquitto i wykonaj restart. Po ponownym uruchomieniu broker wczyta oba pliki i zestawi mostek do Solar Assistant.

Weryfikacja działania

Otwórz Ustawienia i przejdź do Urządzenia i usługi. Wejdź w integrację MQTT. Powinno pojawić się urządzenie reprezentujące falownik lub zestaw encji publikowanych przez Solar Assistant. Jeśli włączyłeś Auto Discovery w Solar Assistant, encje utworzą się automatycznie z opisami i jednostkami.

Najczęstsze problemy i szybkie rozwiązania

Brak nowych encji po restarcie. Sprawdź literówki w Topic Prefix i wartość ClientID.
Błąd uwierzytelnienia po stronie mostka. Upewnij się, że login i hasło są identyczne w Solar Assistant i w pliku solarassistant.conf.
Brak połączenia z SA. Sprawdź poprawność adresu IP i czy port 1883 jest dostępny.
Auto Discovery nie dodaje encji. Upewnij się, że opcja jest włączona w Solar Assistant i że prefix nie koliduje z innymi tematami w brokerze.

Bezpieczeństwo i porządek w tematach

Zachowaj unikalny prefix, aby nie mieszać tematów kilku systemów. Nie używaj danych domyślnych dla użytkownika i hasła. Jeśli broker jest dostępny z sieci zewnętrznej, rozważ TLS i ograniczenia dostępu. W środowisku lokalnym zadbaj o segmentację sieci oraz o stałe adresy IP dla obu urządzeń.

Podsumowanie

Po stronie Solar Assistant konfigurujesz MQTT, włączasz zapisy z HA, ustawiasz Unique ID oraz Auto Discovery. Po stronie Home Assistant instalujesz Samba i Mosquitto, dodajesz dwa pliki w share/mosquitto, restartujesz broker i sprawdzasz integrację. Od tej chwili możesz odczytywać dane, a także wysyłać komendy do urządzeń wspieranych przez Solar Assistant. Integracja jest powtarzalna i łatwa do utrzymania.