Skip to content

Commit 2d304e1

Browse files
noblnobl
committed
Readme updated
1 parent 6be407f commit 2d304e1

3 files changed

Lines changed: 48 additions & 515 deletions

File tree

‎README.md‎

Lines changed: 15 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -22,18 +22,15 @@ Senec currently also no longer provides a reliable way to influence peak shaving
2222
Whether other systems (e.g. V3) also work with it depends on whether they are also based on lala.cgi and provide the same JSON information.
2323
Even with integration into the Senec.Clound it is not guaranteed that the data can still be retrieved via the web interface (for this please report your experiences).
2424

25+
Adapter supports local polling via lala.cgi and polling via Web API.
26+
2527
Systems that might work:
26-
* Senec Home 4.0 / Blei
27-
* Senec Home 6.0 Pb
28-
* Senec Home 8.0 / Blei
29-
* Senec Home 10.0 Pb
30-
* Senec Home 5.0/7.5/10.0 / Lithium
31-
* Senec Home 15.0 / Lithium
32-
* Senec Home V2 5.0/7.5/10.0
33-
* Senec Home V2 10.0 / Blei
34-
* Senec Home V2.1 1ph / Lithium
35-
* Senec.Home V3 Hybrid
36-
* Senec.Home V3 Hybrid duo
28+
* Senec Home 4.0, 6.0, 8.0, 10.0 / Blei
29+
* Senec Home 5.0, 7.5, 10.0, 15.0 / Lithium
30+
* Senec Home V2 5.0, 7.5, 10.0
31+
* Senec Home V2.1
32+
* Senec.Home V3
33+
* Senec.Home V4
3734
* Senec Business 30.0 / Blei
3835
* Senec Business V2 30.0 / Blei
3936
* Senec Business 25.0 / Lithium
@@ -147,14 +144,6 @@ This channel contains values polled from SENEC App-API.
147144

148145
*Read-only number, which represents how much power is coming from / going into the battery in Watts. Negative values are discharging.*
149146

150-
* GUI_BOOSTING_INFO
151-
152-
|Data type|Permission|
153-
|:---:|:---:|
154-
|boolean|R|
155-
156-
*Read-only boolean, which we don't know the exact meaning of yet.*
157-
158147
* GUI_CHARGING_INFO
159148

160149
|Data type|Permission|
@@ -195,14 +184,6 @@ This channel contains values polled from SENEC App-API.
195184

196185
*Read-only number, detailing the system's uptime in hours.*
197186

198-
* STAT_MAINT_REQUIRED
199-
200-
|Data type|Permission|
201-
|:---:|:---:|
202-
|boolean|R|
203-
204-
*Read-only boolean, which represents if your senec system requires maintenance.*
205-
206187
* STAT_STATE
207188

208189
|Data type|Permission|
@@ -296,13 +277,20 @@ This channel contains values polled from SENEC App-API.
296277
* _calc (not relevant anymore since we lost STATISTIC)
297278
* BAT1OBJ[2-4]
298279

