Home Assistant + Wago SPS:
Raffstoresteuerung via Modbus TCP

Modbus TCP aktivieren

In Wago e!COCKPIT bzw. im Koppler-Webinterface muss Modbus TCP aktiviert sein. Die Standardeinstellungen:

Speicheradressen festlegen

In der Wago-SPS werden Variablen über Speicheradressen angesprochen:

• %MX0.x Bit-Merker (werden als Coils über Modbus lesbar/schreibbar)
• %MD1, %MD2 ... Double-Word Merker (32-Bit, als Holding Registers verfügbar)

Adressberechnung

%MDn entspricht der Modbus-Registeradresse 12288 + n×2. Beispiel für 15 Raffstore-Positionen:

%MD1  → Adresse 12290  (Position Raffstore 1, REAL 0.0–100.0 %)
%MD2  → Adresse 12292  (Position Raffstore 2)
%MD3  → Adresse 12294  (Position Raffstore 3)
...
%MD15 → Adresse 12318  (Position Raffstore 15)

Für die genaue Coil-Adressberechnung steht unser kostenloser Online-Rechner bereit.

Wandtaster & Home Assistant konfliktfrei kombinieren

Sollen klassische Wandtaster und Home Assistant dieselbe Jalousie ansteuern können, ohne sich gegenseitig zu blockieren, liegt die Lösung nicht in Home Assistant, sondern im CFC-Programm der Wago (der grafischen Funktionsbausteinsprache). Die Eingänge werden dort über ein OR-Gatter zusammengeführt, bevor sie auf den Funktionsbaustein der Jalousie treffen:

// zusätzliche Merker für den Home-Assistant-Befehl
VAR_GLOBAL
    IN_BueroSued_auf_HA AT %MX0.0: BOOL;  // Coil – "AUF"-Befehl von HA
    IN_BueroSued_zu_HA  AT %MX0.1: BOOL;  // Coil – "ZU"-Befehl von HA
END_VAR

Der Eingang des Jalousie-Funktionsbausteins ist damit die Oder-Verknüpfung aus lokalem Taster, zentralem Sammeltaster und dem Home-Assistant-Coil. Jeder der drei Wege löst dieselbe Fahrt aus – Home Assistant überschreibt die SPS-Logik nicht, sondern reiht sich gleichberechtigt ein.

Modbus-Verbindung in configuration.yaml

In configuration.yaml (oder einer eingebundenen Paketdatei) wird die Verbindung definiert:

# configuration.yaml
modbus:
  - name: wago_sps
    type: tcp
    host: 192.168.0.111
    port: 502
    timeout: 5
    delay: 0

Positions-Sensoren (Float32, Holding Registers)

Rückmeldung der Raffstore-Position aus der SPS – der Parameter swap: word ist bei Wago-Steuerungen zwingend erforderlich:

    sensors:
      - name: "Position OG Zimmer Süd"
        address: 12290
        slave: 1
        input_type: holding
        data_type: float32
        swap: word          # Pflicht bei Wago!
        scan_interval: 5
        unit_of_measurement: "%"

      - name: "Position OG Bad"
        address: 12298
        slave: 1
        input_type: holding
        data_type: float32
        swap: word
        scan_interval: 5
        unit_of_measurement: "%"

Steuer-Switches (Coils, Hoch/Runter)

Fahrbefehle an die SPS werden als Modbus-Coils definiert:

    switches:
      - name: "Raffstore OG Süd Hoch"
        address: 12289
        slave: 1
        write_type: coil

      - name: "Raffstore OG Süd Runter"
        address: 12290
        slave: 1
        write_type: coil

Komplett Runter + Lamellen verstellen

script:
  raffstore_og_sued_zu:
    alias: "OG Süd – Komplett Runter"
    sequence:
      - service: switch.turn_on
        target:
          entity_id: switch.raffstore_og_sued_runter
      - delay:
          milliseconds: 1200   # Anlauf-Impuls
      - delay:
          seconds: 30          # Volle Fahrzeit
      - service: switch.turn_off
        target:
          entity_id: switch.raffstore_og_sued_runter

  raffstore_og_sued_lamellen:
    alias: "OG Süd – Lamellen verstellen"
    sequence:
      - service: switch.turn_on
        target:
          entity_id: switch.raffstore_og_sued_runter
      - delay:
          milliseconds: 150    # Kurzer Impuls für Lamellen
      - service: switch.turn_off
        target:
          entity_id: switch.raffstore_og_sued_runter

Stop-Funktion mit input_boolean

Um einen intelligenten Stopp-Taster zu realisieren, wird der Fahrstatus mit einem input_boolean verfolgt. Das Script prüft dann: Fährt der Raffstore gerade → kurzer Stopp-Impuls (0,1 s). Steht er → normale Fahrt starten.

input_boolean:
  raffstore_og_sued_faehrt:
    name: "OG Süd – fährt gerade"
    initial: false

Fast-Poll während der Fahrt

Der reguläre scan_interval: 5 genügt im Ruhezustand, wirkt während einer aktiven Fahrt aber träge. Eine kleine Automation setzt den Scan-Intervall der Positions-Sensoren beim Start eines Fahr-Scripts kurzzeitig auf 1 Sekunde herunter und danach wieder zurück – so bleibt die Positionsanzeige während der Bewegung nah an Echtzeit, ohne die SPS im Ruhezustand unnötig mit Anfragen zu belasten.

Verzeichnisstruktur

packages/
├── raffstore_gesamt.yaml          # Modbus-Verbindung + alle Sensoren
├── raffstore_og_sued.yaml         # OG Zimmer Süd: input_boolean + scripts
├── raffstore_og_bad.yaml          # OG Bad
├── raffstore_ug_wohnzimmer.yaml   # UG Wohnzimmer
└── ...

Packages in configuration.yaml einbinden

homeassistant:
  packages: !include_dir_named packages/