Joystick 2D
SourcesHet Joystick2D-blok biedt een interactieve twee-assige bedieningsknop op het canvas waarmee gebruikers simultaan twee signalen live tijdens de simulatie kunnen besturen. Door de ronde knop te verslepen genereert het blok gecoördineerde tweedimensionale uitslagsignalen (horizontaal en verticaal ). Dit maakt het blok uitermate geschikt voor het besturen van de oriëntatie van drones (rol en stamp), de rijsnelheid en stuurhoek van mobiele robots, cameragimbals of twee-assige krachtstoringen. Het blok beschikt over radiale begrenzing op de eenheidscirkel, instelbare uitgangsversterking en een optionele veerretourfunctie die de knop automatisch centreert bij loslaten.
Wiskundig Model
Wanneer de gebruiker de knop op het canvas versleept naar coördinaten , wordt de genormaliseerde uitslagvector radiaal begrensd binnen de eenheidscirkel:
De uitgangssignalen op de twee poorten aan de rechterzijde ( en ) worden geschaald met de versterkingsfactor gain ():
Wanneer springReturn = true, zorgt het loslaten van de muisknop of het touchscreencontact ervoor dat de uitslag direct terugspringt naar de oorsprong:
Wanneer springReturn = false, blijft de knop op de laatst versleepte positie staan.
Ingangen & Uitgangen
| Direction | ID | Label | Type | Status |
|---|---|---|---|---|
| ← Out | x |
X | number | Output |
| ← Out | y |
Y | number | Output |
Parameters
| Parameters | Label | Type | Standaard | Beschrijving |
|---|---|---|---|---|
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 |
Gebruiksvoorbeelden
Voorbeeld 1: Handmatige rol- en stamphoekbesturing van een quadrotor
Interactieve besturing van de vlieghoeken van een drone. Instellen van gain = 30.0 (graden) en springReturn = true. Door poort te verbinden met het rolhoekinstelpunt en poort met het stamphoekinstelpunt kan een piloot de gesimuleerde drone live besturen; bij loslaten stabiliseert de drone zichzelf horizontaal.
Voorbeeld 2: Afstandsbediening van een mobiele robot met differentieelaandrijving
Teleoperatie van een autonoom grondvoertuig. Poort levert de voorwaartse lineaire snelheid () met gain = 2.0 (m/s), terwijl poort de gierhoeksnelheid () levert met gain = 1.5 (rad/s). Loslaten van de joystick brengt het voertuig direct tot stilstand.
Opmerkingen & Best Practices
- Radiale eenheidscirkelbegrenzing: Diagonale uitslagen worden strikt begrensd op een vectorlengte van , waardoor diagonale oversturing () effectief wordt voorkomen.
- Automatische real-time synchronisatie: Het toevoegen van een Joystick2D-blok vergrendelt de simulatieklok automatisch op 1:1 werkelijke tijd voor vloeiende menselijke interactie.
- Veerretour versus trimregeling: Het uitschakelen van de veerretour (
springReturn = false) is ideaal voor gashandels of instelbare werkpunten waarbij de gekozen stand behouden moet blijven. - Muis- en touch-compatibiliteit: Werkt vloeiend met zowel desktop muisbediening als mobiele touchscreens.
Gerelateerde Componenten
- Slider: Eén-assige lineaire interactieve schuifregelaar.
- KeyboardInput: Besturing van simulatiesignalen via toetsenbordknoppen (pijltjes of WASD).
- XYPlot: Visualisatie van 2D-trajecten en joystick-fasevlakken.
- Gain: Onafhankelijke schaling van afzonderlijke signaalkanalen.