EN FR AR 🤖 App Robot ⭐ GitHub

Maqueen Lab — Guide complet

Explication détaillée de chaque bouton, mode, onglet et fonctionnalité — avec schémas et animations.

🔗

Connexion au robot

Maqueen Lab se connecte à ton robot via Bluetooth Low Energy (BLE) directement depuis le navigateur — pas d'installation, pas de câble.

📍 Bouton bleu en bas à gauche de l'écran
🔗CONNECT
Non connecté
cligne en bleu →
clique dessus →
sélectionne micro:bit →
disparaît = connecté ✅

📋 Étapes de connexion

1
Allume le robot — interrupteur sous le châssis → LED rouge du micro:bit s'allume.Si le micro:bit est éteint, aucune connexion n'est possible.
2
Ouvre Chrome ou Edge — les seuls navigateurs avec Bluetooth Web.Firefox et Safari iPhone ne supportent pas l'API Bluetooth.
3
Tape le bouton 🔗 CONNECT en bas à gauche — une liste Bluetooth s'ouvre.
4
Sélectionne "BBC micro:bit [XXXXX]" dans la liste, puis clique Jumeler.
5
Le bouton bleu disparaît — le robot est connecté. La batterie s'affiche en haut.
⚠️
Navigateurs supportés : Chrome (Android, Mac, Windows) et Edge (Windows). Pas Firefox, pas Safari iPhone.
💡
Micro:bit absent de la liste ? Appuie sur Reset au dos du micro:bit, attends 3 s et réessaie.

🔋 Indicateur de batterie

Une fois connecté, la tension de la batterie s'affiche en haut de l'app (ex. 3.8 V · 72 %). Si la batterie est faible (<3.5 V), la couleur passe au rouge — remplace les piles pour une conduite stable.

Bouton STOP — Sécurité absolue

Le bouton STOP est la règle n°1 de la robotique. Il est toujours visible, quel que soit l'endroit de la page.

STOP
Bas à droite
toujours visible

Ce bouton rouge :

🛑
Coupe les moteursEnvoie STOP via BLE immédiatement
🚦
Annule tous les modesAuto-wander, autopilot, macro, tilt, voix…
💡
Flash visuelConfirme que l'ordre a bien été envoyé

⌨️ Raccourci clavier : Échap

Sur ordinateur, la touche Échap (Escape) déclenche le même arrêt d'urgence — encore plus rapide que cliquer !

Bonne pratique : Avant de faire rouler le robot, teste toujours le bouton STOP une première fois pour être sûr qu'il répond bien.
🤖

Onglet 🤖 Maqueen

L'onglet principal — conduite, modes automatiques, jeux, tableau de bord et carte SLAM. C'est ici que tu passes 90 % du temps.

📐 Structure de l'onglet (de haut en bas)

SectionContenu
🏁 DrivePavé directionnel + curseur vitesse + barre de macros (modes, jeux, copilot…)
📊 Dashboard4 jauges live : Vitesse, Puissance, Cap, Sonar
🗺️ Carte SLAMTracé en temps réel avec boutons de la carte (photo, timelapse, autopilot…)
🎮 JeuxSLAM the Room, Drift, Soccer, Math, Race, Echo Hunt, Simon, Morse…
🎵 MusiquePiano 8 touches, buzzer fréquence/durée
💡
Les sections se masquent automatiquement selon le profil de densité choisi (Débutant / Standard / Hacker). Si tu ne vois pas une section, change le profil dans ⚙ Réglages.
🎛️

Onglet 🎛️ Controls

Contrôle brut des composants — moteurs, servos, LEDs, buzzer. Idéal pour tester chaque pièce individuellement ou calibrer.

⚙️ Moteurs gauche / droite

Deux curseurs indépendants (−255 à +255) pour chaque moteur. Parfait pour tester si un moteur est plus puissant que l'autre et comprendre la conduite différentielle.

💡
Mets L=150 R=150 → avance droit. L=150 R=50 → vire à droite. L=−100 R=100 → tourne sur place.

🦾 Servo S1 & S2

Contrôle direct de l'angle (0–180°) ou de la vitesse pour les servos à rotation continue. Voir la section Servos & sonar pour le détail complet.

🌈 LEDs NeoPixel

