Documentation eedomus

Introduction

Les périphériques Connectés Legrand® disposent d'une API web qui permet de les rendre interopérable avec eedomus.

La gamme est actuellement composées de prises pilotées, éclairages avec dimmer, actionneurs de volets.

Configuration

Pré-requis : Vous devez disposer de périphériques connectés Legrand® correctement configurés et pilotables via l'app Home+Control et d'une box eedomus opérationnelle.

Depuis le portail eedomus cliquez sur Configuration / Ajouter ou supprimer un périphérique / Ajouter un autre type de périphérique / Legrand® with Netatmo / Créér

Puis suivez les instructions afin de créer votre périphérique dans eedomus. Répétez l'opération si vous avez plusieurs périphériques à créer.

Aperçu d'une prise connectée Legrand® dans eedomus :

Remarque : l'API Legrand® n'étant pas accessible localement, il ne sera pas possible de l'utiliser en cas de coupure internet (dans cette situation l'app Home+Control de Legrand® ne permet a priori pas la commande non plus)

Remarque : les modules volets roulants semblent uniquement ouverts en mode ouvert/fermé. Les ouvertures partielles ou l'arrêt ne semblent pas pris en compte par l'API Legrand.

Remarque : En cas de perte de connexion, essayez le bouton "Tester" dans la configuration du périphérique sous eedomus, dans les paramètres experts. Si vous voyez vous pouvez lier à nouveau votre compte depuis https://secure.eedomus.com/sdk/plugins/legrand_netatmo..., il s'agit de l'authentification qui n'est plus valable. Suivez le lien !

Remarque sur la liaison avec l'API : Le fonctionnement OAuth2 avec l'API Legrand est assez exigeant puisque le jeton de sécurité doit être renouvelé toutes les 3 heures pour permettre le pilotage. Si une erreur intervient dans un renouvellement (qui peut être à plus de 3 heures en cas de période de non fonctionnement), il faut une nouvelle validation manuelle par l'utilisateur. Il suffit d'une erreur sur les 3000 renouvellements annuels pour devoir refaire ce renouvellement dans l'année.

Remarque sur la fréquence de mise à jour: La fréquence des requêtes vers l'API est limitée par les conditions de Legrand Netatmo. Laisser une fréquence de 5 min au plus dans la mesure du possible.

Migration de l'API Legrand de Mai 2022

Legrand/Netatmo a revu son API au mois de Mai 2022, les périphériques eedomus créés avant cette date doivent être "Liés à nouveau" afin de fonctionner après cette migration. Pour cela, rendez-vous dans la configuration de votre périphérique Legrand/Netatmo sur le portail eedomus, et cliquez sur le lien situé dans "Paramètres experts"

En cas de difficulté, il reste possible de supprimer et de recréer ses périphériques Legrand/Netatmo dans eedomus.