Lua et json

json_luaLes dernières versions de Domoticz donnent maintenant la possibilité de lire/fabriquer, dans nos scripts Lua, des fichiers au format JSON en natif sans autre outil externe.

L’intérêt est grand en effet d’avoir des outils pour exploiter ce format qui est utilisé nativement dans Domoticz, mais aussi dans de nombreux sites web afin de donner aux utilisateurs des possibilités d’interrogation, citons juste l’api de Domogeek, celle de méteo France, airaprif …..

Rappel pour ceux qui arriveraient maintenant https://easydomoticz.com/lapi-json-de-domoticz-demythifiee/ et la bibliothèque complète https://easydomoticz.com/traduction-francais-de-lapi-json-domoticz/

Encore une fois il s’agit de la traduction de la page correspondante du wiki https://www.domoticz.com/wiki/Lua_-_json.lua

Utilisation

Rien n’est à installer puisque les versions après le 23/11/2016 (build  8e0dfd5) incorporent un fichier JSON.lua dont nous allons voir l’utilisation ici.

Dans chaque script Lua qui aura besoin d’utiliser des valeurs renvoyées au format JSON, il nous suffira d’appeler ce fichier JSON.lua. Ce fichier est dans le répertoire des scripts lua que ce soit sous Linux ou Windows©.

Exemples

Domoticz

Imaginons que je cherche à récupérer dans un script Lua, le nom et la valeur actuelle d’un dispositif interne à Domoticz.

Comme en tapant dans un navigateur :

http://192.168.1.81:8080/json.htm?type=devices&ridx=226 ou le ridx=226 est l’idx de mon périphérique Domoticz et 192.168.1.81:8080 , l’IP et le port de mon Domoticz.

je reçois cela en retour

Je vois que le nom est dans Name et la valeur dans Data ET TOUT CA dans le « pavé » nommé ‘result’

Le script utilisant la bibliothèque JSON.lua serait :

  • on incorpore le fichier JSON.lua
  • on appelle curl pour interroger le site web qui nous renverra ses données JSON  (ici mon Domoticz)
  • la variable ‘blocjson’ contient tout le pavé JSON, (enlevez les — devant pour voir ce que vous avez reçu)
  • puis l’appel de result[1].Name, result[1].Data nous permet d’assigner nos variables.

Oui, mais pourquoi result[1] ? , cette syntaxe correspond au fait qu’il s’agit du 1er « pavé » nommé ‘result’  dans mon JSON (même si l’y en a qu’un seul).

Weather Undergroud

La doc du wiki prend en exemple le site Weather Ungerground

On voit dans la documentation qu’il nous renvoie la météo sous cette forme JSON

Le script du wiki retire longitude et latitude par un

car je dois aller à current_observation puis display_location pour « tomber sur » latitude et longitude, faites bien attention aux {} d’imbrication et au crochets.

Ça marche pas

Si votre script Lua ne vous renvoie rien :

  • vérifiez les noms des champs dans le JSON, attention aux majuscules/minuscules.
  • avez vous bien respecté le chemin vers votre valeur wwww. xxxx.yyyyy.zzzz
  • si comme pour Domoticz le champ que vous voulez extraire est dans un truc à crochets et accolades ->

il faut utiliser xxxxx[1].mon_champ pour extraire la valeur correspondante.

Conclusion

Loin d’avoir exploré tous les cas de figures d’utilisation de cette nouveauté de Domoticz, l’intérêt apporté est grand et nous permet encore plus d’ouverture et toujours plus de puissance dans notre box domotique préférée.

Résultat de recherche d'images pour "youpi"

 J’adore ces images des années 70

Pour toute question technique concernant cet article, veuillez utiliser les forum situés à https://easydomoticz.com/forum/

Traduction en français de l’Api json Domoticz

Traduction de l’ API/JSON de Domoticz

Vous en rêviez, et bien voici la traduction en français des commandes que nous pouvons utiliser pour interroger et piloter Domoticz via les URL
Un rappel général de l’utilisation est ici https://easydomoticz.com/lapi-json-de-domoticz-demythifiee/
Comme d’habitude il s’agira d’une traduction « à ma sauce » de la page ici située https://www.domoticz.com/wiki/Domoticz_API/JSON_URL’s. Cette page anglophone reste la seule source valable et mise à jour régulièrement, merci de vous y reporter en cas de questions.
Si vous constatez des erreurs, merci d’en faire part dans les commentaires.

