🕹️

Phone Controller

Connectivity
Lancer l’exemple en direct Gratuit · sans inscription · dans votre navigateur

Le bloc PhoneController transforme n'importe quel smartphone en joystick de simulation sans fil à 3 axes. Lorsqu'il est déposé sur le canevas, il génère un QR code d'appairage ; son scan dans un navigateur mobile ouvre un joystick tactile (ou par inclinaison) ainsi qu'une réglette horizontale de lacet (yaw).

Le téléphone diffuse des signaux de commande normalisés selon les axes X, Y et Lacet (−1,0⋯+1,0-1{,}0\dots +1{,}0) à environ 30 Hz via un canal de données poste à poste WebRTC à faible latence. Ses sorties X et Y sont compatibles avec Joystick2D.

Modèle Mathématique

L'appareil mobile transmet des vecteurs de commande normalisés à 3 axes :

u(tk)=[ux(tk),  uy(tk),  uyaw(tk)]T∈[−1,1]3\mathbf{u}(t_k) = [u_x(t_k), \; u_y(t_k), \; u_{\text{yaw}}(t_k)]^T \in [-1, 1]^3

Un seuil de zone morte δdead=0,02\delta_{\text{dead}} = 0{,}02 élimine le tremblement au repos :

ui(t)={0,∣ri(t)∣≤δdeadsign(ri(t))∣ri(t)∣−δdead1−δdead,∣ri(t)∣>δdeadu_i(t) = \begin{cases} 0, & |r_i(t)| \le \delta_{\text{dead}} \\[6pt] \text{sign}(r_i(t)) \dfrac{|r_i(t)| - \delta_{\text{dead}}}{1 - \delta_{\text{dead}}}, & |r_i(t)| > \delta_{\text{dead}} \end{cases}

Les signaux sont reconstruits continuellement au cours des pas de calcul avec un retard tampon τplayout=playoutDelay⋅10−3\tau_{\text{playout}} = \text{playoutDelay} \cdot 10^{-3} s :

yi(t)=interp({(tk,ui,k)},  t−τplayout)y_i(t) = \text{interp}\left( \{(t_k, u_{i,k})\}, \; t - \tau_{\text{playout}} \right)

Entrées & Sorties

Direction ID Label Type Status
← Out x X number Output
← Out y Y number Output
← Out yaw Yaw number Output

Paramètres

Paramètres Label Type Défaut Description
playoutDelay Playout Delay (ms) number 80 Network jitter buffer. Lower = more responsive control, higher = smoother signal on flaky connections.
interpolation Interpolation select linear How to reconstruct the control signal between received joystick packets.
outputLabels Output Labels vector x,y,yaw

Exemples d'Utilisation

Exemple 1 : Pilotage d'attitude de vol d'un quadrirotor

Contrôle de l'attitude de vol d'un drone simulé. La voie x fournit la consigne de roulis, y la consigne de tangage et yaw la vitesse de lacet vers des régulateurs PID commandant un affichage Gimbal3D.

Exemple 2 : Guidage par inclinaison pour robot mobile

Guidage d'un robot à propulsion différentielle. Le mode inclinaison convertit l'orientation du smartphone en commandes de braquage et de propulsion pour une conduite intuitive.

Remarques & Bonnes Pratiques

  • Trois axes de commande indépendants : Délivre X (gauche/droite, −1⋯+1-1\dots +1), Y (arrière/avant, −1⋯+1-1\dots +1) et Lacet (glissière, −1⋯+1-1\dots +1) sur trois sorties dédiées.
  • WebRTC sans installation d'application : S'exécute directement dans le navigateur mobile standard via appairage par QR code.
  • Modes tactile et inclinaison : Bascule simplement entre le pavé virtuel et l'accéléromètre du téléphone.
  • Attente de synchronisation : Dans les bancs d'essai HIL, la simulation attend la liaison WebRTC du smartphone avant de démarrer.

Composants Associés

  • Joystick2D : Joystick 2D commandé à la souris sur le canevas.
  • RemoteSensor : Lit les capteurs bruts d'accélération et gyroscopes de smartphones.
  • Gimbal3D : Visualisation 3D d'attitude de vol en temps réel.
  • Slider : Curseur d'entrée mono-axe à variation continue.