Skip to content

Latest commit

 

History

History
285 lines (240 loc) · 15.6 KB

FAQ.md

File metadata and controls

285 lines (240 loc) · 15.6 KB
Raw

FAQ




C'est bien beau ton truc mais mes compteurs sont en positifs, comment je fais ?

Avant tout pour savoir si les compteurs sont en négatif ou en positif il suffit de regarder sur l'interface web du MsunPv.

On se rend compte sur l'exemple ci-dessus que dans mon cas les compteurs sont en négatif (pas besoin de faire de modifications).

Si tous vos compteurs sont en positif, une première solution serait de passer vos compteurs en négatif par l'outil msapp_pv fournit sur le site Ard-tek pour paramétrer le MsunPv. Je propose cette solution car certains préfèrent voir les compteurs en négatif et dans ce cas c'est la façon de faire.

Sinon il faut modifier les lignes suivantes :

      - name: msunpv_eninj #Production injectée journalière
        unique_id: "msunpv_eninj"
        state: >-
          {% set cptVals =state_attr('sensor.msunpv_xml', 'cptVals')|replace(" ","") %}
          {{ (0 if cptVals.split(";")[1]|int(base=16)|int == 0 else ((0xFFFFFFFF - cptVals.split(";")[1]|int(base=16)) * -1)/10) |float }}
        unit_of_measurement: "Wh"
        device_class: energy

      - name: msunpv_enpv_j #Production panneaux journalière
        unique_id: "msunpv_enpv_j"
        state: >-
          {% set cptVals =state_attr('sensor.msunpv_xml', 'cptVals')|replace(" ","") %}
          {{ (0 if cptVals.split(";")[2]|int(base=16)|int == 0 else ((0xFFFFFFFF - cptVals.split(";")[2]|int(base=16)) * -1)/10) |float }}
        unit_of_measurement: "Wh"
        device_class: energy

      - name: msunpv_enpv_p #Production panneaux totale
        unique_id: "msunpv_enpv_p"
        state: >-
          {% set cptVals =state_attr('sensor.msunpv_xml', 'cptVals')|replace(" ","") %}
          {{ (0 if cptVals.split(";")[3]|int(base=16)|int == 0 else ((0xFFFFFFFF - cptVals.split(";")[3]|int(base=16)) * -1)/10) |float }}
        unit_of_measurement: "Wh"
        device_class: energy

Et les remplacer par celles-ci :

      - name: msunpv_eninj #Production injectée journalière
        unique_id: "msunpv_eninj"
        state: >-
          {% set cptVals =state_attr('sensor.msunpv_xml', 'cptVals')|replace(" ","") %}
          {{ cptVals.split(";")[1]|int(base=16)/10 |float }}
        unit_of_measurement: "Wh"
        device_class: energy

      - name: msunpv_enpv_j #Production panneaux journalière
        unique_id: "msunpv_enpv_j"
        state: >-
          {% set cptVals =state_attr('sensor.msunpv_xml', 'cptVals')|replace(" ","") %}
          {{ cptVals.split(";")[2]|int(base=16)/10 |float }}
        unit_of_measurement: "Wh"
        device_class: energy

      - name: msunpv_enpv_p #Production panneaux totale
        unique_id: "msunpv_enpv_p"
        state: >-
          {% set cptVals =state_attr('sensor.msunpv_xml', 'cptVals')|replace(" ","") %}
          {{ cptVals.split(";")[3]|int(base=16)/10 |float }}
        unit_of_measurement: "Wh"
        device_class: energy


De même pour les sensors du dashboard energy où il faut remplacer les lignes :

      - name: "energie_msunpv_enpv_j" #Production panneaux journalière
        unit_of_measurement: "kWh"
        state: "{{ (states('sensor.msunpv_enpv_j')|float /1000 *-1) }}"
        device_class: energy
        state_class: total_increasing

      - name: "energie_msunpv_eninj" #Production injectée journalière
        unit_of_measurement: "kWh"
        state: "{{ (states('sensor.msunpv_eninj')|float /1000 *-1) }}"
        device_class: energy
        state_class: total_increasing

