Projets:Magic Control 2021

Equipe

• Porteurs du projet : Jonathan (MyHumanKit), accompagné par Romane et Marine.
  
• Contribut/eur/rice/s : Christophe (INRIA), Fred (ArianeGroup), Gweltaz (Les portes logiques), Mathilde (ArianeGroup), Mélanie (ArianeGroup), Olivier (ArianeGroup), Tanguy (ArianeGroup).
  
• Fabmanageuse référente : Delphine (MyHumanKit).
  
• Documentation : Pierre (Flossmanuals FR).

Description du projet

Développer un contrôle d'environnement de fauteuil roulant électrique à bas coût permettant de contrôler les fonctions du fauteuil et l'environnement de l'usager via le magic joystick et un contacteur faible pression.

Génèse du projet

Ce projet a démarré au Fabrikarium 2019, organisé avec ArianeGroup sur le site des Mureaux. Cette première étape a permis de développer des premiers prototypes de joystick à faible force (minijoy) et de mettre au point la communication avec le fauteuil par le protocole R-net.
Au Fabrikarium 2020, le projet a été poursuivi en améliorant le joystick par deux prototypes, ainsi qu'en approfondissant l'analyse des trames de communication R-net.

État technique

Plusieurs prototypes existent pour le joystick à faible force. L'interface CAN/R-net est fonctionnelle sur carte raspberry pi.

Documentation des étapes précédentes sur le wiki :

• https://wikilab.myhumankit.org/index.php?title=Projets:Can2RNET
• https://wikilab.myhumankit.org/index.php?title=Projets:Magic_Joystick
• https://wikilab.myhumankit.org/index.php?title=Projets:Magic_Joystick_2020
• code : https://github.com/myhumankit/MagicJoystick2020

Objectifs de cette 3e étape

Objectifs prioritaires

• (groupe 1) Réglage de la calibration du mini-joystick (minijoy)
• (groupe 1) Test de la séquence d'initialisation du fauteuil de Jonathan
• (groupe 1) Ajout d'un bouton d'arrêt d'urgence
• (groupe 2) Emulation de souris (pour androïd ou apple)
• (groupe 3) Ajout d'un bouton pour donner le contrôle au Raspberry Pi
• (groupe 3) Design / expérience utilisateur

Objectifs secondaires

• Ajout d'un switch pour basculer entre JSM et minijoy : mode «passe-plat» ou mode «minijoy»
• Reverse du protocole de contrôle des vérins
• Ajout d'un contrôle de la vitesse maximum et des vérins
• Contrôle d'environnement par application (androïd, ou par techno web, plus portable)
• Ajout d'un écran de contrôle d'environnement
• Ajout de fonctions domotiques

Réalisation des éléments par étape

Mise à jour du schéma du magic joystick

Magic joystick 2021 : réalisé par Christian à distance

Fichiers kicad : fichiers kicad (zip)

Fichiers kicad

Fabrication des connecteurs

Mise à jour du schéma du air joystick

Air joystick 2021 : réalisé par Christian à distance

Fichiers kicad : fichiers kicad (zip)

Groupe 1, capture des trames R-net

Mise en place d'une procédure de capture des trames d'initialisation du fauteuil de Jonathan.

• Se connecter au Pi en SSH
• Dans un terminal de commande

git clone https://github.com/myhumankit/MagicJoystick2020.git
cd ./MagicJoystick2020/
git branch -a
git checkout -b experimental origin/experimental
cd ./can2RNET/
python3 ./setup.py install
cd ..
cd ./RnetMitm/
python3 ./RnetIntercept.py --dual

Pourquoi cherche-t-on cette séquence d'initialisation ?

La séquence d'initialisation permet de simuler et remplacer un JSM par Magic Control, il faut donc pouvoir reproduire cette séquence.
L'étude d'un premier fauteuil avait permis d'enregistrer une séquence d'initialisation, mais un second fauteuil ne démarre pas avec cette séquence.
Donc les séquences varient selon les modèles, il faut pouvoir les enregistrer pour les rejouer ou chercher une méthode alternative.

Groupe 1, bouton d'arrêt d'urgence

Bouton installé en coupure sur le bus R-net : l'interruption des signaux du watchdog stoppe les commandes moteur. Interrupteur de type DPST utilisé en ON/OFF.

Voir Magic Joystick 2020 pour schéma, composants et fichiers de fabrication du boîtier.

Groupe 2, simuler une souris bluetooth

