🕹

Joystick 2D

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

Le bloc Joystick2D fournit une commande interactive à deux axes sur le schéma permettant un pilotage multivariable simultané en cours de simulation. Le glissement du bouton circulaire génère des signaux de déviation bidimensionnels coordonnés (horizontal XX et vertical YY), ce qui en fait un outil idéal pour piloter l'attitude d'un drone (roulis et tangage), la vitesse et l'angle de braquage d'un robot mobile, une nacelle de caméra ou des forces perturbatrices biaxiales. Le bloc intègre une saturation radiale sur le cercle unité, un gain de mise à l'échelle configurable et un rappel élastique optionnel ramenant automatiquement la commande au centre au relâchement.

Modèle Mathématique

L'utilisateur déplace le bouton sur le canevas vers les coordonnées de déviation (dx,dy)(d_x, d_y). Le vecteur de déviation normalisé est saturé radialement sur le cercle unité :

r=dx2+dy2,(xnorm,ynorm)={(dx,dy),r≤1(dxr,dyr),r>1r = \sqrt{d_x^2 + d_y^2}, \quad (x_{\text{norm}}, y_{\text{norm}}) = \begin{cases} (d_x, d_y), & r \le 1 \\ \left(\frac{d_x}{r}, \frac{d_y}{r}\right), & r > 1 \end{cases}

Les signaux de sortie émis par les deux ports droits (xx et yy) sont pondérés par le gain d'échelle gain (KK) :

xout(t)=K⋅xnorm(t)yout(t)=K⋅ynorm(t)\begin{aligned} x_{\text{out}}(t) &= K \cdot x_{\text{norm}}(t) \\ y_{\text{out}}(t) &= K \cdot y_{\text{norm}}(t) \end{aligned}

Lorsque springReturn = true, le relâchement de la souris ou de l'appui tactile réinitialise immédiatement les coordonnées d'élongation à l'origine :

(xnorm,ynorm)←(0.0,0.0)(x_{\text{norm}}, y_{\text{norm}}) \leftarrow (0.0, 0.0)

Lorsque springReturn = false, le bouton conserve sa dernière position de déviation sélectionnée.

Entrées & Sorties

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

Paramètres

Paramètres Label Type Défaut Description
valueX X Value number 0 Current X deflection — written by the on-canvas knob. Bounded with Y to the unit circle (|(x,y)| ≤ 1).
valueY Y Value number 0 Current Y deflection — written by the on-canvas knob. Bounded with X to the unit circle (|(x,y)| ≤ 1).
gain Gain number 1 Output scale: out = deflection × gain
springReturn Spring Return boolean true Snap the knob back to (0,0) when released

Exemples d'Utilisation

Exemple 1 : Pilotage manuel du roulis et du tangage d'un quadrirotor

Commande interactive des angles d'attitude d'un drone. Configuration de gain = 30.0 (degrés) et springReturn = true. La connexion du port xx à la consigne de roulis et du port yy à la consigne de tangage permet de manœuvrer le drone de façon interactive ; le relâchement de la commande rétablit instantanément l'assiette horizontale.

Exemple 2 : Téléopération d'un robot mobile à entraînement différentiel

Guidage à distance d'un véhicule terrestre autonome. Le port yy fournit la consigne de vitesse linéaire (vv) avec gain = 2.0 (m/s), tandis que le port xx commande la vitesse de lacet (ω\omega) avec gain = 1.5 (rad/s). Relâcher le manche immobilise immédiatement l'engin.

Remarques & Bonnes Pratiques

  • Saturation radiale sur cercle unité : Les déviations diagonales sont limitées à une norme maximale x2+y2≤1\sqrt{x^2 + y^2} \le 1, évitant tout dépassement diagonal non physique (∣(1,1)∣=2≈1,414|(1, 1)| = \sqrt{2} \approx 1{,}414).
  • Synchronisation temps réel automatique : L'insertion d'un bloc Joystick2D synchronise automatiquement la simulation avec le temps réel pour une ergonomie optimale.
  • Rappel élastique vs maintien de consigne : Le réglage springReturn = false est particulièrement utile pour les commandes d'accélération ou d'équilibrage statique devant persister sans maintien manuel.
  • Support complet tactile et souris : Conçu pour fonctionner indifféremment avec une souris d'ordinateur ou un écran tactile mobile.

Composants Associés

  • Slider : Curseur linéaire interactif à axe unique.
  • KeyboardInput : Commande de signaux via les touches de clavier (flèches ou ZQSD/WASD).
  • XYPlot : Visualisation de trajectoires 2D et de portraits de phase.
  • Gain : Mise à l'échelle indépendante de voies de signaux distinctes.