Я скачал репозиторий RT-Thread [1]. Как мне скомпилировать простой пример мигания светодиодом на порту PC13 для микроконтроллера STM32F103C8T6 (плата BluePill) под операционной системой Ubuntu?

1. Установка RT-Thread Env

Вам нужно скачать и распаковать пакет Env для вашей операционной системы.

Для Windows: скачайте последнюю версию env-windows-v2.0.0.7z (или более новую) со страницы RT-Thread/env-windows Releases и распакуйте архив в папку без пробелов и китайских символов (например, C:\env-windows).

Для Linux (Ubuntu): выполните в терминале следующие команды для установки.

Скачайте скрипт установки (для Китая используйте зеркало Gitee, для остальных — GitHub):

wget https://raw.githubusercontent.com/RT-Thread/env/master/install_ubuntu.sh

$ wget https://raw.githubusercontent.com/RT-Thread/env/master/install_ubuntu.sh
--2026-09-11 10:14:30--  https://raw.githubusercontent.com/RT-Thread/env/master/install_ubuntu.sh
Resolving raw.githubusercontent.com (raw.githubusercontent.com)... 185.199.111.133,
 185.199.110.133, 185.199.108.133, ...
Connecting to raw.githubusercontent.com (raw.githubusercontent.com)|185.199.111.133|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 815 [text/plain]
Saving to: ‘install_ubuntu.sh’

install_ubuntu.sh   100%[===================>]     815  --.-KB/s    in 0s

2026-09-11 10:14:31 (34,4 MB/s) - ‘install_ubuntu.sh’ saved [815/815]

Сделайте скрипт исполняемым и запустите его (для скрипта понадобятся права sudo):

chmod 777 install_ubuntu.sh
./install_ubuntu.sh

После завершения установки удалите скрипт:

rm install_ubuntu.sh

2. Запуск Env и выполнение команды

Важное замечание: команды pkgs, scons и другие работают только внутри Env-консоли, а не в обычном терминале cmd или bash.

В Windows: Зайдите в папку, куда распаковали Env (например, C:\env-windows), и запустите файл env.exe (или env.bat). Откроется новое окно терминала. Перейдите в нем в папку вашего BSP (rt-thread\bsp\stm32\stm32f103-blue-pill) и выполняйте команды там .

В Linux: После установки выполните в обычном терминале следующие команды, чтобы активировать окружение Env. После этого команды pkgs и scons будут доступны в этой сессии:

chmod +x ~/.env/env.sh
source ~/.env/env.sh

Проверьте работу Env: введите pkgs --version или просто pkgs (без аргументов). Если вы увидите справочную информацию по использованию команды, значит все установлено правильно.

3. Скачайте зависимости

Перейдите в папку вашего BSP (для платы BluePill это папка rt-thread/bsp/stm32/stm32f103-blue-pill) и выполните команду:

pkgs --update

4. Соберите проект: после успешного скачивания пакетов вы можете использовать команду scons для сборки (если хотите использовать GCC) или открыть проект project.uvprojx в Keil MDK.

(.venv) $ scons

После компиляции в текущем каталоге rt-thread/bsp/stm32/stm32f103-blue-pill появятся результаты компиляции:

rtthread.bin
rt-thread.elf
rt-thread.hex
rt-thread.map

[Прошивка BluePill]

Подключите вашу платку BluePill к отладчику ST-Link V2 через интерфейс SWD, для этого понадобится 4 провода:

+3.3V
SWCLK
SWDIO
GND

Запустите прошивку:

st-flash write rtthread.bin 0x8000000

После прошивки нажмите на кнопку RESET платки BluePill, зеленый светодиод начнет мигать.

[Как конфигурируется проект RT-Thread]

На примере проекта rt-thread/bsp/stm32/stm32f103-blue-pill:

1. Перейдите в папку проекта командой cd:

cd ~/rt-thread/bsp/stm32/stm32f103-blue-pill

2. Запустите окружение для scons:

source ~/.env/env.sh

3. Запустите конфигуратор проекта:

scons --menuconfig

[Ссылки]

1. RT-Thread.
2. RT-Thread RTOS.
3. bluepill-stm32-freertos: запуск на Code::Blocks в Linux.
4. STM32: программирование в Linux.