⌨

Keyboard Input

Sources
Ejecutar el ejemplo en vivo Gratis · sin registro · funciona en tu navegador

El bloque KeyboardInput permite el control manual en tiempo real de modelos de simulación mediante el teclado estándar (teclas de flechas o teclas WASD). Al hacer clic sobre el bloque en el lienzo se le otorga el foco del teclado; pulsar las teclas direccionales modifica dos salidas de coordenadas independientes (XX e YY). Colocar un bloque KeyboardInput sincroniza automáticamente el motor con el tiempo de reloj real, por lo que es ideal para simuladores de vuelo interactivos, teleoperación robótica, demostraciones interactivas e inyección manual de perturbaciones.

Modelo Matemático

El capturador de teclado interpreta las pulsaciones y liberaciones de teclas como estados direccionales discretos sx(t),sy(t)∈{−1,0,1}s_x(t), s_y(t) \in \{-1, 0, 1\}:

sx(t)={−1,FlechaIzquierda / A+1,FlechaDerecha / D0,en otro caso,sy(t)={+1,FlechaArriba / W−1,FlechaAbajo / S0,en otro casos_x(t) = \begin{cases} -1, & \text{FlechaIzquierda / A} \\ +1, & \text{FlechaDerecha / D} \\ 0, & \text{en otro caso} \end{cases}, \quad s_y(t) = \begin{cases} +1, & \text{FlechaArriba / W} \\ -1, & \text{FlechaAbajo / S} \\ 0, & \text{en otro caso} \end{cases}

Las señales emitidas por los dos puertos de salida se escalan mediante el factor de ganancia gain (KK):

xout(t)=K⋅sx(t)yout(t)=K⋅sy(t)\begin{aligned} x_{\text{out}}(t) &= K \cdot s_x(t) \\ y_{\text{out}}(t) &= K \cdot s_y(t) \end{aligned}

Cuando el usuario hace clic fuera del bloque, se desactiva la captura y ambos estados se restablecen de forma segura a cero (sx=0,sy=0s_x = 0, s_y = 0).

Entradas y Salidas

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

Parámetros

Parámetros Label Tipo Por defecto Descripción
keyX X State number 0 -1 (left/A), 0, or 1 (right/D) — written by the keyboard listener
keyY Y State number 0 -1 (down/S), 0, or 1 (up/W) — written by the keyboard listener
gain Gain number 1 Output scale: out = key state × gain

Ejemplos de Uso

Ejemplo 1: Control de aceleración y dirección de vehículo estilo videojuego

Teleoperación de un vehículo terrestre eléctrico simulado. El puerto yy proporciona el par motor con gain = 50.0 (Nm), mientras que el puerto xx comanda el ángulo de giro de la dirección con gain = 25.0 (grados). Pasar la señal del puerto xx por un bloque RateLimiter dota a la dirección de una respuesta suave y realista en lugar de transiciones bruscas.

Ejemplo 2: Inyección interactiva de perturbaciones dinámicas

Evaluación de la inmunidad a perturbaciones de un sistema de control bajo comando humano. Conexión del puerto yy mediante un bloque Gain de 10.010.0 directamente al nudo de suma de fuerzas de un modelo de levitación magnética o péndulo invertido. Pulsar las flechas aplica impulsos calibrados para comprobar la estabilidad en tiempo real.

Observaciones y Buenas Prácticas

  • Seguridad mediante activación por clic: El bloque requiere un clic directo para capturar el teclado. Al hacer clic fuera se desarma de inmediato la captura y se restablecen a cero las salidas, evitando teclas retenidas.
  • Mapeo dual de teclas: Es compatible tanto con las teclas de flechas estándar como con las teclas WASD, ofreciendo ergonomía tanto a diestros como a zurdos.
  • Suavizado mediante filtros dinámicos: Como las teclas generan escalones bruscos (±K\pm K), interconectar la salida con bloques RateLimiter, TransferFunction o LeadLag genera respuestas analógicas suaves.
  • Sincronización automática en tiempo real: Incluir este bloque acopla la tasa del resolvedor 1:1 con el tiempo del sistema.

Bloques Relacionados

  • Joystick2D: Control analógico continuo de dos ejes mediante ratón o pantalla táctil.
  • Slider: Deslizador continuo lineal de un eje con vinculación a variables del proyecto.
  • RateLimiter: Limita la rapidez de cambio de los comandos escalón del teclado.
  • Constant: Fuente de señal escalar fija y no interactiva.