Home
Documentation des services, entités, attributs et événements exposés par l'intégration dans Home Assistant
Cette documentation décrit l'intégration telle qu'elle accompagne le firmware ESPSomfy-RTS.
Le domaine de l'intégration est espsomfy_rts_enhanced. Tous les services décrits ici
s'appellent donc sous la forme espsomfy_rts_enhanced.<service>.
Les services standard de Home Assistant (cover.open_cover, cover.set_cover_position,
cover.stop_cover…) fonctionnent également sur toutes les entités cover de
l'intégration. Les services propres documentés ici n'existent que pour ce que le
protocole RTS sait faire et que le domaine cover ne couvre pas.
| Page | Contenu |
|---|---|
| Entités exposées | ce que l'intégration crée dans Home Assistant : équipements, groupes, capteurs, boutons |
| Diagnostics | les 12 capteurs de l'appareil : réseau, Wi-Fi, Ethernet, mémoire — contenu, cadence, alertes |
| Attributs en template | lire une position, la position MY, la dernière commande — et la convention de position qui s'inverse |
| Événements | le bus espsomfy-rts_event, sa charge utile, et comment réagir à une télécommande physique |
| Page | Contenu |
|---|---|
| Services | les 15 services : mouvement, inclinaison, recalage, capteurs soleil et vent, commandes brutes RTS, appareil |
| Recettes d'automatisation | 10 automatisations complètes, commentées |
| Pièges et limites | ce que le protocole RTS ne permet pas, et ce qu'il faut anticiper |
| Service | Cible | Paramètres |
|---|---|---|
open_shade |
cover |
— |
close_shade |
cover |
— |
stop_shade |
cover |
— |
set_shade_position |
cover |
position |
tilt_open |
cover |
— |
tilt_close |
cover |
— |
set_tilt_position |
cover |
tilt_position |
set_current_position |
cover |
position |
set_current_tilt_position |
cover |
tilt_position |
set_sunny |
cover |
sunny |
set_windy |
cover |
windy |
send_command |
cover |
command, repeat
|
send_step_command |
cover |
direction, step_size, repeat
|
reboot |
button |
— |
backup |
button |
— |
| Ce que vous cherchez | Template |
|---|---|
| position actuelle | {{ state_attr('cover.salon', 'current_position') }} |
| position favorite MY | {{ state_attr('cover.salon', 'my_pos') }} |
| inclinaison actuelle | {{ state_attr('cover.veranda', 'current_tilt_position') }} |
| dernière commande reçue | {{ state_attr('cover.salon', 'last_cmd') }} |
| origine de cette commande | {{ state_attr('cover.salon', 'cmd_source') }} |
| état (ouvert, fermé, en mouvement) | {{ states('cover.salon') }} |
| adresse IP de l'appareil | {{ states('sensor.<appareil>_adresse_ip') }} |
| canal Wi-Fi | {{ states('sensor.<appareil>_canal_wi_fi') }} |
| mémoire libre | {{ states('sensor.<appareil>_memoire_libre') }} |
Les valeurs de diagnostic sont des entités à part entière, pas des attributs : elles
se lisent avec states(). Leurs identifiants dépendent du nom donné à l'appareil — voir
Diagnostics.
Attention : my_pos et target sont livrés dans la convention ESPSomfy-RTS, l'inverse de
current_position. Voir Attributs en template.