ПРИМЕЧАНИЕ Все команды Linux описаны для Ubuntu 18.04 и новее, а так же Debian Stretch и новее. В других дистрибутивах Linux команды и названия пакетов могут отличатся.

Настройка нструментария Rust

Мы рекомендуем использовать Rustup, чтобы легко установить последнюю стабильную версию Rust. Перейдите на https://rustup.rs и следуйте инструкциям.

Пользователи Windows: Нужно установить дополнителный пакет Microsoft C++ Build Tools.

Обновление компилятора и его компонентов: Если у вас уже установлен Rust, убедитесь, что вы используете последнюю версию, запустите rustup update в терминале.

Мы рекомендуем использовать стабильную версию копилятора, так как ночные сборки Rust часто ломаются.

Использование стабильной версии копилятора: Rustup можно настроить по умолчанию на стабильную версию компилятора, запустите rustup default stable в терминале.

Чтобы компилировать код для платы crabik, нужно добавить поддержку архитектуры Cortex-M4 и утилит для анализа скомпилированой программы, запустите в терминале:

rustup target add thumbv7em-none-eabi
rustup component add llvm-tools-preview

Наличие Git: Если у вас не установлен Git, то вам нужно его установить для дальнейшей работы с Cargo. Для установки перейдите на страницу Установка Git и следуйте инструкциям для установки под вашу ОС.

Так же нужно установить утилиты и дополнения для сборщика Cargo. Они нужны для быстрого создания проекта из шаблона, простой загрузки программы, а так же анализа скомпилированной программы. Запустите в терминале:

ПРИМЕЧАНИЕ Если вы используете Linux, то запустите в терминале sudo apt-get install libudev-dev libusb-1.0-0-dev для установки библиотеки libusb.

cargo install cargo-binutils probe-run flip-link cargo-embed cargo-flash cargo-generate

Установка инструментов отладки

Инструкция для Windows

ARM предоставляет Набор инструментов GNU, в готовом установщике для Windows. Скачайте установщик GNU Arm Embedded Toolchain и следуйте инструкциям. Незадолго до завершения процесса установки выберите опцию "Add path to environment variable". Затем убедитесь, что инструменты находятся в вашем %PATH%, запустите в терминале:

arm-none-eabi-gcc -v

Если вы увидели информацию о версии, то Набор инструментов GNU установлен.

Для отладки нам понадобится OpenOCD. Официальной версии OpenOCD для Windows нет, но вы можете скачать xPack OpenOCD. Извлеките zip архив по пути C:\OpenOCD-0.10, затем добавте в переменную %PATH% путь C:\OpenOCD-0.10\bin. Проверьте правильность установки, запустив в терминале:

openocd -v

Если вы увидели информацию о версии, то OpenOCD установлен.

Инструкция для Linux

Установите GNU Arm Embedded Toolchain и OpenOCD, запустив в терминале:

sudo apt-get install gdb-multiarch openocd

Инструкция для macOS

Все инструменты можно установить с помощью Homebrew.

Добавте хранилище пакетов ArmMbed, запустив в терминале:

brew tap ArmMbed/homebrew-formulae

Установите GNU Arm Embedded Toolchain, запустив в терминале:

brew install arm-none-eabi-gcc

Установите OpenOCD, запустив в терминале:

brew install openocd

Установка VS Code и расширений

Для написания кода мы будем использовать редактор кода VS Code, в нем хорошо работает Rust Analyzer, а так же он прост в изучении и настройке.

Установка под Windows: Перейдите на https://code.visualstudio.com и нажмите "Download for Windows".

Установка под Linux: Cледуйте инструкциям для вашего дистрибутива на https://code.visualstudio.com/docs/setup/linux.

Установка под macOS: Перейдите на https://code.visualstudio.com и нажмите "Download for Mac".

После установки редактора, нужно установить расширения для удобной работы с Rust, конфигурацией проекта и отладки кода. Запустите следующие команды в терминале:

code --install-extension matklad.rust-analyzer
code --install-extension bungcip.better-toml
code --install-extension marus25.cortex-debug