> For the complete documentation index, see [llms.txt](https://voltbro.gitbook.io/upravlenie-elektrodvigatelem/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://voltbro.gitbook.io/upravlenie-elektrodvigatelem/kollektornyi-dvigatel/praktika.-vbcores/arduino-ide/ustanovka-po.md).

# Установка ПО

Устанавливаем ПО программатора, Arduino IDE, STM32duino

Модули VBСores совместимы с Arduino IDE, большей частью ее библиотек (например, с библиотеками Adafruit для сенсоров, работающих по SPI или I2C), но для начала работы с ними требуется провести настройку IDE.

Первым делом необходимо установить саму [Arduino IDE](https://www.arduino.cc/en/software). Выберите загрузочный файл, соответствующий вашей операционной системе и установите программу. 

{% hint style="info" %}
Пользователям **Linux**: мануал по установке Arduino IDE доступен по [ссылке](https://www.arduino.cc/en/guide/linux#toc3). 

НЕ НУЖНО устанавливать ее через apt - там лежат очень старые версии.
{% endhint %}

Поскольку [USB-bootloader](https://www.arduino.cc/en/Tutorial/BuiltInExamples/ArduinoISP) у наших модулей отсутствует, для их прошивки требуется программатор ST-Link. Чтобы Arduino IDE научилась работать с ним, понадобится утилита [STM32CubeProg](https://www.st.com/en/development-tools/stm32cubeprog.html#get-software). Выберите версию для своей ОС и скачайте приложение. В процессе установки менять стандартные настройки не нужно. Когда потребуется, разрешите приложению установить необходимые драйвера. Скачивание программы требует регистрации на сайте STM.

{% hint style="info" %}
Пользователям **Linux**: мануал по установке STM32CubeProg доступен по [ссылке](https://wiki.st.com/stm32mpu/wiki/STM32CubeProgrammer#Installing_the_STM32CubeProgrammer_tool).

После установки нужно добавить [udev\_rules](https://wiki.st.com/stm32mpu/wiki/STM32CubeProgrammer#Preparing_the_USB_serial_link_for_flashing). В конце выполните команду:

```
sudo udevadm control --reload-rules
```

{% endhint %}

Ключом к взаимодействию Arduino IDE и микроконтроллеров семейства STM32 является библиотека [STM32duino](https://github.com/stm32duino). Для ее установки в Arduino IDE следует: 

* Открыть Arduino IDE, нажать «Файл (File)», затем «Настройки (Settings)». В открывшемся окне будет поле Дополнительные ссылки для Менеджера плат». В него необходимо вставить ссылку:

```
https://github.com/stm32duino/BoardManagerFiles/raw/main/package_stmicroelectronics_index.json
```

после этого нажать «Ок».

* Нажмите «Инструменты (Tools)», затем «Плата (Board) >  Менеджер плат (Boards manager)...». \
  В появившемся окне впишите в поле поиска «STM32», должен появиться пакет «STM32 MCU based boards». Нажмите «Установить». По окончании установки закройте окно Менеджера плат.