---
title: "SolaX X3 Hybrid Ultra"
description: "SolaX X3-Ultra: monitorizați PV, SOC-ul bateriei, tensiunea/frecvența rețelei; setați modul încărcătorului și SOC-ul de noapte prin Modbus RTU."
url: "https://taphome.com/ro/compatibility/solax-hybrid-ultra-x3/"
language: ro
lastmod: 2026-10-14
generator: hugo
ai:
  topics: ["modbus-rtu","inverter","solar","rs485","battery-storage","3-phase","hybrid-inverter","energy-monitoring","gen5"]
  questions: ["TapHome acceptă invertorul SolaX X3 Hybrid Ultra?","Cum cablez RS-485 de la portul COM 1 al SolaX X3-Ultra la TapHome?","Ce modele SolaX X3-Ultra funcționează cu șablonul TapHome?","Care este baud rate-ul Modbus implicit la SolaX X3-Ultra?","Cum citesc SOC-ul bateriei de la SolaX X3 Hybrid Ultra prin Modbus RTU?","De ce PV3 și SOC baterie 2 afișează zero la SolaX X3-Ultra?"]
---

# SolaX X3 Hybrid Ultra

Comunicație: Modbus RTU

- [Site-ul oficial SolaX Power](https://www.solaxpower.com)
- [Pagina produsului SolaX X3-Ultra](https://www.solaxpower.com/x3-ultra/)

## Ghid de integrare

SolaX X3 Hybrid Ultra (Gen5) este un invertor hibrid trifazat PV/baterie, cu puteri nominale de la 10 kW la 30 kW. Șablonul TapHome comunică cu invertorul prin **Modbus RTU pe portul RS-485 COM 1** (pinii REMOTE_485A / REMOTE_485B) și implementează harta de registre a protocolului SolaX Modbus V3.29. Citește puterea stringurilor PV, starea de încărcare și temperatura bateriei, tensiunea și frecvența trifazată a rețelei, energia zilnică și energia totală produsă pe toată durata de funcționare, puterea injectată de la contorul extern și pune la dispoziție pentru scriere modul de utilizare a încărcătorului, SOC-ul de încărcare de noapte în modul Self Use și limita maximă a puterii injectate.

X3-Ultra **nu** acceptă nativ Modbus TCP: TCP este disponibil doar printr-un modul de monitorizare SolaX (Pocket WiFi 3.0, Pocket LAN sau DataHub), care face legătura RTU–TCP pe portul 502. Pentru instalațiile la distanță, TapHome poate fi conectat și printr-un gateway RS-485–Ethernet terț (de ex. Waveshare, USR-DR302) configurat ca Modbus RTU-over-TCP.

## Modele

Șablonul TapHome acoperă întreaga serie X3-Ultra. Senzorii PV3 și SOC baterie 2 funcționează doar la varianta de 30 kW cu 3 MPPT / două baterii.

| Model | Putere AC nominală | Trackere MPPT | Note |
|-------|----------------|---------------|-------|
| X3-ULT-15K | 15 kW | 2 | Standard, 2 MPPT |
| X3-ULT-15KP | 15 kW | 3 | 3 MPPT (cod model H3BC) |
| X3-ULT-19.9K | 19,9 kW | 2 | Standard, 2 MPPT |
| X3-ULT-20K | 20 kW | 2 | Standard, 2 MPPT (cod model H3BD) |
| X3-ULT-20KP | 20 kW | 3 | 3 MPPT |
| X3-ULT-25K | 25 kW | 3 | Cod model H3BF |
| X3-ULT-25KW | 25 kW | 3 | — |
| X3-ULT-30K | 30 kW | 3 | Două baterii, PV3 activ (cod model H3BG) |
| X3-ULT-10K-GLV | 10 kW | — | Variantă de joasă tensiune (GLV) |
| X3-ULT-15K-GLV | 15 kW | — | Variantă de joasă tensiune (GLV) |

Codul modelului poate fi citit în timpul funcționării prin atributul de modul **Model** (registrul H:0x000E, șir ASCII de 4 caractere).

## Domeniul compatibilității

Șablonul implementează subsetul protocolului SolaX Modbus V3.29 folosit cel mai des pentru managementul energetic al locuinței: 19 dispozitive, 2 atribute de service la nivelul modulului și o acțiune de service. Protocolul complet pune la dispoziție mult mai multe registre; cele mai utile funcții neimplementate (puterea și curentul rețelei pe fiecare fază, tensiunea/curentul/puterea bateriei, starea BMS, timpul de funcționare off-grid, controlul de la distanță al puterii etc.) pot fi adăugate într-o actualizare viitoare a șablonului. Șablonul comunitar corectat din portalul TapHome adaugă deja controlul de la distanță al puterii și scrieri ale setărilor care au loc doar la schimbarea valorii; consultați mai jos Probleme cunoscute ale șablonului oficial și Controlul de la distanță al puterii.

## Conectarea hardware

X3-Ultra are un singur **port COM 1** multifuncțional (conector de tip RJ45 cu un suport de cablu etichetat). Aceiași pini fizici au funcții diferite, în funcție de poziția etichetată din suportul de cablu în care introduceți cablul. Pentru integrarea prin Modbus cu sisteme terțe folosiți poziția **RS485**, adică liniile **REMOTE_485A** și **REMOTE_485B**.

### Alocarea pinilor portului COM 1

![Alocarea pinilor portului COM 1 al SolaX X3-Ultra pentru toate cele șase poziții etichetate (Parallel-1, Parallel-2, BMS-1, BMS-2, RS485, DRM)](https://taphome.com/images/compatibility/solax-hybrid-ultra-x3/com1-pinout_hu_4124a3cd9e8bc981.jpg)

Alocarea pinilor pentru **poziția RS485** (singura poziție relevantă pentru TapHome):

| Pin | Semnal | Cablare TapHome |
|-----|--------|----------------|
| **1** | **REMOTE_485A** | A+ / D+ |
| **2** | **REMOTE_485B** | B− / D− |
| 3 | PARALLEL_485AA | nu se folosește (doar accesorii SolaX) |
| 4 | PARALLEL_485AA | nu se folosește (doar accesorii SolaX) |
| 5 | PARALLEL_485BB | nu se folosește (doar accesorii SolaX) |
| 6 | PARALLEL_485BB | nu se folosește (doar accesorii SolaX) |
| **7** | **REMOTE_485A** | duplicat al pinului 1 (pentru daisy-chain) |
| **8** | **REMOTE_485B** | duplicat al pinului 2 (pentru daisy-chain) |

> [!WARNING]
> Pinii 3–6 aparțin canalului proprietar SolaX PARALLEL_485 și sunt rezervați pentru accesoriile SolaX (Adapter Box G2, EV-Charger, DataHub, invertoare în paralel). **Nu** conectați un master Modbus terț la acești pini.

> [!NOTE]
> Invertoarele SolaX mai vechi (Gen4 X3-Hybrid) foloseau **pinul 4 = 485A** și **pinul 5 = 485B**. Alocarea pinilor COM 1 la X3-Ultra este diferită: verificați întotdeauna etichetarea suportului de cablu de pe unitatea dvs. înainte de sertizare. Unele documentații din comunitate fac încă referire la vechea alocare a pinilor Gen4.

### Cablarea RS-485

![Montarea terminalului RJ45 în poziția RS485 a suportului de cablu COM 1](https://taphome.com/images/compatibility/solax-hybrid-ultra-x3/wiring-rs485_hu_ac07cf89af382c1.jpg)

Reguli de cablare din manualul de utilizare X3-Ultra (secțiunea 8.6.4):

- **Tip de cablu:** cablu UTP standard Cat5 sau Cat6 cu perechi răsucite
- **Lungime maximă:** **30 m** de cablu RS-485 între invertor și TapHome CCU
- **Polaritatea contează:** dacă nu există comunicare, inversați A și B
- **Un singur master Modbus:** pe magistrală este permis un singur master. Dacă linia este partajată cu un modul de monitorizare SolaX, vor apărea conflicte

Suportul de cablu COM 1 are poziții etichetate dedicate pentru fiecare canal: introduceți cablul Cat5/Cat6 în slotul etichetat **RS485** (nu în Parallel-1, Parallel-2, BMS-1, BMS-2 sau DRM).

### Variante de conectare

- **CCU Modbus RTU direct:** conectați perechea RS485 de la COM 1 direct la TapHome Modbus RTU CCU. Oferă cea mai mică latență și este recomandată pentru controlul în timp real.
- **Gateway RS-485–Ethernet (Modbus RTU-over-TCP):** pentru instalațiile în care invertorul este departe de TapHome Core, folosiți un gateway Waveshare RS485-to-Ethernet, USR-DR302 sau similar, configurat ca Modbus RTU-over-TCP pe portul 502. Parametrul de import `IpAddress` al șablonului permite această variantă.
- **SolaX Pocket WiFi 3.0 / Pocket LAN / DataHub (Modbus TCP):** dacă modulul de monitorizare SolaX este deja instalat, acesta face legătura RTU–TCP pe portul 502 cu un ciclu de interogare de aproximativ 1 secundă, mai lent decât RTU direct și nepotrivit pentru buclele de control în timp real.

## Configurare

### Activarea comunicației Modbus pe invertor

Pe afișajul LCD al invertorului mergeți la:

```
Menu → Setting → Advance Setting → Modbus
```

Meniul Advanced Settings poate necesita parola de instalator. Verificați sau setați următoarele:

| Parametru | Valoare implicită în șablonul TapHome | Valoare implicită în invertor | Interval |
|-----------|--------------------------|------------------|-------|
| Modbus Address (Slave ID) | 1 | 1 | 1–255 |
| Baud rate | 19200 | 19200 | 9600 / 19200 / 38400 / 57600 / 115200 |
| Paritate | None | None | None / Odd / Even |
| Biți de date | 8 | 8 | — |
| Biți de stop | 1 | 1 | 1 sau 2 |

> [!WARNING]
> Baud rate-ul trebuie să coincidă între invertor și TapHome. Protocolul V3.29 specifică **19200** ca valoare implicită pentru X3-Ultra; unele șabloane și documentații SolaX mai vechi menționează încă 9600. Dacă comunicarea eșuează, verificați mai întâi baud rate-ul.

Invertorul poate pune la dispoziție și adresa slave Modbus prin registrul holding `H:0x00AC` și baud rate-ul prin registrul holding `H:0x00AD`.

### Parametrii de import în TapHome

La importul șablonului în TapHome trebuie setați doi parametri:

| Parametru | Scop |
|-----------|---------|
| **IpAddress** | Adresa IP a gateway-ului RS-485–TCP (sau a modulului de monitorizare SolaX Pocket WiFi / LAN). Lăsați valoarea implicită dacă invertorul este conectat direct la TapHome Modbus RTU CCU. |
| **SlaveId** | Adresa slave Modbus a invertorului (implicit `1`). Trebuie să corespundă setării Modbus Address a invertorului. |

### Temporizarea comunicației

Protocolul SolaX Modbus cere un interval minim între solicitările succesive, iar șablonul folosește intervale de interogare individuale pentru fiecare dispozitiv (de la câteva secunde pentru tensiunea / frecvența rețelei până la 80 s pentru temperatura bateriei). Nu interogați niciun dispozitiv prea frecvent: invertorul limitează intern solicitările.

## Funcțiile dispozitivului

### Monitorizarea bateriei

- **SOC baterie 1** — starea de încărcare a bateriei principale, ca intrare analogică 0–1 (registrul brut în unități de 1 %, împărțit la 100 pentru intervalul TapHome 0–1)
- **SOC baterie 2** — starea de încărcare a celei de-a doua baterii, **funcțională doar la X3-ULT-30K**, varianta cu două baterii; celelalte modele afișează 0
- **Temperatura bateriei** — temperatura pachetului de baterii, în °C, interogată la fiecare 80 de secunde

### Puterea fotovoltaică

- **Putere PV1 (Est)** — puterea DC a stringului PV 1, în kW
- **Putere PV2 (Est)** — puterea DC a stringului PV 2, în kW
- **Putere PV3 (Vest)** — puterea DC a stringului PV 3, în kW, **funcțională doar la modelele cu 3 MPPT** (vezi tabelul Modele); celelalte modele afișează 0

Sufixele „Est” / „Vest” sunt o convenție de denumire moștenită din șablonul slovac original: numărul stringului PV corespunde intrării MPPT fizice a invertorului, nu orientării reale a panourilor.

### Măsurarea rețelei și a energiei

- **Tensiune rețea L1 / L2 / L3** — tensiunea rețelei pe fiecare fază, în volți (registrele `A:0x006A`, `A:0x006E`, `A:0x0072`)
- **Frecvență rețea L1 / L2 / L3** — frecvența rețelei pe fiecare fază, în herți (registrele `A:0x006D`, `A:0x0071`, `A:0x0075`)
- **Putere injectată în rețea (contor)** — ar trebui să indice puterea injectată de la contorul extern SolaX / CT, dar șablonul oficial citește registrul `A:0x0046` cu ordinea cuvintelor greșită (`Int32` în loc de `LittleEndianInt32`), astfel că valoarea nu are sens (de exemplu −7340,033 în loc de −0,117 kW). Nu este un alias pentru Putere import / export rețea: folosiți acel dispozitiv sau corectați scriptul conform secțiunii Probleme cunoscute ale șablonului oficial
- **Putere import / export rețea** — citirea corectă a puterii contorului / CT (`A:0x0046`, `LittleEndianInt32`), în kW; pozitivă = export, negativă = import
- **Producție invertor zilnică / actuală** — în șablonul oficial combină energia invertorului de astăzi (registrul `A:0x0050`, un contor zilnic care se resetează în fiecare noapte) cu registrul `A:0x0002`, pe care SolaX îl documentează doar pentru modelele monofazate X1; la X3-Ultra acesta afișează 0. Scripturile corectate se găsesc în secțiunea Probleme cunoscute ale șablonului oficial
- **Energie totală produsă** — energia cumulată livrată de portul AC al invertorului în rețea pe toată durata de funcționare, în kWh

### Controlul încărcătorului și al injectării (cu scriere)

- **Mod de utilizare încărcător** — modul de funcționare al încărcătorului bateriei: Self Use, Feed-in Priority, Backup sau Manual
- **SOC încărcare de noapte (Self Use)** — limita superioară a SOC-ului (10–100 %) pentru încărcarea bateriei din rețea în timpul nopții, în modul Self Use
- **Limita maximă a puterii injectate** — puterea maximă permisă pentru export în rețea, **în kW** (nu în procente): la modelele X3 registrul numără în pași de 10 W, iar șablonul împarte la 100

> [!WARNING]
> **Se aplică limita de scriere în EEprom** pentru toate cele trei dispozitive cu scriere de mai sus (Mod de utilizare încărcător → `SH:0x001F`, SOC încărcare de noapte → `SH:0x0063`, Limita maximă a puterii injectate → `SH:0x0042`). Registrele sunt stocate în EEprom, cu un număr limitat de cicluri de scriere: scrierile frecvente (la fiecare câteva secunde într-o buclă de automatizare) vor deteriora permanent EEprom-ul invertorului. Folosiți doar modificări manuale sau scrieri programate rar.

### Atribute și acțiuni la nivelul modulului

- **Mod de funcționare** (atribut de service) — starea de funcționare a invertorului ca text: Waiting, Checking, Normal, Fault, Permanent Fault, Update, Off-grid waiting, Off-grid, Self Testing, Idle, Standby
- **Model** (atribut de service) — codul modelului invertorului ca șir ASCII de 4 caractere (H3BC = 15K/15KP, H3BD = 19.9K/20K/20KP, H3BF = 25K, H3BG = 30K)
- **Deblocare admin** (acțiune de service) — scrie constanta `2014` în `SH:0x0000` pentru a debloca setările avansate ale invertorului (necesară rar, doar pentru diagnosticare)

### Detectarea defecțiunilor

ReadScript-ul modulului monitorizează registrul Run Mode (`A:0x0009`) și raportează o eroare de sistem TapHome când invertorul intră în starea 3 (Fault) sau 4 (Permanent Fault). Două registre de eroare sunt analizate bit cu bit:

- **Coduri de defecțiune ale invertorului** (32 de biți, `A:0x0040`–`A:0x0041`) — 31 de defecțiuni individuale, inclusiv defecțiuni de tensiune / frecvență a rețelei, defecțiuni de tensiune PV, defecțiuni ale bateriei, defecțiuni de izolație, supratemperatură, protecție la supracurent, defecțiuni ale releului și erori de comunicare
- **Coduri de eroare ale managerului** (16 biți, `A:0x0043`) — 11 biți de defecțiune, inclusiv defecțiuni de tip putere, erori EEPROM, probleme ale senzorului NTC, avertismente de temperatură a bateriei, defecțiuni ale contorului și defecțiuni ale ventilatorului

Defecțiunile individuale apar ca erori separate în jurnalul de sistem TapHome, astfel încât instalatorii pot identifica subsistemul defect fără să citească afișajul LCD al invertorului.

## Probleme cunoscute ale șablonului oficial

Șablonul TapHome oficial pentru X3-Ultra citește greșit mai multe registre și scrie periodic o setare (verificat față de protocolul SolaX Modbus V3.29 și V001.02 și față de valorile din sisteme instalate). Un modul importat din șablonul oficial **nu se actualizează singur** când șablonul se modifică. Fie corectați manual scripturile modulului existent și ale dispozitivelor sale, fie importați șablonul comunitar corectat din portalul TapHome: [SolaX X3-Ultra Hybrid Inverter — monitoring and power control](https://portal.taphome.com/portal/community/solax-x3-ultra-power-control-modbus-rtu) (autentificați-vă, descărcați fișierul XML și importați-l ca modul nou).

**[SolaX X3-Ultra Hybrid Inverter — monitoring and power control (Modbus RTU)](https://portal.taphome.com/ro/portal/community/solax-x3-ultra-power-control-modbus-rtu)** — SolaX, Modbus RTU. SolaX X3-Ultra hybrid inverter over Modbus RTU — Energy Dashboard set, corrected readings, settings written only on change, remote AC power control for spot-price charging and discharging.

| Unde | Script oficial | Script corectat | Efectul erorii |
|------|----------------|-----------------|----------------|
| Modul — script de citire | `var x3 := MODBUSR(A, 0x0040, Uint32);` | `var x3 := MODBUSR(A, 0x0040, LittleEndianUint32);` | Cele două jumătăți ale codului de defecțiune pe 32 de biți sunt inversate: o defecțiune în bitul 1 (Grid Lost Fault) este raportată ca bitul 17 (Bat Power Low). Parallel Fault (bitul 21) și Hard Limit Fault (bitul 22) nu sunt raportate deloc |
| Putere injectată în rețea (contor) | `MODBUSR(A,0x0046, Int32)/1000` | `MODBUSR(A, 0x0048, LittleEndianUint32) / 100` — energia totală livrată în rețea, în kWh | Puterea este deja citită corect de Putere import / export rețea; acest dispozitiv afișează un număr fără sens. Energia totală preluată din rețea: `MODBUSR(A, 0x004A, LittleEndianUint32) / 100` |
| Producție invertor zilnică / actuală — consumul total | `MODBUSR(A, 0x50, UInt16) /10` | `MODBUSR(A, 0x0094, LittleEndianUint32) / 10` | 0x0050 este un contor zilnic care scade la 0 în fiecare noapte; 0x0094 este energia PV totală |
| Producție invertor zilnică / actuală — cerere | `MODBUSR(A,0x02, Int16)/1000` | `(MODBUSR(A, 0x000A, UInt16) + MODBUSR(A, 0x000B, UInt16) + MODBUSR(A, 0x0124, UInt16)) / 1000` | 0x0002 este puterea rețelei la modelele monofazate X1 și la X3-Ultra afișează 0 |
| Temperatura bateriei | `MODBUSR(A,0x0018, UInt16)` | `MODBUSR(A, 0x0018, Int16)` | Sub 0 °C șablonul oficial afișează aproximativ 65535 °C |
| SOC încărcare de noapte (Self Use) — script de scriere | `MODBUSW(SH, 0x0063,  Uint16, Le * 100)` cu scrierea periodică activată | `IF(MODBUSR(H, 0x0094, UInt16) != ROUND(Le * 100), MODBUSW(SH, 0x0063, Uint16, ROUND(Le * 100)));` | Dispozitivul oficial scrie ținta de încărcare de noapte în invertor la fiecare interogare (aproximativ la fiecare 55 s); 0x0063 este un registru EEPROM cu aproximativ 1 milion de cicluri de scriere. Cu scriptul corectat, scrie doar atunci când valoarea se schimbă cu adevărat |

Registrul `H:0x0094` este și în protocolul V3.29 starea de încărcare țintă pentru încărcarea de noapte (SelfUse_NightCharge_UpperSoC); încărcarea de noapte din rețea se activează în octetul inferior al `H:0x0093` (registrul de scriere `0x0062`).

## Controlul de la distanță al puterii

Șablonul comunitar corectat adaugă dispozitivul **Remote control - AC power target**. Acesta folosește modul 1 al controlului de la distanță SolaX (VPP): o țintă pozitivă în kW face ca invertorul să preia putere la portul său AC (încarcă bateria, din rețea dacă PV nu este suficient), iar o țintă negativă îl face să livreze putere (descarcă bateria, iar ceea ce casa nu consumă ajunge în rețea); 0 încheie controlul de la distanță. Când este necesar, șablonul deblochează setările invertorului cu parola implicită 2014 și repetă comanda la fiecare 60 s. Controlul de la distanță nu pornește cât timp invertorul este în modul de lucru Manual.

> [!WARNING]
> În protocolul său, SolaX nu marchează registrele de control de la distanță (0x007C–0x0088) ca registre EEPROM, dar nici nu confirmă în scris contrariul. Acest șablon se bazează pe experiența comunităților Home Assistant și openHAB, care scriu aceste registre la intervale de câteva secunde până la câteva minute. Setările de mai sus sunt registre EEPROM (marcate cu ★ de SolaX, aproximativ 1 milion de cicluri de scriere): modificați-le rar și niciodată din automatizări frecvente; pentru încărcarea și descărcarea în funcție de prețurile spot folosiți ținta de putere AC a controlului de la distanță.

## Rezolvarea problemelor

### Nu există comunicare cu invertorul

1. Verificați dacă cablajul RS-485 este pe pinii **REMOTE_485A / REMOTE_485B** (1+2 sau 7+8 în poziția RS485 a COM 1), nu pe pinii PARALLEL_485 3–6
2. Verificați dacă baud rate-ul coincide între invertor (`Menu → Setting → Advance Setting → Modbus`) și modulul TapHome: implicit ambele trebuie să fie 19200
3. Confirmați că Slave ID-ul coincide (implicit `1`)
4. Verificați dacă la magistrala RS-485 este conectat **un singur** master Modbus: Modbus nu acceptă mai mulți masteri
5. Inversați firele A și B dacă polaritatea cablului este incertă
6. Confirmați că lungimea totală a cablului RS-485 nu depășește **30 m**

### PV3 sau SOC baterie 2 afișează zero

Aceste dispozitive funcționează doar la **X3-ULT-30K** (varianta cu 3 MPPT / două baterii). La modelele mai mici, registrele `A:0x0124` (puterea PV3) și `A:0x012D` (SOC baterie 2) returnează zero. La instalațiile fără modelul 30K ascundeți dispozitivele neutilizate în interfața TapHome.

### Temperatura bateriei afișează o valoare neobișnuit de mare

Registrul Temperatura bateriei (`A:0x0018`) este citit de șablonul oficial ca `UInt16`, dar valoarea este cu semn. Temperaturile sub zero (de ex. −1 °C) se transformă în valori pozitive mari (de ex. 65535). Schimbați scriptul în `MODBUSR(A, 0x0018, Int16)`; consultați Probleme cunoscute ale șablonului oficial.

### Scrierile pentru Mod de utilizare încărcător / SOC încărcare de noapte / Limita maximă a puterii injectate nu au efect

Aceste registre sunt stocate în EEprom, iar invertorul limitează rata scrierilor pentru a proteja EEprom-ul. Asigurați-vă că scrierile sunt rare (manuale sau programate, nu într-o buclă de automatizare care scrie la fiecare câteva secunde). Unele versiuni de firmware cer și ca Mod de utilizare încărcător să fie setat la **Manual** (`3`) înainte ca anumite submoduri de încărcare / descărcare forțată să răspundă.

### Modbus TCP prin modulul de monitorizare SolaX este lent

Pocket WiFi 3.0 / Pocket LAN / DataHub fac legătura RTU–TCP cu un ciclu de interogare de aproximativ 1 secundă și gestionează un singur client Modbus TCP la un moment dat. Dacă și monitorizarea SolaX Cloud preia date, vor apărea conflicte. Pentru controlul în timp real (răspuns în frecvență, reducerea vârfurilor de consum – peak shaving) folosiți Modbus RTU direct sau un gateway RS-485–Ethernet terț dedicat.

## Dispozitive disponibile 19

Aceste dispozitive apar în TapHome după import.

SolaX X3 Hybrid Ultra Modul

Atribute de service

|                    |                                                                                                                                                           |
|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
| Mod de funcționare | Starea de funcționare a invertorului — Waiting, Checking, Normal, Fault, Permanent Fault, Update, Off-grid waiting, Off-grid, Self Testing, Idle, Standby |
| Model              | Codul modelului invertorului ca șir ASCII de 4 caractere (H3BC = 15K/15KP, H3BD = 19.9K/20K/20KP, H3BF = 25K, H3BG = 30K)                                 |

Acțiuni de service

|                 |                                                                                                                                           |
|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------|
| Deblocare admin | Scrie constanta 2014 în registrul SH:0x0000 pentru a debloca setările avansate ale invertorului — necesară rar, doar pentru diagnosticare |

Citire (modul)

```taphome
var reg := MODBUSR(A, 0x09, UInt16);
IF(reg = 3, ADDERROR("Run Mode Fault"));
IF(reg = 4, ADDERROR("Run Mode Permanent Fault"));
#error table  2-3 for x3
var x3 := MODBUSR(A, 0x0040, Uint32);
IF(GETBIT(x3, 0) = 1, ADDERROR("TZ Protect Fault"));
IF(GETBIT(x3, 1) = 1, ADDERROR("Grid Lost Fault"));
IF(GETBIT(x3, 2) = 1, ADDERROR("Grid Volt Fault"));
IF(GETBIT(x3, 3) = 1, ADDERROR("Grid Freq Fault"));
IF(GETBIT(x3, 4) = 1, ADDERROR("PV Volt Fault"));
IF(GETBIT(x3, 5) = 1, ADDERROR("Bus Volt Fault"));
IF(GETBIT(x3, 6) = 1, ADDERROR("Bat Volt Fault"));
IF(GETBIT(x3, 7) = 1, ADDERROR("AC10mins Volt Fault"));
IF(GETBIT(x3, 8) = 1, ADDERROR("DCI OCP Fault"));
IF(GETBIT(x3, 9) = 1, ADDERROR("DCV OCP Fault"));
IF(GETBIT(x3, 10) = 1, ADDERROR("SW OCP Fault"));
IF(GETBIT(x3, 11) = 1, ADDERROR("RC OCP Fault"));
IF(GETBIT(x3, 12) = 1, ADDERROR("Isolation Fault"));
IF(GETBIT(x3, 13) = 1, ADDERROR("Temp Over Fault"));
IF(GETBIT(x3, 14) = 1, ADDERROR("BatConnDir Fault"));
IF(GETBIT(x3, 15) = 1, ADDERROR("Off-grid Overload"));
IF(GETBIT(x3, 16) = 1, ADDERROR("Overload"));
IF(GETBIT(x3, 17) = 1, ADDERROR("Bat Power Low"));
IF(GETBIT(x3, 18) = 1, ADDERROR("BMS Lost"));
IF(GETBIT(x3, 19) = 1, ADDERROR("Fan Fault"));
IF(GETBIT(x3, 20) = 1, ADDERROR("Low Temp Fault"));
IF(GETBIT(x3, 23) = 1, ADDERROR("INV Volt Sample Fault"));
IF(GETBIT(x3, 24) = 1, ADDERROR("Inner Comm Fault"));
IF(GETBIT(x3, 25) = 1, ADDERROR("INV EEPROM Fault"));
IF(GETBIT(x3, 26) = 1, ADDERROR("RCD Fault"));
IF(GETBIT(x3, 27) = 1, ADDERROR("Grid Relay Fault"));
IF(GETBIT(x3, 28) = 1, ADDERROR("Off-grid Relay Fault"));
IF(GETBIT(x3, 29) = 1, ADDERROR("PV ConnDir Fault"));
IF(GETBIT(x3, 30) = 1, ADDERROR("Charger Relay Fault"));
IF(GETBIT(x3, 31) = 1, ADDERROR("Earth Relay Fault"));

#error 2-5 Manager error code
var err := MODBUSR(A, 0x0043, Uint16);
IF(GETBIT(err, 0) = 1, ADDERROR("Power Type Fault"));
IF(GETBIT(err, 1) = 1, ADDERROR("Port OC Warning"));
IF(GETBIT(err, 2) = 1, ADDERROR("Mgr EEPROM Fault"));
IF(GETBIT(err, 4) = 1, ADDERROR("NTC Sample Invalid"));
IF(GETBIT(err, 5) = 1, ADDERROR("Battery Temperature Low"));
IF(GETBIT(err, 6) = 1, ADDERROR("Battery Temperature High"));
IF(GETBIT(err, 9) = 1, ADDERROR("Meter Fault"));
IF(GETBIT(err, 10) = 1, ADDERROR("Bypass Relay Fault"));
IF(GETBIT(err, 11) = 1, ADDERROR("Fan 2 Fault"));
```

Atribute de service

Run Mode

```taphome
SWITCH(MODBUSR(A, 0x09, UInt16), 
0, "Waiting",
1, "Checking",
2, "Normal",
3, "Fault",
4, "Permanent Fault",
5, "Update",
6, "Off-grid waiting",
7, "Off-grid",
8, "Self Testing ",
9, "Idle",
10, "Standby",
"Other"
);
```

Model

```taphome
MODBUSR(H, 14, String, 4)
```

Acțiuni de service

Unlock admin

```taphome
MODBUSW(SH, 0x0000, Uint16, 2014);
```

SOC baterie 1 Intrare analogică Doar citire

Starea de încărcare a bateriei principale în procente (0–100 %), disponibilă în TapHome ca intrare analogică 0–1

Registru: A:0x001C UInt16 Unitate: % numeric

Citirea nivelului de intrare

```taphome
MODBUSR(A, 0x1C, UInt16)/100
```

SOC baterie 2 Intrare analogică Doar citire

Starea de încărcare a celei de-a doua baterii în procente — funcțională doar la X3-ULT-30K, varianta cu două baterii; celelalte modele afișează 0

Registru: A:0x012D UInt16 Unitate: % numeric

Citirea nivelului de intrare

```taphome
MODBUSR(A, 0x012D, Uint16) / 100
```

Energie totală produsă Variabilă Doar citire

Energia cumulată livrată de portul AC al invertorului în rețea pe toată durata de funcționare, în kWh

Registru: A:0x0052 LittleEndianInt32 Unitate: kWh numeric

Citire

```taphome
MODBUSR(A, 0x52,LittleEndianInt32) / 10
```

Producție invertor zilnică / actuală Contor electric Doar citire

Șablonul oficial: energia invertorului de astăzi (0x0050, se resetează în fiecare noapte) și registrul 0x0002, documentat doar pentru modelele X1, care la X3-Ultra afișează 0; scripturile corectate citesc energia PV totală (0x0094) și puterea PV1 + PV2 + PV3

Registru: A:0x0050, A:0x0002 UInt16, Int16 Unitate: kWh / kW numeric

Citirea consumului total

```taphome
MODBUSR(A, 0x50, UInt16) /10
```

Citirea cererii

```taphome
MODBUSR(A,0x02, Int16)/1000
```

Putere injectată în rețea (contor) Variabilă Doar citire

Șablonul oficial citește registrul de putere al contorului / CT 0x0046 cu ordinea cuvintelor greșită (Int32), astfel că valoarea nu are sens; folosiți Putere import / export rețea sau schimbați scriptul pe energia livrată în rețea (0x0048, LittleEndianUint32, / 100)

Registru: A:0x0046 Int32 Unitate: kW numeric

Citire

```taphome
MODBUSR(A,0x0046, Int32)/1000
```

Frecvență rețea L1 Variabilă Doar citire

Registru: A:0x006D Int16 Unitate: Hz numeric

Citire

```taphome
MODBUSR(A, 0x006D, Int16)/100
```

Frecvență rețea L2 Variabilă Doar citire

Registru: A:0x0071 Int16 Unitate: Hz numeric

Citire

```taphome
MODBUSR(A,0x0071, Int16)/100
```

Frecvență rețea L3 Variabilă Doar citire

Registru: A:0x0075 Int16 Unitate: Hz numeric

Citire

```taphome
MODBUSR(A,0x0075, Int16)/100
```

Mod de utilizare încărcător Comutator cu mai multe valori Citire și scriere

Modul de funcționare al încărcătorului bateriei — Self Use, Feed-in Priority, Backup sau Manual. Scrierea se face în EEprom: nu modificați des valoarea prin automatizări

Registru: H:0x008B → SH:0x001F UInt16 numeric

Valori / Stări: Self Use · Feedin Priority · Backup · Manual · Peak Shaving

Citirea stării comutatorului

```taphome
MODBUSR(H, 0x008B, Uint16)
```

Scrierea stării comutatorului

```taphome
MODBUSW(SH, 0x001F, uint16, Mu)
```

Tensiune rețea L1 Variabilă Doar citire

Registru: A:0x006A Int16 Unitate: V numeric

Citire

```taphome
MODBUSR(A,0x006A, Int16)/10
```

Tensiune rețea L2 Variabilă Doar citire

Registru: A:0x006E Int16 Unitate: V numeric

Citire

```taphome
MODBUSR(A, 0x006E, Int16)/10
```

Tensiune rețea L3 Variabilă Doar citire

Registru: A:0x0072 Int16 Unitate: V numeric

Citire

```taphome
MODBUSR(A,0x0072, Int16)/10
```

Putere import / export rețea Variabilă Doar citire

Puterea injectată în rețea / consumată din rețea în timp real, de la contorul extern (0x0046, citit corect ca LittleEndianInt32); valorile pozitive înseamnă export în rețea, cele negative import

Registru: A:0x0046 LittleEndianInt32 Unitate: kW numeric

Citire

```taphome
MODBUSR(A, 0x46,LittleEndianInt32)/1000
```

Putere PV1 (Est) Variabilă Doar citire

Puterea DC a stringului PV 1; în denumirea din șablonul slovac original corespunde de obicei panourilor orientate spre est

Registru: A:0x000A UInt16 Unitate: kW numeric

Citire

```taphome
MODBUSR(A,0x0a, UInt16)/1000
```

Putere PV2 (Est) Variabilă Doar citire

Puterea DC a stringului PV 2; în denumirea din șablonul slovac original corespunde de obicei panourilor orientate spre est

Registru: A:0x000B UInt16 Unitate: kW numeric

Citire

```taphome
MODBUSR(A,0x0b, UInt16)/1000
```

Putere PV3 (Vest) Variabilă Doar citire

Puterea DC a stringului PV 3 — funcțională doar la X3-ULT-30K, varianta cu 3 MPPT; celelalte modele afișează 0

Registru: A:0x0124 UInt16 Unitate: kW numeric

Citire

```taphome
MODBUSR(A, 0x0124, Uint16)/1000
```

SOC încărcare de noapte (Self Use) Dimmer Citire și scriere

Limita superioară a SOC-ului (10–100 %) pentru încărcarea bateriei din rețea în timpul nopții, în modul Self Use. Scrierea se face în EEprom; șablonul oficial o scrie la fiecare interogare (aproximativ la fiecare 55 s): folosiți scriptul de scriere care compară mai întâi cu 0x0094

Registru: H:0x0094 → SH:0x0063 UInt16 Unitate: % numeric

Citirea nivelului

```taphome
MODBUSR(H, 0x0094, Uint16) / 100
```

Scrierea nivelului

```taphome
MODBUSW(SH, 0x0063,  Uint16, Le * 100)
```

Temperatura bateriei Senzor de temperatură Doar citire

Registru: A:0x0018 UInt16 Unitate: °C numeric

Citirea temperaturii

```taphome
MODBUSR(A,0x0018, UInt16)
```

Limita maximă a puterii injectate Variabilă Citire și scriere

Puterea maximă permisă pentru export în rețea, în kW (la modelele X3 registrul numără în pași de 10 W). Scrierea se face în EEprom: nu modificați des valoarea prin automatizări

Registru: H:0x00B6 → SH:0x0042 UInt16 Unitate: kW numeric

Citire

```taphome
MODBUSR(H, 0x00B6, Uint16)/100
```

Scriere

```taphome
MODBUSW(SH, 0x0042, Uint16, Va*100)
```

**Conexiune:** Modbus RTU • 19200 baud• 8N1 • Slave ID: $\[SlaveId]

Îmbunătățiri posibile (40)

- A:0x0017 BMS Connect State — 0=Disconnected, 1=Connected. Critical for battery health monitoring
- A:0x001A Grid Status — 0=On-grid, 1=Off-grid. Important for backup/off-grid scenarios
- A:0x0014, A:0x0015, A:0x0016 Battery Voltage / Current / Power — Battery 1 pack telemetry: 0.1V int16, 0.1A int16, 1W int16. Positive current/power = charge, negative = discharge
- A:0x0127, A:0x0128, A:0x0129 Battery 2 Voltage / Current / Power — Battery 2 pack telemetry. X3-ULT-30K only
- A:0x0131 Battery 2 Temperature — 1°C, int16. Battery 2 temperature. X3-ULT-30K only
- A:0x0008 Radiator Temperature — 1°C, int16. Inverter internal radiator/heatsink temperature
- A:0x0003, A:0x0004 PV1 / PV2 Voltage — 0.1V, uint16. Useful for string-level diagnostics
- A:0x0005, A:0x0006 PV1 / PV2 Current — 0.1A, uint16. Useful for string-level diagnostics
- A:0x0122, A:0x0123 PV3 Voltage / Current — 0.1V uint16 / 0.1A uint16. X3-ULT-30K only
- A:0x006B, A:0x006F, A:0x0073 Per-Phase Grid Current L1/L2/L3 — 0.1A, int16 each. Per-phase current for 3-phase monitoring
- A:0x006C, A:0x0070, A:0x0074 Per-Phase Grid Power L1/L2/L3 — 1W, int16 each. Per-phase grid power — essential for 3-phase load balancing
- A:0x0082–0x0087 Per-Phase Feed-in Power L1/L2/L3 (Meter) — 1W, int32 LE × 3 phases. Per-phase feed-in from meter/CT
- A:0x0048–0x0049 Feed-in Energy Total (Meter) — 0.01kWh, uint32 LE. Lifetime energy exported via meter
- A:0x004A–0x004B Consumed Energy Total (Meter) — 0.01kWh, uint32 LE. Lifetime energy consumed from grid via meter
- A:0x0094–0x0095 Solar Energy Total — 0.1kWh, uint32 LE. Cumulative PV production (all strings combined)
- A:0x0096 Solar Energy Today — 0.1kWh, uint16. Today's PV production
- A:0x0091, A:0x0092–0x0093 Charged Energy Today / Total — 0.1kWh, uint16 / uint32 LE. Energy charged to battery via inverter AC port
- A:0x001D–0x001E, A:0x0020 Battery Discharge Energy Today / Total — 0.1kWh, uint32 LE / uint16. Battery discharge energy
- A:0x0021–0x0022, A:0x0023 Battery Charge Energy Today / Total — 0.1kWh, uint32 LE / uint16. Battery charge energy
- A:0x00BA, A:0x00BB Battery Temp High / Low — 0.1°C, int16. Min/max battery cell temperatures
- A:0x00BC, A:0x00BD Cell Voltage High / Low — 0.001V, uint16. Min/max individual cell voltages — important for battery health
- A:0x00BE, A:0x00BF BMS User SOC / SOH — 1%, uint16. SOC and state-of-health as reported by BMS (may differ from A:0x001C)
- A:0x00B8, A:0x00B9 Meter 1 / Meter 2 Communication State — 0=Com Error, 1=Normal. Diagnostic for meter/CT connectivity
- A:0x0019 BDC Status — 0=discharge, 1=charge, 2=stop. Battery DC converter status
- A:0x008E–0x008F, A:0x0090 Off-grid Yield Total / Today — 0.1kWh, uint32 LE / uint16. Energy delivered in off-grid mode
- A:0x0088–0x008B On-grid / Off-grid Running Time — 0.1h, uint32 LE each. Lifetime runtime counters
- A:0x012F–0x0130 Inverter Total AC Power — 1W, int32. Sum of all 3 phases AC output. X3-ULT-30K only
- A:0x0042 Manager Error Code (as Value) — Note: register A:0x0043 is parsed in module readscript for bit-level fault decoding (11 manager fault bits). V3.29 protocol places Manager error at A:0x0042 and BMS error at A:0x0043 — template uses A:0x0043 as 'Manager error code' which may actually be BMS Warning Code (Table 2-6). Potential mismatch — verify
- Write SH:0x0020 Manual Mode — 0=Stop charge & discharge, 1=Force charge, 2=Force discharge. Requires Charger Use Mode = 3 (Manual)
- Write SH:0x0061 Self-Use Discharge Min SOC — 10–100%. Minimum SOC before discharge stops in Self-Use mode
- Write SH:0x0062 Self-Use Night Charge Enable — 0=Disable, 1=Enable night charging from grid. Currently always-on assumption in template — explicit enable would allow user toggle
- H:0x0093 Self-Use Discharge Min SOC (Read) — Readback of discharge min SOC limit
- H:0x008C Manual Mode Readback — 0=Stop, 1=Force charge, 2=Force discharge. Readback of current manual sub-mode
- H:0x008D Battery Type — 0=Lead Acid, 1=Lithium. Battery chemistry diagnostic
- H:0x0100–0x011F Modbus Power Control (Remote) — Active/reactive power targets, SOC targets, time-of-duration. Enables advanced energy management and grid services (peak shaving, FCR, etc.)
- A:0x0120, A:0x0121 BMS Relay State / Restart Flag — 0/1 each. BMS relay status and restart indicator
- H:0x001D Safety Code (Country Standard) — 0–39 enum. Grid safety standard (VDE0126, VDE4105, AS4777, G98/G99, EN50549, etc.) — useful for installation diagnostics
- H:0x0023 Power Limits Percent — 0–100%, uint16. Inverter output power limit
- H:0x00BA Inverter Power Type — Model variant code (15K/20K/25K/30K). Useful for runtime model detection
- H:0x0000–0x0006 Inverter Serial Number — 14-character ASCII string across 7 registers. Service attribute candidate

## Parametri de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație | Implicit      |
|------------------------|---------------|
| Slave Id               | `1`           |
| IP address             | `192.168.1.0` |

## Surse

- SolaX X1/X3-IES & X3-Ultra Modbus TCP & RTU Communication Protocol V3.29
  
  [www.gbc-solino.cz](https://www.gbc-solino.cz/files/uploads/FAQ%20SolaX/Hybrid-X1X3-IES-ULTRA-ModbusTCPRTU-V3.29.pdf) 2026-05-29
  
  [PDF](https://taphome.com/compatibility/devices/solax-hybrid-ultra-x3/manufacturer/Hybrid-X1X3-IES-ULTRA-ModbusTCPRTU-V3.29.pdf)
- SolaX X3-Ultra Series User Manual (Installation & Wiring)
  
  [www.solaxpower.com](https://www.solaxpower.com/uploads/file/x3-ultra-series-user-manual-en.pdf) 2026-05-29
  
  [PDF](https://taphome.com/compatibility/devices/solax-hybrid-ultra-x3/manufacturer/x3-ultra-series-user-manual-en.pdf)
- SolaX X3-Ultra Datasheet (Product Overview & Specs)
  
  [www.solaxpower.com](https://www.solaxpower.com/uploads/file/solax-x3-ultra-datasheet-en.pdf) 2026-05-29
  
  [PDF](https://taphome.com/compatibility/devices/solax-hybrid-ultra-x3/manufacturer/solax-x3-ultra-datasheet-en.pdf)
- Home Assistant SolaX Modbus Integration (X3-Ultra Gen5 Support)
  
  [github.com](https://github.com/wills106/homeassistant-solax-modbus) 2026-05-29
- SolaX KB: How to Get Device Data by Modbus TCP
  
  [kb.solaxpower.com](https://kb.solaxpower.com/solution/detail/ff8080818407e2a701840a22dec20032) 2026-05-29

Documentele producătorilor sunt © ale proprietarilor respectivi. Sunt furnizate așa cum au fost publicate de producător, doar ca referință.

## Documentație asociată

- [Modbus Integration](https://taphome.com/ro/compatibility/modbus-guide/)
- [Modbus](https://taphome.com/ro/docs/integration/modbus/)
- [Configurare simplă cu ajutorul șabloanelor](https://taphome.com/ro/docs/integration/modbus/templates/)
- [Scripturi Modbus și prefetch](https://taphome.com/ro/docs/script/modbus-scripts/)
- [Funcții Modbus](https://taphome.com/ro/docs/script/modbus/)
- [Tipuri de date Modbus](https://taphome.com/ro/docs/script/modbus-data-types/)

