¶ 🚂 Bench-Test : Station de Test et Programmation Ferroviaire
Banc de Test Professionnel pour Locomotives Miniatures 🎯
¶ 📖 Introduction
Bienvenue dans Bench-Test v2.0 ! 🎉 Une station complète de test et programmation pour passionnés de modélisme ferroviaire avec protocole Z21 en WiFi. Ce système vous permet de :
✅ Tester et déboguer les locomotives DC (configurations 2 rails et 3 rails)
✅ Tester les décodeurs DCC avec détection complète d’acquittement
✅ Programmer les CVs DCC en mode service avec mesure de courant
✅ Surveiller la consommation de courant en temps réel avec capteur ACS712
✅ Contrôler à distance via WiFi avec des applications compatibles Z21 (PacoMouseCYD, JMRI, etc.)
✅ Fonctionnalité spéciale : Basculer en mode analogique en sélectionnant l’adresse DCC 1
¶ 🔧 Matériel
- 🎛️ WEMOS D1 Mini (ESP8266) - Contrôleur principal avec WiFi
- ⚡ LM18200 - Pilote de moteur en pont H haute puissance (jusqu’à 3A)
- 📊 ACS712-05A - Capteur de courant pour surveillance et détection ACK
- 📺 LCD 16×2 I²C - Affichage d’état en temps réel
- 🔀 Module Relais - Configuration 2 rails / 3 rails (Relais2)
- 💡 Module BoostUp - Alimentation 24V pour relais de direction Märklin (Relais1)
¶ 📚 Fonctionnalités Logicielles
- Protocole Z21 - Contrôle DCC standard industriel en WiFi
- Gestionnaire WiFi - Configuration facile avec portail captif
- Interface Web - Configuration WiFi via smartphone/navigateur
- Support Multi-clients - Connexion simultanée de plusieurs appareils
- Surveillance du Courant - Diffusion en temps réel à tous les clients
- Standard C++17
¶ 🎮 Modes de Fonctionnement
¶ 📡 Contrôle WiFi (Protocole Z21)
Tout le contrôle se fait via le protocole Z21 en WiFi - Aucun interrupteur physique nécessaire !
Clients supportés :
- PacoMouseCYD - Contrôleur DCC à écran tactile
- JMRI - Suite complète de contrôle et programmation DCC
- Applications Mobiles Z21 - Applications iOS/Android
- Multiples appareils - Jusqu’à 10 connexions simultanées
¶ 🎯 Fonctionnalités de Contrôle Spéciales
| Fonction | Contrôle Z21 | Comportement |
|---|---|---|
| Mode Analogique | Sélectionner Adresse DCC 1 | 🔄 Bascule automatiquement en mode analogique |
| 2 Rails / 3 Rails | Fonction F0 | OFF = 2 rails 🛤️ / ON = 3 rails 🛤️🛤️🛤️ |
| Direction Märklin | Fonction F1 | Déclenche Relais1 (impulsion 24V) - Actif uniquement en mode 3 rails |
| Contrôle Vitesse | Manette | 0-100% via manette Z21 |
| Direction | Bouton Direction | Avant / Arrière |
| Contrôle Alimentation | Alimentation Voie | ON / OFF via Z21 |
| Programmation CV | Mode Programmation | Lecture/Écriture CVs avec détection ACK |
¶ 💡 Indicateurs d’État
| Indicateur | Emplacement | Description |
|---|---|---|
| LED Alimentation | D3 (GPIO0) | 🟢 Allumée fixe quand alimentation voie ON |
| Afficheur LCD | I²C | État et courant en temps réel |
¶ 📺 Format Afficheur LCD
Ligne 1: [ANA/DCC] [RUN/PROG] [ON/OFF]
Ligne 2: I:X.XXA [FWD/REV] #[Adr]
Exemples :
DCC RUN ON+I:0.12A FWD #3→ Mode DCC, adresse 3, 120mAANA RUN ON+I:0.50A REV→ Mode analogique (adresse 1 sélectionnée)WiFi OK+192.168.1.100→ WiFi connecté, affichage IP
¶ 🔬 Utilisation du Banc de Test
¶ 🌐 Première Configuration - Configuration WiFi
Au premier démarrage, l’appareil crée un point d’accès WiFi :
- Connectez-vous au réseau WiFi : BenchTest-Setup
- Mot de passe :
dcc12345 - Ouvrez un navigateur sur :
http://192.168.4.1 - Scannez les réseaux et sélectionnez votre WiFi
- Entrez le mot de passe et enregistrez
- L’appareil se connectera automatiquement et affichera l’IP sur le LCD
¶ ⚡ Mode Analogique (ANA)
Objectif : Tester les locomotives DC et moteurs avec contrôle de tension variable.
🎯 Comment activer le Mode Analogique :
- Dans votre application Z21 (PacoMouseCYD/JMRI), sélectionnez l’Adresse DCC 1
- Le banc bascule automatiquement en mode Analogique
- L’écran LCD affiche :
ANA RUN ON
¶ 🛤️ Configuration 2 Rails (Par défaut)
- Sélectionnez Adresse 1 (bascule en mode analogique)
- F0 = OFF (mode 2 rails) - Relais2 est OFF
- Placez la locomotive 2 rails sur le banc de test
- Alimentation Voie ON via l’application Z21
- Ajustez la manette pour contrôler la vitesse (0-100%)
- Bouton direction change la polarité (avant/arrière)
Fonctionnement :
- Relais2 est OFF (configuration 2 rails)
- Direction contrôlée par broche DIR du LM18200 (inversion de polarité)
- Signal PWM simule la tension DC (0-19V ajustable)
- Plage de vitesse complète disponible
¶ 🚂 Configuration 3 Rails (Märklin)
- Sélectionnez Adresse 1 (bascule en mode analogique)
- F0 = ON (mode 3 rails) - Relais2 est ON
- Placez la locomotive 3 rails sur le banc de test (rail1, rail2, rail-milieu)
- Alimentation Voie ON via l’application Z21
- Ajustez la manette pour contrôler la vitesse
- Appuyez sur F1 pour déclencher le changement de direction (envoie impulsion 24V via Relais1)
Fonctionnement :
- Relais2 est ON (configuration 3 rails)
- F1 déclenche Relais1 → impulsion 24V via module BoostUp (max 500ms)
- Rail central à une polarité, rails extérieurs pour le retour
- Inversion de direction via impulsion de tension externe (standard Märklin)
💡 Note : F1 ne fonctionne que quand F0=ON (mode 3 rails). En mode 2 rails, F1 n’a aucun effet.
¶ 🔵 Mode DCC - Mode Exploitation
Objectif : Tester les décodeurs DCC avec commandes d’exploitation normales.
🎯 Comment utiliser le Mode DCC :
- Dans votre application Z21, sélectionnez n’importe quelle adresse DCC (2-127)
- Le banc fonctionne en mode DCC
- L’écran LCD affiche :
DCC RUN ON
Procédure de Test :
- Placez la locomotive DCC sur le banc de test
- Sélectionnez l’adresse (2-127) dans l’application Z21
- Alimentation Voie ON via l’application Z21
- Ajustez la manette pour contrôler la vitesse
- Bouton direction change la direction
- Boutons de fonction (F0-F28) contrôlent les fonctions du décodeur
📊 Surveillance : Consommation de courant affichée en temps réel sur le LCD et diffusée à tous les clients Z21
Fonctionnalités :
- Génération complète du signal DCC (TODO : Implémentation en attente)
- Contrôle de vitesse (0-28 ou 0-128 crans)
- Contrôle de direction
- Contrôle de fonctions (F0-F28)
- Surveillance du courant en temps réel
- Protection court-circuit (> 2A)
- Support multi-clients
¶ 🔧 Mode DCC - Mode Programmation
Objectif : Programmer les CVs des décodeurs DCC (Variables de Configuration) en Mode Service via Z21.
🎯 Programmation avec JMRI :
- Connectez JMRI au banc de test (voir configuration JMRI ci-dessous)
- Placez UN SEUL décodeur sur la voie de programmation
- Ouvrez DecoderPro dans JMRI
- Sélectionnez la programmation en Mode Service
- Lisez ou Écrivez les CVs via l’interface
🎯 Programmation avec PacoMouseCYD :
- Connectez PacoMouseCYD au banc de test
- Placez UN SEUL décodeur sur la voie de programmation
- Entrez en Mode Programmation dans l’application
- Lisez ou Écrivez les CVs
⚠️ Important : Un seul décodeur sur la voie pendant la programmation !
Fonctionnement :
- Protocole Z21 : Reçoit les commandes CV via WiFi
- Détection ACK : Le capteur de courant ACS712 détecte les impulsions d’acquittement de 60mA (≥6ms)
- Retour : État ACK renvoyé au client Z21
- Surveillance Série : Événements ACK enregistrés dans la console série
- Limite de Vitesse : Automatiquement limitée à 50% en mode programmation
Paramètres de Détection ACK :
- Seuil : 60mA minimum
- Durée : largeur d’impulsion de 6ms minimum
- Sortie série :
✅ ACK DCC DÉTECTÉ ! - Réponse Z21 envoyée à tous les clients
État de la Programmation CV :
- ⚠️ TODO : Génération complète du signal DCC en attente
- ✅ Surveillance du courant fonctionnelle
- ✅ Détection ACK implémentée
- ✅ Communication protocole Z21 prête
¶ 🔌 Câblage et Connexions
¶ 🎛️ Brochage WEMOS D1 Mini (Version Simplifiée 2.0)
| Broche | GPIO | Mode | Fonction | Description |
|---|---|---|---|---|
| A0 | Analog | INPUT | 📊 ACS712 OUT | Lecture analogique capteur de courant |
| D0 | GPIO16 | OUTPUT | 🔀 Relais2 | Sélection 2 rails / 3 rails (F0) |
| D1 | GPIO5 | I²C SCL | 🔌 Horloge I²C | Afficheur LCD |
| D2 | GPIO4 | I²C SDA | 🔌 Données I²C | Afficheur LCD |
| D3 | GPIO0 | OUTPUT | 💡 LED Alim | Indicateur alimentation ON |
| D4 | GPIO2 | OUTPUT | ⚡ LM18200 DIR | Contrôle direction moteur |
| D5 | GPIO14 | OUTPUT | 🔀 Relais1 | Relais direction Märklin (F1) |
| D6 | GPIO12 | - | 🔓 Disponible | Extension future |
| D7 | GPIO13 | - | 🔓 Disponible | Extension future |
| D8 | GPIO15 | OUTPUT | ⚡ LM18200 PWM | Contrôle vitesse moteur |
| TX | GPIO1 | OUTPUT | 📡 TX Série | Communication USB/Debug |
| RX | GPIO3 | INPUT | 📡 RX Série | Communication USB/Debug |
¶ 🎛️ Pilote Moteur LM18200
| Broche | Connexion | Description |
|---|---|---|
| PWM | D8 (GPIO15) | ⚡ Contrôle vitesse via signaux PWM |
| DIR | D4 (GPIO2) | 🔄 Contrôle direction (avant/arrière) |
| BRAKE | GND | 🔒 Relié à GND (non utilisé, fonctionnement normal) |
| OUT1 | ACS712 IP+ | 📊 Le courant passe par le capteur |
| OUT2 | Rail Voie 2 | 🛤️ Deuxième sortie voie |
| VS | Alim 19V | ⚡ Alimentation puissance moteur |
| GND | GND Commun | ⚡ Référence masse |
¶ 📊 Capteur de Courant ACS712 (Modèle 05A)
| Broche | Connexion | Description |
|---|---|---|
| VCC | 5V | ⚡ Alimentation capteur |
| GND | GND | ⚡ Masse |
| OUT | A0 (WEMOS) | 📡 Sortie analogique vers microcontrôleur |
| IP+ | LM18200 OUT1 | ➡️ Entrée courant fort |
| IP- | Rail Voie 1 | ➡️ Sortie courant fort vers voie |
Spécifications :
- Sensibilité : 185mV/A (pour modèle 05A)
- Plage : ±5A
- Sortie courant nul : ~2.5V (512 ADC @ 3.3V)
- Seuil détection ACK : 60mA
¶ 📺 Afficheur LCD (Adresse : 0x27 ou 0x3F)
Afficheur LCD I²C 16×2 caractères
- SDA → D2 (GPIO4)
- SCL → D1 (GPIO5)
- VCC → 5V
- GND → GND
¶ 🔀 Modules Relais
Relais2 (sélection 2 rails / 3 rails) :
- Contrôle : D0 (GPIO16)
- Fonction : Contrôlé par F0 dans Z21
- OFF (F0=OFF) = configuration 2 rails
- ON (F0=ON) = configuration 3 rails
Relais1 (contrôle direction Märklin) :
- Contrôle : D5 (GPIO14)
- Fonction : Contrôlé par F1 dans Z21 (uniquement en mode 3 rails)
- Envoie impulsion 24V via module BoostUp
- Durée impulsion : 500ms
- Câblage : D5 → Bobine relais → GND
¶ 💡 Indicateur LED
LED Alimentation :
- Broche : D3 (GPIO0)
- Câblage : D3 → Résistance 330Ω → Anode LED (+)
- Cathode LED (-) → GND
- État : ON quand alimentation voie activée
¶ ⚡ Architecture Alimentation
Alimentation 19V DC
├─→ Pilote Moteur LM18200 (broche VS)
│ └─→ Sortie Voie (via ACS712)
│
├─→ Abaisseur DC (19V → 5V)
│ ├─→ WEMOS D1 Mini
│ ├─→ Afficheur LCD
│ ├─→ Capteur Courant ACS712
│ └─→ Modules Relais
│
└─→ Module BoostUp (19V → 24V)
└─→ Relais1 (contrôle direction Märklin - déclenché par F1)
Exigences Composants :
- 💡 Alim Principale : 19V DC, 3A minimum
- 🔽 Abaisseur : 19V → 5V, 1A (pour logique)
- 🔼 BoostUp : 19V → 24V, 500mA (pour relais Märklin, déclenché par F1)
¶ 💻 Installation Logicielle & Programmation
¶ 📦 Prérequis
-
Installez PlatformIO :
- Extension VS Code (recommandée) : Télécharger
- Ou PlatformIO Core CLI
-
Clonez le dépôt :
git clone <url-dépôt> cd Bench-Test
¶ 🛠️ Compilation et Téléversement
# Compiler le firmware
pio run
# Téléverser vers WEMOS D1 Mini
pio run --target upload
# Surveiller sortie série
pio device monitor
Ou utilisez VS Code :
- Cliquez PlatformIO: Build (Ctrl+Alt+B)
- Cliquez PlatformIO: Upload (Ctrl+Alt+U)
- Cliquez PlatformIO: Serial Monitor (Ctrl+Alt+S)
¶ 📚 Dépendances (auto-installées par PlatformIO)
lib_deps =
marcoschwartz/LiquidCrystal_I2C@^1.1.4
mrrwa/NmraDcc@^2.0.17
ESP8266WiFi
DNSServer
ESP8266WebServer
¶ 📡 Configuration Client Z21
¶ 📱 Configuration PacoMouseCYD
- Connectez PacoMouseCYD au même WiFi que le Bench-Test
- Paramètres → Protocole → Z21
- Adresse IP : Entrez l’IP affichée sur le LCD du Bench-Test
- Port : 21105
- Enregistrer
Fonctionnalités Spéciales :
- Sélectionnez Adresse 1 pour basculer en mode Analogique
- Utilisez F0 pour basculer 2 rails / 3 rails
- Utilisez F1 pour déclencher la direction Märklin (3 rails uniquement)
¶ 💻 Configuration JMRI
- Édition → Préférences → Connexions
- Cliquez + pour ajouter une connexion
- Configurez :
- Fabricant Système : Roco
- Connexion Système : Z21
- Connexion : Réseau
- Adresse IP : [IP du Bench-Test depuis LCD]
- Port : 21105
- Enregistrer et redémarrer JMRI
Fonctionnalités JMRI :
- Manette : Contrôle vitesse et direction
- DecoderPro : Programmer les CVs en mode service
- Contrôle Fonctions : F0-F28 (F0=rails, F1=direction Märklin)
- Moniteur Courant : Affichage courant temps réel
¶ 🔧 Configuration & Calibration
¶ 🎯 Calibration Capteur de Courant ACS712
Le capteur de courant est auto-calibré au démarrage. Si vous avez besoin d’une calibration manuelle :
- Déconnectez toutes les charges de la voie
- Mettez le système sous tension
- Notez la valeur ADC affichée dans le moniteur série
- Mettez à jour
ACS712_ZERO_CURRENTdansmain.cpp:#define ACS712_ZERO_CURRENT 512 // Ajustez cette valeur
¶ 📍 Configuration Adresse I²C
Si votre LCD utilise une adresse différente :
Afficheur LCD :
LiquidCrystal_I2C lcd(0x27, 16, 2); // Changez 0x27 en 0x3F si nécessaire
¶ 🌐 Configuration WiFi
Réinitialiser les identifiants WiFi si nécessaire :
- Appelez
wifiManager.resetSettings()dans le code, ou - Accédez au portail et cliquez sur « Réinitialiser Paramètres WiFi »
¶ 🎯 Référence Contrôle Z21
¶ Résumé des Commandes
| Commande Z21 | Effet | Notes |
|---|---|---|
| Sélectionner Adresse 1 | 🔄 Basculer en mode Analogique | Changement de mode automatique |
| Sélectionner Adresse 2-127 | 🔵 Mode DCC | Fonctionnement DCC normal |
| Manette | 🚀 Vitesse 0-100% | Contrôle PWM |
| Direction | ➡️⬅️ Avant/Arrière | Broche DIR ou F1 (Märklin) |
| F0 | 🛤️ 2 rails / 3 rails | OFF=2 rails, ON=3 rails |
| F1 | 🚂 Direction Märklin | Actif uniquement en 3 rails (F0=ON) |
| F2-F28 | 🔘 Fonctions | TODO : Implémentation |
| Alimentation Voie | ⚡ ON/OFF | Contrôle alimentation général |
| Lecture/Écriture CV | 📝 Programmation | Mode service |
¶ Comportement Fonctions Spéciales
F0 - Configuration Rails :
- OFF → Relais2 OFF → configuration 2 rails (polarité via broche DIR)
- ON → Relais2 ON → configuration 3 rails (rail central + rails extérieurs)
F1 - Contrôle Direction Märklin :
- Fonctionnel uniquement quand F0 = ON (mode 3 rails)
- Déclenche Relais1 → impulsion 24V via module BoostUp
- Durée impulsion : max 500ms
- Utilisé pour changer la direction sur locomotives 3 rails (Märklin)
¶ Spécifications Protocole
- Protocole : Z21 LAN sur UDP
- Port : 21105
- Support Diffusion : État système, courant, infos loco
- Max Clients : 10 connexions simultanées
- Auto-découverte : Les clients Z21 peuvent trouver l’appareil sur le réseau
¶ 🚀 Améliorations Futures
¶ 🎯 Fonctionnalités Prévues
- ✅ Contrôle WiFi - Protocole Z21 en WiFi (TERMINÉ v2.0)
- ✅ Interface Web - Portail captif pour configuration WiFi (TERMINÉ v2.0)
- ✅ Support Multi-clients - Jusqu’à 10 connexions simultanées (TERMINÉ v2.0)
- 📊 Génération Complète Signal DCC - Sortie forme d’onde DCC complète
- 💾 Sauvegarde Profils Vitesse - Sauvegarder et rappeler courbes de vitesse via EEPROM
- 📈 Enregistrement Données - Journaliser courant/vitesse sur carte SD ou cloud
- 🎵 Test Décodeurs Son - Intégration retour audio
- 🔄 Séquences Test Automatisées - Routines de test pré-programmées
- 📊 Support Écran OLED - Affichage haute résolution
- 🔴 Intégration Relais1 - Contrôle direction Märklin complet (F1)
¶ 🧑💻 Structure du Code (v2.0)
src/
├── main.cpp # Code application principal
│ ├── Définitions Broches # Assignations GPIO (D0-D8, A0)
│ ├── Variables Globales # Gestion état (vitesse, direction, mode)
│ ├── Déclarations Avant # Prototypes de fonctions
│ ├── Fonctions Capteur # readCurrent(), detectDCCAck()
│ ├── Fonctions Contrôle # setSpeed(), setDirection(), setRailsMode()
│ ├── Contrôle Alim # applyPowerControl(), setPowerLED()
│ ├── Fonctions Affichage # updateLCDStatus()
│ ├── Callbacks Z21 # onZ21LocoControl(), onZ21FunctionControl()
│ ├── Callbacks WiFi # onWiFiConnected(), onPortalStarted()
│ ├── setup() # Initialisation WiFi + Z21 + LCD
│ └── loop() # Boucle mise à jour WiFi + Z21 + LCD
│
├── Z21.h # En-tête protocole Z21
│ ├── Constantes Protocole # Commandes, opcodes, port 21105
│ ├── Typedefs Callback # Types pointeurs de fonction
│ └── Classe Z21Protocol # Interface Z21 principale
│
├── Z21.cpp # Implémentation protocole Z21
│ ├── Communication UDP # Gestion socket WiFiUDP
│ ├── Gestion Clients # Jusqu'à 10 clients, suivi timeout
│ ├── Analyse Messages # processZ21Message()
│ ├── Gestionnaires Cmd # handleXSetLoco(), handleXCV...()
│ └── Diffusion # Diffusions alimentation, courant, info loco
│
├── WifiManager.h # En-tête gestionnaire WiFi
│ ├── Config Portail # Paramètres AP, DNS, serveur web
│ ├── Structure EEPROM # Stockage identifiants
│ ├── Typedefs Callback # Callbacks de connexion
│ └── Classe WifiManager # Interface WiFi + portail
│
└── WifiManager.cpp # Implémentation gestionnaire WiFi
├── Stockage Identifiants # Lecture/écriture EEPROM
├── Pages Web Portail # HTML pour configuration
├── Scan Réseau # Découverte réseaux WiFi
├── Logique Connexion # Auto-connexion, gestion timeout
└── Portail Captif DNS # Redirection vers 192.168.4.1
¶ 📝 Référence Fonctions Clés (v2.0)
| Fonction | But | Emplacement |
|---|---|---|
readCurrent() |
Lire capteur ACS712, détecter court-circuit | main.cpp |
detectDCCAck() |
Détecter acquittement DCC (60mA, 6ms) | main.cpp |
applyPowerControl() |
Activer/désactiver sortie PWM | main.cpp |
setSpeed(int) |
Régler vitesse 0-100% via PWM | main.cpp |
setDirection(int) |
Contrôler broche DIR (0=ARR, 1=AV) | main.cpp |
setRailsMode(int) |
Contrôler Relais2 via D0 (fonction F0) | main.cpp |
setPowerLED(bool) |
Contrôler LED alimentation sur D3 | main.cpp |
updateLCDStatus() |
Rafraîchir affichage LCD (toutes les 300ms) | main.cpp |
onZ21LocoControl() |
Callback Z21 pour commandes loco | main.cpp |
onZ21FunctionControl() |
Callback Z21 pour F0-F28 (F0=rails, F1=relais) | main.cpp |
onZ21CVRead/Write() |
Callbacks Z21 pour programmation CV | main.cpp |
onWiFiConnected() |
Callback quand WiFi se connecte, démarre Z21 | main.cpp |
z21.begin(port) |
Initialiser écoute UDP Z21 | Z21.cpp |
z21.loop() |
Traiter messages Z21 entrants | Z21.cpp |
wifiManager.begin() |
Démarrer connexion WiFi ou portail | WifiManager.cpp |
wifiManager.loop() |
Gérer requêtes portail, vérifier connexion | WifiManager.cpp |
¶ 🐛 Conseils de Débogage
Surveiller la sortie série :
pio device monitor
# Affiche : État WiFi, adresse IP, messages Z21, lectures courant, détection ACK
Débogage WiFi :
- LCD affiche « Mode Portail » si pas de WiFi configuré ou échec connexion
- LCD affiche « WiFi OK » + adresse IP quand connecté
- Sortie série affiche tentatives connexion et état
Débogage protocole Z21 :
- Tous messages entrants enregistrés en série
- Connexions/déconnexions clients affichées
- Appels de fonctions (F0, F1, etc.) affichés
Dépannage capteur de courant :
- Courant nul devrait lire ~512 ADC (2.5V @ référence 3.3V)
- Vérifier orientation ACS712 (IP+ vers LM18200 OUT1, IP- vers voie)
- Vérifier alimentation 5V vers ACS712
- Protection court-circuit se déclenche à 2A
¶ 📊 Spécifications Techniques
| Paramètre | Valeur | Notes |
|---|---|---|
| Tension Fonctionnement | 19V DC | Alimentation principale |
| Tension Logique | 5V / 3.3V | ESP8266 fonctionne à 3.3V |
| Courant Max Voie | 3A | Limite LM18200 (avec dissipateur) |
| Protection Court-Circuit | 2A | Coupure alimentation automatique |
| Plage Mesure Courant | ±5A | Modèle ACS712-05A |
| Résolution Courant | ~5mA | ADC 10 bits à 3.3V |
| Seuil Détection ACK | 60mA | Standard DCC, 6ms minimum |
| Fréquence PWM | ~1kHz | Valeur par défaut ESP8266 |
| Plage Adresses DCC | 1-127 | 1=Mode analogique, 2-127=DCC |
| Taux Rafraîch. LCD | 300ms | ~3 IPS |
| Débit Série | 115200 | Sortie USB/Debug |
| Protocole WiFi | 802.11 b/g/n | 2.4GHz uniquement (ESP8266) |
| Protocole Z21 | UDP Port 21105 | Standard Z21 LAN |
| Max Clients Z21 | 10 | Connexions simultanées |
| IP Portail | 192.168.4.1 | Adresse portail captif |
| SSID Portail | BenchTest-Setup | Nom AP par défaut |
| Mot de Passe Portail | dcc12345 | Mot de passe AP par défaut |
| Utilisation Mémoire | RAM: 43.2%, Flash: 31.9% | Beaucoup de place pour extension |
¶ ⚠️ Sécurité & Dépannage
¶ 🛡️ Consignes de Sécurité
⚠️ Toujours déconnecter l’alimentation avant de modifier le câblage
⚠️ Utiliser dissipateur approprié sur LM18200 (chauffe sous charge)
⚠️ Ne pas dépasser 3A en courant continu (protection à 2A se déclenche)
⚠️ Un seul décodeur sur voie de programmation
⚠️ Vérifier la polarité avant de connecter les locomotives
⚠️ Changer le mot de passe portail par défaut pour la sécurité
¶ 🔍 Problèmes Courants
| Problème | Cause Possible | Solution |
|---|---|---|
| Portail inaccessible | D0 BAS au démarrage | S’assurer que D0 (broche Relais2) est tiré HAUT au démarrage |
| Impossible se connecter WiFi | Mauvais identifiants | Réinitialiser via portail ou reflasher |
| Z21 ne répond pas | Pare-feu bloque | Ouvrir port UDP 21105 |
| LCD ne fonctionne pas | Mauvaise adresse I²C | Essayer 0x27 ou 0x3F dans le code |
| Pas de lecture courant | ACS712 inversé | Vérifier orientation IP+ et IP- |
| Pas d’ACK DCC | Seuil trop haut | Ajuster DCC_ACK_THRESHOLD |
| Vitesse erratique | Bruit PWM | Ajouter condensateur aux bornes moteur |
| LED alim ne fonctionne pas | Mauvaise polarité | Vérifier anode LED + vers D3 |
| Relais ne commute pas | Connexion D0 | Vérifier connexion GPIO16 |
| F1 ne fonctionne pas | Pas en mode 3 rails | F1 fonctionne uniquement quand F0=ON |
¶ 📞 Support
- 📧 Email : [votre-email]
- 🐛 Problèmes : GitHub Issues
- 📖 Documentation : Wiki
¶ 📜 Licence
Ce projet est sous licence MIT - voir le fichier LICENSE pour les détails.
¶ 🙏 Remerciements
- NMRA pour les standards DCC
- Märklin pour l’inspiration du système 3 rails
- PlatformIO pour l’excellente plateforme de développement
- Communauté Modélisme Ferroviaire pour les tests et retours
¶ 🎯 Résumé des Fonctionnalités (Version 2.0)
✅ Contrôle WiFi (NOUVEAU v2.0)
- 📡 Protocole Z21 en WiFi
- 🌐 Portail captif pour configuration facile
- 📱 Compatible avec PacoMouseCYD, JMRI, applications Z21
- 🔌 Jusqu’à 10 clients simultanés
- 📊 Diffusions temps réel (alimentation, courant, état système)
✅ Test Multi-Modes
- 🟢 DC Analogique (configurations 2 rails et 3 rails)
- 🔵 Test décodeurs DCC digitaux (TODO : génération signal)
- 🔧 Programmation CV DCC avec détection ACK
- 🔄 Bascule auto en analogique avec Adresse DCC 1
✅ Fonctions Spéciales
- 🛤️ F0 : Basculer 2 rails / 3 rails (contrôle Relais2)
- 🚂 F1 : Impulsion direction Märklin (3 rails uniquement, Relais1)
- ⚡ Changements configuration basés sur fonctions
✅ Surveillance Avancée
- 📊 Mesure courant temps réel (plage 0-5A, résolution 5mA)
- 💡 Indicateur LED alimentation (D3)
- 📺 Affichage LCD 16×2 direct avec adresse IP
- 📡 Sortie débogage série (115200 bauds)
- 🛡️ Protection court-circuit (seuil 2A)
✅ Fonctionnalités Sécurité
- 🛡️ Coupure automatique court-circuit
- 🔒 Limiteur vitesse mode programmation (max 50%)
- 📉 Surveillance courant temps réel
- ⚠️ Indication défauts visuelle et série
✅ Fonctionnalités Professionnelles
- 🔌 Implémentation protocole Z21 LAN
- 💻 Détection ACK (60mA, impulsion 6ms)
- 📈 Callbacks lecture/écriture CV prêts
- 🔧 Structure code modulaire (main.cpp, Z21.cpp, WifiManager.cpp)
- 🌐 Portail captif avec interface web
- 📶 Support multi-clients (jusqu’à 10 simultanés)
¶ 🚂 Bons Tests ! 🎉
Créé avec ❤️ pour les Passionnés de Modélisme Ferroviaire
⭐ Mettez une étoile à ce projet si vous le trouvez utile ! ⭐