# 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**

![Débloquer le fichier via les propriétés Windows](doc/unblock.png)

> 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.