LOCODUINO

Aide
Forum de discussion
Dépôt GIT Locoduino
Flux RSS

mardi 19 mars 2024

Visiteurs connectés : 101

Comment piloter trains et accessoires en DCC avec un Arduino (4)

Les pourquoi et comment des modules logiciels

.
Par : Dominique

DIFFICULTÉ :

Ce dernier article décrit la réalisation du logiciel de notre va-et-vient.
Il est fait pour être modifié, étendu, complété par vous-même, selon vos propres désirs.
C’est donc d’abord une source d’inspiration que je vous propose selon le principe du logiciel libre, mais sans garantie de bon fonctionnement, même si le projet fonctionne bien pour moi.

ATTENTION ! Ce logiciel utilise une bibliothèque qui est maintenant obsolète. Vous trouverez une réalisation parfaitement réalisable dans l’article Réalisation d’un va-et-vient automatique et réaliste .

<

L’Organigramme

Reportons nous aux spécifications de notre projet décrites dans l’article précédent.
Celles-ci définissent tous les ingrédients nécessaires à cette petite centrale.

Rappelons seulement qu’il s’agit de piloter une seule loco qui fera des allers et retours entre deux gares aux extrémités d’une voie unique, soit manuellement, soit automatiquement. Dans ce dernier cas, on comprend qu’il faudra faire jouer de nombreux paramètres de configuration.

A partir de ces spécifications, la réalisation logicielle se découpe en un certain nombre de blocs représentés ci-dessous.

Organigramme de la centrale va-et-vient

Pour commencer, nous allons mettre en place les ingrédients matériels dans le logiciel.

Tout d’abord, les bibliothèques nécessaires.

Définition des bibliothèques utilisées

Bibliothèque CmdrArduino

// LIBRAIRIE CMDRARDUINO
#include <DCCPacket.h>             // bibliothèque CmdrArduino
#include <DCCPacketQueue.h>        // idem
#include <DCCPacketScheduler.h>    // idem

Cette bibliothèque prend en charge la génération du signal DCC sur la Pin 9 du Nano (elle se charge de l’initialisation de cette Pin). Elle est décrite à l’article précédent.

Bibliothèque EEPROM

#include <EEPROM.h>              // gestion mémoire EEPROM

Cette bibliothèque permet de lire et écrire dans la mémoire EEPROM qui est non-volatile.
Nous avons besoin de ces fonctions pour lire et écrire des paramètres de configuration que le logiciel utilisera pour initialiser des variables à chaque mise sous tension.

Bibliothèque Bounce

#include <Bounce.h>              // deboucing pour boutons et inters

Cette bibliothèque permet de lire de façon fiable les actions sur les inters et boutons. En effet, ces contacts mécaniques ont l’inconvénient de « rebondir » c’est à dire de générer plusieurs contacts d’affilée et d’entrainer de fausses commandes que cette bibliothèque permet d’éviter.

Bibliothèque AVR/pgmspace

#include <avr/pgmspace.h>        // gestion mémoire Flash

Cette bibliothèque permet d’accéder (entre autres) à la lecture de données stockées dans la mémoire Flash de programme. Je me suis vite rendu compte que les textes prévus pour les affichages LCD (ou console) occupent la mémoire vive RAM qui est trop petite. C’est un des rares inconvénients de l’Arduino, facilement contourné par cette bibliothèque.

Bibliothèques SoftwareSerial et SerLCD

#include <SoftwareSerial.h>
#include <serLCD.h>              // librairie de gestion d'un LCD 16x2 via port Tx

SoftwareSerial est nécessaire pour se servir de l’écran LCD via l’interface SerLCD.
serLCD permet la gestion d’un écran LCD (2 lignes de 16 caractères) avec les ordres habituels Serial.print et des commandes de positionnement simples.

Après les bibliothèques, voici maintenant les connexions électriques des différents organes avec les broches (Ports ou Pins) de notre Arduino.

Définition des Ports d’Entrée et Sortie de l’Arduino

Cette définition est conforme au schéma de câblage décrit dans l’article précédent.

On y trouve successivement les potentiomètres, les sorties du Booster, les boutons MManuel/Auto et Lumière, la connexion à l’écran LCD, les Leds, les détecteurs de position du train et les sorties de commande du booster LMD18200.

// Pins ARDUINO
#define Pot_AV             A0    // Analog IN : potar vitesse Avant
#define Pot_AR             A1    // Analog IN : potar vitesse Arriere
#define Current_Sense      A2    // Analog IN : courant Booster
#define Thermal_Sense      A3    // Analog IN : temperature Booster
#define Pin_AutoManu       A4    // IN  : commutateur de mode 
                                 // manuel (LOW) ou automatique (HIGH)
#define Pin_SW_FL          A5    // IN  : commutateur d'eclairage
                                 // (HIGH = ON, LOW = OFF)
// les Pins 0 et 1 sont réservées pour Rx et Tx (port série)
#define Pin_Tx             1     // Pour connexion au LCD via serLCD                                 
#define Pin_MAV            2     // OUT : led marche avant
#define Pin_MAR            3     // OUT : led marche arriere
#define Pin_Arret          4     // OUT : led arret
#define Pin_ZoneAV         5     // IN  : detecteur zone d'arret avant
#define Pin_ZoneAR         6     // IN  : detecteur zone d'arret arriere
#define Fin_De_Voie        7     // IN  : detecteur de fin de voie (les 2 combinées)
#define Pin_Mode           8     // IN  : poussoir de mode
#define Pin_Out_DIR        9     // OUT : Signal DIR pour LMD18200
//       pin 10 reservee pour Timer 1
#define Pin_Out_PWM        11    // OUT : Signal PWM pour LMD18200
                                 // HIGH en marche, LOW = stop
#define Pin_DCC            12    // IN  : commutateur marche/arret signal DCC 
#define Pin_Led_Booster    13    // OUT : led DCC OFF (continu) 
                                 // ou surcharge booster (clignotant)

On respire un peu...

... avec une présentation des affichages.

Affichages LCD

On aura deux types d’affichages :

  • 3 écrans pour représenter le fonctionnement du train et suivre l’automatisme de va-et-vient ;
  • 10 écrans pour le configuration des paramètres de la centrale.

Voici d’abord les écrans de la centrale en cours de pilotage :

Mode Manuel

Au départ le commutateur Auto/Manuel est en position « Manuel ».
Les potentiomètres de vitesse sont au minimum. Le train est arrêté.
Tourner le potentiomètre de Vitesse Avant si la loco est en gare 1 ou le potentiomètre de Vitesse Arriere si la loco est en gare 2. La loco démarre
On peut consulter la vitesse (Crans DCC) sur l’afficheur LCD

La vitesse est automatiquement calculée à partir du temps séparant les passages des détecteurs et la distance configurée en EEPROM.
Il est possible de connaitre la vitesse réelle, mesurée entres les passages devant les 2 capteurs Infrarouges en appuyant sur le bouton Mode.

Mode Automatique

Le train doit, au préalable être placé au niveau de la gare de départ (gare 1).
Lorsque la clé Auto/Manuel est levée, le fonctionnement en mode Automatique démarre.
Les séquences suivantes se déroulent automatiquement :

  • 1/2 arrêt en gare de départ (valeur en configuration) ;
  • accélération constante : incrément de vitesse ajouté toutes les 1/2 secondes jusqu’à ce que la vitesse Avant (potentiomètre haut) soit atteinte ;
  • vitesse constante jusqu’à détection de la loco par le détecteur 2 ;
  • décélération arithmétique (diminution de la vitesse toutes les 1/2 secondes) jusqu’à atteinte de la vitesse minimum définie en configuration ;
  • avancement à vitesse minimum pendant la durée définie en configuration ;
  • arrêt en gare d’arrivée (gare 2).

Exemple de courbe de vitesse typique.

Le processus se déroule ensuite de façon symétrique dans l’autre sens :

Le passage entre les 2 capteurs donne toujours lieu à un calcul de la vitesse. La centrale connait donc la vitesse du train au passage du capteur d’arrivée, au début de la séquence de décélération.
Puisqu’elle connait la distance entre ce capteur et le point d’arrivée, elle peut assurer l’arrêt du train à ce point précis.

On peut observer le déroulement des phases de l’automate en affichant l’écran N°2 qui présente la vitesse, la direction, le N° de Canton et le pas qui se décréments toutes les 1/2 secondes dans ce canton :

Revenons maintenant au programme de la centrale !

Définitions des variables et constantes

Pour fonctionner, le programme a besoin de manipuler des données dites « variables » qui sont stockées dans le SRAM (d’autres le sont en Flash). On associe cette déclaration au code d’initialisation qui trouve sa place dans la fonction Setup().

Pour la bibliothèque CmdrArduino

On doit créer une structure dps qui est manipulée par la bibliothèque.
La valeur _stop est crée pour inverser le comportement de la bibliothèque à l’arrêt : La vitesse de cran "1" assure un arrêt avec inertie, plutôt qu’un arrêt brutal.

// DCC handler
#define _stop 1         // 0->eStop et 1->regular stop
DCCPacketScheduler dps; // structure pour la librairie CmdrArduino

Ensuite vient l’initiatisation de la structure dps, qui fait partie de la procédure setup().

dps.setup(); // initialise en même temps les Pins 9 et 10

Enfin nous faut appeler de façon récurrente, donc dans loop() :

 dps.update(); 

ainsi que les commandes de vitesse et lumière dont les variables sont déterminées plus loin, en mode manuel et automatique :

dps.setSpeed128(Config_Init.dcc_adresse,DCC_SHORT_ADDRESS,_speed)
dps.setFunctions0to4(Config_Init.dcc_adresse,DCC_SHORT_ADDRESS,FL)

Pour la configuration

Nous définissons une structure de données en EEPROM qui contiendra les valeurs nécessaires :

typedef struct
{
    int dcc_adresse;              // @ DCC 128 crans. Attention, elle occupe 2 octets.
    byte vitesse_min;             // 2..10 a determiner en pilotage manuel
    byte increment_acceleration;  // 1..10
    byte duree_arret_gare1;       // 0..255 secondes
    byte duree_arret_gare2;       // 0..255 secondes
    byte distance_ligne;          // 1..255 centimetres
    byte distance_gare1;          // 1..255 centimetres
    byte distance_gare2;          // 1..255 centimetres
    byte pas_tempo_ligne;         // 1..255 pas de 1/2 seconde
    byte Nb_Vmin;                 // 1..20  nb de 1/2 secondes à Vmin avant Stop
} configuration;
configuration Config_Init;        // record de configuration copié en EEPROM

Nous verrons l’usage de ces variables à l’occasion des procédures de configuration, et restauration.

Boutons et Capteurs

Nous avons le bouton Mode (poussoir), et les inverseurs AutoManu, Lumière, et A/M DCC.
Avec le bouton Mode nous avons prévu 13 états possibles correspondant aux affichages sur l’écran LCD (3 en fonctionnement normal et 10 en configuration).

