Documentation of Home + Control by Legrand

This is a basic Python library that interacts with the Legrand Home + Control API. It is primarily intended for integration into Smart Home platforms such as Home Assistant.

More information of the API can be found here: https://developer.legrand.com/

The library currently supports 4 types of Legrand modules:

  1. Plugs (power outlets)

  2. Lights (connected switches)

  3. Remotes (wireless switches)

  4. Automations (shutters/covers)

The first two - plugs and lights - are modeled as basic switches that can be interacted with to set their status to on or off.

Remotes are presented as passive modules that only have a battery level attribute.

Automations can be issued commands to open or close to their full positions and to be stopped during the motion.

A ‘home’ is represented by a plant which presents all of its corresponding modules in a topology. A plant is basically a Legrand Home+ Control gateway.

The status of each module in the plant can be accessed through a single status call to the plant or through individual status calls to each module.

Indices and tables