Files

T

cadjou 1b92e78b34 Correction README.md

2026-06-26 03:04:56 +02:00

7.4 KiB

Raw Blame History

EditOffsetCLI — Modification de la consigne relative des BLE Device (Multi-capteur/Unitouch) en masse

Outil de configuration automatique de la plage de réglage de consigne relative des BLE Device (Multi-capteur/Unitouch) sur automates Distech Controls Eclypse.

IMPORTANT : Ce projet est un développement personnel indépendant.

Ce projet a été développé par Charles-Arthur DAVID à titre personnel. Distech Controls n'est pas responsable de ce projet et ne le supporte pas. Aucune demande de support ne sera prise en charge par Distech Controls. Distech Controls ne fournit aucune garantie ni assistance technique pour ce projet.

Prérequis

Windows 10 ou Windows 11
Automates Distech Controls ECY Facilities (V2)
Être connecté au même réseau que les automates (réseau local ou VPN)
Avoir les identifiants de connexion aux automates (nom d'utilisateur et mot de passe)

Aucune installation de logiciel supplémentaire n'est nécessaire.

Contenu du dossier

EditOffsetCLI.ps1   ← script principal (fichier unique à exécuter)
votre_liste.csv     ← export XNU ou fichier CSV de votre choix (voir ci-dessous)

Étape 1 — Débloquer le script (première utilisation uniquement)

Windows bloque par sécurité les fichiers téléchargés depuis internet. Cette étape n'est à faire qu'une seule fois.

Faites un clic droit sur le fichier EditOffsetCLI.ps1
Cliquez sur Propriétés
En bas de la fenêtre, cochez la case Débloquer
Cliquez sur OK

Si vous ne voyez pas la case "Débloquer", le fichier est déjà autorisé, passez à l'étape suivante.

Étape 2 — Préparer la liste des automates (fichier CSV)

Option A — Utiliser un export XpressNetwork Utility (recommandé)

Si vous disposez de XpressNetwork Utility, exportez directement votre liste d'automates en CSV : le fichier est utilisable tel quel sans modification.

Option B — Créer le fichier manuellement

Créez un fichier texte nommé automates.csv dans le même dossier que le script.

Ouvrez-le avec le Bloc-notes (pas Excel) et collez ce contenu en adaptant vos données :

Hostname;Current Ip
Automate-Bureau-101;192.168.1.10
Automate-Bureau-102;192.168.1.11
Automate-Salle-Conf;192.168.1.12

Détail des colonnes

Colonne	Obligatoire	Description	Exemple
`Current Ip`	✅	Adresse IP de l'automate	`192.168.1.10`
`Hostname`	❌	Nom libre pour identifier l'automate dans les logs	`Automate-Bureau-101`
`Username`	❌	Identifiant si différent du paramètre `-Username`	`technicien`
`Password`	❌	Mot de passe si différent du paramètre `-Password`	`motdepasse`

Les automates ECY Facilities V2 communiquent toujours en HTTPS — le script le gère automatiquement.

Identifiants différents par automate (optionnel)

Si certains automates ont des identifiants différents, ajoutez les colonnes Username et Password :

Hostname;Current Ip;Username;Password
Automate-Bureau-101;192.168.1.10;admin;motdepasse1
Automate-Bureau-102;192.168.1.11;technicien;motdepasse2

Étape 3 — Ouvrir PowerShell dans le bon dossier

Ouvrez l'Explorateur de fichiers et naviguez jusqu'au dossier contenant EditOffsetCLI.ps1
Cliquez dans la barre d'adresse en haut (là où est affiché le chemin du dossier)
Tapez powershell puis appuyez sur Entrée

Une fenêtre PowerShell s'ouvre directement dans le bon dossier.

Étape 4 — Lancer le script

Dans la fenêtre PowerShell, tapez la commande suivante en remplaçant 3 par la valeur d'offset souhaitée :

.\EditOffsetCLI.ps1 -CsvInput ".\automates.csv" -Offset 3

Avec identifiants (si tous les automates ont le même mot de passe)

.\EditOffsetCLI.ps1 -CsvInput ".\automates.csv" -Offset 3 -Username "admin" -Password "votre_mot_de_passe"

Paramètres disponibles

Paramètre	Obligatoire	Description
`-CsvInput`	✅	Chemin vers votre fichier CSV
`-Offset`	✅	Valeur de l'offset (ex: `3` → plage de -3 à +3°C)
`-Username`	❌	Identifiant API (défaut : `admin`)
`-Password`	❌	Mot de passe API (défaut : vide)
`-UpdateGfx`	❌	Modifier aussi le fichier GFx de l'automate (interface graphique)

Que fait l'offset ? Si vous entrez -Offset 3, le script configure :

Limite haute : +3°C

Limite basse : -3°C

Consigne relative : 3°C

Avec mise à jour du fichier GFx (interface graphique)

Pour synchroniser aussi les limites dans l'interface graphique de l'automate, ajoutez -UpdateGfx :

.\EditOffsetCLI.ps1 -CsvInput ".\automates.csv" -Offset 3 -UpdateGfx

Sans -UpdateGfx, seule la configuration BLE est modifiée. Recommandé de tester sans -UpdateGfx d'abord.

Étape 5 — Suivre l'exécution

Pendant l'exécution, le script affiche les opérations en temps réel avec des couleurs :

Couleur	Signification
🔵 Cyan	Information (opération en cours)
🟢 Vert	Succès
🟡 Jaune	Avertissement (automate ignoré, port invalide…)
🔴 Rouge	Erreur

À la fin, un résumé s'affiche :

[RESUME]
Automates traites           : 5
Automates en erreur         : 0
Local-values mises a jour   : 10
Configurations mises a jour : 5
GFx mis a jour              : 5
Duree totale                : 00:00:12.34

Fichier journal (log)

Un fichier de log est créé automatiquement dans le même dossier, nommé :

editoffset_2026-06-24_14h30.log

Ce fichier contient l'historique complet de toutes les opérations effectuées. En cas de problème, transmettez ce fichier à votre référent technique.

Problèmes courants

❌ "L'exécution de scripts est désactivée sur ce système"

Windows bloque l'exécution des scripts par politique de sécurité. Lancez cette commande dans PowerShell en tant qu'administrateur :

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Puis relancez le script normalement.

❌ "Fichier CSV introuvable"

Vérifiez que :

Le fichier automates.csv est bien dans le même dossier que EditOffsetCLI.ps1
Le nom du fichier est exactement automates.csv (pas automates.csv.txt)

Dans l'Explorateur de fichiers, activez Affichage → Extensions de noms de fichiers pour voir l'extension réelle.

❌ Tous les automates sont en erreur