Contenu

Format

Le format général à respecter est de  la forme :

  • <username:password@> = le login et le password de Domoticz (optionnel).
  • domoticz-ip =l’ IP-adresse de Domoticz.
  • <:port> =le port de votre Domoticz (optionnel).
  • api-call, la chaine à envoyer pour faire le job.

Ici api-call est donc  tout ce qui suit le ? de json.htm, donc type=command….

A savoir

Si vous avez protégé vos périphériques via la case « Protégé » du widget, les modifs via JSON seront aussi interdites, il faut insérer tout au bout de l’URL  JSON le mot de passe de protection

Mieux afficher les sorties

Par défaut votre navigateur internet affichera les valeurs JSON reçues depuis Domoticz dans un ordre quelconque.

Pour faire plus lisible vous pouvez utiliser des plugins qui affichent et reformatent lisiblement les valeurs.
Pour Google Chrome vous pouvez utiliser JSONView (Chrome web store). Pour les autres navigateurs l’identique doit exister, cherchez dans les extensions/add-on pour votre navigateur.

Il existe également ce site web qui reformate les JSON http://jsonviewer.stack.hu/

Autorisations

Lorsque nous utilisons d’autres méthodes que notre navigateur pour se connecter à Domoticz, il peut être nécessaire de s’identifier.

L’authentification HTTP utilise la requête Autorisation sur HTTP, cette authentification est en base 64 contenant le couple user/password. En utilisant votre propre application/script et si votre domoticz est protégé par mot de passe, il vous faudra vous identifier correctement (voir python requests et la méthode auth à ce sujet). Pensez également que l’on peut autoriser certaines ip à se connecter SANS mot de passe dans le paramétrage Domoticz : réseaux autorisés.

Voici le synopsis de la méthode d’identification :

  • Le nom d’utilisateur et le password sont combinés dans une chaine « username:password »
  • Cette chaine est encodée par RFC2045-MIME version en base64
  • Dans la méthode d’autorisation on envoie « Authorization: » un espace puis « Basic  » puis la chaine encodée ci-dessus.

Comme ceci :

Maintenant sachez que l’envoi des  » http request headers » est dépendant du langage utilisé. Utilisez la documentation appropriée. Python request met à notre disposition des méthodes simples d’authentification.

Réponse

Chaque appel à l’API est suivie d’une réponse : status OK si la commande est réussie , sinon ERR

Fonctions Générales

Retrouver le status d’un dispositif précis

  • IDX = est l’idx de votre périphérique recherché (la colonne IDX dans les dispositifs)

Retrouver tous les dispositifs d’un certain type

Avec le filter=all, vous récupérez la liste de tous les dispositifs. Si vous voulez retrouver les infos de certains types utilisez les filters suivants à la place du filter=all ci dessus .

Retrouver les dispositifs en favoris

Cela vous renvoie un tableau avec les dispositifs marqués en favoris (petite étoile jaune) présents sur la page « Tableau de bord ».

Obtenir les levers/couchers de soleil

Afficher un message dans le log Domoticz

Vous pouvez faire afficher vos propres textes dans le log Domoticz grâce à :

  • MESSAGE = contient le message que vous souhaitez afficher.

Lumières et Interrupteurs

Obtenir la liste de toutes les lumières/switches

ou triés par noms

Exemple :

Allumer une lumière, un switch

Éteindre une lumière, un switch

  • idx = idx de votre dispositif (ici 99).
  • switchcmd = « On » or « Off » (Attention aux majuscules/minuscules !)

Si tout c’est bien passé on a :

Envoyer une valeur à un matériel dimmable

  • Le champ level doit être une valeur entre 1 (0%) et 16 (100%). Si vous voulez utiliser les pourcentages et que 1 à 16 ne marche pas pour vous , utilisez 1 à 100.
  • Lorsque la lampe est à off , elle est passée à On
  • Le retour est :

Basculer un switch d’état

Cette commande permet de passer à On si c’est à Off et vice-versa sans que vous vous occupiez de son état actuel.

