Skip to main content

Usar un Ratón USB en el Wio Terminal

Este repositorio muestra cómo usar un ratón USB en el Wio Terminal. ¡Puedes implementar este ejemplo para ingresar datos desde un ratón al Wio Terminal!

Requisitos​

Para trabajar con este ejemplo, necesitarás un adaptador USB OTG y un módulo USB a Serial, donde el adaptador OTG se usa para conectar el ratón y el módulo USB a Serial para leer las salidas del Wio Terminal.

Procedimiento​

  1. Sube el código al Wio Terminal usando el IDE de Arduino.

  2. Desconecta el cable USB tipo C del Wio Terminal que usaste para subir el código.

  3. Conecta tu ratón al adaptador OTG y luego al puerto USB-C del Wio Terminal.

    • Ratón -> Adaptador OTG -> Wio Terminal (Puerto tipo C)

  4. Conecta el módulo USB a Serial al Wio Terminal de la siguiente manera:

    • TXD (USB a Serial) -> RXD (Pin 10 en Wio Terminal)
    • RXD (USB a Serial) -> TXD (Pin 8 en Wio Terminal)
    • 3.3V (USB a Serial) -> 3.3V (Pin 1 en Wio Terminal)
    • GND (USB a Serial) -> GND (Pin 6 en Wio Terminal)

  5. Conecta el módulo USB a Serial a tu computadora. Dependiendo del modelo usado, descarga el controlador USB correspondiente para que tu computadora pueda reconocerlo.

  6. Para usuarios de Windows, puedes abrir el Administrador de dispositivos para verificar si se reconoce. Debería aparecer un nuevo COM.

    • Para usuarios de Mac, usa ls /dev/cu.* en la terminal para verificar la disponibilidad del módulo.

  7. Para visualizar los datos desde el puerto serie:

    • Windows: Descarga e instala PuTTY. Selecciona Serial y cambia el valor de COM al que aparece en el Administrador de dispositivos, también cambia la velocidad a 115200 y presiona Open. Debería abrirse una terminal. Ahora, si empiezas a mover y hacer clic con el ratón conectado, ¡deberías ver la salida por puerto serie!

    • Mac: Abre la terminal e instala screen usando brew install screen. Una vez instalado, usa el comando screen /dev/cu.usbserial 115200, donde /dev/cu.usbserial debe coincidir con el que identificaste arriba. ¡Deberías ver la salida serial del Wio Terminal!

Nota importante: Como el puerto USB del Wio Terminal se está usando para USB, para subir otro programa al Wio Terminal debes entrar en modo Bootloader presionando dos veces el botón de encendido (el LED se atenuará). Entonces deberías poder ver nuevamente el puerto.

Configuraciones del USB Host​

Para habilitar el modo USB Host en el Wio Terminal, debes configurar dos pines. Es necesario establecer PIN_USB_HOST_ENABLE en LOW y OUTPUT_CTR_5V en HIGH.

Puedes hacerlo simplemente agregando el siguiente código dentro de void setup():

digitalWrite(PIN_USB_HOST_ENABLE, LOW);
digitalWrite(OUTPUT_CTR_5V, HIGH);

Código Completo​

#include <MouseController.h>
#define SerialDebug Serial1

uint32_t lastUSBstate = 0;

// Inicializar controlador USB
USBHost usb;

// Asociar controlador de ratón al USB
MouseController mouse(usb);

// Variables para el estado de los botones del ratón
bool leftButton = false;
bool middleButton = false;
bool rightButton = false;

// Esta función intercepta movimientos del ratón
void mouseMoved() {
  SerialDebug.print("Movimiento: ");
  SerialDebug.print(mouse.getXChange());
  SerialDebug.print(", ");
  SerialDebug.println(mouse.getYChange());
}

// Esta función intercepta movimientos mientras un botón está presionado
void mouseDragged() {
  SerialDebug.print("ARRASTRE: ");
  SerialDebug.print(mouse.getXChange());
  SerialDebug.print(", ");
  SerialDebug.println(mouse.getYChange());
}

// Esta función intercepta la pulsación de un botón del ratón
void mousePressed() {
  SerialDebug.print("Presionado: ");
  if (mouse.getButton(LEFT_BUTTON)) {
    SerialDebug.print("L");
    leftButton = true;
  }
  if (mouse.getButton(MIDDLE_BUTTON)) {
    SerialDebug.print("M");
    middleButton = true;
  }
  if (mouse.getButton(RIGHT_BUTTON)) {
    SerialDebug.print("R");
    rightButton = true;
  }
  SerialDebug.println();
}

// Esta función intercepta la liberación de un botón del ratón
void mouseReleased() {
  SerialDebug.print("Liberado: ");
  if (!mouse.getButton(LEFT_BUTTON) && leftButton == true) {
    SerialDebug.print("L");
    leftButton = false;
  }
  if (!mouse.getButton(MIDDLE_BUTTON) && middleButton == true) {
    SerialDebug.print("M");
    middleButton = false;
  }
  if (!mouse.getButton(RIGHT_BUTTON) && rightButton == true) {
    SerialDebug.print("R");
    rightButton = false;
  }
  SerialDebug.println();
}

void setup()
{
  SerialDebug.begin(115200);
  SerialDebug.println("Programa de Control de Ratón iniciado");

  if (usb.Init())
      SerialDebug.println("El host USB no se inició.");

  delay(20);

  // Configurar pines para habilitar USB Host en el Wio Terminal
  digitalWrite(PIN_USB_HOST_ENABLE, LOW);
  digitalWrite(OUTPUT_CTR_5V, HIGH);
}

void loop()
{
  // Procesar tareas USB
  usb.Task();

  uint32_t currentUSBstate = usb.getUsbTaskState();
  if (lastUSBstate != currentUSBstate) {
    SerialDebug.print("Estado USB cambiado: 0x");
    SerialDebug.print(lastUSBstate, HEX);
    SerialDebug.print(" -> 0x");
    SerialDebug.println(currentUSBstate, HEX);
    switch (currentUSBstate) {
      case USB_ATTACHED_SUBSTATE_SETTLE: SerialDebug.println("Dispositivo conectado"); break;
      case USB_DETACHED_SUBSTATE_WAIT_FOR_DEVICE: SerialDebug.println("Desconectado, esperando dispositivo"); break;
      case USB_ATTACHED_SUBSTATE_RESET_DEVICE: SerialDebug.println("Reiniciando dispositivo"); break;
      case USB_ATTACHED_SUBSTATE_WAIT_RESET_COMPLETE: SerialDebug.println("Reinicio completo"); break;
      case USB_STATE_CONFIGURING: SerialDebug.println("Configurando USB"); break;
      case USB_STATE_RUNNING: SerialDebug.println("USB en ejecución"); break;
    }
    lastUSBstate = currentUSBstate;
  }
}
Loading Comments...