Ici je vais explorer un nouvel objet qui paraissait simple à exploiter mais s'est avéré un peu compliqué. J'ai acheté une télécommande d'alarme Heiman HS1RC en me disant que l'intégration allait être simple. Sauf que, comme ce clavier, sous ZHA cette télécommande n'est pas vue comme une classique télécommande mais comme un panneau de contrôle d'alarme. A noter que l'on retrouve le même comportement sur la télécommande Woox ou Linkind.
Pourquoi pas, il doit y avoir une raison à ce choix (probablement le bouton du bas qui passe en mode "triggered" quelque soit l'état). Sauf que pour gérer les clavier on configure un code dans ZHA, code que va attendre cette télécommande pour se désarmer. Dans ZHA on peu se passer de code pour armer, mais pas pour désarmer. Et comme le bouton désarmer de la télécommande n'envoie pas ce code elle ne désarme pas. De fait on ne peut pas se servir de sont état "disarmed" pour désarmer Alarmo...
Il va donc falloir passer par une petite automation intermédiaire afin de lui faire manger ce code et ensuite avoir un comportement normal de ce panneau d'alarme pour le désarmement... enfin je pensais que ça suffirait....
- id: '2bd0ertyyf-43fa-45f98f-aed0-heiman-001'
alias: "Alarm @ Heiman RC Home"
description: 'Disarm RC Control Panel to use events'
mode: single
trigger:
- platform: event
event_type: zha_event
event_data:
device_ieee: 5c:02:72:ff:fe:e9:2f:ff
command: 'arm'
args:
arm_mode: 0
arm_mode_description: 'Disarm'
code: ''
zone_id: 255
id: "rc_1"
condition: []
action:
- service: alarm_control_panel.alarm_disarm
data:
code: !secret alarm_code_zha
target:
entity_id: alarm_control_panel.heiman_rc_ef_3_0_alarmcontrolpanel
- delay : '00:00:05'
A noter qu'il y a une particularité, quand on appuie sur un des 3 boutons du haut ça envoie 3 event's identiques. Bug ou sécurité supplémentaires liée à l'usage original de cette télécommande ? Je n'ai pas trouvé d'explications vraiment acceptables, certains disent qu'il s'agit d'event's transmis par des équipements relais, d'autres non.... Et le seul contournement que j'ai trouvée pour l'instant consiste à passer mon automation en mode single et d'ajouter un petit delay à la fin afin de ne pas exécuter cette automation trois fois de suite...
A noter que si on utilise plusieurs télécommandes (celle ci ou celle de chez Woox, ou un clavier), il conviendra de tout désarmer toutes les autres unités qui auraient pu êtres utilisées pour l'armement.
Bon, c'est une solution, mais on ne peut pas dire que ce soit très propre...
A noter que ces mêmes télécommandes sous Z2M transmettent des informations exploitables...
> arm_day_zones
> arm_all_zones
> disarm
> emergency
Alternative
En attendant que les développeurs prennent en compte nos demandes, j'ai peut être trouvé une alternative un peu moins sale. J'utilise ControllerX sous AppDaemon pour gérer toutes mes télécommandes et il se trouve qu'il sait traiter les Events sous forme de template. Je peux donc facilement remplacer mon automation par ce code :
remote_alarm:
module: controllerx
class: Controller
controller:
- "a4:c1:48:96:0c:cf:c9:68:1:0x0501" # Woox RC
- "58:8e:81:zz:fe:26:12:64:1:0x0501" # Linkind RC
- "5c:02:72:xx:fe:e9:2f:9a:1:0x0501" # Heiman RC
- "68:0a:e2:af:fe:ea:89:22:1:0x0501" # Linkind Keypad
light: light.my_fake_light
integration:
name: event
event_type: zha_event
controller_key: unique_id
action_template: "{command}_{args[arm_mode]}_{args[arm_mode_description]}_{args[code]}#" # Ici il n' a pas de code reçu
mapping:
arm_0_Disarm_#: # Ici il n' a pas de code reçu
- service: input_button.press
target:
entity_id: input_button.disarm_alarm
- service: alarm_control_panel.alarm_disarm
data:
code: !secret alarm_code_zha
entity_id:
- alarm_control_panel.lk_zb_keypad
- alarm_control_panel.lk_zb_remote
- alarm_control_panel.heiman_remote
- alarm_control_panel.woox_01
arm_0_Disarm_1234#: # Ici on a le code du clavier défini dans ZHA
- service: input_button.press
target:
entity_id: input_button.disarm_alarm
- service: alarm_control_panel.alarm_disarm
data:
code: !secret alarm_code_zha
entity_id:
- alarm_control_panel.lk_zb_remote
- alarm_control_panel.heiman_remote
- alarm_control_panel.woox_01
arm_0_Disarm_314#: # Ici on peut traiter n'importe quel code reçu par le clavier et générer une action...
- service: notify.slack_hass_canaletto
data:
message: "{{now().strftime('%d/%m/%Y, %H:%M:%S')}} > Keyboard 314"
Ici je désarme en plus le sirènes (une sous Z2M qui ne l'expose pas en tant que sirène et les autres en ZHA. Ensuite je notifie Slack qui me sert de log et me permettra de savoir quelle télécommande à désarmé le système. En ce qui concerne le clavier il est également possible d'utiliser plusieurs codes pour désarmer, les traiter via les events et ainsi savoir quel code (confié à une seule personne) à désarmé le système...
- service: mqtt.publish
data:
topic: zigbee2mqtt/Sirène SMaBiT/set
payload: >-
{"warning": {"mode": "stop"}}
- service: siren.turn_off
target:
entity_id:
- siren.heiman_sirene_1
- siren.heiman_sirene_2
- siren.sirene_terrasse
- delay : '00:00:08'
- service: notify.slack_hass_canaletto
data:
message: "{{now().strftime('%d/%m/%Y, %H:%M:%S')}} > Disarm all remotes by : {{ trigger.id }}"
Exploitation
Armement de l'alarme
Dans l'automation qui sert à armer on va utiliser l'état de l'entité Alarm Control Panel de la télécommande avec un ID afin de dérouler la séquence souhaitée et tout ce qui s'en suit (on peu imaginer faire de choses différentes selon le bouton sur lequel on appuie) :
- platform: state
entity_id: alarm_control_panel.heiman_rc_ef_3_0_alarmcontrolpanel
to: "armed_home"
id: "rc_1_home"
A noter que l'on peut également au besoin utiliser to : "triggered" afin de déclencher une autre action immédiate. Genre je me fait agresser quand j'ouvre la porte....
Désarmement de l'alarme
Paradoxalement c'est un peu plus compliqué. En effet si on a armé avec la télécommande et qu'elle se trouve en armed_home il n'y aura pas de soucis quand on va désarmer avec cette même télécommande car elle enverra un disarmed. Par contre si on veut désarmer avec une seconde télécommande ou un clavier qui n'aura pas servi à armer, celui-ci se trouvant déjà en disarmed il n'y aura pas de changement d'état et il ne se passera rien.
Donc dans l'automation qui sert à désarmer on ne va donc pas utiliser l'état de l'entité Alarm Control Panel des différents devices (télécommandes, claviers) mais un input_button: (à créer) :
- platform: state
entity_id: input_button.disarm_alarm
id: "button"
Et cet input_button: sera commandé par l'automation de départ (plus haut) que j'ai adaptée :
- Elle se déclenche à partir des event's des différents devices
- Elle change l'état de l'entité Alarm Control Panel des différents devices
- Elle envoie un
input_button.press qui va déclencher l'automation de désarmement.
Ainsi quand on désarme une télécommande on désarme les autres qui seront disponibles pour un futur armement. Et vu qu'on désarme avec un push button, on peu également envoyer depuis Lovelace ou toute autre automation.
Bref, voilà comment perdre un après midi... J'ai réédité cet article plusieurs fois et j'y reviendrait certainement.
Les commentaires de mon blog n'étant pas des plus pratiques, il est également possible d'échanger sur cet article ici, sur HACF.
EDIT du 27/07/2023
Toujours pour ces télécommandes sous ZHA j'ai depuis trouvé une autre solution en passant par un template: qui va changer l'état d'un binary_sensor:. L'idée est d'écouter un event et de basculer l'état du binary_sensor: quelque secondes. Bien sur la télécommande passe en mode triggered, mais on peut annuler facilement cet état dans l'automation de traitement ou on se sert de l'état du binary_sensor: pour désactiver :
template:
- trigger:
- platform: event
event_type: zha_event
event_data:
device_ieee: a4:c1:38:96:0b:cf:c9:61 # Woox RC1
command: 'arm'
args:
arm_mode: 0
arm_mode_description: 'Disarm'
code: ''
zone_id: 0
binary_sensor:
name: Woox RC1 to Disarmed
icon: "{{ (trigger.platform == 'event') | iif('mdi:remote-off', 'mdi:remote') }}"
state: "{{ trigger.platform == 'event' }}"
auto_off:
seconds: 5
Ensuite une automation sur trigger/state (j'en mets qu'un seul ici mais dans la pratique il y a toutes les télécommandes, claviers et RFID qui me servent à désactiver mes alarmes Alarmo et Visonic)
automation:
- id: '2bd0ertyyf-43fa-45f98f-aed0-disarm'
alias: "Alarm @ Remote Disarm"
description: 'Disarm Remote Control panel'
trigger:
- platform: state
entity_id: binary_sensor.woox_rc1_to_disarmed
to: "on"
id: "Woox RC 1"
Et dans les actions la première chose à faire est de désactiver le triggered de la télécommande. On peut conditionner avec un tigger.id ou le faire pour toutes :
action:
- choose: # DISARM
- conditions: "{{ trigger.id in ['Woox RC 1'] }}"
sequence:
- service: alarm_control_panel.alarm_disarm
data:
code: !secret alarm_code_zha
target:
entity_id:
- alarm_control_panel.woox_01 # Ici on désactive la télécommande
- alarm_control_panel.alarmo # Ici on désactive Alarmo
- alarm_control_panel.visonic # Ici on désactive Visonic
J'ai simplifié pour l'exemple car dans la pratique je désactive un faux alarm_control_panel: qui me sert à commander les deux alarmes et d'autres choses liées aux personnes, volets, etc...
- service: alarm_control_panel.alarm_disarm
data:
code: !secret alarm_code_zha
target:
entity_id:
- alarm_control_panel.home_alarm_command # Fake Alarm
L'idéal serait de pouvoir modifier le comportement de ces télécommandes avec un Quirk sous ZHA afin qu'elles se comportent comme sous Z2M. D'après mes recherches c'est faisable, mais je ne sais pas faire.
Depuis j'ai également testé les petits télécommandes Shelly en BLE avec un seul bouton multifonction, ça fait le job et c'est plus simple. Avantage on évite le temps de reconnexion au réseau.
J'ai passé beaucoup de temps (trop) à tester toutes les possibilités dans tous les sens avec l'objectif que cela fonctionne sur une base ZHA afin de le rendre facile duplicable. De fait j'ai pas mal de choses empilée et la prochaine étape consistera à simplifier au maximum et d'écrire un article plus clair...
Sources