Scènes / Groupes

Obtenir toutes les scènes et les groupes

Exemple :

Passer une scène / groupe à on ou off

  • idx = idx de votre scène/group (dans le menu « Dispositifs »).
  • switchcmd = « On » or « Off » (attention majuscules)
  • Les Scènes peuvent seulement être passées à On

Ajout d’une scène (0)

Ajout d’un groupe (1)

Détruire une scène ou un groupe

number est le numéro de la scéne (c.f paramètres)

Lister tous les dispositifs d’une scène

Ajout d’un dispositif à une scène

Supprimer un device d’une scène

Liste des horaires liés à une scène

Exemple :

Ajout d’un horaire à une scène

idx = index de la scène, du groupe.

  • active = true/false
  • timertype = 0 =Avant lever soleil, 1 = Après lever Soleil, 2 =A l’heure indiquée, 3 = Avant coucher soleil, 4 = après coucher soleil, 5 = A une date ou heure précise.
  • date = MM-JJ-YYYY (mois sur 2 caractères-jour sur 2-année sur 4) Ex: 10-03-2016
  • hour = heure
  • min = minute
  • randomness = Aléatoire : avec le paramètre du paramétrage indiquant la dérive autour de cet horaire, pour faire une simulation de présence par exemple.
  • command = On/Off
  • level = 0..100 (%)
  • days = 0x80 = Tous les jours, 0x100 =Jours de semaine uniquement, 0x200 = Weekends, 0x01 = Lundi, 0x02 = Mardi, 0x04 = Mercredi, 0x08 = Jeudi, 0x10 = Vendredi, 0x20 = Samedi, 0x40 = Dimanche

Allez voir dans le bouton « Plannings » d’un interrupteur pour comprendre tous ces paramètres.

Commandes du serveur

Arrêt du système

Reboot

Les commandes de création

Créer un matériel virtuel

Ensuite pour obtenir un id, obtenez la page hardware pour le dernier ID :

Créer un dispositif virtuel

Temp+Humidité (voir plus bas pour les valeurs)

Electricité (voir plus bas pour les valeurs)

et maintenant obtenez les devices id avec la liste :

Pour le RFXMeter, une autre requête est nécessaire pour configurer le mode, l’url est:

dans lequel DEVICE_ID est le nom du device et SUBTYPE_VALUE est une de ces valeurs :

Mettre à jour des capteurs

Soyez prudent en envoyant vos valeurs via JSON.
Il n’est pas exclu que vous crashiez Domoticz, si vos valeurs ne sont pas bonnes ou manquantes

Surtout sur des Domoticz version <=Beta 1.1634 ou stable <=1.1396 qui sont très sensibles. Les versions ultérieures sont plus sécurisées pour cela.

Vous aurez besoin de l’idx de votre capteur, allez le noter dans l’écran des dispositifs.

Temperature

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • TEMP = Température que vous souhaitez affecter à ce capteur.

Humidité

  • IDX =idx de votre capteur. A obtenir depuis l’écrans des dispositifs.
  • HUM = Humidité: 45 par exemple pour 45%
  • HUM_STAT = Humidity_status

Humidity_status peut être :

  • 0=Normal
  • 1=Confortable
  • 2=Sec
  • 3=Humide

Ce paramètre est obligatoire, si vous ne savez pas quoi mettre, mettez 0

Baromètre

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • BAR = Pression barométrique.
  • BAR_FOR = Météo selon la presion baro à choisir dans la liste ci-desous.
  • 0 = Stable
  • 1 = Soleil
  • 2 = Nuageux
  • 3 = Instable
  • 4 = Tempête
  • 5 = Inconnu
  • 6 = Nuageux/pluie

Ce paramètre est obligatoire, si vous ne savez pas quoi mettre, mettez 0

Température /humidité

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • TEMP = Temperature
  • HUM = Humidité
  • HUM_STAT = Status de l’humidité parmi la liste ci-dessous.

 

  • 0=Normal
  • 1=Confortable
  • 2=Sec
  • 3=Humide

Température/humidité/baromètre

