--- title: "Huawei SUN2000" description: "Integracja Modbus TCP falownika Huawei SUN2000 3-10KTL — moc czynna, stringi PV, napięcia sieci, SOC baterii, stan falownika i zapisywalny limit eksportu." url: "https://taphome.com/pl/compatibility/sun2000-tcp/" language: pl lastmod: 2026-10-08 generator: hugo ai: topics: ["modbus-tcp","inverter","solar","pv-monitoring","battery-storage","export-power-control"] questions: ["Jak zintegrować falownik solarny Huawei SUN2000 z TapHome?","Co mierzy i kontroluje szablon Huawei SUN2000 w TapHome?","Jak podłączyć Huawei SUN2000 przez Modbus TCP za pomocą Smart Dongle?","Jak ograniczyć moc eksportu do sieci na Huawei SUN2000 z TapHome?","Jak odczytać stan naładowania baterii LUNA2000 przez TapHome?","Dlaczego falownik SUN2000 zawiesza się w stanie Idle?"] --- # Huawei SUN2000 Komunikacja: Modbus TCP - [Huawei FusionSolar](https://solar.huawei.com/en/products/residential/inverters) Seria Huawei SUN2000 3-10KTL obejmuje jednofazowe i trójfazowe falowniki stringowe do mieszkaniowych systemów PV o mocy znamionowej od 3 kW do 10 kW. TapHome łączy się z falownikiem przez Modbus TCP — za pośrednictwem Huawei Smart Dongle (WLAN-FE lub 4G) podłączonego do portu USB falownika lub bezpośrednio przez wbudowany punkt dostępowy WiFi falownika. Szablon zapewnia monitorowanie mocy czynnej w sieci, dzienne i całożyciowe liczniki energii, odczyt prądu maksymalnie 4 stringów PV, indywidualne czujniki napięć fazowych, częstotliwość sieci, zagregowaną produkcję DC, stan naładowania baterii (dla LUNA2000), stan pracy falownika ze szczegółowym dekodowaniem podstanów oraz zapisywalne ograniczenie eksportu do sieci. Działania serwisowe na poziomie modułu umożliwiają kompensację mocy biernej (PF i Q/S) oraz ograniczenie mocy czynnej. ## Włączanie komunikacji Modbus Falownik SUN2000 obsługuje Modbus TCP zarówno przez wbudowany punkt dostępowy WiFi, jak i przez Smart Dongle. Do trwałego połączenia z TapHome zalecane jest użycie **Huawei Smart Dongle-WLAN-FE** (lub Smart Dongle-4G) podłączonego do portu USB falownika. ### Opcje połączenia | Metoda | Interfejs | Uwagi | |--------|-----------|-------| | **Smart Dongle (zalecany)** | Ethernet / WiFi | Łączy falownik z lokalną siecią LAN. Umożliwia jednoczesny dostęp Modbus TCP i z aplikacji FusionSolar. | | **Punkt dostępowy WiFi** | WiFi | Bezpośrednie połączenie z AP falownika (SSID: `SUN2000-`). Tylko jeden klient na raz. | | **RS-485 (Modbus RTU)** | Piny portu COM RS485A1/B1 | Nie używany przez ten szablon. Nie może działać jednocześnie z monitorowaniem FusionSolar. | > [!WARNING] > W przypadku korzystania z metody punktu dostępowego WiFi, aplikacja FusionSolar nie może łączyć się jednocześnie. W instalacjach produkcyjnych zawsze używaj Smart Dongle, aby TapHome i FusionSolar mogły działać równolegle. ### Konfiguracja Smart Dongle 1. Podłącz Smart Dongle-WLAN-FE do portu USB na spodzie falownika 2. Połącz Smart Dongle z lokalną siecią WiFi za pomocą aplikacji FusionSolar (konfiguracja początkowa) 3. Dongle uzyska adres IP z routera przez DHCP 4. Zanotuj adres IP z tabeli dzierżaw DHCP routera > [!TIP] > Przypisz Smart Dongle statyczny adres IP (lub rezerwację DHCP) w ustawieniach routera, aby adres nie zmieniał się po wyłączeniu zasilania. ## Połączenie sieciowe - **Protokół:** Modbus TCP - **Port:** 502 (standardowy port Modbus TCP) - **Domyślne Slave ID:** 1 - **Kolejność bajtów:** Big-endian (standardowy Modbus) - **Używany zakres rejestrów:** H:30000 — H:47418 > [!NOTE] > Biblioteka `huawei-solar-lib` dla Home Assistant w trybie WiFi AP używa domyślnie portu 503. Przy połączeniu przez Smart Dongle w lokalnej sieci TapHome używa standardowego portu Modbus TCP **502**. ## Konfiguracja Podczas importowania szablonu w TapHome podaj: - **Adres IP** — adres IP Smart Dongle w lokalnej sieci (lub IP AP WiFi falownika, domyślnie: 192.168.200.1) - **Slave ID** — adres slave Modbus (domyślnie: 1) ## Funkcje urządzeń Szablon udostępnia 16 urządzeń pogrupowanych według funkcji poniżej. ### Monitorowanie mocy i energii - **Moc czynna** — licznik energii Modbus odczytujący dzienny skumulowany uzysk z H:32114 (kWh) oraz chwilową moc czynną pobieraną z sieci z H:37113 (kW). Zawiera 11 atrybutów serwisowych (szczytowa moc czynna dnia, moc bierna, znamionowa/maks. moc czynna, maks. moc pozorna, maks. moc bierna oddawana/pobierana, kompensacja mocy biernej PF i Q/S, ograniczenie mocy czynnej w % oraz wartości stałej) i 3 działania serwisowe (kompensacja mocy biernej PF, kompensacja mocy biernej Q/S, ograniczenie mocy czynnej %). - **Energia całkowita** — skumulowana energia całożyciowa wyprodukowana przez falownik od uruchomienia, w kWh (H:32106). - **Energia dziś** — energia wytworzona od północy, resetuje się codziennie, w kWh (H:32114). - **Produkcja DC** — zagregowana moc wejściowa DC ze wszystkich stringów PV w kW (H:32064). Atrybuty serwisowe udostępniają częstotliwość sieci (H:32085), napięcia fazowe A/B/C (H:32069–32071) oraz prądy fazowe A/B/C (H:32072–32076). ### Monitorowanie stringów PV Cztery urządzenia czujnikowe, po jednym na string PV, raportują prąd DC w amperach. Każde urządzenie zawiera atrybut serwisowy dla odpowiadającego napięcia DC stringu: | Urządzenie | Rejestr prądu | Atrybut napięcia | |------------|---------------|------------------| | **PV1 prąd** | H:32017 | H:32016 | | **PV2 prąd** | H:32019 | H:32018 | | **PV3 prąd** | H:32021 | H:32020 | | **PV4 prąd** | H:32023 | H:32022 | > [!NOTE] > Liczba aktywnych urządzeń stringów PV zależy od modelu falownika i instalacji. Nieużywane wejścia stringów odczytują 0 A — na przykład model 3KTL zazwyczaj wykorzystuje tylko PV1 i PV2. ### Parametry sieci - **Napięcie fazy A** — napięcie faza-neutralny na linii A w V (H:32069). - **Napięcie fazy B** — napięcie faza-neutralny na linii B w V (H:32070). - **Napięcie fazy C** — napięcie faza-neutralny na linii C w V (H:32071). - **Częstotliwość sieci** — częstotliwość sieci AC na wyjściu falownika w Hz (H:32085). ### Bateria (LUNA2000) - **SOC baterii** — stan naładowania baterii jako ułamek dostępnej pojemności, odczytywany z H:37760. Gdy falownik raportuje wartość powyżej 1 (brak baterii), urządzenie dodaje informacyjną wiadomość *„Batéria nepripojená"* (Bateria niepodłączona). > [!WARNING] > Dokument Huawei Modbus Interface Definitions V3.0 określa dla rejestru H:37760 gain 10 (procent z jednym miejscem dziesiętnym). Szablon TapHome używa gain 1000, co odczytuje wartość jako ułamek (0,0–1,0). Obie reprezentacje udostępniają te same dane bazowe — zinterpretuj wyświetloną wartość odpowiednio. ### Kontrola eksportu mocy - **Maksymalna moc do sieci** — **zapisywalne** ograniczenie eksportu wyrażone jako procent mocy znamionowej (H:47418, Int16, gain 10). Ustaw to urządzenie, aby ograniczyć, ile energii falownik oddaje do sieci. - **Maksymalna moc do sieci (W)** — czujnik (tylko do odczytu) raportujący aktualnie obowiązujący limit eksportu jako bezwzględną wartość w kW (H:47416, Int32, gain 1000). > [!WARNING] > Rejestry H:47416 i H:47418 **nie są udokumentowane** w oficjalnym dokumencie Huawei Solar Inverter Modbus Interface Definitions V3.0 (2023-01-16). Są to rozszerzenia producenta na nowszym firmware, potwierdzone tylko poprzez testy w terenie. Zachowanie może się różnić w zależności od wersji firmware falownika — przed poleganiem na limicie w automatyzacjach zweryfikuj odpowiedź po zapisie do H:47418. ### Stan pracy falownika Przełącznik wielowartościowy (odczytywany z H:32089), który mapuje ponad 20 surowych kodów stanu Huawei na 10 wysokopoziomowych stanów: | Wartość | Stan | Surowe kody źródłowe | |---------|------|----------------------| | 0 | Stan czuwania | 0 | | 1 | Bezczynny / Brak nasłonecznienia | 1, 2, 3, 40960 | | 2 | Uruchamianie | 256 | | 3 | Podłączony do sieci | 512, 513, 514 | | 4 | Wyłączenie | 768–774 | | 5 | Regulacja sieci | 1025, 1026 | | 6 | Skanowanie IV | 2048 | | 7 | Kontrola wyrywkowa | 1280, 1281 | | 8 | Inspekcja | 1536 | | 9 | Wykrywanie wejścia DC | 2304 | Atrybuty serwisowe zapewniają głębszy wgląd w stan: - **Pełny stan** — pełny stan falownika zdekodowany z H:32089 ze wszystkimi ponad 20 surowymi podstanami (Idle: Initializing, Idle: Detecting ISO, On-Grid: Power Limit, Shutdown: Fault, Shutdown: OVGR, Grid dispatch: krzywa cos(Phi)-P itd.). - **Połączenie z siecią** — wyprowadzone z bitów H:32000: Stan czuwania, Normalne połączenie z siecią, Połączenie z deratingiem z powodu ograniczenia mocy, Połączenie z deratingiem z powodu wewnętrznych przyczyn falownika lub Niepodłączony. - **Teleindykacja** — stan telesygnalizacji IEC 60870-5-104 z bitów H:32000: Stan czuwania, Normalne zatrzymanie, Zatrzymanie z powodu awarii, Zatrzymanie z powodu ograniczenia mocy, Wyłączenie, Kontrola wyrywkowa, Podłączony do sieci. - **Status blokady** — Zablokowany lub Odblokowany, wyprowadzony z bitu 0 H:32002. - **Status połączenia PV** — Podłączony lub Odłączony, wyprowadzony z bitu 0 H:32002. - **Czas uruchomienia** — najnowszy czas uruchomienia w ciągu dnia (HH:MM) z H:32091. - **Czas wyłączenia** — najnowszy czas wyłączenia w ciągu dnia (HH:MM) z H:32093. ### Diagnostyka na poziomie modułu Moduł udostępnia atrybuty serwisowe do identyfikacji urządzenia i diagnostyki: | Atrybut | Rejestr | Opis | |---------|---------|------| | Nazwa modelu | H:30000 | Identyfikator modelu z tabliczki znamionowej falownika | | SN | H:30015 | Numer seryjny | | PN | H:30025 | Numer części | | Model ID | H:30070 | Numeryczny identyfikator modelu | | Liczba stringów | H:30071 | Stringi PV obsługiwane przez sprzęt | | Liczba MPPT | H:30072 | Liczba niezależnych trackerów MPPT | | Czas systemowy | H:40000 | Wewnętrzny zegar falownika | | Strefa czasowa | H:43006 | Skonfigurowane przesunięcie UTC | | Sprawność falownika | H:32086 | Aktualna sprawność konwersji AC/DC (%) | | Temperatura obudowy | H:32087 | Wewnętrzna temperatura obudowy (°C) | | Rezystancja izolacji | H:32088 | Rezystancja izolacji po stronie DC (MΩ) | | Zbieranie danych DSP | H:32002 | Czy DSP falownika zbiera telemetrię | Działanie serwisowe **Strefa czasowa** pozwala ustawić przesunięcie UTC falownika (zapis do H:43006). Obsługiwane wartości obejmują zakres od UTC-12:00 do UTC+14:00. ### Monitorowanie alarmów Skrypt odczytu na poziomie modułu odpytuje rejestry alarmów H:32008 (Alarm 1) i H:32009 (Alarm 2) i dekoduje każdy bit jako nazwany błąd lub ostrzeżenie. Godne uwagi alarmy: | Rejestr | Bit | Alarm | |---------|-----|-------| | H:32008 | 0 | Wysokie napięcie stringu | | H:32008 | 1 | Łuk DC | | H:32008 | 2 | Odwrócona polaryzacja stringu | | H:32008 | 3 | Nieprawidłowy string (ostrzeżenie) | | H:32008 | 5 | Błąd AFCI | | H:32008 | 7 | Awaria sieci elektrycznej | | H:32008 | 8–9 | Pod-/Przepięcie sieci | | H:32008 | 11–13 | Błędy częstotliwości sieci | | H:32008 | 14–15 | Przeciążenie wyjścia / Składowa DC | | H:32009 | 0 | Nieprawidłowy prąd upływu | | H:32009 | 1–2 | Nieprawidłowe uziemienie / Niska izolacja | | H:32009 | 3–4 | Wysoka temperatura / Awaria urządzenia | | H:32009 | 9 | Nieprawidłowe urządzenie magazynowania energii | | H:32009 | 10–11 | Wyspowość aktywna/pasywna | | H:32009 | 15 | Nieprawidłowa konfiguracja modułu PV | ## Rozwiązywanie problemów ### Brak komunikacji Modbus 1. Sprawdź, czy Smart Dongle jest podłączony do portu USB falownika i ma zasilanie (świeci dioda LED). 2. Potwierdź adres IP dongla w tabeli dzierżaw DHCP routera. 3. Upewnij się, że TapHome Core i Smart Dongle znajdują się w tej samej sieci / podsieci. 4. Sprawdź, czy żadna zapora sieciowa nie blokuje portu TCP 502. 5. Jeśli używasz trybu WiFi AP, połącz się z SSID falownika (`SUN2000-`) i użyj IP `192.168.200.1`. ### Wartości stringów PV odczytują zero Nieużywane wejścia stringów PV zawsze odczytują 0 A i 0 V. Jest to normalne dla modeli falowników z mniejszą liczbą wejść MPPT niż zapewnia szablon (np. model 3KTL zazwyczaj używa tylko PV1 i PV2). ### SOC baterii pokazuje „Batéria nepripojená" lub wartości powyżej 100 % Rejestry baterii LUNA2000 są wypełniane tylko wtedy, gdy do falownika fizycznie podłączona jest kompatybilna bateria. Bez baterii rejestr H:37760 zwraca wartości spoza oczekiwanego zakresu i szablon generuje informacyjny komunikat *„Batéria nepripojená"* (Bateria niepodłączona). ### Falownik zawieszony w stanie Idle W godzinach nocnych lub przy niskim nasłonecznieniu falownik pozostaje w stanie **Idle** (podstany „Detecting ISO", „Detecting irradiation", „Grid Detecting" lub „No irradiation"). Falownik automatycznie przechodzi do stanu **On-Grid** po wykryciu wystarczającego nasłonecznienia. ### Zapis do Maksymalna moc do sieci nie daje efektu Rejestry H:47416 i H:47418 są rozszerzeniami producenta i nie występują w oficjalnej dokumentacji Modbus V3.0. Jeśli limit eksportu nie ma efektu, zweryfikuj: 1. Czy wersja firmware falownika obsługuje funkcję ograniczenia eksportu. 2. Czy Smart Dongle jest podłączony i nie znajduje się w trybie pass-through używanym przez usługi kodu sieciowego FusionSolar. 3. Czy żaden konfliktowy kod sieciowy ani sygnał DRM nie nadpisuje lokalnego limitu. ### Podstan Shutdown pokazuje OVGR / DC Switch OFF Te podstany wyłączenia (zdekodowane z H:32089) wskazują, że falownik został zatrzymany przez sygnał ochronny — OVGR przez zewnętrzny styk OVGR lub DC Switch OFF przez fizyczny rozłącznik DC na falowniku. Przed próbą zdalnego włączenia usuń przyczynę fizyczną. ## Dostępne urządzenia SUN2000 TCP Moduł Moc czynna Licznik energii Licznik energii — dzienny uzysk (kWh) i chwilowa moc czynna z sieci (kW), z mocą bierną, współczynnikiem mocy, szczytową mocą dnia i zapisywalnymi akcjami ograniczenia Rejestr: H:32114 UInt32 / Int32 Jednostka: kWh / kW numeric SOC baterii Wejście analogowe Tylko do odczytu Stan naładowania baterii — ułamek dostępnej pojemności; wartości powyżej 100 % wywołują komunikat „Bateria niepodłączona“ Rejestr: H:37760 UInt16 numeric Energia całkowita Zmienna Tylko do odczytu Skumulowana energia całożyciowa wyprodukowana przez falownik od uruchomienia (kWh) Rejestr: H:32106 UInt32 Jednostka: kWh numeric Energia dziś Zmienna Tylko do odczytu Energia wytworzona od północy; resetuje się codziennie (kWh) Rejestr: H:32114 Int32 Jednostka: kWh numeric Częstotliwość sieci Zmienna Tylko do odczytu Częstotliwość sieci AC na wyjściu falownika (Hz) Rejestr: H:32085 UInt16 Jednostka: Hz numeric Maksymalna moc do sieci Ściemniacz Zapisywalne ograniczenie eksportu jako procent mocy znamionowej — ogranicza ilość energii oddawanej do sieci Rejestr: H:47418 Int16 Jednostka: % numeric Maksymalna moc do sieci (W) Zmienna Tylko do odczytu Aktualnie obowiązujący limit eksportu wyrażony jako bezwzględna wartość mocy (kW) Rejestr: H:47416 Int32 Jednostka: kW numeric Napięcie fazy A Zmienna Tylko do odczytu Napięcie faza-neutralny na linii A (V) Rejestr: H:32069 UInt16 Jednostka: V numeric Napięcie fazy B Zmienna Tylko do odczytu Napięcie faza-neutralny na linii B (V) Rejestr: H:32070 UInt16 Jednostka: V numeric Napięcie fazy C Zmienna Tylko do odczytu Napięcie faza-neutralny na linii C (V) Rejestr: H:32071 UInt16 Jednostka: V numeric PV1 prąd Zmienna Tylko do odczytu Rejestr: H:32017 Int16 Jednostka: A numeric Atrybuty serwisowe | | |--------------| | PV1 napięcie | PV2 prąd Zmienna Tylko do odczytu Rejestr: H:32019 Int16 Jednostka: A numeric Atrybuty serwisowe | | |--------------| | PV2 napięcie | PV3 prąd Zmienna Tylko do odczytu Rejestr: H:32021 Int16 Jednostka: A numeric Atrybuty serwisowe | | |--------------| | PV3 napięcie | PV4 prąd Zmienna Tylko do odczytu Rejestr: H:32023 Int16 Jednostka: A numeric Atrybuty serwisowe | | |--------------| | PV4 napięcie | Stan falownika Przełącznik wielowartościowy Stan pracy falownika zmapowany na 10 wysokopoziomowych kodów — Stan czuwania, Bezczynny/Brak nasłonecznienia, Uruchamianie, Podłączony do sieci, Wyłączenie, Regulacja sieci, Skanowanie IV, Kontrola wyrywkowa, Inspekcja, Wykrywanie wejścia DC Rejestr: H:32089 UInt16 numeric Wartości / Stany: ON · OFF Produkcja DC Zmienna Tylko do odczytu Zagregowana moc wejściowa DC ze wszystkich stringów PV (kW), z atrybutami serwisowymi po stronie sieci — częstotliwość, napięcia i prądy fazowe A/B/C Rejestr: H:32064 Int32 Jednostka: kW numeric Atrybuty serwisowe | | |-----------------| | Częstotliwość | | Napięcie fazy A | | Napięcie fazy B | | Napięcie fazy C | | Prąd fazy A | | Prąd fazy B | | Prąd fazy C | **Połączenie:** Modbus TCP • Slave ID: $\[SlaveId] Możliwe ulepszenia (24) - H:30035 Firmware Version — STR, 15 regs — useful for diagnostics and version-specific feature gating - H:30050 Software Version — STR, 15 regs — main controller software build - H:31000 Hardware Version — STR, 15 regs — hardware revision identifier - H:32010 Alarm 3 — Bitfield16, additional alarm bits beyond Alarm 1/2 handled by readscript - H:32066 Line Voltage A-B — U16, V, /10 — line-to-line grid voltage - H:32067 Line Voltage B-C — U16, V, /10 — line-to-line grid voltage - H:32068 Line Voltage C-A — U16, V, /10 — line-to-line grid voltage - H:32080 Active Power (instantaneous) — I32, kW, /1000 — instantaneous active power; template now uses H:37113 grid-side power instead - H:32084 Power Factor — I16, /1000 — referenced in legacy Active Power service attributes but not exposed as standalone sensor - H:32090 Fault Code — U16 — specific fault code when device is in shutdown:fault state - H:32108 Total DC Input Energy — U32, kWh, /100 — cumulative DC energy input across all PV strings - H:32116 Monthly Energy — U32, kWh, /100 — energy generated this month - H:32118 Yearly Energy — U32, kWh, /100 — energy generated this year - H:37101 Grid Phase A Voltage (power meter) — I32, V, /10 — phase voltage measured by external power meter (different sensor than H:32069) - H:37107 Grid Phase A Current (power meter) — I32, A, /100 — phase current measured by external power meter - H:37119 Grid Exported Energy (active) — I32, kWh, /100 — energy exported to the grid - H:37121 Grid Exported Energy — U32, kWh, /100 — cumulative grid export counter - H:37123 Grid Accumulated Energy — U32, kWh, /100 — total energy from grid (import) - H:37762 Battery Running Status — U16 enum — 0=Offline, 1=Standby, 2=Running, 3=Fault, 4=Sleep - H:37765 Battery Charge/Discharge Power — I32, W — positive=charging, negative=discharging - H:37784 Battery Daily Charge — U32, kWh, /100 — today's battery charge energy - H:37786 Battery Daily Discharge — U32, kWh, /100 — today's battery discharge energy - H:40200 Power On — WO, E16 — remote inverter power-on command - H:40201 Shutdown — WO, E16 — remote inverter shutdown command ## Źródła - Solar Inverter Modbus Interface Definitions (V3.0) 2026-03-13 [PDF](https://taphome.com/compatibility/devices/sun2000-tcp/manufacturer/modbus-interface-definitions-v3.pdf) - huawei-solar-lib — Python Modbus Library [github.com](https://github.com/wlcrs/huawei-solar-lib) 2026-03-13 ## Powiązana dokumentacja - [Modbus Integration](https://taphome.com/pl/compatibility/modbus-guide/) - [Modbus](https://taphome.com/pl/docs/integration/modbus/) - [Prosta konfiguracja za pomocą szablonów](https://taphome.com/pl/docs/integration/modbus/templates/) - [Skrypty Modbus i prefetch](https://taphome.com/pl/docs/script/modbus-scripts/) - [Funkcje Modbus](https://taphome.com/pl/docs/script/modbus/) - [Typy danych Modbus](https://taphome.com/pl/docs/script/modbus-data-types/)