Configurando o ambiente de desenvolvimento

Lidar com microcontroladores envolve o uso de várias ferramentas, pois estaremos lidando com uma arquitetura diferente da arquitetura do seu computador e teremos que executar e depurar programas em um dispositivo "remoto".

Documentação

No entanto, as ferramentas não são tudo. Sem documentação, é praticamente impossível trabalhar com microcontroladores.

Vamos fazer referência a todos esses documentos ao longo deste livro:

Ferramentas

Vamos utilizar todas as ferramentas listadas abaixo. Onde uma versão mínima não for especificada, qualquer versão recente deve funcionar, mas listamos a versão que testamos.

  • Rust 1.57.0 ou um toolchain mais recente.
  • gdb-multiarch. Versão testada: 10.2. Outras versões provavelmente também funcionarão bem, mas se a sua distribuição/plataforma não tiver o gdb-multiarch disponível, arm-none-eabi-gdb também servirá. Além disso, alguns binários normais do gdb são construídos com recursos multiarquitetura, você pode encontrar mais informações sobre isso nos subcapítulos.
  • minicom para Linux e macOS. Versão testada: 2.7.1. Outras versões provavelmente também funcionarão.
  • PuTTY para Windows.

Em seguida, siga as instruções de instalação independentes do sistema operacional para algumas das ferramentas.

rustc & Cargo

Instale o rustup seguindo as instruções em https://rustup.rs.

Se você já tiver o rustup instalado, verifique se você está no canal estável e se sua toolchain estável está atualizada. rustc -V deve retornar uma data mais recente do que a mostrada abaixo:

$ rustc -V
rustc 1.53.0 (53cb7b09b 2021-06-17)

cargo-binutils

$ rustup component add llvm-tools-preview

$ cargo install cargo-binutils --vers 0.3.3

$ cargo size --version
cargo-size 0.3.3

cargo-embed

Para instalar o cargo-embed, primeiro instale seus pré-requisitos. Em seguida, instale-o com cargo:

$ cargo install cargo-embed --vers 0.11.0

$ cargo embed --version
cargo-embed 0.11.0
git commit: crates.io

Este repositório

Como este livro também contém algumas pequenas bases de código Rust usadas em vários capítulos, você também terá que baixar seu código-fonte. Você pode fazer isso de uma das seguintes maneiras:

  • Visite o repositório, clique no botão verde "Code" e depois no botão "Download Zip"
  • Clone-o usando git (se você conhece o git, provavelmente já o tem instalado) do mesmo repositório mencionado na abordagem do zip

Instruções específicas do sistema operacional

Agora siga as instruções específicas para o sistema operacional que você está usando: