嵌入式IDE-PlatformIO + STM32CubeMX +RT-thread RTOS 操作系统

最新推荐文章于 2024-06-28 22:08:02 发布
最新推荐文章于 2024-06-28 22:08:02 发布
阅读量7.2k 收藏 80
点赞数 23
分类专栏： 嵌入式 STM32 前端 文章标签： 嵌入式 stm32 ide rtos
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/jiladahe1997/article/details/108371747
版权
嵌入式 同时被 3 个专栏收录
16 篇文章 19 订阅
订阅专栏
STM32
10 篇文章 4 订阅
订阅专栏
前端
3 篇文章 0 订阅
订阅专栏

简介

PlatformIO是下一代的嵌入式IDE，关于其基本介绍，欢迎查看我的上一篇文章：使用下一代的嵌入式IDE-PlatformIO 教程

STM32CubeMX是ST官方的代码生成工具，作为一个从前端转嵌入式的程序员，对各种寄存器配置真的是感到无语。比如开启串口1，明明一个函数能完成的事，非要让你去写几十行代码，配置RCC、配置GPIO、配置USART三种加起来数十个寄存器，而且每种寄存器的配置内容、配置顺序还隐藏的很深，官方文档也是一笔带过。
这实在是不符合软件工程的解耦思想。STM32CubeMX则可以让你点点点就能完成上述的工作。

这篇博客将要介绍的是结合使用PlatformIO和STM32CubeMX。



预先需要了解的知识

  • PlatformIO IDE的安装及基本使用
  • STM32CubeMX 的安装及基本使用
  • STM32系列MCU的基本编程方法
  • arm-none-eabi-gcc编译器的概念，gcc编译器的常用参数
  • makefile的基本概念
  • scons构建系统的基本概念
  • python的基础语法


整体架构图

在这里插入图片描述解释：使用STM32CubeMX和PlatformIO生成同一个工程。之后的scons构建工具、gcc编译器、jlink、GDB等工具都是已经集成到了PlatformIO中了。
生成了工程之后，需要配置一下scons构建工具的配置文件，然后点击编译调试，platfromIO会自动的帮我们完成之后的工作：调用scons、调用gcc、调用jlink、启动GDB server等。




一.生成工程

1.1 打开STM32CubeMX：

  • 选择你的MCU，这里我用的是STM32F103RC
  • RCC中开启外部HSE时钟，外部时钟比HSI更稳定些
  • 开启DEBUG 4线
  • 打开串口1用于打印调试信息，波特率115200，校验位0，停止位1
  • 切换到Project Manage选项，Code Generator中选择Copy only the necessary library files
  • 切换到Project, Toolchain/IDE选择makefile
  • 最后点击生成工程。

1.2 生成PlatformIO工程：

打开vscode，会自动弹出PlatformIO的主页。点击New Project，生成一个项目，弹出项目基本信息填写框。

这里的基本信息需要注意，Name项目名称需要和CubeMX中的一样，Board芯片也必须选择正确，Location项目目录需要和CubeMX中的一样。这样生成的工程和STM32CubeMX可以无缝结合。

作者注：还有另外一个骚气一点的办法。由于PlatformIO是根据项目中有没有platformio.ini文件来判断是否是PlatformIO项目的。同时这个文件又十分的简单，只有几行代码。所以另外一种办法是手动在CubeMX生成的工程中加上platformio.ini文件即可。

在这里插入图片描述





二：修改PlatformIO配置文件

在上面生成PlatformIO项目时，细心的读者已经发现了有一个Framework选项我没有提到。

其实原因是这样：STM32CubeMX的原理是，解析你在GUI界面上选择的外设，生成使用HAL库的代码，并同时将HAL库添加到工程中；而PlatformIO的原理是，不生成任何代码，但自动下载HAL库，并放在C:/.platformio目录下去，并在编译时自动使用C:/platformio下的HAL库。

这样你会发现，两者使用的HAL库其实不是同一个，两者的细微差异会导致编译失败。而由于我们实际使用的是CubeMX生成的代码，所以我们需要使用是 CubeMX的HAL库。

