Instalar DeviceScript consiste en preparar las herramientas del ordenador y cargar su runtime en la placa. Necesitaremos Node.js, Visual Studio Code y la extensión oficial.
A diferencia del IDE de Arduino, que reúne casi todo en una misma aplicación, aquí usamos una toolchain basada en varias herramientas. La extensión de VS Code coordina el proyecto, el compilador, el simulador y la placa.
DeviceScript fue un proyecto experimental de Microsoft Research y su repositorio oficial quedó archivado el 8 de diciembre de 2025.
El código y la documentación siguen disponibles, pero ya no recibe mantenimiento; por tanto, alguna descarga o integración puede dejar de funcionar con versiones futuras de Node.js o VS Code.
Vamos a necesitar tres ingredientes:
- Node.js: El motor que hará funcionar las herramientas por debajo.
- VS Code: Nuestro editor de código.
- La extensión de DeviceScript: Integra el flujo de trabajo en VS Code.
Instalar Node.js
DeviceScript es, al fin y al cabo, TypeScript. Y para compilar TypeScript y gestionar las librerías, necesitamos Node.js.
Aunque nosotros estemos programando un microcontrolador, nuestro PC necesita Node para ejecutar el compilador y gestionar los paquetes (drivers de sensores, utilidades, etc.) que bajaremos de NPM.
Ve a la web oficial de Node.js.
Descarga una versión LTS (Long Term Support) compatible con la última versión de DeviceScript.
Instálala con las opciones por defecto.
Para comprobar que todo ha ido bien, abre una terminal (cmd o PowerShell) y escribe:
node -v
El comando debería mostrar la versión instalada.
Instalar Visual Studio Code
Si no lo tienes, descarga Visual Studio Code desde code.visualstudio.com. Es gratuito y está disponible para los principales sistemas operativos.
Nota importante: No confundir con Visual Studio (el IDE morado gigante de Microsoft). Necesitamos Visual Studio Code (el azul).
Instalar la extensión de DeviceScript
La extensión convierte VS Code en el entorno desde el que creamos, simulamos, depuramos y desplegamos los programas.
Abre VS Code.
Ve a la pestaña de Extensiones (o pulsa Ctrl+Shift+X).
Busca DeviceScript.
Instala la extensión publicada por Microsoft si todavía aparece disponible.
Una vez instalada, aparecerá un nuevo icono de DeviceScript (el logo de Jacdac) en la barra lateral izquierda, además de nuevas opciones en la barra de estado.
Crear nuestro primer proyecto
A diferencia de Arduino, donde abres un archivo y listo, aquí trabajamos por Proyectos (carpetas).
Crea una carpeta vacía en el ordenador, por ejemplo MiPrimerDeviceScript.
Abre esa carpeta con VS Code mediante Archivo > Abrir carpeta.
Abre la paleta de comandos con Ctrl+Shift+P (o F1).
Busca el comando para crear un proyecto de DeviceScript y ejecútalo.
La extensión configurará el proyecto y creará varios archivos. Los más importantes son:
src/main.ts: Aquí es donde escribiremos nuestro código. Es el equivalente al.inode Arduino.tsconfig.json: Configuración de TypeScript. De momento no necesitamos modificarla.package.json: El archivo que gestiona las dependencias (librerías) de nuestro proyecto.
Es posible que la primera vez pregunte si quieres instalar los paquetes del proyecto. Confirma la instalación.
Conectar y preparar la placa
Tenemos el código, pero nuestra placa (ESP32 o Pico) todavía está “vacía” o tiene un firmware antiguo (quizás MicroPython o Arduino). Necesitamos instalarle el Runtime de DeviceScript.
Lo genial es que la extensión hace esto muy fácil, pero tiene truco la primera vez.
Conecta la placa al USB.
Busca el panel de DeviceScript en la barra lateral de VS Code.
Abre la sección de conexión o pulsa el icono del enchufe.
Selecciona la conexión Serial.
Si la placa todavía no contiene el runtime, VS Code no la reconocerá como un dispositivo DeviceScript y solicitará grabar el firmware.
El proceso de flasheo
DeviceScript usa una herramienta web para esto.
Abre la herramienta que ofrece el diálogo de conexión o ejecuta DeviceScript: Flash Firmware....
Selecciona el modelo exacto de la placa.
Seguid las instrucciones en pantalla.
En algunas placas hay que mantener pulsado BOOT mientras se conecta el USB para entrar en modo de descarga. Sigue las instrucciones específicas del modelo seleccionado.
Una vez grabado, la placa se reiniciará y debería aparecer en la lista de dispositivos conectados con un nombre generado automáticamente.
Solucionar problemas comunes
Los fallos más habituales aparecen durante la conexión o la grabación:
No aparece el puerto USB
Esto es el 99% de los casos.
- El cable USB: Asegúrate de que es un cable de datos y no solo de carga. Prueba con otro cable.
- Drivers: Si usas un ESP32 antiguo, necesitas los drivers CP210x o CH340 instalados en tu ordenador.
Error WebSerial not supported
La herramienta de flasheo usa tecnología WebSerial. Asegúrate de estar usando un navegador compatible (Chrome, Edge u Opera). Firefox todavía no lo soporta nativamente para esto.
El flasheo falla a mitad del proceso
A veces ocurre si el puerto USB no da suficiente corriente o si hay interferencias.
- Prueba otro puerto USB (preferiblemente uno directo a la placa base, no un hub).
- Desconecta otros dispositivos serie.
- Si es un ESP32, asegúrate de mantener pulsado el botón
BOOThasta que empiece la carga.
