Présentation

Netatmo Sécurité Pour Jeedom

Plugin pour gérer les équipements Netatmo Sécurité et particulièrement les cameras. Les informations sont mises à jour via connexion API et/ou en réseau local et via des webhooks (si possible).

Ce plugin vous donnera la possibilité de *(1):

• Remonter la majorité des infos( éventements, état des équipements, notifications, mouvements,…)
• Remonter les personnes connus/inconnus(“Welcome”)
• Visionner les snapshots des évenements récents(“Welcome” , “Présence”, Btinco 300 Eos,…)
• Afficher un live (snapshot ou vidéo) pour les équipements compatibles (“Welcome” , “Présence”,…)
• Exécuter des commandes (activer/désactiver une sirene, activer/désactiver le monitoring ou la surveillance,…)
• Plus globalement ce sont les principales informations et actions disponibles via l’application (Netatmo Home+Sécurité) 
toutefois le plugin n’as pas vocation à remplacer l’application d’origine, certains paramétres de configuration restent disponible uniquement via l’application du fabricant
• … etc

• (1): selon vos équipements, certaines fonctions ne seront pas disponibles.n d’origine, certains parametres de configuration restent disponible uniquement via l’app. -…etc

Aperçu du plugin

Pré-requis

Avant de faire acquisition du plugin, il faut s’assurer des points suivants:

• Vos équipement sont compatibles avec le plugin.
• Vous disposer d’un compte Netatmo, et les informations de l’app Netatmo.
• Pour bénéficier des retours webhooks(optionnels), il est nécessaire d’avoir un accès externe sur l’un des ports 80, 443, 88 ou 9443.

Autres informations

Ce plugin est indépendant des marques qu’il gère (Netatmo, Legrand, Btinco…)

Les développements accessoires(panel,…) sont fournis à titre expérimentale et n’impose aucune obligation de résultat. Les Tickets ou réclamations ne seront pas forcément traités. Pour autant vous pouvez informez le développeur des soucis rencontrés.

Installation du plugin

1. Rendez vous sur la page du market Jeedom et télécharger la dernière version du plugin

   Page Market du plugin

   

2 - Télécharger la version de votre choix (beta ou stable)

Boutons installation

1. Une fois le plugin installé, aller sur sa page de configuration pour renseigner vos informations de connexion Netatmo.

Configuration du Plugin

Créer l’app Netatmo

(*) Pour accéder à L’Api Netatmo, il est indispensable d’avoir un compte Netatmo et de créer une application sur https://dev.netatmo.com/apps/createanapp#form vous devez remplir un formulaire pour générer ces informations(Client ID, Client secret). Il arrive que le serveur soit indisponible, dans ce cas il faut réessayer plus tard. Vous pouver vous basez sur l’exemple ci-joint, ne remplissez que les infos en vert. Si vous n’y arrivez pas demandez de l’aides à vos amis !… ;-)

Une fois renseigné cliquer sur le bouton "Save", un formulaire va apparaître contenant les informations recherchées.
Le formulaire ressemble à celui-ci:

Il est important d’avoir une App dédiée au plugin pour éviter tout conflits et bénéficier des Webhooks.

Informations du formulaire à renseigner

Dans la page de configuration du plugin vous devez renseigner;