综上所述，需要修改platformIO的配置文件：platfomio.ini如下（每一行代码的作用见注释）：

[platformio]
src_dir = ./

[env:genericSTM32F103RC]
platform = ststm32
board = genericSTM32F103RC
/* 注释掉下面framework这一行（ini文件中分号表示注释）*/
/* 表示不使用plateformIO的HAL库 */
;framework = stm32cube 
/* 表示使用项目目录下的HAL库以及RT-threa */
build_flags =         
  -D STM32F103xE
  -IInc
  -IDrivers/CMSIS/Include
  -IDrivers/CMSIS/Device/ST/STM32F1xx/Include
  -IDrivers/STM32F1xx_HAL_Driver/Inc
  -IDrivers/STM32F1xx_HAL_Driver/Inc/Legacye/

/* 表示使用项目目录下的HAL库以及RT-thread */
src_filter = +<src/> +<startup_stm32f103xe.s> +<Drivers/> +<Middlewares/> 
/* 表示使用项目目录下的链接文件 */
board_build.ldscript = ./STM32F103RCTx_FLASH.ld
debug_tool = jlink

此时你应该可以正常进行编译和调试了。

在这里插入图片描述


三.再多一点，接入rt-thread RTOS操作系统

今天（20200903）公司聚餐，也算是为几位即将离职的同事送行。 以前在美团，对离职都比较避讳；现在到了小公司，周围的同事对离职反而看的很开。有四位将要离职的同事，一位是和我关系很不错的实习生，哎，我也想再回到学校体验无忧无虑的生活；一位是刚入职3周的新同事，有更好的机会，领导也放人并且祝福他；一位是华为过来的同事，他走了之后，我就是唯一一个来自大公司的了；最后一位则是我的直属领导，虽然技术能力并没有出神入化，但是有很强的技术精神，我比较敬佩。回家路上我又想了很多，我19年本科毕业就进入了美团，没有进入到最理想的BAT一线公司。在美团干了1年前端之后，发现自己其实对前端不感兴趣；来到小公司干了嵌入式之后，虽然对嵌入式比较感兴趣，但是薪资比同龄人低了一大截。 哎，人生到底追求的是什么，赢得什么才算胜利呢？

废话少说，言归正传。下面记录一下怎么再PlatformIO+STM32CubeMX的基础上再加上RT-Thread。

一般而言，对于真正的嵌入式应用，RTOS是不可或缺的一环，需要把这一环打通，才能把PlatformIO投入真正的使用。

在上述第一步、第二步的项目的基础上，我们进行进一步的修改：

3.1 增加RT-thread的源文件，请参考官方链接：基于 CubeMX 移植 RT-Thread Nano：

  • 使用CubeMX打开第二步中的项目，参考上述链接，添加rt-thread软件包。
  • 参考上述链接，在最左侧Additional Software处勾选软件包
  • 参考上述链接，System Core - NVIC - Code generation选项，取消勾选Time base: System tick timer、Pendable request for system service 、Hard fault interrupt三个中断的生成
  • 在Connectivity中开启串口1用于rtthread shell交互。
  • 在System Core - NVIC - NVIC中Enable串口1中断
  • 在System Core - NVIC - Code generation取消勾选串口1中断的Call HAL handle，我们需要自己处理串口中断。
  • 切换到 Project Manager页面，勾选 Do not generate the main()，我们需要自己写main函数。
  • 再切换到 Project Manager页面下的 Advanced Settings，会看到有三个函数MX_GPIO_INIT、SystemClock_Config、MX_USART1_UART_init，均勾选上Not Generate Function Call ，我们需要手动调用外设初始化。
  • 还是在上述页面，均 取消勾选 Visibility(Static)，我们需要手动调用外设初始化，所以函数不能是Static静态函数。
  • 最后点击生成工程

3.2 将rt-thread源文件添加到编译链

这一步很简单，只需要在platformio.ini文件中加入即可：

  • 在build_flag中加入相关头文件：
