Labomedia Ressources

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Objectifs ======

Dans le cadre d'un réseau MESH couplé à Node-Red, la mise à jour des flows après scrutation du réseau MESH afin de créer les éléments nécessaires est envisagée.
  
L'idée de modifier dynamiquement les flows est apparue, mais il est techniquement, à ma connaissance pas possible de l'envisager.

Une alternative est possible, qui n'automatise pas tout, mais assure une grosse partie du travail.

====== Procédure ======

  * Un ensemble de **flows de base** crées dans l'éditeur Node-Red qui servent de cadre à notre projet.
  * un SubFlows spécifique pour chaque type d'élément du MESH. Ces subflows seront exportés puis modifiés pour l'usage dans un script python.


  * un script doit permettre d'assurer les opérations suivantes dans le cadre d'une mise à jour du jeu de **flows de base** 
     - la copie du flow*.json depuis le répertoire .node-red
     - la scrutation du MESH via le protocole MQTT pour récupérer la liste des nœuds identifier le type de carte pour chaque noeud.
     - la création des subflows nécessaires pour les nouveaux noeuds et leur intégration dans les **flows de base** et production du nouveau fichier Json.
     - la mise à jour de la liste des nœuds du MESH pris en charge par le jeu de **flows de base**.
 
**ATTENTION :** Node-red ne pouvant pas être modifié en route, il est pour le moment impossible de recharger ces flows automatiquement. Ceci impose les manipulations suivantes pour sa mise à jour.
  - Dans l'éditeur Node-red, importer le nouveau json.
  - supprimer les flows antérieurs liés au MESH
  - déployer l'ensemble.

====== Quelques précisions sur la structure d'un flow Node-Red ======

Tous les éléments sont identifiés par un **id unique** puis des liens entre les éléments sont fait via ces **id**. Il en va de même pour les subflows, dont les id des éléments doivent être uniques.

L'affectation des objets dans l'interface utilisateur se fait via la des groupes {"type": "ui_group",} eux mêmes affectés à une page via l'ID de la page.

L'usage d'un subflow nécessite deux parties :
  * Le subflow et sa définition.
  * Le noeud dans le flow qui pointe sur le subflow.

Prochainement une illustration sur la structure d'un subflow.

====== Principe général du script ======


Le script python doit à partir du jeu de **flows de base** effectuer ceci :
  - trouver les id des tous les éléments actuels, afin de ne introduire les mêmes par la suite.
  - pour chaque noeud 
      - récupère les id des élements dans le json d'origine indispensables {id des pages de l'ui, de la page de l'éditeur)
      - créer , à partir d'un subflow générique le subflow et le nœud du flow nécessaire et la modification du flow général si besoin. 
  - l'adjonction de ces éléments dans le json général.
  - la sauvegarde de l'ensemble.

Pour la création du subflow et de son nœud, la procédure est la suivante :
  - dans Node-Red créer le subflow qui convient pour un type de carte puis l'exporter. Cet export sera modifié, pour le rendre générique pour le script en remplaçant tous les id qui doivent être modifiés par un code entre deux # exemple #IDE_UI_TAB_CONFIGURATION#. 

<code>
{
        "id": "#IDE_NOEUD_CARTE_RELAIS2#",
        "type": "subflow:#ID_SUBFLOW#",
        "z": "#IDE_TAB_CONTROLE#",
        "name": "#IDE_NOEUD_MESH#",
        "env": [],
        "x": "#POS_X#",
        "y": "#POS_Y#",
        "wires": []
    },
{
</code>
la portion de subflow générique pour introduire le nœud sur le subflow. 

<code>
{
        "id": "#ID_SUBFLOW#", 
        "type": "subflow",
        "name": "RELAIS2",
        "info": "",
        "in": [
            {
                "x": 40,
                "y": 80,
                "wires": [
						{
                        "id": "#ID_ENTREE1#"
                    },
                    {
                        "id": "#ID_ENTREE2#"
                    },
                    {
                        "id": "#ID_ENTREE3#"
                    }
                    
                ]
            }
        ],
        "out": []
    },
</code>
la définition du subflow, avec les indication de raccordement du noeud d'entrée du subflow sur les éléments internes.

<code>
{
        "id": "#ID_ELEMENT4#",
        "type": "ui_button",
        "z": "#ID_SUBFLOW#",
        "name": "ETAT VOYANT 2",
        "group": "#ID_GROUPE_CONTROLE#",
        "order": 2,
        "width": 1,
        "height": 1,
        "passthru": false,
        "label": "{{msg.state2}}",
        "tooltip": "",
        "color": "",
        "bgcolor": "{{msg.background2}}",
        "icon": "",
        "payload": "",
        "payloadType": "str",
        "topic": "",
        "x": 720,
        "y": 540,
        "wires": [
            []
        ]
    },
</code>

Un élément du subflow qui doit apparaître dans l'interface utilisateur via un groupe dont l'id est #ID_GROUPE_CONTROLE#

<code>
{
	"id": "#ID_GROUPE_CONTROLE#", 
        "type": "ui_group",
        "z": "",
        "name": "#IDE_NOEUD_MESH#",
        "tab": "#IDE_UITAB_CONTROLE#",
        "disp": "true",
        "width": "6",
        "collapse": "true"
		},
</code>

le groupe de contrôle qui apparaît dans la page de l'interface utilisateur  #IDE_UITAB_CONTROLE#

  - Après chargement du json générique sous forme d'une chaîne de caractères, une expression régulière permet de trouver les éléments à modifier puis de les remplacer avant réinjection dans le json principal.

   ATTENTION : Cette étape de production du json générique est fondamentale, il est indispensable de bien décortiquer comment il est constitué. En effet dans un subflow, certains élements {id} sont interne au subflow, d'autres sont liés à l'extérieur.
Exemple : l'id du subflow doit être connue pour la création du nœud dans le flow. Alors que les id des éléments du subflow peuvent rester inconnus du reste.
   C'est pourquoi j'ai choisi de NOTER #IDE_XXX" les id extérieurs au flow et ID ceux internes au flow.



{{tag>nodejs node-red développement mqtt iOT bj}}