Zanim zaczniesz
- Działająca instalacja Ampernova z przypisanymi termostatami online.
- Home Assistant i broker dostępny ze sterownika HeatingMain.
- Dostęp do sterownika w portalu Ampernova. Musi być online, aby odebrać ustawienia brokera.
Po skonfigurowaniu MQTT działa lokalnie. Parowanie Matter i menu Fabric termostatu są niezależne od tej konfiguracji.
Konfiguracja MQTT
- W Home Assistant otwórz Ustawienia → Urządzenia & usługi → Dodaj integrację → MQTT. W Home Assistant OS wykonaj proponowaną konfigurację brokera Mosquitto. Jeśli jest już zainstalowany, użyj istniejącego brokera.
- Utwórz oddzielne konto brokera dla Ampernova. W oficjalnej aplikacji Mosquitto utwórz użytkownika Home Assistant w Ustawienia → Osoby → Użytkownicy; jeśli zakładka Użytkownicy jest ukryta, włącz tryb zaawansowany w profilu. Wybierz unikalne hasło i nie nadawaj uprawnień administratora.
- Dla Home Assistant Container lub zewnętrznego brokera zainstaluj Mosquitto osobno i podaj adres oraz dane logowania brokera w integracji MQTT.
- Pozostaw wykrywanie MQTT włączone z prefiksem
homeassistant.
Oficjalne instrukcje MQTT Home Assistant · Konfiguracja Mosquitto i użytkowników
Połącz Ampernova
W portalu Ampernova otwórz sterownik HeatingMain, a następnie Settings → MQTT broker. Wypełnij wszystkie cztery pola:
| Pole | Co wpisać |
|---|---|
host | Adres LAN brokera, np. 192.168.1.20. Dla aplikacji Mosquitto użyj adresu LAN komputera z Home Assistant. Nie wpisuj tu protokołu, ścieżki ani portu. |
port | 1883 dla lokalnego połączenia MQTT TCP. |
user | Nazwa utworzonego użytkownika brokera. |
password | Hasło tego użytkownika brokera. Wpisuj je przy każdym zastosowaniu ustawień; puste pole wysyła puste hasło. |
Wybierz apply broker. Sterownik zapisze ustawienia i połączy się ponownie automatycznie; ręczny restart nie jest potrzebny. Powtórz dla każdego sterownika HeatingMain, który chcesz dodać do Home Assistant.
Komunikat „settings sent” potwierdza wysłanie. Sprawdź połączenie na podstawie bieżących odczytów w Home Assistant. Hasło nigdy nie jest wyświetlane ani wstępnie wpisywane.
Używaj zaufanej sieci lokalnej: to ustawienie korzysta z nieszyfrowanego MQTT TCP, bez TLS i WebSockets. Port brokera powinien być dostępny wyłącznie w sieci LAN.
Znajdź pokoje
- W Home Assistant otwórz Ustawienia → Urządzenia & usługi → MQTT, a następnie listę urządzeń.
- Znajdź sterownik po identyfikatorze urządzenia. Encje termostatów są zgrupowane pod sterownikiem i używają nazw obwodów, np. Thermostat A1 lub Thermostat B4.
- Otwórz encję termostatu i porównaj temperaturę oraz wartości zadane z fizycznym termostatem. Zmień nazwę encji na nazwę pokoju i opcjonalnie przypisz obszar.
- Dodaj encję termostatu do pulpitu. Zmień temperaturę zadaną i potwierdź jej dotarcie do fizycznego termostatu; odczekaj cykl magistrali, około minuty.
Nie potrzeba osobnej integracji Ampernova ani ręcznej konfiguracji wykrywania w YAML. Dostępne encje zależą od obwodów i oprogramowania; pokój przypisany do podłogi i sufitu może występować pod oboma adresami obwodów.
Temperatury zadane ustawia się osobno dla pokoi. Sezon grzania lub chłodzenia dotyczy całej instalacji; użyj globalnego sterowania trybem w portalu Ampernova.
Rozwiązywanie problemów
Sterownik się nie pojawia
Sprawdź adres brokera, dane logowania i dostęp LAN ze sterownika. Użyj adresu IP LAN komputera brokera, a nie localhost lub core-mosquitto. Sprawdź dziennik Mosquitto pod kątem błędów połączenia lub uwierzytelniania, a następnie ponownie zastosuj wszystkie cztery pola.
MQTT jest połączone, ale brakuje pokoi
Potwierdź, że termostaty są online i przypisane. W opcjach MQTT Home Assistant sprawdź, czy wykrywanie jest włączone z prefiksem homeassistant. Gdy pokoje będą online, ponownie zastosuj ustawienia brokera, aby połączyć się i wysłać wykrywanie jeszcze raz.
Encje są widoczne, ale niedostępne
Broker przechowuje opisy wykrywania nawet po zakończeniu połączenia. Sprawdź bieżące połączenie sterownika i termostatów i poczekaj na świeże odczyty. Sam zachowany wpis urządzenia nie dowodzi, że system jest online.
Co robi „use default broker”?
Usuwa ustawienie portalu i przywraca broker skonfigurowany podczas przygotowania sterownika. Jeśli nie ma domyślnego brokera, lokalne MQTT się zatrzyma. Aby użyć własnego brokera, wpisz jego dane i wybierz apply broker.