Objectifs
Ce module permet de vérifier périodiquement l'état de vos devices. Si vous souhaitez être informé lors du changement d'état d'un ou plusieurs de vos devices, ce module est celui qu'il vous faut. Vous pouvez vous en servir pour surveiller que votre frigo ne reste pas ouvert, que votre chauffage ne passe pas en surchauffe, ou que vos MS13 fonctionnent régulièrement. Lorsqu'une de ces règles est détectée, vous pouvez vous faire avertir par l'intérmédiaire de votre Nabaztag, par un email ou par un SMS.
Les différentes versions
Version 1.1 : Ce module gère maintenant les devices ACRF (DS10, Digimax, etc)
Version 1.0 : Première release
Pré-requis
Pour envoyer des SMS, vous devez installer Skype v3 (ou +), et vous devez acquérir un crédit Skype. Personnellement, j'ai pris 10 euros de crédit, à 0,11 centimes d'euros le SMS, ca fait presque une centaine de SMS ...
Devices et Events utilisés par le module
Il faut paramétrer un device par règle à surveiller. Par exemple : Y1 vous dira si le frigo est ouvert depuis plus de 5 minutes, Y2, vous dira si votre chauffage dépasse les 25°, etc.
Coté évènement, un seul est nécessaire. C'est un évènement qui se lance toutes les 5 minutes et qui vérifie vos règles. Cet évènement est créé par défaut, mais vous pouvez le changer pour qu'il passe plus ou moins souvent.
Comment installer le module ?
- Arrêtez votre application Homeseer
- Vérifiez que vous avez installez un framework domotics. Sinon faites le en suivant les instructions de cette page
- Vérifiez que vous avez un répertoire scripts\modules dans Homeseer. Sinon, créez le.
- Dézippez les fichiers dans le répertoire module. Vous devez avoir une structure du style C:\Program Files\Homeseer 2\scripts\modules\WATCH.DOG\scripts\*
- Ajoutez la ligne hs.run "modules\WATCH.DOG\scripts\install.vbs" dans votre fichier C:\Program Files\Homeseer 2\scripts\startup.txt.
- Editez les fichiers de properties (dev_*.ini et evt_*.ini) pour paramètrer le module en fonction de votre besoin : C:\Program Files\Homeseer 2\scripts\modules\WATCH.DOG\config\*
- Redémarrez Homeseer
Comment paramétrer le fichier Properties.ini ?
Le paramètre MODE=DATABASE permet de sauver les changements de status en base de données MYSQL (si votre framework est paramétré pour pointer sur une base de données). Si vous ne voulez pas utiliser de base de données, utilisez le paramètre MODE=ALONE .
Pour changer la verbosité des logs, il ya le paramètre suivant LEVEL=CRITICAL. Il peut prendre les valeurs INFORMATION, WARNING, CRITICAL ou SEVERE. En mode de production, je vous conseille de mettre la valeur CRITICAL. En mode de débuggage, vous pouvez mettre LEVEL=INFORMATION.
Le paramètre CONFIG=..\scripts\modules\WATCH.DOG\config\ ne doit pas changer, sauf si vous déplacer le module.
Le paramètre DEVICES=dev_z10.ini|dev_z11.ini|dev_z12.ini|dev_z13.ini|dev_z14.ini contient le nombre de règles que vous souhaitez surveiller.
Le paramètre EVENTS=evt_watch_dog_periodically.ini contient juste l'évènement qui va se lancer régulièrement. A priori, vous n'avez pas à toucher à cette ligne.
Enfin, il ya les trois paramètres NOTIFY_BY_EMAIL, NOTIFY_BY_NABAZTAG et NOTIFY_BY_SMS. Chacune de vos règles que vous allez créer dans un device à un niveau de gravité. Pour le frigo qui reste ouvert, disons que c'est pas grave (disons donc CRITICAL), par contre pour le chauffage en surchauffe, disons que c'est un peu plus grave (disons donc SEVERE). Il vous suffit donc de préciser comment vous aller notifier vos differents niveaux d'erreurs. Lorsque vous voulez donner plusieurs niveaux à un système de notification, vous devez séparer ces valeurs par un |
Exemple:
NOTIFY_BY_EMAIL=INFORMATION|WARNING|CRITICAL|SEVERE
NOTIFY_BY_NABAZTAG=WARNING
NOTIFY_BY_SMS=SEVERE
Comment paramétrer le fichier dev_xxx.ini ?
Vous avez besoin d'un fichier dev_xxx.ini par règle de vérification. Chaque dev_xxx.ini représente un virtual device Homeseer. Il contiendra le status de sauvegarde de votre logiciel. Notamment la date de dernière sauvegarde.
CAN_DIM=false permet de créer un device DIMable. Dans notre cas, le device donne juste un status de sauvegarde. Donc on laisse la valeur false.
HC=Z, DC=10, LOCATION=Monitoring, DEV_TYPE_STRING=Virtual, NAME=Homeseer, REF=26010 sont les paramètres généraux de votre device. Vous pouvez changer les valeurs que vous voulez.
MISC permet de préciser votre device (Voir l'aide de Homeseer). Si vous utilisez MISC=&H8, le device ne sera plus loggué dans Homeseer. De nombreuses autres options existent dans l'aide de Homeseer.
STATUS_SUPPORT, VALUES, BUTTONS, GRAPHICS, PARAM4 à PARAM10 ne sont pas utilisés dans cette version.
La Valeur par défaut de votre device est donné par DEFAULT_STATUS= , DEFAULT_STRING=R.A.S., DEFAULT_VALUE=. Cette valeur est juste utilisée lors de la création du device.
Enfin, il ya 4 paramètres pour ces devices :
* PARAM1=[C5=ON][R.A.S.]|[C5=OFF]&[T2>30][Il faudrait allumer le récupérateur de chaleur][R.A.S.]. Ce sont des règles de vérification (Voir chapitre suivant pour plus de détails)
* PARAM2=WARNING. Donne le niveau de gravité de cette règle (de ce device)
* PARAM3=Il faudrait allumer le récupérateur de chaleur (Donne la valeur qui déclenche l'évènement)
* PARAM4 donne le destinataire (SMS ou email). Si vous ne précisez pas de destinataire, le système prend les variables par défaut du framework (Voir fichier framework_domotics.inc).
Comment paramétrer le fichier evt_xxx.ini ?
NAME et GROUP sont modifiables pour que vous renommiez l'évènement à votre guise.
MISC permet de préciser votre évènement (Voir l'aide de Homeseer). Si vous utilisez MISC=&H4000, l'évènement ne sera plus loggué dans Homeseer. De nombreuses autres options existent dans l'aide de Homeseer.
REC_MINS=5 et EVT_ABS_TIME=6 permet de créer un évènement qui s'exécute toutes les 5 minutes.
