Приветствую!
Данная статья открывает цикл статей о программировании микроконтроллеров STM32 для новичков.
Сегодня я расскажу как написать моргание светодиодом двумя способами с использованием инструментов, труднодоступных в 2023 году.
Инструменты: Железо
Плата BlackPill или BluePill
Программатор ST-LinkV2
Загрузка среды разработки
Для настройки тактирования и периферии будем использовать ST CubeMX. Писать код будем в Keil. Cube MX можно скачать здесь, а Keil здесь. Для загрузки CubeMX потребуется регистрация на сайте ST Для загрузки Cube MX ссылка на пост Telegram актуальна на момент написания статьи и уже прожила полгода. Установка не требует особенных знаний, описывать ее процесс не буду, но могу ответить на вопросы в комментариях. Если у вас Mac OS или Linux, то здесь можно скачать CubeIDE - Eclipse подобную среду разработки от ST с интегрированным CubeMX (если вы не живете в России или умеете пользоваться Tor Browser и VPN), но статья будет длиться до второго пришествия, если я буду описывать весь процесс для всех сред разработки, так что просто отдельно упомяну критически важные моменты, когда это потребуется.
Создание проекта в CubeMX
Откроем CubeMx и увидим следующее окно:
![Рис. 1. Стартовый экран CubeMx Рис. 1. Стартовый экран CubeMx](https://habrastorage.org/getpro/habr/upload_files/a2e/ff0/54c/a2eff054cbd719d849935296ae7d0c95.png)
Для создания нового проекта выберем пункт "Access to MCU selector". После непродолжительной (относительно периода вращения земли вокруг своей оси) подгрузки компонентов откроется новое окно, где нам предложено выбрать интересующий нас микроконтроллер.
Важное замечание: В статье здесь и далее будут приведены примеры для программирования на платах BluePill и BlackPill, как самых распространенных среди начинающих. У Вас может быть любая другая плата - NUCLEO, DISCOVERY, но процесс настройки периферии, тактирования и программирования не будет принципиально отличаться от приведенных в статье.
"Выберешь черную таблетку..."
![Рис. 2. Окно поиска микроконтроллера. Первый микроконтроллер для BlackPill Рис. 2. Окно поиска микроконтроллера. Первый микроконтроллер для BlackPill](https://habrastorage.org/getpro/habr/upload_files/7bc/aa9/2bf/7bcaa92bfcdc3cac070309c31d55d7ed.png)
Если у вас плата BlackPill, вам нужно выбрать вариант STM32F401CC или STM32F411CC - на самом камне обычно достаточно хорошо различимо выгравирована маркировка лазером.
![Рис. 3. Окно поиска микроконтроллера. Второй микроконтроллер для BlackPill Рис. 3. Окно поиска микроконтроллера. Второй микроконтроллер для BlackPill](https://habrastorage.org/getpro/habr/upload_files/361/67e/430/36167e4309cdab19ea34c568700b636e.png)
Для BluePill:
![Рис. 4. Окно поиска микроконтроллера. Микроконтроллер для BluePill Рис. 4. Окно поиска микроконтроллера. Микроконтроллер для BluePill](https://habrastorage.org/getpro/habr/upload_files/b4b/82b/8a9/b4b82b8a98555186db5d53894aac8ab8.png)
После выбора нужного вам чипа нажимаем "Start Project" в правом верхнем углу и попадаем в окно "Pinout & Configuration" (Рисунок 5). Здесь в разделе System Core -> Sys в пункте "Debug" выбираем "Serial Wire" и справа видим два пина микроконтроллера, выделенных зеленым. Это пины отладочного интерфейса, через который будет происходить прошивка и отладка программ.
![Рис. 5. Включаем отладку Рис. 5. Включаем отладку](https://habrastorage.org/getpro/habr/upload_files/f1a/035/d26/f1a035d2680928f8e047db2016102287.png)
Теперь включим ножку 13 порта C в режиме GPIO Output - Вход выход общего назначения в режиме выхода - мышкой на ножку клик, выбираем "GPIO Output" (Рисунок 6)
![Рис. 6. GPIO output Рис. 6. GPIO output](https://habrastorage.org/getpro/habr/upload_files/c38/934/c4b/c38934c4baaf2779e5391f4b720c595f.png)
Для BluePill ножки совпадают - также выбираем пин 13 порта C.
Теперь переходим на вкладку "Project manager" и попадаем в меню "Project" (Рисунок 7).
В пункте "Toolchain/IDE" выбираем MDK - ARM для Keil или STM32CubeIDE для соответствующего варианта. Далее буду использовать Keil, выбираю его.
![Рис. 7. Меню Project Рис. 7. Меню Project](https://habrastorage.org/getpro/habr/upload_files/54c/138/c0f/54c138c0f270fe1a7cc95811eebb87bb.png)
Для удобства в дальнейшей работе, откроем вкладку "Code generator" (Рисунок 8, левый столбец, вторая кнопка) и поставим галочку напротив "Generate peripheral initialization as a pair of '.c/.h' files per peripheral ". Что это дает - каждый периферийный модуль микроконтроллера будет инициализироваться не в main.c, а в своем файле, что больших проектах улучшает читаемость.
![Рис. 8. Раздельные файлы Рис. 8. Раздельные файлы](https://habrastorage.org/getpro/habr/upload_files/6c4/44f/2d5/6c444f2d5a394cedbcf485e3dd8046b8.png)
Теперь нажмем кнопку "Generate code" (Рисунок 9).
![Рис. 9. Запуск Рис. 9. Запуск](https://habrastorage.org/getpro/habr/upload_files/493/e03/88f/493e0388f9b539d2f8a1a21d42fdf6a8.png)
После успешного создания проекта открываем его (Рисунок 10).
![Рис. 10. Проект успешно создан Рис. 10. Проект успешно создан](https://habrastorage.org/getpro/habr/upload_files/fe7/3a5/757/fe73a5757e51e368f8065b71c19d68a7.png)
Знакомство с проектом
Теперь рассмотрим окно проекта по умолчанию (Рисунок 11) 1 - дерево проекта, 2 - вывод компилятора, 3 - основное окно, в котором отображается текущий открытый документ, 4 - кнопка сборки проекта (F7), 5 - прошивка микроконтроллера (F8), 6 - Настройки проекта, 7 - переход в режим отладки (Ctrl+F5).
![Рис. 11.Проект Keil Рис. 11.Проект Keil](https://habrastorage.org/getpro/habr/upload_files/1ea/66f/362/1ea66f3627acf354cbf212ffe819c48e.png)
Передвинем консоль под дерево проекта, чтобы не занимать полезное место для кода
![Рис. 12. Удобная консоль Рис. 12. Удобная консоль](https://habrastorage.org/getpro/habr/upload_files/9d6/b16/cc0/9d6b16cc0e003c972d3e8e24b0241e71.png)
Развернем папку "Application/User/Core" и откроем файл main.c (Рисунок 13) Ctrl + колесико позволяет менять размер шрифта.
![Рис. 13. Открываем нужное Рис. 13. Открываем нужное](https://habrastorage.org/getpro/habr/upload_files/383/ac7/d3f/383ac7d3f456e0197079c6946ef55c36.png)
![Рис.14. Основное тело программы Рис.14. Основное тело программы](https://habrastorage.org/getpro/habr/upload_files/abd/87d/bc9/abd87dbc9b79ffc18b19e5bd97ed44b5.png)
Рассмотрим, что здесь есть: вначале подключается main.h файл и файл gpio.h, если поставили галочку раздельной генерации файлов периферии. Далее объявлен прототип функции конфигурации периферии и затем попадаем в main() функцию, в которой инициализируется HAL (Hardware Abstraction Layer) фреймфорк и тактирование с портами ввода вывода (Рисунок 14).
Кодим
В функции main() после инициализации, которая происходит единожды, присутствует бесконечный цикл while(1), в котором и будет выполняться наша программа. Обратите внимание на секции USER CODE - если писать код внутри них, то при перегенерации проекта из CubeMX, ваш код не перетрется.
Добавим в секцию USER CODE BEGIN 3 включение светодиода на ножке GPIOC 13, ожидание 500 мс и его выключение (Рисунок 15).
![Рис.15. Моргаем на регистрах Рис.15. Моргаем на регистрах](https://habrastorage.org/getpro/habr/upload_files/946/20f/031/94620f0318005dd8f089185744174a2a.png)
98 строка: В регистр ODR (Output Data Register) блока GPIO положили число, равное
1 << 13;
// или в бинарном выражении
0010 0000 0000 0000
Поскольку биты нумеруются справа налево (и с нуля), получается, что положили "1" в 13 й бит регистра ODR.
99 строка: Вызвали функцию HAL_Delay() с аргументом 500, где "500" - это миллисекунды, т.е 500 мс ничего не делаем.
100 строка: Вспомним число (1<<13) и инвертируем его.
1 << 13;
// или в бинарном выражении
0010 0000 0000 0000
// когда делаем ~(1<<13), мы побитово инвертируем число в скобках
1101 1111 1111 1111
теперь умножаем текущее значение регистра побитово на полученное число т.е все биты, которые были, сохраняют свое значение, кроме 13 - го, его умножили на ноль и сбросили.
0010 0000 0000 0000
// когда делаем ~(1<<13), мы побитово инвертируем число в скобках
1101 1111 1111 1111
//
светодиод в этот момент зажигается, потому что на плате BlackPill светодиод подтянут резистором к 3.3В.
101 строка: снова ждем 500 мс.
Теперь можно нажать F7, чтобы собрать проект, должно получиться так:
![Рис. 16. Успешно собрали Рис. 16. Успешно собрали](https://habrastorage.org/getpro/habr/upload_files/5a3/1b4/008/5a31b4008d86e1b7758f363cbde5e70f.png)
Теперь настроим отладчик, нажимаем "Настройки".
![Рис. 17. Настройки Рис. 17. Настройки](https://habrastorage.org/getpro/habr/upload_files/474/47e/a9e/47447ea9ebfd7dc3e9ff084a385d04a3.png)
И сменим компилятор на 6.16 - он гораздо быстрее и переходим в вкладку "Debug" (Рисунок 18).
![Рис. 18. Компилятор и отладка Рис. 18. Компилятор и отладка](https://habrastorage.org/getpro/habr/upload_files/0ae/a9e/c73/0aea9ec7332c79200d20994d195247fb.png)
Во вкладке "Debug" выберем ST-Link и подтверждаем выбор.
![Рис. 19. Выбираем отладчик Рис. 19. Выбираем отладчик](https://habrastorage.org/getpro/habr/upload_files/004/d0d/12a/004d0d12aa7ebe033aa7c8a8a75bf5ed.png)
Теперь можно подключить программатор к плате, вставить в USB компьютера и прошить, нажав F8. Если сразу не сработало, перепроверьте, не перепутаны ли контакты программатора и платы. После прошивки нужно нажать кнопку Reset на плате, чтобы светодиод начал мигать.
Очень надеюсь, что у вас получилось, потому что далее мы попробуем сделать то же самое, но изменив пару строчек кода и значения задержки с 500 на 100 мс (Рисунок 20):
![Рис. 20. Больше HAL Рис. 20. Больше HAL](https://habrastorage.org/getpro/habr/upload_files/519/a24/a48/519a24a48a4ff657535c6818c6d7a734.png)
Теперь на 98 строке появилась функция, которая включает пин 13 порта GPIOC.
На 99 строке "500" поменяли на "100".
На 100 строке соответственный пин выключает.
На 101 строке "500" поменяли на "100".
Снова соберем проект через F7 и зашьем проект нажатием F8, перезапустим МК нажатием RESET.
Если все сделали правильно, светодиод будет моргать гораздо чаще.
Домашнее задание
Для того, чтобы инвертировать значение бита, есть операнд "исключающее ИЛИ".
^=
Попробуйте использовать его для случая с регистрами, чтобы сократить число строчек кода в while(1) до двух.
Всем спасибо за то, что прочитали публикацию, жду ваших вопросов и исправления неточностей в комментариях или на почту: mgostev.it@gmail.com