Diretório de artigos
0 Prefácio
Antes, configurei o ambiente Arduino no computador baseado no VS Code. O método geral é baixar um plug-in no VS Code e configurar o caminho do Arduino IDE sob a premissa de instalar o Arduino IDE. De um modo geral, é muito simples . Mas hoje, ao configurar de acordo com o método na memória, apareceu uma janela pop-up:
Após tentativa e erro, descobri que se você deseja configurar com base no Arduino IDE como antes, basta ignorar essa configuração e não pode clicar em "Usar arduino-cli integrado", caso contrário, ocorrerão problemas.
Originalmente, esse problema estava quase resolvido, mas o mais abominável é que esse pop-up aparece toda vez que a janela é atualizada, o que é muito chato. Portanto, demorei um pouco para ler todas as informações relevantes sobre o arduino-cli com cuidado e fiquei surpreso ao descobrir que esse arduino-cli é incrível! Basta configurar o ambiente de desenvolvimento, e não depende em nada do IDE do Arduino! , este tutorial apresenta brevemente como configurar o ambiente de desenvolvimento do framework Arduino baseado em arduino-cli no VS Code .
Existem também alguns tutoriais semelhantes na Internet, mas não são detalhados e claros o suficiente. Partindo do princípio, aqui está um tutorial mais detalhado, com mais conteúdo, assista com paciência.
1 Vantagens do VS Code e desvantagens do Arduino IDE
Se você estiver usando o Arduino IDE, basta baixá-lo do site oficial e instalá-lo sem pensar, é muito simples. Mas usar o VS Code requer uma configuração relativamente problemática. Mas o trabalho duro sempre compensa. Aqui está uma breve palestra sobre as vantagens do VS Code e as desvantagens do Arduino IDE.
Olhe para os benefícios antes de decidir se quer gastar tempo.
- A interface do VS Code é melhor que a IDE do Arduino, não há dúvidas
- O VS Code pode rastrear o código-fonte, o que é muito mais conveniente para entender as bibliotecas de terceiros
- O prompt inteligente do VS Code (IntelliSence) reduz bastante a carga de trabalho do código de código
2 Preparação preliminar
- Ter o VSCode e entender seu princípio básico de funcionamento, podendo basicamente usá-lo
- Não há necessidade de baixar o Arduino IDE, se for baixado, pode ser desinstalado completamente.
3 CLI do Arduino
3.1 O que é a CLI do Arduino?
Antes de tudo, vamos entender o que é esse cli. O chamado cli , ou seja, Command Line Interface , é o oposto do gui (Graphic User Interface), ou seja, usar a linha de comando para realizar as funções que podem ser concluídas clicando no botão na interface gráfica. É uma ferramenta integrada lançada oficialmente em 2018. Integra o processo de desenvolvimento embarcado relacionado ao Arduino, como compilação e download, biblioteca de gerenciamento e SDK da placa, etc. ( Claro que não tem a função de compilar e baixar sozinho, apenas chama outras ferramentas para operar ) Desta forma, apenas esta ferramenta pode ser utilizada para construir todo o projeto, o que é muito poderoso.
E essa ferramenta é multiplataforma e pode ser facilmente integrada a vários editores populares, como VS Code e Eclipse, etc.
Se você estiver interessado, pode dar uma olhada na introdução fornecida no site oficial.
3.2 Download e instalação
A ferramenta Arduino cli é atualizada muito rapidamente, basicamente a cada poucos dias, por isso é recomendável baixá-la no GitHub oficial: https://github.com/arduino/arduino-cli/releases
O Arduino cli é um único arquivo executável que pode ser baixado como um pacote compactado e colocado em algum lugar do seu computador. No entanto, é recomendável baixar o arquivo com o sufixo , para que o caminho de instalação seja adicionado automaticamente à variável de ambiente.msi durante a instalação , o que é menos problemático.
Após a instalação, verifique se a instalação foi bem-sucedida:
arduino-cli -h #or --help
Se não houver erros, a instalação foi bem-sucedida.
O vermelho sublinhado na imagem acima são instruções mais importantes, que serão usadas posteriormente
3.3 Uso básico
Aqui estão duas técnicas de uso simples.
-
Consultar instruções de ajuda rapidamente
Se você não sabe quais "subcomandos" estão por trás de um determinado comando, você pode usar--helpou-hpara consultar o uso do comando. Ou não insira nenhum parâmetro diretamente e o documento de ajuda é aberto por padrão. Se você inseri-lo diretamente,arduino-cliele também abrirá o documento de ajuda -
Configuração de conclusão de tabulação
Esta é uma operação de conclusão de tabulação fornecida pelo oficial, que pode suportar a conclusão de todos os comandos e parâmetros, o que é mais conveniente ao inserir comandos. A premissa parece ser instalar o Power Shell7. Para tutoriais de configuração específicos, consulte o site oficial . Você pode ignorá-lo se não quiser se incomodar.
3.4 Configuração do ambiente de desenvolvimento
Como mencionado anteriormente, o arduino-cli é uma ferramenta integrada, que inclui basicamente as funções comuns do Arduino IDE, podendo até ser considerado o núcleo do Arduino IDE, mas carece de um editor. Portanto, é melhor entender as funções básicas do Arduino IDE para que você possa entender quase todas as etapas da configuração.
Antes de configurar, você deve primeiro saber quais diretórios o Arduino IDE possui.
- O primeiro é o diretório de instalação do IDE, que está
%ProgramFiles(X86)%\Arduino_1.8.19sob o diretório (caminho padrão) - Depois, há o diretório SDK da placa de desenvolvimento. Cada placa de desenvolvimento tem seu código básico correspondente, biblioteca integrada, ferramentas de compilação e download, etc. Esses arquivos são colocados na
%LocalAppdata%\Arduino15pasta - Se uma biblioteca de terceiros for instalada durante o uso, o arquivo da biblioteca será colocado na pasta do projeto Claro, isso também pode ser personalizado no IDE:
Depois de entender a estrutura de pastas do Arduino IDE, você deve ter uma certa compreensão de seu princípio de funcionamento e, em seguida, começar a usar o arduino-cli instalado para criar o ambiente de desenvolvimento do Arduino.
A parte do VS Code está no final, esta parte pode ser um pouco difícil de entender, mas não entre em pânico, apenas siga-a, e você poderá entendê-la depois de terminar.
- Configuração inicial
arduino-cli config init --dest-dir "$env:LOCALAPPDATA\Arduino15"
O motivo da escolha desta pasta é porque o plug-in do Arduino no VS Code só reconhece os arquivos de configuração desta pasta, o que será entendido mais adiante
Se você quiser ver a configuração, você pode:
arduino-cli config dump
Isso é essencialmente olhar para o arquivo de configuração inicial acima. Se não houver arquivo de configuração no caminho padrão, a configuração padrão interna será exibida.
- Modificar arquivo de configuração (opcional)
Ao verificar a configuração padrão, podemos ver que o arquivo da biblioteca e o arquivo SDK da placa não estão no mesmo caminho, o que é muito inconveniente para mim pessoalmente, então modifique a configuração:
arduino-cli config set directories.user "$env:LOCALAPPDATA\Arduino15"
Dessa forma, os arquivos de configuração, os arquivos do SDK da placa e os arquivos de biblioteca de terceiros instalados estão todos em um único caminho. Se você precisar encontrar o destino, será mais claro
- Baixe o núcleo da placa de desenvolvimento
Esse é o SDK mencionado repetidamente acima, placas diferentes são diferentes, se você desenvolver apenas o Arduino, precisará instalar apenas o kit de desenvolvimento do Arduino:
# 先更新一下板子列表（core list）
arduino-cli core update-index
# 再下载arduino核心（SDK）
arduino-cli core install arduino:avr
E se eu quiser desenvolver ESP8266 e ESP32? Lembra como foi configurado no Arduino IDE? Primeiro adicione um link de placa, um arquivo json e, em seguida, baixe e instale, e então a lista de placas terá muitos modelos opcionais de placas de desenvolvimento.
Acredito que quem já configurou sabe que a probabilidade de falha é muito alta ao configurar na IDE do Arduino, e muitas vezes são necessários vários cliques para fazer o download.
Portanto, o foco aqui é o arquivo json dos pacotes. Dos tutoriais anteriores, esse link sempre falhará, por isso é recomendável encontrar um link do GitHub relativamente fixo:
Instruções de instalação:
# 先添加额外的链接，按需选择，多个开发板用空格分隔
arduino-cli config set board_manager.additional_urls https://hub.yzuu.cf/esp8266/Arduino/releases/download/3.1.2/package_esp8266com_index.json https://hub.yzuu.cf/espressif/arduino-esp32/releases/download/2.0.7/package_esp32_index.json
# 然后再更新一下链接（实际上就是把上面两个文件下载下来）
arduino-cli core update-index
# 这个时候就可以根据需要下载对应的开发板包了
arduino-cli core install esp32:esp32
arduino-cli core install esp8266:esp8266
Na terceira etapa, se a velocidade de download estiver muito lenta, é porque cada pacote de download é baixado do GitHub. É recomendável modificar o arquivo de pacotes e usar o site espelho para fazer o download, a velocidade será muito mais rápida:
Recomenda-se usar pesquisar e substituir, github.comsubstituir tudo por hub.yzuu.cfe, em seguida, executar o comando acima
Após a conclusão da instalação, você pode usar arduino-cli para limpar o arquivo de cache
# 加上-v可以看到详细输出信息
arduino-cli cache clean -v
Até agora, a parte arduino-cli está configurada, e então vamos ver como configurar a parte VS Code
4 Configuração do Código VS
- Primeiro instale o plug-in do Arduino, não há dúvidas sobre isso
Minha sugestão é dar uma olhada mais de perto no módulo "Detalhes", para que você possa entender melhor as operações posteriores. Este plug-in possui duas dependências, ou seja, o plug-in C/C++ e um plug-in de porta serial, que devem ser instalados automaticamente durante a instalação.
Depois de instalar o plug-in, se você olhar o diretório de instalação deste plug-in, verá que um Arduino CLI foi baixado por padrão no diretório (ou seja, o Arduino CLI que instalamos anteriormente, talvez apenas a versão é diferente), e as funções de compilação e download do plug-in dependem da implementação deste programa.
Teoricamente, já existe um programa de execução, então você não precisa instalá-lo sozinho, mas pessoalmente acho que você ainda precisa instalá-lo novamente. Existem dois motivos principais:
- ①O arquivo em si não é muito grande, <30M, então baixar/copiar parece mais barato;
- ②Para usar este programa em qualquer local, é melhor adicioná-lo à variável de ambiente, mas como o plug-in do VS Code mudará o diretório quando for atualizado, geralmente ele muda com o tempo, adicionando-o ao ambiente variável não é significativa.
- Configurações do plug-in
A configuração deste plug-in é muito simples, basta verificar a opção Use Arduino Cli
- uso básico
Se o SDK da placa de desenvolvimento tiver sido instalado, crie um novo arquivo no VS Code .inoe, em seguida, selecione a placa de desenvolvimento na barra de status inferior, o programa será atualizado automaticamente e crie um arquivo na pasta atual do projeto c_cpp_properties.json, que define o desenvolvimento da placa de desenvolvimento correspondente O compilador que precisa ser usado no processo, os arquivos da biblioteca que precisam ser incluídos, etc. Se não aparecer, você pode tentar Ctrl Shift P, optar por recarregar a janela e atualizar várias vezes. E se você trocar a placa de desenvolvimento, ela será atualizada automaticamente, essa é a função importante do VS Code, ou seja, ajuda a economizar muito trabalho e você não precisa digitar comandos sozinho, o que é muito conveniente .
- Adicionar arquivos de biblioteca
E se você quiser adicionar uma biblioteca de terceiros e usá-la no programa durante o processo de desenvolvimento do programa? Primeiro, instale a biblioteca de terceiros usando a linha de comando:
# 查看已安装的库
arduino-cli lib list
# 搜索某个库
arduino-cli lib search <name>
# 安装某个库
arduino-cli lib install <name>
# 升级
arduino-cli lib upgrade
Depois de instalar a biblioteca de terceiros, ela pode ser referenciada diretamente no programa, mas geralmente uma linha ondulada será desenhada. Isso ocorre porque o arquivo c_cpp_properties.json não foi atualizado. Tente recarregar a janela. Está quase bom, porque toda vez que a janela for recarregada, o plug-in verificará o arquivo ino aberto (Verificar)
-
Precauções para uso
- Fique sempre atento à barra de status no canto inferior direito, ou seja, modelo da placa, número da porta serial, arquivo de destino (não necessariamente o arquivo aberto), etc.
- arduino-cli ainda usa o conceito de arquivos de projeto Arduino IDE, então toda vez que você criar um novo arquivo, lembre-se de definir uma pasta com o mesmo nome fora
Resumindo, o plug-in do Arduino realmente conta com o programa cli no diretório de instalação, e integra algumas de suas funções comuns em alguns botões da interface do VS Code, o que facilita muito o uso dos desenvolvedores. Antes de baixar e instalar o arduino -cli , mais para necessidades ocasionais, como ao instalar uma biblioteca de terceiros, mas a operação real ainda é o programa arduino-cli que vem com o VS Code. É equivalente a dois programas idênticos lendo e gravando a mesma pilha de arquivos.