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

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.

---

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

---

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.

1. Faites un clic droit sur le fichier EditOffsetCLI.ps1
2. Cliquez sur Propriétés
3. En bas de la fenêtre, cochez la case Débloquer
4. 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

1. Ouvrez l'Explorateur de fichiers et naviguez jusqu'au dossier contenant EditOffsetCLI.ps1
2. Cliquez dans la barre d'adresse en haut (là où est affiché le chemin du dossier)
3. 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

Vérifiez que :

• Votre PC est bien connecté au réseau des automates
• Les adresses IP dans le CSV sont correctes
• Le port renseigné correspond au protocole actif sur l'automate (HTTP ou HTTPS)
• Les identifiants sont corrects

---

❌ "Erreur SSL/TLS" ou "certificat"

Le script gère automatiquement les certificats auto-signés des automates Distech. Si l'erreur persiste, vérifiez que curl.exe est disponible sur votre système (inclus dans Windows 10 v1803+ et Windows 11).

---

Exemple complet

Fichier automates.csv :

Hostname;Current Ip
Salle-A101;10.0.1.50
Salle-A102;10.0.1.51
Salle-B201;10.0.1.52

Commande :

.\EditOffsetCLI.ps1 -CsvInput ".\automates.csv" -Offset 4 -Username "admin" -Password "Distech2024"

Résultat attendu : les 3 automates sont configurés avec une plage de -4°C à +4°C.