Bounce B_Mode = Bounce(Pin_Mode, 100);// bouton MODE
byte prev_BM_state = 1;               // etat anterieur du poussoir Mode
byte BM = 0;                          // inactif (0) ou actif (1)
boolean Mode_Config = false;
byte Mode_EnCours = 0;                // mode 0 : normal, affichage "DCC V DIR AV AR "
                                      // mode 1 : normal, affichage "V DIR Canton Pas"
                                      // mode 2 : normal, affichage vitesse reelle
                                      // mode 3 : config : @ dcc
                                      // mode 4 : config : V min
                                      // mode 5 : config : acceleration
                                      // mode 6 : config : t arret gare 1
                                      // mode 7 : config : t arret gare 2
                                      // mode 8 : config : l canton ligne
                                      // mode 9 : config : l canton gare 1
                                      // mode 10: config : l canton gare 2
                                      // mode 11: config : time-out n 1/2s
                                      // mode 12: config : nb 1/2s a Vmin
                                       
Bounce B_AutoManu = Bounce(Pin_AutoManu, 20); // clé AUTO/MANUEL
byte prev_AutoManu_state = 0;                 // etat anterieur du commutateur
                                              // auto-manuel
byte AutoManu = 0;                            // manuel (0) ou automatique (1)

Bounce B_SW_FL = Bounce(Pin_SW_FL, 20); // clé LUMIERE
byte prev_FL_state = 0;                 // etat anterieur du bouton lumiere FL
byte FL = 0;                            // eclairage éteint (0) ou allumé (1)

Bounce B_DCC = Bounce(Pin_DCC, 20); // clé ARRET/MARCHE DCC
byte prev_ON_DCC_state = 0;         // etat anterieur du bouton de signal DCC
                                    // (pour etre OFF à l'init)
byte ON_DCC = 0;                    // DCC off (0) ou on (1)

Pour les Détecteurs de passage et l’alarme température du Booster

boolean alarme_temperature = true; // LOW si T>145°C au capteur, 
					                         // inversé à la mesure
int mesure_courant = 0;
 
// detecteur de zones AV (gare 2)
int detecteur_ZAV, prev_detecteur_ZAV, etat_detecteur_ZAV = 0;      
// detecteur de zones AR (gare 1)
int detecteur_ZAR, prev_detecteur_ZAR, etat_detecteur_ZAR = 0;      
					
unsigned long IRdebounce_time;
#define IRdebtime  100             // 10 milliseconde
byte IRdebounceAVH, IRdebounceAVL, IRdebounceARH, IRdebounceARL = 0;

On peut se demander pourquoi ces détecteurs sont concernés par les problèmes de rebond, puisqu’on voit ici le terme debounce.
En fait il n’est est rien, mais ici, par souci de perfection, on veut tenir compte de l’espace entre 2 voitures qui provoquerait une détection parasite. On élimine donc cette détection parasite avec un traitement similaire à celui de la bibliothèque Bounce.

Pour la tâche de clignotement des Leds

// 0 = normal, >0 (true) =  clignote 1 éteint ou 3 allumé
byte surchargeBooster = 0; 
byte Rouge_Clignotant = 0;     
byte Jaune_Clignotant = 0; 
byte Vert_Clignotant = 0; 

Evidemment ces Leds ne vont pas clignoter en utilisant l’instruction delay(). On va utiliser le temps système avec millis() pour déclencher les changement d’état des Leds.

Passons à l’affichage LCD

serLCD lcd(Pin_Tx);

Cette ligne définit la classe « lcd » et initialise le port 1

On définit ensuite les chaines de caractères qui seront affichées en 1ère ligne sur l’écran LCD.

Ces chaines sont définies pour être stockées en mémoire Flash (avec le programme) et récupérées au coup par coup et une seule à la fois en SRAM, pour éviter de la saturer (sinon plantage assuré, c’est un écueil que nous rencontrons tous à nos débuts).

prog_char string_0[]  PROGMEM = "DCC V DIR AV AR ";   // Mode_EnCours = 0
prog_char string_1[]  PROGMEM = "V DIR Canton Pas";   // Mode_EnCours = 1
prog_char string_2[]  PROGMEM = "Vit  Km/h  Cm/s ";   // Mode_EnCours = 2
prog_char string_3[]  PROGMEM = "Adresse DCC :   ";   // Mode_EnCours = 3
// mode configuration à partir de 4
prog_char string_4[]  PROGMEM = "Vitesse min :   ";   // Mode_EnCours = 4
prog_char string_5[]  PROGMEM = "Acceleration :  ";   // Mode_EnCours = 5
prog_char string_6[]  PROGMEM = "T arret gare 1: ";   // Mode_EnCours = 6
prog_char string_7[]  PROGMEM = "T arret gare 2: ";   // Mode_EnCours = 7
prog_char string_8[]  PROGMEM = "L canton ligne: ";   // Mode_EnCours = 8
prog_char string_9[]  PROGMEM = "L canton gare 1:";   // Mode_EnCours = 9
prog_char string_10[] PROGMEM = "L canton gare 2:";   // Mode_EnCours = 10
prog_char string_11[] PROGMEM = "Time-out n 1/2s:";   // Mode_EnCours = 11
prog_char string_12[] PROGMEM = "Nb 1/2s Vmin :  ";   // Mode_EnCours = 12

PROGMEM const char *string_table[] = 	                // table des adresses
{   
  string_0,
  string_1,
  string_2,
  string_3,
  string_4,
  string_5,
  string_6,
  string_7,
  string_8,
  string_9,
  string_10,
  string_11,
  string_12
 };

char buffer[16];    
// tampon de recopie en RAM (doit etre au moins aussi grand que le plus grand STRING

Ce type de déclaration peut être recopié dans tous programmes faisant un usage intensif des affichages de texte.

Passons aux taches périodiques

unsigned long time500, looptime;

Pour la tâche de clignotement des Leds

On va réaliser une sorte d’automate qui s’appuie sur 2 bits d’un octet (4 états possibles) pour définir les états des Leds (allumé, éteint, fixe ou clignotant).

// 0 = normal, >0 (true) =  clignote 1 éteint ou 3 allumé
byte surchargeBooster = 0; 
byte Rouge_Clignotant = 0; 
byte Jaune_Clignotant = 0;
byte Vert_Clignotant = 0; 

Pour le mouvement du train

Il y a beaucoup de variables pour les modes manuel et automatique, ce qui se comprendra aisément à la lecture des modules de traitement.

unsigned int AV_value = 0;           // lecture du potentiometre vitesse avant
unsigned int AR_value = 0;           // lecture du potentiometre vitesse arriere
byte speed_AV, old_speed_AV = 0;     // vitesse AV (courante, précédente)
byte speed_AR, old_speed_AR = 0;     // vitesse AR
byte _speed, vitesse = 0;            // vitesse instantannee (selon direction)
boolean change_V = false;            // si true => change donc nouvelle commande DCC
byte DIR = 1;                        // marche avant: gare1>gare2 (1) 
                                     // ou arriere: gare2>gare1 (0)
byte Canton = 0;                     // 0=arret quai gare1, 1=depart acceleration, 
                                     // 2=ligne, 3=arrivee ralentissement, 
                                     // 4= vitesse min, 5=arret quai gare2
#define NBCantons 6                  // 6 cantons = 6 etats automate
#define NBPAS 10                     // nombre de pas de 1/2 sec par etat automate et 
                                     // par defaut si le detecteur n'a pas fonctionne
byte PasAV[NBCantons];               // pas en Avant : 1 valeur par canton 
byte PasAR[NBCantons];               // pas en Ariere : 1 valeur par canton 
byte TO;                             // time-out passage canton ligne calculé d'après 
                                     // le temps de passage entre capteurs
unsigned long TC, MTC, VKM, VCM = 0; // duree de passage entre capteurs, moyenne, 
                                     // vitesse (km/h) et vitesse (cm/s)
unsigned int MMA, DDS100;            // Nb de millimetre restant a parcourir 
                                     // jusqu’a arret et decrement par 1/2 seconde

Toutes le déclarations étant faites, nous pouvons commencer le déroulement des instruction du setup()

Initialisations du programme

  #define VERSION "b3-081114"
  
  void setup() {

  lcd.setBrightness(25); // rétro-éclairage du LCD 0..30
  lcd.clear();           // effacement du LCD
  lcd.print("Vers. ");
  lcd.print(VERSION);
  lcd.selectLine(2);     // positionnement en 2è ligne

  ///////////// initialisation des Pins
  //pinMode(Pot_AV, INPUT);         // entree analogique donc pas nécessaire
  //pinMode(Pot_AR, INPUT);         // entree analogique donc pas nécessaire
  //pinMode(Current_Sense, INPUT);  // entree analogique donc pas nécessaire
  pinMode(Thermal_Sense, INPUT_PULLUP);
  pinMode(Pin_AutoManu, INPUT_PULLUP);
  pinMode(Pin_SW_FL, INPUT_PULLUP);
  pinMode(Pin_Mode, INPUT_PULLUP);
  pinMode(Pin_DCC, INPUT_PULLUP);
  pinMode(Pin_Out_PWM, OUTPUT);
  //pinMode(Pin_Out_DIR, OUTPUT);   // initialisé par CmdrArduino
  digitalWrite(Pin_Out_PWM, LOW);   // DCC OFF
  pinMode(Pin_Led_Booster, OUTPUT);
  digitalWrite(Pin_Led_Booster, HIGH);  
    // Booster OFF (allume) ou CLIGNOTANT (surcharge)
  pinMode(Pin_MAV, OUTPUT);
  pinMode(Pin_MAR, OUTPUT);
  pinMode(Pin_Arret, OUTPUT);
  pinMode(Pin_ZoneAV, INPUT_PULLUP);
  pinMode(Pin_ZoneAR, INPUT_PULLUP);
  pinMode(Fin_De_Voie, INPUT_PULLUP);

  ////////////// initialisation de la bibliothèque CmdrArduino
  dps.setup();                      // initialise les Pins 9 et 10

  prev_ON_DCC_state = B_DCC.read(); // force l'etat DCC off
  // il faut une transition bas -> haut de Alim Rails
  // pour autoriser l’alimentation des rails
   
  ////////////// Recuperation des valeurs de configuration en EEPROM 
  _Recup_EEPROM();     // voir le détail de cette fonction plus loin
  
  lcd.print("DCC:");   // affichage de l’adresse DCC en configuration
  lcd.print(Config_Init.dcc_adresse);
 
  Mode_EnCours = 0;    // initialisation de la variable
  Mode_Config = false; // pas de mode configuration 
  
  ///////////// test de la configuration : si l’adresse DCC == 0 ou FF (EEPROM vierge):
  ///////////// passage obligatoire en configuration à la 1ère mise en service
  if ((Config_Init.dcc_adresse == 0) || (Config_Init.dcc_adresse == 255))
  {
    Mode_EnCours = 3;
    Mode_Config = true;
    _Configuration();         // voir le détail de cette fonction plus loin
  }
 
  ///////////// initialisation des compteurs de temps pour les taches periodiques
  time500 = millis();         // pour déclencher la fonction SR_demiseconde()
  looptime = micros();        // pour mesurer la durée moyenne de la LOOP()
  IRdebounce_time = millis(); // pour l’anti-rebond des boutons
 
  lcd.print(" RAM:");
  lcd.print(_RamFree()); // affiche la quantité de RAM restant (état de santé)
  delay(2000);           // pendant 2 secondes
} // fin de la fonction setup()

