Mobile Alerts

v3.5
Plug-in pour récupérer les données Mobile Alerts des capteurs Lacrosse compatibles.

! Attention, avant achat, il vous faut soit un kit avec passerelle MA10001, soit si vous possédez la passerelle, des capteurs compatibles, vérifiez sur la page Mobile Alerts la compatibilité ! Vous pouvez aussi les trouver sur la page Lacrosse dans le menu "Objets Connectés"*

Important

Note : Le plugin sert à installer le script et un seul type de capteur à la fois ! exemples:

• Nouvelle installation, commencez par installer le Capteur Maître.
• Vous installez un capteur et vous en avez déjà un de ce type: clonez-le !
• Vous installez un nouveau type de capteur: repassez par le plugin !

Mise à jour

Si vous venez de la version v3.4 vous n'avez plus accès aux données, Mobile Alerts ayant bloqué les appels PHP, cette nouvelle version a donc supprimé la possibilité de déterminer la durée du cache, celle-ci est maintenant fixée à 30' et non modifiable
Pour passer outre ce blocage, vous devez entrer maintenant dans VAR2 votre User Agent, me contacter en MP
Vous devrez donc aussi modifier l'URL d'appel qui devient
http://localhost/script/?exec=lacrosse.php&phoneid=[VAR1]&useragent=[VAR2]&langue=[VAR3]
! Attention: Si VAR2 se propage (un seul capteur à modifier), il n'en est pas de même pour l'URL, il faudra pour chaque capteur changer le mot cacheduration par le mot useragent !

Installation

Installation Rapide

• 1- Créer, Attribuer une pièce, Je veux créer un : Capteur Maître, ID Smartphone, User Agent, Créer // Sauvegarder
• 2- Pour chaque capteur (!) : Créer, Attribuer une pièce, Sélection du Capteur Maître, choix présentation si anémomètre, Créer // Renommer, contrôler le XPath, Sauvegarder

Chapître Installation

Il est conseillé de lire les prérequis avant d'aller au chapître Installation

Principe des Canaux

Le Capteur Maître

Le Capteur Maître "Heure du Cache" est le "parent" de tous les périphériques Mobile Alerts. Ils sont donc regroupés en canaux et ont en commun les paramètres Var[1,2&3] et le Polling (chapitre Groupe). Ce Capteur Maître vous indiquera le nom du capteur qui a appelé en dernier le serveur Mobile Alerts et l'heure de cet appel: les autres capteurs faisant appel au cache.

• Sur un seul capteur : Renseignez ou vérifiez (mise à jour du groupe) :
  • [VAR1] = ID
  • [VAR2] = indiquez ici l'User Agent que vous trouverez ICI
  • [VAR3] = langue du Capteur Maître: fr ou en, si vous laissez vide = fr
  • Polling (fréquence de requête), doit être égale à 30 ! c'est à dire à la durée du cache, fixé dans le script à 30' et non modifiable.

Suppression de périphérique

Attention : avant de supprimer un périphérique, désassociez le (Rattacher à) sous peine de supprimer tous les périphériques du groupe parent/enfants.

Produits compatibles

