IAMMETER intergration for Grid Meter

[azzajess]

I am wondering if its possible to add IAMMETER to the list of supported devices that measure the grid electricity.
Mainly the two products are WEM3080 (single Phase) and WEM3080T (Three Phase)
They have local APIs with documentation and info from here
https://www.iammeter.com/newsshow/blog-fw-features
and some additional information here...
https://www.iammeter.com/docs/own-system#3-upload-data-to-your-own-server

[VolkerK62]

If you have this hardware, try to create a custom meter with HTTP Plugin
https://docs.evcc.io/en/docs/devices/meters#custom
https://docs.evcc.io/en/docs/reference/plugins#http-readwrite
IF this works, it is possible to create a template

[CiNcH83]

I habe hier auch einen IAMMETER (WEM3080T). Hier findet sich die Doku des lokalen REST APIs. Ich habe mal einen custom meter im Trockenen erstellt:

- name: wem3080t
  type: custom
  # saldierte Leistung u. Energie befindet sich im 4. Tuple bzw. bei Index 3
  power: # net metered power/saldierte Leistung (W)
    source: http
    uri: http://192.168.1.16/api/monitorjson
    method: GET
    headers:
    - content-type: application/json
    jq: .Datas[3][2]
    timeout: 10s
    cache: 2s
  energy: # net metered forward active energy/saldierter Energieverbrauch (kWh)
    source: http
    uri: http://192.168.1.16/api/monitorjson
    method: GET
    headers:
    - content-type: application/json
    jq: .Datas[3][3]
    timeout: 10s
    cache: 2s
  currents: # L1/L2/L3 (A)
  - source: http
    uri: http://192.168.1.16/api/monitorjson
    method: GET
    headers:
    - content-type: application/json
    jq: if .Datas[0][2] < 0 then -.Datas[0][1] else .Datas[0][1] end
    timeout: 10s
    cache: 2s
  - source: http
    uri: http://192.168.1.16/api/monitorjson
    method: GET
    headers:
    - content-type: application/json
    jq: if .Datas[1][2] < 0 then -.Datas[1][1] else .Datas[1][1] end
    timeout: 10s
    cache: 2s
  - source: http
    uri: http://192.168.1.16/api/monitorjson
    method: GET
    headers:
    - content-type: application/json
    jq: if .Datas[2][2] < 0 then -.Datas[2][1] else .Datas[2][1] end
    timeout: 10s
    cache: 2s
  voltages: # L1/L2/L3 (V)
  - source: http
    uri: http://192.168.1.16/api/monitorjson
    method: GET
    headers:
    - content-type: application/json
    jq: .Datas[0][0]
    timeout: 10s
    cache: 2s
  - source: http
    uri: http://192.168.1.16/api/monitorjson
    method: GET
    headers:
    - content-type: application/json
    jq: .Datas[1][0]
    timeout: 10s
    cache: 2s
  - source: http
    uri: http://192.168.1.16/api/monitorjson
    method: GET
    headers:
    - content-type: application/json
    jq: .Datas[2][0]
    timeout: 10s
    cache: 2s

ACHTUNG! Ich habe das noch nicht getestet. Was zu beachten ist:

1. IP Adresse muss entsprechend angepasst werden
2. NET Metering muss im Zähler aktiviert sein. Nur dann gibt es das 4. Tuple im Response, bei dem die Werte der saldierten (und nicht phasenweisen) Leistung/Energie entsprechen

Ein paar Fragen von meiner Seite:

1. Muss für jeden Datenpunkt ein neuer Request abgesetzt werden?
2. Gibt es auch einen Datenpunkt für exportierte/eingespeiste Energie (reverse active energy)?

[VolkerK62]

zu 1) es gibt seit kurzem auch cache. #18152
Hab ich noch nicht benutzt. Ich denke, dass ( cache: 2s ) muss dann zu jeder Abfrage hinzugefügt werden
zu 2) nein, es gibt nur einen energy Parameter

[CiNcH83]

Der custom meter scheint zu funktionieren. Den cache habe ich hinzugefügt. Allerdings scheint er pro Zyklus 2 Abfragen abzusetzen:

[wem3080t] TRACE 2025/03/05 16:55:13 GET http://192.168.1.16/api/monitorjson
[wem3080t] TRACE 2025/03/05 16:55:13 {"method":"2-5","mac":"","version":"i.76.058.8","server":"em","SN":"","Datas":[[231.8,1.560,-356.0,1128.468,5809.802,50.01,0.99],[231.6,1.570,-306.0,2396.350,4803.104,50.01,0.85],[233.3,0.870,-113.0,1839.225,4721.446,50.01,0.55],[232.2,0.000,-775.0,3930.543,13903.074,50.01,0.55]]}
[wem3080t] TRACE 2025/03/05 16:55:13 GET http://192.168.1.16/api/monitorjson
[wem3080t] TRACE 2025/03/05 16:55:13 {"method":"2-5","mac":"","version":"i.76.058.8","server":"em","SN":"","Datas":[[231.7,1.550,-354.0,1128.468,5809.802,50.01,0.98],[231.7,1.560,-305.0,2396.350,4803.104,50.01,0.84],[233.3,0.860,-112.0,1839.225,4721.446,50.01,0.56],[232.2,0.000,-771.0,3930.543,13903.074,50.01,0.56]]}
[wem3080t] TRACE 2025/03/05 16:55:43 GET http://192.168.1.16/api/monitorjson
[wem3080t] TRACE 2025/03/05 16:55:43 {"method":"2-5","mac":"","version":"i.76.058.8","server":"em","SN":"","Datas":[[231.9,1.550,-353.0,1128.468,5809.805,50.01,0.98],[231.7,1.600,-313.0,2396.350,4803.106,50.01,0.85],[233.8,0.850,-111.0,1839.225,4721.447,50.01,0.56],[232.5,0.000,-777.0,3930.543,13903.080,50.01,0.56]]}
[wem3080t] TRACE 2025/03/05 16:55:43 GET http://192.168.1.16/api/monitorjson
[wem3080t] TRACE 2025/03/05 16:55:43 {"method":"2-5","mac":"","version":"i.76.058.8","server":"em","SN":"","Datas":[[231.9,1.550,-353.0,1128.468,5809.805,50.01,0.98],

Auch eine Änderung auf cache: 5s hat nichts gebracht. Oder sieht man den Log-Eintrag trotzdem und der Request wird aus dem Cache bedient? Wie kann ich den custom meter möglichst einfach visualisieren, ohne dass ich gleich ein ganzes Solar- oder Ladesystem anlegen muss? Aktuell hängt der Zähler als ext in der site.

[EDIT]
OK, jetzt sehe ich alle 5 Requests. Evtl. hat da im YAML was mit der Einrückung bei den currents nicht gepasst!?

[CiNcH83]

Ah, jetzt habe ich die powers verstanden, danke. Habe dazu keine Anleitung gefunden...

[VolkerK62]

stimmt, ist in der Doku beim Custom Meter nicht aufgeführt.
Es gibt auch noch voltages (Phasenspannung).
Das ist bei einem Charge Meter ziemlich nützlich. Dadurch wird z.B. automatisch erkannt, ob eine Wallbox 1p oder 3p angeschlossen ist.

[CiNcH83]

Alles klar. Danke für die Info. Ich werde die Vorzeichengeschichte noch ausprobieren und die Spannung ergänzen.

[CiNcH83]

Den custom meter oben habe ich angepasst.

[CiNcH83]

Power ist negativ, aber alle Currents sind positiv. Dann kommen die wohl ohne Vorzeichen Wenn du noch die Phasenpower ( powers ) mit reinnimmst, dann vergibt evcc auf der Basis die richtigen Vorzeichen an die Ströme.

Scheint nicht der Fall zu sein, siehe hier.

[CiNcH83]

Hier noch der Vorschlag für das Template:

template: iammeter-3p
products:
  - brand: IAMMETER
    description:
      generic: WEM3080T/WEM3046T/WEM3050T
requirements:
  description:
    de: |
      Benötigt die Aktivierung des Net Metering Mode (NEM) (=phasensaldierende Zählung). 
      Siehe https://www.iammeter.com/newsshow/net-energy-metering
    en: |
      Requires Net Metering Mode (NEM) to be enabled.
      See https://www.iammeter.com/newsshow/net-energy-metering
params:
  - name: usage
    choice: ["grid", "pv", "charge"]
  - name: host
  - name: timeout
    default: 10s
render: |
  type: custom
  # net metered power/saldierte Leistung (W)
  power:
    source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: .Datas[3][2]
    timeout: {{ .timeout }}
    cache: 2s
  # net metered forward active energy/saldierter Energieverbrauch (kWh)
  energy:
    source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: .Datas[3][3]
    timeout: {{ .timeout }}
    cache: 2s
  currents:
  # L1 current (A)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas[0][2] < 0 then -.Datas[0][1] else .Datas[0][1] end
    timeout: {{ .timeout }}
    cache: 2s
  # L2 current (A)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas[1][2] < 0 then -.Datas[1][1] else .Datas[1][1] end
    timeout: {{ .timeout }}
    cache: 2s
  # L3 current (A)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas[2][2] < 0 then -.Datas[2][1] else .Datas[2][1] end
    timeout: {{ .timeout }}
    cache: 2s
  voltages:
  # L1 voltage (V)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: .Datas[0][0]
    timeout: {{ .timeout }}
    cache: 2s
  # L2 voltage (V)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: .Datas[1][0]
    timeout: {{ .timeout }}
    cache: 2s
  # L3 voltage (V)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: .Datas[2][0]
    timeout: {{ .timeout }}
    cache: 2s

Usage:

- name: wem3080t
  type: template
  template: iammeter-3p
  usage: grid
  host: 192.168.1.16
  timeout: 10s

ACHTUNG! Noch nicht getestet!

Ich bin noch unschlüssig, ob ich die phasenweise Leistung auch hinzufügen soll. Könnte ich die dann innerhalb des Templates auch zur Ermittlung der Vorzeichen für die Ströme referenzieren ohne erneute Abfrage?

[VolkerK62]

Ich bin noch unschlüssig, ob ich die phasenweise Leistung auch hinzufügen soll. Könnte ich die dann innerhalb des Templates auch zur Ermittlung der Vorzeichen für die Ströme referenzieren ohne erneute Abfrage?

Wenn die Phasenleistungen drin sind, dann brauchst du für die Ströme keine Referenzierung mehr. Das macht evcc dann intern. Ist z.B. bei meinem Shelly so.

[VolkerK62]

und dann auch noch den Hinweis "NET Metering muss im Zähler aktiviert sein."
ins Template aufnehmen

[CiNcH83]

und dann auch noch den Hinweis "NET Metering muss im Zähler aktiviert sein." ins Template aufnehmen

Ist doch schon...

[VolkerK62]

ah, hast du geändert. Hatte ich nicht gesehen

[CiNcH83]

Genau, das Ding "lebt" momentan noch etwas...

Wenn die Phasenleistungen drin sind, dann brauchst du für die Ströme keine Referenzierung mehr. Das macht evcc dann intern. Ist z.B. bei meinem Shelly so.

Ah OK. Probiere ich noch aus. Schaden tun die phasenweisen Leistungen ja auch nicht...

[CiNcH83]

Hier noch für den einphasigen WEM3080:

template: iammeter-1p
products:
  - brand: IAMMETER
    description:
      generic: WEM3080
params:
  - name: usage
    choice: ["grid", "pv", "charge"]
  - name: host
  - name: timeout
    default: 10s
render: |
  type: custom
  # net metered power/saldierte Leistung (W)
  power:
    source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: .Data[2]
    timeout: {{ .timeout }}
    cache: 2s
  # net metered forward active energy/saldierter Energieverbrauch (kWh)
  energy:
    source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: .Data[3]
    timeout: {{ .timeout }}
    cache: 2s
  currents:
  # current (A)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Data[2] < 0 then -.Data[1] else .Data[1] end
    timeout: {{ .timeout }}
    cache: 2s
  - source: const
    value: 0  # single phase meter
  - source: const
    value: 0  # single phase meter
  voltages:
  # voltage (V)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: .Data[0]
    timeout: {{ .timeout }}
    cache: 2s
  - source: const
    value: 0  # single phase meter
  - source: const
    value: 0  # single phase meter

Den kann ich leider nicht testen. Implementierung basierend auf diesen Infos.

[VolkerK62]

Sahnehäubchen: Wäre schön, wenn es nur ein Template gäbe, das 1p/3p erkennt

[CiNcH83]

Gibt es da ein Beispiel für? D.h. ich würde einen Parameter für 1p/3p hinzufügen und diesen dann in jq abfragen? Oder gibt es da schon einen wie phases im loadpoint?

[CiNcH83]

Sahnehäubchen: Wäre schön, wenn es nur ein Template gäbe, das 1p/3p erkennt

Bin noch unschlüssig, ob sich daraus wirklich ein Benefit ergibt. Es gibt dann zwar nur noch ein Template, das ist dafür aber komplexer und nicht mehr auf den ersten Blick verständlich. Für den Endanwender macht es keinen großen Unterschied. Bzw. bin ich nicht sicher, ob es nicht gar komplizierter wird. NEM wird nur für den 3p benötigt...

[VolkerK62]

Hier ist ein Beispiel, wie man im Template Bedingungen einbringt.
https://github.com/evcc-io/evcc/blob/master/templates/definition/meter/enphase.yaml

Meines Wissens gibt es dafür keinen Parameter. Idee ist eine Art automatische Erkennung.
Ich kenne JSON nur rudimentär, aber bei 1p gibt es ja nur einen "Datensatz" (keine Ahnung wie die korrekte Bezeichnung ist), wohingegen es bei 3p davon 4 (je Phase und gesamt) gibt.

[CiNcH83]

OK. Stimmt. Bei IAMMETER heißen die Felder auch noch zudem anders beim 1p und 3p. D.h. ich müsste einfach nur auf Existenz prüfen.

[CiNcH83]

Hier das gemeinsame Template:

template: iammeter
products:
  - brand: IAMMETER
    description:
      generic: WEM3080T/WEM3046T/WEM3050T
  - brand: IAMMETER
    description:
      generic: WEM3080
requirements:
  description:
    de: |
      Die 3-phasigen Zähler (WEM3080T/WEM3046T/WEM3050T) benötigen die Aktivierung des Net Metering Mode (NEM) (=phasensaldierende Zählung). 
      Siehe https://www.iammeter.com/newsshow/net-energy-metering
    en: |
      3-phase meters (WEM3080T/WEM3046T/WEM3050T) require Net Metering Mode (NEM) to be enabled.
      See https://www.iammeter.com/newsshow/net-energy-metering
params:
  - name: usage
    choice: ["grid", "pv", "charge"]
  - name: host
  - name: timeout
    default: 10s
render: |
  type: custom
  # net metered power/saldierte Leistung (W)
  power:
    source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas then .Datas[3][2] else .Data[2] end
    timeout: {{ .timeout }}
    cache: 2s
  # net metered forward active energy/saldierter Energieverbrauch (kWh)
  energy:
    source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas then .Datas[3][3] else .Data[3] end
    timeout: {{ .timeout }}
    cache: 2s
  powers:
  # L1 power (W)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas then .Datas[0][2] else .Data[2] end
    timeout: {{ .timeout }}
    cache: 2s
  # L2 power (W)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas then .Datas[1][2] else 0 end
    timeout: {{ .timeout }}
    cache: 2s
  # L3 power (W)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas then .Datas[2][2] else 0 end
    timeout: {{ .timeout }}
    cache: 2s  
  currents:
  # L1 current (A)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas then Datas[0][1] else .Data[1] end
    timeout: {{ .timeout }}
    cache: 2s
  # L2 current (A)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas then .Datas[1][1] else 0 end
    timeout: {{ .timeout }}
    cache: 2s
  # L3 current (A)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas then .Datas[2][1] else 0 end
    timeout: {{ .timeout }}
    cache: 2s
  voltages:
  # L1 voltage (V)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas then .Datas[0][0] else .Data[0] end
    timeout: {{ .timeout }}
    cache: 2s
  # L2 voltage (V)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas then .Datas[1][0] else 0 end
    timeout: {{ .timeout }}
    cache: 2s
  # L3 voltage (V)
  - source: http
    uri: http://{{ .host }}/api/monitorjson
    jq: if .Datas then .Datas[2][0] else 0 end
    timeout: {{ .timeout }}
    cache: 2s

Muss ich jetzt noch testen, ob sich da kein Syntaxfehler eingeschlichen hat, sprich ob es funktioniert und ob die Vorzeichengeschichte so funkioniert. Den einphasigen kann ich nicht testen.

Zum PR komme ich aber erst nächste Woche. Gerne in der Zwischenzeit noch Feedback...

[andig]

docker run -it evcc/evcc charger

?

[CiNcH83]

Es geht um dieses Kommando..

evcc --template-type meter --template /root/.evcc/iammeter.yaml

..mit dem Nightly.

Ich habe den Container via docker-compose aufgespannt.

[andig]

Ich habe den Container via docker-compose aufgespannt.

Wozu? Brauchts nicht. Bei Dateien musst du natürlich ein Volume mounten.

[CiNcH83]

Ich bekomme es nicht hin. Muss ich dann den aktuellen evcc Container erst löschen? Und dann spanne ich einen neuen per Run auf?

Folgendes schluckt er schon einmal nicht (brauche ja auch das Nightly...):

sudo docker run -it evcc/evcc --template-type meter --template /root/.evcc/iammeter.yaml --name evcc \
-v /home/Automation/evcc/.evcc:/root/.evcc \
evcc/evcc:nightly
Error: unknown command "evcc/evcc:nightly" for "evcc"
Run 'evcc --help' for usage.
unknown command "evcc/evcc:nightly" for "evcc"

[CiNcH83]

Wenn ich das Nightly weglasse:

sudo docker run -it evcc/evcc --template-type meter --template /root/.evcc/iammeter.yaml --name evcc -v /home/Automation/evcc/.evcc:/root/.evcc
Error: unknown flag: --template-type
Usage:
  evcc [flags]
  evcc [command]

Available Commands:
  charger     Query configured chargers
  checkconfig Check config file for errors
  completion  Generate the autocompletion script for the specified shell
  config      Dump database configuration
  configure   Create configuration (evcc.yaml)
  detect      Auto-detect compatible hardware
  device      Query database-configured devices (debug only)
  discuss     Request support at Github Discussions (https://github.com/evcc-io/evcc/discussions/categories/erste-hilfe)
  dump        Dump configuration
  eebus-cert  Generate EEBUS certificate for using EEBUS compatible chargers
  health      Check application health
  help        Help about any command
  meter       Query configured meters
  migrate     Migrate yaml to database (overwrites db settings)
  password    Password administration
  settings    Manage configuration settings
  sponsor     Validate sponsor token
  sunspec     Dump SunSpec model information
  tariff      Query configured tariff
  token       Generate token credentials
  vehicle     Query configured vehicles

Flags:
  -c, --config string     Config file (default "~/evcc.yaml" or "/etc/evcc.yaml")
      --database string   Database location (default "~/.evcc/evcc.db")
      --disable-auth      Disable authentication (dangerous)
  -h, --help              Help
      --ignore-db         Run command ignoring service database
  -l, --log string        Log level (fatal, error, warn, info, debug, trace) (default "info")
      --log-headers       Log headers
      --metrics           Expose metrics
      --profile           Expose pprof profiles
  -v, --version           version for evcc

Use "evcc [command] --help" for more information about a command.

unknown flag: --template-type

Das Nightly habe ich gepullt:

services:
  evcc:
    command:
      - evcc
    container_name: evcc
    image: evcc/evcc:nightly
    network_mode: host
    volumes:
      - /home/Automation/evcc/evcc.yaml:/etc/evcc.yaml
      - /home/Automation/evcc/.evcc:/root/.evcc
      - /etc/machine-id:/etc/machine-id
      - /var/lib/dbus/machine-id:/var/lib/dbus/machine-id
    restart: unless-stopped

docker compose pull
docker compose up -d

[CiNcH83]

Fortsetzung hier: #19640