Sous-programmes de setup()

La fonction setup() fait donc appel aux fonctions suivantes :

  • _Recup_EEPROM() qui permet de lire les paramètres en EEPROM et initialiser des variables,
  • _Program_EEPROM() qui permet d’écrire les paramètres en EEPROM, après
  • _Configuration() qui permet de déterminer les paramètres à écrire en EEPROM à l’aide d’un dialogue avec l’utilisateur, mettant en oeuvre l’écran LCD, boutons et potentiomètres.

Attention à la survie de l’EEPROM ! : le nombre maximum d’écritures dans l’EEPROM est de 100.000 ! Ce n’est pas rien, mais il ne faut pas en abuser, sinon le micro-controleur ne pourra plus s’en servir.
On n’écrit donc JAMAIS en permanence dans cette mémoire mais seulement de façon occasionnelle. C’est le cas des paramètres de configuration.

Fonction _Recup_EEPROM()

void _Recup_EEPROM()
{
  int i;
  int s = sizeof(Config_Init);
  byte b[s]; // tableau de lecture de l’EEPROM
  
  for (i = 0; i < s; i++)
  {
    b[i] = EEPROM.read(i);
    delay(10);
  }
  // puis affectation des variables
  Config_Init.dcc_adresse = b[0]*256 + b[1]; 
  // on assemble les 2 octets pour faire un ‘int'
  Config_Init.vitesse_min = b[2];
  Config_Init.increment_acceleration = b[3]; 
  Config_Init.duree_arret_gare1 = b[4];
  Config_Init.duree_arret_gare2 = b[5];
  Config_Init.distance_ligne = b[6];
  Config_Init.distance_gare1 = b[7];
  Config_Init.distance_gare2 = b[8];
  Config_Init.pas_tempo_ligne = b[9];
  Config_Init.Nb_Vmin = b[10];
}

Fonction _Program_EEPROM()

void _Program_EEPROM()
{
  int i;
  int s = sizeof(Config_Init);
  byte b[s];
  
  b[0] = highByte(Config_Init.dcc_adresse);  // séparation du int en 2 bytes
  b[1] = lowByte(Config_Init.dcc_adresse);
  b[2] = Config_Init.vitesse_min;
  b[3] = Config_Init.increment_acceleration;
  b[4] = Config_Init.duree_arret_gare1;
  b[5] = Config_Init.duree_arret_gare2;
  b[6] = Config_Init.distance_ligne;
  b[7] = Config_Init.distance_gare1;
  b[8] = Config_Init.distance_gare2;
  b[9] = Config_Init.pas_tempo_ligne;
  b[10] = Config_Init.Nb_Vmin;
 for (i = 0; i < s; i++)
  {
    EEPROM.write(i, b[i]); 
    delay(10);  // un petit délai pour garantir une bonne écriture
  }
}

Fonction _Configuration()

La fonction _Configuration() est bien plus compliquée. Elle met en oeuvre un écran LCD par paramètre.

Prenez un café et continuez la lecture !

Le texte de la question apparait sur la 1ere ligne du LCD
La valeur pré-existante est affichée sur la 2e ligne, suivie de « -> »

Puis la valeur est définie par rotation des 2 potentiomètres de vitesse !

Cette méthode permet de se passer d’un clavier 0..9. On utilise les potentiomètres car il est possible de lire leur position angulaire qui, après conversion analogique-digitale, donne une valeur comprise entre 0 et 1023. Ensuite, il est nécessaire de « démultiplier » la valeur lue pour la ramener dans la plage 0..127.

Pour ce faire, on ajoute les lectures des 2 potentiomètres (résultat compris entre 0 et 2048) puis on divise le résultat par 16 : on obtient une valeur comprise entre 0 et 127.

Ce résultat est affiché à droite de « -> ».

La fonction tourne en boucle en affichant cette valeur jusqu’à ce qu’on n’appuie sur le bouton MODE.

Pour enregistrer une nouvelle valeur (affichée à droite de « -> »), il faut lever la clé LUMIERE puis appuyer sur MODE, puis abaisser la clé LUMIERE.

Dans ce cas, la valeur est écrite en EEPROM (« OK » apparait pendant 1 seconde) puis la configuration passe au paramètre suivant.
Sinon, rien n’est changé et le passage au paramètre suivant est réalisé. On peut ainsi consulter la configuration en laissant la clé LUMIERE en bas et en appuyant successivement sur MODE.

Comme il y a des processus répétitifs, j’ai écrit ces processus dans des fonctions.

La fonction _Configuration() fait appel aux fonctions _questionB(), _questionC() et _questionD().

_questionB() traite uniquement le cas de l’adresse DCC qui occupe 2 octets de configuration en EEPROM ;
_questionC() traite les autres paramètres qui occupent seulement 1 octet.
_questionD() est un cas particulier de _questionC() qui permet de choisir une valeur dans la plage 0..512. J’en ai eu besoin pour définir la distance entre les 2 capteurs. Je peux les espacer jusqu’à 5 mètres et 11 cms.

Ces 3 fonctions sont décrites après la fonction _Configuration()

Fonction _Configuration()

void _Configuration()
{
  // version LCD (remplace la version Console via USB)
  // entrée : mode manuel, LUMIERE=0 - si OK suite de questions
  // sortie avec suite d’appuis sur bouton mode
  // Mode_EnCours = 3 à 13 (index des questions)
  
  // arret du train, stop DCC booster, vitesse AV/AR=0, pots à 0
  vitesse = _stop;
  dps.setSpeed128(Config_Init.dcc_adresse,DCC_SHORT_ADDRESS,vitesse);
  ON_DCC = 0;
  digitalWrite(Pin_Out_PWM, ON_DCC);      // 0 = arret
  digitalWrite(Pin_Led_Booster, !ON_DCC); // 1 = led allumee 
  lcd.clear();
  
  // recopie de la chaine en Flash vers notre buffer
  // Cast et dereferencement nécessaire
  strcpy_P(buffer, (char*)pgm_read_word(&(string_table[Mode_EnCours])));
  lcd.print(buffer);    // affichage 1ere ligne
  lcd.setCursor(2, 1);  // adresse DCC
  _questionB();         // attente d’appui sur MODE
  Mode_EnCours++;       // question suivante
  lcd.clear();
  strcpy_P(buffer, (char*)pgm_read_word(&(string_table[Mode_EnCours])));
  lcd.print(buffer);     // affichage 1ere ligne
  lcd.setCursor(2, 1);   // vitesse minimale
  Config_Init.vitesse_min = _questionC(Config_Init.vitesse_min, 2);
  Mode_EnCours++;
  lcd.clear();
  strcpy_P(buffer, (char*)pgm_read_word(&(string_table[Mode_EnCours])));
  lcd.print(buffer);    // affichage 1ere ligne
  lcd.setCursor(2, 1);  // incréments d’accélération
Config_Init.increment_acceleration = _questionC(Config_Init.increment_acceleration, 3);   
  Mode_EnCours++;
  lcd.clear();
  strcpy_P(buffer, (char*)pgm_read_word(&(string_table[Mode_EnCours]))); 
  lcd.print(buffer);    // affichage 1ere ligne
  lcd.setCursor(2, 1);  // 1/2 durée arrêt en gare 1
  Config_Init.duree_arret_gare1 = _questionC(Config_Init.duree_arret_gare1, 4);   
  Mode_EnCours++;
  lcd.clear();
  strcpy_P(buffer, (char*)pgm_read_word(&(string_table[Mode_EnCours]))); 
  lcd.print(buffer);    // affichage 1ere ligne
  lcd.setCursor(2, 1);  // 1/2 durée arrêt en gare 2
  Config_Init.duree_arret_gare2 = _questionC(Config_Init.duree_arret_gare2, 5);   
  Mode_EnCours++;
  lcd.clear();
  strcpy_P(buffer, (char*)pgm_read_word(&(string_table[Mode_EnCours]))); 
  lcd.print(buffer);    // affichage 1ere ligne
  lcd.setCursor(2, 1);  // Distance zone Ligne en cm
  Config_Init.distance_ligne = _questionD(Config_Init.distance_ligne, 6);   
  Mode_EnCours++;
  lcd.clear();
  strcpy_P(buffer, (char*)pgm_read_word(&(string_table[Mode_EnCours]))); 
  lcd.print(buffer);    // affichage 1ere ligne
  lcd.setCursor(2, 1);  // Distance zone Gare 1 en cm
  Config_Init.distance_gare1 = _questionC(Config_Init.distance_gare1, 7);   
  Mode_EnCours++;
  lcd.clear();
  strcpy_P(buffer, (char*)pgm_read_word(&(string_table[Mode_EnCours]))); 
  lcd.print(buffer);    // affichage 1ere ligne
  lcd.setCursor(2, 1);  // Distance zone Gare 2 en cm
  Config_Init.distance_gare2 = _questionC(Config_Init.distance_gare2, 8);   
  Mode_EnCours++;
  lcd.clear();
  strcpy_P(buffer, (char*)pgm_read_word(&(string_table[Mode_EnCours]))); 
  lcd.print(buffer);    // affichage 1ere ligne
  lcd.setCursor(2, 1);  // Nombre de 1/2 secondes maximum sur zone Ligne
  Config_Init.pas_tempo_ligne = _questionC(Config_Init.pas_tempo_ligne, 9);   
  Mode_EnCours++;
  lcd.clear();
  strcpy_P(buffer, (char*)pgm_read_word(&(string_table[Mode_EnCours]))); 
  lcd.print(buffer);    // affichage 1ere ligne
  lcd.setCursor(2, 1);  // Nombre de 1/2 secondes à vitesse Vmin
  Config_Init.Nb_Vmin = _questionC(Config_Init.Nb_Vmin, 10);   
  Mode_EnCours = 0;
  Mode_Config = false;
  lcd.clear();
  lcd.print("Fin Config ");
  lcd.print(_RamFree());
  delay(2000);
} 

En fin de configuration, le dernier écran affiche la quantité de mémoire SRAM restante.

Fonction _questionB()

_questionB() sert à renseigner uniquement la valeur de l’adresse DCC de la loco en service et de l’enregistrer en EEPROM. Elle n’a pas de paramètre en entrée.
La clé LUMIERE doit être positionnée en bas (lumière éteinte).
Après affichage de la valeur initiale une boucle « while » tourne tant que le booléen RXIT est faux.
Le booléen ROK passe à vrai si on lève la clé LUMIERE.
RXIT passe à vrai si on appuie sur le bouton MODE : on sort de la boucle sans modification si ROK est faux ou en modifiant le paramètre si ROK est vrai.