280+
### Donate
281+
Maintenance of this adapter can be quite time consuming. If you wish to thank the author, please use these links:
282+
- [WERO](https://share.weropay.eu/p/1/c/QzzqgSQcI3)
283+
- [![Paypal](https://img.shields.io)](https://www.paypal.me/gerbots)
284+
- [![GitHub Sponsor](https://img.shields.io)](https://github.com/sponsors/nobl)
299285

300286
## Changelog
301287

302288
<!--
303289
Placeholder for the next version (at the beginning of the line):
304290
### **WORK IN PROGRESS**
305291
-->
292+
### **WORK IN PROGRESS**
293+
306294
### 2.4.8 (2026-03-14)
307295
- Connection type now is "cloud" (ioBroker internal setting) - although we still support local interaction (if possible per individual appliance)
308296
- Dependency updates
@@ -390,7 +378,6 @@ This channel contains values polled from SENEC App-API.
390378
- less logging (moved some info to debug again)
391379

392380
### 2.1.0 (2026-02-04) - the API returns - finally finally hopefully finally
393-
394381
- Complete rewrite of the Senec API functionality. Thanks to @timfxtones for pointing me in the right direction
395382
- No longer using the web-interface at mein-senec.de - it didn't work properly on the long run ...
396383
- Still missing some datapoints so far. They will be implemented in the future.

‎docs/de/README.md‎

Lines changed: 18 additions & 243 deletions
Original file line numberDiff line numberDiff line change
@@ -8,18 +8,15 @@ Senec stellt derzeit über die Webschnittstelle auch keine zuverlässige Möglic
88
Ob andere Systeme (z.B. V3) ebenfalls damit funktionieren, ist davon abhängig, ob diese ebenfalls auf lala.cgi basieren und die gleichen JSON Informationen zur Verfügung stellen.
99
Auch bei Einbindung in die Senec.Clound ist nicht gewährleistet, dass die Daten weiterhin über die Webschnittstelle abgerufen werden können (hierzu bitte Erfahrungsberichte).
1010

11+
Der Adapter unterstützt lokales Polling via lala.cgi als auch via Web API.
12+
1113
Systeme, die funktionieren dürften, da sie die gleiche Schnittstelle nutzen sind nachfolgend gelistet. Allerdings können die Datenpunkte unterschiedlich sein (fehlen, zusätzlich, geändert).
12-
* Senec Home 4.0 / Blei
13-
* Senec Home 6.0 Pb
14-
* Senec Home 8.0 / Blei
15-
* Senec Home 10.0 Pb
16-
* Senec Home 5.0/7.5/10.0 / Lithium
17-
* Senec Home 15.0 / Lithium
18-
* Senec Home V2 5.0/7.5/10.0
19-
* Senec Home V2 10.0 / Blei
20-
* Senec Home V2.1 1ph / Lithium
21-
* Senec.Home V3 Hybrid
22-
* Senec.Home V3 Hybrid duo
14+
* Senec Home 4.0, 6.0, 8.0, 10.0 / Blei
15+
* Senec Home 5.0, 7.5, 10.0, 15.0 / Lithium
16+
* Senec Home V2 5.0, 7.5, 10.0
17+
* Senec Home V2.1
18+
* Senec.Home V3
19+
* Senec.Home V4
2320
* Senec Business 30.0 / Blei
2421
* Senec Business V2 30.0 / Blei
2522
* Senec Business 25.0 / Lithium
@@ -105,172 +102,11 @@ Falls zu einem State keine Dokumentation vorhanden ist, jemand aber weiß, was d
105102
|boolean|R|
106103

107104
*Nur lesbarer boolscher Wert, welcher true ist, wenn die Verbindung zwischen ioBroker und Senec.Home hergestellt ist.*
108-
109-
#### Channel: _calc
110-
Dieser Kanal enthielt berechnete Werte. Nicht mehr versorgt, da STATISTIC nicht mehr verfügbar.
111105

106+
#### Channel: _api
107+
Werte, die von der Web API abgerufen werden
112108

113109
#### Channel: BMS
114-
115-
* BL[0-3]
116-
117-
|Data type|Permission|
118-
|:---:|:---:|
119-
|number|R|
120-
121-
*Nur lesbare Zahl, die angibt: ? für jeden Battery Pack.*
122-
123-
* CHARGED_ENERGY[0-3]
124-
125-
|Data type|Permission|
126-
|:---:|:---:|
127-
|number|R|
128-
129-
*Nur lesbare Zahl, die angibt, wieviel Energie je Battery Pack geladen wurde. Einheit: ?*
130-
131-
* CHARGE_CURRENT_LIMIT[0-3]
132-
133-
|Data type|Permission|
134-
|:---:|:---:|
135-
|number|R|
136-
137-
*Nur lesbare Zahl, die angibt, wie hoch die Ladeleistung je Battery Pack in Ampere ist.*
138-
139-
* CURRENT[0-3]
140-
141-
|Data type|Permission|
142-
|:---:|:---:|
143-
|number|R|
144-
145-
*Nur lesbare Zahl, die angibt, wieviel Ampere jeder Battery Pack aktuell hat.*
146-
147-
* CYCLES[0-3]
148-
149-
|Data type|Permission|
150-
|:---:|:---:|
151-
|number|R|
152-
153-
*Nur lesbare Zahl, die angibt, wieviele Ladezyklen jeder Battery Pack hat.*
154-
155-
* DISCHARGED_ENERGY[0-3]
156-
157-
|Data type|Permission|
158-
|:---:|:---:|
159-
|number|R|
160-
161-
*Nur lesbare Zahl, die angibt, wieviel Energie aus einem Battery Pack ausgespeist wurde. Einheit: ?*
162-
163-
* DISCHARGE_CURRENT_LIMIT[0-3]
164-
165-
|Data type|Permission|
166-
|:---:|:---:|
167-
|number|R|
168-
169-
*Nur lesbare Zahl, die angibt, welche Entladeleistung jeder Battery Pack aktuell hat.*
170-
171-
* FW[0-3]
172-
173-
|Data type|Permission|
174-
|:---:|:---:|
175-
|number|R|
176-
177-
*Nur lesbare Zahl, die angibt, welche Firmwareversion ein Battery Pack aktuell hat.*
178-
179-
* HW_EXTENSION[0-3]
180-
181-
|Data type|Permission|
182-
|:---:|:---:|
183-
|number|R|
184-
185-
*Nur lesbare Zahl, die angibt, welche Hardware Erweiterung der jeweilige Battery Pack hat.*
186-
187-
* HW_MAINBOARD[0-3]
188-
189-
|Data type|Permission|
190-
|:---:|:---:|
191-
|number|R|
192-
193-
*Nur lesbare Zahl, die angibt, welche Hardwareversion das Mainboard des jeweiligen Battery Pack hat.*
194-
195-
* MAX_CELL_VOTAGE[0-3]
196-
197-
|Data type|Permission|
198-
|:---:|:---:|
199-
|number|R|
200-
201-
*Nur lesbare Zahl, die angibt, wie hoch die maximale Voltzahl des einzelnen Battery Pack ist.*
202-
203-
* MIN_CELL_VOTAGE[0-3]
204-
205-
|Data type|Permission|
206-
|:---:|:---:|
207-
|number|R|
208-
209-
*Nur lesbare Zahl, die angibt, wie hoch die minimale Voltzahl des einzelnen Battery Pack ist.*
210-
211-
* SN[0-3]
212-
213-
|Data type|Permission|
214-
|:---:|:---:|
215-
|number|R|
216-
217-
*Nur lesbare Zahl, die angibt, wie die Seriennummer des einzelnen Battery Pack lautet.*
218-
219-
* SOC[0-3]
220-
221-
|Data type|Permission|
222-
|:---:|:---:|
223-
|number|R|
224-
225-
*Nur lesbare Zahl, die angibt, wie der Ladezustand des einzelnen Battery Pack ist.*
226-
227-
* SOH[0-3]
228-
229-
|Data type|Permission|
230-
|:---:|:---:|
231-
|number|R|
232-
233-
*Nur lesbare Zahl, die angibt, wie der Gesundheitszustand des einzelnen Battery Pack ist.*
234-
235-
* STATUS[0-3]
236-
237-
|Data type|Permission|
238-
|:---:|:---:|
239-
|number|R|
240-
241-
*Nur lesbare Zahl, die angibt, wie der Status des einzelnen Battery Pack ist.*
242-
243-
* TEMP_MAX[0-3]
244-
245-
|Data type|Permission|
246-
|:---:|:---:|
247-
|number|R|
248-
249-
*Nur lesbare Zahl, die angibt, wie hoch die maximale Temperatur des einzelnen Battery Pack ist.*
250-
251-
* TEMP_MIN[0-3]
252-
253-
|Data type|Permission|
254-
|:---:|:---:|
255-
|number|R|
256-
257-
*Nur lesbare Zahl, die angibt, wie hoch die minimale Temperatur des einzelnen Battery Pack ist.*
258-
259-
* VOLTAGE[0-3]
260-
261-
|Data type|Permission|
262-
|:---:|:---:|
263-
|number|R|
264-
265-
*Nur lesbare Zahl, die angibt, wie hoch die Volt des einzelnen Battery Pack sind.*
266-
267-
* BMS_READY_FLAG
268-
269-
|Data type|Permission|
270-
|:---:|:---:|
271-
|boolean|R|
272-
273-
*Nur lesbarer boolscher Wert, welcher true ist, falls das BMS bereit ist.*
274110

275111
* MODULES_CONFIGURED
276112

@@ -287,54 +123,6 @@ Dieser Kanal enthielt berechnete Werte. Nicht mehr versorgt, da STATISTIC nicht
287123
|number|R|
288124

289125
*Nur lesbare Zahl, die angibt, wieviele Module im System angeschlossen sind (inkl. nicht konfigurierter).*
290-
291-
* START_UPDATE
292-
293-
|Data type|Permission|
294-
|:---:|:---:|
295-
|boolean|R|
296-
297-
*Nur lesbarer boolscher Wert, welcher true ist, falls ein Update zu starten ist.*
298-
299-
* WIZARD_ABORT
300-
301-
|Data type|Permission|
302-
|:---:|:---:|
303-
|boolean|R|
304-
305-
*Nur lesbarer boolscher Wert, welcher true ist, der Einrichtungsprozess unterbrochen wurde.*
306-
307-
* WIZARD_CONFIRM
308-
309-
|Data type|Permission|
310-
|:---:|:---:|
311-
|boolean|R|
312-
313-
*Nur lesbarer boolscher Wert, welcher true ist, der Einrichtungsprozess bestätigt wurde.*
314-
315-
* WIZARD_DCCONNECT
316-
317-
|Data type|Permission|
318-
|:---:|:---:|
319-
|boolean|R|
320-
321-
*Nur lesbarer boolscher Wert, welcher true ist, der Einrichtungsprozess ?.*
322-
323-
* WIZARD_START
324-
325-
|Data type|Permission|
326-
|:---:|:---:|
327-
|boolean|R|
328-
329-
*Nur lesbarer boolscher Wert, welcher true ist, der Einrichtungsprozess gestartet wurde.*
330-
331-
* WIZARD_STATE
332-
333-
|Data type|Permission|
334-
|:---:|:---:|
335-
|number|R|
336-
337-
*Nur lesbare Zahl, die angibt, welchen Status der Einrichtungsprozess hat.*
338126

339127
#### Channel: ENERGY
340128

@@ -370,14 +158,6 @@ Dieser Kanal enthielt berechnete Werte. Nicht mehr versorgt, da STATISTIC nicht
370158

371159
*Nur lesbare Zahl, die angibt, wieviel Watt gerade in die Batterie eingespeist werden oder aus ihr entnommen (negativer Wert) werden.*
372160

373-
* GUI_BOOSTING_INFO
374-
375-
|Data type|Permission|
376-
|:---:|:---:|
377-
|boolean|R|
378-
379-
*Nur lesbarer boolscher Wert, dessen Sinn bisher nicht eindeutig klar ist.*
380-
381161
* GUI_CHARGING_INFO
382162

383163
|Data type|Permission|
@@ -418,14 +198,6 @@ Dieser Kanal enthielt berechnete Werte. Nicht mehr versorgt, da STATISTIC nicht
418198

419199
*Nur lesbare Zahl, die die Betriebsstunden des Systems angibt.*
420200

421-
* STAT_MAINT_REQUIRED
422-
423-
|Data type|Permission|
424-
|:---:|:---:|
425-
|boolean|R|
426-
427-
*Nur lesbarer boolscher Wert, der angibt, ob das System gewartet werden muss.*
428-
429201
* STAT_STATE
430202

431203
|Data type|Permission|
@@ -442,10 +214,7 @@ Dieser Kanal enthielt berechnete Werte. Nicht mehr versorgt, da STATISTIC nicht
442214

443215
*Nur lesbare Zeichenkette, die den Zustand des Systems in Klartext angibt. Leider liegen uns nur die original Senec-Texte in Deutsch vor.*
444216

445-
#### Channel: STATISTIC
446-
Existiert nicht mehr
447-
448-
217+
449218
#### Channel: SYS_UPDATE
450219

451220
* NPU_IMAGE_VERSION
@@ -513,4 +282,10 @@ Existiert nicht mehr
513282
|:---:|:---:|
514283
|string|R|
515284

516-
*Nur lesbarer Text, die die Seriennummern der evtl. vorhandenen Wallboxen 0-3 angibt.*
285+
*Nur lesbarer Text, die die Seriennummern der evtl. vorhandenen Wallboxen 0-3 angibt.*
286+
287+
### Nicht mehr vorhanden, bzw. entfernt
288+
* STATISTIC
289+
* Display
290+
* _calc (mit Wegfall von STATISTIC nicht mehr relevant)
291+
* BAT1OBJ[2-4]

0 commit comments

Comments
 (0)