iobroker.senec 1.1.1 → 1.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/docs/de/README.md DELETED
@@ -1,539 +0,0 @@
1
- ![Logo](/admin/senec.png)
2
- # ioBroker.senec
3
-
4
- ## SENEC Adapter für ioBroker
5
- Der Adapter wurde für Senec Home V2.1 Systeme entwickelt.
6
- Im Senec.Home System können keine Werte verändert werden. Auf die Einbindung der Sicherheitsladung wurde bewusst verzichtet.
7
- Senec stellt derzeit über die Webschnittstelle auch keine zuverlässige Möglichkeit mehr zur Verfügung, das Peak Shaving zu beeinflussen. Hierzu muss mein-senec.de bemüht werden.
8
- 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.
9
- 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).
10
-
11
- 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
23
- * Senec Business 30.0 / Blei
24
- * Senec Business V2 30.0 / Blei
25
- * Senec Business 25.0 / Lithium
26
- * Senec Business V2_2ph / Lithium
27
- * Senec Business V2 3ph / Lithium
28
- * ADS Tec
29
- * OEM LG
30
- * Solarinvert Storage 10.0 / Blei,
31
-
32
- ### SENEC.Home
33
- Es handelt sich um ein System, dessen Herzstück ein Lithium-Ionen-Akku ist, der Strom speichert und wieder abgibt, der von der Solaranlage auf dem Dach erzeugt wird. Das funktioniert genau wie beim Akku im Smartphone, Notebook oder dem Akkuschrauber. Es steckt im Prinzip auch die gleiche bewährte Technologie drin. Wenn du mehr Strom auf dem Dach erzeugst, als du selbst im Haus verbrauchen kannst, fließt der Strom nicht ins Netz, sondern in deinen Speicher. Du kannst ihn dann nutzen, wenn es dunkel wird oder Wolken aufziehen und du weniger oder keinen Strom mehr erzeugst. Dann kannst du auch abends mit deinem eigenen Solarstrom den Fernseher betreiben oder das Essen kochen.
34
-
35
- ## Voraussetzungen vor der Installation
36
- Voraussetzungen für den Betrieb eines Senec.Home Speichersystems mit ioBroker, ist die erfolgreiche Einrichtung des Systems durch einen Elektriker. Ebenfalls muss sich das System im gleichen Netzwerk wie der ioBroker befinden.
37
-
38
- ### Installation
39
- Eine Instanz des Adapters wird über die ioBroker Admin-Oberfläche installiert.
40
- Nach Abschluss der Installation einer Adapterinstanz öffnet sich automatisch ein Konfigurationsfenster.
41
-
42
- ## Konfiguration
43
-
44
- ### Fenster "Haupteinstellungen"
45
- ![Main Settings](media/mainSettings.png "Haupteinstellungen")
46
-
47
- | Feld | Beschreibung |
48
- |:-------------|:-------------|
49
- |SENEC System |Hier wird die IP-Adresse des gewünschten Senec.Home Systems angegeben werden. Falls im Netzwerk ein funktionierender DNS existiert, kann auch der FQDN angegeben werden.|
50
- |Abfrageintervall hohe Priorität|Hier wird eingegeben, in welchen Zeitintervallen (Millisekunden) die Werde hoher Priorität vom Senec.Home Systems abgerufen werden. (Default: 10 Sekunden)|
51
- |Abfrageintervall niedrige Priorität|Hier wird eingegeben, in welchen Zeitintervallen (Millisekunden) die Werde niedriger Priorität vom Senec.Home Systems abgerufen werden. (Default: 60 Minuten)<br>
52
- Achtung! Wird das SENEC System mit zu hoher Frequenz abgefragt, kann dies dazu führen, dass keine Daten mehr an die SENEC Server übermittelt werden können! (z.B. keine aktuellen Werte in der App oder auf mein-senec.de)|
53
- |Request-Timeout|Hier wird eingegeben, nach wievielen Millisekunden eine Anfrage spätestens vom Senec.Home System beantwortet sein muss, bevor die Anfrage abgebrochen wird. (Default: 5000)|
54
- |Wiederholungsversuche|Hier wird angegeben, wie oft versucht werden soll, das Senec System anzufragen, falls es zu einem Fehler kommt. Dies gilt nicht beim Start des Adapters - sollte das System dabei nicht erreichbar sein, beendet der Adapter seine Arbeit. (Default: 10)|
55
- |Polling-Wiederholungsfaktor|Mit diesem Wert kann der Abstand zwischen den Wiederholungsversuchen beeinflusst werden. Es gilt: der n'te Wiederholungsversuch erfolgt nach Intervall * Multiplikator * n Sekunden nach Versuch n-1. Beispiel: Mit Standardwerten erfolgt der 1. Wiederholungsversuch 20 Sekunden nach dem initialen Versuch und der 2. Wiederholungsversuch erfolgt 40 Sekunden nach dem 1. Ein erfolgreicher Datenabruf setzt den Zähler für Wiederholungen zurück.|
56
-
57
- Nach Abschluss der Konfiguration wird der Konfigurationsdialog mit `SPEICHERN UND SCHLIEßEN` verlassen.
58
- Dadurch erfolgt im Anschluß ein Neustart des Adapters.
59
-
60
- ## Instanzen
61
- Die Installation des Adapters hat im Bereich `Objekte` eine aktive Instanz des sonnen Adapters angelegt.
62
-
63
- Auf einem ioBroker Server können mehrere Senec Adapter Instanzen angelegt werden. Umgekehrt kann ein Senec.Home System auch mit mehreren ioBroker Servern betrieben werden. Sollen mehrere Geräte von einem ioBroker Server gesteuert werden, sollte je System eine Instanz angelegt werden.
64
- <br/><br/>
65
- Ob der Adapter aktiviert und mit dem System verbunden ist, wird mit der Farbe des Status-Feldes der Instanz verdeutlicht. Zeigt der Mauszeiger auf das Symbol, werden weitere Detailinformationen dargestellt.
66
-
67
- ## Objekte des Adapters
68
- Im Bereich `Objekte` werden in einer Baumstruktur alle vom Adapter im Hub erkannten Geräte und Aktivitäten aufgelistet.
69
-
70
- Nachfolgend werden die Objekte in States unterteilt.
71
- Jeder Datenpunkt ist mit seinem zugehörigen Datentyp sowie seinen Berechtigungen aufgeführt.
72
- Berechtigungen können dezeit nur lesend (R) sein. Jeder Datenpunkt kann mindestens gelesen (R) werden.
73
- Zur Suche nach einem bestimmten Datenpunkt empfiehlt sich die Suche mittels der Tastenkombination "STRG + F".
74
- Abhängig vom individuellen System können States nicht existieren oder aber auch nicht dokumentierte States auftreten.
75
- Falls zu einem State keine Dokumentation vorhanden ist, jemand aber weiß, was der State darstellt, bitte ich um einen entspr. Pull-Request (oder Ticket mit der entspr. Information eröffnen).
76
-
77
- ### Beispiel States (verfügbare States sind abhängig von System und Softwarestand)
78
-
79
- #### Channel: info
80
-
81
- * info.connection
82
-
83
- |Data type|Permission|
84
- |:---:|:---:|
85
- |boolean|R|
86
-
87
- *Nur lesbarer boolscher Wert, welcher true ist, wenn die Verbindung zwischen ioBroker und Senec.Home hergestellt ist.*
88
-
89
- #### Channel: BMS
90
-
91
- * BL[0-3]
92
-
93
- |Data type|Permission|
94
- |:---:|:---:|
95
- |number|R|
96
-
97
- *Nur lesbare Zahl, die angibt: ? für jeden Battery Pack.*
98
-
99
- * CHARGED_ENERGY[0-3]
100
-
101
- |Data type|Permission|
102
- |:---:|:---:|
103
- |number|R|
104
-
105
- *Nur lesbare Zahl, die angibt, wieviel Energie je Battery Pack geladen wurde. Einheit: ?*
106
-
107
- * CHARGE_CURRENT_LIMIT[0-3]
108
-
109
- |Data type|Permission|
110
- |:---:|:---:|
111
- |number|R|
112
-
113
- *Nur lesbare Zahl, die angibt, wie hoch die Ladeleistung je Battery Pack in Ampere ist.*
114
-
115
- * CURRENT[0-3]
116
-
117
- |Data type|Permission|
118
- |:---:|:---:|
119
- |number|R|
120
-
121
- *Nur lesbare Zahl, die angibt, wieviel Ampere jeder Battery Pack aktuell hat.*
122
-
123
- * CYCLES[0-3]
124
-
125
- |Data type|Permission|
126
- |:---:|:---:|
127
- |number|R|
128
-
129
- *Nur lesbare Zahl, die angibt, wieviele Ladezyklen jeder Battery Pack hat.*
130
-
131
- * DISCHARGED_ENERGY[0-3]
132
-
133
- |Data type|Permission|
134
- |:---:|:---:|
135
- |number|R|
136
-
137
- *Nur lesbare Zahl, die angibt, wieviel Energie aus einem Battery Pack ausgespeist wurde. Einheit: ?*
138
-
139
- * DISCHARGE_CURRENT_LIMIT[0-3]
140
-
141
- |Data type|Permission|
142
- |:---:|:---:|
143
- |number|R|
144
-
145
- *Nur lesbare Zahl, die angibt, welche Entladeleistung jeder Battery Pack aktuell hat.*
146
-
147
- * FW[0-3]
148
-
149
- |Data type|Permission|
150
- |:---:|:---:|
151
- |number|R|
152
-
153
- *Nur lesbare Zahl, die angibt, welche Firmwareversion ein Battery Pack aktuell hat.*
154
-
155
- * HW_EXTENSION[0-3]
156
-
157
- |Data type|Permission|
158
- |:---:|:---:|
159
- |number|R|
160
-
161
- *Nur lesbare Zahl, die angibt, welche Hardware Erweiterung der jeweilige Battery Pack hat.*
162
-
163
- * HW_MAINBOARD[0-3]
164
-
165
- |Data type|Permission|
166
- |:---:|:---:|
167
- |number|R|
168
-
169
- *Nur lesbare Zahl, die angibt, welche Hardwareversion das Mainboard des jeweiligen Battery Pack hat.*
170
-
171
- * MAX_CELL_VOTAGE[0-3]
172
-
173
- |Data type|Permission|
174
- |:---:|:---:|
175
- |number|R|
176
-
177
- *Nur lesbare Zahl, die angibt, wie hoch die maximale Voltzahl des einzelnen Battery Pack ist.*
178
-
179
- * MIN_CELL_VOTAGE[0-3]
180
-
181
- |Data type|Permission|
182
- |:---:|:---:|
183
- |number|R|
184
-
185
- *Nur lesbare Zahl, die angibt, wie hoch die minimale Voltzahl des einzelnen Battery Pack ist.*
186
-
187
- * SN[0-3]
188
-
189
- |Data type|Permission|
190
- |:---:|:---:|
191
- |number|R|
192
-
193
- *Nur lesbare Zahl, die angibt, wie die Seriennummer des einzelnen Battery Pack lautet.*
194
-
195
- * SOC[0-3]
196
-
197
- |Data type|Permission|
198
- |:---:|:---:|
199
- |number|R|
200
-
201
- *Nur lesbare Zahl, die angibt, wie der Ladezustand des einzelnen Battery Pack ist.*
202
-
203
- * SOH[0-3]
204
-
205
- |Data type|Permission|
206
- |:---:|:---:|
207
- |number|R|
208
-
209
- *Nur lesbare Zahl, die angibt, wie der Gesundheitszustand des einzelnen Battery Pack ist.*
210
-
211
- * STATUS[0-3]
212
-
213
- |Data type|Permission|
214
- |:---:|:---:|
215
- |number|R|
216
-
217
- *Nur lesbare Zahl, die angibt, wie der Status des einzelnen Battery Pack ist.*
218
-
219
- * TEMP_MAX[0-3]
220
-
221
- |Data type|Permission|
222
- |:---:|:---:|
223
- |number|R|
224
-
225
- *Nur lesbare Zahl, die angibt, wie hoch die maximale Temperatur des einzelnen Battery Pack ist.*
226
-
227
- * TEMP_MIN[0-3]
228
-
229
- |Data type|Permission|
230
- |:---:|:---:|
231
- |number|R|
232
-
233
- *Nur lesbare Zahl, die angibt, wie hoch die minimale Temperatur des einzelnen Battery Pack ist.*
234
-
235
- * VOLTAGE[0-3]
236
-
237
- |Data type|Permission|
238
- |:---:|:---:|
239
- |number|R|
240
-
241
- *Nur lesbare Zahl, die angibt, wie hoch die Volt des einzelnen Battery Pack sind.*
242
-
243
- * BMS_READY_FLAG
244
-
245
- |Data type|Permission|
246
- |:---:|:---:|
247
- |boolean|R|
248
-
249
- *Nur lesbarer boolscher Wert, welcher true ist, falls das BMS bereit ist.*
250
-
251
- * MODULES_CONFIGURED
252
-
253
- |Data type|Permission|
254
- |:---:|:---:|
255
- |number|R|
256
-
257
- *Nur lesbare Zahl, die angibt, wieviele Module im System konfiguriert sind.*
258
-
259
- * MODULE_COUNT
260
-
261
- |Data type|Permission|
262
- |:---:|:---:|
263
- |number|R|
264
-
265
- *Nur lesbare Zahl, die angibt, wieviele Module im System angeschlossen sind (inkl. nicht konfigurierter).*
266
-
267
- * START_UPDATE
268
-
269
- |Data type|Permission|
270
- |:---:|:---:|
271
- |boolean|R|
272
-
273
- *Nur lesbarer boolscher Wert, welcher true ist, falls ein Update zu starten ist.*
274
-
275
- * WIZARD_ABORT
276
-
277
- |Data type|Permission|
278
- |:---:|:---:|
279
- |boolean|R|
280
-
281
- *Nur lesbarer boolscher Wert, welcher true ist, der Einrichtungsprozess unterbrochen wurde.*
282
-
283
- * WIZARD_CONFIRM
284
-
285
- |Data type|Permission|
286
- |:---:|:---:|
287
- |boolean|R|
288
-
289
- *Nur lesbarer boolscher Wert, welcher true ist, der Einrichtungsprozess bestätigt wurde.*
290
-
291
- * WIZARD_DCCONNECT
292
-
293
- |Data type|Permission|
294
- |:---:|:---:|
295
- |boolean|R|
296
-
297
- *Nur lesbarer boolscher Wert, welcher true ist, der Einrichtungsprozess ?.*
298
-
299
- * WIZARD_START
300
-
301
- |Data type|Permission|
302
- |:---:|:---:|
303
- |boolean|R|
304
-
305
- *Nur lesbarer boolscher Wert, welcher true ist, der Einrichtungsprozess gestartet wurde.*
306
-
307
- * WIZARD_STATE
308
-
309
- |Data type|Permission|
310
- |:---:|:---:|
311
- |number|R|
312
-
313
- *Nur lesbare Zahl, die angibt, welchen Status der Einrichtungsprozess hat.*
314
-
315
- #### Channel: ENERGY
316
-
317
- * GUI_BAT_DATA_CURRENT
318
-
319
- |Data type|Permission|
320
- |:---:|:---:|
321
- |number|R|
322
-
323
- *Nur lesbare Zahl, die den aktuellen Batteriestrom in Ampere angibt.*
324
-
325
- * GUI_BAT_DATA_FUEL_CHARGE
326
-
327
- |Data type|Permission|
328
- |:---:|:---:|
329
- |number|R|
330
-
331
- *Nur lesbare Zahl, die den Füllstand in % des Systems angibt.*
332
-
333
- * GUI_BAT_DATA_VOLTAGE
334
-
335
- |Data type|Permission|
336
- |:---:|:---:|
337
- |number|R|
338
-
339
- *Nur lesbare Zahl, die die derzeitige Batteriespannung in Volt angibt*
340
-
341
- * GUI_BAT_DATA_POWER
342
-
343
- |Data type|Permission|
344
- |:---:|:---:|
345
- |number|R|
346
-
347
- *Nur lesbare Zahl, die angibt, wieviel Watt gerade in die Batterie eingespeist werden oder aus ihr entnommen (negativer Wert) werden.*
348
-
349
- * GUI_BOOSTING_INFO
350
-
351
- |Data type|Permission|
352
- |:---:|:---:|
353
- |boolean|R|
354
-
355
- *Nur lesbarer boolscher Wert, dessen Sinn bisher nicht eindeutig klar ist.*
356
-
357
- * GUI_CHARGING_INFO
358
-
359
- |Data type|Permission|
360
- |:---:|:---:|
361
- |boolean|R|
362
-
363
- *Nur lesbarer boolscher Wert, der angibt, ob die Batterie gerade geladen wird.*
364
-
365
- * GUI_GRID_POW
366
-
367
- |Data type|Permission|
368
- |:---:|:---:|
369
- |number|R|
370
-
371
- *Nur lesbare Zahl, die angibt, wieviel Watt gerade aus dem Netz gezogen oder ins Netz eingespeist (negativer Wert) werden.*
372
-
373
- * GUI_HOUSE_POW
374
-
375
- |Data type|Permission|
376
- |:---:|:---:|
377
- |number|R|
378
-
379
- *Nur lesbare Zahl, die angibt, wieviel Watt gerade vom Haus verbraucht werden.*
380
-
381
- * GUI_INVERTER_POWER
382
-
383
- |Data type|Permission|
384
- |:---:|:---:|
385
- |number|R|
386
-
387
- *Nur lesbare Zahl, die angibt, wieviel Watt vom PV System gerade erzeugt werden.*
388
-
389
- * STAT_HOURS_OF_OPERATION
390
-
391
- |Data type|Permission|
392
- |:---:|:---:|
393
- |number|R|
394
-
395
- *Nur lesbare Zahl, die die Betriebsstunden des Systems angibt.*
396
-
397
- * STAT_MAINT_REQUIRED
398
-
399
- |Data type|Permission|
400
- |:---:|:---:|
401
- |boolean|R|
402
-
403
- *Nur lesbarer boolscher Wert, der angibt, ob das System gewartet werden muss.*
404
-
405
- * STAT_STATE
406
-
407
- |Data type|Permission|
408
- |:---:|:---:|
409
- |number|R|
410
-
411
- *Nur lesbare Zahl, die den Zustand des Systems repräsentiert.*
412
-
413
- * STAT_STATE_Text
414
-
415
- |Data type|Permission|
416
- |:---:|:---:|
417
- |string|R|
418
-
419
- *Nur lesbare Zeichenkette, die den Zustand des Systems in Klartext angibt. Leider liegen uns nur die original Senec-Texte in Deutsch vor.*
420
-
421
- #### Channel: STATISTIC
422
-
423
- * STAT_DAY_BAT_CHARGE
424
-
425
- |Data type|Permission|
426
- |:---:|:---:|
427
- |number|R|
428
-
429
- *Nur lesbare Zahl, die angibt, wieviele kWh heute in der Batterie gespeichert wurden.*
430
-
431
- * STAT_DAY_BAT_DISCHARGE
432
-
433
- |Data type|Permission|
434
- |:---:|:---:|
435
- |number|R|
436
-
437
- *Nur lesbare Zahl, die angibt, wieviele kWh heute aus der Batterie entnommen wurden.*
438
-
439
- * STAT_DAY_E_GRID_EXPORT
440
-
441
- |Data type|Permission|
442
- |:---:|:---:|
443
- |number|R|
444
-
445
- *Nur lesbare Zahl, die angibt, wieviele kWh heute ins Netz eingespeist wurden.*
446
-
447
- * STAT_DAY_E_GRID_IMPORT
448
-
449
- |Data type|Permission|
450
- |:---:|:---:|
451
- |number|R|
452
-
453
- *Nur lesbare Zahl, die angibt, wieviele kWh heute aus dem Netz bezogen wurden.*
454
-
455
- * STAT_DAY_E_HOUSE
456
-
457
- |Data type|Permission|
458
- |:---:|:---:|
459
- |number|R|
460
-
461
- *Nur lesbare Zahl, die den heutigen Hausverbrauch in kWh angibt.*
462
-
463
- * STAT_DAY_E_PV
464
-
465
- |Data type|Permission|
466
- |:---:|:---:|
467
- |number|R|
468
-
469
- *Nur lesbare Zahl, die angibt, wieviele kWh heute von der PV Anlage produziert wurden.*
470
-
471
-
472
- #### Channel: SYS_UPDATE
473
-
474
- * NPU_IMAGE_VERSION
475
-
476
- |Data type|Permission|
477
- |:---:|:---:|
478
- |number|R|
479
-
480
- *Nur lesbare Zahl, mit dem Wert für Revision NPU-IMAGE (*
481
-
482
- * NPU_VER
483
-
484
- |Data type|Permission|
485
- |:---:|:---:|
486
- |number|R|
487
-
488
- *Nur lesbare Zahl, die mit dem Wert für Revision NPU-REGS*
489
-
490
- * UPDATE_AVAILABLE
491
-
492
- |Data type|Permission|
493
- |:---:|:---:|
494
- |boolean|R|
495
-
496
- *Nur lesbarer boolscher Wert, der angibt, ob ein Update vorhanden ist (diese werden allerdings von Senec zur Verfügung gestellt und auch automatisiert eingespielt).*
497
-
498
-
499
- #### Channel: WIZARD
500
-
501
- * APPLICATION_VERSION
502
-
503
- |Data type|Permission|
504
- |:---:|:---:|
505
- |string|R|
506
-
507
- *Nur lesbarer Text, mit dem Wert für Revision MCU.*
508
-
509
- * CONFIG_LOADED
510
-
511
- |Data type|Permission|
512
- |:---:|:---:|
513
- |boolean|R|
514
-
515
- *Nur lesbarer boolscher Wert, der angibt, ob die Konfiguration geladen wurde (dieser Wert sollte nicht dauerhaft auf falsch stehen).*
516
-
517
- * INTERFACE_VERSION
518
-
519
- |Data type|Permission|
520
- |:---:|:---:|
521
- |string|R|
522
-
523
- *Nur lesbarer Text, mit dem Wert für Revision GUI.*
524
-
525
- * SETUP_NUMBER_WALLBOXES
526
-
527
- |Data type|Permission|
528
- |:---:|:---:|
529
- |number|R|
530
-
531
- *Nur lesbare Zahl, die angibt, wieviele Wallboxen im System konfiguriert sind.*
532
-
533
- * SETUP_WALLBOX_SERIAL[0..3]
534
-
535
- |Data type|Permission|
536
- |:---:|:---:|
537
- |string|R|
538
-
539
- *Nur lesbarer Text, die die Seriennummern der evtl. vorhandenen Wallboxen 0-3 angibt.*
Binary file