jumeaux-numeriques/volet_roulant/README.md

# Jumeau numérique d'un volet roulant

Ce jumeau numérique permet la programmation en Python d'une maquette réelle d'un volet roulant

## Maquette réelle

La maquette réelle est basée sur des modules AutoProg. Elle est disponible sur le site de l'entreprise A4 technologie : https://www.a4.fr/robotique-programmation/maquettes-automatisees/volet-roulant-automatise.html

Une version auto-construite avec des modules Grove et réalisable à partir de plaque de 3 mm (découpe laser) et d'impression 3D est en cours de conception.

## Maquette numérique

Le modèle 3D est basé sur la maquette développée par l'entreprise A4 technologie. Les documents techniques et pédagogiques signés A4 Technologie sont diffusés librement sous licence Creative Commons BY-NC-SA. 

Site internet de la maquette A4 Technologie : https://www.a4.fr/wiki/index.php?title=Volet_roulant

Il y a deux variantes du modèle 3D : 
- **variante 1** : le mode automatique s'active avec le bouton poussoir **bp_auto** et se désactive avec l'appui sur **bp_m**, **bp_a** ou **bp_d**,
- **variante 2** : le mode automatique s'active et se désactive avec  le bouton à glissière **bg_auto**.

La variante 1 correspond à la maquette réelle de 4A technologie. La variante 2 est une version simplifiée mais uniquement numérique.

## Téléchargement

Les binaires (Game Engine Runtime) sont hébergés sur [phroy.org](https://www.phroy.org/twin.html).

## Instructions

Le script Python qui permet la commande du volet est le fichier **'volrou_cmd.py**. Il est éditable avec tout éditeur (Spyder, Emacs, Pulsar, ...).

#### Actions

Les actions (ordre = True ou False) sont : 
- Monter le volet (moteur sens trigo) : **mot_m(True | False)**
- Descendre le volet (moteur sens horaire) : **mot_d(True | False)**

#### Capteurs

Les compte-rendus des capteurs sont : 
 - Capteur fin de course volet en haut : **fdc_h()** : valeur retournée = True ou False
 - Capteur fin de course volet en bas : **fdc_b()** : valeur retournée = True ou False
 - Capteur de luminosité (LDR) : **lum()** : valeur retournée = entre 0.0 et 1.0

#### Pupitre

Les consignes (valeur retournée = True ou False) du pupitre sont : 
- Bouton poussoir monter volet : **bp_m()**
- Bouton poussoir arrêt volet : **bp_a()**
- Bouton poussoir descendre volet : **bp_d()**
- Bouton poussoir mode automatique : **bp_auto()**

Le retour d'information (allumer = True ou False) du pupitre est : 
- Voyant témoin mode automatique : **voy_auto(True | False)**

#### Gestion du temps

Les temporisations : **tempo(duree)** avec la durée en seconde

## Accès aux données

 - Retourne la valeur de la variable à l'instant : **get(variable)**.
 -  Enregistre les données et génére un fichier de données CSV à l'arrêt du cycle : **daq([variables])**.
 -  Affiche, à l'arrêt du cycle, le chronogramme des données enregristrées : **plot([variables])**.
 
#### Variables publiques : 
- Entrées/sorties : 'bp_m', 'bp_a', 'bp_d', 'mot_m', 'mot_d', 'fdc_h', 'fdc_b', 'bp_auto', 'bg_auto', 'voy_auto' et 'lum'.
- Variables réels (si il y a jumelage) : 'bp_m_r', 'bp_a_r', 'bp_d_r', 'fdc_h_r', 'fdc_b_r', 'bp_auto_r', 'bg_auto_r' et  'lum_r'.
- Autres : 't' (temps), 'mot_angle' et 'mot_vitesse'.

## Jumelage

- Démarrer le jumelage : **jumeau(brochage)**.
- Arrêter le jumelage : **jumeau_stop()**.
- Définit les modes  d'activation des entrées/sorties (True ou False) : **jumeau_mode(entrées réelles, entrées numériques, sorties réelles, sorties numériques)**.

#### Brochage 

Le brochage est un dictionnaire qui permet d'associer les objets 3D du jumeau numérique aux broches du jumeau réel. 

Son format est le suivant : **brochage = { nom:[type, broche, mode] }** :
 - nom : nom de l'objet 3D du jumeau numérique,
 - type : a (analogique) ou d (binaire),
 - broche : numéro de la broche de carte (Arduino, ...),
 - mode : i (entrée), o (sortie) ou p (pwm).

#### Objets 3D du jumeau numérique : 
- Entrées/sorties : 'bp_m', 'bp_a', 'bp_d', 'mot_m', 'mot_d', 'fdc_h', 'fdc_b', 'bp_auto', 'bg_auto', 'voy_auto' et 'lum'.