On trouvera, sur Amazon ou principalement en Allemagne, les mêmes produits sous les marques TechnoLine - Mobile Alerts - avec les mêmes références & TFA Dostmann (qui produit la coque pour thermomètre extérieur de l'article MA10250) WEATHERHUB SmartHome.

Principes

Pour l'utilité de la passerelle, les avantages des capteurs Lacrosse / Techno-Line / Conrad Connect, leurs références, voir les liens proposés (Mobile Alerts - Lacrosse - La discussion sur le script dans le forum Eedomus).
Le plugin ne propose la création que d'un type de péripérique à la fois y compris pour le Capteur Maître qui n'est à installer qu'une seule et unique fois ! (chapitre Installation). Une fois un périphérique d'un type donné créé et sa configuration complétée et enregistrée, vous devrez dupliquer celui-ci pour en installer un autre du même type pour ne remplir que les infos personnalisées concernant ce dernier : nom, pièce, XPath et laisser le reste des informations tel quel.

• Par cohérence VAR(1,2&3) doivent avoir la même valeur pour tous les périphériques: n'importe quel périphérique peut faire l'acquisition des données et mettre à jour le cache qui contiendra toutes les données de tous les périphériques : c'est lui qui sera interrogé durant toute la durée (du cache) entre deux requêtes au serveur Mobile-Alerts.
• De même, la fréquence de requête n'a pas a être supérieure (cela ne diminuera pas la fréquence d'interrogation au serveur) ni inférieure (elle n'irait reprendre que la même valeur dans un cache non encore mis à jour): elle doit donc être la même ! c'est à dire 30 !
• L'URL doit évidemment être le même partout, attention, il ne se propage pas et il faut le modifier pour chaque capteur en cas de mise à jour.
• Vous avez l'indication de la dernière mise à jour du cache, et quel capteur l'a faite, dans le Capteur Maître.

ID Smartphone, User Agent et Langue ne sont indiqués que lors de la création du Capteur Maître (Heure du Cache). Lors de la création d'un Capteur, ces valeurs n'ont plus à être renseignées.

Tests

Vous pouvez, avant achat, voir un exemple de données HTML en allant sur la page de Luc Trullemans, un météorologue d'exception (RTL, expéditions, Solar Impulse...) maintenant à la retraite, au menu Observation (le premier lien Huppertzberg est un lien Mobile Alerts).

Vous pouvez aussi installer l'appli smartphone et ajouter les capteurs tests suivants:

Prérequis

Vous avez une passerelle Mobile Alerts et au moins un capteur ou une centrale compatible :

• Eventuellement, une fois configuré la centrale (autonome) ou ayant en main le capteur
• Brancher la passerelle sur Internet, puis sur le secteur, attendez le voyant vert
• Installez l'application Mobile Alerts sur votre smartphone
  • Permettez lui d'accéder à l'appareil photo si vous préférez le scan à l'entrée du deviceID
  • Scannez le 3DBarCode de vos capteurs un à un (ou entrez leur ID)
  • Dans l'appli, renommez éventuellement les différents capteurs / centrale
  • Notez l'ID de l'appli smartphone (menu Réglage: Phone ID)
  • Vous n'avez plus besoin de l'appli, ne la désinstallez pas, c'est tout.

les unités par défaut à l'installation sont :

Pour afficher d'autres unités :

• température en °F
• précipitations en inch
• vitesse de vent en m/s, mph ou kn

Vous devez les changer dans l'onglet "Réglages" de l'Appli Smartphone, puis vous l'indiquerez dans Paramètres/Unité de la configuration du capteur concerné.

Installation

• Depuis le store eedomus, cliquez sur le bouton Créer situé sous l'icone du plug-in.

• Va apparaître la fenêtre de configuration, indiquez y les valeurs suivantes :

  • Sélectionnez "Mobile Alerts Master" (Heure du Cache...) s'il a déjà été installé.
  • S'il n'a pas déjà été installé, vous DEVEZ sélectionner ensuite "Capteur Maître" ! Sinon le Capteur créé ne sera associé à aucun "parent" et aucun canal ne sera configuré.
  • Sélectionnez le type de capteur à créer.
  • Seulement pour l'anémomètre, indiquez le type de description, sinon laissez "Autres Capteurs"
    • N'indiquez pas le Nom (nom par défaut à éditer ensuite)
    • Pièce !!! (sinon invisible)
    • éventuellement Notes
    • VAR1 : l'ID de votre appli smartphone (12 chiffres) - uniquement pour le Capteur Maître
    • VAR2 : User Agent (me contacter en MP) - uniquement pour le Capteur Maître

• Aller dans la pièce concernée pour trouver le (les) nouveau(x) capteur(s) puis:

• Terminez la configuration:
  • Editez éventuellement son Nom
  • Contrôlez ou "tester" sous "Chemin XPath" pour déterminer celui-ci (voir plus loin)
  • Cliquer sur "Sauver"
• Inutile de (ne pas) recharger le plugin pour créer le même TYPE de capteur: faire "dupliquer" (en bas à côté de "sauver"), reparamétrer le nouveau capteur : Nom, Pièce, XPath

Note sur le groupe

Le Capteur Maître "Heure du Cache" contient le nom du périphérique appelant et servira à créer le groupe de capteurs Mobile Alerts qui seront tous considérés comme des canaux de ce Capteur Maître, chaque modification d'un seul capteur sur VAR (1 à 3) et Polling (qui doit toujours être égal à 30) sera répercuté sur tous les autres, pour satisfaire à l'exigence de données identiques (voir les explications sur le cache), les capteurs devront donc tous être rattachés au Capteur Maître (Paramètres Expert). Vous pouvez changer le nom du Capteur Maître (par défaut: "Heure du Cache"), mais pas son XPath !

Note sur le cache

Le cache permet de n'interroger qu'un seul capteur pour récupérer l'ensemble des données (ce capteur et l'heure de mise à jour sont indiqués dans le Capteur Maître), les autres capteurs, dans l'intervalle de durée du cache (30'), interrogent ce dernier.
NB : en cas d'erreur d'acquisition, lors de l'interrogation au serveur, la durée du cache est augmentée immédiatement de 30': tous les autres capteurs iront lire le cache, inchangé, jusqu'à la prochaine acquisition. Cela permet de réduire considérablement les notifications d'erreur, et d'alléger la charge du serveur lors de la remise en service.