Sélecteur de couleur + 4 boutons préréglés. Agit sur les 4 LEDs WS2812 en même temps.

🔊 Buzzer

Curseur fréquence (50–2000 Hz) + curseur durée (10–5000 ms) + bouton ▶ Bip. Joue une note unique au PWM du micro:bit.

📡

Onglet 📡 Sensors

Lecture en direct de tous les capteurs du micro:bit et du Maqueen. Utile pour diagnostiquer et pour les activités scientifiques.

🔘 Boutons A / B

Affiche l'état (appuyé / relâché) des boutons physiques du micro:bit. Tu peux les utiliser pour déclencher des actions dans ton code.

📐 Accéléromètre

X, Y, Z en temps réel. Secoue le robot ou incline le micro:bit — les valeurs changent instantanément. Base du mode Tilt-to-Drive.

🧭 Boussole (magnétomètre)

Cap en degrés (0–360°, 0 = Nord). Doit être calibrée une fois (tourner le micro:bit dans tous les sens). Utilisée par Drift Champion et le heading lock.

💡 Capteur de lumière

Valeur 0–255 de la luminosité ambiante. Les LEDs du micro:bit servent de photodiodes — simple mais efficace.

🔈 Capteur sonore

Niveau sonore ambiant (micro:bit V2 uniquement). Utile pour les activités de mesure du bruit ou pour déclencher des actions sur bruit fort.

🌡️ Température

Température du processeur du micro:bit en °C. Approximative (±2–3°C) mais suffisante pour des expériences comparatives.

📈

Onglet 📈 Graph

Trace des courbes en temps réel de n'importe quelle valeur de capteur. Parfait pour l'analyse scientifique et les exposés.

Comment l'utiliser

1
Sélectionne le capteur à tracer (sonar, vitesse, cap, lumière…) dans le sélecteur en haut.
2
La courbe se trace automatiquement en temps réel pendant que le robot bouge.
3
Utilise les boutons Export CSV ou Export JSON pour télécharger les données brutes pour un tableur.
💡
Idée pédagogique : Trace la distance sonar pendant l'Auto-Wander — tu vois exactement comment le robot "voit" les obstacles et décide de tourner.
🧊

Onglet 🧊 3D

Modèle 3D interactif du micro:bit qui reflète l'état réel du robot en temps réel.

Ce qu'il montre

🔄
Rotation 3DLe modèle tourne et s'incline avec l'accéléromètre réel du micro:bit
💡
LEDs alluméesLa matrice LED 5×5 du micro:bit s'affiche en 3D
🖱️
Navigation sourisClic + glisser pour faire pivoter le modèle manuellement
🕹️

Pilotage manuel

Conduis le robot avec les flèches à l'écran ou les touches du clavier. C'est la base de tout !

📍 Onglet 🤖 Maqueen → section Drive

🎮 Pavé directionnel

⬆️
⬅️
➡️
⬇️

Maintiens appuyé → le robot bouge
Relâche → il s'arrête

⌨️ Équivalents clavier

Avance
Recule
Tourne gauche
Tourne droite
ÉchapSTOP d'urgence

⚡ Curseur de vitesse — SPEED

Règle la puissance moteur de 0 à 255. Tous les modes (wander, autopilot, tilt, copilot…) respectent cette limite.

Débutant
100
Standard
175
Max
255
💡
Commence à 100 pour apprendre. Monte à 200+ quand tu maîtrises l'espace disponible.

📼 Enregistrement de macro

🔴
Bouton RECLance l'enregistrement — chaque commande (direction + durée) est capturée
▶️
Bouton REPLAYRejoue exactement la séquence enregistrée, à la même vitesse
💡
Pourquoi c'est utile : Enregistre un parcours complexe une seule fois, puis rejoue-le en boucle pour une démo ou un concours de précision.
🚗

Modes de pilotage automatiques

Six façons différentes de contrôler le robot — du pilote autonome au geste de la main.

🚦 Auto-Wander — exploration autonome

Qu'est-ce que c'est ? Le robot avance seul, détecte les obstacles avec le sonar et tourne pour les éviter. Il explore la pièce sans aucune intervention humaine.

Comment ça marche ? Un sonar orientable balaye de gauche à droite. Quand il détecte un mur à moins de X cm, le robot choisit le côté le plus libre et tourne.

