Porte de garage en mode Barrier Operator

J’ai eu à plusieurs reprises des questions suite à mon article Domotiser sa porte de garage avec Jeedom pour l’utilisation avec la classe de commande « Barrier Operator » qui est disponible depuis les versions mai 2017 du plugin openzwave.

Je vais dans un premier temps rapidement expliquer ce qu’est la classe de commande « Barrier Operator », puis son utilisation dans jeedom pour le contrôleur de porte de garage Aeotec Garage Door Controller Gen5 (ZW062).

Classe de commande Barrier Operator

La classe de commande  « Barrier Operator » est utilisée pour contrôler et interroger l’état des barrières ou portes de garages motorisées. L’équipement peut ignorer une commande « Barrier Operator » si l’opération demandée viole les limitations opérationnelles ou les règles de sécurité.

Je vous reviens plus tard, sur la citation l’équipement peut ignorer une commande.

Important: la classe de commande « Barrier Operator » doit être utilisée en mode de communication sécurisée.

Si vous avez inclu votre module en mode normal il serait donc préférable de l’exclure pour l’inclure mais cette fois en mode sécurisé.

Si vous avez bien effectué une inclusion en mode sécurisé, mais que vous avez toutefois le cadenas ouvert, c’est un simplement problème d’actualisation de l’information. Pour corriger, aller onglet Actions et cliquer sur Rafraîchir Infos du nœud.

Si suite à l’inclusion sécurisé vous n’avez même pas le cadenas, il peut y avoir deux raisons: l’inclusion ne c’est pas effectuée en sécurisée, mais la plus fréquente est que le moteur Z-Wave n’a simplement pas remonté cette information lord de l’interview du module. Vous pouvez alors simplement lancer la Régénération de la détection du nœud et voir une fois le réseau redémarré et l’interview terminé que le cadenas est bien apparue et en position fermé.

Utilisation dans jeedom

Avec le plugin à jour, version mai 2017 et supérieur, vous bénéficiez du support de la classe de commande « Barrier Operator ».

Pour les inclusions effectuées depuis la mise à jour du mois de mai 2017 le mode de notification de rapport est par défaut en « Barrier Operator », vous n’avez rien à faire.

En mode « Barrier Operator » on a cette fois 2 commandes actions et une pour la position de la porte.

Les actions et informations sont sur la classe de commande « Barrier Operator » n° 102 dans le mapping de commande.

Un widget officiel jeedom « garageBarrierOperator » est aussi disponible, vous n’avez donc plus besoin de récupérer le mien du market, il était destiné à l’utilisation en mode Basic.

On passe donc de, une commande à deux commandes pour gérer l’ouverture fermeture de sa porte de garage, mais pour en faire quoi de plus?

En « Barrier Operator » on lance une demande de changement de position afin d’initier un changement de l’état actuel de la barrière / porte de garage.

Un changement de position est initié seulement si la position désirée est différente de la position actuelle. C’est-à-dire que si on lance une demande d’ouverture et que la porte est déjà ouverte rien ne se produira. Dans le même sens si la porte est déjà en position fermée et qu’on initie la fermeture la porte ne bougera pas. 

Voici les possibles transitions selon les positions de la porte.

C’est très intéressant en comparaison au mode de fonctionnement précédent en CC Basic où l’on inverse systématiquement la position actuelle sur le lancement de l’action « Open/Close » quel que soit la position actuelle.

Spécificités 

L’appareil PEUT ignorer la commande « Barrier Set » si l’opération demandée enfreint les limites opérationnelles ou les règles de sécurité.

Comme nous l’avons vu, le contrôleur de porte de garage Aeotec n’initiera pas de changement de position si la position actuelle est la position souhaitée, on doit dire qu’en final ce n’est que normal.

Il y a encore une autre subtilité, nous l’avons vue l’ouverture fermeture de porte de garage ou de barrière sans surveillance requiert bons nombres de dispositifs de sécurité.  Si lors de la fermeture la porte s’arrête à cause d’un obstacle ou autre, le contrôleur ZW062 notifie une position Stop afin d’informer que la porte n’a pas terminé sa course. Dans ce cas, seule la commande d’ouverture sera possible. L’idée est de ne pas essayer d’écraser l’objet qui bloque la fermeture de la porte, mais bien de le dégager en ouvrant complètement la porte. 

Utilisation avec plugin Mobile et Homebridge

Homebridge

Le plugin Homebridge supporte déjà les 2 types génériques de commande ainsi que l’information de la position actuelle de la porte.

Il faudra donc s’assurer que la commande:

• Ouvrir/Stop est liée avec Portail ou garage bouton d’ouverture
• Fermer est liée avec Portail ou garage bouton de fermeture

Si vous avez Portail ou garage bouton toggle il faudra adapter pour un bon fonctionnement.

Il n’y a pas de différence lors de l’utilisation avec Siri ou dans l’application Home

Mobile

Le support pour le plugin Mobile arrive prochainement, les 2 types génériques requis arrivent dans la prochaine version de jeedom et seront supporté dans l’application Mobile. Il faudra donc une mise à jour jeedom et de l’application Mobile pour en profiter pleinement.

Voici la configuration des types génériques du plugin mobile pour l’équipement. (Je suis dans la version beta)

Tout comme la configuration de Homebridge, Il faudra donc s’assurer que les commandes soient associées aux bons types génériques:

• Ouvrir/Stop est liée avec Portail ou garage bouton d’ouverture
• Fermer est liée avec Portail ou garage bouton de fermeture

Note : si vous n’avez pas les 2 nouveaux types génériques c’est normal avec une version de jeedom en 3.1.7 ou inférieur. Il faudra attendre la mise à jour.

Je participerai à la phase de test avec l’équipe de développent du plugin Mobile et de l’application Mobile dès que son implémentation sera disponible.

Passer de Basic à Barrier Operator

Si vous avez inclu votre module avant mai 2017, vous l’utilisez normalement via la Classe de Commande Basic. Aeotec avait permis une utilisation plutôt complète du contrôleur de porte de garage en mode CC Basic avec les 5 positions possibles de la porte de garage. C’est d’ailleurs requis pour obtenir l’accréditation de chez Sigma si on expose la classe de commande Barrier Operator.

En mode Basic l’ouverture, la fermeture ou l’arrêt de la porte de garage s’effectuait via une seule commande action. 

Et la position remontait en Classe n° 32 la classe de commande Basic.

Si vous souhaitez basculer en mode Barrier Operator, le plus simple reste de passer par l’exclusion et inclure en nouveau, comme il doit être inclu en mode sécurisé. De cette façon les commandes seront automatiquement créées avec leur bons mapping et widget.

Il n’est bien entendu pas nécessaire / obligatoire de passer en mode Barrier Operator si vous êtes pleinement satisfait de son utilisation en mode Basic.

Conclusion

Voilà c’est déjà terminé, je vous ai exposé ici le nouveau (plus si nouveau) mode de fonctionnement du contrôleur de porte de garage ZW062 d’Aeotec via la classe de commande « Barrier Operator ».

S’il reste des interrogations n’hésitez pas à me les remonter, les commentaires sont aussi là pour ça, j’adapterai au besoin l’article.