Skip to content

Commit a215b8d

Browse files
naltatisnaltatis
committed
Merge branch 'main' of github.com:evcc-io/docs
2 parents 89bb481 + a162868 commit a215b8d

File tree

72 files changed

+2564
-272
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

72 files changed

+2564
-272
lines changed

‎docs/devices/chargers.mdx‎

Lines changed: 119 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1048,7 +1048,7 @@ Phasenumschaltung bietet nur die Solar-Variante und muss vom Anwender freigescha
10481048
10491049
### Solo
10501050
1051-
<DeviceFeatures features="mA,rfid,1p3p" />
1051+
<DeviceFeatures features="mA,rfid" />
10521052
10531053
<DeviceConfig code={`chargers:
10541054
- name: my_charger
@@ -1256,7 +1256,7 @@ Die Wallbox muss über eine aktuelle Firmware mit Modbus-Unterstützung verfüge
12561256
<DeviceConfig code={`chargers:
12571257
- name: my_charger
12581258
type: template
1259-
template: daheimladen-mb
1259+
template: daheimladen
12601260
host: 192.0.2.2 # IP-Adresse oder Hostname
12611261
port: 502 # Port, optional`} />
12621262
@@ -2302,6 +2302,33 @@ Die Wallbox muss sich im "Power" Modus befinden.
23022302
23032303
23042304
2305+
<SponsorshipRequired />
2306+
2307+
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/charger -->
2308+
2309+
## EV Expert EVECUBE
2310+
2311+
<DeviceFeatures features="1p3p,rfid" />
2312+
2313+
Benötigt HTTP-API-Zugriff.
2314+
2315+
<DeviceConfig code={`chargers:
2316+
- name: my_charger
2317+
type: template
2318+
template: evecube
2319+
host: 192.168.1.100 # IP-Adresse oder Hostname, Hostname oder IP-Adresse
2320+
user: admin # Benutzerkonto, Benutzername für Admin-API (optional)
2321+
password: # Passwort, Passwort für Admin-API (optional)`} advanced={`chargers:
2322+
- name: my_charger
2323+
type: template
2324+
template: evecube
2325+
host: 192.168.1.100 # IP-Adresse oder Hostname, Hostname oder IP-Adresse
2326+
user: admin # Benutzerkonto, Benutzername für Admin-API (optional)
2327+
password: # Passwort, Passwort für Admin-API (optional)
2328+
connector: 1 # Ladepunkt (falls >1 Ladepunkt), Anschluss-Nummer (1-4) (optional)`} />
2329+
2330+
2331+
23052332
<SponsorshipRequired />
23062333
23072334
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/charger -->
@@ -3838,6 +3865,50 @@ Setup, Backend, Backend-Server: Hier muss die evcc URL `ws://<evcc-address>:8887
38383865
38393866
38403867
3868+
<SponsorshipRequired />
3869+
3870+
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/charger -->
3871+
3872+
## Neoom
3873+
3874+
### N
3875+
3876+
<DeviceFeatures features="mA,1p3p" />
3877+
3878+
<DeviceConfig code={`chargers:
3879+
- name: my_charger
3880+
type: template
3881+
template: neoom-n
3882+
3883+
# Modbus TCP
3884+
modbus: tcpip
3885+
id: 1
3886+
host: 192.0.2.2 # Hostname
3887+
port: 502 # Port`} />
3888+
3889+
3890+
3891+
<SponsorshipRequired />
3892+
3893+
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/charger -->
3894+
3895+
### N+
3896+
3897+
<DeviceFeatures features="mA,1p3p" />
3898+
3899+
<DeviceConfig code={`chargers:
3900+
- name: my_charger
3901+
type: template
3902+
template: neoom-n-plus
3903+
3904+
# Modbus TCP
3905+
modbus: tcpip
3906+
id: 1
3907+
host: 192.0.2.2 # Hostname
3908+
port: 502 # Port`} />
3909+
3910+
3911+
38413912
<SponsorshipRequired />
38423913
38433914
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/charger -->
@@ -4764,6 +4835,50 @@ Die Wallbox muss sich im Modus "Schnell" befinden und vom Wechselrichtersystem e
47644835
47654836
47664837
4838+
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/charger -->
4839+
4840+
## Senec
4841+
4842+
### Plus
4843+
4844+
<DeviceFeatures features="mA,1p3p" />
4845+
4846+
<DeviceConfig code={`chargers:
4847+
- name: my_charger
4848+
type: template
4849+
template: senec-plus
4850+
4851+
# Modbus TCP
4852+
modbus: tcpip
4853+
id: 1
4854+
host: 192.0.2.2 # Hostname
4855+
port: 502 # Port`} />
4856+
4857+
4858+
4859+
<SponsorshipRequired />
4860+
4861+
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/charger -->
4862+
4863+
### Premium
4864+
4865+
<DeviceFeatures features="mA,rfid,1p3p" />
4866+
4867+
<DeviceConfig code={`chargers:
4868+
- name: my_charger
4869+
type: template
4870+
template: senec-premium
4871+
4872+
# Modbus TCP
4873+
modbus: tcpip
4874+
id: 1
4875+
host: 192.0.2.2 # Hostname
4876+
port: 502 # Port`} />
4877+
4878+
4879+
4880+
<SponsorshipRequired />
4881+
47674882
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/charger -->
47684883
47694884
## SENEC
@@ -7361,7 +7476,7 @@ Für Wärmepumpen mit Luxtronik 2.1 Steuerung. Nutzt modbus-tcp. Braucht mindest
73617476

73627477
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/charger -->
73637478

7364-
### Vaillant SensoNET (SG Ready)
7479+
### Vaillant SensoNET (API)
73657480

73667481
<DeviceFeatures features="sponsorfree" />
73677482

@@ -7381,7 +7496,7 @@ Die Boost Funktion erwärmt Warmwasser oder eine Boostzone. Die Boostzone wird d
73817496

73827497
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/charger -->
73837498

7384-
### Viessmann Heatpump (SG Ready)
7499+
### Viessmann Heatpump (API)
73857500

73867501
<DeviceFeatures features="sponsorfree" />
73877502

@@ -7391,8 +7506,6 @@ Einmalige Warmwasserbereitung. Das Gerät entscheidet eigenständig, ob die Wär
73917506
- name: my_charger
73927507
type: template
73937508
template: viessmann
7394-
user: # Benutzerkonto, Registrieren auf [app.developer.viessmann-climatesolutions.com](https://app.developer.viessmann-climatesolutions.com)
7395-
password: # Passwort, Für den konfigurierten Viessmann Account.
73967509
clientid: # Client ID, Konfigurieren in [app.developer.viessmann-climatesolutions.com](https://app.developer.viessmann-climatesolutions.com)
73977510
gateway_serial: # Gateway Serial, Seriennummer des VitoConnect modul (VitoCare App -> Einstellungen -> Kommunikationsmodul -> Seriennummer)
73987511
installation_id: # Installation ID, Leider kann man die Installation ID nicht einfach in der Viessmann App einsehen - stattdessen müssen wir die folgenden Kommandos in der Kommandozeile ausführen. Es ist uns bewusst, dass das nicht für jeden Benutzer einfach umsetzbar ist, aber bisher haben wir leider keinen besseren Ablauf...<br/> Vorraussetzungen: curl, jq, und die folgenden Umgebungsvariblen: \`\`\` VIESSMANN_USER=<your-user> VIESSMANN_PASS=<your-password> VIESSMANN_CLIENT_ID=<your-clientid> \`\`\` Dann holen wir uns einen oauth token (n.b. am besten den gesamten Block in das Terminal kopieren, da die Zwischenvariable 'CODE' nur 20 Sekunden gültig ist): \`\`\` VIESSMANN_REDIRECT_URI="http://localhost:4200/" VIESSMANN_CODE_CHALLENGE="5M5nhkBfkWZCGfLZYcTL-l7esjPUN7PpZ4rq8k4cmys" VIESSMANN_CODE_VERIFIER="6PygdmeK8JKPuuftlkc6q4ceyvjhMM_a_cJrPbcmcLc-SPjx2ZXTYr-SOofPUBydQ3McNYRy7Hibc2L2WtVLJFpOQ~Qbgic455ArKjUz9_UiTLnO6q8A3e.I_fIF8hAo" VIESSMANN_CODE=$(curl -X POST --silent \ --user $VIESSMANN_USER:$VIESSMANN_PASS \ --output /dev/null \ --dump-header - \ "https://iam.viessmann-climatesolutions.com/idp/v3/authorize?client_id=$VIESSMANN_CLIENT_ID&redirect_uri=$VIESSMANN_REDIRECT_URI&scope=IoT%20User%20offline_access&response_type=code&code_challenge=$VIESSMANN_CODE_CHALLENGE&code_challenge_method=S256" \ | grep "^location: " \ | sed 's/.*\\?code=\\(.*\\).*/\\1/' \ | tr -d '[:space:]') TOKEN_RESPONSE=$(curl -XPOST --silent \ -H "Content-Type: application/x-www-form-urlencoded" \ --data "grant_type=authorization_code&client_id=$VIESSMANN_CLIENT_ID&redirect_uri=$VIESSMANN_REDIRECT_URI&code_verifier=$VIESSMANN_CODE_VERIFIER&code=$VIESSMANN_CODE" \ https://iam.viessmann-climatesolutions.com/idp/v3/token) VIESSMANN_TOKEN=$(echo $TOKEN_RESPONSE | jq --raw-output .access_token) \`\`\` Damit können wir jetzt die Installation ID abfragen: \`\`\` curl --silent -H "Authorization: Bearer $VIESSMANN_TOKEN" \ https://api.viessmann-climatesolutions.com/iot/v1/equipment/installations?includeGateways=true \ | jq '.data[].id' \`\`\`

‎docs/devices/heating.mdx‎

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -786,7 +786,7 @@ Für Wärmepumpen mit Luxtronik 2.1 Steuerung. Nutzt modbus-tcp. Braucht mindest
786786

787787
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/heating -->
788788

789-
### Vaillant SensoNET (SG Ready)
789+
### Vaillant SensoNET (API)
790790

791791
Die Boost Funktion erwärmt Warmwasser oder eine Boostzone. Die Boostzone wird durch die ID identifiziert. Die Boost Temperatur wird in Grad Celsius angegeben. Ist eine Boost Temperatur angegeben, wird die Boostzone aktiviert, anderenfalls Warmwasser.
792792

@@ -804,16 +804,14 @@ Die Boost Funktion erwärmt Warmwasser oder eine Boostzone. Die Boostzone wird d
804804

805805
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/heating -->
806806

807-
### Viessmann Heatpump (SG Ready)
807+
### Viessmann Heatpump (API)
808808

809809
Einmalige Warmwasserbereitung. Das Gerät entscheidet eigenständig, ob die Wärmepumpe oder die elektrische Zusatzheizung (falls vorhanden) genutzt wird.
810810

811811
<DeviceConfig code={`chargers:
812812
- name: my_heating
813813
type: template
814814
template: viessmann
815-
user: # Benutzerkonto, Registrieren auf [app.developer.viessmann-climatesolutions.com](https://app.developer.viessmann-climatesolutions.com)
816-
password: # Passwort, Für den konfigurierten Viessmann Account.
817815
clientid: # Client ID, Konfigurieren in [app.developer.viessmann-climatesolutions.com](https://app.developer.viessmann-climatesolutions.com)
818816
gateway_serial: # Gateway Serial, Seriennummer des VitoConnect modul (VitoCare App -> Einstellungen -> Kommunikationsmodul -> Seriennummer)
819817
installation_id: # Installation ID, Leider kann man die Installation ID nicht einfach in der Viessmann App einsehen - stattdessen müssen wir die folgenden Kommandos in der Kommandozeile ausführen. Es ist uns bewusst, dass das nicht für jeden Benutzer einfach umsetzbar ist, aber bisher haben wir leider keinen besseren Ablauf...<br/> Vorraussetzungen: curl, jq, und die folgenden Umgebungsvariblen: \`\`\` VIESSMANN_USER=<your-user> VIESSMANN_PASS=<your-password> VIESSMANN_CLIENT_ID=<your-clientid> \`\`\` Dann holen wir uns einen oauth token (n.b. am besten den gesamten Block in das Terminal kopieren, da die Zwischenvariable 'CODE' nur 20 Sekunden gültig ist): \`\`\` VIESSMANN_REDIRECT_URI="http://localhost:4200/" VIESSMANN_CODE_CHALLENGE="5M5nhkBfkWZCGfLZYcTL-l7esjPUN7PpZ4rq8k4cmys" VIESSMANN_CODE_VERIFIER="6PygdmeK8JKPuuftlkc6q4ceyvjhMM_a_cJrPbcmcLc-SPjx2ZXTYr-SOofPUBydQ3McNYRy7Hibc2L2WtVLJFpOQ~Qbgic455ArKjUz9_UiTLnO6q8A3e.I_fIF8hAo" VIESSMANN_CODE=$(curl -X POST --silent \ --user $VIESSMANN_USER:$VIESSMANN_PASS \ --output /dev/null \ --dump-header - \ "https://iam.viessmann-climatesolutions.com/idp/v3/authorize?client_id=$VIESSMANN_CLIENT_ID&redirect_uri=$VIESSMANN_REDIRECT_URI&scope=IoT%20User%20offline_access&response_type=code&code_challenge=$VIESSMANN_CODE_CHALLENGE&code_challenge_method=S256" \ | grep "^location: " \ | sed 's/.*\\?code=\\(.*\\).*/\\1/' \ | tr -d '[:space:]') TOKEN_RESPONSE=$(curl -XPOST --silent \ -H "Content-Type: application/x-www-form-urlencoded" \ --data "grant_type=authorization_code&client_id=$VIESSMANN_CLIENT_ID&redirect_uri=$VIESSMANN_REDIRECT_URI&code_verifier=$VIESSMANN_CODE_VERIFIER&code=$VIESSMANN_CODE" \ https://iam.viessmann-climatesolutions.com/idp/v3/token) VIESSMANN_TOKEN=$(echo $TOKEN_RESPONSE | jq --raw-output .access_token) \`\`\` Damit können wir jetzt die Installation ID abfragen: \`\`\` curl --silent -H "Authorization: Bearer $VIESSMANN_TOKEN" \ https://api.viessmann-climatesolutions.com/iot/v1/equipment/installations?includeGateways=true \ | jq '.data[].id' \`\`\`

‎docs/devices/meters.mdx‎

Lines changed: 8 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -217,11 +217,11 @@ Die meisten modernen PV-Technikkomponenten, insbesondere Wechselrichter und Batt
217217
218218
<!-- AUTO-GENERATED FROM TEMPLATE - PLEASE EDIT HERE https://github.com/evcc-io/evcc/tree/master/templates/definition/meter -->
219219
220-
## Aandewiel DSMR logger restAPI version
220+
## Aandewiel DSMR-logger API
221221
222222
<DeviceFeatures features="" />
223223
224-
Aandewiel dsmr-logger
224+
[DSMR-logger](https://github.com/mrWheel/DSMRloggerAPI) by Willem Aandewiel, REST-API version
225225
226226
<DeviceConfig code={`meters:
227227
- name: my_grid
@@ -2478,17 +2478,7 @@ Benutzername und Passwort sind identisch zum Web-Portal bzw. My E3/DC App. Key (
24782478
port: 5033 # Port, optional
24792479
user: # Benutzerkonto, bspw. E-Mail Adresse, User Id, etc.
24802480
password: # Passwort, Bei führenden Nullen bitte in einfache Hochkommata setzen
2481-
key: # RSCP-Password`} advanced={`meters:
2482-
- name: my_grid
2483-
type: template
2484-
template: e3dc-rscp
2485-
usage: grid
2486-
host: 192.0.2.2 # IP-Adresse oder Hostname
2487-
port: 5033 # Port, optional
2488-
user: # Benutzerkonto, bspw. E-Mail Adresse, User Id, etc.
2489-
password: # Passwort, Bei führenden Nullen bitte in einfache Hochkommata setzen
2490-
key: # RSCP-Password
2491-
dischargelimit: # Entladelimit in W, Limitiert die Entladeleistung im 'Halten' Batteriemodus (optional)`} />
2481+
key: # RSCP-Password`} />
24922482
24932483
24942484
@@ -2514,7 +2504,6 @@ Benutzername und Passwort sind identisch zum Web-Portal bzw. My E3/DC App. Key (
25142504
user: # Benutzerkonto, bspw. E-Mail Adresse, User Id, etc.
25152505
password: # Passwort, Bei führenden Nullen bitte in einfache Hochkommata setzen
25162506
key: # RSCP-Password
2517-
dischargelimit: # Entladelimit in W, Limitiert die Entladeleistung im 'Halten' Batteriemodus (optional)
25182507
maxacpower: 0 # Maximale AC Leistung des Hybrid-Wechselrichters (W), optional
25192508
externalpower: true # Externe Quelle einschließen, Bezieht alle angeschlossenen externen Quellen in die PV-Berechnung ein (Standard). (optional)`} />
25202509
@@ -5184,6 +5173,8 @@ Siehe https://forum.huawei.com/enterprise/en/modbus-tcp-guide/thread/66725067715
51845173
port: 502 # Port
51855174
timeout: 15s # Zeitüberschreitung, optional
51865175
storageunit: 1 # Nummer des Batteriespeichers, optional
5176+
minsoc: 25 # Minimaler Ladestand (%), Untere Grenze beim Entladen der Batterie im normalen Betrieb (optional)
5177+
maxsoc: 95 # Maximaler Ladestand (%), Oberes Limit beim Laden der Batterie aus dem Netz (optional)
51875178
maxchargepower: 10000 # Maximale Ladeleistung (W), Für erzwungenes Laden des Speichers. (optional)
51885179
maxdischargepower: # Maximale Entladeleistung (W), Maximale Entladeleistung des Speichers. (optional)
51895180
capacity: 50 # Akkukapazität (kWh), optional
@@ -6043,6 +6034,8 @@ _siehe auch https://github.com/evcc-io/evcc/wiki/Kostal-Plenticore_
60436034
endianness: little # Byte-Reihenfolge (Little/Big), [little, big] (optional)
60446035
capacity: 50 # Akkukapazität (kWh), optional
60456036
maxchargerate: 100 # Maximale prozentuale Ladeleistung (%), Für erzwungenes Laden des Speichers in Prozent in Relation zur maximalen Ladeleistung des Batteriewechselrichters. (optional)
6037+
minsoc: 25 # Minimaler Ladestand (%), Untere Grenze beim Entladen der Batterie im normalen Betrieb (optional)
6038+
maxsoc: 95 # Maximaler Ladestand (%), Oberes Limit beim Laden der Batterie aus dem Netz (optional)
60466039
watchdog: 60s # Watchdog, optional`} />
60476040
60486041
@@ -6640,7 +6633,7 @@ Um die Batteriesteuerung zu nutzen, wird eine Firmwareversionen größer gleich
66406633
host: 192.0.2.2 # Hostname
66416634
port: 502 # Port
66426635
capacity: 5.12 # Akkukapazität (kWh), Venus-E 5.12 kWh, Venus-C 2.56 kWh (optional)
6643-
minsoc: 11 # Minimaler Ladestand (%), Venus kann nur bis 11% entladen werden. (optional)
6636+
minsoc: 11 # Minimaler Ladestand (%), Untere Grenze beim Entladen der Batterie im normalen Betrieb (optional)
66446637
maxsoc: 100 # Maximaler Ladestand (%), Oberes Limit beim Laden der Batterie aus dem Netz (optional)
66456638
maxchargepower: 2500 # Maximale Ladeleistung (W), 2500W ist das Maximum für Venus. (optional)
66466639
work_mode_normal: 1 # Work mode für Normal-Modus, 0=manuell, 1=Eigenverbrauch, 2=AI-Optimierung. (optional)`} />

0 commit comments

Comments
 (0)