SOMFY RTS CUL

This software package provides a homeasstant integration to connect a CUL wireless transceiver to control SOMFY shades.

Further information about the CUL: Product page, firmware details.

Installation

SOMFY RTS CUL Integration can be installed via HACS, or by manually copying the somfy_cul directory to Home Assistant's config/custom_components/ directory.

Configuration

CUL

Create the CUL hub by adding the following to your configuration.yaml.

somfy_cul:
  cul_path: /dev/ttyAMA0
  baud_rate: 38400

Covers / Shades

Add the following to your configuration.yaml. If you have multiplt covers, you need to add multiple items.

cover:
  - platform: somfy_cul
    name: "Bad"
    address: "ABCD"
    up_time: 16
    down_time: 13

Once created, the integration will create a file name somfy_cover_state.yaml in your config directory. In this file you can manipulate the enc_keys and the rolling_codes of the covers.

Services

The integration registers several services to directly control or manage your SOMFY RTS covers.

Service	Description	Example
somfy_cul.prog_cover	Put a cover into programming mode (needed to pair or re-pair a remote/cover).	yaml\nservice: somfy_cul.prog_cover\ndata:\n entity_id: cover.somfy_cul_abcd\n
somfy_cul.open_cover	Open the specified cover.	yaml\nservice: somfy_cul.open_cover\ndata:\n entity_id: cover.somfy_cul_abcd\n
somfy_cul.close_cover	Close the specified cover.	yaml\nservice: somfy_cul.close_cover\ndata:\n entity_id: cover.somfy_cul_abcd\n
somfy_cul.stop_cover	Stop the cover’s movement immediately.	yaml\nservice: somfy_cul.stop_cover\ndata:\n entity_id: cover.somfy_cul_abcd\n
somfy_cul.reload_state	Reload the somfy_cover_state.yaml file from disk. Useful if you manually edited encryption keys or rolling codes.	yaml\nservice: somfy_cul.reload_state\ndata:\n entity_id: cover.somfy_cul_abcd\n

All services require at least the entity_id of the target cover.

Contributing To The Project

There are several ways of contributing to this project, they include:

• Updating or improving the features
• Updating or improving the documentation
• Helping answer/fix any issues raised

Licence

This project uses the MIT Licence, for more details see the licence document.

Showing Your Appreciation

If you like this project, please give it a star on GitHub or consider becoming a Sponsor.