Piloter son microcontroleur à distance
10 - RemoteXY
Cette page va vous accompagner dans l'utilisation de RemoteXY vous permettant de piloter votre robot à distance.
RemoteXY est une plateforme qui permet de créer des interfaces utilisateur pour contrôler des microcontrôleurs (comme Arduino, ESP32, STM32, etc.) via des appareils mobiles (smartphones ou tablettes). Ces interfaces peuvent inclure des boutons, des curseurs, des joysticks, des indicateurs, etc.
RemoteXY simplifie ainsi la création d’applications interactives sans nécessiter de compétences avancées en développement mobile.
L’application RemoteXY est gratuite, mais elle est limitée à un maximum de 5 éléments. Pour ajouter davantage d’éléments, vous devrez passer à la version Pro, qui est payante.
1. Génération de l’Interface
Avec RemoteXY, vous créez facilement une interface graphique (GUI) en glissant-déposant des éléments comme des boutons, curseurs ou jauges via son constructeur en ligne. Une fois l’interface prête, un code source préconfiguré est généré, adapté au microcontrôleur utilisé (Arduino, ESP32, etc.).
2. Communication
RemoteXY connecte l’application mobile au microcontrôleur via :
3. Code Généré
Le code généré contient :
4. Interaction
Le microcontrôleur échange des données avec l’application mobile :
Cela permet de développer rapidement des systèmes interactifs et évolutifs.
Dans un premier temps, téléchargez l’application sur votre téléphone, soit depuis l’App Store de votre système mobile, soit directement via la page web du projet.
Ensuite, rendez-vous sur la page de l’éditeur d’interface. Vous y trouverez tous les outils nécessaires pour concevoir votre interface. Pour commencer, nous allons créer une application simple permettant de tester un servomoteur à l’aide d’un slider.
Pour cela, glissze déposez un slider sur l’interface et positionnez le à l’endroit désiré. Vous pouvez remarquer sur votre droite des informations liées à ce slider, comme le nom de la variable ou des options graphiques.
changez le nom de variable en slider_servo_D7, puis passez l’option Center position sur Middle.
Dans Configuration, en haut à droite, sélectionnez Bluetooth. Une fenêtre s’ouvre pour vous guider dans la configuration de votre projet.
Dans Board, sélectionnez votre carte, ici ESP32 based board. Dans Module, choisissez Integrated Bluetooth.
Une fois ces paramètres définis, cliquez sur Apply pour valider.
Dans l’onglet Settings, vous pouvez configurer les paramètres de connexion avec votre appareil. Voici les options disponibles :
Device name in app : Le nom de votre équipement tel qu’il apparaîtra dans l’application mobile.Access password : Le mot de passe d’accès. Ce n’est pas obligatoire, mais fortement recommandé pour sécuriser la connexion.Bluetooth name : Le nom de votre équipement visible lors de la recherche d’appareils Bluetooth.Mode : Le type de connexion Bluetooth utilisé, soit classique, soit LE (Low Energy), en fonction des capacités de votre appareil.
Cliquez ensuite sur Get Source Code en haut à droite. Une nouvelle page s’ouvre avec un code généré pour votre application. Cliquez sur download code pour télécharger votre code et l’ouvrir dans l’Arduino IDE, ou copier coller votre code dans un nouveau projet.
Le code généré par RemoteXY contient déjà de nombreuses informations utiles. Avant de le modifier ou de l’adapter à vos besoins, prenons le temps d’examiner sa structure et de comprendre son fonctionnement pas à pas.
Voici une analyse détaillée, ligne par ligne, pour vous aider à mieux appréhender chaque partie du code :
//#define REMOTEXY__DEBUGLOG
#define REMOTEXY_MODE__ESP32CORE_BLE
#include <BLEDevice.h>
REMOTEXY_MODE__ESP32CORE_BLE : Configure RemoteXY pour fonctionner en mode Bluetooth Low Energy (BLE), qui est pris en charge par l’ESP32.#include <BLEDevice.h> : Inclut la bibliothèque pour gérer la communication BLE.#define REMOTEXY_BLUETOOTH_NAME "Otto-BLE"
#define REMOTEXY_ACCESS_PASSWORD "**************"
REMOTEXY_BLUETOOTH_NAME : Définit le nom de l’appareil qui apparaîtra lors de la recherche Bluetooth. Ici, l’appareil sera visible sous le nom “Otto-BLE”.REMOTEXY_ACCESS_PASSWORD : Définit un mot de passe pour sécuriser l’accès. Ce champ est fortement recommandé pour éviter les connexions non autorisées.#include <RemoteXY.h>
#pragma pack(push, 1)
uint8_t RemoteXY_CONF[] = // 42 bytes
{ 255,1,0,0,0,35,0,19,0,0,0,79,116,116,111,45,71,114,111,117,
112,101,32,48,50,0,31,1,106,200,1,1,1,0,4,45,37,13,100,32,
2,26 };
#pragma pack(pop)
RemoteXY_CONF[] : C’est une configuration générée automatiquement qui définit la disposition et les propriétés des éléments de l’interface graphique (GUI).
#pragma pack(push, 1) : Assure un alignement des données en mémoire pour optimiser la communication entre l’appareil mobile et le microcontrôleur.struct {
// input variables
int8_t slider_servo_D7; // from -100 to 100
// other variable
uint8_t connect_flag; // =1 if wire connected, else =0
} RemoteXY;
struct RemoteXY : Structure qui contient les variables liées aux éléments de l’interface :
slider_servo_D7 : Variable correspondant à la position du slider. Elle varie de -100 à 100, ce qui peut être utilisé pour contrôler un servomoteur.connect_flag : Indique l’état de la connexion Bluetooth :
1 : L’appareil est connecté.0 : Aucun appareil n’est connecté.setup()void setup()
{
RemoteXY_Init ();
// TODO you setup code
}
RemoteXY_Init() : Initialise la communication Bluetooth et configure les éléments de l’interface graphique définis dans RemoteXY_CONF[].loop()void loop()
{
RemoteXY_Handler ();
// TODO you loop code
// use the RemoteXY structure for data transfer
// do not call delay(), use instead RemoteXY_delay()
}
RemoteXY_Handler() :
TODO Comments : Ces sections servent à ajouter vos propres instructions pour interagir avec les variables (par exemple, déplacer un servomoteur selon la position du slider).Important : La fonction delay() classique n’est pas compatible avec RemoteXY, car elle bloque le fonctionnement. Utilisez plutôt RemoteXY_delay() pour gérer les temporisations.
RemoteXY.slider_servo_D7.setup() et loop().De manière générale, si vous modifiez l’interface, il n’est pas nécessaire de reprendre l’intégralité du code. Seule la partie liée à la configuration de l’interface graphique (GUI) doit être mise à jour et adaptée pour refléter les changements effectués.
// RemoteXY GUI configuration
#pragma pack(push, 1)
uint8_t RemoteXY_CONF[] = // 42 bytes
{ 255,1,0,0,0,35,0,19,0,0,0,79,116,116,111,45,71,114,111,117,
112,101,32,48,50,0,31,1,106,200,1,1,1,0,4,45,37,13,100,32,
2,26 };
// this structure defines all the variables and events of your control interface
struct {
// input variables
int8_t slider_servo_D7; // from -100 to 100
// other variable
uint8_t connect_flag; // =1 if wire connected, else =0
} RemoteXY;
#pragma pack(pop)
Pour ajouter le pilotage d’un servomoteur connecté à la broche D7 sur un ESP32, en utilisant la valeur du slider généré par RemoteXY, voici les lignes à ajouter ou modifier dans le code :
Ajoutez la bibliothèque ESP32Servo.h en haut du code pour permettre le contrôle du servomoteur.
#include <ESP32Servo.h>
Déclarez un objet pour représenter le servomoteur et une constante pour la broche D7.
Servo servoD7; // Création d'un objet Servo
const int servoPinD7 = D7; // Définir la broche D7
setup()Ajoutez l’instruction pour attacher le servomoteur à la broche D7 dans la fonction setup().
void setup()
{
RemoteXY_Init();
servoD7.attach(servoPinD7); // Attacher le servomoteur à la broche D7
servoD7.write(90); // Positionner le servo au milieu (90°) au démarrage
}
loop()Ajoutez le code dans la fonction loop() pour lire la valeur du slider et l’utiliser pour contrôler le servomoteur. Convertissez la valeur du slider (de -100 à 100) en un angle (de 0° à 180°).
void loop()
{
RemoteXY_Handler();
// Convertir la valeur du slider (-100 à 100) en angle (0° à 180°)
int angle = map(RemoteXY.slider_servo_D7, -100, 100, 0, 180);
// Piloter le servomoteur avec l'angle correspondant
servoD7.write(angle);
}
Une fois le programme modifié, vous pouvez téléverser le code dans la carte et lancer l’application. N’oubliez pas d’installer la librairie RemoteXY dans l’IDE Arduino.
Sur votre téléphone, ouvrez l’application RemoteXY. Appuyez sur + - Add new device, puis sélectionnez Bluetooth. Choisissez la technologie Bluetooth correspondant à celle configurée précédemment dans l’éditeur (classique ou BLE). Votre appareil devrait apparaître dans la liste des connexions Bluetooth. Appuyez sur son nom pour vous connecter, puis saisissez le mot de passe si nécessaire.
Une fois connecté, votre application devrait s’afficher sur votre téléphone. Essayez de déplacer le slider : le servomoteur devrait réagir en suivant les mouvements du slider, ajustant sa position en conséquence.
Dans les chapitres précédents, nous avons vu comment récupérer la distance du capteur ultrason. Nosu allons ici adapter l’interface afin d’afficher cette distance sur votre téléphone.
Ajoutez un élément Value et donnez lui le nom distance_sensor.
Générez le code et copiez uniquement les éléments destinés aux modifications de l’interface.
Ajoutez les lignes de code nécessaires pour récupérer la distance mesurée par le capteur. Veillez à remplacer les delay() par des RemoteXY_delay() si nécessaire. Évitez d’utiliser la liaison série dans ce cas. Nous utiliserons la variable RemoteXY.distance_sensor.
Relancez l’application. Vous devriez voir la distance mesurée par votre capteur s’afficher en dessous.
Trouvez d'autres tutoriels en lien avec le projet