Par :

      - name: "energie_msunpv_enpv_j" #Production panneaux journalière
        unit_of_measurement: "kWh"
        state: "{{ (states('sensor.msunpv_enpv_j')|float /1000) }}"
        device_class: energy
        state_class: total_increasing

      - name: "energie_msunpv_eninj" #Production injectée journalière
        unit_of_measurement: "kWh"
        state: "{{ (states('sensor.msunpv_eninj')|float /1000) }}"
        device_class: energy
        state_class: total_increasing

Attention, il est possible que le compteur (notamment sur les versions Projet MS_PV2_2c et Projet MS_PV4_4c) EnInj du MsunPv soit en négatif et les autres en positif comme sur la photo ci-dessous :

Dans ce cas là on ne modifiera pas les lignes concernant 'msunpv_eninj' et 'energie_msunpv_eninj'.



J'ai une sonde qui mesure la puissance du cumulus, comment je fais ?

De base sur une la version 2 entrées, 2 sorties la mesure pour le cumulus se fait en pourcentage, mais on peut très bien y adjoindre une pince de mesure pour exprimer cette entrée en W. Dans ce cas là, je remplace simplement la ligne :

      - name: msunpv_outbal #% routage cumulus
        unique_id: "msunpv_outbal"
        state: >-
          {{ (state_attr('sensor.msunpv_xml', 'inAns')|replace(" ","")|replace(",",".")).split(";")[2] |int }}
        unit_of_measurement: "%"

Par :

      - name: msunpv_outbal #puissance routage cumulus
        unique_id: "msunpv_outbal"
        state: >-
          {{ (state_attr('sensor.msunpv_xml', 'inAns')|replace(" ","")|replace(",",".")).split(";")[2] |float }}
        unit_of_measurement: "W"

L'unité de mesure devient W à la place de % et la valeur devient un nombre décimal et non plus un nombre entier (En ayant tout de même pris soin de faire la modif dans msapp_pv avant bien sur).

A l'inverse sur une version 4 entrées, 4 sorties de base la mesure s'exprime en W, mais si l'on à mis de pince de mesure sur celui, on peut très bien faire l'opération inverse (En ayant tout de même pris soin de faire la modif dans msapp_pv avant également).



Et si je veux faire apparaitre un capteur autre que ceux déjà présent, comment je fais ?

Pour savoir comment les rajouter il faut recupérer les fichiers 'http://IP_DU_MSUNPV/index.xml' et 'http://IP_DU_MSUNPV/status.xml' qui vont permettre de comprendre qu'est ce qu'il faut récupérer.

  • index.xml :
This XML file does not appear to have any style information associated with it. The document tree is shown below.
<xml>
      <paramSys>16:11:04;23/10/2023;On;01:00;0,0;MS_PV2_2b;5.0.1;0000220;104a;104a;00:00;00:00</paramSys>
      <typAns>PowReso;1;6:PowPV;1;6:OutBal;0;3:OutRad;0;3:VoltRes;1;4:T_Bal1;1;18:T_SDB;1;18:T_Amb;1;18:S9;0;0:S10;0;0:S11;0;0:S12;0;0:S13;0;0:S14;0;0:S15;0;0:S16;0;0:</typAns>
      <typouts>Cumulus;0;2:Sortie2;0;1:A3;0;0:A4;0;0:A5;0;0:A6;0;0:A7;0;0:A8;0;0:A9;0;0:A10;0;0:A11;0;0:A12;0;0:A13;0;0:A14;0;0:A15;0;0:A16;0;0:</typouts>
      <cmdM0>3;0;Comd Manu/Auto;ManuBal;AutoBal;ManuRad;AutoRad;</cmdM0>
      <cmdM1>0;0;Commande 2;Param1;Param2;Param3;Param4;</cmdM1>
      <cmdM2>0;0;Commande 3;Param1;Param2;Param3;Param4;</cmdM2>
      <cmdM3>0;0;Commande 4;Param1;Param2;Param3;Param4;</cmdM3>
      <cmdM4>0;0;Commande 5;Param1;Param2;Param3;Param4;</cmdM4>
      <cmdM5>0;0;Commande 6;Param1;Param2;Param3;Param4;</cmdM5>
      <cmdM6>0;0;Commande 7;Param1;Param2;Param3;Param4;</cmdM6>
      <cmdM7>1;2;Test routeur;Inject;Zero;Moyen;Fort;</cmdM7>
      <typCpt>EnConso;1;16:EnInj;1;16:EnPV_J;1;16:EnPV_P;1;16:Compt 5;0;0:Compt 6;0;0:Compt 7;0;0:Compt 8;0;0:</typCpt>
