Jeedom | Plugin Qivivo

Intégration du Thermostat Qivivo.

Qivivo - Plugin pour Jeedom

Lien market

Intégration du Thermostat Qivivo.

Pré-requis
Configuration
Utilisation
Actions
Programmes
Historique
Remarques
Changelog

Pré-requis

Ce plugin repose en partie sur l’API officielle Qivivo, vous devez donc créer un accès (gratuit) sur cette API, puis récupérer vos Client ID et Secret ID. account.qivivo.com

Configuration

Après installation, activez le plugin. Il apparaîtra alors dans le menu Plugins > Confort.

Configuration

Ceci aura pour effet d’installer votre thermostat, la passerelle (qui n’a ici aucune fonction), et vos modules fil-pilote, nommés par zone. Il ne vous reste qu’à rafraîchir la page du plugin (F5) !

Plugin

Utilisation

Renseignez pour chaque module, son nom et son Objet parent si nécessaire. Ils apparaîtront ainsi au bon endroit sur votre dashboard.

Dashboard

Voici un exemple sur le dashboard:

Dashboard

Vous pouvez ainsi visualiser:

Quand vous changez la consigne du thermostat, l’affichage change sur le dashboard. Toutefois, la commande info de consigne n’est volontairement pas mise à jour. En effet, les programmes temporaires ne sont pas pris en compte immédiatement par Qivivo, cela peu prendre entre 1 et 5mins. De cette façon, l’historique de la consigne enregistrera les vraies valeurs de consigne du thermostat et sera mise à jour lors de la prise en compte par celui-ci. Idéalement, il faudrait pouvoir savoir si un programme temporaire est en cours, mais l’API Qivivo ne remonte pas cette info. A voir dans le futur.

Vous pouvez également:

Vous pouvez bien sûr intégrer ces informations et actions dans des scénarios !

Actions

Le thermostat dispose de plusieurs actions que vous pouvez intégrer normalement dans Jeedom, dans les scénarios par exemple.

Actions du thermostat

La commande SetTempérature permet de lancer un programme temporaire, de la même manière que par le site Qivivo ou physiquement sur le thermostat. Le thermostat dispose dans Jeedom d’une info DuréeOrdre qui sera la durée du programme temporaire. Celle-ci se remet à 120mins (comme pour le thermostat physique) toutes les 15mins (ou 5mins si vous activez le cron5). Toutefois, si vous souhaitez spécifier une autre durée, lancer une commande SetDuréeOrdre avant la commande SetTempérature. Vous pouvez également annuler un programme temporaire avec la commande Annule_Ordre_Temp.

Les modules de zone disposent également de leurs actions SetMode pour changer d’ordre, et SetProgramme pour appliquer un programme que vous aurez créé auparavant.

Le module de la Zone Thermostat ne possède pas la commande SetMode puisqu’il est contrôlé par la consigne du thermostat.

Programmes

Programmes

Sur chaque module, y compris celui de la zone thermostat, vous trouverez un onglet Programmes. Vous pourrez y créer plusieurs programmes, pour pouvoir en changer, depuis le dashboard ou depuis un scénario.

Sur chaque jour, vous pouvez bien sûr créer des périodes de chauffe, mais aussi copier un jour entier pour le coller ailleurs, y compris sur un autre programme.

Une fois vos programmes créés et votre équipement sauvegardé, la liste de vos programmes apparaîtra sur la tuile de cette zone sur votre dashboard, et dans la liste proposée sur l’action SetProgramme dans vos scénarios.

Vous pouvez également exporter chaque programme (un fichier json correspondant sera créé dans plugins/qivivo/exportedPrograms), pour pouvoir ensuite l’importer dans un autre programme.

Équipements

Thermostat

Thermostat

Certaines informations sont visibles ici, notamment les réglages de température. Ce sont les mêmes que dans les réglages sur le site de Qivivo.

Module fil-pilote

Module chauffage

Le module fil-pilote possède une info Ordre affichant l’ordre courant sous forme lisible (string). Cette info n’est pas historisée, mais une autre info OrdreNum représente l’ordre sous forme de numéro de 1 à 6, et est historisée :

Historique

Comme pour toutes les commandes dans Jeedom, vous pouvez bien sûr consulter l’historique de celles-ci et ainsi avoir une synthèse quotidienne, que Qivivo ne propose plus aux nouveaux clients depuis plus d’un an.

Historique

Les commandes suivantes sont créées par défaut sans mode de lissage, en conservant les valeurs pendant 1an:

  • Thermostat Consigne
  • Thermostat Temperature
  • Thermostat Humidité
  • Thermostat Presence
  • Thermostat Chauffe
  • Module Chauffage OrdreNum

Vous pouvez également ajouter un Graphique sur un Design pour avoir la synthèse pré-configurée. Une fois le graphique créé sur le design, faites un clic droit dessus puis Configuration avancée pour choisir vos courbes et paramètres.

Exemple: Paramètres historique

Vous pouvez bien sûr y ajouter d’autres courbes d’autres capteurs de températures, etc.

Remarques

Fonctionnement

Le but à terme est de basculer entièrement sur l’API officielle, quand celle-ci proposera l’ensemble des fonctions dont le plugin a besoin.

Gestion des erreurs

Il peux arriver que les serveurs de Qivivo ne répondent pas:

Lors d’un rafraîchissement des informations, si l’appel à l’API Qivivo échoue trois fois de suite, un log d’erreur sera créé.

Lorsque vous passez une commande (une action), par le dashboard ou un scénario, un échec peut-être très embêtant. Si vous quittez la maison pendant une semaine et qu’un scénario passe votre Qivivo en programme absence, le risque est que le chauffage reste allumé toute la semaine.

Dans ce cas, vous avez deux possibilités, dans la configuration du plugin:

Auto actualisation

Dans la page de configuration, onglet Fonctionnalités, l’option cron15 est activée par défaut. Ceci permet d’actualiser toutes les infos des modules et du thermostat toutes les 15 mins. Au regard de la réactivité du chauffage, c’est suffisant. Toutefois, l’actualisation des données sur les serveurs Qivivo se faisant toutes les 5 minutes, vous pouvez si vous le souhaitez passer le cron à 5 mins.

Eté / Hiver

A l’arrêt du chauffage, vous pouvez basculer le plugin en cron15 (voir même désactiver les cron) par un scénario, avec un bloc code:

config::save('functionality::cron5::enable', 0, 'qivivo');
config::save('functionality::cron15::enable', 1, 'qivivo');

Personnellement, j’ai un programme Off sur chaque zone, en Arrêt et Hors-Gel. Avec un Mode je passe la maison en Travail, Vacances ou Absence, qui ajuste le programme de chauffage en fonction. J’ai ensuite deux variables pour les dates de début et fin de chauffage, et en fonction, un scénario change le programme en Off, change le cron du plugin, et affiche ou masque les équipements sur le dashboard.

Debug

Si vous rencontrez des problèmes, l’équipement passerelle possède une commande debug. Vous pouvez cliquer sur Tester, ce qui générera un log qivivo_debug. Vous pouvez l’envoyer à kiboost->free.fr (ou mp sur le forum Jeedom) avec:

Changelog

Voir la page dédiée.