Files

618 lines
24 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# SOFAR BTS V4 – Home Assistant Package
# HYD 10KTL-3PH V120005 / ha-solarman v25.08.16
# BITTE vor dem Einsatz komplette Konfiguration sichern.
# Automatische Erkennung der beiden physisch verfuegbaren Batterieanschluesse:
# ID 0 -> BMS Adresse 1; ID 1 -> BMS Adresse 17.
# Eine dritte ID (2) wurde am Wechselrichter bereits als unzulaessig abgewiesen.
# Register 4175 = konfigurierte Kapazitaet in Ah; BTS 5K = 100 Ah/Modul.
# Es gibt keine Bedienfunktion zum Aendern von Stromgrenzen.
# Technisch benoetigter FC16-Block (19 Register) sendet sie jedoch unveraendert mit.
# ACHTUNG: EOD/EPS-Schreiben ist an dieser Anlage NOCH NICHT praktisch bestaetigt.
# Dieses Paket ersetzt V1/V2/V3, niemals parallel aktivieren.
input_boolean:
sofar_bts_turm0_erkannt:
name: SOFAR BTS BAT1 erkannt
icon: mdi:battery-check
sofar_bts_turm1_erkannt:
name: SOFAR BTS BAT2 erkannt
icon: mdi:battery-check
input_text:
sofar_bts_turm0_reg19:
name: SOFAR BTS BAT1 Registerabbild
max: 255
sofar_bts_turm1_reg19:
name: SOFAR BTS BAT2 Registerabbild
max: 255
input_datetime:
sofar_bts_turm0_zeit:
name: SOFAR BTS BAT1 letzter Abruf
has_date: true
has_time: true
sofar_bts_turm1_zeit:
name: SOFAR BTS BAT2 letzter Abruf
has_date: true
has_time: true
# Gemeinsame Sollwerte sind lediglich Eingabefelder. Erst die jeweilige
# 'Auf beide anwenden'-Schaltflaeche sendet Aenderungen an den Wechselrichter.
input_number:
sofar_bts_alle_dod:
name: SOFAR BTS DOD fuer beide BAT
min: 1
max: 90
step: 1
initial: 85
unit_of_measurement: '%'
mode: slider
sofar_bts_alle_eod:
name: SOFAR BTS EOD fuer beide BAT
min: 1
max: 90
step: 1
initial: 90
unit_of_measurement: '%'
mode: slider
sofar_bts_alle_eps:
name: SOFAR BTS EPS fuer beide BAT
min: 5
max: 100
step: 1
initial: 5
unit_of_measurement: '%'
mode: slider
script:
sofar_bts_gateway:
alias: SOFAR BTS – serielles Gateway V4
description: >-
Fuer Batterie-ID 0 oder 1 Auswahl und komplette 19-Register-Lesung.
Im Modus 'erkennen' wird ungueltige Batterie-ID toleriert und Slot deaktiviert.
Nur DOD/EOD/EPS mit anschliessender Lesebestaetigung schreiben.
mode: queued
max: 30
fields:
turm:
name: Batterie-ID
required: true
selector:
select:
options:
- label: BAT1 / ID 0
value: '0'
- label: BAT2 / ID 1
value: '1'
parameter:
name: Operation
required: false
selector:
select:
options: [erkennen, lesen, dod, eod, eps]
ziel:
name: Neuer Prozentwert
required: false
selector:
number:
min: 1
max: 100
step: 1
mode: box
sequence:
- variables:
tid: "{{ turm | int(-1) }}"
par: "{{ parameter | default('lesen', true) }}"
z: "{{ ziel | float(-1) if ziel is defined else -1 }}"
- if:
- condition: template
value_template: "{{ tid not in [0,1] or par not in ['erkennen','lesen','dod','eod','eps'] }}"
then:
- stop: Ungueltige Batterie-ID oder Operation. Es wurde nichts geaendert.
error: true
- variables:
idx: "{{ {'dod':9,'eod':10,'eps':14}.get(par, -1) }}"
val: "{{ z | int(-1) }}"
- if:
- condition: template
value_template: >-
{{ par in ['dod','eod','eps'] and
(z != val or (par in ['dod','eod'] and not (1 <= val <= 90))
or (par == 'eps' and not (5 <= val <= 100))) }}
then:
- stop: Sollwert ungueltig; es wurde nichts geaendert.
error: true
# Die Leseauswahl (4164, ein Wert) ist fuer ID 0 und ID 1 getestet.
# Bei Erkennung werden erwartete Fehler abgefangen. Wenn eine Auswahl
# fehlschlaegt, muss die nachfolgende Antwort ZWINGEND dieselbe ID haben.
- action: solarman.write_multiple_holding_registers
continue_on_error: true
data:
device: 9402bac3581421a90aa1b963306c0d01
register: 4164
values: "{{ [tid | int] }}"
- delay:
milliseconds: 750
- action: solarman.read_holding_registers
continue_on_error: true
data:
device: 9402bac3581421a90aa1b963306c0d01
address: 4164
count: 19
response_variable: vr
- variables:
regs: >-
{% set r = vr if vr is defined and vr is mapping else {} -%}
{% set ns = namespace(v=[]) -%}
{% for a in range(4164, 4183) -%}
{% set x = r.get(a, r.get(a | string, -1)) -%}
{% set ns.v = ns.v + [x | int(-1)] -%}
{% endfor -%}
{{ ns.v }}
valid: >-
{{ regs | count == 19 and regs | min >= 0 and regs | max <= 65535
and regs[0] == tid and regs[1] == (1 if tid == 0 else 17)
and regs[2] == 11 and regs[3] == 5000
and regs[11] >= 100 and regs[11] <= 1500
and regs[11] % 100 == 0
and regs[15] == 0 and regs[18] == 32 }}
- if:
- condition: template
value_template: "{{ not valid }}"
then:
- if:
- condition: template
value_template: "{{ par == 'erkennen' }}"
then:
- choose:
- conditions: "{{ tid == 0 }}"
sequence:
- action: input_boolean.turn_off
target:
entity_id: input_boolean.sofar_bts_turm0_erkannt
- action: input_text.set_value
target:
entity_id: input_text.sofar_bts_turm0_reg19
data:
value: '[]'
default:
- action: input_boolean.turn_off
target:
entity_id: input_boolean.sofar_bts_turm1_erkannt
- action: input_text.set_value
target:
entity_id: input_text.sofar_bts_turm1_reg19
data:
value: '[]'
- stop: Batterieeingang nicht erkannt oder Lesefehler; sicher uebersprungen.
- stop: Registerblock unvollstaendig/ungueltig. Keine Aenderung!
error: true
# Nur eine plausible Antwort mit korrekter Batterie-ID wird gespeichert.
- choose:
- conditions: "{{ tid == 0 }}"
sequence:
- action: input_text.set_value
target:
entity_id: input_text.sofar_bts_turm0_reg19
data:
value: "{{ regs | to_json }}"
- action: input_datetime.set_datetime
target:
entity_id: input_datetime.sofar_bts_turm0_zeit
data:
datetime: "{{ now().strftime('%Y-%m-%d %H:%M:%S') }}"
- action: input_boolean.turn_on
target:
entity_id: input_boolean.sofar_bts_turm0_erkannt
default:
- action: input_text.set_value
target:
entity_id: input_text.sofar_bts_turm1_reg19
data:
value: "{{ regs | to_json }}"
- action: input_datetime.set_datetime
target:
entity_id: input_datetime.sofar_bts_turm1_zeit
data:
datetime: "{{ now().strftime('%Y-%m-%d %H:%M:%S') }}"
- action: input_boolean.turn_on
target:
entity_id: input_boolean.sofar_bts_turm1_erkannt
# Bei reinen Leseaufrufen unterbleibt jeder Konfigurations-Schreibzugriff.
- if:
- condition: template
value_template: "{{ par in ['dod','eod','eps'] and regs[idx] != val }}"
then:
# Ersetze ausschliesslich den gewuenschten Wert und das Commit-Flag.
# Insbesondere 4171/4172: GAR KEINE eigenstaendige Einstelloption.
- variables:
neu: "{{ regs[:idx] + [val | int] + regs[idx+1:15] + [1] + regs[16:] }}"
- action: solarman.write_multiple_holding_registers
data:
device: 9402bac3581421a90aa1b963306c0d01
register: 4164
values: "{{ neu }}"
- delay:
seconds: 2
- action: solarman.write_multiple_holding_registers
data:
device: 9402bac3581421a90aa1b963306c0d01
register: 4164
values: "{{ [tid | int] }}"
- delay:
milliseconds: 750
- action: solarman.read_holding_registers
data:
device: 9402bac3581421a90aa1b963306c0d01
address: 4164
count: 19
response_variable: nr
- variables:
rueck: >-
{% set r = nr if nr is defined and nr is mapping else {} -%}
{% set ns = namespace(v=[]) -%}
{% for a in range(4164, 4183) -%}
{% set x = r.get(a, r.get(a | string, -1)) -%}
{% set ns.v = ns.v + [x | int(-1)] -%}
{% endfor -%}
{{ ns.v }}
- if:
- condition: template
value_template: >-
{{ rueck | count != 19 or rueck | min < 0 or
rueck[0] != tid or
(rueck[:15] + rueck[16:]) != (neu[:15] + neu[16:]) or
rueck[15] != 0 }}
then:
- stop: Nachpruefung fehlgeschlagen! Nicht erneut schreiben.
error: true
- choose:
- conditions: "{{ tid == 0 }}"
sequence:
- action: input_text.set_value
target:
entity_id: input_text.sofar_bts_turm0_reg19
data:
value: "{{ rueck | to_json }}"
- action: input_datetime.set_datetime
target:
entity_id: input_datetime.sofar_bts_turm0_zeit
data:
datetime: "{{ now().strftime('%Y-%m-%d %H:%M:%S') }}"
default:
- action: input_text.set_value
target:
entity_id: input_text.sofar_bts_turm1_reg19
data:
value: "{{ rueck | to_json }}"
- action: input_datetime.set_datetime
target:
entity_id: input_datetime.sofar_bts_turm1_zeit
data:
datetime: "{{ now().strftime('%Y-%m-%d %H:%M:%S') }}"
sofar_bts_erkennen:
alias: SOFAR BTS – Anschluesse erkennen und Einstellungen aktualisieren
icon: mdi:refresh
mode: single
sequence:
# Der WR hat nur BAT1 und BAT2. ID 2 wurde bereits als ungueltig bestaetigt.
- action: script.sofar_bts_gateway
data: {turm: 0, parameter: erkennen}
- action: script.sofar_bts_gateway
data: {turm: 1, parameter: erkennen}
sofar_bts_aktualisieren:
alias: SOFAR BTS – bekannte BAT aktualisieren
icon: mdi:refresh
mode: single
sequence:
- if:
- condition: state
entity_id: input_boolean.sofar_bts_turm0_erkannt
state: 'on'
then:
- action: script.sofar_bts_gateway
data: {turm: 0, parameter: lesen}
- if:
- condition: state
entity_id: input_boolean.sofar_bts_turm1_erkannt
state: 'on'
then:
- action: script.sofar_bts_gateway
data: {turm: 1, parameter: lesen}
sofar_bts_alle_dod_anwenden:
alias: SOFAR BTS – DOD auf alle erkannten BAT
icon: mdi:battery-lock
mode: single
sequence:
- variables:
ziel: "{{ states('input_number.sofar_bts_alle_dod') | int(-1) }}"
- if:
- condition: template
value_template: >-
{{ not is_state('input_boolean.sofar_bts_turm0_erkannt','on')
and not is_state('input_boolean.sofar_bts_turm1_erkannt','on') }}
then:
- stop: Es wurde kein Batterieeingang erkannt.
error: true
- if:
- condition: state
entity_id: input_boolean.sofar_bts_turm0_erkannt
state: 'on'
then:
- action: script.sofar_bts_gateway
data: {turm: 0, parameter: dod, ziel: "{{ ziel }}"}
- if:
- condition: state
entity_id: input_boolean.sofar_bts_turm1_erkannt
state: 'on'
then:
- action: script.sofar_bts_gateway
data: {turm: 1, parameter: dod, ziel: "{{ ziel }}"}
sofar_bts_alle_eod_anwenden:
alias: SOFAR BTS – EOD auf alle erkannten BAT
icon: mdi:battery-lock
mode: single
sequence:
- variables:
ziel: "{{ states('input_number.sofar_bts_alle_eod') | int(-1) }}"
- if:
- condition: template
value_template: >-
{{ not is_state('input_boolean.sofar_bts_turm0_erkannt','on')
and not is_state('input_boolean.sofar_bts_turm1_erkannt','on') }}
then:
- stop: Es wurde kein Batterieeingang erkannt.
error: true
- if:
- condition: state
entity_id: input_boolean.sofar_bts_turm0_erkannt
state: 'on'
then:
- action: script.sofar_bts_gateway
data: {turm: 0, parameter: eod, ziel: "{{ ziel }}"}
- if:
- condition: state
entity_id: input_boolean.sofar_bts_turm1_erkannt
state: 'on'
then:
- action: script.sofar_bts_gateway
data: {turm: 1, parameter: eod, ziel: "{{ ziel }}"}
sofar_bts_alle_eps_anwenden:
alias: SOFAR BTS – EPS-Puffer auf alle erkannten BAT
icon: mdi:battery-lock
mode: single
sequence:
- variables:
ziel: "{{ states('input_number.sofar_bts_alle_eps') | int(-1) }}"
- if:
- condition: template
value_template: >-
{{ not is_state('input_boolean.sofar_bts_turm0_erkannt','on')
and not is_state('input_boolean.sofar_bts_turm1_erkannt','on') }}
then:
- stop: Es wurde kein Batterieeingang erkannt.
error: true
- if:
- condition: state
entity_id: input_boolean.sofar_bts_turm0_erkannt
state: 'on'
then:
- action: script.sofar_bts_gateway
data: {turm: 0, parameter: eps, ziel: "{{ ziel }}"}
- if:
- condition: state
entity_id: input_boolean.sofar_bts_turm1_erkannt
state: 'on'
then:
- action: script.sofar_bts_gateway
data: {turm: 1, parameter: eps, ziel: "{{ ziel }}"}
# Beim Start Erkennung (auch nach Modul-Erweiterung); im Betrieb werden nur
# bereits erkannte Eingaenge regelmaessig aktualisiert. Manueller Button
# 'Erkennen/Aktualisieren' prueft auch bisher fehlende Eingaenge erneut.
automation:
- id: sofar_bts_v4_start
alias: SOFAR BTS V4 – nach HA-Start erkennen
triggers:
- trigger: homeassistant
event: start
actions:
- delay:
seconds: 30
- action: script.sofar_bts_erkennen
- id: sofar_bts_v4_zyklus
alias: SOFAR BTS V4 – alle 10 Minuten lesen
triggers:
- trigger: time_pattern
minutes: '/10'
actions:
- action: script.sofar_bts_aktualisieren
# Anzeige der erkannter Module/Tuerme, unabhaengig von der Solarman-
# Standard-Entitaet 'Battery DOD', die jeweils die zuletzt gewaehlte ID zeigt.
template:
- sensor:
- name: SOFAR BTS erkannte Tuerme
unique_id: sofar_bts_v4_erkannte_tuerme
default_entity_id: sensor.sofar_bts_erkannte_tuerme
icon: mdi:battery-multiple
state: >-
{{ (1 if is_state('input_boolean.sofar_bts_turm0_erkannt','on') else 0)
+ (1 if is_state('input_boolean.sofar_bts_turm1_erkannt','on') else 0) }}
- name: SOFAR BTS Module gesamt
unique_id: sofar_bts_v4_module_gesamt
default_entity_id: sensor.sofar_bts_module_gesamt
icon: mdi:battery-multiple
state: >-
{% set a = states('input_text.sofar_bts_turm0_reg19') | from_json([]) %}
{% set b = states('input_text.sofar_bts_turm1_reg19') | from_json([]) %}
{{ (a[11] // 100 if is_state('input_boolean.sofar_bts_turm0_erkannt','on') and a | count == 19 else 0)
+ (b[11] // 100 if is_state('input_boolean.sofar_bts_turm1_erkannt','on') and b | count == 19 else 0) }}
- name: SOFAR BTS BAT1 Module
unique_id: sofar_bts_v4_turm0_module
default_entity_id: sensor.sofar_bts_turm0_module
icon: mdi:battery
availability: "{{ is_state('input_boolean.sofar_bts_turm0_erkannt','on') and (states('input_text.sofar_bts_turm0_reg19') | from_json([])) | count == 19 }}"
state: >-
{% set x = states('input_text.sofar_bts_turm0_reg19') | from_json([]) %}
{{ x[11] // 100 if x | count == 19 else none }}
- name: SOFAR BTS BAT1 Kapazitaet Ah
unique_id: sofar_bts_v4_turm0_kap_ah
default_entity_id: sensor.sofar_bts_turm0_kap_ah
unit_of_measurement: Ah
availability: "{{ is_state('input_boolean.sofar_bts_turm0_erkannt','on') and (states('input_text.sofar_bts_turm0_reg19') | from_json([])) | count == 19 }}"
state: >-
{% set x = states('input_text.sofar_bts_turm0_reg19') | from_json([]) %}
{{ x[11] if x | count == 19 else none }}
- name: SOFAR BTS BAT1 Mindest SOC
unique_id: sofar_bts_v4_turm0_min_soc
default_entity_id: sensor.sofar_bts_turm0_min_soc
unit_of_measurement: '%'
availability: "{{ is_state('input_boolean.sofar_bts_turm0_erkannt','on') and (states('input_text.sofar_bts_turm0_reg19') | from_json([])) | count == 19 }}"
state: >-
{% set x = states('input_text.sofar_bts_turm0_reg19') | from_json([]) %}
{{ 100 - x[9] if x | count == 19 else none }}
- name: SOFAR BTS BAT2 Module
unique_id: sofar_bts_v4_turm1_module
default_entity_id: sensor.sofar_bts_turm1_module
icon: mdi:battery
availability: "{{ is_state('input_boolean.sofar_bts_turm1_erkannt','on') and (states('input_text.sofar_bts_turm1_reg19') | from_json([])) | count == 19 }}"
state: >-
{% set x = states('input_text.sofar_bts_turm1_reg19') | from_json([]) %}
{{ x[11] // 100 if x | count == 19 else none }}
- name: SOFAR BTS BAT2 Kapazitaet Ah
unique_id: sofar_bts_v4_turm1_kap_ah
default_entity_id: sensor.sofar_bts_turm1_kap_ah
unit_of_measurement: Ah
availability: "{{ is_state('input_boolean.sofar_bts_turm1_erkannt','on') and (states('input_text.sofar_bts_turm1_reg19') | from_json([])) | count == 19 }}"
state: >-
{% set x = states('input_text.sofar_bts_turm1_reg19') | from_json([]) %}
{{ x[11] if x | count == 19 else none }}
- name: SOFAR BTS BAT2 Mindest SOC
unique_id: sofar_bts_v4_turm1_min_soc
default_entity_id: sensor.sofar_bts_turm1_min_soc
unit_of_measurement: '%'
availability: "{{ is_state('input_boolean.sofar_bts_turm1_erkannt','on') and (states('input_text.sofar_bts_turm1_reg19') | from_json([])) | count == 19 }}"
state: >-
{% set x = states('input_text.sofar_bts_turm1_reg19') | from_json([]) %}
{{ 100 - x[9] if x | count == 19 else none }}
- number:
- name: SOFAR BTS BAT1 DOD
unique_id: sofar_bts_v4_turm0_dod
default_entity_id: number.sofar_bts_turm0_dod
icon: mdi:battery-cog
unit_of_measurement: '%'
min: 1
max: 90
step: 1
optimistic: false
availability: "{{ is_state('input_boolean.sofar_bts_turm0_erkannt','on') and (states('input_text.sofar_bts_turm0_reg19') | from_json([])) | count == 19 }}"
state: >-
{% set x = states('input_text.sofar_bts_turm0_reg19') | from_json([]) %}
{{ x[9] if x | count == 19 else none }}
set_value:
- action: script.sofar_bts_gateway
data:
turm: 0
parameter: dod
ziel: "{{ value }}"
- name: SOFAR BTS BAT1 EOD
unique_id: sofar_bts_v4_turm0_eod
default_entity_id: number.sofar_bts_turm0_eod
icon: mdi:battery-cog
unit_of_measurement: '%'
min: 1
max: 90
step: 1
optimistic: false
availability: "{{ is_state('input_boolean.sofar_bts_turm0_erkannt','on') and (states('input_text.sofar_bts_turm0_reg19') | from_json([])) | count == 19 }}"
state: >-
{% set x = states('input_text.sofar_bts_turm0_reg19') | from_json([]) %}
{{ x[10] if x | count == 19 else none }}
set_value:
- action: script.sofar_bts_gateway
data:
turm: 0
parameter: eod
ziel: "{{ value }}"
- name: SOFAR BTS BAT1 EPS
unique_id: sofar_bts_v4_turm0_eps
default_entity_id: number.sofar_bts_turm0_eps
icon: mdi:battery-cog
unit_of_measurement: '%'
min: 5
max: 100
step: 1
optimistic: false
availability: "{{ is_state('input_boolean.sofar_bts_turm0_erkannt','on') and (states('input_text.sofar_bts_turm0_reg19') | from_json([])) | count == 19 }}"
state: >-
{% set x = states('input_text.sofar_bts_turm0_reg19') | from_json([]) %}
{{ x[14] if x | count == 19 else none }}
set_value:
- action: script.sofar_bts_gateway
data:
turm: 0
parameter: eps
ziel: "{{ value }}"
- name: SOFAR BTS BAT2 DOD
unique_id: sofar_bts_v4_turm1_dod
default_entity_id: number.sofar_bts_turm1_dod
icon: mdi:battery-cog
unit_of_measurement: '%'
min: 1
max: 90
step: 1
optimistic: false
availability: "{{ is_state('input_boolean.sofar_bts_turm1_erkannt','on') and (states('input_text.sofar_bts_turm1_reg19') | from_json([])) | count == 19 }}"
state: >-
{% set x = states('input_text.sofar_bts_turm1_reg19') | from_json([]) %}
{{ x[9] if x | count == 19 else none }}
set_value:
- action: script.sofar_bts_gateway
data:
turm: 1
parameter: dod
ziel: "{{ value }}"
- name: SOFAR BTS BAT2 EOD
unique_id: sofar_bts_v4_turm1_eod
default_entity_id: number.sofar_bts_turm1_eod
icon: mdi:battery-cog
unit_of_measurement: '%'
min: 1
max: 90
step: 1
optimistic: false
availability: "{{ is_state('input_boolean.sofar_bts_turm1_erkannt','on') and (states('input_text.sofar_bts_turm1_reg19') | from_json([])) | count == 19 }}"
state: >-
{% set x = states('input_text.sofar_bts_turm1_reg19') | from_json([]) %}
{{ x[10] if x | count == 19 else none }}
set_value:
- action: script.sofar_bts_gateway
data:
turm: 1
parameter: eod
ziel: "{{ value }}"
- name: SOFAR BTS BAT2 EPS
unique_id: sofar_bts_v4_turm1_eps
default_entity_id: number.sofar_bts_turm1_eps
icon: mdi:battery-cog
unit_of_measurement: '%'
min: 5
max: 100
step: 1
optimistic: false
availability: "{{ is_state('input_boolean.sofar_bts_turm1_erkannt','on') and (states('input_text.sofar_bts_turm1_reg19') | from_json([])) | count == 19 }}"
state: >-
{% set x = states('input_text.sofar_bts_turm1_reg19') | from_json([]) %}
{{ x[14] if x | count == 19 else none }}
set_value:
- action: script.sofar_bts_gateway
data:
turm: 1
parameter: eps
ziel: "{{ value }}"