</xml>
  • statuts.xml :
This XML file does not appear to have any style information associated with it. The document tree is shown below.
<xml>
      <rtcc>16:12:45 LU</rtcc>
      <paramSys>16:12:46;23/10/2023;On;01:00;0,0;MS_PV2_2b;5.0.1;0000220;104a;104a;00:00;00:00</paramSys>
      <inAns>0,2;-609,5;44; 0;233,8;0,0;0,0;0,0; 0; 0; 0; 0; 0; 0; 0; 0;</inAns>
      <survMm>0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;</survMm>
      <cmdPos>0;0;0;0;0;0;0;2;</cmdPos>
      <outStat>10;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;</outStat>
      <cptVals>6333;fffffff6;ffff4e6a;fdd33e02;0;0;0;0;</cptVals>
      <chOutVal>0;0;0;ff;:0,0;0,0;0,0;0,0;</chOutVal>
</xml>

Et plus particulièrement ces lignes qui vont nous indiquer quelle est la position de chaque éléments dans le fichier 'status.xml' et donc pouvoir en extraire les bonnes valeurs :

      <typAns>PowReso;1;6:PowPV;1;6:OutBal;0;3:OutRad;0;3:VoltRes;1;4:T_Bal1;1;18:T_SDB;1;18:T_Amb;1;18:S9;0;0:S10;0;0:S11;0;0:S12;0;0:S13;0;0:S14;0;0:S15;0;0:S16;0;0:</typAns>
      <typCpt>EnConso;1;16:EnInj;1;16:EnPV_J;1;16:EnPV_P;1;16:Compt 5;0;0:Compt 6;0;0:Compt 7;0;0:Compt 8;0;0:</typCpt>

Qui une fois reduites aux infos qui nous interressent nous donne :

      <typAns>PowReso:PowPV:OutBal:OutRad:VoltRes:T_Bal1:T_SDB:T_Amb:S9:S10:S11:S12:S13:S14:S15:S16:</typAns>
      <typCpt>EnConso:EnInj:EnPV_J:EnPV_P:Compt 5:Compt 6:Compt 7:Compt 8:</typCpt>

On va présenter tout ça dans un tableau pour une meilleure lisibilité et rajouter les lignes contenant les valeurs à récupérer en fonction de la correspondance suivante :

index.xml <=> status.xml
typAns <=> inAns
typCpt <=> cptVals

'inAns' correspondant aux 'entrées' et 'cptVals' aux compteurs, ce qui nous donne ce tableau :

Position dans la liste 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
typAns PowReso PowPV OutBal OutRad VoltRes T_Bal1 T_SDB T_Amb S9 S10 S11 S12 S13 S14 S15 S16
inAns 0,2 -609,5 44 0 233,8 0 0 0 0 0 0 0 0 0 0 0
typCpt EnConso EnInj EnPV_J EnPV_P Compt_5 Compt_6 Compt_7 Compt_8
cptVals 6333 fffffff6 ffff4e6a fdd33e02 0 0 0 0

On sait donc maintenant que si je veux récupérer la valeur de 'Outbal' il faudra que je récupère la 3éme colonne du tableau.
De la même manière si je veux la valeur du compteur 'Compt 6' je récupère la 5éme colonne du tableau.


Et comment on traduit ça en sensor ?

Exemple de code pour récupérer la valeur de 'Compt 5' qui n'ai pas dans la version mSunPv2_2 de base et imaginons que cela corresponde au compteur de la pince qui mesure la puissance en W envoyée au cumulus chaque jour, le code à ajouter serait :

      - name: msunpv_energie_cumulus #Consommation cumulus journalière
        unique_id: "msunpv_energie_cumulus"
        state: >-
          {% set cptVals =state_attr('sensor.msunpv_xml', 'cptVals')|replace(" ","") %}
          {{ cptVals.split(";")[4]|int(base=16)/10 |float }}
        unit_of_measurement: "Wh"
        device_class: energy