Cette instruction permet de donner des valeurs aux capteurs Temp+Humidité+Baromètre

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • TEMP = Temperature
  • HUM = Humidité
  • HUM_STAT = Status d’humidité
  • BAR = Pression barométrique
  • BAR_FOR = Météo selon la presion baro à choisir dans la liste ci-desous :

 

  • 0 = No info
  • 1 = Soleil
  • 2 = Partiellement nuageux
  • 3 = Nuageux
  • 4 = Pluie

Pluie

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • RAINRATE = quantité de pluie depuis la dernière heure
  • RAINCOUNTER = cumul de pluie tombée en mm

Vent

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • WB = Angle du vent (0-359)
  • WD = Direction du vent (S, SW, NNW, etc.)
  • WS = 10 * Vitesse du vent [m/s]
  • WG = 10 * vitesse de la rafale[m/s]
  • 22 = Temperature
  • 24 = Temperature Windchill

les deux dernières valeurs sont TOUJOURS 22 et 24.

UV

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • COUNTER = La valeur de l’UV avec un point décimal (obligatoire : exemple: 2.0)

Attention il y a un « ;0 » à la fin, c’est comme ça , ne l’oubliez pas.

Compteur

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • COUNTER = Un nombre entier qui est votre comptage.

N’oubliez pas que ls compteurs Domoticz peuvent compter dans plusieurs unités :

  • Energie (kWh)
  • Gaz (m3)
  • Eau (m3)
  • Compteur (sans unité)

Et donc bien entendu pour les m 3 si vous passez des litres la valeur sera divisée par 1000 car l’unité est le m3. Le compteur affiche toujours 2 valeurs :

  • Le status est le total cumulé.
  • Le volume ou comptage du jour est affiché dabs le coin en haut à droite.

Électricité (instantané et compteur)

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • POWER = Puissance actuelle consommée.
  • ENERGY = cumul en Watt-heures (Wh) (c’est juste un « compteur virtuel », tous les cumuls doivent être faits par VOUS)

Électricité P1 smart meter

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • USAGE1= Conso en tarif 1
  • USAGE2= Conso en tarif 2
  • RETURN1= energy return meter tariff 1
  • RETURN2= energy return meter tariff 2
  • CONS= actual usage power (Watt)
  • PROD= actual return power (Watt)

USAGE et RETURN sont des compteurs qui ne peuvent que croitre. Vous devez y donner des valeurs en Wh sans virgule. Ainsi si votre valeur est USAGE1= 523,66 KWh vous devez envoyer 523660)

Qualité de l’air

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • PPM = CO2-concentration

Pression

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • BAR = Pression atmosphérique en Bar

Créer ce capteur dans « Matériel »/ »Créer capteur Virtuel »

Pourcentage

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • PERCENTAGE = Le pourcentage à afficher dans le widget

Gaz

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • USAGE= Gaz en litre (1000 litres = 1 m³)

Ainsi si votre compteur de gaz affiche 145,332 m³ vous devez envoyer 145332.
La variable USAGE est le total des litres depuis la nuit des temps et non pas la consommation journalière.

Lux

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • VALUE = valeur de la luminosité en Lux.

Voltage

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • VALUE = valeur de volts a afficher sur le widget

Text sensor

Ceci permet d’afficher un texte sur un widget Domoticz.

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • TEXT = Le texte à afficher.

 

  • Exemple http://IP:PORT/json.htm?type=command&param=udevice&idx=mon_idx&svalue=MONTEXTEAAFFICHER

 

Alert sensor

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • LEVEL = (0=gris, 1=vert, 2=jaune, 3=orange, 4=rouge)
  • TEXT = Le texte à afficher.

 

Distance

 

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • DISTANCE = distance en ce que vous voulez comme unité, la valeur est affichée sans unité. Vous pouvez envoyer des décimales (12.6) avec un point.

Selector Switch

Il s’agit de piloter ce capteur virtuel nomme « Selector switch » ou l’on peut prédéfinir 4 niveaux (pour des dimmables par ex, ou des volets)

inter_sele

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • LEVEL = Un nombre qui fait référence à celui défini dans le menu « Editer » du widget
  • sel_switch

Custom Sensor

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.
  • VALUE = Valeur avec un point décimal (12.345)

Paramètres additionnels (signal level & battery level)

Il y deux paramètres supplémentaires pour toutes les commandes ci dessus pour préciser la qualité de réception (radio) et le niveau de batterie.

Par défaut le niveau de signal est à 12 et le niveau de la batterie est à 255 (pas de batterie) sinon le niveau est entre 0 et 100.

Il faut ajouter ces lignes tout au bout de la chaine

exemple: &rssi=10&battery=89

User variables

Ajouter une nouvelle variable

uservariablename= le nom de la variable, évitez les accents.

  • uservariabletype = le type de valeur à stocker, entre 0 et 4 :

  • uservariablevalue = la valeur à stocker dans cette variable

Tout cela est vérifié par l’API, si la variable n’est pas correcte , elle n’est pas enregistrée par Domoticz.

Par exemple , vous avez défini une variable stockant des nombres entiers et vous essayer d’y écrire 3.0

ici je crée une variable nommée code_porte_garage en type chaine de caractères et j’uy mets « 453aZVT » dedans.

Modifier une variable

  • USERVARIABLENAME, le nom de la variable
  • USERVARIABLETYPE le type (cf ci-dessus)
  • USERVARIABLEVALUE la nouvelle valeur

Liste de toutes les variables

vous affiche toutes les variables.

Pour obtenir une seule variable et ses valeurs:

  • IDX = idx de la variable, allez voir dans les varialbes utilisateur dans »Réglages/Plus d’options » c’est le numéro IDX

Détruire une variable

  • IDX = idx de la variable, allez voir dans les varialbes utilisateur dans »Réglages/Plus d’options » c’est le numéro IDX

Plans

Lister les pièces

Lister tous les devices d’une pièce

  • IDX = idx de votre pièce

Historiques

On affiche gràce à ces instructions l’historique des capteurs. Alluamges,extenction avec les dates pour les switches, températures et dates pour les autres.

  • IDX = idx de votre capteur. A obtenir depuis l’écran des dispositifs.

Switch

Tempèratures

Setpoint

Energie, Gaz, Eau

 

Pas encore documenté

Autoriser les nouveaux dispositifs

Cela correpond à la case « Autoriser les nouveaux dispositifs » du menu « Réglages/Paramètres »

 

Tous les plannings

Retrouvez tout ce qui est planifié par :

Typical result :

Afficher les plannings que pour les devices

Afficher les plannings que pour les Scenes

Afficher les plannings que pour les Thermostats

Activer un planning spécifique ?

qu’est timerID ?

Désactiver un planning spécifique

 

Pour toute question technique concernant cet article, veuillez utiliser les forum situés à https://easydomoticz.com/forum/

Commandes vocales via Jarvis

J’avais déjà parlé ici de reconnaissance vocale via imperihome Android ou YANA.

Je voudrais vous présenter ici un nouvel outil que j’ai découvert récemment nommé JARVIS.

Son grand avantage par rapport à d’autres outils : LE FRANCAIS est natif !!

jarvis Vous emballez quand même pas trop, on est pas dans Ironman. jarvis_logo_red

L’intérêt de ce Jarvis ci est de faire de la reconnaissance vocale et d’y enchaîner des actions :

  • « Jarvis » « météo » vous donnera vocalement la météo de weather Underground (plugin+enregistrement) ,
  • « Jarvis » « tu sais quelle heure il est ? » dira l’heure.

La reconnaissance se base sur des mots clés que vous définissez vous même. Ainsi dans le « tu sais quelle heure il est » le mot clé recherché peut être défini à *HEURE* et donc toute phrase contenant le mot heure donnera l’heure. Cette reconnaissance d’un mot permet de lancer des scripts bash qui font des actions. « Heure » lance une commande linux :

En plus d’être extrêmement paramétrable car on peut programmer soit même les actions à effectuer à l’issue d’une phrase, on peut lancer des taches vocales via cron (toutes les 10 minutes dire « Bonjour votre Altesse »), il y a des plugins dont un destiné à de la domotique et bien plus.

La phase de reconnaissance vocale peut utiliser soit un moteur local (pocketsphynx) soit Bing.

