Domotique et Norme X10

Introduction

Le X10 est un protocole de communication par courant porteur qui permet de faire dialoguer ensemble des équipements compatibles. Je ne réinventerai pas la roue, de très bonnes documentations existent sur le sujet, notamment celle-ci Domotique et Norme X10.

Pour résumer très rapidement, il permet, avec la mise en place d'émetteurs et de récepteurs, d'automatiser des tâches de la vie quotidienne au sein de son logement (ex.: ouvrir les volets, fermer la veilleuse du petit dernier...)

Présentation

But recherché

Le but de cet article est d'expliquer comment pouvoir commander à partir de Linux les récepteurs et de programmer l'émetteur PC vers X10 (CM11) grâce à des macros. Il existe sous Linux quelques projects qui permettent de mettre en place une 'maison domotique', le plus complet est MisterHouse. C'est une application complexe à mettre en oeuvre et que l'on peut plus apparenter à un logiciel pour HTPC. J'ai choisi pour ma part d'utiliser Heyu. C'est un logiciel simple à mettre en place et à configurer et dont je vous propose de vous en expliquer l'utilisation.

Prérequis

Le matériel minimum à acquérir pour tester son utilisation est :

• un pc équipé d'un port série
• un émetteur CM11
• un récepteur type AM12F

A noter, il existe 2 versions de CM11, l'une USB et l'autre série, j'ai choisi d'acheter cette dernière pour être sûr de son fonctionnement avec notre OS préféré.

Il existe aussi plusieurs versions des modules récepteurs. AM12F: "A" pour appareil, et "F" pour france donc LM12G: "L" pour module lampe qui permet de faire des variations, "G" pour german donc module allemand.

Heyu

Installation

Vérifier que vous disposez de la dernière version sur le site de l'auteur : $ wget http://heyu.tanj.com/download/heyu-2.0beta.6.2.tgz $ tar zxvf heyu-2.0beta.6.2.tgz $ cd heyu-2.0beta.6.2 $ ./Configure $ make $ su (pour devenir root) Password :

1. make install

mkdir -p -m 755 /usr/local/bin cp heyu /usr/local/bin chgrp root /usr/local/bin/heyu chmod 755 /usr/local/bin/heyu chown root /usr/local/bin/heyu ./install.sh

I did not find a Heyu configuration file. Where would you like the sample Heyu configuration file installed?

 1. In directory /home/dimitri/.heyu/
 2. In subdirectory .heyu/ under a different user home directory
 3. In directory /etc/heyu  (for system-wide access)
 4. No thanks, I'll take care of it myself

Choice [1, 2, 3, or 4] ? 3 Creating directory /etc/heyu with permissions rwxrwxrwx. Adjust ownership and permissions as required. The sample configuration file will be installed as /etc/heyu/x10.conf

I will add the TTY port for your CM11 to the config file Specify /dev/ttyS0, /dev/ttyS1, etc. To which port is the CM11 attached? /dev/ttyS0

Configuration

Comme nous avons pu le voir précédemment, les fichiers de configuration vont se trouver dans le répertoire choisi à l'étape d'installation, ici /etc/heyu. Le fichier de configuration principal est heyu.conf TTY /dev/ttyS0 HOUSECODE A LOG_DIR NONE SCRIPT_MODE SCRIPTS SCHEDULE_FILE x10.sched MODE COMPATIBLE PROGRAM_DAYS 366 COMBINE_EVENTS YES COMPRESS_MACROS NO

1. LONGITUDE W079:49 # [degrees:minutes East or West of Greenwich]
2. LATITUDE N36:04 # [degrees:minutes North or South of equator]

DAWN_OPTION FIRST DUSK_OPTION FIRST MIN_DAWN OFF MAX_DAWN OFF MIN_DUSK OFF MAX_DUSK OFF REPL_DELAYED_MACROS YES WRITE_CHECK_FILES YES

Le port ttyS0 doit pouvoir être utilisé par tous les utilisateurs afin de communiquer avec le CM11 : # /bin/chmod a+rw /dev/ttyS0

Petit test

Tout d'abord, chaque module est identifié par un code Maison (de A à P) et un code Unité (de 1 à 16). Cette identification va permettre de commander le récepteur de la façon suivante :
La commande $ /usr/local/bin/heyu on A1 permet d'allumer le récepteur A1. Et si tout va bien, l'équipement électrique connecté sur le module doit s'allumer. Vous me direz : "Ouais, il est gentil mais cela n'a pas beaucoup d'intérêt". Mais ce n'est que le début.

Cas concret

A présent que nous avons validé le bon fonctionnement entre Heyu et le CM11, passons à un cas concret. Disons que nous voulons que des volets électriques s'ouvrent à l'aube et se ferment au coucher du soleil. Pour cela il faut acquérir des modules SW10 que l'on branche en lieu et place des interrupteurs classiques montée/descente. Pour simplifier les choses, nous leur affecterons le même code Maison/Unité A2.

Un nouveau fichier permet de créer ce scénario /etc/heyu/x10.sched : timer smtwtfs 01/01-12/31 dusk 23:00 allumer null timer smtwtfs 01/01-12/31 dawn 00:00 eteindre null macro allumer 0 on a2 macro eteindre 0 off a2 smtwtfs correspond au jour de la semaine (Sunday, Monday...)

01/01 - 12/31 à la période d'exécution souhaitée

dusk au lever du soleil et dawn au coucher du soleil

Ces 2 dernières variables sont calculées en fonction des coordonnées géographiques (longitude/latitude) que l'on indique dans le fichier /etc/heyu/x10.conf.

Pour vérifier les heures calculées, utiliser la commande suivante : $/usr/local/bin/heyu utility suntable

Une fois le fichier complété, il faut l'envoyer à l'émetteur CM11, pour cela : $/usr/local/bin/heyu upload

Les directives du fichier x10.sched sont envoyées au CM11 qui exécutera l'ensemble des macros de façon autonome.

Pour finir

Les X10 et Heyu offrent de nombreuses possibilités dont je ne vous ai fait découvrir qu'une mince partie. N'hésitez pas à user et abuser des man heyu et autres fichiers sample disponibles avec ce logiciel.

Copyright

© 01/09/2006 D. Clatot