Client ID*: votre : client ID (Obtenu sur https://dev.netatmo.com/apps)

Client secret* : Client secret (Obtenu sur https://dev.netatmo.com/apps)

email : l’adresse mail de votre compte Netatmo

Mot de passe : mot de passe de votre compte Netatmo

Case Webhooks : si coché, ça permet d’obtenir une actualisation automatique via les webhooks Netatmo.

Objet par défaut : L’objet Jeedom dans lequel seront crées les équipements(facultatif).

Une fois que vous avez renseigner les information du formulaire, **Cliquer le bouton “Sauvegarder” puis sur “Connect Netatmo” **, une fenêtre s’ouvre vous invitant à vous authentifier et autoriser le plugin à accéder à l’Api. A la fin du procédé et si les informations sont correctes, le plugin va automatiquement synchroniser vos équipements Netatmo avec Jeedom. Si ce n’est pas le cas, reportez vous à la section “faqs” ou “en cas de problèmes” de ce document. Le cas échéant, actualiser la page “touche F5” pour faire apparaître les équipements.

Exemple d’apérçu des équipements après synchronisation

Configuration des équipements

Préalable: Vous avez déjà reneiger les paramétrés d’authentification et synchroniser le plugin avec les serveur netatmo. (Voir section2 Comment installer ce plugin ? )

La configuration des équipements Netatmo Sécurité est accessible à partir du menu Plugin => Confort => netatmoSecurity:

Une fois que vous cliquez sur un équipement vous obtenez :

Vous retrouvez ici toute la configuration de votre équipement :

**Nom de l’équipement ** : nom de votre équipement (Vous pouvez le changer librement).

Objet parent : indique l’objet parent auquel appartient l’équipement c’est là que la tuile va apparaître.

Activer : permet d’activer l’équipement et synchroniser ses informations périodiquement

Visible : le rend visible sur le dashboard

Identifiant : identifiant unique de l’équipement

Type : type de votre équipement (Welcome, Présence…)

D’autres informations ou paramètres peuvent être disponibles selon le type des équipements

Configuration les Commandes infos et actions

Les Commandes disponibles pour cet équipement sont accessibles depuis l’onglet Commandes Elles sont classées par type; infos ou actions

Afficher : permet d’afficher la commande sélectionnée( uniquement pour tuiles ‘core’**)

Historiser : permet d’historiser la donnée de la commande “Info” sélectionnée

Configuration avancée (petites roues crantées) : permet d’afficher la configuration avancée de la commande (méthode d’historisation, widget…)

Tester : permet de tester la commande “Action” sélectionnée

Utilisation du Plugin

WIDGET

Voici des exemples de widget pour les équipements Netatmo Sécurité :

Le plugin installe un ensemble de widget “xx.iso.xx”, certains peuvent servir pour d’autres plugins. D’autres sont didiés à son propore usage. Les commandes du plugin sont pré-configurées pour utiliser ces widgets toutefois vous êtes libre de les changer. Dans ce cas informez vous pour connaître les procédés adéquats. Des widgets différents selon les équipements et les informations affichées, voici quelques visuels.

Widget mobile :

Lors du changement de mode de widget, le résultat n’apurait que lors d'une actualisation des informations.

Fonctionnement

Notion Home vs Autres équipements

Gestion/Remontée des éventements

Commandes

Afficher la liste des éventements

Afficher un snapshot des éventements(image)

Afficher un snapshot Live(image)

Afficher un stream Live(Vidéo)

Conseils

Limiter le nombre de commandes affichées

Utilité du stream Vidéo?

En cas de problème(s)

C’est le moment de savoir si vous avez de vrais amis !

Si non

1- Activer les logs en mode “debug”, dans un premier temps lire les logs et essayer de comprendre ce qui cloche,

2- Consulter le forum “Communauty-Jeedom” et faire une recherche sur le plugin “netatmoSecurity” et/ou l’erreur que vous rencontrez

3- Ouvrir un fil dédié au problème que vous rencontrez, en apportant un maximum de précisions( version Jeedom, version du plugin,…) ** Ne poster Jamais vos logs en public, sans prendre connaissance de leur contenus. ** les logs peuvent contenir des informations confidentiels (token, adresse email,…)

4- En cas de nécessité, contacter le développeur via MP en joignant vos logs et un maximum d’infos lui permettant de comprendre et analyser votre problème.

FAQ

Quelle est la fréquence de rafraîchissement des informations?

Le système récupère les informations toutes les 10 min. Et via webhook(Push automatique depuis les serveurs Netatmo)

Je n’arrive pas synchroniser ?

Vérifier les informations renseignés et recommencer la procédure d’authentification.

Un équipement ne remonte pas

Vérifier la compatibilité du plugin avec votre équipement. Si non **Voir la section “En cas de problème(s)” **

Je rencontre des erreurs !

**Voir la section “En cas de problème(s)” **

Certains équipements ne remontent pas d’éventements

Le plugin remonte un nombre d’éventements limité mais proportionnel au nombre d’équipement de votre maison( Home au sens Netatmo), En admettant que ce nombre est 100 et que les 100 derniers éventements ne concerne pas cet équipement, la plugin ne va pas les afficher.

Si vous souhaitez en afficher d’avantage, il faut créer une autre maison(Netatmo) et y déplacer les objet de votre choix.

Les webhooks ne remontent pas

• S’assurer que votre configuration est compatible avec les exigences Netatmo,
• Vérifier le statut de votre App netatmo,dev et que vous n’êtes pas BAN
• Synchroniser et vérifier les logs concernant les webhooks

layout: default title: Changelog netatmoSecurity lang: fr_FR pluginId: netatmoSecurity —

Changelog

Netatmo-Sécurité - Plugin pour Jeedom (Intégration des équipements NETATMO Sécurité).

• Installation du plugin Netatmo-Sécurité.
• Topic dedié au plugin Topic community.
• Documentation du plugin..

Liste des évolutions majeures de la version courante :

Liste non-exhaustive. Les changements mineurs et/ou corrections de bugs ne figurent pas forcément ici.

Version 15/11/2024

• Amélioration de la compatibilité PHP8
• Ajout de commandes Projecteur(On-Off-Auto) de type bouton pour une meilleure interopérabilité.
• Liaison de la commande ‘sensibilité Projecteur’ à une nouvelle commande info ‘Intensité’.
• Diverses améliorations …

Version 03/01/2024

• correction et améliorations des tuiles(dashboard, mobile)

Version 20/12/2023

• Installation de plugins
• Mise à jour de plugins