Verification Request: homebridge-somfy-rts-shutters

Plugin Name

homebridge-somfy-rts-shutters

Link To GitHub Repo

https://github.com/Barichon21/homebridge-somfy-rts-shutters

Plugin Icon (Optional)

No response

The plugin does not offer the same nor less functionality than that of any existing verified plugin.

🟢 Yes

The plugin successfully installs and does not start unless it is configured.

🟢 Yes

The plugin does not require the user to run Homebridge in a TTY or with non-standard startup parameters, even for initial configuration.

🟢 Yes

The plugin does not contain any analytics or calls that enable you to track the user.

🟢 Yes

If the plugin needs to write files to disk (cache, keys, etc.), it stores them inside the Homebridge storage directory.

🟢 Yes

The plugin does not throw unhandled exceptions, the plugin must catch and log its own errors.

🟢 Yes

More Information

homebridge-somfy-rts-shutters exposes Somfy RTS shutters/awnings as native HomeKit
WindowCovering accessories (0–100 % slider) through an RFXCOM USB transceiver.

Since RTS motors have no position feedback, the plugin simulates absolute positioning:
timed motor runs against per-shutter calibrated open/close durations, automatic stop
for intermediate positions, position persisted across restarts, interrupted/reversed
moves handled, optional HoldPosition (stop) characteristic.

How it differs from the verified homebridge-somfy-rfxcom: that plugin exposes each
device as three Switch accessories (Up/Down/Stop) with no position model, and requires
RFXmngr (Windows) for pairing. Mine offers a single native WindowCovering with percentage
positioning, and ships cross-platform pairing/calibration helpers (scripts/pair.js,
scripts/jog.js) — no Windows needed. Several Somfy plugins with different approaches
already coexist in the verified list (TaHoma, Inteo, hotwired, somfy-rfxcom).

Tested end-to-end against a real RFX-433EMC (2025 series, ESP32, firmware 4050) running
as a child bridge on Homebridge 2.1 / Node 24 / macOS. Robustness: missing config,
missing serial port or invalid deviceId never crash the bridge (guarded and covered by
a mock-based test bench). Full motor calibration on the physical awnings is scheduled
for the coming weeks and will ship as v1.0.0.

Review the linked homebridge-somfy-rts-shutters repository against the verification checklist in this issue. Inspect scripts/pair.js, scripts/jog.js, and the mock-based test bench first, then confirm the documented installation, configuration, error handling, and distinction from homebridge-somfy-rfxcom. Done means the plugin satisfies the checklist and its stated functionality is ready for verification.