void _questionB()                           // adresse DCC, Mode_EnCours = 3
{
  boolean ROK = false;
  boolean RXIT = false; 
  byte Valeur = 0;
  
  lcd.print(Config_Init.dcc_adresse);       // ancienne valeur sur 2e ligne, max 3 cars
  lcd.print(" ->");                         // choix à afficher en ligne 2, colonne 8
  while (!RXIT) 
  {
    // on se sert de la somme des potentiometres
    Valeur = (analogRead(Pot_AV) + analogRead(Pot_AR)) >> 4; 
    //division par 16 pour ramener le champ 0-2047 à 0-127
    lcd.setCursor(2, 6);
    lcd.print(Valeur);
    lcd.print("  ");             // pour effacer les caracteres suivants eventuels
    if (B_Mode.update())         // Poussoir Mode change-t-il ?
    {
      if (B_Mode.risingEdge()) 
      {
        RXIT = true;             // sortie de la boucle while
     }
    }
    if (B_SW_FL.update())        // COMMUTATEUR DE LUMIERE
    {
      if (B_SW_FL.read() == HIGH)
      {        
        Config_Init.dcc_adresse = Valeur; // validation 
        ROK = true;
      } 
    }
  } // while !ROK
  
  if (ROK) 
  {
    // enregistrement en EEPROM
    EEPROM.write(0, highByte(Config_Init.dcc_adresse)); 
    delay(10);
    EEPROM.write(1, lowByte(Config_Init.dcc_adresse));
    lcd.print(" Ok!");
    delay(1000);
  }
}

Fonction _questionC()

_questionC() sert à renseigner les autres paramètres et les enregistrer en EEPROM. Elle a 2 paramètres en entrée : l’index du paramètre et sa valeur initiale.
La clé LUMIERE doit être positionnée en bas (lumière éteinte).
Après affichage de la valeur initiale une boucle « while » tourne tant que le booléen RXIT est faux.
Le booléen ROK passe à vrai si on lève la clé LUMIERE.
RXIT passe à vrai si on appuie sur le bouton MODE : on sort de la boucle sans modification si ROK est faux ou en modifiant le paramètre si ROK est vrai.

int _questionC(int _VAL, int _index)  // Mode_EnCours > 3
{
  boolean ROK = false;
  boolean RXIT = false;
  byte Valeur = 0;
  
  lcd.print(_VAL);          // ancienne valeur sur 2e ligne, max 3 cars
  lcd.print(" ->");         // choix à afficher en ligne 2, colonne 8
  while (!RXIT) 
  {
    // on se sert de la somme des potentiometres
    Valeur = (analogRead(Pot_AV) + analogRead(Pot_AR)) >> 4;
    //division par 16 pour ramener le champ 0-2047 à 0-127
    lcd.setCursor(2, 6);
    lcd.print(Valeur);
    if (B_Mode.update())    // Poussoir Mode change-t-il ?
    {
      if (B_Mode.risingEdge()) 
      {
        RXIT = true;        // sortie de la boucle while
     }
    }
    if (B_SW_FL.update())   // COMMUTATEUR DE LUMIERE
    {
      if (B_SW_FL.read() == HIGH)
      {
        _VAL = Valeur;      // validation
        ROK = true;
      } 
    }
  }  // while !ROK
  if (ROK) 
  {
    // enregistrement en EEPROM
    EEPROM.write(_index, _VAL);
    lcd.print(" Ok!");
    delay(1000);
  }
  return(_VAL);  // retour avec le paramètre modifié ou non
}

Fonction _questionD()

Cette fonction diffère de _questionC() par le seul fait qu’elle permet de renseigner une valeur comprise entre 0 et 511 au lieu de 0..255. Cette valeur correspond à des centimètres, la distance entre les deux capteurs. Il est probable que cette valeur dépasse 2,50 mètres, ce qui était mon cas. Alors en fait on multiplie par 2 la valeur enregistrée en EEPROM car celle-ci est codée sur un seul octet.
L’affichage peut suivre puisqu’il peut aller jusqu’à 2047. La valeur enregistrée en EEPROM est divisée par 2 car elle reste limitée à 255 et la valeur récupérée en variable est doublée.

int _questionD(int _VAL, int _index)  // mode LCD uniquement, Mode_EnCours > 3, pour une valeur 0..512
{
  boolean ROK = false; 
  boolean RXIT = false;               // pour cette reponse globale
  int Valeur = 0;
  
  lcd.print(_VAL*2);                  // ancienne valeur double sur 2e ligne, max 3 cars
  lcd.print(" ->");                   // choix à afficher en ligne 2, colonne 8
  while (!RXIT) 
  {
    // on se sert de la somme des potentiometres
    Valeur = (analogRead(Pot_AV) + analogRead(Pot_AR)) >> 2; // division par 4 pour ramener
                                                             // le champ 0-2047 à 0-511.
    lcd.setCursor(2, 6);
    lcd.print(Valeur);
    lcd.print("  ");                  // pour effacer les caracteres suivants eventuels
    if (B_Mode.update())              // Poussoir Mode change
    {
      if (B_Mode.risingEdge()) 
      {
        RXIT = true;                  // sortie de la fonction sans modification
      }
    }
    if (B_SW_FL.update())             // COMMUTATEUR DE LUMIERE
    {
      if (B_SW_FL.read() == HIGH)
      {
        _VAL = Valeur/2;              // nouvelle valeur
        ROK = true;
      } 
    }
  }  // while !ROK
  if (ROK) 
  {
    EEPROM.write(_index, (byte)_VAL);
    lcd.print(" Ok!");
    delay(1000);
  }
  return(_VAL);
}

Abordons maintenant la boucle principale

Boucle principale (loop)

La fonction loop() est exécutée de façon répétitive à l’infini. C’est dans cette fonction que toutes les tâches devront être exécutées les unes à la suite des autres.

Mais certaines tâches n’ont pas besoin d’être exécutées à chaque tour de loop ! C’est le cas de l’automate qui commande l’avancement automatique du train. Pour cet automate, on a choisi un pas d’avancement d’1/2 seconde. Chaque 1/2 seconde, l’automate avance d’un pas.

Pour ce faire, la variable time500 est comparée au temps système millis() : si cette dernière dépasse de 500 millisecondes la valeur de time500, une procédure SR_demiseconde() est lancée et time500 est mis à jour avec la valeur lue de millis().

En parallèle, des conditions extérieures peuvent influer sur le fonctionnement et les états de l’automate : appui sur le bouton, changement d’état des clés ou détection de passage devant un capteur infrarouge. Pire, un dépassement de température du booster ! Ces événements doivent être traités en priorité, le plus vite possible : ils sont donc traités dans le fonction loop() qui s’exécute environ 200 fois par seconde.

Pour garantir un temps de réponse le plus court possible, la fonction delay() n’est JAMAIS utilisée dans loop(). Il faut donc « accrocher » les taches qui doivent attendre à la fonction SR_demiseconde() et utiliser des compteurs qu’il faut initialiser avec le nombre de 1/2 secondes à attendre. La fonction SR_demiseconde() n’a alors qu’à décrémenter le compteur et exécuter une tache seulement lorsqu’un compteur arrive à zéro.

C’est le cas des taches suivantes :

  • la detection de passage devant les capteurs qui doit être confirmée après une temporisation de 0,2 seconde pour la tête de train et 1 seconde pour la queue du train (afin d’éliminer les éventuels espace entre wagon qui pourrait donner de fausses détection). Ici on ne sert pas de la détection de queue de train, mais cela pourrait servir dans un autre projet. On fait appel ici à une variable IRdebtime initialisée à 100 pour avoir des pas de 0,1 seconde.
  • le clignotement des leds est accroché à la fonction SR_demiseconde().
  • l’avancement de l’automate est régit par des tableaux de variables PasAR[Canton] et PasAV[Canton] qui sont initialisées à chaque changement de condition et décrémentés à chaque 1/2 seconde. Lorsqu’une variable atteint 0, un changement d’état s’opère (s’il n’a pas eu lieu avant par une condition externe).
  • le rafraichissement de l’affichage LCD.

