El proyecto Cocket StreamDeck consiste en el diseño y ensamble de una consola programable de accesos rápidos basada en la tarjeta de desarrollo UNIT Cocket Nova CH552G. El sistema utiliza una red de resistencias formando divisores de voltaje para multiplexar seis botones mediante una única entrada analógica (ADC), permitiendo que el microcontrolador identifique cada pulsación sin necesidad de dedicar un pin independiente a cada botón.
Como complemento, incorpora un encoder rotatorio KY-040 con botón integrado para controlar el volumen del sistema y activar la función de silencio (Mute). Gracias a la interfaz USB HID nativa del CH552G, el dispositivo es reconocido automáticamente por la computadora como un teclado multimedia, permitiendo ejecutar acciones como abrir páginas web, escribir texto automáticamente y controlar la reproducción multimedia de manera inmediata, convirtiéndose en una práctica Stream Deck de bajo costo y completamente personalizable.
Introducción
Las Stream Deck se han convertido en herramientas indispensables para mejorar la productividad, automatizar tareas repetitivas y controlar aplicaciones mediante botones programables. Sin embargo, muchas de estas soluciones comerciales presentan un costo elevado o requieren hardware especializado.
En este proyecto se desarrolla una alternativa compacta y económica utilizando la tarjeta de desarrollo UNIT Cocket Nova CH552G, la cual incorpora soporte USB nativo para dispositivos HID. El diseño electrónico aprovecha una red de resistencias configuradas como divisores de voltaje para conectar seis botones independientes a una única entrada analógica del microcontrolador. Cada botón genera un nivel de voltaje diferente, permitiendo que el firmware identifique cuál fue presionado mediante la conversión analógica-digital (ADC).
Además del teclado analógico, el sistema integra un encoder rotatorio KY-040. El giro del encoder permite aumentar o disminuir el volumen del sistema operativo, mientras que su botón central activa o desactiva el modo silencio.
El firmware interpreta cada entrada y ejecuta diferentes acciones sobre la computadora, incluyendo la apertura automática de páginas web, escritura de texto predefinido y control multimedia. Gracias a la emulación HID, todas estas funciones se realizan sin instalar software adicional ni controladores específicos, ofreciendo una experiencia completamente Plug & Play.
Materiales
Para construir este proyecto, necesitarás reunir los siguientes componentes electrónicos, elementos mecánicos y herramientas de ensamblaje. Puedes encontrar todo el material en la siguiente lista de materiales, la cual incluye los siguientes componentes:
- Cocket Nova CH552G – UNIT DevLab
- Encoder Rotativo KY-040
- 6pz Push Button 4 pines MicroSwitch
- Resistencias 1/4W 5% de : 1KΩ, 2.2KΩ, 4.7KΩ, 10KΩ, 22KΩ, 47KΩ
- Capacitor ceramico 100 nF
- Cables Dupont Cortos 10cm HH (Opcional)
- Arnes QWIIC – QWIIC Hembra – Hembra 4 pines Pitch 1 mm
- Alambre
- Tornillería M2x5 (4 piezas) y M3x5mm(8 piezas)
- Desarmador
- Cautín
Las piezas que forman parte de la estructura del StreamDeck. Las puedes descargar los archivos e imprimirlos directamente desde nuestro espacio en Grabcad : UN
¿No cuentas con una impresora 3D? Puedes utilizar nuestro servicio de impresión 3D para la fabricación de las piezas: Servicio de impresión 3D UNIT
Diagrama de conexión
Código
Te recomendamos seguir los pasos del manual https://uelectronics.com/wp-content/uploads/2024/10/Cocket-Nova-Product-Reference-Manual-ES.pdf para instalar los programas y drivers previos es indispensable:
- Software Zadig
- Controlador CH372drv
- WCHISPStudio
Descarga platformio para VSC
Clona este repositorio en tu computadora GitHub – UNIT-Electronics-MX/unit_ch55x_sdk at platformio-example-migration de la rama platformio-example-migration
En PlatformIP busca “Open Project”
Abre la carpeta usb_minikeyboard_adc
Busca el archivo main.c dentro de VSC y da clic en Build
Busca la el archivo firmware.bin
Abre WCHISPStudio y agrega el .bin anterior en el FilePath.
Presiona Boot y conecta tu CocketNova a la computadora para que entre en modo programación, presiona Download en WCHISPStudio.
Otra forma de subir el programa es activar la casilla de descarga automática:
Y presionar el boton boot al conectar la CocketNova, permitirá que el programa se actualice automáticamente.
Resultado
Una vez ensamblado el circuito y cargado el firmware en la Cocket Nova CH552G, el dispositivo es reconocido automáticamente por el sistema operativo como un dispositivo HID USB, sin necesidad de instalar controladores adicionales.
Los seis pulsadores conectados mediante la red de divisores de voltaje generan distintos niveles analógicos que son interpretados por el convertidor ADC del microcontrolador. El firmware compara cada lectura con rangos previamente calibrados para identificar con precisión qué botón fue presionado y ejecutar la acción correspondiente.
La asignación de funciones es la siguiente:
| Botón | Acción |
|---|---|
| SW1 | Abrir YouTube |
| SW2 | Abrir UNIT Electronics |
| SW3 | Escribir “Hola mundo” |
| SW4 | Escribir “Cocket Nova” |
| SW5 | Canción anterior |
| SW6 | Canción siguiente |
Por su parte, el encoder KY-040 proporciona funciones multimedia adicionales:
| Acción del encoder | Función |
|---|---|
| Giro horario | Aumentar volumen |
| Giro antihorario | Disminuir volumen |
| Pulsación | Activar o desactivar Mute |
Las funciones multimedia utilizan los comandos HID Consumer Control, mientras que las funciones de escritura emplean la emulación de teclado USB. Para la apertura de páginas web, el firmware ejecuta la combinación Windows + R, escribe automáticamente la dirección correspondiente y presiona Enter, iniciando el navegador predeterminado del sistema.
El resultado es una Stream Deck compacta, económica y completamente funcional que permite automatizar tareas frecuentes, controlar contenido multimedia y ejecutar accesos rápidos mediante una interfaz física intuitiva, aprovechando eficientemente los recursos del microcontrolador gracias al uso de divisores de voltaje y lectura analógica.
Conclusiones
El proyecto Cocket StreamDeck demuestra cómo es posible implementar un controlador de accesos rápidos completamente funcional utilizando una cantidad mínima de componentes electrónicos y aprovechando las capacidades USB HID nativas del microcontrolador CH552G.
La utilización de una red de divisores de voltaje representa una solución eficiente para multiplexar múltiples botones sobre una única entrada analógica, reduciendo significativamente el consumo de pines sin sacrificar velocidad ni confiabilidad en la detección de pulsaciones. La incorporación del encoder KY-040 complementa el sistema al añadir controles multimedia continuos, proporcionando una experiencia de uso más completa.
Además de servir como una práctica plataforma para aprender sobre interfaces HID, conversión analógica-digital y diseño electrónico, este proyecto constituye una excelente base para desarrollar teclados macro personalizados, paneles de control para streaming, automatización de tareas de oficina o control de aplicaciones profesionales. Gracias a que todas las funciones pueden modificarse desde el firmware, la Stream Deck puede adaptarse fácilmente a las necesidades específicas de cada usuario, convirtiéndose en una herramienta versátil para múltiples aplicaciones.
