evcc-io/templates/definition/meter/huawei-sun2000-hybrid.yaml

499 lines
16 KiB
YAML

template: huawei-sun2000-hybrid
covers: ["huawei-sun2000", "huawei-dongle-powersensor", "huawei-sun2000-rs485"]
products:
- brand: Huawei
description:
de: SUN2000 Hybrid-Wechselrichter
en: SUN2000 Hybrid Inverter
capabilities: ["battery-control", "curtail", "dim"]
requirements:
description:
de: |
Netz und Batterie erfordern den Huawei Smart Power Sensor (DDSU/DTSU666 or SmartPS).
Modbus TCP erfordert die Freischaltung in den Kommunikationseinstellungen des Wechselrichters via "Installateur Zugang", siehe [Modbus TCP Aktivierungs-Anleitung](https://forum.huawei.com/enterprise/en/modbus-tcp-guide/thread/667250677153415168-667213868771979264).
##### WARNUNG!
Die folgendenden Gegebenheiten können zu Unterbrechungen in der Modbus-Kommunikation führen:
- veraltete Firmware
- Änderung von Wechselrichter/Speicher-Einstellungen über das Huawei FusionSolar-Portal
- weitere Anwendungen (z.B. Home Assistant) greifen über einen Modbus Proxy auf die Anlage zu (auch abhängig von der Anlagenkomplexität, z.B. Anzahl kaskadierter Wechselrichter)
en: |
Grid and Battery require the Huawei Smart Power Sensor (DDSU/DTSU666 or SmartPS).
Modbus TCP requires activation within the communication settings of the inverter using an "installer account", see [Modbus TCP Activation Guide](https://forum.huawei.com/enterprise/en/modbus-tcp-guide/thread/667250677153415168-667213868771979264).
##### WARNING!
Please beware that the following circumstances may lead to Modbus communication interruptions:
- outdated firmware
- altering inverter/battery configuration settings via Huawei FusionSolar portal
- other applications (e.g. Home Assistant) accessing the inverter via Modbus proxy (also depending on plant complexity, e.g. number of cascaded inverters)
params:
- name: usage
choice: ["grid", "pv", "battery"]
- name: modbus
choice: ["rs485", "tcpip"]
- name: timeout
default: 15s
- name: maxacpower
service: modbus/read?address=30075&type=holding&encoding=uint32&{modbus}
- name: curtailpercent
description:
de: Wirkleistungsbegrenzung in Prozent
en: Active power limit in percent
advanced: true
usages: ["pv"]
- name: storageunit
- name: forceaccharging
default: false
advanced: true
type: bool
usages: ["battery"]
description:
en: Inverter cascade
de: Wechselrichterkaskade
help:
en: Keep AC charging active (except for when being dimmed) to charge the storage from other inverters via AC. May prevent standby with older firmware versions.
de: AC-Laden bleibt aktiv (außer bei einer aktiven Leistungsreduzierung) zum Laden des Speichers aus anderen AC Quellen für Wechselrichterkaskaden. Verhindert u.U. den Standby mit älteren Firmware-Versionen.
- preset: battery-params
- name: capacity
service: modbus/read?address=37758&type=holding&encoding=uint32&scale=0.001&{modbus}
- name: maxchargepower
service: modbus/read?address=37046&type=holding&encoding=uint32&{modbus}
required: true
- name: maxdischargepower
service: modbus/read?address=37048&type=holding&encoding=uint32&{modbus}
required: true
- name: minsoc
service: modbus/read?address=47082&type=holding&encoding=uint16&scale=0.1&{modbus}
- name: maxsoc
service: modbus/read?address=47081&type=holding&encoding=uint16&scale=0.1&{modbus}
render: |
type: custom
{{- if eq .usage "grid" }}
power:
source: modbus
{{- include "modbus" . | indent 2 }}
timeout: {{ .timeout }}
connectdelay: 1s
register:
address: 37113 # Grid import/export power
type: holding
decode: int32nan
block: # 37107-37122
register: 37107
count: 16
scale: -1
energy:
source: modbus
{{- include "modbus" . | indent 2 }}
timeout: {{ .timeout }}
register:
address: 37121 # Active energy imported from the grid
type: holding
decode: uint32nan
block: # 37107-37122
register: 37107
count: 16
scale: 0.01
returnenergy:
source: modbus
{{- include "modbus" . | indent 2 }}
timeout: {{ .timeout }}
register:
address: 37119 # Active energy exported to the grid
type: holding
decode: uint32nan
block: # 37107-37122
register: 37107
count: 16
scale: 0.01
currents:
- source: modbus
{{- include "modbus" . | indent 2 }}
timeout: {{ .timeout }}
register:
address: 37107 # Huawei phase A grid current
type: holding
decode: int32nan
block: # 37107-37122
register: 37107
count: 16
scale: -0.01
- source: modbus
{{- include "modbus" . | indent 2 }}
timeout: {{ .timeout }}
register:
address: 37109 # Huawei phase B grid current
type: holding
decode: int32nan
block: # 37107-37122
register: 37107
count: 16
scale: -0.01
- source: modbus
{{- include "modbus" . | indent 2 }}
timeout: {{ .timeout }}
register:
address: 37111 # Huawei phase C grid current
type: holding
decode: int32nan
block: # 37107-37122
register: 37107
count: 16
scale: -0.01
{{- end }}
{{- if eq .usage "pv" }}
power:
source: modbus
{{- include "modbus" . | indent 2 }}
timeout: {{ .timeout }}
connectdelay: 1s
register:
address: 32064 # Input power DC
type: holding
decode: int32nan
energy:
source: modbus
{{- include "modbus" . | indent 2 }}
timeout: {{ .timeout }}
register:
address: 32108 # Total DC Input Energy
type: holding
decode: uint32nan
scale: 0.01
maxacpower: {{ .maxacpower }}
curtail:
source: ifelse
if:
source: convert
convert: bool2int
set:
source: sequence
set:
- source: const
value: {{ .curtailpercent }}
set:
source: modbus
{{- include "modbus" . | indent 10 }}
register:
address: 47418 # Maximum Feed Grid Power (0-100 %)
type: writesingle
encoding: uint16
scale: 10
- source: const
value: 7 # Power-limited grid connection (%)
set:
source: modbus
{{- include "modbus" . | indent 10 }}
register:
address: 47415 # Active power control mode
type: writesingle
encoding: uint16
else:
source: convert
convert: bool2int
set:
source: const
value: 0 # Unlimited
set:
source: modbus
{{- include "modbus" . | indent 8 }}
register:
address: 47415 # Active power control mode
type: writesingle
encoding: uint16
curtailed:
source: modbus
{{- include "modbus" . | indent 2 }}
register:
address: 47415 # Active power control mode (0=no curtailment)
type: holding
decode: uint16
{{- end }}
{{- if eq .usage "battery" }}
power:
source: modbus
{{- include "modbus" . | indent 2 }}
timeout: {{ .timeout }}
connectdelay: 1s
register:
{{- if eq .storageunit "2" }}
address: 37743
{{- else }}
address: 37001
{{- end }}
type: holding
decode: int32nan
scale: -1
energy:
source: modbus
{{- include "modbus" . | indent 2 }}
timeout: {{ .timeout }}
register:
{{- if eq .storageunit "2" }}
address: 37755 # [Energy storage unit 2] Total discharge
{{- else }}
address: 37068 # [Energy storage unit 1] Total discharge
{{- end }}
type: holding
decode: uint32nan
scale: 0.01
returnenergy:
source: modbus
{{- include "modbus" . | indent 2 }}
timeout: {{ .timeout }}
register:
{{- if eq .storageunit "2" }}
address: 37753 # [Energy storage unit 2] Total charge
{{- else }}
address: 37066 # [Energy storage unit 1] Total charge
{{- end }}
type: holding
decode: uint32nan
scale: 0.01
soc:
source: modbus
{{- include "modbus" . | indent 2 }}
timeout: {{ .timeout }}
register:
{{- if eq .storageunit "2" }}
address: 37738
{{- else }}
address: 37004
{{- end }}
type: holding
decode: uint16nan
scale: 0.1
dim:
source: ifelse
if:
source: convert
convert: bool2int
set:
source: const
value: 0 # Disable
set:
source: modbus
{{- include "modbus" . | indent 8 }}
register:
address: 47087 # Charge from grid
type: writesingle
encoding: uint16
else:
source: convert
convert: bool2int
set:
{{- if eq .forceaccharging "true" }}
source: const
value: 1 # Enable
set:
source: modbus
{{- include "modbus" . | indent 8 }}
register:
address: 47087 # Charge from grid
type: writesingle
encoding: uint16
{{- else }}
source: sleep
duration: 0s
{{- end }}
dimmed:
source: go
in:
- name: v
type: int
config:
source: modbus
{{- include "modbus" . | indent 6 }}
register:
address: 47087 # Charge from grid (0=disabled → dimmed, 1=enabled → not dimmed)
type: holding
decode: uint16
script: v == 0
batterymode:
source: sequence
set:
- source: switch
switch:
- case: 1 # normal
set:
source: sequence
set:
- source: const
value: 0 # stop
set:
source: modbus
{{- include "modbus" . | indent 16 }}
register:
address: 47100 # Forcible charge/discharge
type: writesingle
encoding: uint16
# register 47077 is range-checked: a maxdischargepower above the
# inverter rated max (37048) is rejected, so clamp before writing
- source: go
in:
- name: rated
type: int
config:
source: cached
cache: 1h # rated max is static
value:
source: modbus
{{- include "modbus" . | indent 22 }}
register:
address: 37048 # [ESS] Maximum discharge power (RO)
type: holding
decode: uint32
out:
- name: power
type: int
config:
source: modbus
{{- include "modbus" . | indent 20 }}
register:
address: 47077 # Max. Discharge Power
type: writemultiple
encoding: uint32
script: |
limit := {{ .maxdischargepower }}
out := rated
if limit < rated { out = limit }
out
{{- if eq .forceaccharging "false" }}
- source: const
value: 0 # Disable
set:
source: modbus
{{- include "modbus" . | indent 16 }}
register:
address: 47087 # Charge from grid
type: writesingle
encoding: uint16
{{- end }}
- case: 2 # hold
set:
source: sequence
set:
- source: const
value: 0 # stop
set:
source: modbus
{{- include "modbus" . | indent 16 }}
register:
address: 47100 # Forcible charge/discharge
type: writesingle
encoding: uint16
- source: const
value: 0 # W Discharge Power
set:
source: modbus
{{- include "modbus" . | indent 16 }}
register:
address: 47077 # Max. Discharge Power
type: writemultiple
encoding: uint32
{{- if eq .forceaccharging "false" }}
- source: const
value: 0 # Disable
set:
source: modbus
{{- include "modbus" . | indent 16 }}
register:
address: 47087 # Charge from grid
type: writesingle
encoding: uint16
{{- end }}
- case: 3 # charge
set:
source: sequence
set:
- source: const
value: 1 # Enable
set:
source: modbus
{{- include "modbus" . | indent 16 }}
register:
address: 47087 # Charge from grid
type: writesingle
encoding: uint16
# clamp maxchargepower to the inverter rated max (37046) for parity
# with discharge, avoiding a stale out-of-range value
- source: go
in:
- name: rated
type: int
config:
source: cached
cache: 1h # rated max is static
value:
source: modbus
{{- include "modbus" . | indent 22 }}
register:
address: 37046 # [ESS] Maximum charge power (RO)
type: holding
decode: uint32
out:
- name: power
type: int
config:
source: modbus
{{- include "modbus" . | indent 20 }}
register:
address: 47247 # Forcible charge power
type: writemultiple
encoding: uint32
script: |
limit := {{ .maxchargepower }}
out := rated
if limit < rated { out = limit }
out
- source: const
value: 1 # Minute
set:
source: modbus
{{- include "modbus" . | indent 16 }}
register:
address: 47083 # Forced charging and discharging period
type: writesingle
encoding: uint16
- source: const
value: 0 # duration
set:
source: modbus
{{- include "modbus" . | indent 16 }}
register:
address: 47246 # Forcible charge/discharge setting mode
type: writesingle
encoding: uint16
- source: watchdog
timeout: 30s
reset: 1
set:
source: switch
switch:
- case: 1 # normal
set:
source: sleep
duration: 0s
- case: 2 # hold
set:
source: sleep
duration: 0s
# only charging requires repeated requests
- case: 3 # charge
set:
source: const
value: 1 # charge
set:
source: modbus
{{- include "modbus" . | indent 16 }}
register:
address: 47100 # Forcible charge/discharge
type: writesingle
encoding: uint16
{{- include "battery-params" . }}
{{- end }}