build_flags = 
  -D STM32F103xE
  -IInc
  -IDrivers/CMSIS/Include
  -IDrivers/CMSIS/Device/ST/STM32F1xx/Include
  -IDrivers/STM32F1xx_HAL_Driver/Inc
  -IDrivers/STM32F1xx_HAL_Driver/Inc/Legacy
  /* 增加下面两行 */
  -IMiddlewares/Third_Party/RealThread_RTOS_RT-Thread/components/finsh/
  -IMiddlewares/Third_Party/RealThread_RTOS_RT-Thread/include/
  • 在 src_filter 中加入Middlewares文件夹：
src_filter = +<src/> +<startup_stm32f103xe.s> +<Drivers/> +<Middlewares/>

3.3 移植rtthread：

这一步其实和PlatformIO没多大关系了，主要是rtthread的移植工作，所以我将其放在附录，有兴趣的请移步附录A。




四.做技术就是要贪心，再接入Modbus协议栈

TODO，这部分就不详细说明了，如果你有需要欢迎在下面留言，我会根据情况更新的。
这部分只需要在第三步的基础上，在编译链中加上Modbus的相关文件，然后移植Modbus协议栈即可，请参考我的这篇文章：STM32 MODBUS协议-简介及接入 FreeMODBUS。

参考CubeMX_script.py：

Import("env")
import os

env.Prepend(CCFLAGS=[
  "-IFreeModbus/port",
  "-IFreeModbus/modbus/include",
  "-IFreeModbus/modbus/rtu"
])
modbusfiles = [
  os.path.join("$BUILD_SRC_DIR",  "./FreeModbus/modbus/mb_m.c"),
  os.path.join("$BUILD_SRC_DIR",  "./FreeModbus/modbus/rtu/mbcrc.c"),
  os.path.join("$BUILD_SRC_DIR",  "./FreeModbus/modbus/rtu/mbrtu_m.c"),
  os.path.join("$BUILD_SRC_DIR",  "./FreeModbus/modbus/functions/mbfuncother.c"),
  os.path.join("$BUILD_SRC_DIR",  "./FreeModbus/modbus/functions/mbfuncinput_m.c"),
  os.path.join("$BUILD_SRC_DIR",  "./FreeModbus/modbus/functions/mbutils.c"),
  os.path.join("$BUILD_SRC_DIR",  "./FreeModbus/port/rtt/port.c"),
  os.path.join("$BUILD_SRC_DIR",  "./FreeModbus/port/rtt/portevent_m.c"),
  os.path.join("$BUILD_SRC_DIR",  "./FreeModbus/port/rtt/portserial_m.c"),
  os.path.join("$BUILD_SRC_DIR",  "./FreeModbus/port/rtt/porttimer_m.c"),
]
env.Append(PIOBUILDFILES= modbusfiles)






附录A： 移植RT-thread

1.Middlewares\Third_Party\RealThread_RTOS_RT-Thread\bsp\board.c中
修改rt_hw_board_init函数：增加初始化外设部分代码

#include "main.h"
extern void SystemClock_Config(void);
extern void MX_GPIO_Init(void);
extern void MX_USART1_UART_Init(void);
extern UART_HandleTypeDef huart1;
/* 调试串口1接收数据的消息队列buffer */
static uint8_t consoleInputBuffer[256];
struct rt_messagequeue consoleInputMQ;
void rt_hw_board_init()
{
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_USART1_UART_Init();
   
    /* 使用串口1作为调试串口，初始化一个消息队列保存串口1接收到的数据，并手动开启串口中断 */
    rt_err_t error = rt_mq_init(&consoleInputMQ,"consoleInputMQ",consoleInputBuffer,
                                1,sizeof(consoleInputBuffer),RT_IPC_FLAG_FIFO);
    RT_ASSERT(error == RT_EOK);
    SET_BIT(huart1.Instance->CR1, USART_CR1_PEIE | USART_CR1_RXNEIE);

    /* System Clock Update */
    SystemCoreClockUpdate();
    
    /* System Tick Configuration */
    _SysTick_Config(SystemCoreClock / RT_TICK_PER_SECOND);

    /* Call components board initial (use INIT_BOARD_EXPORT()) */
#ifdef RT_USING_COMPONENTS_INIT
    rt_components_board_init();
#endif

#if defined(RT_USING_USER_MAIN) && defined(RT_USING_HEAP)
    rt_system_heap_init(rt_heap_begin_get(), rt_heap_end_get());
#endif
}