La page de référence est ici http://domotiquefacile.fr/jarvis/ et Alexylem le concepteur du soft à bien fait les choses puisque explications d’ installation et d’utilisation du soft sont très claires et didactiques (comprenez par la que je ne détaillerai pas ces phases 😆 ).

Bien entendu nous verrons ici comment intégrer Jarvis à notre Domoticz.

A noter Jarvis ne fonctionne QUE sur Raspberry, il faut donc un micro et des enceintes reliés à celui-ci.

Les points forts

Énormément de choses sont paramétrables, plusieurs moteurs de synthèse ou reconnaissance vocable, liste de mots clés reconnus , actions à déclencher, des plugins météo, gmail, de domotique.

On peut aussi lancer Jarvis en ligne de commande pour lui faire faire des actions, on peut utiliser les scripts:/// de Action ON et Action OFF pour lancer des commandes au basculement d’un switch. jarvis.sh -s « Le salon vient de s’allumer » juste pour faire dire une phrase ou -x pour exécuter une commande interne Jarvis

Via Lua un petit os.execute fera le job./home/pi/jarvis/jarvis.sh -x « c’est comment la météo » lance la commande METEO de Jarvis.

Installation

Je vous laisse parcourir le site de Jarvis pour effectuer l’installation.

Sachez toutefois qu’il vous faudra installer sox, alsamixer,aplay, arecord,mpg123 et jq.

Pour jq vous trouverez la procédure ici https://easydomoticz.com/manipuler-les-donnees-json-de-domoticz-en-shell/

Sinon, pas d’inquiétude, la procédure d’installation vérifie tout cela et vous donne les commandes à taper.

Puis l’assistant d’installation vous guide dans tout le processus de configuration y compris la détection de vos micros et hauts-parleurs.

A noter : Les meilleurs résultats de reconnaissance que j’ai pu obtenir sont lors de l’utilisation de la reconnaissance vocale Microsoft Bing qui utilise Internet (à mon grand désespoir).

Alexylem à un joli tableau récapitulatif ici http://domotiquefacile.fr/jarvis/content/stt

Pensez à votre vie privée lorsque vous transmettez des commandes à des tiers sur Internet (Bing, Google, Wit)

Une fois familiarisé avec Jarvis, attaquons nous au coté Domoticz de façon à piloter quelque chose à la voix.

Intégration avec Domoticz

Nous allons utiliser un plugin générique Home Automation de Jarvis.

Ce plugin permet d’envoyer des requêtes http à la voix .

Dans le store Jarvis

jarvis_storeInstallez le plugin « Home Automation » puis « Home Control ».

De même n’hésitez pas à faire des mise à jour du plugin dans Store > Installed > Home Control > Update en attendant les mise à jour automatique des plugin (work in progress).

Il s’affiche une page d’aide que nous allons détailler et adapter à Domoticz.

On voit ici qu’il nous faudra adapter les url suivant les spécifications de l’API Json de Domoticz et indiquer dans le tableau pg_hc_config le nom à prononcer et l’idx domoticz.

Modifiez les turnon_url et turnoff_url avec vos ip:ports Domoticz et l’appel à l’api JSON qui vous convient en laissant [ADDRESS] à l’endroit ou vous devez envoyer l’idx Domoticz.

Rappel : l’idx c’est cette colonne :idx_domoticz

Faites les modifs  via le menu « Config » du plugin « Home Automation » de Jarvis pour obtenir quelque chose comme :

Ou 192.168.181:8080 est mon Domoticz, lumière et 112 , le nom et l’idx de la lumière , volet cuisine, 33 …

En prononçant « allume lumière » on ira donc activer l’idx 112 de Domoticz  via « pg_hc_turnon_url »

N.B  Les plugins sont dans le dossier plugins, il y a un sous dossier par plugin, puis dans celui ci un readme.md qui donne quelques explications au sujet du plugin , puis des dossiers /fr ou /en ou se situent les commandes dans la langue correspondante. Ce sont des fichier texte bash. Vous pouvez agir directement sur ces fichiers. La modification est immédiate, pas besoin de relancer Jarvis sauf si vous avez changé un mot à reconnaitre..

Je vous conseille de prendre des mots vraiment discriminants , par exemple , la reconnaissance du mot « volets » donne souvent le verbe « voler » et donc la phrase « ouvre voler salon » n’existant pas …

