В данной заметке речь пойдёт о настройке среды разработки под STM32 на линуксе. Будет рассказано как подготовить базовую среду и заставить плату мигать светодиодами, более сложные аспекты, такие как настройка отладчиков затрагиваться не будет.
Общий концепт
В качестве конфигуратора будет использоваться STM32 CubeMX. IDE - VSCode с отдельно установленными терминальными утилитами для работы с платами STM32.
Установка CubeMX
Переходим на официальную страницу для скачивания CubeMX, желательно с включенным VPN (если вы заходите из России).
Выбираете последнюю версию для Linux:
Далее соглашаетесь с лицензией и создаёте новый аккаунт, либо входите в свой, если такой имеется. Ссылку на скачивание установщика вам пришлют на почту. Она действует какое-то определённое время, поэтому желательно скачать сразу.
Далее необходимо запустить установщик:
chmod +x SetupSTM32CubeMX-6.10.0
./SetupSTM32CubeMX-6.10.0
Название файла может немного отличаться, в зависимости от версии.
Далее соглашаемся с лицензиями и устанавливаем всё с дефолтными параметрами. В итоге CubeMX будет установлен в выбранную вами директорию (по-умолчанию : ~/STM32CubeMX).
В ней находится бинарник STM32CubeMX.
Генерация проекта - пример
Далее будет показан пример конфигурации и прошивки платы STM32 Discovery на контроллере STM32F303VCT6, но инструкция так же применима и к другим отладочным платам и контроллерам, например Blue Pill с STM32F103C8T6.
Нажимаем "Access to board selector" и через поиск находим наш контроллер.
Далее "Start Project". Настроим пины PE8 и PE9 на выход (GPIO_OUTPUT), к ним подключены светодиоды LD4 и LD3.
Далее можно настроить остальные интерфейсы, частоты тактирования и так далее. Чтобы не усложнять пример оставим всё по-умолчанию, на среду разработки это не влияет. Переходим в раздел "Project Manager".
Указываем название проекта и выбирает тулчеин (Toolchain/IDE): Makefile, как на скриншоте ниже:
Теперь нажимаем на синюю кнопку "GENERATE CODE" в правом верхнем углу.
В итоге получим следующее уведомление:
При нажатии "Open Folder" директория проекта откроется в дефолтном файловом менеджере, либо в VSCode (у меня настроено, чтобы все папки открывались в нём).
VSCode и прошивка платы
Структура файлов кода проекта не отличается от той, которая будет в Keil. Добавим простой код, который будет мигать двумя светодиодами (через библиотеку HAL) в бесконечный цикл, в файле Core/Src/main.c
HAL_GPIO_TogglePin (GPIOE, GPIO_PIN_8);
HAL_GPIO_TogglePin (GPIOE, GPIO_PIN_9);
HAL_Delay (500);
Теперь необходимо скомпилировать проект, для этого в системе должен стоять make. Установить его легко:
sudo pacman -Sy make # Arch based
sudo apt install make # Debian
Для компиляции в терминале пишем:
make all
В итоге в директории build будут объектные файлы всех библиотек и бинарник итоговой прошивки (LinuxEnvTest.bin), которую необходимо загрузить на плату:
Прошивать плату будем через программатор STLink. На STM32 Discovery он разведён на плате, для Blue Pill необходимо использовать внешний.
Пакет инструментов для STLink легко устанавливается на большинство дистрибутивов Linux:
sudo pacman -Sy stlink # Arch
sudo apt install stlink-tools # Ubuntu
Через st-info --probe проверим подключение платы к компьютеру:
Для прошивки используем следующую команду (замените название бинарника на своё):
st-flash write build/LinuxEnvTest.bin 0x08000000
Для полной очистки прошивки с платы используется следующая плата (необходимо задержать RESET кнопку на плате при подключении):
st-flash --connect-under reset write build/LinuxEnvTest.bin 0x08000000
После прошивки всё работает и плата мигает двумя светодиодами.
Заключение
Использование конфигурации проекта с помощью Makefile в STM32 CubeMX позволяет использовать любой редактор кода для разработки, который вы уже настроили под себя. Это достаточно удобно, но к сожалению, лишает некоторых специализированных инструментов. Например отладчика, который "из коробки" есть в Keil. Его можно заменить gdb или утилитами под JTAG.