Ajout initial
Fichiers : - EditOffsetCLI.ps1 — script PowerShell principal (modification BLE + GFx) - README.md — documentation utilisateur en français - .gitignore — configuration git
This commit is contained in:
@@ -0,0 +1,236 @@
|
||||
# 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 :
|
||||
|
||||
```powershell
|
||||
.\EditOffsetCLI.ps1 -CsvInput ".\automates.csv" -Offset 3
|
||||
```
|
||||
|
||||
### Avec identifiants (si tous les automates ont le même mot de passe)
|
||||
|
||||
```powershell
|
||||
.\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` :
|
||||
|
||||
```powershell
|
||||
.\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** :
|
||||
|
||||
```powershell
|
||||
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 :
|
||||
```powershell
|
||||
.\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.
|
||||
Reference in New Issue
Block a user