CyberPi Toolkit — Extensión VS Code

Conectá, programá y explorá tu CyberPi (Makeblock) directamente desde VS Code.

✨ Funcionalidades

Feature	Descripción
🔌 Conexión USB/Serial	Auto-detecta el puerto del CyberPi y conecta con un clic
☁️ Upload de código Python	Subí tu `.py` al CyberPi (Ctrl+Shift+U)
🖥️ REPL interactivo	Terminal con el REPL de MicroPython del CyberPi
📚 API Explorer	Barra lateral con todos los módulos y métodos, con ejemplos
✂️ Snippets	~30 snippets con prefijo `cp-` para autocompletar código
🌳 Snippets Tree	Árbol de ejemplos con inserción directa al editor
📊 Status Bar	Indicador de conexión siempre visible

🚀 Inicio rápido

Conectar CyberPi por USB
Abrí la barra lateral CyberPi Toolkit y entrá al panel Panel
Seleccioná el puerto (el CyberPi suele aparecer como COM3/COM4 en Windows o /dev/ttyUSB0 en Linux)
Tocá Conectar
Abrí o creá un archivo .py
Tocá Subir archivo abierto para cargarlo al CyberPi

⌨️ Atajos de teclado

Atajo	Acción
`Ctrl+Shift+U`	Subir archivo Python activo
`Ctrl+Shift+C`	Detener ejecución (Ctrl+C)

📋 Comandos disponibles

Todos los comandos están bajo el prefijo CyberPi: en la paleta de comandos (Ctrl+Shift+P):

Conectar por USB/Serial — Abre el selector de puertos y conecta
Desconectar — Cierra la conexión serial
Subir código Python al CyberPi — Sube un archivo .py seleccionado
Subir archivo activo — Sube el archivo abierto actualmente
Abrir Monitor Serial (REPL) — Abre terminal interactiva con MicroPython
Explorador de API / Comandos — Abre el panel lateral con la documentación
Reset (soft reset) — Reinicia el CyberPi (Ctrl+D)
Detener ejecución — Envía Ctrl+C para interrumpir el programa
Listar puertos seriales — Lista y configura el puerto manualmente

✂️ Snippets (prefijo `cp-`)

Escribí el prefijo en un archivo .py y presioná Tab:

Prefijo	Descripción
`cyberpi`	`import cyberpi`
`cyberpi-loop`	Estructura main con loop
`cp-label`	Mostrar texto en pantalla
`cp-image`	Mostrar imagen/sprite
`cp-led-on`	Encender LEDs RGB
`cp-led-play`	Efecto de LEDs (rainbow, etc.)
`cp-sound`	Reproducir sonido
`cp-note`	Nota musical
`cp-melody`	Melodía con loop
`cp-acc`	Leer aceleración (X, Y, Z)
`cp-imu`	Roll y pitch
`cp-shaken`	Detectar agitado
`cp-btn-a`	Botón A presionado
`cp-buttons`	Botones A y B
`cp-mic`	Nivel de micrófono
`cp-wifi`	Conectar WiFi
`cp-http`	Petición HTTP GET
`cp-sprite`	Mostrar sprite animado
`cp-broadcast`	Enviar mensaje broadcast
`cp-timer`	Temporizador interno

⚙️ Configuración

Setting	Default	Descripción
`cyberpi.port`	`""`	Puerto serial (ej: `COM3`). Vacío = auto-detectar
`cyberpi.baudRate`	`115200`	Velocidad de comunicación
`cyberpi.dtr`	`false`	Señal DTR al abrir el puerto. En CyberPi/CH340 normalmente conviene `false`
`cyberpi.rts`	`false`	Señal RTS al abrir el puerto. En CyberPi/CH340 normalmente conviene `false`
`cyberpi.autoConnect`	`false`	Conectar automáticamente al abrir VS Code
`cyberpi.uploadMode`	`rawrepl`	`rawrepl` (built-in) o `ampy` (requiere `pip install adafruit-ampy`)
`cyberpi.pythonPath`	`python`	Ruta a Python (solo para modo `ampy`)

Diagnóstico rápido

Si el puerto abre pero la placa no responde al subir código, la CyberPi probablemente está usando CyberOS con el flujo propio de Makeblock. En ese modo la carga se hace desde mBlock/mBlock-Python con mLink. Desde el panel podés abrir mBlock Python o la descarga oficial de mLink.

El panel también detecta mLink localmente: muestra si mLink está instalado/activo, puede iniciarlo y lista los puertos que mLink ve. Esto confirma que el puente de Makeblock funciona antes de intentar la carga.

🛠️ Instalación para desarrollo

npm install
npm run compile
# Presioná F5 en VS Code para lanzar la extensión en modo desarrollo

Dependencias nativas

La extensión usa serialport para la comunicación USB. Si ves errores de módulo nativo, ejecutá:

npm install
# Si sigue fallando:
npm rebuild

📦 Empaquetar para distribuir

npm install -g @vscode/vsce
vsce package
# Genera: cyberpi-toolkit-0.1.0.vsix

Para instalar el .vsix:

Ctrl+Shift+P → Extensions: Install from VSIX...

🤖 Módulos CyberPi soportados

cyberpi.display — Pantalla TFT 128×128
cyberpi.led — 5 LEDs RGB NeoPixel
cyberpi.audio — Speaker + notas musicales
cyberpi.motion_sensor — IMU (acelerómetro + giroscopio)
cyberpi.button_a / cyberpi.button_b — Botones físicos
cyberpi.microphone — Micrófono integrado
cyberpi.wifi — Conectividad WiFi
cyberpi.sprite — Sprites y animaciones
cyberpi.timer — Temporizador interno
broadcast — Comunicación entre dispositivos
urequests — Peticiones HTTP
cyberpi.pin1/2/3/4 — Pines GPIO / Neuron

📝 Licencia

MIT

CyberPi Toolkit

Betech