🕹️

Phone Controller

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

El bloque PhoneController convierte cualquier smartphone en un joystick inalámbrico de 3 ejes para simulación. Al colocarlo en el lienzo, genera un código QR de emparejamiento; al escanearlo desde un navegador móvil, se abre un joystick táctil (o control por inclinación) junto con un deslizador horizontal independiente de guiñada (yaw).

El teléfono transmite señales de control normalizadas en los ejes X, Y y Yaw (−1,0⋯+1,0-1{,}0\dots +1{,}0) a unos 30 Hz a través de un canal WebRTC punto a punto de baja latencia. Sus puertos X e Y coinciden con los de Joystick2D, permitiendo una sustitución directa.

Modelo Matemático

El dispositivo móvil transmite vectores de control normalizados de 3 ejes:

u(tk)=[ux(tk),  uy(tk),  uyaw(tk)]T∈[−1,1]3\mathbf{u}(t_k) = [u_x(t_k), \; u_y(t_k), \; u_{\text{yaw}}(t_k)]^T \in [-1, 1]^3

Un umbral de zona muerta δdead=0,02\delta_{\text{dead}} = 0{,}02 suprime temblores en reposo:

ui(t)={0,∣ri(t)∣≤δdeadsign(ri(t))∣ri(t)∣−δdead1−δdead,∣ri(t)∣>δdeadu_i(t) = \begin{cases} 0, & |r_i(t)| \le \delta_{\text{dead}} \\[6pt] \text{sign}(r_i(t)) \dfrac{|r_i(t)| - \delta_{\text{dead}}}{1 - \delta_{\text{dead}}}, & |r_i(t)| > \delta_{\text{dead}} \end{cases}

Las señales se reconstruyen de forma continua durante los pasos del solver con una latencia de búfer τplayout=playoutDelay⋅10−3\tau_{\text{playout}} = \text{playoutDelay} \cdot 10^{-3} s:

yi(t)=interp({(tk,ui,k)},  t−τplayout)y_i(t) = \text{interp}\left( \{(t_k, u_{i,k})\}, \; t - \tau_{\text{playout}} \right)

Entradas y Salidas

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

Parámetros

Parámetros Label Tipo Por defecto Descripción
playoutDelay Playout Delay (ms) number 80 Network jitter buffer. Lower = more responsive control, higher = smoother signal on flaky connections.
interpolation Interpolation select linear How to reconstruct the control signal between received joystick packets.
outputLabels Output Labels vector x,y,yaw

Ejemplos de Uso

Ejemplo 1: Control de actitud de vuelo de cuadricóptero

Gobierno de la actitud de un dron simulado. El puerto x suministra la consigna de alabeo (roll), y la de cabeceo (pitch) y yaw la velocidad de guiñada hacia reguladores PID que controlan un visor Gimbal3D.

Ejemplo 2: Navegación por inclinación en robótica móvil

Control de un robot terrestre con tracción diferencial. Activar el modo inclinación mapea la orientación física del móvil en órdenes de giro y avance para una conducción intuitiva.

Observaciones y Buenas Prácticas

  • Tres ejes de control independientes: Entrega X (izquierda/derecha, −1⋯+1-1\dots +1), Y (atrás/adelante, −1⋯+1-1\dots +1) y Guiñada (deslizador horizontal, −1⋯+1-1\dots +1) en tres salidas dedicadas.
  • WebRTC sin instalación de apps: Funciona directamente en cualquier navegador web móvil estándar mediante código QR.
  • Modos táctil y por inclinación: Alterna entre el mando táctil y los acelerómetros del dispositivo con un solo toque.
  • Sincronización de simulación: En maquetas de hardware en el bucle, la simulación espera a que el teléfono establezca la conexión WebRTC antes de arrancar.

Bloques Relacionados

  • Joystick2D: Joystick 2D accionado mediante ratón en el lienzo.
  • RemoteSensor: Lee sensores brutos de aceleración y orientación de teléfonos móviles.
  • Gimbal3D: Visualizador 3D de actitud de vuelo en tiempo real.
  • Slider: Deslizador de entrada continua de una sola variable.