alexylem vient de me préciser que en utilisant « vole » tout simplement (la comparaison vérifie si le nom du device est « inclue » dans la commande reçue) cela devrait fonctionner.

Et comme les plus perspicaces d’entre vous auront remarqué qu’il faut dire « Allume volet salon » ou « éteint volet salon » ce qui peut paraitre bizarre nous verrons prochainement comment améliorer cela en ajoutant les mots « Ouvre » et « Ferme ».

Un petit film de présentation ici

 

Pour toute question technique concernant cet article, veuillez utiliser les forum situés à https://easydomoticz.com/forum/

Prévision de pluie pour Domoticz

Météo France propose un service bien pratique et qui de nombreuses fois m’a prouvé son efficacité lors de sortie sportives : le fameux « Va t’il pleuvoir dans l’heure ». http://www.meteofrance.com/previsions-meteo-france/previsions-pluie

Ainsi vous saurez pour une ville donnée si vous avez la malchance de voir tomber la pluie dans l’heure qui suit et ainsi vous éviter un inutile arrosage du jardin ou une ballade humide.

A force de chercher j’ai trouvé l’API en question chez Météo France. :mrgreen:

Vous trouverez ici  une extension Chrome : https://github.com/liorzoue/ext-meteo affichant le fameux  » ‘Va-t-il pleuvoir dans l’heure ?' », merci à l’auteur liorzoue pour son travail et dont je reprends en fin d’article le message de prudence quand à l’utilisation de cette API.

 

L’API

  • Récupérer le code insee de votre ville ici  (ce n’est pas le code postal!) ajoutez y le chiffre 0 à la fin

sinon rendez vous ici avec le nom de votre ville tout au bout.

http://www.meteofrance.com/mf3-rpc-portlet/rest/lieu/facet/pluie/search/ma_ville_

  • Récupérer les prévisions via url

http://www.meteofrance.com/mf3-rpc-portlet/rest/pluie/330210

la réponse est du JSON , je ne sais pas tout en lire mais l’essentiel est

Un script bash + un switch virtuel

Je vais donc créer un switch virtuel qui passera à ON que si de la pluie est annoncée, une notification est associée à ce passage à ON

Après interrogation du site web, récupérons donc le contenu de niveauPluieText par utilisation de JQ  jdont l’installation est expliquée ici, supprimons les caractères indésirables de texte horaire, de ‘[‘ ‘]’ et espaces.

Dans ce script changez vos ip de votre Domoticz et votre CODE INSEE.

Dans la ligne curl http://192.168…..’ modifiez idx=215 par votre idx de votre switch virtuel.

Il faudra bien entendu lancer toutes les heures le script via crontab pour mettre à jour le widget

Attention !

L’extension utilise une API non documentée (à ma connaissance) de Météo France, cette extension peut donc cesser de fonctionner à tout moment. 🙂

Et hop, rangez vos parapluies

Pour toute question technique concernant cet article, veuillez utiliser les forum situés à https://easydomoticz.com/forum/

Des scripts plus faciles pour Domoticz avec dzVents

Vous êtes sans doute nombreux à avoir vu passer l’info: depuis quelques semaines il existe un nouveau type de langage de scripts que l’on peut intégrer à Domoticz, les dzEvents de dannybloe.

Langage de script qui se veut plus simple et plus lisible que Lua et qui est une surcouche du Lua Domoticz. Ainsi le dzEvent sera « retraduit » en « vrai » Lua. L’idée est de faciliter la lecture/ecriture de scripts.

Vous trouverez donc ici la traduction à ma sauce et des débuts d’explications de ces ressources anglophones : http://www.domoticz.com/forum/viewtopic.php?f=23&t=10834&sid=b844044efb6fbeb0841881a164361a0c

et https://github.com/dannybloe/dzVents

Voici donc le pitch de dzEvents

Présentation

dzVents (|diː ziː vɛnts| raccourci pour Domoticz Easy Events) apporte un nouveau type de scripting dans Domoticz.

Vous pouvez gérer vos switches facilement,vous aurez un contrôle sur les scripts basés sur le temps avec un vrai planning, dzEvent vous apporte une API qui utilise toutes les informations de Domoticz issues de toutes les différentes tables de Domoticz.Plus de commandArrays complexes car dzEvent les encapsule tous y compris les écritures et lecture de vos périphériques.

