routage HC3 - table de routage Z-wave (suite)

[jluc2808 61]

bonjour ,

 

************************** Introduction ************************************

ceci est le 1er message du nouveau fil de discussion sur l'affichage liste et graphique de la table de routage z-wave sur HC3

l'ancien fil restera pour ce qui été publié jusqu'à la V6 et tout le reste à partir de cette version sera dans la suite de nouveau fil de discussion

 

Ce 1er post a pour objectif de reprendre l'ensemble des fonctionnalités, leur explication, la méthode d'installation et sera enrichi tout au long des évolutions et correctifs pour éviter d'avoir à se balader de post en post pour savoir ce qui a été fait .

 

ce Post 1 - sera maintenu et est découpé en sections pour plus de lisibilité.

 

************************* les programmes courants ***********************************

 

config.hc3 v1.6.php  ==> fichier template va permettre une fois copié et renommé de stocker vos données personnelles et vos options par défaut -

ATTENTION - Ce fichier doit être copié avec le nom My_confi.hc3.php , puis modifié pour mettre à jour vos données

NOTE - si l'installation est déjà en place, il faut modifier la version (6.x) dans My_config.hc3.php (si ce n'est pas fait alors le lanceur utilisera toujours l'ancien programme V6.x-1)

 

- correction des liens graphiques lorsque demande de noeud - &node=

z-wave_network_hc3_mod V6.4.php

 

entree_valeur_z-wave_network_hc3 v1.2.php   ==>  ce fichier est un lanceur (il va lancer le programme principal avec les options retenues), il a pour objectif de lister les options possibles et sélectionner celles qui vont être utilisées dans le programme principal . Il ne stocke rien .

- ajout de texte d'information dans les zones de saisies

 

 

************************ l'historique des évolutions *****************************

24/10/2023 z-wave_network_hc3_mod V6.4.php et config.hc3 v1.6.php ==> - correction des liens graphiques lorsque demande de noeud - &node=

16/10/2023 z-wave_network_hc3_mod V6.3.php  et config.hc3 v1.5.php  ==> correction des graphiques lorsque l'on demande un nœud (ou plusieurs) particulier

15/10/2023 z-wave_network_hc3_mod V6.2.php  et config.hc3 v1.4.php et  entree_valeur_z-wave_network_hc3 v1.2.php  ==> modification de l'argument &node qui maintenant va accepter plusieurs nœuds avec le séparateur ","  (&node=31,36,371) 

13/10/2023 z-wave_network_hc3_mod V6.1.php et config.hc3 v1.3.php ==> correction dans la partie graphique du nom de la pièce pour les nœuds intermédiaires dans les rebonds

11/10/2023 entree_valeur_z-wave_network_hc3 v1.1.php  ==> ajout d'une étape de validation et zone de texte

10/10/2023  entree_valeur_z-wave_network_hc3 v1.0.php et z-wave_network_hc3_mod V6.0.php  et    ==> ajout du lanceur, ajout du choix &fix=node/global, ajout de lignes de débug

08/10/2023 z-wave_network_hc3_mod V5.2.php  ==> stockage des données API, ajout du choix des rebonds, ajout de debug

07/10/2023 z-wave_network_hc3_mod V5.1.php  et  config.hc3.php ==> corrections de bugs, amélioration du rendu et ajout de la couleur grise pour le HC3 (changement de couleur possible)

06/10/2023 config.hc3.php  ==> éditez lr fichier de config pour personnaliser et le nommer My_config.hc3.php et z-wave_network_hc3_mod V5.php  ==> ajout du fichier config.php

05/10/2023 z-wave_network_hc3_mod V4.php  ==> ajout d'un fichier .ini pour stocker les données personnelles + option node et unique dans route- Pour des choix de sécurité la partie .ini ne sera pas conservée

04/10/2023 z-wave_network_hc3_mod V3.2.php   ==> ajout de l'argument &fix pour laisser le choix dynamique ou statique 

03/10/2023 z-wave_network_hc3_mod V3.1.php  ==>  permet de fixer le graphique et le modifier à volonté 

02/10/2023 z-wave_network_hc3_mod V3.php   ==> modifie la restitution des listes et supprime le passage par excel 

23/09/2023 z-wave_network_hc3_mod V2.php  ==> ajoute la sélection par pièce &room=cuisine,garage 

20/09/2023  z-wave_network_hc3_mod.php    ==> version initiale de l'ère JLB - ajoute la liste des liens et nécessite de passer par excel 

 

********************** les recommandations d'installations et mise à jour ****************

 

l'installation à plusieurs pré-requis