La seule exception à la règle du « ZERO delay() » arrive lorsque qu’il y a appel de la fonction _Configuration() qui contient des instruction delay(). Mais pour éviter tout risque dans ce cas, le train est d’abord stoppé (sa vitesse est programmée à 0 et le signal DCC est arrêté.

En plus des taches exécutées dans la boucle loop(), il faut savoir que les librairies lancées au démarrage mettent en place des taches prioritaires déclenchées par des horloges internes : les interruptions.

C’est le cas de la librairie CmdeArduino qui initialise le Timer 1. Toutes les 50 ou 100 microsecondes environ, une interruption prend la main du processeur et s’occupe de la gestion du signal DCC : une transition d’un 0 à 1 ou 1 à 0 des trames DCC préparées par les instructions de commande de vitesse et de lumière.

Le détail des opérations de loop() est indiqué dans le corps du programme ci-dessous :

void loop() {
  
  int i;  // variable locale, propre à loop()

  /////////////////////////////////////////
  // Boutons et commutateurs
  /////////////////////////////////////////

Bouton Auto/Manuel

On détecte uniquement un changement d’état (par rapport à un état précédent prev_AutoManu_state. Le passage en mode AUTO démarre l’automate : AutoManu est vrai, cette variable étant une condition pour le déroulement de l’automate dans SR_demiseconde().
Le passage en mode MANUEL stoppe l’automate : AutoManu est faux, condition pour appliquer directement les valeurs de vitesse des potentiomètres dans loop().

  if (B_AutoManu.update())                   // COMMUTATEUR AUTO/MANUEL
  {
    byte AutoManu_state = B_AutoManu.read(); // variable locale
    if (AutoManu_state != prev_AutoManu_state)  
    {
      prev_AutoManu_state = AutoManu_state;
      AutoManu = prev_AutoManu_state;
 
      if (AutoManu) 
      {                    // passage en mode Auto
      // pour le moment on suppose le train au depart en gare 1 
      Canton = 0;          // 1/2 arret en Gare1
      DIR = 1;             // Marche Avant
      vitesse = 0;         // initialisation vitesse
      PasAV[Canton]=Config_Init.duree_arret_gare1;  // init 1/2 duree arret en gare 1
      } else 
      { // passage en mode Manuel
        old_speed_AV = 0;
        old_speed_AR = 0;
        Vert_Clignotant=0;
        Jaune_Clignotant=0;
        // peu importe la position du train
        // mais on continue a mettre a jour sa position,
        // direction et vitesse
      }
    }  
  }

Bouton Lumière

On détecte uniquement un changement d’état (par rapport à un état précédent prev_FL_state. Le changement d’état entraine une commande de lumière : allumage ou extinction.
Si la fonction dps.setFunctions0to4 retourne une erreur, le symbole « : » est affiché là ou le curseur se trouve (c’est une fonction de débugging) .

  /////////////////////////////////////////
  //Commande d'eclairage FL
  /////////////////////////////////////////
  if (B_SW_FL.update())              // COMMUTATEUR DE LUMIERE
  {
    byte FL_state = B_SW_FL.read();  //high == not pushed; low == pushed
    if(FL_state != prev_FL_state)
    {
      prev_FL_state = FL_state;
      FL = prev_FL_state;
      if (!dps.setFunctions0to4(Config_Init.dcc_adresse,DCC_SHORT_ADDRESS,FL))
      {
        lcd.print(":");
      }
    }
  }

Bouton Mode

On détecte uniquement un changement d’état (par rapport à un état précédent prev_BM_state) et seulement le relâchement du bouton. Le changement entraine une mise à jour de la variable d’état Mode_En_Cours qui régit l’affichage LCD en fonctionnement standard et en configuration.
En fonctionnement standard, seuls les écrans 0, 1 et 2 sont possibles. Après 2, on retourne à 0.
En mode configuration (si les boutons Lumière et Auto/Manu sont en bas - sans lumière et mode manuel), la configuration est démarrée.

  /////////////////////////////////////////
  // MODE
  /////////////////////////////////////////
  if (B_Mode.update())              // Poussoir Mode
  {
    byte BM_state = B_Mode.read();  //high == not pushed; low == pushed
    if(BM_state != prev_BM_state)
    {
      prev_BM_state = BM_state;
      BM = prev_BM_state;
      if (BM)
      // prise en compte du relachement
      {
        Mode_EnCours++;
        if (Mode_EnCours > 2 && !AutoManu && !FL) 
        {       // passage en mode configuration
          Mode_Config = true; 
          _Configuration();      // 1 question, 1 reponse, 
          // + programmation EEPROM en fonction de Mode_EnCours
        } else // mode normal
        {
          Mode_Config = false;
          if (Mode_EnCours > 2) Mode_EnCours = 0;       
          // affichages 1ere et 2e ligne faits par SR_demiseconde
        }
      }
    }
  }

Gestion des potentiomètres de vitesse Avant et Arrière.

Comme l’arrêt correspond à la valeur de vitesse = 1, une valeur inférieure à 2 vaut arrêt.
La commande de vitesse DCC n’est envoyée que si la vitesse change car la librairie CmdrArduino se charge de la répétition de la commande conformément à la norme NMRA.
Ne sont pris en compte que les changements de moins de 50% (écretage en cas de crachement du potentiomètre, pour éviter de saturer la librairie CmdrArduino).
En mode manuel, la vitesse est envoyée immédiatement et les leds de direction sont mises à jour
En mode auto, la vitesse est gérée par l’automate, la vitesse maximale étant celle indiquée par le potentiomètre avant ou arrière, suivant le sens de déplacement.

Rappel : en marche avant la vitesse est négative, mais positive en marche arrière

  /////////////////////////////////////////
  //Commandes de vitesse AV et AR
  /////////////////////////////////////////
  AV_value = analogRead(Pot_AV);
  speed_AV = (AV_value >> 3); 
  // division par 8 pour passer de 0-1023 a 0-127
  if (speed_AV < 2)           //forcement un stop
  {
    speed_AV = _stop;         // 0 = e_stop;   1 = _stop 
  }
  if (speed_AV != old_speed_AV)
  {
    if (abs(speed_AV - old_speed_AV) < 64)  // ecretage en cas de pot qui crache
    {
      old_speed_AV = speed_AV;
      change_V = true;
    }
  }
  AR_value = analogRead(Pot_AR);
  speed_AR = (AR_value >> 3); 
  // division par 8 pour passer de 0-1023 a 0-127
  if (speed_AR < 2)           //forcement un stop
  {
    speed_AR = _stop;   	   // 0 = e_stop;  1 = _stop 
  }
  if (speed_AR != old_speed_AR)
  {
    if (abs(speed_AR - old_speed_AR) < 64)  // ecretage en cas de pot qui crache
    {
      old_speed_AR = speed_AR;
      change_V = true;
    }
  }
  if (change_V && !AutoManu) 
  {                                  // mode manuel : vitesse envoyee immediatement
    DIR = (speed_AV > speed_AR);
    if (speed_AR == _stop) DIR = 1;
    if (speed_AV == _stop && speed_AR == _stop) 
    {
      digitalWrite(Pin_Arret, HIGH); 
    } else 
    {
      digitalWrite(Pin_Arret, LOW);
    }
    digitalWrite(Pin_MAV, DIR);      // Led verte
    digitalWrite(Pin_MAR, !DIR);     // led jaune
    if (DIR) {                       // avant
      vitesse = speed_AV;            // 
      _speed = -vitesse;             // en avant vitesse negative
    } else   {                       // arriere
      vitesse = speed_AR;            // 
      _speed = vitesse;              // vitesse positive
    }
    if (!dps.setSpeed128(Config_Init.dcc_adresse,DCC_SHORT_ADDRESS,_speed))
    {
      lcd.print(".");                // détection d’anomalie
    }
    change_V = false;
  }

Activation de la bibliothèque CmdrArduino

La bibliothèque CmdrArduino a besoin d’opérer en tâche de fond (sous interruptions) aussi souvent que possible : elle est appelée dans loop() à chaque tour. Les interruptions servent à changer les bits 0 et 1 émis par la broche DIR (9) au rythme de l’horloge TIMER1 (toutes les 50 ou 100 µs environ). La fonction dps.update() sert à organiser les données privées de cette librairie et notamment la file d’attente des trames à émettre.

  /////////////////////////////////////////
  // Execution CmdrArduino à chaque LOOP
  /////////////////////////////////////////
  dps.update();

Pilotage du Booster LMD18200

La libération du booster par la clé Alim Rails se fait par une transition bas -> haut de cette clé.
Si la clé est initialement en position basse (arrêt), lever la clé alimente les rails en DCC.
Si la clé est initialement en position haute (marche, alors que la Led rouge DCC Stop est allumée), il faut d’abord baisser la clé, puis la lever.

  /////////////////////////////////////////
  // START / STOP BOOSTER
  /////////////////////////////////////////  
  if (B_DCC.update())                      // BOUTON ON / OFF DCC
  {
    byte ON_DCC_state = B_DCC.read();
    if (ON_DCC_state != prev_ON_DCC_state)  
    {
      prev_ON_DCC_state = ON_DCC_state;
      if (!ON_DCC_state)
      {
        ON_DCC = 0;
      }
      if (ON_DCC_state)
      {
        ON_DCC = !ON_DCC;                     // inversion ON -> OFF -> ON ...
      }
      digitalWrite(Pin_Out_PWM, ON_DCC);      // 1 = en marche
      digitalWrite(Pin_Led_Booster, !ON_DCC); // 0 = led OFF allumee en continu
      vitesse = 0;                            // par sécurite
    }
  }

Une surveillance du booster est possible, grâce aux 2 signaux Courant et Temperature.
La valeur 600 correspond à une tension de 2,5 v, soit 1,5 A dans le booster. En réalité je n’ai pas réussi à lire une valeur plausible : des essais sont à poursuivre.
L’alarme temperature se déclenche au dessus de 145 °C
En cas d’alarme, le signal DCC est arrêté, la led DCC stop allumée et la led STOP clignotante

  /////////////////////////////////////////
  // ALARMES BOOSTER (courant et temperature)
  /////////////////////////////////////////
  mesure_courant = analogRead(Current_Sense);
  alarme_temperature = !digitalRead(Thermal_Sense);  // LOW si T > 145°C)
                                                     // puis inversé  
  if ((mesure_courant > 600) || alarme_temperature )
  {
    ON_DCC = 0;
    digitalWrite(Pin_Out_PWM, ON_DCC);        // 0 = STOP
    digitalWrite(Pin_Led_Booster, !ON_DCC);   // 1 = led Booster OFF allumée
    surchargeBooster = 3;                     // et clignotante
    Rouge_Clignotant = 3;                     // led ARRET clignotante
  }

Gestion des capteurs de passage (détecteurs infrarouge)

C’est une partie plus complexe !

On sépare la détection de l’avant du train de celle de l’arrière du train, par rapport au sens de la marche.
La tête est à l’avant en marche avant, la queue est en avant en marche arrière !

C’est plus facile à faire avec des barrières infrarouge qu’avec d’autres types de détecteurs (ILS, consommation de courant, etc..). C’est pour cela que j’ai choisi cette technologie. Mais rien n’empêche de faire autrement.

On applique une temporisation de 0,2 s pour confirmer la détection de la tête de train.
On applique une temporisation de 1,0 s pour confirmer la détection de la queue du train.

On allume la Led Arrêt pendant le passage du train pour contrôler le bon fonctionnement du détecteur. C’est très important dans le cas des barrières infrarouges : il y a souvent une petite main (ou une grosse) qui risque de bousculer un capteur sous prétexte d’améliorer le décor qui cache ce capteur !!!. Il faut pouvoir détecter l’anomalie et y remédier. Bien entendu cela m’est arrivé !

Au 1er détecteur, TC est initialisé par le temps système.

Au 2e détecteur on calcule le temps de passage entre détecteurs et la vitesse du train.

Une mise à jour du « temps de traversée » est faite pour l’automate, afin de sécuriser l’arrêt final du train, si l’un des détecteurs venait à défaillir.
La mesure de vitesse est réalisée à la fois en mode manuel et en mode automatique.

En mode automatique, le 2e passage détecté déclenche la décélération.

D’autres détails seront expliqués dans l’automate SR_demiseconde().

Il y a donc 2 détecteurs : Le premier, dans le sens de la marche du train, déclenche seulement une mesure de vitesse. Le deuxième termine cette mesure et déclenche le ralentissement seulement en mode automatique.

  /////////////////////////////////////////
  // CAPTEURS ZONE DE RALENTISSEMENT
  /////////////////////////////////////////
 
  // traitement detecteur Zone AV (pres de gare 1)
  detecteur_ZAV = digitalRead(Pin_ZoneAV);
  if ((detecteur_ZAV!=prev_detecteur_ZAV)&&(detecteur_ZAV==1)&&(etat_detecteur_ZAV==0))
  {  // detection debut de convoi (tete en AV, queue en AR)               
    etat_detecteur_ZAV = 1; // etat 1 = detection initiale début de convoi
    IRdebounceAVH = 2;      // arme tempo de confirmation après 0,2 sec
  } else {
    if ((detecteur_ZAV == 1) && (IRdebounceAVH == 0) && (etat_detecteur_ZAV == 1))
    { // validation debut de convoi
      etat_detecteur_ZAV = 2;  // etat 2 = en cours de passage devant le detecteur
      prev_detecteur_ZAV = 1;
      // TRAITEMENT TETE DE CONVOI
      digitalWrite(Pin_Arret, HIGH);
      // calcul de la vitesse dans tous les cas : manuel et auto
      if (DIR) {         // marche avant, raz TC
        TC = millis();   // début du comptage
      } else {           // marche arriere, fin du comptage, TC -> calcul vitesse
        TC = millis() - TC;
        if (MTC == 0) {MTC = TC;} else {MTC = (MTC + TC) / 2;}    
        // tend vers la moyenne en millisecondes
        TO = (int)(MTC/500);          // nb de 1/2 secondes
        if (TO > (Config_Init.pas_tempo_ligne+10))
        {
          TO = Config_Init.pas_tempo_ligne;  // butee
        }
        VCM = (unsigned long)Config_Init.distance_ligne;  // cast 1/2 distance en cm
        VCM = VCM*2000/TC;
        VKM = VCM*576/100;
      }
      // si auto : DIR = 1 entree dans ligne (vitesse constante) 
      // ou DIR = 0 ralentir avant arret gare 1
      if (AutoManu)
      {
        if (DIR)         // avant
        {
          // rien a l'entree dans canton ligne
        } else {         // arriere, sortie du canton ligne
          Canton = 2;    // deceleration : preparation des parametres
          PasAR[Canton]=Config_Init.distance_gare1;  // PasAR = distance capteur -> arret gare 1
          MMA = (unsigned int)Config_Init.distance_gare1; 
          // init distance restant a parcourir jusqu'a vitesse min (ex: 60 cm)
          MMA = MMA*2;  
          // amélioration de la précision - ordre de grandeur 120
          DeltaVitesse = MMA/VCM;  
          // nombre de pas en 1/2 sec a VCM pour parcourir MMA
          DeltaVitesse = vitesse/DeltaVitesse;  
          // decrement de vitesse a decompter toutes les 1/2 sec
        } 
      }
    } else {  // autres cas que debut de convoi
      if ((detecteur_ZAV!=prev_detecteur_ZAV)&&(detecteur_ZAV==0)&&(etat_detecteur_ZAV==2))
      { // transition vers 0 en cours de passage de convoi (inter-wagon ou queue)
        etat_detecteur_ZAV = 3; // etat 3 detection retour a 0
        IRdebounceAVL = 10;     // armement tempo 1 sec
      } else {
        if ((detecteur_ZAV==1)&&(IRdebounceAVL!=0)&&(etat_detecteur_ZAV==3))
        { // interwagon a ignorer
          etat_detecteur_ZAV = 2;
          IRdebounceAVL = 0;
        } else {
          if ((detecteur_ZAV==0)&&(IRdebounceAVL==0)&&(etat_detecteur_ZAV==3))
          {
            // queue de convoi
            etat_detecteur_ZAV = 0;
            prev_detecteur_ZAV = 0;
            // TRAITEMENT QUEUE DE CONVOI
            digitalWrite(Pin_Arret, LOW);
          }
        }
      }
    }
  }

  // traitement detecteur Zone AR (pres de gare 2)
  detecteur_ZAR = digitalRead(Pin_ZoneAR);
  if ((detecteur_ZAR!=prev_detecteur_ZAR)&&(detecteur_ZAR==1)&&(etat_detecteur_ZAR==0))
  {  // detection debut de convoi (tete en AV, queue en AR)               
    etat_detecteur_ZAR = 1; // etat 1 = detection initiale début de convoi
    IRdebounceARH = 2;      // arme tempo de confirmation après 0,2 sec
  } else {
    if ((detecteur_ZAR==1)&&(IRdebounceARH==0)&&(etat_detecteur_ZAR==1))
    { // validation debut de convoi
      etat_detecteur_ZAR = 2;  // etat 2 = en cours de passage devant le detecteur
      prev_detecteur_ZAR = 1;
      // TRAITEMENT TETE DE CONVOI
      digitalWrite(Pin_Arret, HIGH);
      // calcul de la vitesse dans tous les cas : manuel et auto
      if (!DIR) {          // marche arriere, raz TC
        TC = millis();    // debut de comptage
      } else {            // marche avant, fin du comptage TC -> calcul vitesse
        TC = millis() - TC;
        if (MTC == 0) {MTC = TC;} else {MTC = (MTC + TC) / 2;} 
         // tend vers la moyenne
        TO = (int)(MTC/500);        // nb de 1/2 secondes
        if (TO > Config_Init.pas_tempo_ligne + 10) { TO = Config_Init.pas_tempo_ligne; }
        VCM = (unsigned long)Config_Init.distance_ligne;  // cast 1/2 distance en cm
        VCM = VCM*2000/TC;
        VKM = VCM*576/100;
      }
      // si auto : DIR = 1 ralentir avant arret gare 2 ou DIR = 0 entree dans ligne (vitesse constante)
      if (AutoManu)
      {
        if (DIR)         // avant
        {
          Canton = 3;                      // deceleration et arret
          PasAV[Canton]=Config_Init.distance_gare2;      
           // PasAV = distance capteur -> arret gare 2
          MMA = (unsigned int)Config_Init.distance_gare2;        
          // init distance restant a parcourir jusqu'a arret *100
          MMA = MMA*2;                                            
          // amélioration de la précision - ordre de grandeur 6000
          DeltaVitesse = MMA/VCM;                                 
          // nombre de pas en 1/2 sec a VCM pour parcourir MMA
          DeltaVitesse = vitesse/DeltaVitesse;                    
          // decrement de vitesse a decompter toutes les 1/2 sec
        } else {         // arriere
          // rien (entree dans canton ligne)
        }
      }
    } else {
      if ((detecteur_ZAR!=prev_detecteur_ZAR)&&(detecteur_ZAR==0)&&(etat_detecteur_ZAR==2))
      { // transition vers 0 en cours de passage de convoi (inter-wagon ou queue)
        etat_detecteur_ZAR = 3; // etat 3 detection retour a 0
        IRdebounceARL = 10;    // armement tempo 1 sec
      } else {
        if ((detecteur_ZAR==1)&&(IRdebounceARL!=0)&&(etat_detecteur_ZAR==3))
        { // interwagon a ignorer
          etat_detecteur_ZAR = 2;
          IRdebounceARL = 0;
        } else {
          if ((detecteur_ZAR==0)&&(IRdebounceARL==0)&&(etat_detecteur_ZAR==3))
          {
            // queue de convoi
            etat_detecteur_ZAR = 0;
            prev_detecteur_ZAR = 0;
            // TRAITEMENT QUEUE DE CONVOI
            digitalWrite(Pin_Arret, LOW);
          }
        }
      }
    }
  }

Capteur de fin de voie

Le capteur de fin de voie (pour éviter une sortie de voie) n’est pas implémenté pour le moment mais son emplacement est prévu pour une évolution future facile. En attendant il est toujours possible d’isoler une petite portion de voie qui forcera le train à s’arrêter (mais il faudra le pousser à la main pour repartir !).

  /////////////////////////////////////////
  // CAPTEUR FIN DE VOIE
  /////////////////////////////////////////
  
  if (!digitalRead(Fin_De_Voie))  // detection si LOW 
  {
    // arret train immediat : eStop et led Rouge allumée
    // vitesse = 0, attente retour potentiometres à zero
    // passage en mode manuel
    
  }

Traitement du mode automatique dans loop()

Loop() ne contient aucun traitement du mode automatique. Ceux-ci sont réalisés dans la fonction SR_demiseconde().

  /////////////////////////////////////////
  // MODE AUTOMATIQUE
  /////////////////////////////////////////
  
  // voir automate dans SR_demiseconde()

Déclenchement des tâches périodiques

Cette portion de code sert à déclencher les tâches périodiques, en utilisant le temps système millis().

  /////////////////////////////////////////
  // TACHES PERIODIQUES
  /////////////////////////////////////////
  
  if ((time500 + 500) < millis())  {
    time500 = time500 + 500;   // pour rattraper les secondes si ça dérape
    SR_demiseconde();          // automate
  }
  
  if ((IRdebounce_time + IRdebtime) < millis()) {  // debouncing detecteurs IR
   IRdebounce_time = millis();
   if (IRdebounceAVH > 0) IRdebounceAVH--;  // tend vers 0 en IRdebtime ms
   if (IRdebounceAVL > 0) IRdebounceAVL--;  // tend vers 0 en IRdebtime ms
   if (IRdebounceARH > 0) IRdebounceARH--;  // tend vers 0 en IRdebtime ms
   if (IRdebounceARL > 0) IRdebounceARL--;  // tend vers 0 en IRdebtime ms
  }
  
  loopduration = micros() - looptime;
  looptime = micros();
  if (loopduration > max_loopduration)
  {
    max_loopduration = loopduration;
  }
  
} // fin de LOOP

La variable 32 bits time500 est comparée au temps système millis() et augmentée de 500 (millisecondes) à chaque concordance. Celle-ci apparait donc toutes les 1/2 secondes. Cela déclenche l’appel de la fonction SR_demiseconde().

J’ai testé divers intervals de temps (1 seconde ; 1/4 seconde) et j’ai trouvé que la demi-seconde est un bon compromis.

La même technique est utilisée pour réaliser des « time-out » ou temporisations de confirmation des détecteurs de passage.

Nous allons entrer maintenant dans les détails de l’automate de circulation.
Il est constitué d’une variable d’état Canton qui peut prendre 6 valeurs (0..5) et d’une variable de direction Dir (avant ou arrière).
Cela fait 12 traitements possibles qui sont réalisé dans une instruction switch.

Mode Automatique - Fonctions de l’automate SR_demiseconde()

Nous allons maintenant passer en revue le module principal de l’automate : la fonction SR_demiseconde() qui s’exécute toutes les demi secondes.

Il gère d’abord le clignotement des Leds, puis le mode automatique.

///////////////////////////////////
void SR_demiseconde()
{

Clignotement des Leds : On utilise 2 bits de poids faible d’une variable de type byte.
Si cet octet est nul (tous les bits à 0) on ne fait rien.
Sinon, le clignotement est dérivé de la valeur du bit 1 qui est inversé à chaque appel de la fonction.

  if (surchargeBooster > 0)  {
    digitalWrite(Pin_Led_Booster, bitRead(surchargeBooster, 1));
    bitWrite(surchargeBooster, 1, !bitRead(surchargeBooster, 1));
  }
 
  if (Rouge_Clignotant > 0)  {
    digitalWrite(Pin_Arret, bitRead(Rouge_Clignotant, 1));
    bitWrite(Rouge_Clignotant, 1, !bitRead(Rouge_Clignotant, 1));
  }
  
  if (Jaune_Clignotant > 0)  {
    digitalWrite(Pin_MAR, bitRead(Jaune_Clignotant, 1));
    bitWrite(Jaune_Clignotant, 1, !bitRead(Jaune_Clignotant, 1));
  }
  
  if (Vert_Clignotant > 0)  {
    digitalWrite(Pin_MAV, bitRead(Vert_Clignotant, 1));
    bitWrite(Vert_Clignotant, 1, !bitRead(Vert_Clignotant, 1));
  }

Automate du mode automatique

Mise à jour de l’état des Leds, à partir des variables DIR (direction) et vitesse.

  //////////// MODE AUTOMATIQUE //////////////
  if (AutoManu) {
     // automate mode automatique (s'execute toutes les 1/2 secondes)
    digitalWrite(Pin_MAV, (DIR && (vitesse != _stop)));  
    //Led Verte si DIR = AVANT ET PAS ARRET
    digitalWrite(Pin_MAR, (!DIR && (vitesse != _stop))); 
    //Led Jaune si DIR = ARRIERE ET PAS ARRET
    digitalWrite(Pin_Arret, (vitesse == _stop));         
    //Led Rouge si ARRET

Automate : Pour chaque sens de circulation (selon DIR) le mouvement du train est décomposé en 6 états appelés « Canton » de façon impropre (au départ il n’y en avait que 3, correspondant aux 3 cantons réels, puis d’autres cas sont apparus nécessaire. Mais le nom de la variable a été conservé). Dans chaque canton, une variable « Pas » évolue (partant d’une valeur initiale définie à la sortie du canton précédent, elle diminue jusqu’à 0, condition de passage au canton suivant, qui peut aussi être provoquée par une détection de barrière infrarouge).
Il y a une variable Pas pour chaque Canton, donc elle se présente sous forme de tableau, bien que ce ne soit pas nécessaire.

A chaque appel de la fonction, la combinaison de DIR et Canton définit un module de traitement. Chaque module est décrit à l’aide de l’instruction « switch » qui est la plus pratique pour ce cas.

Cas de la marche avant :

- 0 : Le train reste à l’arrêt pendant le demi-arrêt en gare 1
- 1 : Le train démarre et accélère jusqu’à atteindre la vitesse définie par le potentiomètre Avant
- 2 : Le train circule à vitesse constante
- 3 : Le train ralenti jusqu’à sa vitesse minimale
- 4- le train roule à vitesse minimale (devant le quai de la gare 2)
- 5 : Le train s’arrête pendant le demi-arrêt en gare 2

    if (DIR)
    {  // Marche avant
      switch (Canton) {

0 : Le train reste à l’arrêt pendant le demi-arrêt en gare 1

On se contente de décrémenter le Pas (configuration duree_arret_gare1)

        case 0:      // AV : arret en gare 1 avant départ
        vitesse = _stop;
        Rouge_Clignotant=0;
        PasAV[Canton]--;           // rester dans canton tant que PasAV > 0
        if (PasAV[Canton] == 0)  { // passage au canton suivant
          Canton = 1;              // passage au canton suivant : acceleration AV
          Vert_Clignotant=3;       
          // vert clignotant = acceleration dans l'etat suivant
        }
        break;

1 : Le train démarre et accélère jusqu’à atteindre la vitesse définie par le potentiomètre Avant

On incrémente la vitesse de la quantité en configuration increment_acceleration jusqu’à atteindre la vitesse de consigne.
On initialise la durée maximale du canton suivant (en cas de défaut du détecteur)

        case 1:  // AV : depart de la gare 1 : acceleration jusqu'a speed_AV
        PasAV[Canton]--;
        vitesse = vitesse + Config_Init.increment_acceleration;   
        if (vitesse > speed_AV)                    
        // acceleration constante, puis vitesse constante
        {
          vitesse = speed_AV;       // vitesse de consigne atteinte
          Canton = 2;
          PasAV[Canton] = TO + 10;  // marge de securite (5 secondes)
                                    // en cas de defaillance de capteur IR
        }
        Vert_Clignotant=0;          // vert fixe : fin acceleration
        break;

2 : Le train circule à vitesse constante

On diminue le Pas d’une unité. La détection de passage doit en principe intervenir avant que Pas = 0.

        case 2:               
        // AV : ligne a vitesse constante jusqu'a detecteur gare 2
        PasAV[Canton]--;            // rester dans canton tant que PasAV > 0
        if (PasAV[Canton] == 0)  {  // passage au canton suivant
          Canton = 3;               // passage au canton suivant : deceleration
          PasAV[Canton]=Config_Init.distance_gare2; 
          // PasAV = distance capteur -> arret gare 2
          Vert_Clignotant=3;        // vert clignotant : deceleration
        }
        break;

3 : Le train ralenti jusqu’à sa vitesse minimale

On réduit la vitesse de façon arithmétique. Celle-ci est diminuée de la variable DeltaVitesse calculée lors du passage aux capteurs).

        case 3:  // AV : ralentissement jusqu' a V min avant arrivee en gare 2
        if (vitesse > Config_Init.vitesse_min)
        {
          PasAV[Canton]--;   // decremente distance parcourue durant 1/2 seconde
          vitesse = vitesse - DeltaVitesse;  // vitesse = deceleration    
          if ((vitesse <= Config_Init.vitesse_min) ||
              (vitesse > 126) ||
              (PasAV[Canton] == 0)) 
          {
            vitesse = Config_Init.vitesse_min;       
            // vitesse est une valeur absolue jamais negative 
            Canton = 4;
            PasAV[Canton]=Config_Init.Nb_Vmin;      
            // PasAV = Nb de 1/2 secondes à vitesse Vmin
          }
        }
        break;

4- le train roule à vitesse minimale (devant le quai de la gare 2)

Pendant quelques Pas, le train roule très lentement, juste avant l’arrêt complet pour simuler la réalité au mieux

        case 4:   
        PasAV[Canton]--;          // decompte les 1/2 secondes a vitesse Vmin
        if (PasAV[Canton] == 0)   // si < 0 passage au canton suivant
        {
          Canton = 5;             // vers canton suivant : arret gare
          PasAV[Canton]=Config_Init.duree_arret_gare2;
          // init 1/2 duree d'arret en gare 2
          Vert_Clignotant=0;      // vert eteint
        }
        break;

5 : Le train s’arrête pendant le demi-arrêt en gare 2

Traitement similaire au cas 0. Mais on change la direction DIR, pour être prêt à repartir dans le sens opposé. L’état Canton est reinitialisé à 5 pour parcourir les 6 cas d’automate décrits juste après.

        case 5:                     // AV : arret en gare 2
        vitesse = _stop;
        PasAV[Canton]--;            // rester dans canton tant que PasAV > 0
        if (PasAV[Canton] == 0)  {  // passage au canton suivant
          DIR = 0;                  // changement de sens : marche AR
          Canton = 5;               // vers canton suivant (marche arrière)
          PasAR[Canton]=Config_Init.duree_arret_gare2;  
          // init 1/2 duree d'arret en gare 2
        }
        break;
      } 
    } // if DIR avant
    else

Cas de la marche arrière :

- 5 : Le train reste à l’arrêt pendant le demi-arrêt en gare 2
- 4 : Le train démarre et accélère jusqu’à atteindre la vitesse définie par le potentiomètre Arrière
- 3 : Le train circule à vitesse constante
- 2 : Le train ralenti jusqu’à sa vitesse minimale
- 1- le train roule à vitesse minimale (devant le quai de la gare 1)
- 0 : Le train s’arrête pendant le demi-arrêt en gare 1

    {  // DIR = 0 arriere
      switch (Canton) {

5 : Le train reste à l’arrêt pendant le demi-arrêt en gare 2

        case 5:                     // AR : arret en gare 2
        vitesse = _stop;
        PasAR[Canton]--;            // rester dans canton tant que PasAV > 0
        if (PasAR[Canton] == 0)  {   
          // passage au canton suivant : acceleration en marche arrière 
          Canton = 4;               // vers canton suivant
          PasAR[Canton] = 30;
          Jaune_Clignotant=3;
        }
        break;

4 : Le train démarre et accélère jusqu’à atteindre la vitesse définie par le potentiomètre Arrière

        case 4:                     // AR : depart de gare 2 : acceleration
        PasAR[Canton]--;
        vitesse = vitesse + Config_Init.increment_acceleration;    
        if (vitesse > speed_AR) 
        {
          vitesse = speed_AR;
          Canton = 3;               // vers canton suivant : ligne
          PasAR[Canton] = TO + 10;
          // butee de securite en cas de defaillance de capteur IR
        }
        Jaune_Clignotant=0;
        break;

3 : Le train circule à vitesse constante

        case 3:  // AR : ligne a vitesse constante jusqu'a detecteur gare 1
        //vitesse constante
        PasAR[Canton]—;               // rester dans canton tant que PasAV > 0
        if (PasAR[Canton] == 0)  {    // passage au canton suivant
          Canton = 2;                 // vers canton suivant : deceleration
          PasAR[Canton]=Config_Init.distance_gare1;    
          // PasAR = distance capteur -> arret gare 1
          Jaune_Clignotant=3;
        }
        break;

2 : Le train ralenti jusqu’à sa vitesse minimale

        case 2:     // AR : ralentissement jusqu' a V min avant arrivee en gare 1
        if (vitesse > Config_Init.vitesse_min)
        {
          PasAR[Canton]--;  // decremente distance parcourue durant 1/2 seconde
          vitesse = vitesse - DeltaVitesse;  //vitesse = deceleration   
          if ((vitesse <= Config_Init.vitesse_min) ||
              (vitesse > 126) ||
              (PasAR[Canton] == 0)) 
          {
            vitesse = Config_Init.vitesse_min;
            // vitesse est une valeur absolue jamais negative 
            Canton = 1;
            PasAR[Canton]=Config_Init.Nb_Vmin;
            // PasAV = Nb de 1/2 secondes à vitesse Vmin
          }
        }    
        break;

1- le train roule à vitesse minimale (devant le quai de la gare 1)

        case 1:     
        PasAR[Canton]--;            // decompte les 1/2 secondes a vitesse Vmin
        if (PasAR[Canton] == 0)  {  // si =  0 passage au canton suivant
          Canton = 0;               // vers canton suivant
          PasAR[Canton]=Config_Init.duree_arret_gare1; 
          // init 1/2 duree arret en gare 1
          Jaune_Clignotant=0;
        }
        break;

0 : Le train s’arrête pendant le demi-arrêt en gare 1

        case 0:                     // AR : 1/2 duree arret en gare 1  
        vitesse = _stop;
        PasAR[Canton]--;            // rester dans canton tant que PasAV > 0
        if (PasAR[Canton] == 0)  {  // passage au canton suivant
          Canton = 0;               // vers canton suivant
          DIR = 1;                  // changement de sens : marche AV
          PasAV[Canton]=Config_Init.duree_arret_gare1; 
          // init 1/2 duree arret en gare 1
        }
        break;
      } // switch canton        
    } // if DIR arriere

Envoi des commandes DCC (vitesse et lumière)

Maintenant que les variables de l’automate ont évolué et que la vitesse à probablement changé, il faut transmettre une nouvelle commande à la bibliothèque CmdrArduino.

En fait, j’ai trouvé qu’il était préférable d’envoyer des commandes DCC toutes les 1/2 secondes, ce que le code fait ci-après :

    // commande DCC de vitesse et lumiere en auto
    _speed = vitesse;
    // préserver la variable vitesse qui est toujours comprise entre 0 et 127
    if (DIR || (vitesse == _stop))
    {
      _speed = -vitesse;   
      // en avant le bit de poids fort est à 1 en 128 pas
    }                      // et à l'arret, la direction est = AVANT   
    if (!dps.setSpeed128(Config_Init.dcc_adresse,DCC_SHORT_ADDRESS,_speed))
    {
      _erreurDPSS = true;
    }
    if (!dps.setFunctions0to4(Config_Init.dcc_adresse,DCC_SHORT_ADDRESS,FL))
    {
      _erreurDPSL = true;
    } // commandes DCC
  }   // if Automanu = Auto
  else
  { // mode manuel : repetition des commandes DCC toutes les 1/2 secondes
    if (!dps.setSpeed128(Config_Init.dcc_adresse,DCC_SHORT_ADDRESS,_speed))
    {
      _erreurDPSS = true;
    }
    if (!dps.setFunctions0to4(Config_Init.dcc_adresse,DCC_SHORT_ADDRESS,FL))
    {
      _erreurDPSL = true;
    } // commandes DCC
  }

Fin de l’automate en mode automatique !

Mise à jour périodique de l’affichage LCD

On profite de cette fonction périodique pour rafraichir les affichages toutes les 1/2 secondes.
Les 3 écrans possibles dépendent de la variable Mode_EnCours

Affichage de la ligne 1

    strcpy_P(buffer, (char*)pgm_read_word(&(string_table[Mode_EnCours])));
    lcd.print(buffer);  // affichage 1ere ligne

Affichage de la ligne 2

    switch (Mode_EnCours)
    {
      case 0:      // Mode_EnCours 0 : normal, affichage "DCC V DIR AV AR "
      lcd.setCursor(2, 1);
      lcd.print(Config_Init.dcc_adresse);
      lcd.setCursor(2, 5);
      lcd.print(vitesse);
      lcd.setCursor(2, 8);
      if (DIR) {lcd.print(">>");} else {lcd.print("<<");} 
      lcd.setCursor(2, 11);
      lcd.print(speed_AV, DEC);
      lcd.setCursor(2, 14);
      lcd.print(speed_AR, DEC);
      break;
      
      case 1:    // Mode_EnCours 1 : normal, affichage "V DIR Canton Pas"
      lcd.setCursor(2, 1);
      lcd.print(vitesse);
      lcd.setCursor(2, 4);
      if (DIR) {lcd.print(">>");} else {lcd.print("<<");} 
      lcd.setCursor(2, 8);
      lcd.print(Canton);
      lcd.setCursor(2, 14);
      if (DIR) {lcd.print(PasAV[Canton]);} else {lcd.print(PasAR[Canton]);}
      break;
      
      case 2:     // Mode_EnCours 2 : normal, affichage "Vit  Km/h  Cm/s "
      lcd.setCursor(2, 1);
      lcd.print(vitesse);
      lcd.setCursor(2, 7);
      lcd.print(VKM);
      lcd.setCursor(2, 13);
      lcd.print(VCM);
      break;
    }    
}

Code source complet de la centrale va-et-vient

Le source complet est ici :

Programme complet de la centrale

Cette version dite b3 (beta 3 datée du 8/11/2014) a été mise en service pendant tout un week-end d’exposition au Plessis-Paté (Essonne).

Durant cette exposition, j’ai pu tester l’effet des réglages de configuration, selon les différents locos qui se sont présentées. En jouant sur la distance capteur-gare ET le nombre de pas de 1/2 secondes à vitesse minimum, on peut obtenir un arrêt très réaliste devant les voyageurs qui attendent sur le quai.

Un petit automate sonore serait du plus bel effet pour animer cette gare. Il serait facile d’ajouter cette fonction à la centrale.

Avec ce dernier article, prend fin la description d’une petite centrale DCC basée sur Arduino.
J’ai testé ce type de centrale sur Uno, Nano, Mini et Mega2560, mais pas encore sur Due.
Sur Uno, Nano, Mini, le sketch occupe seulement la moitié de l’espace de stockage de programmes. Sur Mega, il occupe seulement 6%.
Les variables globales occupent 554 octets donc il reste bien assez de mémoire pour le fonctionnement.

C’est volontairement que le code n’est pas optimisé et écrit de façon simple sans astuces de programmation.

Il peut donc être amélioré, mais est-ce nécessaire ?

Ce projet a été pour moi le fruit de l’accumulation de diverses expériences sur Arduino et sur les trains.

L’exemple du va-et-vient à l’air simple, mais il demande tout de même un code important. Mais de l’automatisme simple décrit ici à quelque chose de plus sophistiqué, la tâche n’est pas énorme :

  • J’ai pensé à mettre 2 trains sur une voie unique avec une gare de croisement au milieu et 2 aiguilles, comme la voie du train de St Gervais au Nid d’Aigle en Haute-Savoie.
  • J’ai déjà réalisé un block system qui stoppe les trains arrivant sur un canton occupé.

Dans tous les cas, un bonne partie du code est récupérable.

Je vous invite à me faire part de vos trouvailles !

Donc à bientôt ...

51 Messages

Réagissez à « Comment piloter trains et accessoires en DCC avec un Arduino (4) »

Qui êtes-vous ?
Votre message

Pour créer des paragraphes, laissez simplement des lignes vides.

Lien hypertexte

(Si votre message se réfère à un article publié sur le Web, ou à une page fournissant plus d’informations, vous pouvez indiquer ci-après le titre de la page et son adresse.)

Rubrique « Projets »

LaBox, Une Centrale DCC polyvalente et abordable (1)

LaBox, Une Centrale DCC polyvalente et abordable (2)

LaBox, Une Centrale DCC polyvalente et abordable (3)

SGDD : Système de Gestion DD (1)

SGDD : Système de Gestion DD (2)

SGDD : Système de Gestion DD (3)

La PWM : Qu’est-ce que c’est ? (1)

La PWM : Qu’est-ce que c’est ? (2)

La PWM : Qu’est-ce que c’est ? (3)

La PWM : Qu’est-ce que c’est ? (4)

Mise en oeuvre du Bus CAN entre modules Arduino (1)

Mise en oeuvre du Bus CAN entre modules Arduino (2)

Un gestionnaire en C++ pour votre réseau (1)

Un gestionnaire en C++ pour votre réseau (2)

Un gestionnaire en C++ pour votre réseau (3)

Un gestionnaire en C++ pour votre réseau (4)

Réalisation de centrales DCC avec le logiciel libre DCC++ (1)

Réalisation de centrales DCC avec le logiciel libre DCC++ (2)

Réalisation de centrales DCC avec le logiciel libre DCC++ (3)

Contrôleur à télécommande infrarouge pour centrale DCC++

Gestion d’une gare cachée (1)

Gestion d’une gare cachée (2)

Gestion d’une gare cachée (3)

La carte Satellite V1 (1)

La carte Satellite V1 (2)

La carte Satellite V1 (3)

La carte Satellite V1 (4)

La carte Satellite V1 (5)

Chenillard de DEL

Enseigne de magasin

Feux tricolores

Multi-animations lumineuses

L’Arduino et le système de commande numérique DCC

Un décodeur d’accessoire DCC versatile basé sur Arduino

Un moniteur de signaux DCC

Une barrière infrarouge

Un capteur RFID

Un TCO xpressnet

Une animation sonore

L’Arduino au coeur des systèmes de pilotage analogiques ou numériques

Calcul de la vitesse d’un train miniature avec l’Arduino

La génèse d’un réseau 100% Arduino

Une horloge à échelle H0

Simulateur de soudure à arc

Un automatisme de Passage à Niveau

Automatisation du pont FLEISCHMANN 6152 (HO) avec un ESP32 (1)

Identifier et localiser vos trains avec le RFID/NFC et un bus CAN.

Etude d’un passage à niveau multivoies

La rétro-signalisation sur Arduino

Décodeur pour aiguillage à solénoïdes sur Arduino

Un décodeur DCC pour les signaux à deux ou trois feux sur Arduino NANO/UNO

Etude d’un passage à niveau universel

Réalisation pratique d’un système de mesure de vitesse à l’échelle N

Une Passerelle entre le bus S88 et le bus CAN pour la rétro signalisation

Un décodeur DCC pour 16 feux tricolores

Block Automatique Lumineux avec la carte shield "Arduino 4 relays"

Réalisation d’un affichage de gare ARRIVEE DEPART

Ménage à trois (Ordinateur, Arduino, réseau)

Réalisation d’un va-et-vient automatique et réaliste

Souris et centrale sans fil

Communications entre JMRI et Arduino

Annonces en gare avec la RFID

Une croix de pharmacie animée avec Arduino UNO

Réalisation d’un wagon de mesure (distance et vitesse)

Passage à niveau géré par Arduino (1)

Passage à niveau géré par Arduino (2)

Passage à niveau géré par Arduino (3)

Passage à niveau géré par Arduino (4)

Passage à niveau géré par Arduino (5)

Une manette simple et autonome pour LaBox

Éclairer le réseau (1)

Éclairer le réseau (2)

Block Automatique Lumineux à 8 cantons analogiques

Un décodeur DCC pour les plaques tournantes Fleischmann et Roco

Éclairer le réseau (3)

Éclairer le réseau (4)

Éclairer le réseau (5)

JMRI pour Ma première centrale DCC

Rocrail pour Ma première centrale DCC

CDM-Rail pour Ma première centrale DCC (1)

CDM-Rail pour Ma première centrale DCC (2)

Banc de test pour les décodeurs DCC

Ma première manette pour les aiguillages DCC

Mon premier décodeur pour les aiguillages DCC

Boitier 3D pour la station DCC minimale

Va-et-vient pour deux trains

Un programme pour régler facilement les servos moteurs avec un ESP32

Affichage publicitaire avec Arduino (1)

Affichage publicitaire avec Arduino (2)

TCO Web interactif avec des ESP32 et des ESP8266 (1)

TCO Web interactif avec des ESP32 et des ESP8266 (2)

TCO Web interactif avec des ESP32 et des ESP8266 (3)

TCO Web interactif avec des ESP32 et des ESP8266 (4)

TCO Web interactif avec des ESP32 et des ESP8266 (5)

Les derniers articles

LaBox, Une Centrale DCC polyvalente et abordable (3)


Thierry

LaBox, Une Centrale DCC polyvalente et abordable (1)


Thierry

LaBox, Une Centrale DCC polyvalente et abordable (2)


Dominique, msport, Thierry

Un programme pour régler facilement les servos moteurs avec un ESP32


bobyAndCo

TCO Web interactif avec des ESP32 et des ESP8266 (5)


utpeca

TCO Web interactif avec des ESP32 et des ESP8266 (4)


utpeca

TCO Web interactif avec des ESP32 et des ESP8266 (3)


utpeca

TCO Web interactif avec des ESP32 et des ESP8266 (2)


utpeca

TCO Web interactif avec des ESP32 et des ESP8266 (1)


utpeca

Affichage publicitaire avec Arduino (2)


catplus, Christian

Les articles les plus lus

Réalisation de centrales DCC avec le logiciel libre DCC++ (3)

La PWM : Qu’est-ce que c’est ? (1)

Comment piloter trains et accessoires en DCC avec un Arduino (1)

Mon premier décodeur pour les aiguillages DCC

La rétro-signalisation sur Arduino

Réalisation de centrales DCC avec le logiciel libre DCC++ (1)

Chenillard de DEL

Mise en oeuvre du Bus CAN entre modules Arduino (2)

LaBox, Une Centrale DCC polyvalente et abordable (1)

Comment piloter trains et accessoires en DCC avec un Arduino (3)