Présentation de la girouette

A l'installation, vous avez ces choix de description de la rose des vents (16 directions)

• Météo France avec Majuscule (Sud-Sud-Est)
• Météo France (sud-sud-ouest)
• International (WNW)
• Angle en degré minute (67°30')
• Angle en décimal (67.5°)

Attention, ce sont des descriptions, pas des valeurs, la valeur sera toujours en International.

Présentation de l'heure du dernier contact (capteur d'ouverture)

Pour une utilisation classique de boîte aux lettres : ce capteur, lié à un capteur d'ouverture indiquera soit,

• l'heure de dernier contact (ouvert/fermé)
• la mention "depuis hier" si il n'ya pas eu de contact dans la journée courante (depuis minuit)

Vous pourrez à ce moment créer une règle pour déterminer si par exemple, une boite aux lettres a été (ouverte et) refermée et à quelle heure.
Exemple, testez la valeur "depuis hier", si elle est différente, la boite a été ouverte.
NB: la valeur ne se mettra à jour qu'apès la mise à jour du Capteur Maître, puis ensuite après sa propre mise à jour !

Le bouton "Tester"

• Le XPath par défaut est prédéterminé, mais il faut le contrôler et éventuellement le changer pour obtenir la valeur désirée :
  • Sous "Chemin XPath" vous allez cliquer sur le lien "Tester" qui vous amènera sur la page de test du script.
  • Cliquez dans cette page sur le bouton "Tester"
  • Il va apparaître le XML généré, cliquez maintenant sur "Utiliser le résultat XML"
  • Entrez maintenant le XPath désiré (voir plus loin) puis cliquer sur le bouton "Tester" à nouveau.
  • Si la valeur qui s'affiche est correcte, copiez cet XPath, fermez cette fenêtre et collez le XPath dans la fenêtre de configuration.
• Il est conseillé de copier le XML généré pour configurer les autres capteurs/données sans repasser par la fenêtre de test.

Déterminer le XPath

• Pour repérer la valeur souhaitée, puis les Tags qui l'encadrent:

  • Cas 1 : le nom du tag est unique (dans le XML), alors la valeur XPath sera simplement:
    • //tag (généralement prédéterminé)
  • Cas2 : le nom du tag est le même pour plusieurs capteurs (exemple : "temperature"), dans ce cas, rechercher le nom du capteur qui encadre la donnée qui vous interresse, le XPath sera alors:
    • //Nom du Capteur/tag
  • exemple pour le Test du Huppertzberg
    • //__anemometre_huppertzberg__482m_/rafale
  • Nouveauté : Cas 2 incrémenté pour les capteurs d'ouverture, de température et de température/hygrométrie; Le nom du capteur se termine par _X (X=1, 2, ...) dans ce cas, le nom du capteur seul suffit. Attention a bien repérer le nom du capteur, l'incrémentation se faisant dans l'ordre, un capteur de température puis un capteur de température et d'hygrométrie seront nommés respectivement : temperature_1, temperature_2, hygrometre_1, toujours vérifier dans le XML avant d'entrer le XPath.

• Ne changez pas le XPath du Capteur Maître !

A propos de ce plug-in

Ces dispositifs sont les plus adaptés aux données météo, aux températures extrèmes (-40°C+60°C), aux économies de piles et sont en 868 Mz (500mw) donc ayant une portée théorique de 100 mètres. Ils bénéficient en outre d'un coût relativement peu élevé (passerelle comprise). Ce plugin qui reprend le script paru sur le forum eedomus a été inspiré d'une publication (parue en 2017) sur le forum Jeedom et la base de sa programmation a été réalisée par merguez07. Toutes les mises à jour sont de thrymartin.

• V1.0 : version initiale personnelle. (merguez07)
• V1.1 : version universelle. (merguez07)
• V2.0 : utilisation du cache.
• v2.2 : suppression des commentaires "Luftfeuchtigkeit".
• v2.3 : suppression de tous les commentaires.
• v2.4 : paramétrage de la durée du cache.
• v2.5 : présentation de l'anémomètre, paramétrage cache en cas d'erreur d'acquisition.
• v3.0 : canaux, configurations spécifiques, heure du cache, correctifs pluviomètre & anémomètre.
• v3.1 : girouettes, version anglaise des capteurs, unités, documentation.
• v3.2 : ajout du pluviomètre "pluie cumulée" : compatibilité avec le plugin "pluviomètre" (JMVong) - en attente d'édition sur v 3.6
• v3.3 : corrections de bugs: accentuées, incrémentation de capteurs multiples de même nom pour les capteurs d'ouverture, thermomètres et hygromètres.
• v3.4 : ajout de l'heure de dernier contact (capteur d'ouverture).
• v3.5 : cache fixé à 30', accès par User Agent