1. avoir un serveur web qui permet d’exécuter des programmes PHP
2. créer un répertoire dans le serveur Web pour y mettre tous les programmes (par la suite les données enregistrées issues de l'API - &enregistre

- installer tous les programmes et versions dans le même répertoire

- copier et nommer My_config.hc3.php le fichier qui sert de stockage ds données et options personnelles 

- utiliser le lanceur entree_valeur_z-wave_network_hc3.php pouir sélectionner les options désirées

- la syntaxe est :

http://IP_du_serveur_Web:Port_du_serveur_web/répertoire_des_programmes_php/entree_valeur_z-wave_network_hc3.php

ou si vous souhaitez lancer directement le PHP

http://IP_du_serveur_Web:Port_du_serveur_web/répertoire_des_programmes_php/z-wave_network_hc3_mod Vx.x.php?arg=x&arg2=y&arg3=z

 

les tests ont été fait avec une HC3 dernière version, navigateur Chrome, Firefox et Edge, serveur wen Synology PHP 7.3 apache 2.2

 

********************* les fonctionnalités et les explications de comment les utiliser ***********

le comportement par défaut:

- l'affichage est avec liste et graphique des liens

- comprend toutes les pièces

- intègre toutes les routes (directes et avec rebonds)

 

 

les options :

 

• display ou afficher ou affiche :  graph/graphique/dessin, table/liste, all/tout (par défaut)
• route ou lien ou navigation : direct, rebond, unique, all/tout/toute (par défaut)
• room ou piece: nom de la pièce sans "" et séparateur "," si plusieurs pièce s
• fix = node / global  (node = fixe avec des liens droits, global fixe avec des liens elliptiques)
• node = xx (xx est l'Id HC3)
• debug
• rebond = all/xx
• reuse pour réutilisé les données stockées du retour serveur
• &enregistre pour stocker les données (&reuse et &enregistre sont exclusifs donc ne peuvent être utilisés ensemble)

 

- display=graph ou table ou all

• all  ==> affiche la liste et le graphique
• graph  ou dessin ou graphique ==> affiche uniquement le graphique
• table ou liste ==> affiche uniquement la liste

- route=direct ou rebond ou all ou unique  

• all ==> restitue toutes les routes y compris les routes alternatives
• unique ==> ne prend que les routes les plus directes  (celles avec le moins de rebond)
• direct ==> restitue uniquement les nœuds en lien direct avec le contrôleur z-wave (route avec 0 rebond)
• rebond ==> restitue toutes les routes avec rebond(s)

- l'argument &node=xx , xx est l'ID HC3, il permet de lister et afficher toutes les routes dans lesquels cet Id HC3 est impliqué  (que ce soit dans les rebonds, en direct ou en final)

- l'argument &route, peux prendre les valeurs

• all ==> dans ce cas toutes les routes sont prises en compte, directes, rebonds, fin de course , il n'y a pas de dédoublonnage
• unique ==> ce cas permet de n'avoir que les routes principales (les plus courtes) vers les Id HC3 - il y a dédoublonnage et tri ascendant
• direct ==> va sélectionner que les Id qui sont en direct avec le contrôleur HC3 - dédoublonné (donc si il y a plusieurs route ou le module est en lien direct il ne sera affiché qu'une seule fois)
• rebond ==> prend tous les rebonds qui impliquent cet Id à l’exception des liens directs avec le contrôleur HC3 - il n'y a pas de dédoublonnage 

 

-  changement de couleur du contrôleur maitre (la HC3) ==> par défaut dans cette version il est en gris + un paramètre dans le fichier de config $HC3_color = "grey"

         vous pouvez mettre la couleur que vous voulez pour la représentation graphique du contrôleur HC3, soit le code Hexa (#70726E pour gris), soit rgb(R,B,V), soit rgba(R,B,V,I), soit une couleur (red, black, grey....)

         si vous ne changez rien à votre fichier config avec cette version 5.1 , la rétrocompatibilité est assuré et la couleur du contrôleur HC3 sera grise 

- &enregistre ==> va enregistrer (normalement dans le répertoire du programme PHP) 2 fichiers : donnees_devices.json et donnees_rooms.json

si ces fichiers existaient déjà, ils sont supprimés avant d'être recréés tout neufs

 

- &reuse ==> permet d'utiliser ces fichiers comme données d'entrée et ne fait plus appel à l'API tant que les fichiers existent et que la condition est dans les arguments de la commande

si les fichiers n'existent pas (supprimés, déplacés, pas encore générés, pbs de droits , ......) alors le programme va faire un appel API HC3 comme avant.

 

- &debug ==> ne pas utiliser sans une bonne raison, va tracer dans la fenêtre d'affichage plein de données afin de comprendre ce qui est utilisé.

 

- &rebond=x ==> reprend ce que j'avais spécifié plusieurs posts auparavant

•  &rebond=x  x étant le nombre de rebond que l'on veut exploiter, si on ne précise pas quelque chose dans &route alors on ne listera que les routes avec x rebond (fonction par défaut)
• - &route=direct ==> la valeur &rebond n'a pas de sens comme &rebond=0  c'est  &route=direct qui sera appliqué  
• - &route=unique&rebond=3 ==>  on ne listera que les id avec 3 rebonds si c'est le chemin le plus court pour l'Id 
• - &route=all&rebond=3 ==> toutes les routes jusque 3 rebonds 
• - &rebond=3 , équivalent à &route=rebond&rebond=3 ==> liste que les routes avec 3 rebonds 
•  si x=all /tout/tous alors ce sera comme &route=rebond

 

 

********************** les bugs ou restrictions connues ******************************

 

- les défauts d'affichage du graphique sont presque toujours liés à un problème de syntaxe dans les fichiers config (ou oublie du $ ; "" ' ou commentaires mal placés)

- erreurs de type " *** getDevices *** httpcode=0, devices= z-wave_network>ko , sont liées à un manque de données personnelles IP_HC3, ID ou Mdp HC3 dans le fichier My_config.hc3.php ou a un manque du fichier tout court

 

********************* les copies d'écran ******************************************

vision brute de la table de routage Z-wave

 

 

 

 

graphique avec remise en forme manuelle en utilisant l'argument &fix

 

 

graphique des liens par pièce en utilisant l'argument &room=cuisine

 

image de la restitution des listes

vision statique droite et elliptique  :

 

config.hc3 v1.2.php

config.hc3 v1.5.php

Modifié 24 octobre 2023 par jluc2808

[jluc2808 61]

reservé

[jluc2808 61]

reservé

[henri-allauch 217]

Beau travail mais au moment de mettre en ligne tu as du faire une dernière modification : 

 

Dans config.phpconfig.hc3 v1.2.php                   ->       tu déclare $Current_version = "V6.0";

Dans entree_valeur_z-wave_network_hc3.php    ->       tu utilise $Current_zwave_version

 

-> entree_valeur_z-wave_network_hc3.php        ->       dans le titre  la version n'est pas affichée puisque pas trouvée 

-> et le nom du php étant incomplet -> il ne peut pas être lancé   -> erreur

 

Une fois corrigé c'est bon 

 

Modifié 10 octobre 2023 par henri-allauch

[jluc2808 61]

Il y a 10 heures, henri-allauch a dit :

Beau travail mais au moment de mettre en ligne tu as du faire une dernière modification : 

 

Dans config.phpconfig.hc3 v1.2.php                   ->       tu déclare $Current_version = "V6.0";

Dans entree_valeur_z-wave_network_hc3.php    ->       tu utilise $Current_zwave_version

 

-> entree_valeur_z-wave_network_hc3.php        ->       dans le titre  la version n'est pas affichée puisque pas trouvée 

-> et le nom du php étant incomplet -> il ne peut pas être lancé   -> erreur

 

Une fois corrigé c'est bon 

 

oui effectivement c'est exactement ça qui s'est passé

j'ai corrigé et mis la bonne version en chargement

 

merci de ton retour

[jluc2808 61]

- modification du lanceur d'entrée pour ajouter une étape de validation des options sélectionnées

- ajout de texte dans les zones de saisies

entree_valeur_z-wave_network_hc3 v1.1.php

[jluc2808 61]

- correction dans la partie graphique du nom de la pièce pour les nœuds intermédiaires dans les rebonds 

- nettoyage du code

z-wave_network_hc3_mod V6.1.php

 

- ajustement de la version dans le template de config

config.hc3 v1.3.php

 

ATTENTION pour ceux pour lesquels l'installation est déjà en place, modifier la version dans My_config.hc3.php (si ce n'est pas fait alors le lanceur utilisera toujours l'ancien programme V6.0)

[jluc2808 61]

comme j'en ai eu besoin j'ai fait la modif

 

- modification de l'argument &node qui maintenant va accepter plusieurs nœuds avec le séparateur ","  (&node=31,36,371)

z-wave_network_hc3_mod V6.2.php

 

- ajustement de la version dans le template de config

config.hc3 v1.4.php

pour ceux avec l'installation déjà en place, modifier la version dans My_config.hc3.php  en V6.2 (si ce n'est pas fait alors le lanceur utilisera toujours l'ancien programme V6.0 ou V6.1)

 

- ajustement du lanceur dans la zone informative de texte 'node' (l'ancien lanceur V1.1 reste valide mais n'aura pas la zone d'info mise à jour)

entree_valeur_z-wave_network_hc3 v1.2.php

Modifié 15 octobre 2023 par jluc2808

[jluc2808 61]

- correction des graphiques lorsque l'on demande un nœud (ou plusieurs) particulier

z-wave_network_hc3_mod V6.3.php

 

- ajustement de la version dans le template de config

config.hc3 v1.5.php

pour ceux avec l'installation déjà en place, modifier la version dans My_config.hc3.php  en V6.3 (si ce n'est pas fait alors le lanceur utilisera toujours l'ancien programme V6.0 ou V6.1 ou V6.2)

[jluc2808 61]

- correction des liens graphiques lorsque demande de noeud - &node=

z-wave_network_hc3_mod V6.4.php

 

- template qui va avec

config.hc3 v1.6.php

pour ceux avec l'installation déjà en place, modifier la version dans My_config.hc3.php  en V6.4