Primeros pasos con VS Code y PlatformIO para ESP32 y ESP8266 (Windows, macOS y Linux)

Aunque Arduino IDE es la opción más recomendada para quienes se inician en el desarrollo con ESP32, muchos usuarios terminan dando el salto a Visual Studio Code (VS Code) junto con la extensión PlatformIO, un entorno mucho más potente y orientado al desarrollo de proyectos de mayor envergadura.

En esta guía aprenderás a instalar y configurar Visual Studio Code y PlatformIO IDE para programar tanto placas ESP32 como ESP8266, utilizando Windows, macOS o distribuciones Linux, como Ubuntu.

¿Qué es PlatformIO?

PlatformIO es una plataforma de desarrollo profesional para sistemas embebidos que se integra directamente en Visual Studio Code y añade numerosas funciones que no están disponibles en Arduino IDE.

Entre sus principales ventajas destacan:

• Autocompletado inteligente y análisis avanzado del código.
• Gestión automática de bibliotecas y dependencias.
• Soporte para múltiples plataformas y microcontroladores desde un único entorno.
• Herramientas de depuración (debugging) compatibles con determinados dispositivos.
• Compilación más rápida y una organización de proyectos mucho más profesional.
• Integración con sistemas de control de versiones como Git.

Gracias a estas características, PlatformIO se ha convertido en uno de los entornos preferidos por desarrolladores que trabajan con ESP32, ESP8266, STM32, Raspberry Pi Pico, Arduino y muchos otros microcontroladores.

¿Arduino IDE o PlatformIO?

Ambos entornos permiten desarrollar proyectos para ESP32, pero están orientados a perfiles de usuario diferentes.

• Arduino IDE destaca por su sencillez y es la mejor opción para aprender los fundamentos, realizar pruebas rápidas y comenzar a programar sin complicaciones.
• PlatformIO, por su parte, ofrece una experiencia mucho más completa, con herramientas avanzadas que resultan especialmente útiles en proyectos grandes, colaborativos o de carácter profesional.

En otras palabras, Arduino IDE suele ser la puerta de entrada, mientras que PlatformIO representa el siguiente paso natural para quienes desean llevar sus proyectos con ESP32 y ESP8266 a un nivel más avanzado.

En los siguientes apartados veremos cómo instalar y configurar este potente entorno de desarrollo para comenzar a programar nuestras placas desde Visual Studio Code.

¿Por qué utilizar Visual Studio Code con PlatformIO?

Arduino IDE es una herramienta excelente para aprender y desarrollar proyectos sencillos. Sin embargo, a medida que las aplicaciones crecen en complejidad —con cientos de líneas de código, múltiples archivos, varias bibliotecas y una estructura más organizada— puede quedarse algo limitado.

En estos casos, Visual Studio Code (VS Code) junto con la extensión PlatformIO ofrece un entorno de desarrollo mucho más completo, incorporando funciones como:

• Autocompletado inteligente de código.
• Detección de errores mientras programas.
• Gestión automática de bibliotecas y dependencias.
• Navegación rápida entre archivos y funciones.
• Organización de proyectos profesionales.
• Integración con Git y otras herramientas de desarrollo.

Por ello, es una opción muy recomendable para quienes ya dominan Arduino IDE y desean trabajar con proyectos más avanzados para ESP32 o ESP8266.

Instalar Visual Studio Code en Windows

El primer paso consiste en instalar Visual Studio Code, el editor de código desarrollado por Microsoft sobre el que posteriormente instalaremos PlatformIO.

1. Descargar Visual Studio Code

Accede a la página oficial de Visual Studio Code y descarga la versión estable correspondiente a Windows.

2. Ejecutar el instalador

Una vez finalizada la descarga, ejecuta el archivo de instalación.

El asistente te guiará durante todo el proceso. Solo tendrás que aceptar los términos de licencia y pulsar Siguiente (Next) para continuar.

3. Seleccionar las opciones recomendadas

Durante la instalación aparecerán varias opciones de configuración. Es recomendable mantener activadas las opciones sugeridas por el instalador, ya que facilitan el uso de VS Code desde el explorador de archivos de Windows y mejoran la integración con el sistema operativo.