增加一个函数用于输出调试信息：

void rt_hw_console_output(const char *str)
{
    rt_size_t i = 0, size = 0;
    char a = '\r';

    __HAL_UNLOCK(&huart1);

    size = rt_strlen(str);
    for (i = 0; i < size; i++)
    {
        if (*(str + i) == '\n')
        {
            HAL_UART_Transmit(&huart1, (uint8_t *)&a, 1, 50);
        }
        HAL_UART_Transmit(&huart1, (uint8_t *)(str + i), 1, 50);
    }
}

2.Src\stm32f1xx_it.c中：
修改串口1中断函数：

#include "rtthread.h"
extern struct rt_messagequeue consoleInputMQ;
void USART1_IRQHandler(void)
{
  /* USER CODE BEGIN USART1_IRQn 0 */
  if(huart1.Instance->SR & USART_SR_RXNE)
  {
    uint8_t data =  (uint8_t)(huart1.Instance->DR & (uint8_t)0x00FF);
    rt_mq_send(&consoleInputMQ, &data, 1);
  }
  /* USER CODE END USART1_IRQn 0 */
  /* USER CODE BEGIN USART1_IRQn 1 */
  /* USER CODE END USART1_IRQn 1 */
}

3.Inc\rtconfig.h中：修改注释，开启FINSH控制台和消息队列。

/*注释掉 __CC_ARM,强制开启FINSH控制台*/
//#if defined(__CC_ARM) || defined(__CLANG_ARM)
#include "RTE_Components.h"
#if defined(RTE_USING_FINSH)
#define RT_USING_FINSH
#endif  //RTE_USING_FINSH
//#endif  //(__CC_ARM) || (__CLANG_ARM)

...

/* 开启消息队列 */
// <c1>Using Message Queue
//  <i>Using Message Queue
#define RT_USING_MESSAGEQUEUE

4.增加main.c中的main函数：

#include "rtthread.h"
int main(void) {
  rt_kprintf("Hello RT-thread! \r\n");
  while(1) {
  }
}

5.修改startup_stm32f103xe.s启动文件

  99行 bl main

修改为

  bl entry

参考：此链接第99行。 这一行的意思是，初始化静态变量完成之后的跳转位置，默认是main，需要修改成rtthread中components.c 中的 157 行 entry 函数。

6.修改链接脚本，在.text段中增加如下代码:意思是保留 rti_fn段的代码，这是rtthread中的要求的。rtthread中的INIT_BOARD_INIT的原理其实就是把函数声明成rti_fn段，然后启动的时候再去寻找rti_fn段代码执行。
参考：此链接

.text{
	...
	...
	...
    /* section information for finsh shell */
    . = ALIGN(4);
    __fsymtab_start = .;
    KEEP(*(FSymTab))
    __fsymtab_end = .;

    . = ALIGN(4);
    __vsymtab_start = .;
    KEEP(*(VSymTab))
    __vsymtab_end = .;

    /* section information for initial. */
    . = ALIGN(4);
    __rt_init_start = .;
    KEEP(*(SORT(.rti_fn*)))
    __rt_init_end = .;
    ...
    ...
    ...
}

7.修改链接link参数，增加一个链接参数：
参考：此链接
首先在platformio.ini中增加一个脚本

extra_scripts = pre:CubeMX_script.py

然后写这个脚本的代码：CubeMX_script.py

Import("env")

env.Prepend(LINKFLAGS=[
  "--specs=nosys.specs"
])



附录B：

前两步的工程代码：
https://github.com/jiladahe1997/CSDN_PlatformIO_CubeMX_demo