Et cerise sur le gâteau la performance des scripts à été améliorée : si vous avez beaucoup de scripts Domoticz ne cherchera qu’une seule fois l’information pour vos script device et time au lieu de parcourir tous les scripts un par un.

Un exemple :

Imaginez que nous ayons un switch, qui à son changement d’état doit activer un autre switch si et seulement si la température d’une pièce est supérieure à une valeur niveau puis nous envoyer une notification

En dzEvent cela donne :

Pas mal !

Remarquez la syntaxe du haut on = , c’est le déclencheur sur l’état de quelque chose.

Un autre exemple avec des dates/heures/jours, le on = est ici un timer

Voyez qu’ici toutes les 10 minutes les lundi,mardi,mercredi,jeudi,vendredi on va lire une variable MyVar et si elle est égale a 10 on met une autre variable nommée ‘AnotherVar’  à 15 et on active une scène ‘Evening lights’ et si le périphérique nommé PIR n’a rien vu bouger depuis 5 minutes on met Bathroom lights à off par un switchOff.

Simple et concis.

Voyons la mise en place.

Installation.

Note: Ceci n’est pas testé pour des machines  non-linux (Windows).  Je suis certain que vous aurez des problèmes (dixit dannybloe concepteur du script).

Récupérez la dernière version depuis  GitHub, décompressez la dans le dossier de vos scripts Lua (/domoticz/scripts/lua)

Vous obtenez un dossier dzEvent-master, entrez à l’intérieur prenez en le contenu (copier) et recopiez le directement dans le dossier Lua (coller) pour obtenir cela  :

dzEvent_1

Supprimez dzEvent-master une fois que tout est fonctionnel.

En résumé, un dossier  dzVents,puis les fichiers dzVents contenant :

Ouvrez le fichier  dzVents_settings.lua et placez vos ip et numéro de port Domoticz. Merci de vérifier que vous n’utilisez pas de user/password pour le réseaux locaux (127.0.0.1) dans la config de Domotic sinon dzVents ne pourra lire les valeurs de vos équipements !

Dans ces settings on peut régler le niveau de log souhaité, plus ou moins bavard, 3 étant le plus loquace et utile au tout départ afin de savoir si tout marche. Repassez le à 2 ensuite.

Le [‘Enable http fetch’] à placer à True ou False permet à dzVents d’interroger régilièrement Domoticz et de mettre à disposition des scripts dzVents toutes les valeurs de Domoticz d’un seul coup.

[‘Domoticz ip’] = ‘192.168.1.81’,
[‘Domoticz port’] = ‘8080’,
[‘Fetch interval’] = ‘every 30 minutes’, — see readme for timer settings
[‘Enable http fetch’] = true, — only works on linux systems
[‘Log level’] = 3
}

Le dossier nommé scripts devra contenir nos scripts dzVents, il suffit juste de les nommer en .lua, plus besoin de script_device, ou script_time…

Et tout de suite les logs Domoticz doivent vous donner trace de l’activité de dzEvents (ici avec niveau de log = 3)

Bien maintenant que ça marche , continuons.

Si cela ne fonctionne pas vérifiez bien votre arborescence /domoticz/scripts/lua/dzevent avec le fichier de settings dans /lua

Mon premier script dzVents

Créons notre premier script :

Récupérez le nom exact d’un de vos switchs ici un capteur PIR nommé ‘Présence’ puis copiez ce script dans le dossier scripts (/domoticz/scripts/lua/scripts). Nommez le comme bon vous semble ici test.lua

Le script envoie une notification et affiche un message dans le log Domoticz lors de son passage à ON et envoie une notification lors du passage à OFF.

le log affiche alors (en mode 3)

Voila, après cette première étape nous découvrirons d’autres fonctionnalités dans de prochains articles.

P.S : il y a un dossier examples dans le dossier dzVents contenant quelques fichiers exemple, n’hésitez pas à les ouvrir pour vous en inspirer.

Pour toute question technique concernant cet article, veuillez utiliser les forum situés à https://easydomoticz.com/forum/