Una vez configuradas, pulsa Instalar (Install).

4. Finalizar la instalación

Cuando el proceso termine, haz clic en Finalizar (Finish).

VS Code se abrirá automáticamente mostrando la pantalla de bienvenida y las novedades de la versión instalada.

Con esto, Visual Studio Code habrá quedado correctamente instalado y estará listo para añadir la extensión PlatformIO, que permitirá desarrollar proyectos para ESP32 y ESP8266 desde un entorno mucho más potente que Arduino IDE.

¿Cómo instalar Python en Windows?

Para utilizar PlatformIO con placas ESP32 y ESP8266, es necesario tener instalada una versión reciente de Python en el ordenador. Actualmente, PlatformIO es compatible con Python 3.5 o superior, aunque lo más recomendable es utilizar siempre una versión estable y actualizada de Python 3.

1. Descargar Python

Accede a la página oficial de Python y descarga la versión más reciente disponible para Windows.

2. Ejecutar el instalador

Abre el archivo descargado para iniciar el asistente de instalación.

Antes de pulsar el botón Install Now, hay un paso muy importante.

Activa la opción “Add Python to PATH”

Marca la casilla “Add Python to PATH” (o “Add Python 3.x to PATH”, dependiendo de la versión instalada).

Esta opción añade automáticamente Python a las variables de entorno de Windows, permitiendo que PlatformIO y otras herramientas lo detecten sin necesidad de realizar configuraciones adicionales.

Una vez activada, pulsa Install Now para comenzar la instalación.

3. Finaliza la instalación

Cuando el proceso termine aparecerá un mensaje indicando que Python se ha instalado correctamente.

Haz clic en Close para cerrar el asistente.

Con Python ya instalado, el siguiente paso será instalar la extensión PlatformIO dentro de Visual Studio Code, que será la encargada de gestionar la compilación, programación y depuración de proyectos para ESP32 y ESP8266.

B) Instalar Visual Studio Code en macOS

El proceso de instalación de Visual Studio Code en macOS es muy sencillo y apenas lleva unos minutos.

1. Descargar Visual Studio Code

Accede a la página oficial de Visual Studio Code y descarga la versión estable para macOS.

2. Abrir la aplicación

Una vez finalizada la descarga, macOS puede mostrar un aviso de seguridad solicitando confirmación para abrir la aplicación descargada.

Pulsa Abrir (Open) para continuar.

Si el aviso no aparece automáticamente, también puedes abrir Visual Studio Code directamente desde la carpeta Descargas (Downloads) o mover la aplicación a la carpeta Aplicaciones (Applications) para tenerla instalada de forma permanente.

3. Iniciar Visual Studio Code

La primera vez que abras VS Code aparecerá la pantalla de bienvenida junto con las novedades de la versión instalada.

Con esto, Visual Studio Code habrá quedado correctamente instalado y estará listo para añadir la extensión PlatformIO.

Instalar Python en macOS

Al igual que ocurre en Windows, PlatformIO necesita disponer de Python 3 para funcionar correctamente.

Aunque las versiones recientes de macOS ya incluyen Python para determinadas tareas del sistema, lo más recomendable es instalar una versión actual mediante Homebrew, el gestor de paquetes más utilizado en este sistema operativo.

1. Instalar Homebrew (si aún no lo tienes)

Si Homebrew no está instalado en tu equipo, puedes hacerlo ejecutando el siguiente comando desde la aplicación Terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

2. Instalar Python

Una vez instalado Homebrew, ejecuta el siguiente comando para instalar la versión más reciente de Python 3:

brew install python3

Cuando finalice la instalación, Python quedará disponible para que PlatformIO pueda utilizarlo automáticamente.

Con Visual Studio Code y Python correctamente instalados, ya tendrás todo preparado para el siguiente paso: instalar la extensión PlatformIO, que convertirá VS Code en un completo entorno de desarrollo para ESP32, ESP8266 y muchos otros microcontroladores.

C) Instalar Visual Studio Code en Ubuntu (Linux)

Si utilizas Ubuntu u otra distribución basada en Debian, instalar Visual Studio Code es un proceso rápido y sencillo.

1. Descargar Visual Studio Code

