pico vscode

Extensión de código de Visual Studio para Raspberry Pi Pico

Nota: La extensión está actualmente en desarrollo.

Esta es la extensión oficial de Visual Studio Code para el desarrollo de Raspberry Pi Pico. Esta extensión le proporciona un conjunto de herramientas diseñadas para optimizar sus proyectos Pico utilizando Visual Studio Code y el SDK oficial de Pico.

Para obtener instrucciones de configuración completas, consulte la guía de introducción en PDF.

¿Descargar la última versión Beta?

Características

Configuración y gestión de proyectos

• Generador de proyectos : cree y configure fácilmente nuevos proyectos con soporte para funciones avanzadas de Pico como I2C y PIO. El generador apunta al sistema de construcción Ninja y permite la personalización durante la creación del proyecto.
• Configuración rápida del proyecto : inicie nuevos proyectos de Pico directamente desde la vista del Explorador, cuando no haya ningún espacio de trabajo abierto.
• Soporte MicroPython : cree y desarrolle proyectos Pico basados ​​en MicroPython con soporte proporcionado a través de la extensión MicroPico.

Configuración y gestión de herramientas

• Configuración automática de CMake : configura CMake automáticamente al cargar un proyecto.
• Cambio de versión : cambie sin problemas entre diferentes versiones de Pico SDK y herramientas.
• No se requiere configuración manual : maneja automáticamente variables de entorno, cadena de herramientas, SDK y administración de herramientas.
• Incluye un desinstalador : elimine fácilmente la extensión junto con todas las herramientas y SDK instalados automáticamente.

Compilación, depuración y documentación

• Compilación y depuración con un clic : configure automáticamente OpenOCD, Ninja y CMake, lo que le permitirá compilar y depurar con un solo clic.

• Documentación sin conexión : acceda cómodamente a la documentación de Pico SDK directamente desde el editor, incluso sin conexión.

• Cambio de versión : cambie sin problemas entre diferentes versiones de Pico SDK y herramientas.

• No se requiere configuración manual : la extensión maneja las variables de entorno, la cadena de herramientas, el SDK y la administración de herramientas por usted.

• Compilación con un clic : compila proyectos directamente desde la barra de estado con el SDK y las herramientas seleccionadas.

• Documentación sin conexión : acceda a la documentación de Pico SDK sin conexión.

• Configuración rápida de proyectos : cree rápidamente nuevos proyectos Pico desde la vista del Explorador cuando no haya ningún espacio de trabajo abierto.

• Compatibilidad con MicroPython : cree proyectos Pico basados ​​en MicroPython con soporte proporcionado a través de la extensión MicroPico.

Requisitos por sistema operativo

Plataformas compatibles: Raspberry Pi OS (64 bits), Windows 10/11 (x86_64), macOS Sonoma (14.0) y posteriores, Linux x64 y arm64

• Código de Visual Studio v1.92.1 o posterior

Sistema operativo Raspberry Pi y Windows

No se necesitan requisitos adicionales.

macos

Para cumplir con los requisitos de macOS, ejecute el siguiente comando en Terminal para instalar las herramientas necesarias:

xcode-select --install

Este comando instala todas las herramientas necesarias, incluidas, entre otras:

• Git 2.28 o posterior (asegúrese de que esté en su RUTA)
• Tar (asegúrate de que esté en tu RUTA)

linux

• Python 3.9 o posterior (asegúrese de que esté en su RUTA o configurado en la configuración)
• Git 2.28 o posterior (asegúrese de que esté en su RUTA)
• Tar (asegúrate de que esté en tu RUTA)
• [Opcional] gdb-multiarch para depuración (solo x86_64)
• Para [Ubuntu 22.04] , instale los paquetes libftdi1-2 y libhidapi-hidraw0 para usar OpenOCD

Configuración de extensión

Esta extensión proporciona las siguientes configuraciones:

• raspberry-pi-pico.cmakePath : especifica una ruta personalizada para CMake.
• raspberry-pi-pico.python3Path : especifique una ruta personalizada para Python 3 (ámbito de máquina) .
• raspberry-pi-pico.ninjaPath : especifica una ruta personalizada para Ninja.
• raspberry-pi-pico.gitPath : especifica una ruta personalizada para Git.
• raspberry-pi-pico.cmakeAutoConfigure : proporciona un token de acceso personal de GitHub (clásico) con el alcance public_repo . Este token se utiliza para comprobar las versiones disponibles de Pico SDK y otras herramientas. Sin ella, la extensión utiliza la API de GitHub no autenticada, que tiene un límite de velocidad más bajo y puede dar lugar a una funcionalidad restringida si se excede el límite. El límite de tasa de no autenticados es por dirección IP pública, por lo que un token es más necesario si su IP se comparte con muchos usuarios.

Integración de la extensión de herramientas CMake

Para proyectos más complejos, como aquellos con múltiples ejecutables o cuando el nombre del proyecto se define como una variable, esta extensión se puede integrar con la extensión CMake Tools para mejorar el análisis de CMake. Puede habilitar la integración de CMake Tools durante la generación del proyecto en Opciones avanzadas . Además, para habilitarlo manualmente, ajuste las siguientes configuraciones en su settings.json :

• raspberry-pi-pico.cmakeAutoConfigure : se establece de true a false .
• raspberry-pi-pico.useCmakeTools : se establece de false a true .

Para una funcionalidad óptima, considere habilitar:

• cmake.configureOnEdit : verdadero
• cmake.automaticReconfigure : verdadero
• cmake.configureOnOpen : verdadero

Cuando se le solicite, seleccione el kit Pico en CMake Tools y configure sus objetivos de compilación y lanzamiento en consecuencia. Utilice CMake Tools para la compilación, pero continúe usando esta extensión para la depuración, ya que la depuración de CMake Tools no es compatible con Pico.

Perfiles de código VS

Si trabaja con varias cadenas de herramientas de microcontroladores, considere instalar esta extensión en un perfil de VS Code para evitar conflictos con otras cadenas de herramientas. Siga estos pasos:

1. Descargue el perfil de muestra desde aquí.
2. Abra la paleta de comandos con Ctrl+Shift+P (o Cmd+Shift+P en macOS) y seleccione Profiles: Import Profile .
3. Importe el archivo descargado para instalar la extensión en un perfil Pico dedicado.
4. Esta configuración ayuda a aislar la extensión Pico de otras extensiones, lo que reduce el riesgo de conflictos.

Problemas conocidos

• Rutas personalizadas: las rutas personalizadas para Ninja, Python3 y Git no se almacenan en CMakeLists.txt como las rutas de SDK y Toolchain. Debe crear y configurar proyectos a través de la extensión para utilizar estas rutas personalizadas.

Límite de tasa de API de GitHub ("Error al recuperar las versiones del SDK y la cadena de herramientas")

Si tiene problemas para recuperar las versiones disponibles de Pico SDK, puede deberse a los límites de velocidad de la API de GitHub. Para resolver esto, cree un token de acceso personal (PAT clásico) con el alcance public_repo y configúrelo en la configuración de la extensión global (Usuario) para aumentar su límite de velocidad.

Instrucciones de construcción

Para usuarios avanzados que quieran crear el archivo de extensión .vsix , siga estos pasos:

1. Instalar nodejs (Instrucciones de Windows)
2. Instale Yarn globalmente: npm install -g yarn
3. Instale VSCE globalmente: npm install -g @vscode/vsce
4. Ejecute yarn en el directorio del proyecto para instalar dependencias.
5. Compile la extensión con: vsce package .

Esto generará un archivo .vsix , que puede instalar en VS Code usando code --install-extension path-to.vsix o mediante la GUI: Extensions > three dots > Install from VSIX .