pulpLab es un entorno de programación para placas electrónicas que funciona en el navegador. Se escribe en MicroPython o en C++ Arduino, se envía el programa a un ESP32, una Raspberry Pi Pico o un Arduino por USB, y se siguen la consola, el monitor serie y las curvas en directo. ¿No tiene placa a mano? Las placas virtuales permiten probar.
Primeros pasos
- Abra pulpLab. La primera vez que lo abre, aparece solo un ejemplo para que vea cómo es pulpLab: el proyecto Estación meteorológica ESP32, ejecutado en una placa virtual (sin nada que conectar), con sus curvas de temperatura, humedad y luz en el Trazador. Empezar desde cero o Eliminar el ejemplo lo quita con un clic, y Archivo › Volver a ver el ejemplo lo vuelve a abrir, al igual que el botón Ejecutar en la placa virtual de la página de inicio. No se guarda nada mientras no lo modifique. La página de inicio indica si su navegador puede hablar con placas USB (Chrome o Edge en ordenador) y si el relé de compilación está activo (lo necesita el C++ Arduino).
- Elija Nuevo proyecto MicroPython, Nuevo boceto Arduino o uno de los Ejemplos (hacer parpadear el LED, leer un sensor, barrido de un servomotor, Wi-Fi ESP32, arcoíris NeoPixel, botón e interrupción, estación meteorológica).
- Ajuste la Placa destino en la barra superior y pulse Conectar: Placa USB… abre la selección del puerto, o elija una placa virtual (ESP32, Pico, Uno, Mega). pulpLab reconoce la mayoría de las placas en cuanto se conectan. Las placas previstas son ESP32 (DevKit, S3, C3), Raspberry Pi Pico (Pico, Pico W, Pico 2), Arduino Uno, Nano y Mega 2560, STM32 Nucleo-64 (solo compilación) y Pyboard.
- En MicroPython, Ejecutar (F5) lanza el programa sin escribirlo en la placa; Enviar a la placa (Ctrl+U) copia en ella los archivos y el programa principal pasa a ser
main.py, que arranca en cada encendido. En Arduino, Verificar (Ctrl+R) compila y Cargar (Ctrl+U) compila y escribe el programa. - Siga la salida en las pestañas Consola, Monitor, Trazador y Problemas. Los errores se subrayan en el editor, en la línea correcta.
Tareas habituales
¿Cómo instalar MicroPython en la placa?
Conecte la placa, abra el menú ⋯ (Más acciones) de la barra superior y luego Instalar MicroPython…. Elija la placa y el origen: MicroPython oficial (se descarga de micropython.org solo con su consentimiento), Archivo del ordenador o, para la placa virtual, Imagen de prueba. Marque Borrar toda la flash antes en una primera instalación, confirme y pulse Escribir en la flash. Con una Raspberry Pi Pico, ponga la placa en modo BOOTSEL y elija su unidad «RPI-RP2»: el archivo .uf2 se copia en ella. Si el relé de compilación no está en marcha, descargue usted mismo el archivo de su placa en micropython.org y selecciónelo en la ventana. Para una placa sin MicroPython (Arduino), la misma entrada del menú se llama Escribir un firmware….
¿Cómo compilar C++ Arduino?
El C++ Arduino debe compilarse antes de cargarse, algo que el navegador no puede hacer solo: pulpLab se apoya en un relé de compilación que se ejecuta en su ordenador, con el compilador Arduino instalado. Sin el relé funcionan la edición, el monitor, el trazador y todo MicroPython, pero Verificar y Cargar muestran qué hacer. Todo se explica en pulpLab y la compilación. También puede compilar en otro programa y cargar el archivo resultante.
¿Cómo cargar un archivo compilado en otro programa?
Use ⋯ › Cargar un archivo (.bin, .uf2, .hex)… o arrastre el archivo a la ventana. pulpLab comprueba el archivo antes de escribir: .hex para los Arduino AVR (Uno, Nano, Mega), .bin para los ESP32 (con la dirección de escritura), .uf2 para las placas con unidad USB como la Pico.
¿Cómo usar el monitor serie?
En la pestaña Monitor, elija la Velocidad (115 200 baudios por defecto) y el Fin de línea, y escriba el texto que quiere enviar. La Marca de tiempo, el Desplazamiento automático, la búsqueda en la salida y Exportar como texto facilitan el análisis.
¿Cómo trazar curvas?
Haga que la placa escriba números, una línea por medida: 12 34 o temp:21.5 hum:48. La pestaña Trazador dibuja una curva por serie; haga clic en una serie para ocultarla, ajuste la ventana, use Pausa o Exportar como CSV.
¿Cómo organizar los archivos de mi proyecto?
El panel Archivos del proyecto (barra izquierda) permite crear un Nuevo archivo, Importar archivos, renombrar, eliminar y Definir como programa principal (la estrella) el archivo que arranca primero. La lupa Buscar en el proyecto busca en todos los archivos. También puede arrastrar un archivo a la ventana.
¿Cómo reiniciar o desconectar la placa?
En el menú ⋯: Reinicio suave (Ctrl+D, MicroPython: main.py vuelve a arrancar), Reiniciar la placa y Desconectar. El Panel de la placa (a la derecha) muestra la placa reconocida, la versión de MicroPython, el estado del Wi-Fi, los servos y, en Arduino, la memoria de programa utilizada; un recuadro recuerda la tensión de la placa (5 V o 3,3 V).
¿Cómo gestionar los archivos de la placa?
Con MicroPython, el panel Archivos de la placa muestra su contenido (Leer los archivos de la placa). Desde ahí puede crear una carpeta, ejecutar un archivo, descargarlo al ordenador, eliminarlo (de forma definitiva, tras confirmar) o Enviar archivos a la placa.
¿Cómo probar sin placa?
En Conectar, elija una placa virtual. El ESP32 y la Pico virtuales ejecutan MicroPython con sus pines, LED, NeoPixel, servos, Wi-Fi simulado y un Entorno simulado ajustable (temperatura, humedad, luz, potenciómetro, distancia, presión). El Uno y la Mega virtuales solo simulan el cargador de arranque: la carga se comprueba de principio a fin, pero el programa no se ejecuta.
¿Cómo reutilizar los pines de una placa de pulpCircuit?
Abra o arrastre el archivo .pboard exportado por pulpCircuit: pulpLab genera pins.h (Arduino) o pins.py (MicroPython) con una constante por cada señal del esquema. Si no hay ningún proyecto abierto, se crea uno nuevo para el microcontrolador de la placa.
¿Cómo controlar una máquina GRBL?
La pestaña GRBL sirve para grabadores láser, fresadoras o plóteres con GRBL (115 200 baudios): estado, origen, desbloqueo, pausa, reanudación, parada de emergencia, comandos y Enviar un archivo G-code línea a línea. Tenga la parada de emergencia al alcance; para preparar un trabajo láser, vea también pulpCase.
Formatos compatibles
| Formato | Apertura | Guardado | Observaciones |
|---|---|---|---|
| pulpLab (.plab) | Sí | Sí | Proyecto completo; es un archivo ZIP que puede descomprimir para recuperar sus archivos. |
| Boceto Arduino (.ino), .h, .cpp, .c | Sí | Dentro del .plab | Un archivo abierto suelto crea un proyecto. |
| MicroPython (.py) | Sí | Dentro del .plab | Igual. |
| Programa de pulpRobot (.psketch) | Sí | No | Se abre como proyecto nuevo. |
| Placa de pulpCircuit (.pboard) | Sí | No | Genera pins.h o pins.py. |
| Firmware .hex, .bin, .uf2 | Sí (para cargar) | No | Se comprueba antes de escribir. |
| Salida del monitor | No | Sí (texto) | Exportar como texto. |
| Datos del trazador | No | Sí (CSV) | Exportar como CSV. |
| G-code (.gcode, .nc, .gc, .ngc, .tap) | Sí (envío GRBL) | No | Pestaña GRBL. |
Límites conocidos:
- La compilación de C++ pasa por el relé de compilación y el compilador Arduino instalados en su ordenador; no se hace en el navegador.
- El puerto serie solo existe en Chrome o Edge en ordenador; copiar un .uf2 en la unidad BOOTSEL también lo requiere.
- STM32 Nucleo: solo compilación, sin carga desde pulpLab. Pyboard: MicroPython por el puerto serie, sin instalación de firmware.
- El Arduino virtual no ejecuta el código; la placa MicroPython virtual reproduce los módulos principales, no la velocidad ni el tiempo real exactos.
- Los archivos de un proyecto no se descargan de uno en uno: guarde el .plab y descomprímalo para recuperar sus
.inoo.py.
Atajos de teclado
| Atajo | Acción |
|---|---|
| F5 | Ejecutar (MicroPython); Cargar (Arduino) |
| Mayús+F5 | Detener el programa |
| Ctrl+U | Enviar a la placa (MicroPython); Cargar (Arduino) |
| Ctrl+R | Verificar (compilar, Arduino) |
| Ctrl+S / Ctrl+Mayús+S | Guardar / Guardar como (.plab) |
| Ctrl+O | Abrir |
| Ctrl+F | Editor: buscar en el archivo |
| Ctrl+Z / Ctrl+Y | Editor: deshacer / rehacer |
| Ctrl+/ | Editor: comentar o descomentar la línea |
| Ctrl+Espacio | Editor: proponer un autocompletado |
| Tab | Editor: sangrar |
| Intro | Consola: enviar el comando (Mayús+Intro: nueva línea) |
| ↑ / ↓ | Consola: historial de comandos |
| Ctrl+C | Consola: interrumpir el programa (sin texto seleccionado) |
| Ctrl+D | Consola: reinicio suave |
En Mac, Cmd sustituye a Ctrl, salvo en la consola, donde Ctrl+C y Ctrl+D siguen en Ctrl. Ctrl+J abre pulpAssist.
La IA en pulpLab
pulpLab no utiliza ningún modelo de IA. Si ha configurado pulpAssist, el asistente puede leer el proyecto abierto (archivos, placa destino, errores, última salida de la placa) y proponer leer o modificar archivos del proyecto, siempre tras su confirmación y en un paso que se puede deshacer. Tras un error de compilación o de ejecución, el botón Explicar le pasa el mensaje para obtener una explicación sencilla y una corrección propuesta.
El asistente nunca envía código a la placa ni carga nada: ejecutar y cargar siempre requieren un clic suyo. Los archivos y mensajes que lee se envían al servicio configurado para el asistente. Revise siempre el código propuesto antes de ejecutarlo en una placa real.
Preguntas frecuentes y solución de problemas
Mi placa no aparece en la lista de puertos.
Use Chrome o Edge en ordenador, pruebe otro cable (algunos solo cargan) y cierre los demás programas que usen el puerto (IDE de Arduino, terminal serie). En Windows, una placa con chip CH340 o CP210x puede necesitar su controlador.
«La placa no responde» durante la carga.
Compruebe el puerto, la Placa destino y el cable. Para un Arduino Nano antiguo, elija «Arduino Nano (old bootloader)». En algunos ESP32, mantenga pulsado el botón BOOT al empezar la escritura.
«Relé de compilación no iniciado».
El C++ Arduino no se puede compilar sin el relé de compilación. Siga pulpLab y la compilación o trabaje en MicroPython, que no lo necesita.
Mi programa arranca cada vez que conecto la placa.
Es la función de main.py: Enviar a la placa sustituye los archivos de la placa y el programa principal arranca en cada encendido. Para una prueba rápida, use Ejecutar.
El trazador no muestra nada.
La placa debe escribir números separados por espacios, o pares nombre:valor, una línea por medida, a la velocidad elegida en el monitor.
¿Dónde están mis proyectos?
En este dispositivo, en el espacio reservado al navegador (Proyectos recientes en la página de inicio), con un borrador de seguridad; borrar los datos del navegador los elimina. Archivo › Guardar crea un .plab en el disco. Consulte documentos y copias de seguridad.
¿Funciona pulpLab sin conexión?
Sí, una vez cargado: edición, MicroPython, placas virtuales, monitor y trazador. Descargar MicroPython requiere conexión, y el compilador Arduino debe haber recibido antes la compatibilidad con sus placas.