🤖 obstacle ! vire !
Le robot détecte l'obstacle (🟡) et vire du côté libre (flèche verte)
Rapide
Vitesse élevée, seuil de détection court — fonce et vire vite
Vitesse
Prudence
🐢
Prudent
Lent, seuil large — vire longtemps avant les obstacles
Vitesse
Prudence
🔍
Curieux
Balayage sonar très large — explore systématiquement
Vitesse
Balayage
😴
Fainéant
S'arrête souvent, balayage rare — économe en batterie
Vitesse
Pauses

📱 Tilt-to-Drive — pilotage par inclinaison

Qu'est-ce que c'est ? Tu tiens le téléphone comme un volant de voiture et le robot répond à tes inclinaisons.

📱↗️
Incline en avant
→ Avance
📱↙️
Incline en arrière
→ Recule
📱↔️
Penche à droite/gauche
→ Tourne
📍 Bouton 📱 dans la barre de macros Drive
💡
Sur iOS 13+, l'app demande une permission d'accès aux capteurs de mouvement. Accepte-la ! Si tu cliques "Refuser", le bouton affiche ❌ — va dans Réglages → Safari → Accès aux capteurs de mouvement.

🎙️ Commandes vocales

Parle au micro de ton téléphone — le robot obéit à ta voix !

Mot(s) reconnusAction
avance / forward / go⬆️ En avant
recule / backward / back⬇️ En arrière
gauche / left⬅️ Tourne gauche
droite / right➡️ Tourne droite
stop / arrête■ STOP
plus vite / faster⚡ +25 vitesse
moins vite / slower🐢 −25 vitesse

👯 Co-Pilot — 2 joueurs, 1 clavier

Principe : Deux enfants partagent le même clavier. L'un contrôle l'accélération, l'autre la direction. Aucun ne peut conduire seul — il faut coopérer !

👧 Joueur 1
W Avance
S Recule
👦 Joueur 2
J Gauche
L Droite
🖍️

Dessine & Roule — Autopilot

Trace un chemin du doigt sur la carte — le robot le suit exactement grâce à un contrôleur de cap proportionnel.

📍 Bouton 🖍️ dans la barre de la carte SLAM

📐 Comment ça marche (la physique)

À chaque instant (10 fois/seconde), le robot calcule :

  1. L'angle vers le prochain waypoint (point du tracé)
  2. La différence avec son cap actuel (= erreur)
  3. La correction moteur proportionnelle à cette erreur
  4. Le waypoint est "atteint" quand le robot passe à moins de 6 cm
🤖 cap cible départ arrivée

🖱️ Étapes d'utilisation

1
Clique sur 🖍️ dans la barre de la carte — le curseur devient une croix.
2
Maintiens appuyé sur la carte et trace une courbe douce.Des points violets capturent le tracé toutes les 2 cm de déplacement.
3
Relâche — le robot démarre immédiatement.
4
Les boutons 💾 🔁 📂 apparaissent automatiquement sous les boutons de la carte.

💾 Enregistrer

Télécharge le chemin en fichier .json. Le fichier contient tous les waypoints en coordonnées monde (cm).

💡
Le fichier est sauvegardé même APRÈS la course — les waypoints d'origine sont conservés.

🔁 Rejouer

Relance exactement le même chemin depuis le début sans avoir à redessiner.

Parfait pour comparer plusieurs runs ou faire une démo répétée.

📂 Charger

Ouvre un fichier .json sauvegardé. Le chemin s'affiche sur la carte et le robot part automatiquement.

💡
Astuce : Dessine sur une carte "propre" (après ↺ effacer) pour que le point de départ du chemin corresponde à la position réelle du robot.
⚠️
Le robot suit le chemin en coordonnées odométriques — si le sol est glissant ou les piles faibles, la position estimée dérive et le robot s'écarte du tracé.
📊

Tableau de bord

4 jauges en temps réel + 4 compteurs de trajet. Tu vois exactement ce que fait le robot à chaque instant.

📍 Onglet 🤖 Maqueen → section Dashboard
87
cm/s · Vitesse
68%
Puissance
324°
Cap
18cm
Sonar

🔵 Vitesse (cm/s)

