Skip to content

Services

xkain edited this page May 27, 2026 · 1 revision

⚙️ Integration Services

ESPSomfy RTS entities expose several custom services. You can use these services directly in your Home Assistant automations, scripts, or developer tools for advanced control.


🪟 Standard Shade Controls

Service Description
espsomfy_rts.open_shade Opens the shade completely.
espsomfy_rts.close_shade Closes the shade completely.
espsomfy_rts.stop_shade Stops the shade if it is moving. If the shade is already stopped, moves it to the "My" (favorite) position.
espsomfy_rts.set_shade_position Moves the shade lift to a specific percentage.

📄 YAML Example (Set Position)

service: espsomfy_rts.set_shade_position target: entity_id: cover.living_room_shade data: position: 45


📐 Tilt Controls

Service Description
espsomfy_rts.tilt_open Opens the tilt/slats completely.
espsomfy_rts.tilt_close Closes the tilt/slats completely.
espsomfy_rts.set_tilt_position Sets the target tilt position to a specific percentage.

🛠️ Calibration Services (Virtual Adjustment)

Warning

These services change the state inside Home Assistant/ESPSomfy without moving the physical motor. Use them only for manual synchronization or advanced calibration scripts.

Service Description
espsomfy_rts.set_current_position Manually overrides the current lift position percentage.
espsomfy_rts.set_current_tilt_position Manually overrides the current tilt position percentage.

☀️ Weather & Automation Overrides

These services allow you to interface external Home Assistant weather sensors (like a local weather station or anemometer) with your Somfy motors.

1. Sun Sensor (set_sunny)

Tells a motor with a sun sensor that it is currently sunny.

  • True: Extends the awning/shade if the sun flag is enabled.
  • False: Retracts the awning/shade when the sunny condition subsides.

service: espsomfy_rts.set_sunny target: entity_id: cover.terrace_awning data: sunny: true

2. Wind Sensor (set_windy)

Important

Safety Feature: Triggers a dangerous wind position override to immediately retract/open your awning to protect it from high winds.

  • Behavior: After the wind condition is cleared (windy: false), the system suspends manual movement for 30 seconds and prevents automatic sun extensions for 12 minutes to ensure stability.

service: espsomfy_rts.set_windy target: entity_id: cover.terrace_awning data: windy: true

Clone this wiki locally