Przez lata odpowiedź na pytanie „jak podłączyć falownik FoxESS do Home Assistant lokalnie” była zawsze taka sama: kup konwerter RS485, rozbierz złącze COM, wkręć dwa cienkie przewody w zaciski i módl się, żebyś nie pomylił linii A z B. Sam przeszedłem tę drogę z moim H3 i opisałem ją krok po kroku w osobnym poradniku. Działa to świetnie, ale wymaga sprzętu, lutowania lub wkręcania przewodów oraz odrobiny odwagi, bo grzebiemy przy urządzeniu wartym kilkanaście tysięcy złotych.
Pod koniec 2025 roku coś się jednak zmieniło. FoxESS po cichu otworzył serwer Modbus TCP wbudowany w moduł komunikacyjny najnowszych falowników. W praktyce oznacza to, że wybrane modele można spiąć z Home Assistant bezpośrednio po sieci, bez żadnego konwertera, bez otwierania złącza COM i bez dodatkowego sprzętu. Wystarczy adres IP falownika i integracja foxess_modbus.
W czerwcu 2026 roku ta funkcja wyszła z fazy testów: wydano stabilną wersję 1.15.0 integracji foxess_modbus, która oficjalnie obsługuje modele H3 Smart, P3 Smart i P3 Pro, a tryb połączenia Direct LAN przestał wymagać wersji beta. To dobry moment, żeby uporządkować temat, bo w polskim internecie praktycznie nie ma kompletnej informacji, które modele FoxESS obsługują połączenie bezpośrednie, a które nadal wymagają RS485.
W tym artykule znajdziesz pełną tabelę zgodności wszystkich serii FoxESS, instrukcję jak sprawdzić czy Twój egzemplarz ma aktywny Modbus TCP, konfigurację Home Assistant krok po kroku oraz listę najczęstszych błędów wraz z rozwiązaniami.
Dlaczego przez lata jedyną opcją było RS485?
Żeby zrozumieć, dlaczego Direct LAN to taka duża zmiana, trzeba cofnąć się do początków. Falowniki FoxESS zawsze komunikowały się ze światem na dwa sposoby: przez chmurę FoxESS Cloud oraz przez fizyczną magistralę RS485 ukrytą w złączu COM lub Meter/CT.
Chmura odpada dla każdego, kto traktuje automatykę domową poważnie. Dane odświeżają się co 5 minut, a gdy serwery FoxESS mają gorszy dzień, Home Assistant zostaje ślepy. Automatyka sterująca grzaniem CWU z nadwyżek PV nie może czekać 5 minut na informację, że chmura akurat przeszła nad panelami.
Ciekawostka historyczna: pierwsza generacja jednofazowych falowników H1 miała na spodzie gniazdo Ethernet, przez które dało się czytać rejestry Modbus. Społeczność szybko to wykorzystała, ale połączenie było niestabilne, nie dawało dostępu do części rejestrów (między innymi BMS baterii) i nie pozwalało zapisywać ustawień takich jak Min SoC czy okna ładowania. FoxESS ostatecznie wyłączył tę furtkę w firmware Manager 1.70, a nowsze egzemplarze H1 w ogóle nie mają tego portu. Kto polegał na tym rozwiązaniu, po aktualizacji został z niczym.
W trójfazowych H3 pierwszej generacji sytuacja była jeszcze prostsza: port 502 był po prostu zamknięty i żadna wersja firmware go nie otwierała. Została więc jedna sensowna droga: fizyczne podpięcie się do linii RS485 przez konwerter USB, Ethernet lub WiFi (Elfin EW11, USR-W610, Waveshare RS485 to ETH) albo własny mostek na ESP32, który opisywałem w poradniku o podłączeniu H3. RS485 daje pełny dostęp do rejestrów, pozwala zapisywać ustawienia i działa błyskawicznie, ale wymaga sprzętu i pracy przy falowniku.
Czym jest Direct LAN i jak działa Modbus TCP
Najnowsza generacja falowników FoxESS (modele z dopiskiem Smart oraz WL w oznaczeniu) ma wbudowany moduł komunikacyjny WiFi/LAN, który poza wysyłaniem danych do chmury robi coś jeszcze: uruchamia lokalny serwer Modbus TCP na porcie 502. To dokładnie ten sam protokół, którym rozmawia konwerter RS485 z trybem Modbus TCP, tylko że tym razem serwer siedzi w samym falowniku.
Z punktu widzenia Home Assistant nie ma znaczenia, czy po drugiej stronie jest konwerter Waveshare, mostek na ESP32 czy logger wbudowany w falownik. Integracja wysyła zapytania Modbus TCP na adres IP i port 502, a w odpowiedzi dostaje zawartość rejestrów: moc z paneli, stan baterii, pobór z sieci, temperatury i dziesiątki innych wartości. Domyślny adres slave to 247.
Co ważne dla praktyki: serwer działa na module komunikacyjnym, więc falownik może być podłączony do sieci zarówno kablem Ethernet, jak i przez WiFi. Kabel jest oczywiście stabilniejszy i to jego polecam, jeśli tylko masz możliwość doprowadzenia skrętki do falownika, ale samo rozwiązanie zadziała też bezprzewodowo.
Nazwa Direct LAN wzięła się z integracji foxess_modbus autorstwa nathanmarlor, gdzie tak nazywa się jeden z trybów połączenia w kreatorze konfiguracji. Warto podkreślić jedną rzecz: to nadal rozwiązanie społecznościowe. FoxESS oficjalnie nie wspiera integracji z Home Assistant, ale współpracuje ze społecznością i w nowej generacji falowników udostępnił mapę rejestrów najbliższą oficjalnej specyfikacji, jaka kiedykolwiek istniała.
Które modele FoxESS obsługują Direct LAN? Pełna tabela zgodności
Poniższa tabela to serce tego artykułu. Zebrałem w niej wszystkie serie falowników FoxESS wraz z informacją, czy dany model łączy się z Home Assistant bezpośrednio po sieci (Direct LAN, czyli wbudowany Modbus TCP), czy wymaga konwertera RS485. Stan na lipiec 2026, integracja foxess_modbus w wersji 1.15.0.
Zasada, która załatwia 90% przypadków
Jeśli w oznaczeniu Twojego falownika występuje Smart, WL lub końcówka -M (np. H3-10.0-Smart, H1-3.0-E-G2-WL, H3-12.0-M), masz wbudowany Modbus TCP i możesz łączyć się bez konwertera. Jeśli model kończy się na -E (np. H3-10.0-E, H1-5.0-E), potrzebujesz RS485.
Seria / model
Przykładowe oznaczenie
Direct LAN (Modbus TCP)
RS485
Uwagi
H1 G1 (1-faz. hybryda)
H1-3.0-E … H1-6.0-E
NIE
TAK
Port LAN działał w starych firmware, wyłączony od Manager 1.70
AC1 (1-faz. AC coupled)
AC-3.0-E … AC-6.0-E
NIE
TAK
Ta sama platforma co H1 G1
AIO-H1 (all-in-one)
AIO-H1-3.0 … AIO-H1-6.0
NIE
TAK
Falownik zintegrowany z baterią, komunikacja jak H1
H1 G2 (2. generacja)
H1-5.0-E-G2
NIE
TAK
Bez dopisku WL wymaga konwertera
H1 G2 WL
H1-3.0-E-G2-WL
TAK
TAK
Wbudowany serwer Modbus TCP w loggerze WiFi/LAN
KH / KA
KH-10.5, KA-8.0
NIE
TAK
Platforma pokrewna H1, tylko RS485
H3 (3-faz. hybryda, 1. gen.)
H3-5.0-E … H3-12.0-E
NIE
TAK
Port 502 zamknięty, żaden firmware go nie otwiera
AC3 / AIO-H3
AC3-10.0, AIO-H3-8.0
NIE
TAK
Pochodne H3, komunikacja identyczna
H3 Pro
H3-Pro-15.0 … 30.0
ZALEŻY
TAK
Nowsze egzemplarze z loggerem WL-H3-G2 / Smart Logger mają serwer Modbus TCP, starsze wymagają RS485; sprawdź port 502
H3 Smart
H3-10.0-Smart, H3-12.0-M
TAK
TAK (EMS485)
Wbudowany Modbus TCP; modele z końcówką -M to też H3 Smart
P3 Smart / P3 SH
P3-5.0-SH
TAK
TAK
Wsparcie w integracji od wersji 1.15.0 (czerwiec 2026)
P3 Pro
P3-Pro-x.x
SPRAWDŹ
TAK
Wariant OEM H3 Pro, wsparcie od 1.15.0; sprawdź port 502 na swoim egzemplarzu
P1
P1-x.x
BETA
TAK
Wsparcie dodane w wersji beta 1.16.0b1, wkrótce w stabilnej
Seria T (sieciowe, bez baterii)
T5, T10, T15 …
NIE
TAK
Osobne integracje społeczności, wymaga ustawienia CT/Meter na Comm
Rebrandy (Kuara, Sonnenkraft, STAR, Solavita, a-TroniX, Enpal, 1KOMMA5°)
różne
ZALEŻY
TAK
Decyduje bazowy model FoxESS, na którym zbudowano urządzenie
Krótkie porównanie linii trójfazowych, bo tu jest najwięcej zamieszania. H3-x.x-E to pierwsza generacja, sprzedawana masowo w Polsce w latach 2022-2024 (taki falownik mam u siebie): tylko RS485. H3 Pro to mocniejsza wersja z nową mapą rejestrów, a obsługa Direct LAN zależy od konkretnej wersji sprzętowej oraz zastosowanego loggera: starsze konfiguracje wykorzystują RS485, natomiast nowsze egzemplarze ze zintegrowanym loggerem WL-H3-G2 / Smart Logger udostępniają lokalny serwer Modbus TCP. Przed zakupem konwertera warto po prostu sprawdzić, czy port 502 odpowiada (opisuję to niżej). Pełne wsparcie Direct LAN od początku mają H3 Smart i pokrewna seria P3, które dostały logger z wbudowanym serwerem Modbus TCP. W jednofazówkach analogicznie: zwykłe H1 i H1 G2 wymagają konwertera, a Direct LAN ma dopiero wariant H1 G2 WL.
Jak sprawdzić, czy Twój egzemplarz ma aktywny Modbus TCP
Sama nazwa modelu to dopiero połowa sukcesu. Serwer Modbus TCP działa na module komunikacyjnym i wymaga odpowiednio nowego firmware, więc warto zweryfikować trzy rzeczy zanim zaczniesz konfigurować Home Assistant.
Krok 1: Potwierdź model i firmware
Dokładne oznaczenie znajdziesz na tabliczce znamionowej falownika albo w menu na wyświetlaczu (Settings, potem Information, potem Model). Sprawdź też wersje firmware: Master, Slave, Manager oraz wersję loggera WiFi. Jeżeli falownik był instalowany dawno temu i nie aktualizowany, napisz zgłoszenie do wsparcia FoxESS z prośbą o zdalną aktualizację. To standardowa procedura, serwis robi to bez wizyt u klienta, a na starym firmware serwer Modbus TCP potrafi zwracać błędy albo w ogóle nie odpowiadać.
Krok 2: Znajdź adres IP falownika
Falownik podłączony do sieci (kablem lub przez WiFi) pojawi się na liście klientów DHCP w Twoim routerze, czasem pod nazwą typu solarmanager. Od razu zrób dla niego rezerwację adresu IP w routerze. Home Assistant będzie łączyć się po konkretnym adresie i zmiana IP po restarcie routera to jedna z najczęstszych przyczyn „zepsutej” integracji po kilku tygodniach działania.
Krok 3: Sprawdź, czy port 502 jest otwarty
Najszybszy test z dowolnego komputera w tej samej sieci:
nmap -p 502 192.168.1.50# albo prościej, bez instalowania nmap:
nc -zv 192.168.1.50 502
nc -zv 192.168.1.50 502
Jeżeli port jest otwarty (open), masz aktywny serwer Modbus TCP i możesz przechodzić do konfiguracji. Jeżeli widzisz closed lub filtered, zajrzyj jeszcze do menu falownika: w nowych modelach pod Settings, a następnie Communication, bywają dostępne opcje Ethernet i Modbus. Gdy to nie pomaga, a model teoretycznie powinien obsługiwać Direct LAN, wracamy do kroku 1, czyli aktualizacji firmware przez wsparcie FoxESS.
Konfiguracja Home Assistant krok po kroku
Do połączenia użyjemy integracji foxess_modbus autorstwa nathanmarlor. To najbardziej dopracowana integracja FoxESS dla Home Assistant, rozwijana od lat i utrzymywana przez aktywną społeczność. Upewnij się, że instalujesz wersję co najmniej 1.15.0, bo dopiero ona ma stabilne wsparcie dla H3 Smart i serii P3.
1. Instalacja przez HACS. Otwórz HACS, wyszukaj FoxESS – Modbus i pobierz integrację. Po instalacji zrestartuj Home Assistant. Jeżeli masz już starszą wersję (na przykład 1.13.x), po prostu ją zaktualizuj w HACS, konfiguracja zostanie zachowana.
2. Dodanie integracji. Przejdź do Ustawienia, potem Urządzenia i usługi, kliknij Dodaj integrację i wyszukaj FoxESS – Modbus. Jeśli integracja nie pojawia się na liście, wyczyść pamięć podręczną przeglądarki i odśwież stronę.
3. Wybór typu połączenia. Kreator zapyta o sposób połączenia z falownikiem. Wybierz opcję Direct LAN connection. Pozostałe opcje (adaptery sieciowe i USB) dotyczą klasycznej drogi przez konwerter RS485.
4. Dane połączenia. Podaj adres IP falownika (ten zarezerwowany w routerze), port 502 i adres slave 247. Integracja sama wykryje model falownika i wersję firmware, a następnie dobierze właściwą mapę rejestrów. Jeżeli Twój falownik nie ma najnowszego firmware Manager, w ustawieniach integracji możesz ręcznie wybrać wersję.
5. Encje i dashboard energii. Po chwili w Home Assistant pojawi się urządzenie z kilkudziesięcioma encjami: produkcja PV na strunach, moc i SoC baterii, pobór i oddawanie do sieci, napięcia i częstotliwość na fazach, temperatury, liczniki dzienne i całkowite. Encje energii podepnij w Panelu energii, a sensory mocy wykorzystaj w automatyzacjach. W modelach Smart integracja pozwala też zapisywać ustawienia: okna ładowania baterii, tryb pracy, Min SoC, a od wersji 1.16 również limit eksportu. Funkcje zapisu na świeżych modelach miewały jednak błędy wieku dziecięcego (w wersjach beta zdarzało się na przykład, że Force Charge przełączał H3 Smart w tryb Back-up przez błędny znak jednego rejestru), więc po pierwszych zmianach ustawień z poziomu HA zerknij do aplikacji Fox, czy falownik robi dokładnie to, czego oczekujesz.
Ile trwa cała operacja?
Przy działającym porcie 502 realnie 10 minut, z czego większość to restart Home Assistant po instalacji z HACS. Dla porównania: droga przez RS485 to zakup konwertera, czekanie na przesyłkę, rozbieranie złącza COM i konfiguracja mostka. Różnica jest kolosalna.
Najczęstsze problemy i rozwiązania
Connection refused (Errno 111)
Port 502 jest zamknięty. Najczęstsze przyczyny: falownik to jednak wariant -E bez serwera TCP, stary firmware loggera albo wyłączona komunikacja Modbus w menu falownika (Settings, potem Communication). Sprawdź port narzędziem nmap, a jeśli model powinien obsługiwać Direct LAN, zgłoś się do FoxESS o aktualizację firmware.
Exception Response: Illegal Address
Połączenie działa, ale falownik nie rozpoznaje odpytywanych rejestrów. To niemal zawsze niedopasowanie wersji: albo firmware falownika jest starszy niż zakłada integracja, albo odwrotnie. Zaktualizuj integrację do najnowszej stabilnej wersji, a w jej ustawieniach spróbuj ręcznie wybrać wersję Manager odpowiadającą Twojemu firmware. Jeśli to nie pomaga, poproś FoxESS o aktualizację falownika.
No response received, expected at least 8 bytes
Klasyk z okresu beta. Serwer w loggerze przyjmuje połączenie, ale nie odpowiada na konkretne zapytania. W czasach wersji testowych pomagało przejście na konkretną betę (społeczność masowo używała 1.14.0b3), dziś w pierwszej kolejności zaktualizuj integrację do najnowszego stabilnego wydania i upewnij się, że logger WiFi ma aktualny firmware. Pomaga też restart falownika, bo logger potrafi się zawiesić. Jedna uwaga: wiosną 2026 część użytkowników zgłaszała, że połączenie psuje się po aktualizacji samego Home Assistant Core, a pomagało dopiero dobranie zgodnej pary wersji HA i integracji. Jeśli problem pojawił się zaraz po aktualizacji HA, zajrzyj do zakładki Discussions projektu foxess_modbus, zanim zaczniesz grzebać w falowniku.
Inverter model not supported
Integracja nie zna oznaczenia Twojego modelu. Tak było z P3-5.0-SH na początku 2026 roku, zanim wsparcie trafiło do wydania 1.15.0. Rozwiązanie: aktualizacja integracji, a jeśli model jest naprawdę świeży, zajrzyj do zakładki Discussions na GitHubie projektu, zwykle ktoś już zgłosił temat i wsparcie czeka w wersji beta.
Wszystkie encje pokazują unknown
Połączenie stoi, urządzenie jest w Home Assistant, ale każdy sensor świeci „unknown”. Sekret tkwi w tym, że integracja odczytuje model falownika tylko raz, przy pierwszej konfiguracji, i na tej podstawie dobiera mapę rejestrów. Jeżeli konfigurowałeś falownik na starszej wersji integracji albo przed aktualizacją firmware, stara detekcja zostaje. Rozwiązanie potwierdzone przez społeczność: usuń falownik z integracji (a przy uporczywych przypadkach całą integrację), zrestartuj Home Assistant, zainstaluj najnowszą wersję i dodaj urządzenie od nowa, żeby model został wykryty ponownie.
Integracja gubi połączenie co kilka dni
Dwa typowe winowajcy. Pierwszy: brak rezerwacji DHCP i zmieniający się adres IP falownika. Drugi: falownik połączony przez WiFi na granicy zasięgu. Logger ma słabą antenę, a falowniki wiszą zwykle w garażu albo kotłowni, daleko od routera. Jeżeli masz możliwość, pociągnij kabel Ethernet, a jeśli nie, postaw blisko falownika punkt dostępowy.
RS485 czy Direct LAN, co wybrać?
Jeżeli masz falownik z wbudowanym Modbus TCP, odpowiedź w większości przypadków brzmi: Direct LAN. Zero dodatkowego sprzętu, zero pracy przy falowniku, konfiguracja w 10 minut. Dla typowego użytkownika, który chce widzieć produkcję w Panelu energii i sterować grzaniem CWU z nadwyżek, to rozwiązanie w zupełności wystarczy.
RS485 wciąż ma jednak swoje mocne strony i nie jest to droga tylko dla posiadaczy starszych modeli. Po pierwsze, historia lubi się powtarzać: FoxESS raz już wyłączył firmware’em działające połączenie sieciowe w falownikach H1 pierwszej generacji. Wbudowany serwer TCP w modelach Smart to funkcja kontrolowana przez producenta i teoretycznie kolejna aktualizacja może ją zmienić albo ograniczyć. Fizyczna magistrala RS485 jest poza zasięgiem takich decyzji, to po prostu przewody i standard przemysłowy sprzed dekad. Po drugie, na starszych generacjach RS485 daje dostęp do rejestrów, których interfejs sieciowy nigdy nie udostępniał, między innymi szczegółów BMS baterii. Po trzecie, połączenie kablowe przez konwerter bywa po prostu stabilniejsze niż logger WiFi wiszący na granicy zasięgu.
Moja rekomendacja wygląda tak: masz model Smart, WL albo P3, zaczynasz od Direct LAN i najpewniej na tym kończysz. Masz H3-E, H1, KH albo inny starszy model, nie masz wyboru, RS485 to Twoja droga i naprawdę nie ma się czego bać. Cały potrzebny sprzęt to konwerter za kilkadziesiąt złotych, a poradnik krok po kroku dla H3 znajdziesz u mnie na blogu.
FAQ: FoxESS Direct LAN i Home Assistant
Czy mój H3-10.0-E obsłuży Direct LAN po aktualizacji firmware?
Nie. W falownikach H3 pierwszej generacji (końcówka -E) port 502 jest zamknięty i żadna dotychczasowa wersja firmware tego nie zmienia. Jedyna droga do lokalnej integracji z Home Assistant to konwerter RS485 podpięty do złącza COM.
Czy Direct LAN wymaga kabla Ethernet?
Nie, nazwa jest trochę myląca. Serwer Modbus TCP działa na module komunikacyjnym falownika, więc wystarczy, że falownik jest w Twojej sieci lokalnej, kablem albo przez WiFi. Kabel polecam ze względu na stabilność, ale nie jest obowiązkowy.
Jaki port i adres slave ustawić w integracji foxess_modbus?
Port 502, adres slave 247. To domyślne wartości serwera Modbus TCP w falownikach FoxESS i integracja podpowiada je w kreatorze konfiguracji.
Czy przez Direct LAN mogę sterować falownikiem, czy tylko odczytywać dane?
Na modelach Smart integracja pozwala również zapisywać ustawienia: okna ładowania baterii, tryb pracy, minimalny SoC, a w najnowszych wersjach także limit eksportu do sieci. Zakres funkcji zależy od modelu i wersji firmware, pełną listę znajdziesz na wiki projektu foxess_modbus w sekcji Supported Features.
Czy FoxESS oficjalnie wspiera integrację z Home Assistant?
Nie. Zarówno foxess_modbus, jak i pozostałe integracje to projekty społeczności. FoxESS nie publikuje oficjalnego wsparcia dla Modbusa w zastosowaniach domowych, ale współpracuje z twórcami integracji i w nowej generacji falowników udostępnił najbardziej uporządkowaną mapę rejestrów w historii marki. Trzeba jednak pamiętać, że producent kontroluje firmware i może zmieniać zachowanie interfejsu sieciowego.
Mam falownik marki Kuara / Enpal / 1KOMMA5°, czy to też zadziała?
To rebrandowane konstrukcje FoxESS i integracja foxess_modbus obsługuje wiele z nich (Kuara H3, Sonnenkraft SK-HWR, STAR, Solavita SP, a-TroniX AX, Enpal, 1KOMMA5°). O dostępności Direct LAN decyduje bazowy model: jeżeli urządzenie zbudowano na platformie Smart, serwer TCP powinien być na pokładzie. W pozostałych przypadkach pozostaje RS485.
Podsumowanie
Otwarcie serwera Modbus TCP w nowych falownikach to najlepsza rzecz, jaka spotkała posiadaczy FoxESS od lat. Integracja, która kiedyś wymagała konwertera, przewodów i grzebania w złączu COM, dziś na modelach H3 Smart, H1 G2 WL i serii P3 sprowadza się do podania adresu IP. Od czerwca 2026 wszystko działa na stabilnej wersji integracji foxess_modbus, bez konieczności instalowania wydań beta.
Zapamiętaj trzy rzeczy. Po pierwsze, o wszystkim decyduje dokładne oznaczenie modelu: Smart, WL i M oznaczają wbudowany Modbus TCP, końcówka E oznacza RS485. Po drugie, przed konfiguracją sprawdź firmware i port 502, to dwie minuty, które oszczędzą Ci godzin debugowania. Po trzecie, jeżeli masz starszy model, nie masz czego żałować: RS485 daje dokładnie te same dane, a często nawet pełniejszy dostęp do rejestrów.
Jeżeli masz H3 pierwszej generacji tak jak ja, zajrzyj do mojego poradnika o podłączeniu FoxESS H3 przez RS485 i ESP32. A jeśli właśnie skonfigurowałeś Direct LAN na nowym Smart, daj znać w komentarzu, jak sprawuje się połączenie, zbieram doświadczenia czytelników do aktualizacji tabeli zgodności.
