Elero USB-Sender

Adapter zur Steuerung von Elero-Geräten.

Aktueller Release
1.0.5
Entwickler
Marc
Lizenz
MIT

Logo

elero-usb-transmitter-Adapter für ioBroker

Adapter zur Steuerung von Elero-Geräten mit dem Elero USB-Transmitter-Stick. Sie benötigen den USB-Transmitter-Stick und müssen die vorhandenen Rollladenmotoren daran anschließen. Der Adapter erkennt automatisch die aktiven Kanäle und fügt die Geräte hinzu. In den Einstellungen können Sie die Gerätenamen und das Aktualisierungsintervall festlegen.

Konfiguration

  1. USB-Stick-Gerätepfad : Pfad zu Ihrem USB-Transmitter-Stick (z. B./dev/ttyUSB0 oderCOM3 ).
  2. Aktualisierungsintervall : Zeit in Minuten, um den Gerätestatus zu aktualisieren.
  3. Gerätekonfigurationen : In den Adaptereinstellungen können Sie Kanalnummern benutzerdefinierten Namen zuordnen.

Verwendung

Der Adapter erstellt für jeden aktiven Kanal des Sticks ein Gerät. Jedes Gerät enthält die folgenden Zustände:

ZustandRolleBeschreibung
channelTextDie Kanalnummer des Geräts.
infoTextAktuelle Statusinformationen, die vom Stick zurückgegeben werden.
openschaltenHauptsteuerung. Einstellen auftrue zum ÖFFNEN,false zum SCHLIESSEN (ABSCHLIESSEN).
controlCommandZustandSende spezifische Befehle direkt.

Steuerbefehle

Sie können die folgenden Werte in diecontrolCommand Zustand:

  • 16 : STOPPEN
  • 32 : HOCH
  • 36 Belüftung/Neigung
  • 64 : RUNTER
  • 68 Zwischenposition

Einfache Befehle

  • 74 : EASY_CHECK
  • 75 : EASY_CONFIRM
  • 76 : EASY_SEND
  • 77 : EASY_ACK
  • 78 : EASY_INFO

Statuswerte

Derinfo Der Status zeigt den aktuellen Status des Geräts an. Gängige Werte sind:

WertBeschreibung
INFO_UNKNOWNUnbekannter Status (-1).
INFO_NO_INFORMATIONKeine Informationen verfügbar (0).
INFO_TOP_POSITION_STOPAuf dem ersten Platz (1) gestoppt.
INFO_BOTTOM_POSITION_STOPAn der unteren Position (2) angehalten.
INFO_INTERMEDIATE_POSITION_STOPAn der Zwischenposition (3) angehalten.
INFO_TILT_VENTILATION_POS_STOPAngehalten in der Kipp-/Belüftungsposition (4).
INFO_BLOCKINGBlockierung erkannt (5).
INFO_OVERHEATEDMotor obenliegend (6).
INFO_TIMEOUTZeitüberschreitung (7).
INFO_START_TO_MOVE_UPBeginnt nach oben (8).
INFO_START_TO_MOVE_DOWNBeginnt, sich nach unten zu bewegen (9).
INFO_MOVING_UPAufstieg (10).
INFO_MOVING_DOWNAbwärtsbewegung (11).
INFO_STOPPED_IN_UNDEFINED_POSITIONAn einer undefinierten Position angehalten (13).
INFO_TOP_POS_STOP_WICH_TILT_POSAnschlag in oberer Position mit Neigungsposition (14).
INFO_BOTTOM_POS_STOP_WICH_INT_POSUntere Position mit Zwischenstellung (15).
INFO_SWITCHING_DEVICE_SWITCHED_OFFGerät ausschalten (16).
INFO_SWITCHING_DEVICE_SWITCHED_ONGerät einschalten (17).

Beispiele

JavaScript / Blockly

Zum Öffnen eines Rollladens (Kanal 1):

setState('elero-usb-transmitter.0.channel_1.open', true); // Moves UP

Um einen sich bewegenden Verschluss anzuhalten:

setState('elero-usb-transmitter.0.channel_1.controlCommand', 16); // STOP command

Changelog

1.0.7 (2026-07-25)

  • (ioBroker-Bot) Adapter requires js-controller >= 6.0.11 now.

1.0.6 (2026-05-24)

  • Serialize USB access (runExclusive) for getInfo and control commands
  • Retry control commands and reconnect the stick on failure; update info.connection
  • Adjust burst polling after commands (10s interval, 6 runs)
  • Update dependencies

origin/main

1.0.5 (2025-12-31)

  • Fixed reliability issue with fast polling (burst mode)

1.0.4 (2025-12-30)

  • Adjusted release configuration
  • Implemented fast polling after command execution

1.0.3 (2025-12-30)

  • Release script configuration improved (added missing plugins)
  • Bug fix: Status update handling (async + validation)
  • Improvement: Connection retry logic implemented
  • Improvement: All tests converted to TypeScript

Older changelogs can be found there## License

MIT License

Copyright (c) 2025-2026 marc marc@lammers.dev

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.