Joystick 2D
SourcesDer 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 und vertikal ). 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 gezogen, wird der normierte Auslenkungsvektor radial auf den Einheitskreis begrenzt:
Die an den beiden Ausgängen ( und ) ausgegebenen Signale werden mit dem Skalierungsfaktor gain () multipliziert:
Wenn springReturn = true, setzt das Loslassen der Maustaste oder des Touch-Kontakts die Auslenkungskoordinaten unverzüglich auf den Ursprung zurück:
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 mit dem Rollwinkel-Sollwert und Ausgang 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 liefert die Vorwärtsgeschwindigkeit () mit gain = 2.0 (m/s), während Port die Gierrate () 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 begrenzt, wodurch eine Übersteuerung in den Ecken () 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.