🕹

Joystick 2D

Sources
Live-Beispiel starten Kostenlos · ohne Anmeldung · läuft im Browser

Der Joystick2D-Block stellt ein interaktives zweiachsiges Daumen-Bedienelement auf der Arbeitsfläche bereit, mit dem Benutzer während laufender Simulationen zwei Signale synchron steuern können. Das Ziehen des kreisförmigen Knopfs erzeugt koordinierte zweidimensionale Auslenkungssignale (horizontal XX und vertikal YY). Dies eignet sich hervorragend zur Führung von Drohnenlagen (Rollen und Nicken), Fahrgeschwindigkeiten und Lenkwinkeln mobiler Roboter, Kameragimbals oder zweiachsigen Kraftstörungen. Der Block verfügt über eine radiale Einheitskreisbegrenzung, eine einstellbare Ausgangsverstärkung und eine optionale Federrückstellung zur automatischen Zentrierung.

Mathematisches Modell

Wird der Knopf auf der Arbeitsfläche auf die Koordinaten (dx,dy)(d_x, d_y) gezogen, wird der normierte Auslenkungsvektor radial auf den Einheitskreis begrenzt:

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}

Die an den beiden Ausgängen (xx und yy) ausgegebenen Signale werden mit dem Skalierungsfaktor gain (KK) multipliziert:

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}

Wenn springReturn = true, setzt das Loslassen der Maustaste oder des Touch-Kontakts die Auslenkungskoordinaten unverzüglich auf den Ursprung zurück:

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

Wenn springReturn = false, behält der Knopf die zuletzt eingestellte Auslenkungsposition bei.

Ein- & Ausgänge

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

Parameter

Parameter Label Typ Standardwert Beschreibung
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

Anwendungsbeispiele

Beispiel 1: Manuelle Roll- und Nicklagensteuerung eines Quadrokopters

Interaktive Sollwertvorgabe für Lagewinkel einer Drohne. Konfiguration mit gain = 30.0 (Grad) und springReturn = true. Die Verbindung von Ausgang xx mit dem Rollwinkel-Sollwert und Ausgang yy mit dem Nickwinkel-Sollwert ermöglicht die interaktive Steuerung im Flug; beim Loslassen richtet sich die Drohne selbsttätig horizontal aus.

Beispiel 2: Teleoperation eines fahrerlosen Transportfahrzeugs

Fernsteuerung eines mobilen Roboters mit Differentialantrieb. Port yy liefert die Vorwärtsgeschwindigkeit (vv) mit gain = 2.0 (m/s), während Port xx die Gierrate (ω\omega) mit gain = 1.5 (rad/s) steuert. Das Loslassen des Joysticks stoppt das Fahrzeug sofort zuverlässig.

Hinweise & Best Practices

  • Radiale Einheitskreisbegrenzung: Diagonale Auslenkungen werden auf eine maximale Vektorlänge von x2+y2≤1\sqrt{x^2 + y^2} \le 1 begrenzt, wodurch eine Übersteuerung in den Ecken (∣(1,1)∣=2≈1,414|(1, 1)| = \sqrt{2} \approx 1{,}414) vermieden wird.
  • Automatische Echtzeit-Synchronisation: Das Einfügen eines Joystick2D-Blocks bindet die Simulationsgeschwindigkeit automatisch an die reale Wanduhrzeit für ruckelfreie Bedienerführung.
  • Federrückstellung vs. Trimmregelung: Das Deaktivieren der Federrückstellung (springReturn = false) eignet sich für Gashebel und statische Arbeitspunkte, die ohne Festhalten der Maus aktiv bleiben sollen.
  • Vollständig touch- und mauskompatibel: Funktioniert gleichermaßen präzise auf Desktop-Systemen mit Maus sowie auf Touchscreens mobiler Endgeräte.

Verwandte Blöcke

  • Slider: Einachsiger interaktiver linearer Schieberegler.
  • KeyboardInput: Steuerung von Simulationssignalen über Tastaturtasten (Pfeiltasten oder WASD).
  • XYPlot: Visualisierung zweidimensionaler Trajektorien und Phasenporträts.
  • Gain: Unabhängige Skalierung einzelner Signalkanäle.