Script

 

Les modules De Domotic's

Le framework domotics est une librairie de fonctions vbscripts dont on a besoin pour personnaliser son environnement de domotique. Ces centaines de lignes de code sont le fruit de plusieurs années de programmation avec Homeseer. Grâce à elles, vous pouvez écrire rapidement vos scripts, puisque les fonctions les plus couramment utilisées sont dans le framework ...

Malheureusement, fabriquer sa librairie de scripts ne résoud pas tous les problèmes de maintenance de votre environnement de domotique !

Au cours de ces années, j'ai constaté les difficultés suivantes :

Voilà donc pourquoi je développe maintenant sous forme de modules.

J'ai commencé à mettre quelques-uns de mes modules en téléchargement sur le forum. Le forum est bien pratique car il permet aussi de tracer vos différentes propositions d'évolutions ...

N'hésitez pas à me faire des remarques, je ferais évoluer mes scripts.

Un module dans le detail ...

Un module est toujours stocké dans l'arborescence Homeseer\scripts\modules\exempledemodule.

Il comporte les sous répertoires suivants :

  • config : ce répertoire est obligatoire, il décrit les devices et les events liés à ce module,
  • log : ce répertoire est facultatif, il contient les fichiers de log du module,
  • doc : ce répertoire est facultatif, il contient les docs du modules,
  • scripts : ce répertoire est obligatoire, il contient les scripts du module,
  • tmp : ce répertoire est facultatif, il est souvent présent quand le module a besoin d'écrire un fichier de travail en local (exemple la météo, etc)

Le répertoire config contient les devices (fichiers dev_*.ini) et les évènements (evt_*.ini) à créer pour le module. Un fichier principal properties.ini liste les fichiers devices et les fichiers évènements à prendre en compte. Parfois, le fichier properties.ini contient aussi des paramètres globaux au module (TIMEOUT, URL, etc).

Le répertoire scripts contient généralement trois fichiers :

  • install.vbs : c'est le script qui est appelé au démarrage de Homeseer, on peut se servir de ce script pour créer devices et évènements,
  • local-parameters.inc : c'est un bout de script qui initialise les variables globales du module,
  • lescriptdumodule.vbs : c'est le script principal qui est lancé par vos évènements.

Pour lancer ou installer un module, c'est très facile. Il faut éditer le fichier Homeseer\scripts\startup.txt.Et ajouter une ligne :

hs.run "modules\RUN.ALARM\scripts\install.vbs"

En conclusion

Personnellement, je gagne beaucoup de temps depuis que j'ai des modules. Le plus surprenant, c'est que chaque nouveau module est plus facile à écrire que le précédent !

  • Je regarde le script qui se rapproche le plus de celui que je veux créer
  • Je duplique le répertoire, et je le renomme
  • J'éditer les fichiers de config pour y mettre les nouveaux devices/évènements
  • Je rajoute une ligne hs.run dans le fichier startup.txt de Homeseer
  • J'édite et je mets à jour les les fichiers install.vbs et local-parameters.inc
  • Puis je modifie le fichier lescriptdumodule.vbs en fonction des besoins de mon module.

N'hésitez pas, envoyer moi vos remarques ... et pourquoi pas, créez vos propres modules !

© 2006 - Domotic's