Vitesse réelle estimée des roues, calculée à partir de la PWM moteur et de la tension batterie. S'affiche en cm/s.

Utile pour l'activité Math the Distance : tu connais la vitesse réelle pour calculer d = v × t.

🟢 Puissance (%)

Pourcentage du curseur de vitesse actuel par rapport au maximum (255). Reflète exactement où tu as mis le curseur SPEED.

🟡 Cap (°)

Direction du robot, de 0° à 360° (0° = Nord). Calculé à partir de la boussole ou de l'odométrie des roues selon le mode actif.

Quand le cap boussole est verrouillé (🎚 LOCK), cette jauge affiche la boussole — plus précis sur longue distance.

🔴 Sonar (cm)

Distance de l'obstacle le plus proche détecté par le sonar HC-SR04. Rouge quand inférieur au seuil d'alerte. La valeur clignote quand le robot est en mode wander et détecte un mur.

🛣️ Compteurs de trajet

CompteurMesureSe remet à 0
📏 ODODistance totale depuis le premier démarrageJamais (persistant)
🔄 TRIPDistance depuis la dernière connexionÀ chaque connexion
🚀 PEAKVitesse maximale atteinte en cm/sManuellement ou reconnexion
📈 AVGVitesse moyenne sur la sessionÀ chaque connexion
🗺️

Carte SLAM — Odométrie en temps réel

La carte dessine le trajet du robot en direct. SLAM = Simultaneous Localization And Mapping — la même technologie que dans les voitures autonomes !

📍 Onglet 🤖 Maqueen → SVG interactif sous le Dashboard
🤖 0,0 trajet obstacle

