SofarBTS-Steuerung hinzugefügt

This commit is contained in:
sharky committed 2026-10-09 20:02:24 +02:00
1 parent 051efc3f63
commit 39558bf906
1 file changed
+617
+617
View File
@@ -0,0 +1,617 @@
# 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 }}"