L'objectif est de permettre en appuyant sur un bouton d'utiliser le joystick du fauteuil comme pointeur de navigation dans l'interface du contrôle d'environnement. Le développement s'appuie sur le script d'émulation développé et documenté par Thanh, en l'adaptant au projet :

• https://thanhle.me/emulate-bluetooth-mouse-with-raspberry-pi/
• https://github.com/quangthanh010290/keyboard_mouse_emulate_on_raspberry

La procédure d'installation est décrite sur le dépôt github d'origine.

Groupe 3, calibration logicielle du magic joystick

TODO / Refonte du code

Groupe 3, design utilisateur du contrôle d'environnement

Schéma actuel de la navigation dans l'application de contrôle d'environnement (joystick : navigation, clic : sélection)

Détails sur le fichier pdf : schéma de l'application de contrôle d'environnement (pdf)

Voir-ci-dessous pour la nouvelle interface web

Réalisation du prototype complet

Architecture hardware

Matériel requis

Ce projet nécessite de la découpe laser, de l'impression 3D et du matériel de fabrication électronique (réalisation du joystick, des cables, etc.), ainsi que les éléments suivants :

• un magic joystick 2020
• un bouton d'arrêt d'urgence (cf. magic joystick 2020)
• un cable R-Net avec connecteurs intercalés (cf. magic joystick 2020)
• deux contacteurs à faible pression
• une carte raspberry pi 3 avec système Debian 10 Buster sur carte micro-SD
• une carte PiCAN2
• (option) un dongle USB-Bluetooth pour se connecter à un ordinateur (afin d'avoir 2 connexions bluetooth sur rpi)

Principe d'initialisation

L'initialisation est faite par RNetCtrl selon la séquence suivante :

• fig. 1 : le JSM envoie des trames d'initialisation sur le bus R-Net, RNetCtrl fonctionne en passe-plat, transmettant les trames au moteur.
• fig. 2 : une fois la dernière trame d'initialisation du JSM reconnue, RNetCtrl arrête de transmettre les trames du JSM. En revanche il continue à transmettre les trames du watchdog, toutes les 10 millisecondes, afin que le moteur continue de fonctionner.
• fig. 3 : Et voilà! RNetCtrl transmet au moteur les commandes fournies par le Magic Joystick et les trames du watchdog.

Architecture logicielle

Après avoir examiné plusieurs scénarii, le choix de l'équipe se porte sur un broker MQTT, qui permet à chaque brique logicielle de publier ou de s'abonner à des flux de données.

L'intégralité du code source est accessible dans le dépôt git : https://github.com/myhumankit/MagicJoystick2020

Points de montage MQTT

Interface web

L'interface est accessible sur un serveur http en wifi depuis le téléphone via Firefox. Il faudra ajouter un couche de sécurité pour que l'interface ne soit accessible que par l'utilisateur.

L'ordinateur de bord permet de choisir ce qu'on contrôle via le magic joystick :

• la conduite du fauteuil pour se déplacer ainsi que toutes les autres fonctionnalités accessibles : lumières, klaxon, vérins
• naviguer sur le PC ou téléphone via le bluetooth
• afficher l'heure et le niveau de batterie du fauteuil sur tous les écrans
• configurer la température du chauffe-main
• accéder aux paramètres d'alimentation de l'ordinateur de bord pour le mettre en veille, l'arrêter ou le redémarrer

A développer :

• domotique (fenêtre, porte, volets etc..)
• équipement (TV, lecteur DVD, chaîne hifi )

Modalités de navigation dans l'interface :

• clic long avec contacteur pour sortir du mode bluetooth quand le joystick est utilisé comme souris pour naviguer sur PC.
• clic court avec contacteur pour sortir du mode "conduite" (quand le joystick sert à conduire le fauteuil), et retourner en mode "navigation" dans l'interface.

Pour passer d'un sous-menu à l'autre dans les fonctionnalités du fauteuil (en mode vérins, lumière), on utilise le joystick gauche/droite pour faire défiler les sous-menus.
En mode lumière, le joystick haut, permet d'activer la fonction, le joystick bas permet de désactiver.
En mode vérins, le joystick haut et bas permet de monter ou descendre le vérin sélectionné.

Reste à implémenter dans l'interface :

• Sur l'écran Fauteuil
  • les différents vérins : pied gauche, droit, les deux, le dossier, le lift, l'assise (inclinaison)
  • le sous menu des lumières : clignotant gauche, droit, et warning
• Sur l'écran Bluetooth
  • le choix de l'appareil bluetooth (PC ou tel), le choix des différents clics (gauche, droit, double clic, maintien, triple clic). (icônes à préparer)
  • l'écran Chauffe-main
  • l'écran Alimentation : Veille, Arrêt, Redémarrage, Retour. (icônes à préparer)

Pour plus tard :

• l'écran domotique
• l'écran maison

Notes sur la nouvelle interface web :

réalisation, installation et démarrage

• Fabriquer les éléments (contacteurs faible pression, magic joystick, cables)
• Installer les logiciels sur le Raspberry Pi
  • Installation du système Debian 10 Buster
  • Cloner le dépôt github sur le Raspberry Pi
  • Lancer le script de configuration (procédure décrite sur github)
• Hors tension, relier le circuit de Magic Control au fauteuil
• !TODO! compléter la procédure de démarrage

Composants et circuits électroniques utilisés

Carte Raspberry Pi 3 model B+

Pour ce projet, la carte est dotée d'un système Debian 10 Buster sur carte micro-SD 8 GO

https://www.raspberrypi.com/products/raspberry-pi-3-model-b-plus/

Carte PiCAN2 Duo

Carte électronique additionnelle pour Raspberry Pi 3/4 avec double interface pour bus CAN et transformateur d'alimentation (SMPS) capable de fournir 3A. Fabriquée par SK Pang.

https://www.skpang.co.uk/collections/hats/products/pican2-duo-can-bus-board-for-raspberry-pi-4-with-3a-smps

Lexique

Broker MQTT : Le broker MQTT est un serveur qui reçoit tous les messages des clients et les aiguille vers les clients de destination appropriés.

CAN (Controller Area Network) : Bus de communication série utilisé en électronique, particulièrement dans l'industrie automobile. Il fonctionne sur le principe du multiplexage ou chaque équipement connecté communique avec tous les autres. https://fr.wikipedia.org/wiki/Bus_de_donn%C3%A9es_CAN

JSM (Joystick Module) (module électronique d'un fauteuil) joystick d'assistance à l'arrière du fauteuil, prioritaire sur le contrôle du déplacement.

MQTT (Message Queuing Telemetry Transport) : protocole de messagerie *publish-subscribe* basé sur TCP-IP (cf. MQTT sur wikipedia) + d'infos : https://mqtt.org/

PiCAN : carte additionnelle pour Raspberry Pi, permettant de s'interfacer à un bus CAN. Il en existe plusieurs variantes, celles utilisées pour ce fabrikarium est une PiCAN2 Duo.

R-net : Le protocole R-net définit des commandes qui passent sur un bus CAN. Il a été mis au point en 2011 par PGDT (PG Drives Technology) pour le contrôle des fauteuils électriques. Il s'agit d'un protocole propriétaire, en 2016 des informations sur ce protocole ont été trouvées par Stephen Chavez par ingénierie inverse pour le projet https://github.com/redragonx/can2RNET.

Raspberry Pi : nano-ordinateur sur carte électronique unique équipé d'un système linux Debian.

Trame CAN : série de bits envoyée sur le bus CAN et interprêtée par le JSM et le contrôleur de moteur.

Watchdog : trame périodique surveillée afin de détecter une éventuelle rupture de communication.

Journal du projet

Premier jour, matin

• Présentation des étapes précédentes du projet.
• Présentation de l'état technique actuel.
• Définition des objectifs primaires et secondaires du fabrikarium.
• Répartition en 3 groupes pour un premier passage en revue des solutions.

Premier jour, après-midi

Poursuites des pistes définies le matin pour les 3 groupes

Synthèse présentée à la présentation de fin de journée

Programme des 3 groupes de travail

Jour 2, matin

• Amélioration de l'algorithme de calibration (calculs de matrices).
• Design graphique de l'interface utilisateur du nouveau contrôle d'environnement.
• Essai (concluant!) d'une nouvelle méthode d'intégration sur le bus R-net.
• Définition du système client-serveur pour le contrôle d'environnement.(point d'accès wifi, serveur flask).
• Programmation de l'interface web de contrôle d'environnement.
• Mise au point de l'architecture hardware.

Jour 2, après-midi

• Réflexion sur l'architecture logicielle, plusieurs pistes sont esquissées.
• Poursuite du design graphique du contrôle d'environnement.
• Développement logiciel par itérations et POCs

Document de la restitution du jour 2 : présentation (pdf)

Jour 3, matin

• Petit point : jusqu'où essaie-t-on d'aller aujourd'hui ?
• Définition des mountpoints de publication MQTT
• Dév. du code intensif

Jour 3, après-midi

• Dév. du code intensif
• Bouclage pour préparer la démo
• Préparation de la présentation