🔘 Boutons de la carte (barre d'icônes)

📸
PhotoTélécharge une image PNG haute résolution de la carte actuelle — parfaite pour un compte-rendu ou une affiche
🎬
TimelapseGénère une vidéo WebM accélérée (×10) montrant l'évolution du trajet sur 6 secondes
🖍️
Dessine & RouleTrace un chemin sur la carte — le robot le suit (voir section Autopilot)
📷
ARMode réalité augmentée — superpose la carte sur le flux de la caméra du téléphone
🍩
BilanRésumé de session : distance parcourue, obstacles rencontrés, vitesse max, durée
✏️
Pen / StyloLe robot trace avec une vraie plume montée sur le servo S2 — active ce mode et le servo descend pour dessiner sur papier
EffacerRemet la carte à zéro et repositionne le robot à l'origine (0,0). Irréversible !

🎯 Mode Challenge — suis une forme

Sélectionne une forme cible dans le menu Challenge (sous la carte) :

🟦 Carré
4 × 4 tours
⭕ Cercle
rayon 30 cm
∞ Figure 8
deux boucles

La forme apparaît en pointillés sur la carte. Un score live mesure à quel point ton tracé correspond au modèle. Le meilleur score est sauvegardé.

🎮

Mini-jeux

10 jeux qui mêlent robot, capteurs, physique et réflexes. Tous les meilleurs scores sont sauvegardés automatiquement.

🛰️
SLAM the Room
📍 Section Jeux → SLAM
Explore un maximum de cases de 10×10 cm en 60 secondes. La carte compte chaque cellule unique visitée. Lance le chrono, conduis dans tous les coins de la pièce !
🏆 Score = nombre de cases · Persistant
🎯
Drift Champion
📍 Section Jeux → Drift
Conduis le plus droit possible pendant 60 s. La boussole mesure en continu l'écart entre ton cap et la direction initiale. Erreur = dérive en degrés.
🏆 Score = 100 − dérive_moyenne°
🧱
Maze Runner
📍 Section Jeux → Maze
Active ce mode : vitesse basse, seuil de détection serré, balayage sonar étroit. Guide le robot dans un labyrinthe fait de livres ou de boîtes sans toucher les murs !
🏆 Construis le labyrinthe le plus long possible
Robot Soccer
📍 Section Jeux → Soccer
Scoreboard pour 2 équipes (Rouge vs Bleu). Pilote le robot pour pousser une balle dans le but de l'adversaire. Compte les buts avec les boutons +1.
🏆 Premier à X buts gagne la coupe !
🎯
Echo Hunt
📍 Section Jeux → Echo
Un trésor invisible est placé aléatoirement sur la carte. Le sonar émet des bips audio qui s'accélèrent quand le robot s'approche (chaud/froid robotique).
🏆 Trouve le trésor en moins de temps
📐
Math the Distance
📍 Section Jeux → Math
L'app donne une vitesse + un temps. Calcule d = v × t, entre ta réponse, puis lance le robot pour vérifier. L'odométrie mesure la distance réelle.
🏆 Score = précision de ton calcul en %
🏁
Line Race
📍 Section Jeux → Race
Chronomètre avec boutons Start et Lap. Trace un circuit sur le sol avec du scotch, fais des tours et bats ton meilleur temps de tour.
🏆 Meilleur tour ⚡ sauvegardé auto
🔴
Simon Says
📍 Section Jeux → Simon
Jeu de mémoire classique. L'app allume les LEDs Maqueen dans un ordre aléatoire. Reproduis la séquence sur les boutons colorés à l'écran. La séquence s'allonge à chaque bon tour.
🏆 Record de longueur de séquence sauvegardé
• − •
Morse Code
📍 Section Jeux → Morse
Le buzzer du robot joue un mot en code morse (points et tirets sonores). Transcris ce que tu entends lettre par lettre dans le champ de texte.
🏆 Score = lettres correctes / total
🎯
Challenge Shape
📍 Carte → Challenge
Sélectionne carré, cercle ou 8. La forme s'affiche en pointillés sur la carte. Conduis le robot aussi près du tracé idéal que possible. Score live calculé en temps réel.
🏆 Meilleur score par forme sauvegardé
🎵

Musique & sons

Piano 8 touches, buzzer personnalisé et jeux de rythme — le robot fait aussi de la musique !

🎹 Piano (Buzz Tune)

8 touches blanches couvrant une octave (Do → Do). Chaque touche joue simultanément :

  • La note sur le buzzer PWM du robot
  • La même note en Web Audio (dans le navigateur)

Bouton Demo → joue "Au Clair de la Lune" automatiquement.

🔊 Buzzer personnalisé

Deux curseurs indépendants :

  • Fréquence : 50–2000 Hz (grave → aigu)
  • Durée : 10–5000 ms (court → très long)

Bouton ▶ Bip joue la note. Idéal pour coder des signaux personnalisés dans ton programme micro:bit.

🦾

Servos & sonar

Le Maqueen a 2 ports servo. S1 est généralement le support sonar (balayage), S2 peut porter un stylo ou un bras.

🎛️ Deux modes pour chaque servo

🎯 Mode Position (0–180°)

Le servo va à une position angulaire précise. Utilise le curseur ou les boutons préréglés :

Full 0–180° Front 60–120° Left 0–90° Right 90–180°
🔄 Mode Rotation continue

Pour les servos 360°. Curseur de −255 à +255 :

  • Valeur positive → tourne dans un sens
  • Valeur négative → sens inverse
  • 0 → arrêt

🔭 Balayage automatique du sonar

Le sonar peut balayer automatiquement de gauche à droite pour cartographier tout l'espace devant le robot. Règle les angles de début et fin, puis active le balayage.

🔭
L'Auto-Wander utilise ce balayage pour décider du meilleur sens de virage quand un obstacle est détecté — il cherche le côté le plus libre.
💡

LEDs NeoPixel & buzzer

4 LEDs RGB WS2812 adressables + buzzer PWM — le robot peut signaler, décorer et jouer de la musique !

🌈 LEDs NeoPixel

Le Maqueen dispose de 4 LEDs RGB (2 à l'avant, 2 à l'arrière). Tu peux :

🔴 Rouge
🟢 Vert
🔵 Bleu
🟡 Jaune
🎨 Couleur perso
💡
Les LEDs clignotent automatiquement en rouge quand le sonar détecte un obstacle à moins du seuil d'alerte wander — ton robot "rougit" de peur !
🎬

Export vidéo

Partage ta session avec une vidéo générée automatiquement — timelapse ou vlog complet.

🎬 Timelapse

Bouton dans la barre de la carte

Génère une vidéo WebM de 6 secondes accélérée ×10 montrant :

  • L'évolution du tracé vert sur la carte
  • L'apparition des obstacles jaunes
  • La progression du robot pas à pas

🎥 Vlog YouTuber

Bouton 🎥 dans la barre de la carte

Vidéo ~25 secondes de qualité profesionnelle :

  1. Carte de titre animée
  2. Timelapse du trajet
  3. Panneau de statistiques
  4. Narration vocale optionnelle (Web Speech TTS)
⚙️

Réglages & Profils de densité

Adapte l'interface à ton niveau — de l'enfant de 6 ans au maker confirmé.

🎚️ Profils de densité

Le profil masque ou affiche des sections entières selon le niveau de l'utilisateur :

ProfilCe qui s'affichePour qui ?
🐣 DébutantPavé + vitesse + STOP uniquementEnfants 6–8 ans, première utilisation
🎓 StandardDashboard + modes + carte + jeuxUtilisation régulière — défaut
🥷 HackerTout + BLE sniffer + debug + export brutDéveloppeurs, enseignants, makers
🎬 DémoDébutant + auto-wander pré-arméPrésentations, stands, showcases

🌍 Langue

Bascule entre Français 🇫🇷, English 🇬🇧 et عربي 🇲🇦. Toute l'interface se traduit instantanément — boutons, labels, messages d'erreur, aide.

🎨 Thème visuel

Trois thèmes disponibles :

  • Cosmos — bleu nuit, défaut
  • Workshop — tons chauds orange/brun
  • Stealth — noir absolu, très contrasté
⌨️

Raccourcis clavier

Sur ordinateur, tout se fait plus vite avec les touches. Voici la liste complète.

ToucheActionDisponible quand
Échap🛑 Arrêt d'urgence — priorité absolueToujours
Avance / Recule / Gauche / DroitePavé directionnel actif
W SThrottle Co-Pilot (Joueur 1)Co-Pilot activé
J LDirection Co-Pilot (Joueur 2)Co-Pilot activé
EspaceFocus sur le pavé directionnelToujours
TabCycle entre les onglets principauxToujours
🔧

Dépannage

Solutions aux problèmes les plus fréquents — essaie dans l'ordre indiqué.

🔗 Le micro:bit n'apparaît pas dans la liste Bluetooth

1
Vérifie que tu utilises Chrome ou Edge — pas Firefox, pas Safari.
2
Vérifie que le Bluetooth est activé sur ton téléphone/ordinateur.
3
Appuie sur le bouton Reset au dos du micro:bit → attends 3 s.
4
Si tu étais déjà jumelé, va dans les Réglages Bluetooth du système → oublie le micro:bit → réessaie.

🚗 Le robot ne s'arrête pas

🚨
Appuie immédiatement sur Échap ou le bouton rouge ⏹ STOP. Si ça ne marche pas, appuie sur Reset sur le micro:bit.

Cause probable : commande M: coalesced qui arrive après le STOP. La mise à jour récente du firmware corrige ce problème — reflashe si nécessaire.

↔️ Le robot dérive à gauche ou à droite

C'est normal — les deux moteurs ont de légères différences. Solutions :

  • Active le cap boussole (🎚 LOCK dans la carte) pour corriger la dérive sur longue distance
  • Utilise l'onglet Controls → moteurs L/R pour équilibrer manuellement les deux côtés
  • Vérifie que les piles sont symétriques dans le boîtier (même niveau de charge)

📡 Sonar affiche 0 ou des valeurs incohérentes

  • Vérifie que le capteur HC-SR04 est bien branché sur le port sonar
  • Redémarre le robot (interrupteur OFF → ON)
  • Teste en pointant le sonar vers un mur plat à 30 cm

💡 LEDs NeoPixel ne s'allument pas

Le firmware doit inclure le support NeoPixel. Va dans Plus → Firmware et reflashe avec la dernière version.

📱 Tilt-to-Drive ne fonctionne pas (iOS)

iOS 13+ bloque l'accès aux capteurs de mouvement par défaut. Va dans :

Réglages → Safari → Accès aux capteurs de mouvement et d'orientation → Activé

Ensuite recharge la page et retape le bouton 📱 tilt.

🌀 L'app est lente ou bugguée

1
Ouvre ⚙ Réglages → Vider le cache.
2
Si ça persiste, ferme complètement l'onglet et rouvre l'URL.
3
En dernier recours, efface les données du site dans les Réglages du navigateur.