Accede a la página oficial de Visual Studio Code y descarga el paquete correspondiente para Linux (.deb).

Guarda el archivo en tu carpeta Descargas.

2. Instalar el paquete

Abre una ventana de Terminal, accede a la carpeta donde descargaste el instalador y ejecuta el siguiente comando:

cd ~/Downloads
sudo apt install ./code_*.deb

Consejo: utilizar code_*.deb en lugar del nombre completo del archivo hace que el comando funcione independientemente de la versión descargada, evitando tener que modificarlo cada vez que Microsoft publica una actualización.

Una vez finalizada la instalación, Visual Studio Code aparecerá automáticamente en el menú de aplicaciones de Ubuntu y podrás ejecutarlo como cualquier otro programa.

La primera vez que lo abras se mostrará la pantalla de bienvenida junto con las novedades de la versión instalada.

Con esto, VS Code ya estará preparado para instalar la extensión PlatformIO.

Instalar Python en Ubuntu

Para utilizar PlatformIO con placas ESP32 y ESP8266, es necesario disponer de Python 3.

1. Comprobar si Python ya está instalado

En la mayoría de distribuciones modernas de Ubuntu, Python 3 viene instalado por defecto. Puedes comprobarlo ejecutando:

python3 --version

Si el comando devuelve un número de versión, como por ejemplo:

Python 3.12.3

(o cualquier otra versión reciente de Python 3), no será necesario instalarlo de nuevo.

2. Instalar Python (si es necesario)

Si Python no está instalado, puedes hacerlo fácilmente con el siguiente comando:

sudo apt install python3

3. Instalar las utilidades necesarias

Independientemente de si Python ya estaba instalado o acabas de instalarlo, es recomendable añadir el paquete python3-distutils, ya que algunas herramientas utilizadas por PlatformIO pueden requerirlo.

sudo apt install python3-distutils

Nota: en las versiones más recientes de Ubuntu este paquete puede venir incluido por defecto o haber sido sustituido por otros componentes del sistema. Si el gestor de paquetes indica que no está disponible, normalmente PlatformIO seguirá funcionando sin problemas.

Con Visual Studio Code y Python 3 correctamente instalados, ya tendrás todo preparado para instalar PlatformIO IDE, el siguiente paso para comenzar a desarrollar proyectos con ESP32 y ESP8266 desde un entorno profesional.

Instalar la extensión PlatformIO en Visual Studio Code

Una vez instalados Visual Studio Code y Python, el siguiente paso es añadir PlatformIO IDE, la extensión que convierte VS Code en un completo entorno de desarrollo para ESP32, ESP8266 y cientos de placas basadas en microcontroladores.

La instalación solo lleva unos minutos.

1. Abrir Visual Studio Code

Inicia Visual Studio Code y abre el panel de Extensiones pulsando el icono correspondiente de la barra lateral o utilizando el atajo de teclado:

• Windows y Linux: Ctrl + Shift + X
• macOS: ⌘ + Shift + X

2. Buscar PlatformIO

En el cuadro de búsqueda escribe:

PlatformIO IDE

Entre los resultados aparecerá la extensión oficial desarrollada por PlatformIO.

3. Instalar la extensión

Selecciona la extensión y pulsa Install.

La descarga e instalación pueden tardar varios minutos, ya que PlatformIO instala automáticamente todas las herramientas necesarias para compilar, cargar y gestionar proyectos de sistemas embebidos.

Es completamente normal que durante este proceso se descarguen distintos componentes adicionales.

4. Verificar la instalación

Cuando la instalación finalice, la extensión aparecerá como Enabled (Activada).

Además, observarás dos cambios importantes en la interfaz de Visual Studio Code:

• Un nuevo icono de PlatformIO (PIO) en la barra lateral izquierda.
• El acceso a la pantalla de inicio de PlatformIO, desde la que podrás crear proyectos, administrar plataformas, instalar bibliotecas y configurar dispositivos.

Estos elementos indican que la instalación se ha realizado correctamente.

5. Reiniciar Visual Studio Code

En algunos equipos el icono de PlatformIO puede no aparecer inmediatamente.

Si ocurre esto, simplemente cierra y vuelve a abrir Visual Studio Code para que todos los cambios se apliquen correctamente.

De hecho, es recomendable reiniciar VS Code después de instalar PlatformIO, incluso aunque todo parezca funcionar correctamente. De esta forma te aseguras de que la extensión y todas sus herramientas se inicialicen sin problemas.

Con PlatformIO ya instalado, el siguiente paso será crear tu primer proyecto para ESP32 o ESP8266 y comenzar a programar desde uno de los entornos de desarrollo más completos y potentes disponibles en la actualidad.

Conociendo la interfaz de Visual Studio Code

Una vez instalado PlatformIO, es recomendable familiarizarse con la interfaz de Visual Studio Code, ya que la mayoría de las herramientas que utilizarás durante el desarrollo se encuentran siempre accesibles desde la barra lateral y la barra inferior.

Barra lateral izquierda

La barra lateral reúne las principales funciones del editor:

• Explorador de archivos: permite navegar por la estructura del proyecto, crear nuevos archivos y gestionar carpetas.
• Búsqueda global: localiza rápidamente texto, variables o funciones en todos los archivos del proyecto.
• Control de versiones (Git): facilita el seguimiento de cambios, la creación de commits y la sincronización con repositorios remotos.
• Ejecución y depuración (Run & Debug): permite iniciar sesiones de depuración en los dispositivos compatibles.
• Extensiones: desde aquí puedes instalar, actualizar o administrar los complementos de Visual Studio Code, incluido PlatformIO.

La Paleta de comandos

Una de las herramientas más útiles de VS Code es la Paleta de comandos (Command Palette).

Puedes abrirla mediante:

• Windows y Linux: Ctrl + Shift + P
• macOS: ⌘ + Shift + P

También está disponible desde el menú:

View → Command Palette…

La Paleta de comandos permite acceder rápidamente a prácticamente cualquier función del editor. Basta con escribir el nombre de la acción que deseas realizar para ejecutarla sin necesidad de navegar por los menús.

Barra de herramientas de PlatformIO

Tras instalar PlatformIO aparecerá una barra azul en la parte inferior de Visual Studio Code con accesos directos a las funciones más utilizadas.

De izquierda a derecha encontrarás:

• PlatformIO Home: abre la página principal de PlatformIO.
• Build: compila el proyecto sin cargarlo en la placa.
• Upload: compila y transfiere el programa al microcontrolador.
• Clean: elimina los archivos generados durante la compilación para realizar una compilación completamente limpia.
• Serial Monitor: abre el monitor serie para visualizar la salida del programa o enviar datos al dispositivo.
• New Terminal: crea una nueva terminal integrada dentro de Visual Studio Code.

Si sitúas el cursor sobre cualquiera de estos iconos durante unos segundos, VS Code mostrará una breve descripción de su función.

Panel de tareas de PlatformIO

Otra forma de acceder a todas las herramientas es pulsando el icono PIO situado en la barra lateral izquierda.

Desde este panel podrás ejecutar todas las tareas relacionadas con tu proyecto, como:

• Compilar el código.
• Cargar el firmware en la placa.
• Abrir el Monitor Serie.
• Limpiar archivos temporales.
• Administrar bibliotecas.
• Configurar el proyecto.

Si este panel no aparece, normalmente basta con abrir el menú de opciones (los tres puntos situados en la parte superior del panel lateral) y activar la opción correspondiente para mostrar las PlatformIO Tasks.

Una vez visibles, tendrás acceso desde un único lugar a todas las herramientas necesarias para desarrollar y gestionar proyectos con ESP32 y ESP8266.

Primeros pasos con PlatformIO

La mejor forma de familiarizarse con PlatformIO es creando un proyecto sencillo. En este ejemplo desarrollaremos el clásico programa Blink, que hace parpadear el LED integrado de una placa ESP32 o ESP8266.

Además de comprobar que todo funciona correctamente, este primer proyecto servirá para conocer la estructura básica que utiliza PlatformIO.

Crear un nuevo proyecto

Desde Visual Studio Code, haz clic en el icono PlatformIO Home y selecciona + New Project.

A continuación deberás configurar tres parámetros principales:

• Project Name: el nombre del proyecto (por ejemplo, Blink_LED).
• Board: selecciona el modelo de tu placa. En este ejemplo utilizaremos la DOIT ESP32 DEVKIT V1, aunque el procedimiento es exactamente el mismo para cualquier otra placa ESP32 o ESP8266.
• Framework: selecciona Arduino, ya que utilizaremos el conocido framework de Arduino para programar el microcontrolador.

Puedes guardar el proyecto en la ubicación predeterminada o elegir una carpeta personalizada.

Por defecto, PlatformIO almacena los proyectos en:

Documentos/PlatformIO/Projects

Cuando todo esté configurado, pulsa Finish.

En pocos segundos PlatformIO generará automáticamente toda la estructura del proyecto.

La estructura de un proyecto en PlatformIO

A diferencia de Arduino IDE, donde normalmente solo existe un archivo .ino, PlatformIO organiza cada proyecto mediante una estructura de carpetas mucho más completa.

Al abrir el panel Explorer observarás varios directorios y archivos creados automáticamente.

Aunque al principio pueda parecer complejo, en realidad la mayor parte de esos archivos no tendrás que modificarlos nunca. En la práctica, la mayoría de proyectos se desarrollan trabajando únicamente sobre uno o dos archivos.

Importante: no elimines ni cambies de ubicación las carpetas creadas automáticamente ni el archivo platformio.ini, ya que PlatformIO depende de esta estructura para compilar correctamente el proyecto.

El archivo platformio.ini

El archivo platformio.ini es el centro de configuración de cualquier proyecto desarrollado con PlatformIO.

En él se definen aspectos fundamentales como:

• La plataforma de hardware utilizada.
• El modelo de placa.
• El framework de programación.
• Las bibliotecas necesarias.
• Las opciones de compilación.
• La configuración de carga del firmware.
• Los parámetros del Monitor Serie.

Un ejemplo básico podría ser:

[env:esp32doit-devkit-v1]
platform = espressif32
board = esp32doit-devkit-v1
framework = arduino

Cada uno de estos parámetros tiene una función específica:

• platform: indica la familia del microcontrolador (por ejemplo, espressif32 para ESP32).
• board: especifica el modelo exacto de la placa de desarrollo.
• framework: determina el entorno de programación que utilizará el proyecto, siendo Arduino el más habitual para principiantes.

Configurar el Monitor Serie

Si deseas utilizar el Monitor Serie a 115200 baudios, simplemente añade la siguiente línea al archivo:

monitor_speed = 115200

Después guarda los cambios mediante Ctrl + S.

Más adelante también podrás utilizar este mismo archivo para añadir bibliotecas automáticamente mediante la directiva lib_deps, configurar opciones de carga o personalizar distintos aspectos del proyecto.

La carpeta src

La carpeta src contiene el código fuente del proyecto.

Dentro encontrarás un archivo denominado main.cpp, que será donde escribirás prácticamente todo el programa.

Al abrirlo verás una estructura muy similar a la de Arduino IDE, con las conocidas funciones:

• setup()
• loop()

La principal diferencia es que PlatformIO trabaja directamente con archivos C++, por lo que todos los proyectos deben comenzar incluyendo la cabecera de Arduino:

#include <Arduino.h>

A partir de ese momento podrás programar exactamente igual que en Arduino IDE, utilizando las funciones y bibliotecas habituales de Arduino, pero disfrutando de un entorno mucho más potente, organizado y preparado para proyectos de cualquier tamaño.

Cargar un programa en el ESP32 o ESP8266 con PlatformIO

Ahora que el proyecto ya está configurado, es momento de comprobar que todo funciona correctamente cargando un programa de prueba.

En este ejemplo utilizaremos el clásico Blink, que hace parpadear el LED integrado de la placa una vez por segundo mientras envía mensajes al Monitor Serie.

Copia el siguiente código en el archivo src/main.cpp:

#include <Arduino.h>

#define LED 2

void setup() {
  Serial.begin(115200);
  pinMode(LED, OUTPUT);
}

void loop() {
  digitalWrite(LED, HIGH);
  Serial.println("LED encendido");
  delay(1000);

  digitalWrite(LED, LOW);
  Serial.println("LED apagado");
  delay(1000);
}

Este programa es compatible tanto con ESP32 como con ESP8266, ya que en la mayoría de placas de desarrollo el LED integrado está conectado al GPIO 2.

Consejo: aunque siempre puedes copiar y pegar el código, es recomendable escribirlo manualmente cuando estés aprendiendo. Así podrás aprovechar funciones de PlatformIO como el autocompletado inteligente, la detección de errores en tiempo real y las sugerencias de código, herramientas que agilizan enormemente el desarrollo de proyectos.

Una vez terminado, guarda el archivo mediante Ctrl + S o desde Archivo → Guardar.

Compilar y cargar el programa

Con el código listo, solo tienes que pulsar el botón Upload de la barra inferior de PlatformIO.

También puedes realizar la misma acción desde:

PlatformIO → Project Tasks → Upload

PlatformIO compilará automáticamente el proyecto y, si no existen errores, transferirá el programa a la placa.

Cuando el proceso finalice correctamente aparecerá un mensaje indicando que la carga se ha completado con éxito.

A partir de ese momento, el ESP32 o ESP8266 comenzará a ejecutar el programa y el LED integrado empezará a parpadear cada segundo.

Utilizar el Monitor Serie

Para comprobar la salida del programa, pulsa el botón Serial Monitor de la barra inferior de PlatformIO.

Si todo funciona correctamente, la consola mostrará mensajes similares a los siguientes:

LED encendido
LED apagado
LED encendido
LED apagado
...

Estos mensajes confirman que el programa se está ejecutando correctamente y que la comunicación serie funciona sin problemas.

Nota: si la ventana del terminal no aparece automáticamente, puedes abrirla manualmente desde Terminal → New Terminal. Desde ella también podrás acceder al Monitor Serie y a otras herramientas de PlatformIO.

Con esta sencilla prueba habrás verificado que Visual Studio Code, PlatformIO, el compilador y tu placa ESP32 o ESP8266 están correctamente configurados y listos para comenzar a desarrollar proyectos más avanzados.

Detectar el puerto serie (COM)

Una de las ventajas de PlatformIO es que detecta automáticamente el puerto serie al que está conectada la placa, por lo que, en la mayoría de los casos, no tendrás que configurarlo manualmente.

Si deseas comprobar qué dispositivos ha detectado el entorno, abre PlatformIO Home y accede al apartado Devices.

Desde esta sección podrás consultar:

• El puerto serie asignado a la placa (COM en Windows o /dev/tty... en macOS y Linux).
• El modelo del dispositivo detectado.
• El chip USB-Serie utilizado.
• Otra información útil para identificar correctamente el hardware conectado.

Esta herramienta resulta especialmente útil cuando trabajas con varias placas conectadas al mismo ordenador o cuando necesitas comprobar si el sistema ha reconocido correctamente el dispositivo.

Solución de problemas

Aunque PlatformIO automatiza gran parte del proceso de programación, pueden aparecer algunos errores habituales durante la primera configuración.

Error: “Failed to connect to ESP32: Timed out…”

Si durante la carga del programa aparece un mensaje similar a:

A fatal error occurred:
Failed to connect to ESP32:
Timed out waiting for packet header...

significa que el ESP32 no ha entrado en modo de programación (Flash Mode).

Para solucionarlo:

1. Comprueba que has seleccionado el modelo correcto de placa.
2. Verifica que PlatformIO ha detectado el puerto serie adecuado.
3. Mantén pulsado el botón BOOT del ESP32.
4. Pulsa Upload para iniciar la carga.
5. Cuando aparezca el mensaje “Connecting…”, suelta el botón BOOT.
6. Espera a que finalice la programación. Si todo ha ido bien, aparecerá el mensaje indicando que la carga se ha completado correctamente.

En algunas placas económicas este procedimiento deberá repetirse cada vez que cargues un nuevo programa, aunque muchos modelos permiten habilitar el modo de programación automática mediante pequeñas modificaciones de hardware o utilizando versiones más recientes del firmware del conversor USB-Serie.

Error: “COM Port not found” o “Puerto COM no disponible”

Si PlatformIO no detecta ningún puerto serie, normalmente el problema está relacionado con los controladores del conversor USB integrado en la placa.

La mayoría de placas ESP32 incorporan uno de estos chips:

• CP2102 / CP210x
• CH340 / CH341

En estos casos basta con instalar el controlador correspondiente al chip utilizado por tu placa y volver a conectarla al ordenador.

Tras instalar los controladores, PlatformIO debería detectar automáticamente el nuevo puerto disponible.

Otros problemas habituales

Si continúas teniendo dificultades para programar tu ESP32 o ESP8266, revisa estos puntos antes de pensar que existe un fallo de hardware:

• Utiliza siempre un cable USB con capacidad de transferencia de datos.
• Comprueba que el puerto USB del ordenador funciona correctamente.
• Verifica que la placa recibe alimentación (el LED de encendido debería iluminarse).
• Reinicia Visual Studio Code y vuelve a abrir el proyecto.
• Actualiza PlatformIO y las plataformas instaladas si hace tiempo que no lo haces.
• Cierra cualquier otro programa que pueda estar utilizando el mismo puerto serie.

En la mayoría de los casos, estos sencillos pasos son suficientes para resolver los problemas más habituales de conexión y programación, permitiéndote continuar con el desarrollo de tus proyectos en ESP32 y ESP8266 sin complicaciones.

Cambiar la velocidad del Monitor Serie en PlatformIO

De forma predeterminada, PlatformIO configura el Monitor Serie a una velocidad de 9600 baudios. Sin embargo, muchos ejemplos para ESP32 y ESP8266 utilizan velocidades superiores, siendo 115200 baudios la más habitual.

Para modificar esta configuración, abre el archivo platformio.ini de tu proyecto y añade la siguiente directiva:

monitor_speed = 115200

Una vez guardado el archivo, el Monitor Serie utilizará automáticamente esa velocidad cada vez que lo abras desde PlatformIO.

Consejo: la velocidad configurada en monitor_speed debe coincidir con la utilizada en el programa mediante Serial.begin(). Por ejemplo, si tu código contiene Serial.begin(115200);, el archivo platformio.ini también deberá especificar monitor_speed = 115200. De lo contrario, los mensajes mostrados en el Monitor Serie aparecerán con caracteres ilegibles.

Instalar bibliotecas en PlatformIO

Una de las mayores ventajas de PlatformIO frente a Arduino IDE es su potente gestor de bibliotecas, que permite administrar automáticamente todas las dependencias de cada proyecto.

Cada proyecto mantiene sus propias bibliotecas, evitando conflictos entre versiones y facilitando enormemente la portabilidad del código.

Instalar una biblioteca desde la interfaz gráfica

Para añadir una nueva biblioteca:

1. Abre PlatformIO Home.
2. Accede al apartado Libraries.
3. Busca la biblioteca que deseas instalar (por ejemplo, Adafruit BME280).
4. Selecciónala y pulsa Add to Project.
5. Escoge el proyecto en el que quieres utilizarla.

PlatformIO añadirá automáticamente la dependencia al archivo platformio.ini, descargando tanto la biblioteca seleccionada como todas aquellas de las que dependa.

Instalar una biblioteca manualmente

También puedes añadir las dependencias editando directamente el archivo platformio.ini.

Por ejemplo:

lib_deps = adafruit/Adafruit BME280 Library @ ^2.1.0

Cuando guardes el archivo o vuelvas a compilar el proyecto, PlatformIO descargará automáticamente la versión indicada.

Añadir varias bibliotecas

Si tu proyecto necesita más de una biblioteca, puedes especificarlas en varias líneas para mejorar la legibilidad:

lib_deps =
    arduino-libraries/Arduino_JSON @ 0.1.0
    adafruit/Adafruit BME280 Library @ ^2.1.0
    adafruit/Adafruit Unified Sensor @ ^1.1.4

PlatformIO se encargará de descargar cada una de ellas, resolver sus dependencias y mantenerlas actualizadas dentro del proyecto.

Ventajas del gestor de bibliotecas de PlatformIO

El sistema de gestión de dependencias de PlatformIO ofrece varias ventajas frente al utilizado por Arduino IDE:

• Cada proyecto mantiene sus propias bibliotecas y versiones.
• Las dependencias se descargan automáticamente al compilar.
• Es posible fijar versiones concretas para garantizar la compatibilidad del código.
• Facilita compartir proyectos con otros desarrolladores, ya que PlatformIO instalará automáticamente todas las bibliotecas necesarias únicamente a partir del archivo platformio.ini.
• Reduce los problemas derivados de bibliotecas duplicadas o incompatibles.

Gracias a este sistema, PlatformIO se convierte en una herramienta especialmente adecuada para proyectos de cierta complejidad, donde mantener un control preciso sobre las dependencias resulta fundamental.

Abrir un proyecto existente en PlatformIO

Si deseas continuar trabajando en un proyecto creado anteriormente, PlatformIO permite abrirlo fácilmente desde Visual Studio Code.

Para ello:

1. Abre Visual Studio Code.
2. Accede a PlatformIO Home.
3. Haz clic en Open Project.
4. Navega hasta la carpeta donde se encuentra tu proyecto y selecciónala.

PlatformIO cargará automáticamente toda la estructura del proyecto, incluyendo el archivo platformio.ini, las bibliotecas instaladas y el código fuente, dejándolo listo para seguir programando exactamente donde lo habías dejado.

Personalizar el aspecto de Visual Studio Code

Uno de los puntos fuertes de VS Code es su enorme capacidad de personalización.

Desde el menú Manage (Configuración) puedes acceder a la opción Color Theme, donde encontrarás una amplia colección de temas claros y oscuros.

Cambiar el tema no solo modifica la apariencia del editor, sino que también puede mejorar la comodidad visual durante largas sesiones de programación, especialmente si trabajas muchas horas frente al ordenador.

Además de los temas incluidos por defecto, la comunidad ofrece miles de temas adicionales que pueden instalarse gratuitamente desde el Marketplace de Visual Studio Code.

Atajos de teclado

Visual Studio Code incorpora cientos de atajos de teclado que permiten realizar prácticamente cualquier acción sin utilizar el ratón.

Aprender los más habituales puede aumentar considerablemente la productividad, especialmente en proyectos de gran tamaño.

Entre los más utilizados se encuentran:

VS Code dispone de decenas de atajos adicionales para Windows, macOS y Linux que pueden consultarse desde la documentación oficial.

Conclusión

A lo largo de esta guía has aprendido a instalar y configurar Visual Studio Code junto con la extensión PlatformIO, uno de los entornos de desarrollo más completos para trabajar con placas ESP32 y ESP8266.

También has visto cómo crear proyectos, compilar programas, cargarlos en la placa, utilizar el Monitor Serie y administrar bibliotecas mediante el potente sistema de dependencias de PlatformIO.

¿Por qué elegir PlatformIO?

Aunque Arduino IDE continúa siendo una excelente opción para aprender y realizar proyectos sencillos, PlatformIO ofrece una experiencia mucho más avanzada y profesional.

Entre sus principales ventajas destacan:

• Detección automática del puerto serie al conectar la placa.
• IntelliSense, con autocompletado inteligente y sugerencias de código en tiempo real.
• Detección temprana de errores, resaltando problemas antes incluso de compilar el programa.
• Gestión automática de bibliotecas y dependencias, evitando conflictos entre proyectos.
• Navegación avanzada por el código, ideal para aplicaciones de gran tamaño.
• Soporte para múltiples archivos y proyectos complejos, manteniendo una estructura mucho más organizada.
• Integración nativa con Git, facilitando el control de versiones y el trabajo colaborativo.
• Amplias opciones de personalización, tanto del editor como del propio flujo de desarrollo.

En definitiva, si estás comenzando con el ESP32, Arduino IDE sigue siendo la alternativa más sencilla para dar los primeros pasos. Sin embargo, a medida que tus proyectos crezcan en complejidad, Visual Studio Code con PlatformIO se convertirá en un aliado imprescindible gracias a sus herramientas profesionales, su flexibilidad y su excelente rendimiento.

Dominar este entorno desde el principio te permitirá desarrollar aplicaciones para ESP32 y ESP8266 de una forma mucho más organizada, eficiente y escalable.