Plugin PoeleAgua

Ce plugin sert à communiquer avec les poêles à bois et/ou granulé communiquant sur la base du system AGUA IOT.

Il se base sur le travail de fredericvl avec le script python py-agua-iot Ce plugin permet l’intégration des poêles connectés par la plateforme AGUA IOT de Micronova dans Jeedom

Attention ce plugin n’a pas été testé avec tous les poêles. , il n’y a donc aucune garantie que cela fonctionnera avec le vôtre.

Post forum listant des modéles testés post forum Liste des matériels compatible

Configuration

Pour utiliser le plugin, vous devez configurer les informations suivantes :

Api URL, Login URL , Customer Code , Marque , brandName, Version

Vous devez renseigner tout d’abord l’adresse de la plateforme Agua IOT de votre fabricant, l’url de login si necessaire (ex piazzetta) (sinon laisser vide) et le Customer Code correspondant, la marque, le brandName si necessaire, et la version en vous référent au tableau si aprés.

texte coloré en vert sur fond bleu

UUID

UUID aléatoire (vous pouvez générer un nouvel UUID automatiquement via ce site par exemple : https://www.uuidgenerator.net/version4)

Login sur l’app

Login sur l’app (l’e-mail que vous utilisez sur l’application mobile Android ou iOS)

Mot de passe sur l’app

Mot de passe de votre compte que vous utilisez sur l’application mobile Android ou iOS

Port de communication Jeedom

Renseigner un port de libre pour la communication avec jeedom (par exemple 3131, 3130, 4576, etc., évitez 80, 443, et autres ports utilisés par d’autres services déjà installés sur votre Jeedom)

Port de communication Jeedom

Renseigner un port de libre pour la communication avec jeedom (par exemple 3131, 3130, 4576, etc., évitez 80, 443, et autres ports utilisés par d’autres services déjà installés sur votre Jeedom)

Mode expert

Le mode expert permet d’ajouter des retour d’état et commandes spécifiques à chaque marque et modèle de poêle.

Attention : certaines commandes, si mal paramétrées, peuvent altérer le fonctionnement de votre poêle. Il est impératif de se référer à la documentation de votre équipement et de comprendre les différentes options et paramètres de votre poêle préalablement à toute intervention dans le plugin Poêle Agua IOT.

Bonnes pratiques :

Il est vivement conseillé de ne créer dans un premier temps que les retours d’états souhaités et d’en avoir l’historique (‘Historiser’ coché). Faire les tests de commande avec l’application Android ou Apple dédiée à côté de l’équipement et s’assurer que le changement d’état dans le plugin correspond bien à la commande désirée et modifie bien le comportement du poêle. Créer ensuite les commandes dans le plugin. Faire les tests de commande avec le plugin à côté de l’équipement et s’assurer que le changement d’état dans l’application Android ou Apple dédiée correspond bien à la commande désirée et modifie bien le comportement du poêle. Si un retour d’état ou une commande n’est pas disponible dans l’application Android ou Apple dédiée, elle ne le sera pas non plus dans le plugin !

Identification des retours d’états et commandes disponibles :

Récupérer le log PoeleAgua en mode debug après avoir redémarré le Démon.

Dans [update_device_registers_mapping –> REGISTERS MAP] identifier le retour d’état ou la commande qui doit être ajoutée.

Exemple :

'vent_front_get': {'reg_type': 'GET', 'offset': 32897, 'formula': '#', 'formula_inverse': '#', 'format_string': '{0}', 'set_min': 0, 'set_max': 3, 'mask': 65535, 'value_off': 3} 

‘Vent_front_get’ est le retour d’état de la consigne de puissance du ventilateur. ‘reg_type’: ‘GET’ signifie qu’il s’agit d’un retour d’état (GET) ‘offset’: 32897 désigne l’adresse à laquelle l’état ou la commande est assignée (important pour la suite). ‘set_min’ : 0, ‘set_max’ : 3, […], ‘value_off’ : 3 signifie qu’il y a quatre état possible de 0 à 3 et que trois signifie ‘éteint’.

'vent_front_set': {'reg_type': 'SET', 'offset': 32897, 'formula': '#', 'formula_inverse': '#', 'format_string': '{0}', 'set_min': 0, 'set_max': 3, 'mask': 65535, 'value_off': 3} 

‘Vent_front_set’ est la commande de la consigne de puissance du ventilateur. ‘reg_type’: ‘SET’ signifie qu’il s’agit d’une commande (SET) ‘offset’: 32897 a la même adresse que le retour d’état. ‘set_min’ : 0, ‘set_max’ : 3, […], ‘value_off’ : 3 est identique au retour d’état.

Dans [update_device_information–> INFORMATION MAP:] identifier la valeur d’un retour d’état offset

Dans cet exemple :

32897: 2 

La valeur retournée dans le plugin pour l’offset 32897 (puissance de ventilateur dans notre exemple) sera 2. Note : dans ce cas précis, l’application Android ou Apple dédiée renvoie une valeur de 3 car 0=1, 1=2, 2=3 et 3=Off. 

Ajouter un retour d’état :

Après avoir sélectionné votre poêle dans le plugin, aller dans la section commandes et cliquer en haut à droite sur ‘ajouter une commande’.

Nom de la commande = le nom que vous souhaitez voir s’afficher dans le plugin. Dans cet exemple : Puissance ventilateur Commande = i_ + le retour d’état de votre poêle identifié précédemment que vous voulez voir. Dans notre exemple :

i_vent_front_get 

Info = retour d’état. Numérique = Retour numérique Cliquer sur ‘Historiser’ N’oubliez pas de sauvegarder !

Ajouter une commande :

Après avoir sélectionné votre poêle dans le plugin, aller dans la section commandes et cliquer en haut à droite sur ‘ajouter une commande’.

Nom de la commande = le nom que vous souhaitez voir s’afficher dans le plugin. Par exemple : Réglage ventilateur Commande = le retour d’état de votre poêle identifié précédemment que vous voulez voir, sans le préfixe i_. Dans cet exemple :

vent_front_set

Info = basculer sur ‘action’.

Aucune = sélectionner dans le menu déroulant la commande info liée. Dans cet exemple : Puissance ventilateur. Défaut = Basculer vers ‘Curseur N’oubliez pas de sauvegarder !

FAQ

Certificats

Avec certaines plateformes, vous pouvez renconter des difficultés à vous connecter sur le serveur du fabricant (ex : mcz) à cause du certificat utilisé pour le https. Pour corriger ce problème, sur remote-mcz par exemple:

• Récupérer le certificat (remote-mcz-it-chain.pem) du site (à partir de votre navigateur web, par exemple :

  -----BEGIN CERTIFICATE-----
  MIIGujCCBaKgAwIBAgIQCu86AermVJHmCGKh0S0GrjANBgkqhkiG9w0BAQsFADBN
  MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMScwJQYDVQQDEx5E
  aWdpQ2VydCBTSEEyIFNlY3VyZSBTZXJ2ZXIgQ0EwHhcNMjAwNjAzMDAwMDAwWhcN
  MjIwNjA4MTIwMDAwWjB4MQswCQYDVQQGEwJJVDEeMBwGA1UECBMVRnJpdWxpIFZl
  bmV6aWEgR2l1bGlhMRYwFAYDVQQHEw1Gb250YW5hZnJlZGRhMRkwFwYDVQQKExBN
  Q1ogR1JPVVAgUy5wLkEuMRYwFAYDVQQDEw1yZW1vdGUubWN6Lml0MIIBIjANBgkq
  hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA7WKFHvKtmcCIT+DJXTdmYoLDP6glGqEh
  dVU95C8XpjQJGd08b+J4p+s1ERLyyigF9RNgQjTJ/ehUyfSmLNOuszplcq7VTgsd
  /i2+0AhtiyIgRdRjt7fODm/AC4pj74tPunBnt01JnQLRzelFleRQMu3iKnj4ctR7
  KQO4nY2S0JHt6JpLvgALEN2zF2+pJiw+O6t8hANNJKI3KdVK5Cq2KDk7yMyEsvxR
  4ns6lkwIR1moaAt6cUkULg+v5SgKhBFT4eQhqoY5HmnC4R0+RlLPNGhNXi6cUFM5
  VxxD09gBMmTEkjSUz7b0h65LES3MW5U5GP4ihlaTBdRNGPcGpPYFewIDAQABo4ID
  aTCCA2UwHwYDVR0jBBgwFoAUD4BhHIIxYdUvKOeNRji0LOHG2eIwHQYDVR0OBBYE
  FJ+zPMkkxAeoVuCFOUCp3IAAX7s5MCsGA1UdEQQkMCKCDXJlbW90ZS5tY3ouaXSC
  EXd3dy5yZW1vdGUubWN6Lml0MA4GA1UdDwEB/wQEAwIFoDAdBgNVHSUEFjAUBggr
  BgEFBQcDAQYIKwYBBQUHAwIwawYDVR0fBGQwYjAvoC2gK4YpaHR0cDovL2NybDMu
  ZGlnaWNlcnQuY29tL3NzY2Etc2hhMi1nNi5jcmwwL6AtoCuGKWh0dHA6Ly9jcmw0
  LmRpZ2ljZXJ0LmNvbS9zc2NhLXNoYTItZzYuY3JsMEwGA1UdIARFMEMwNwYJYIZI
  AYb9bAEBMCowKAYIKwYBBQUHAgEWHGh0dHBzOi8vd3d3LmRpZ2ljZXJ0LmNvbS9D
  UFMwCAYGZ4EMAQICMHwGCCsGAQUFBwEBBHAwbjAkBggrBgEFBQcwAYYYaHR0cDov
  L29jc3AuZGlnaWNlcnQuY29tMEYGCCsGAQUFBzAChjpodHRwOi8vY2FjZXJ0cy5k
  aWdpY2VydC5jb20vRGlnaUNlcnRTSEEyU2VjdXJlU2VydmVyQ0EuY3J0MAwGA1Ud
  EwEB/wQCMAAwggF+BgorBgEEAdZ5AgQCBIIBbgSCAWoBaAB2ACl5vvCeOTkh8FZz
  n2Old+W+V32cYAr4+U1dJlwlXceEAAABcnpRVP4AAAQDAEcwRQIgBzrv+Vk+eBMS
  ji/TZdBL51eSwrPq67SOnUzya4Zl1aUCIQCDgBayJJxmKvFjhtQnGUe8/hoHC+rs
  pRDADT6lU3j6nAB2ACJFRQdZVSRWlj+hL/H3bYbgIyZjrcBLf13Gg1xu4g8CAAAB
  cnpRVS8AAAQDAEcwRQIgeCB/PwDSA68xE0MomkXyG7yBOJ9aXNr+bAbzEx6/WFsC
  IQD3i5F/kW/RkkIxY69aElspCtPLLwlK280ONsVQrnK9aQB2AFGjsPX9AXmcVm24
  N3iPDKR6zBsny/eeiEKaDf7UiwXlAAABcnpRVXkAAAQDAEcwRQIhAM/SHmuqvkA9
  Fy0frQUn1vwn74MxMCqE23nUq6dlWm4DAiBzfERRSZi8nvHX52zyEmcR5uUD83rn
  PvFttJdjhIISzjANBgkqhkiG9w0BAQsFAAOCAQEAAPMKwBwRGLA7x8b/NG2/C9Bj
  JDTRXk+CAaOMh0+cjxvffEW4ehFFGasaUR4iHYTCU+KcA2Dr4c/uphHtnV8ajMBD
  RL9xG5JHDlyUCX5mDw/tk9SueU8d1PmNzPfhdPRfhp2VRtUWRLG8U7GWPkQsi/NS
  nHUoxi76FFtnlhDCghmYTvOMNNj3fEyWMYZdmR9JI1VTXuNe3R/WhasyYljKHmqc
  AgydMsiJPv7QGlvIDxeD3iVZcZ6ARgoX+JTEhHPLPdDHmtPMnua5YToJdjH5GrLE
  RI3kPIe0zku25r5RuUJUmbZ95X8H+geZGfxiDj//vASRcatN02p+eesdmvhvNg==
  -----END CERTIFICATE-----
  -----BEGIN CERTIFICATE-----
  MIIElDCCA3ygAwIBAgIQAf2j627KdciIQ4tyS8+8kTANBgkqhkiG9w0BAQsFADBh
  MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
  d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD
  QTAeFw0xMzAzMDgxMjAwMDBaFw0yMzAzMDgxMjAwMDBaME0xCzAJBgNVBAYTAlVT
  MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxJzAlBgNVBAMTHkRpZ2lDZXJ0IFNIQTIg
  U2VjdXJlIFNlcnZlciBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
  ANyuWJBNwcQwFZA1W248ghX1LFy949v/cUP6ZCWA1O4Yok3wZtAKc24RmDYXZK83
  nf36QYSvx6+M/hpzTc8zl5CilodTgyu5pnVILR1WN3vaMTIa16yrBvSqXUu3R0bd
  KpPDkC55gIDvEwRqFDu1m5K+wgdlTvza/P96rtxcflUxDOg5B6TXvi/TC2rSsd9f
  /ld0Uzs1gN2ujkSYs58O09rg1/RrKatEp0tYhG2SS4HD2nOLEpdIkARFdRrdNzGX
  kujNVA075ME/OV4uuPNcfhCOhkEAjUVmR7ChZc6gqikJTvOX6+guqw9ypzAO+sf0
  /RR3w6RbKFfCs/mC/bdFWJsCAwEAAaOCAVowggFWMBIGA1UdEwEB/wQIMAYBAf8C
  AQAwDgYDVR0PAQH/BAQDAgGGMDQGCCsGAQUFBwEBBCgwJjAkBggrBgEFBQcwAYYY
  aHR0cDovL29jc3AuZGlnaWNlcnQuY29tMHsGA1UdHwR0MHIwN6A1oDOGMWh0dHA6
  Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEdsb2JhbFJvb3RDQS5jcmwwN6A1
  oDOGMWh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEdsb2JhbFJvb3RD
  QS5jcmwwPQYDVR0gBDYwNDAyBgRVHSAAMCowKAYIKwYBBQUHAgEWHGh0dHBzOi8v
  d3d3LmRpZ2ljZXJ0LmNvbS9DUFMwHQYDVR0OBBYEFA+AYRyCMWHVLyjnjUY4tCzh
  xtniMB8GA1UdIwQYMBaAFAPeUDVW0Uy7ZvCj4hsbw5eyPdFVMA0GCSqGSIb3DQEB
  CwUAA4IBAQAjPt9L0jFCpbZ+QlwaRMxp0Wi0XUvgBCFsS+JtzLHgl4+mUwnNqipl
  5TlPHoOlblyYoiQm5vuh7ZPHLgLGTUq/sELfeNqzqPlt/yGFUzZgTHbO7Djc1lGA
  8MXW5dRNJ2Srm8c+cftIl7gzbckTB+6WohsYFfZcTEDts8Ls/3HB40f/1LkAtDdC
  2iDJ6m6K7hQGrn2iWZiIqBtvLfTyyRRfJs8sjX7tN8Cp1Tm5gr8ZDOo0rwAhaPit
  c+LJMto4JQtV05od8GiG7S5BNO98pVAdvzr508EIDObtHopYJeS4d60tbvVS3bR0
  j6tJLp07kzQoH3jOlOrHvdPJbRzeXDLz
  -----END CERTIFICATE-----
  -----BEGIN CERTIFICATE-----
  MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh
  MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
  d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD
  QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT
  MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j
  b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG
  9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB
  CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97
  nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt
  43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P
  T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4
  gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO
  BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR
  TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw
  DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr
  hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg
  06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF
  PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls
  YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk
  CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4=
  -----END CERTIFICATE-----
  

• Renommer le certificat remote-mcz-it-chain.pem en remote-mcz-it-chain.crt
• Copier le dans le dossier /usr/share/ca-certificates de votre serveur Jeedom
• Lancer la commande sudo dpkg-reconfigure ca-certificates
• Dans la fenêtre, sélectionner votre certificat

Merci à kaz6531 pour l’aide à la rédaction de cette notice:wink: et à DjBlues pour la rédaction du mode expert.:wink: