node-red-contrib-cstech-box 1.1.3
Node-RED nodes for CSTech Box (cstechbox.com): read values from inverters, air conditioners, relays and hubs connected to your CSTech Box, switch devices and run scenes over the local API.
node-red-contrib-cstech-box
Node-RED nodes for CSTech Box. Enter the address and the API key once; the nodes then list the devices on your CSTech Box, grouped by integration, with their current values. Tick the values you need, the same way the Victron palette works.
Română mai jos.
About CSTech Box
CSTech Box is a local controller for solar and energy automation. It connects inverters (Victron, Fronius, Huawei, Solis, Sungrow, Deye), EV chargers, air conditioners and heat pumps (Daikin, Gree, LG, Mitsubishi, Bosch…), smart relays and plugs (Shelly, Tuya) and home hubs (Homey, Yubii / Nice, Home Assistant) in one place. It runs scenes and schedules on its own, in your network, with an optional cloud dashboard.
- Website: cstechbox.com
- Supported devices: cstechbox.com/devices
- Buy in România: shop.cstech.ro
- Buy outside România: shop.cstechbox.com
Install
- Palette Manager: Menu › Manage palette › Install, search for
node-red-contrib-cstech-box. Before it is published on npm, use Upload and pick the.tgzfile. - Command line, in your Node-RED folder (usually
~/.node-red):npm install node-red-contrib-cstech-box
Requires Node-RED 3.0 or newer and CSTech Box firmware V4.300012 or newer.
Setup
- In CSTech Box, open Smart home › Node-RED (firmware V4.300019+; before: Settings › Account & plan › Security) and create an API key for local integrations. The page also shows the Box IP address with a copy button.
- In Node-RED, drag any node from the CSTech Box category, then add a CSTech Box connection with the address (e.g.
192.168.1.50) and the API key. Press Test connection. - Pick the device and tick the values.
Nodes
| Node | What it does |
|---|---|
| Victron, Fronius, Huawei, Solis, Sungrow, Deye, Daikin, Gree, LG ThinQ, Shelly, Tuya… | One node per integration. Choose the device, tick the values. |
| Variable | Any variable from the CSTech Box, not tied to a device. |
| Command | Turns a device on, off, or toggles it (msg.payload = true / false / "toggle"). |
| Scene | Runs, activates or deactivates a CSTech Box scene (activate / deactivate: firmware V4.300017+). |
| Send to Box | Sends values from Node-RED to CSTech Box as a virtual device (msg.topic = name, msg.payload = value, or an object). They appear in Variables, cards and scenes. Firmware V4.300019+; Standard 3 devices, Premium 20. |
Output of the reading nodes
- One message per value:
msg.topic=Solis/batt_soc,msg.payload=76. - One message with all values:
msg.payload={ "pv_power": 5120, "batt_soc": 76 }. msg.cstechholds the device and variable details (id, unit, role).- Only when it changes (default) sends a value only when it changed.
Security
- The key is sent only in the
Authorization: Bearer …header, never in the address. - It is stored with the Node-RED credentials and is not exported with your flows.
- The editor never receives the saved key. A saved key is used only for the saved address; if you change the address, enter the key again.
- All reading nodes share one request per interval (minimum 5 s), so the CSTech Box is not overloaded.
Română
Noduri Node-RED pentru CSTech Box. Scrii o singură dată adresa și cheia API; nodurile arată apoi dispozitivele din CSTech Box, grupate pe integrări, cu valorile lor curente. Bifezi valorile de care ai nevoie, la fel ca la paleta Victron.
Despre CSTech Box
CSTech Box este un controler local pentru automatizarea energiei și a sistemelor solare. Conectează într-un singur loc invertoare (Victron, Fronius, Huawei, Solis, Sungrow, Deye), stații de încărcare, aere condiționate și pompe de căldură (Daikin, Gree, LG, Mitsubishi, Bosch…), relee și prize inteligente (Shelly, Tuya) și huburi (Homey, Yubii / Nice, Home Assistant). Rulează singur scene și programări, în rețeaua ta, cu panou în cloud opțional.
- Site: cstechbox.com
- Dispozitive compatibile: cstechbox.com/devices
- Cumpără în România: shop.cstech.ro
- Cumpără din afara României: shop.cstechbox.com
Instalare
- Palette Manager: Meniu › Manage palette › Install, cauți
node-red-contrib-cstech-box. Până la publicarea pe npm, folosești Upload și alegi fișierul.tgz. - Linie de comandă, în folderul Node-RED (de obicei
~/.node-red):npm install node-red-contrib-cstech-box
Necesită Node-RED 3.0 sau mai nou și firmware CSTech Box V4.300012 sau mai nou.
Configurare
- În CSTech Box, deschizi Smart home › Node-RED (firmware V4.300019+; înainte: Setări › Cont și plan › Securitate) și creezi o cheie API pentru integrări locale. Pagina arată și adresa IP a Box-ului, cu buton de copiere.
- În Node-RED, tragi orice nod din categoria CSTech Box și adaugi o conexiune CSTech Box cu adresa (de exemplu
192.168.1.50) și cheia API. Apeși Test conexiune. - Alegi dispozitivul și bifezi valorile.
Noduri
| Nod | Ce face |
|---|---|
| Victron, Fronius, Huawei, Solis, Sungrow, Deye, Daikin, Gree, LG ThinQ, Shelly, Tuya… | Câte un nod pe integrare. Alegi dispozitivul, bifezi valorile. |
| Variabilă | Orice variabilă din CSTech Box, fără legătură cu un dispozitiv. |
| Comandă | Pornește, oprește sau comută un dispozitiv (msg.payload = true / false / "toggle"). |
| Scenă | Rulează, activează sau dezactivează o scenă din CSTech Box (activare / dezactivare: firmware V4.300017+). |
| Trimite în Box | Trimite valori din Node-RED în CSTech Box, ca dispozitiv virtual (msg.topic = nume, msg.payload = valoare, sau un obiect). Apar în Variabile, carduri și scene. Firmware V4.300019+; Standard 3 dispozitive, Premium 20. |
Ieșirea nodurilor de citire
- Un mesaj pe valoare:
msg.topic=Solis/batt_soc,msg.payload=76. - Un mesaj cu toate valorile:
msg.payload={ "pv_power": 5120, "batt_soc": 76 }. msg.cstechconține detaliile dispozitivului și ale variabilei (id, unitate, rol).- Doar la schimbare (implicit) trimite o valoare doar când s-a schimbat.
Securitate
- Cheia se trimite doar în antetul
Authorization: Bearer …, niciodată în adresă. - Se păstrează în credențialele Node-RED și nu se exportă cu fluxurile.
- Editorul nu primește niciodată cheia salvată. Cheia salvată se folosește doar pentru adresa salvată; dacă schimbi adresa, scrii din nou cheia.
- Toate nodurile de citire folosesc o singură cerere la fiecare interval (minim 5 s), ca să nu încarce CSTech Box.
License
MIT