La ligne ci dessous sert à mettre en forme la ligne 'cptVals' en supprimant les espaces inutiles.

          {% set cptVals =state_attr('sensor.msunpv_xml', 'cptVals')|replace(" ","") %}

La ligne ci dessous sert à récupérer la valeur et à la convertir.

          {{ cptVals.split(";")[4]|int(base=16)/10 |float }}

Le [4] correspond à la position dans la liste de la valeur que nous voulons récupérer, dans le tableau que nous avons créer. Le |int(base=16) assure la conversion de la valeur hexadecimale du compteur valeur en decimale. Les compteurs sont stockés en hexadecimal sur le MsunPv et du coup sans partie décimale.

Si je prends le compteur EnConso dans le tableau au dessus sa valeur hex est de 6333 qui une fois converti donne 25395.
Le /10 |float est pour récupérer la décimale de la valeur du compteur. Du coup l'exemple EnConso devient 2539,5 qui est la valeur affichée sur ma page web du MsunPv.


Si le compteur est en kWh :

      - name: msunpv_energie_cumulus #Consommation cumulus journalière
        unique_id: "msunpv_energie_cumulus"
        state: >-
          {% set cptVals =state_attr('sensor.msunpv_xml', 'cptVals')|replace(" ","") %}
          {{ cptVals.split(";")[4]|int(base=16)/10 |float }}
        unit_of_measurement: "kWh"
        device_class: energy


Et si le compteur est en Wh et que je veux ma valeur en kWh, je divise par 1000 et je fais un arrondi à 3 chiffre après la virgule :

      - name: msunpv_energie_cumulus #Consommation cumulus journalière
        unique_id: "msunpv_energie_cumulus"
        state: >-
          {% set cptVals =state_attr('sensor.msunpv_xml', 'cptVals')|replace(" ","") %}
          {{ (cptVals.split(";")[4]|int(base=16)/10 |float /1000)|round(3) }}
        unit_of_measurement: "kWh"
        device_class: energy

Pour le 'name' du sensor vous pouvez mettre ce que bon vous semble ainsi que pour son 'unique_id'. Il faut juste que 'unique_id' soit unique par contre.


L'information à retenir est :

  • Je crée un petit tableau pour savoir ce que je veux ajouter comme sensor
  • Si le sensor que je veux ajouter est du type 'entrées', je copie dans le 'yaml' un sensor de type 'entrées' et je le colle à la suite des autres sensors 'entrées' puis je modifie le chiffre entre crochets pour correspondre à celui que je souhaite ajouter. Je modifie également le nom, l'unique_id et l'unité de mesure.
  • Si le sensor que je veux ajouter est du type 'compteurs', je copie dans le 'yaml' un sensor de type 'compteurs' et je le colle à la suite des autres sensors 'compteurs' puis je modifie le chiffre entre crochets pour correspondre à celui que je souhaite ajouter. Je modifie également le nom, l'unique_id, le device_class et l'unité de mesure si besoin.

Rien de bien compliqué en somme



Je n'ai plus de MsunPv ou je souhaite repartir de zéro, comment je fais ?

Rien de plus simple, il suffit de supprimer le dossier 'msunpv' (ou tous les fichiers de l'intégration, si je n'ai pas ce dossier) présent dans le dossier 'packages'.



Commenter, décommenter rapidement des sections de code avec File éditor.

Pour commenter ou décommenter rapidement des sections de code dans les fichiers '.yaml' à l'aide du File éditor de Home Assistant, il existe une petite astuce bien pratique pour faire une selection verticale.

  • Je place mon curseur en tout début de la première ligne de code que je veux commenter (ou décommenter).
  • Je maintien appuyer les touches CTRL et ALT et j'appui sur la flèche BAS pour étendre ma selection jusqu'a la dernière ligne à commenter (ou décommenter).
  • Maintenant je peux appuyer sur # pour commenter toutes les lignes d'un coup (ou sur SUPPR pour décommenter).

Démonstration :



Retour au README.md