Nota: A extensão está atualmente em desenvolvimento.
Esta é a extensão oficial do Visual Studio Code para desenvolvimento do Raspberry Pi Pico. Esta extensão fornece um conjunto de ferramentas projetadas para agilizar seus projetos do Pico usando o Visual Studio Code e o Pico SDK oficial.
Para obter instruções de configuração abrangentes, consulte o PDF do guia de primeiros passos.
Baixar o Beta mais recente?
Compilação e depuração com um clique : configure automaticamente OpenOCD, Ninja e CMake, permitindo compilar e depurar com um único clique.
Documentação offline : acesse de forma conveniente a documentação do Pico SDK diretamente no editor, mesmo quando estiver offline.
Troca de versão : alterne perfeitamente entre diferentes versões do Pico SDK e ferramentas.
Não é necessária configuração manual : a extensão lida com variáveis de ambiente, conjunto de ferramentas, SDK e gerenciamento de ferramentas para você.
Compilação com um clique : compile projetos diretamente da barra de status com o SDK e as ferramentas selecionadas.
Documentação offline : acesse a documentação do Pico SDK offline.
Configuração rápida do projeto : crie rapidamente novos projetos do Pico a partir da visualização do Explorer quando nenhum espaço de trabalho estiver aberto.
Suporte MicroPython : Crie projetos Pico baseados em MicroPython com suporte fornecido por meio da extensão MicroPico.
Plataformas suportadas: Raspberry Pi OS (64 bits), Windows 10/11 (x86_64), macOS Sonoma (14.0) e mais recente, Linux x64 e arm64
Não são necessários requisitos adicionais.
Para atender aos requisitos do macOS, execute o seguinte comando no Terminal para instalar as ferramentas necessárias:
xcode-select --install
Este comando instala todas as ferramentas necessárias, incluindo, mas não se limitando a:
libftdi1-2
e libhidapi-hidraw0
para usar o OpenOCD Esta extensão fornece as seguintes configurações:
raspberry-pi-pico.cmakePath
: Especifique um caminho personalizado para CMake.raspberry-pi-pico.python3Path
: Especifique um caminho personalizado para Python 3 (escopo da máquina) .raspberry-pi-pico.ninjaPath
: Especifique um caminho personalizado para Ninja.raspberry-pi-pico.gitPath
: especifique um caminho personalizado para o Git.raspberry-pi-pico.cmakeAutoConfigure
: fornece um token de acesso pessoal do GitHub (clássico) com o escopo public_repo
. Este token é usado para verificar as versões disponíveis do Pico SDK e outras ferramentas. Sem ele, a extensão usa a API GitHub não autenticada, que tem um limite de taxa mais baixo e pode levar a funcionalidades restritas se o limite for excedido. O limite de taxa não autenticada é por endereço IP público, portanto, um token é mais necessário se o seu IP for compartilhado com muitos usuários. Para projetos mais complexos, como aqueles com vários executáveis ou quando o nome do projeto é definido como uma variável, esta extensão pode ser integrada à extensão CMake Tools para aprimorar a análise do CMake. Você pode habilitar a integração do CMake Tools durante a geração do projeto em Advanced Options . Além disso, para ativá-lo manualmente, ajuste as seguintes configurações em seu settings.json
:
raspberry-pi-pico.cmakeAutoConfigure
: Defina de true
para false
.raspberry-pi-pico.useCmakeTools
: Defina de false
para true
.Para obter funcionalidade ideal, considere ativar:
cmake.configureOnEdit
: verdadeirocmake.automaticReconfigure
: verdadeirocmake.configureOnOpen
: verdadeiro Quando solicitado, selecione o kit Pico
no CMake Tools e defina seus alvos de construção e lançamento de acordo. Use o CMake Tools para compilação, mas continue usando esta extensão para depuração, pois a depuração do CMake Tools não é compatível com o Pico.
Se você trabalha com vários conjuntos de ferramentas de microcontroladores, considere instalar esta extensão em um perfil do VS Code para evitar conflitos com outros conjuntos de ferramentas. Siga estas etapas:
Ctrl+Shift+P
(ou Cmd+Shift+P
no macOS) e selecione Profiles: Import Profile
.CMakeLists.txt
como caminhos SDK e Toolchain. Você precisa criar e configurar projetos por meio da extensão para usar esses caminhos personalizados. Se você encontrar problemas ao recuperar as versões disponíveis do Pico SDK, pode ser devido aos limites de taxa da API do GitHub. Para resolver isso, crie um token de acesso pessoal (PAT clássico) com o escopo public_repo
e defina-o nas configurações globais da extensão (Usuário) para aumentar seu limite de taxa.
Para usuários avançados que desejam criar o arquivo de extensão .vsix
, siga estas etapas:
npm install -g yarn
npm install -g @vscode/vsce
yarn
no diretório do projeto para instalar dependências.vsce package
. Isso gerará um arquivo .vsix
, que você pode instalar no VS Code usando code --install-extension path-to.vsix
ou por meio da GUI: Extensions > three dots > Install from VSIX
.