Joystick 2D
SourcesLe 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 et vertical ), 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 . Le vecteur de déviation normalisé est saturé radialement sur le cercle unité :
Les signaux de sortie émis par les deux ports droits ( et ) sont pondérés par le gain d'échelle gain () :
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 :
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 à la consigne de roulis et du port à 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 fournit la consigne de vitesse linéaire () avec gain = 2.0 (m/s), tandis que le port commande la vitesse de lacet () 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 , évitant tout dépassement diagonal non physique ().
- 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 = falseest 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.