jiladahe1997
关注
  • 23
    点赞
  • 踩
  • 80
    收藏
    觉得还不错? 一键收藏
  • 12
    评论
专栏目录
第一章 ESP32 PlatformIO IED开发环境搭建
yang140698的博客
08-14 6605
第一章 ESP32 PlatformIo IED开发环境搭建 1、PlatformIO IDE介绍
stm32f103标准库+rt-thread 3.1.3+finsh
11-02
STM32F103是意法半导体...总的来说，这个项目涵盖了嵌入式系统开发的多个关键环节，包括硬件驱动、实时操作系统、命令行交互和中断处理，对于想要深入学习STM32和RTOS的开发者来说，是一个非常有价值的实践案例。
RT-Thread 学习入门（一） ：ESP32在RT-Thread Studio中的工程创建
weixin_37883167的博客
01-31 1639
RT-Thread Studio 主要包括工程创建和管理，代码编辑，SDK管理，RT-Thread配置，构建配置，调试配置，程序下载和调试等功能，结合图形化配置系统以及软件包和组件资源，减少重复工作，提高开发效率。我是先在VScode上跑通，再移植到RT-Thread Studio上的。创建工程完成后，我们试着写一个基础的程序，让IO口翻转。本文章只为记录博主工程中遇到的问题，供大家学习使用，如有讲解不到的地方，欢迎大家批评指正。创建工程完成后，我们试着写一个基础的程序，让ESP32-S3的IO口翻转。
ESP32 PlatformIO IDE 安装教程
qq_62819897的博客
03-11 3611
ESP32 PlatformIO IDE 安装教程
PlatformIO开发环境
最新发布
嵌入式行业打工人，不定期更新博客。
06-28 719
5. **编译和上传** - 使用`platformio run`来编译你的项目，使用`platformio run --target upload`来上传到硬件设备。1. **安装PlatformIO IDE** - 如果你使用的是VSCode或Atom，你可以通过它们的插件市场来安装PlatformIO IDE插件。2. **安装PlatformIO Core** - 对于命令行用户，你需要通过Python包管理器pip来安装PlatformIO Core。
02-VS Code 和 PlatformIO IDE开发环境
dangerqsq的博客
02-20 3699
一、安装VS CodeArduino IDE 非常适合小型应用程序。但是，对于具有超过 200 行代码、多个文件和其他高级功能（如自动完成和错误检查）的高级项目，带有 PlatformIO IDE 扩展的 VS Code 是最佳选择，并且其可以有代码提示功能，这对于高效率编程非常有帮助。
VS Code中PlatformIO IDE的安装并开发Arduino
m0_73640344的博客
05-07 2739
【代码】VS Code中PlatformIO IDE的安装并开发Arduino。
VsCode - PlatformIO IDE汉化教程
Mtopu的博客
08-23 2083
VsCode - platformio IDE汉化教程，许多人使用 vscode的platformio插件估计看着一堆英文很是头疼，translate.js是一款开源的网站自动翻译api，使用极其简单。 无需任何前期准备，直接加入几行代码即可拥有多种语言全自动切换能力。
RT-Thread Stdio+CH32V307+0.96OLED
05-11
RT-Thread是一个开源的、实时操作系统（RTOS），而CH32V307是南京灵动微电子公司的一款基于STM32内核的微控制器，通常用于嵌入式应用。0.96英寸OLED显示屏常用于显示简单的文本或图形信息，适用于各种小型物联网设备...
基于Stm32C8T6的标准外设库Rtthread操作系统移植
04-21
通过这个项目，初学者可以深入理解嵌入式实时操作系统的工作原理，掌握STM32的开发技能，并能够将RtThread成功地应用到实际项目中。同时，对于课程设计而言，这样的实践有助于提高学生的动手能力和问题解决能力。
STM32F103 RT-Thread 工程
06-28
2. **RT-Thread移植**：将RT-Thread操作系统移植到STM32F103，配置系统时钟、内存布局、初始化堆栈等。 3. **创建任务**：定义并创建需要运行的任务，设置优先级和调度策略。 4. **外设驱动**：编写或利用HAL库开发...
STM32L496实现基于TF卡的文件系统【RT-Thread工程，支持STM32L4系列单片机】.zip
05-16
STM32L496是意法半导体（STMicroelectronics）推出...通过这个项目，开发者不仅可以掌握STM32L496的底层驱动开发，还能深入理解RT-Thread操作系统的文件系统实现和任务调度机制，为今后的嵌入式开发工作打下坚实基础。
树莓派5安装PlatformIO IDE
weixin_41589183的博客
01-02 1208
PlatformIO IDE是一个开源的物联网生态系统，其核心是一个功能齐备的跨平台IDE。它支持多种硬件平台，包括Arduino、ESP32、Raspberry Pi、STM32等，集成了库管理器、调试器、构建工具和上传工具等多种功能，大大降低了物联网开发的门槛。PlatformIO IDE提供了C/C++的代码智能提示，程序库管理，内置命令行等功能。此外，PlatformIO for Visual Studio Code提供了构建、部署、设备监视器、程序库搜索等主要功能。
使用PlatformIO IDE来让你的Arduino编译快上8倍
arenascat的博客
04-07 1万+
什么是PlatformIO 如何用上 操作很简单，首先你需要有一个Visual Studio，然后点击左侧扩展标识 搜索Platform IDE，并且进行安装 . 之后，会先进行初始化，在自动化安装一些必要的编译器等工具后，会提示重新启动VSCode 在重新启动VSCode完成后点击小房子这个标识 此时就可以出现PlatformIO的主页面了 点击建立新的工程，我选择了一个Arduino Nano 然后配置一下新建工程的目录以及名称 在第一次使用...
esp32 rt-thread
wangjun779的专栏
02-10 746
https://nu-ll.github.io/2020/07/06/ESP32%E4%B8%8A%E7%A7%BB%E6%A4%8DRt-thread/
RT-Thread OS支持ESP32的实现方式分析
tugouxp的专栏
02-23 6550
ESP32基于一款Xtensa指令集架构的核心，虽然这款IP核知道的人不多，但是提到音频领域鼎鼎大名的HIFI系列DSP，可能很多人不会陌生，事实上，HIFI系列和ESP32基于的LX6核心使用的是相同的指令集架构(ISA).ISA架构。xtensa架构的ISA定义比较晦涩，而且使用了比较难于理解的寄存器窗的概念，也就是在汇编指令用的EABI寄存器和微架构上实现的物理寄存器中间做了一层抽象，为了的是节省caller/callee 之间堆栈save/restore的花销，为了防止新的寄存器窗口覆盖老的，又设计
使用STM32CubeMX + Visual Studio Code + OpenOCD + PlatformIO搭建一个现代化且跨平台的STM32开发环境
qq_41757528的博客
11-07 3618
其实这套工具链（除开STM32CubeMX）不仅STM32能用，还能给8051，ESP32，Arduino等芯片使用，只要你所使用的烧录工具以及芯片本身被PlatformIO支持。在本文介绍的这套工具链中，Visual Studio Code为文本编辑器，gcc-arm-none-eabi为编译器，STM32CubeMX用于创建基础代码，而PlatformIO则将上述内容组合到一起，形成了一个强大的IDE。
如何在VScode+PlatformIO中使用STM32CubeIDE的工程？
palzhj的博客
03-11 1972
如何在VScode+PlatformIO中使用STM32CubeIDE的工程
Visual Studio Code PlatformIo IDE 新建项目下载慢的解决办法
热门推荐
每天进步一点就够了
05-14 2万+
假设你已经安装好了platformio插件 关闭vscode，打开任务管理器，把platformio.exe以及所有的Python.exe进程全部结束掉，一定要全部关掉（实在不行就重启电脑，重启电脑之后不要打开vscode） 配置pip镜像源为国内阿里云，打开platformio安装地址，C:\Users[你电脑的用户名].platformio夹 进入penv文件夹，打开pip.conf文件 改成如下内容： 返回上一级，删除.cache文件夹里所有文件 打开vscode，新建项目，
评论 12
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值