下载文档原格式
本片文档分为两部分：第一部分是实现UART 控制台，该部分只需要实现两个数即可完成UART 控制台打印功能。
第二部分是实现移植FinSH 组件，实现在控制台输入命令调试系统，该部分实现基于第一部分，只需要添加FinSH 组件源码并再对接一个系统函数即可实现。
下面将对这两部分进行说明。
在 Nano 上添加 UART 控制台在RT-Thread Nano 上添加UART 控制台打印功能后，就可以在代码中使用RT-Thread 提供的打印函数rt_kprintf() 进行信息打印，从而获取自定义的打印信息，方便定位代码bug 或者获取系统当前运行状态等。
实现控制台打印（需要确认rtconfig.h 中已使及对接一个系统输出字符的函数，本小节将详细说明。
实现串口初始化使用串口对接控制台的打印，首先需要初始化串口，如引脚、波特率等。
uart_init() 需要在 board.c 中2static int uart_init(void);示例代码：如下是基于 HAL 库的STM32F103 串口驱动，完成添加控制台的示例代码，仅做参考。
1static UART_HandleTypeDef UartHandle;2static int uart_init(void)3{4 /* 初始化串口参数，如波特率、停止位等等 */5 UartHandle.Instance = USART1;6 UartHandle.Init.BaudRate = 115200;7 UartHandle.Init.HwFlowCtl = UART_HWCONTROL_NONE;8 UartHandle.Init.Mode = UART_MODE_TX_RX;9 UartHandle.Init.OverSampling = UART_OVERSAMPLING_16;10 UartHandle.Init.WordLength = UART_WORDLENGTH_8B;11 UartHandle.Init.StopBits = UART_STOPBITS_1;12 UartHandle.Init.Parity = UART_PARITY_NONE;1314 /* 初始化串口引脚等 */15 if (HAL_UART_Init(&UartHandle) != HAL_OK)16 {17 while(1);18 }1920 return 0;21}22INIT_BOARD_EXPORT(uart_init);1/* board.c */2void rt_hw_board_init(void)3{4 ....5 uart_init(); // 在 rt_hw_board_init 函数中调用串口初始化函数6 ....7}实现 rt_hw_console_output实现 finsh 组件输出一个字符，即在该函数中实现 uart 输出字符：1/* 实现 2：输出一个字符，系统函数，函数名不可更改*/2void rt_hw_console_output(const char *str);示例代码：如下是基于STM32F103 HAL 串口驱动对接的rt_hw_console_output() 函数，实现控制台字符输出，示例仅做参考。
使用RT-Thread 1.0.2 （或者打开任何一个RTThread工程）部分引自Prife的《RT_Thread的测试框架使用及分析》，仔细阅读后作了修订。
/prife/article/details/74870381.Finsh组件配置在例程源代码中，系统配置已经完毕，首先是修改了rtconfig.h 文件，将使用Finsh组件的宏打开其次将Finsh 组件的源文件加入到工程中编译2.连接串口下载程序后，连接好串口1，打开SecureCRT.exe，设置波特率115200，后连接。
开发板上电后，显示：输入list()后回车，list()命令的作用就是将系统中支持的所有shell命令都打印出来，也可以按TAB键。
有点类似与其他系统中的help命令。
有了这些命令和描述信息，我们就可以深入内核，查看它们的信息。
当前系统中运行的线程信息。
敲入list_thread()，回车。
当前系统实际运行时所有线程信息。
当前系统中运行着10个线程。
线程的名称，优先级，运行状态，堆栈地址，堆栈大小，最大使用堆栈，剩余运行tick 时间，错误信息都一览无遗，呵呵，是不是很方便。
其实，Finsh 的更强大功能还等着你挖掘呢.4.一个最简单的测试用例（不使用TestCase 框架）在application.c中的最后添加如下代码int testfunc(void){rt_kprintf("hello, rt-thread!\n");return 0;}#include <finsh.h>FINSH_FUNCTION_EXPORT(testfunc, just a test function);重新编译工程，启动串口工具输入命令list() 或者按Tab键多出一行。
接下来，在finsh上输入t 然后按下Tab键，finsh会自动地为我们补全testfunc，然后我们手动输入()后回车，可以看到如下运行效果：finsh />testfunc()hello, rt-thread!0, 0x00000000finsh />注：finsh跟linux下的shell很像，都具有tab键自动补全的功能，但是又有些不同，finsh的命令是C语言风格的，命令即函数调用语句。
rtthread多线程写法一、引言RT-Thread是一种广泛使用的实时操作系统，它支持多线程编程，使得开发者能够充分利用多核处理器的能力，提高系统的性能和稳定性。
本文将介绍RT-Thread多线程的编写方法，包括线程的创建、同步、通信等关键技术。
二、线程创建RT-Thread支持多种线程创建方式，包括手动创建、自动创建和共享内存创建。
手动创建适用于简单的应用场景，自动创建适用于复杂的应用场景，而共享内存创建适用于需要跨进程或跨线程通信的情况。
在创建线程时，需要指定线程的优先级、堆栈大小等参数，并为其分配必要的资源。
三、线程同步多线程编程中，线程同步是至关重要的一环。
RT-Thread提供了多种同步机制，包括互斥锁、信号量、条件变量等。
互斥锁用于保护共享资源的访问，避免出现竞态条件；信号量用于控制线程的执行流程，实现线程间的通信；条件变量用于实现线程间的异步通信，提高系统的响应速度。
在使用这些同步机制时，需要注意避免死锁、饥饿等问题。
四、线程通信线程通信是多线程编程中的另一个重要问题。
RT-Thread提供了消息队列、事件通知等机制来实现线程间的通信。
消息队列用于在多个线程之间传递数据，事件通知用于在特定条件下触发某个线程的行为。
在实现线程通信时，需要考虑到通信的效率、可靠性和安全性，避免出现数据丢失、重复接收等问题。
五、代码示例下面是一个简单的RT-Thread多线程示例代码：```c++#include <rtthread.h>// 定义互斥锁rt_mutex_t mutex;// 定义信号量，初始值为1，表示只有一个线程可以执行以下代码块rt_sem_t sem;void thread_func(void* arg){// 锁定互斥锁rt_mutex_lock(&mutex);// 释放信号量，表示有线程进入了等待队列rt_sem_release(&sem);// 执行需要同步的代码块rt_sem_take(&sem, RT_WAITING_FOREVER);// 解锁互斥锁rt_mutex_unlock(&mutex);}int main(){// 创建线程1，参数为线程函数和传递的参数rt_thread_t tid1 = rt_thread_create("tid1", thread_func, NULL, 2048, 5, 3);if (tid1 == RT_NULL) {rt_kprintf("Failed to create thread1\n");return -1;}// 创建线程2，参数为线程函数和传递的参数rt_thread_t tid2 = rt_thread_create("tid2", thread_func, NULL, 2048, 5, 3);if (tid2 == RT_NULL) {rt_kprintf("Failed to create thread2\n");return -1;}// 启动线程1和线程2rt_thread_startup(tid1);rt_thread_startup(tid2);// 等待所有线程退出完成rt_thread_join(tid1);rt_thread_join(tid2);// 销毁线程资源并释放内存空间rt_thread_delete(tid1);rt_thread_delete(tid2);return 0;}```这个示例代码创建了两个线程，并使用互斥锁和信号量实现了简单的同步和通信。
干货扒一扒RT-Thread内核对象管理器设计思路RT-Tread内核架构RT-Thread，全称是 Real Time-Thread，顾名思义，它是一个嵌入式实时多线程操作系统，基本属性之一是支持多任务，允许多个任务同时运行并不意味着处理器在同一时刻真地执行了多个任务。
其内核架构如下图所示：RT-Thread 内核及底层结构对于各部分的功能，这里不做展开描述。
RT-Tread内核吸引我的方面：•代码优雅、可读性非常高•体积小巧、代码类Linux风格，可裁剪•社区活跃，国人自主开发，用户越来越多•优秀的设计，对于面向对象设计思想可以说是非常优秀的实践•主要定位于物联网应用，各种组件丰富，融合的也很好•........所以如果是RTOS应用或者开发从业者，面对这么优秀且比较容易深入学习的内核，如果不去好好读读，实在有点可惜。
要去体会RT-Thread对象设计思想，从其对内核对象object的管理入手，不失为一个非常好的切入点。
什么是RT-Thread内核对象管理？RT-Thread 采用内核对象管理系统来访问/ 管理所有内核对象，内核对象包含了内核中绝大部分设施，这些内核对象既可以是静态分配的静态对象，也可以是从系统内存堆中分配的动态对象。
通过这种内核对象的设计方式，RT-Thread 做到了不依赖于具体的内存分配方式，系统的灵活性得到极大的提高。
RT-Thread 内核对象包括：线程，信号量，互斥量，事件，邮箱，消息队列和定时器，内存池，设备驱动等。
对象容器中包含了每类内核对象的信息，包括对象类型，大小等。
对象容器给每类内核对象分配了一个链表，所有的内核对象都被链接到该链表上，如图RT-Thread 的内核对象容器及链表如下图所示：RT-Thread 的内核对象容器及链表参考自：/document/site/programming-manual/basic/basic/#_7这个集中管理的内核对象容器在内存的开销方面代价很小，但却具有高度的灵活性，从设计的角度看其代码也非常利于扩展，增加新的内核对象类别，以及对于相应的内核对象功能的裁剪适配。
十余年历史的国产RTOS，从RT现在是一个快节奏的时代，技术领域也是如此。
近些年，IoT备受资本青睐，各种新技术新方案层出不穷，质量也参差不齐，这边唱罢那边登台，以至于有些技术还未被人熟知，就被淹没在长河中了。
客观的说，RTOS领域玩家众多，仅笔者短短的从业时间，国产RTOS就听闻了五、六款之多。
RT-Thread作为一个有十余年历史的国产RTOS，经历了长时间的考验和用户的青睐，目前发展趋势蒸蒸日上，也即将发布RT-Thread 3.0，其中必然有值得我们思考和学习的地方，我们也可以从中汲取到不少宝贵的经验。
软件工程管理 软件工程管理对于软件研发是十分重要的，甚至可以说是开发过程的基石。
公司中有高水平的嵌入式软件程序员，也有刚入职的实习生，水平难免参差不齐，当共同协作开发一个项目时，如何彼此协调也是一个难题。
时至今日，很多公司仍然在使用落后的代码管理方式。
有些甚至使用把代码压缩成一个个的压缩包来做版本管理。
同事之间的协作依靠互相发送文件，每次接收到同事的新文件首先要花半天时间解决编译error，甚至还要在本地对同事的代码进行修改，这样，软件基本处在半失控的状态，某次改动产生问题，就要从浩瀚的压缩包海洋里挑选一个，进行版本回退。
在开发一个大项目的时候，这种情况下甚至会出现人数越多，开发难度和周期越大的情况。
而RT-Thread，提供了一个教科书级的范例。
RT-Thread由13000多个文件构成，支持各类设备和芯片近70款，从代码量和组织方式上来说，是一个相当庞大的软件工程。
在近十年的时间里，至少有将近100个开发者参与到了RT-Thread的开发中，使得RT-Thread稳步迭代，而这也是有一定的维护难。
FLASH分区管理是怎么一回事呢？我们可以以个人电脑来做类比，我们的电脑通常都分有很多个盘符：这些都是我们硬盘的分区，我这里装了两块硬盘，512GB的机械硬盘+128GB的固态硬盘，共分C~H六个分区，我这里的C盘和H盘是固态硬盘，其它盘符是机械硬盘：分区是为了方便我们对我们的资料进行管理，各个分区互不影响，比如格式化某个分区只会删除这个分区的内容而不会影响其它分区及整个硬盘等。
同样的，在我们的STM32上也是可以进行分区管理的，这篇笔记我们来使用RT-Thread的FAL软件包来对我STM32片内FLASH及片外FLASH的分区管理。
FAL软件包介绍FAL (Flash Abstraction Layer) Flash 抽象层，是 RT-Thread 的一个软件包，是对 Flash 及基于 Flash的分区进行管理、操作的抽象层，对上层统一了 Flash 及分区操作的 API ，并具有以下特性：• 支持静态可配置的分区表，并可关联多个 Flash 设备；• 分区表支持自动装载。
避免在多固件项目，分区表被多次定义的问题；• 代码精简，对操作系统无依赖，可运行于裸机平台，比如对资源有一定要求的 bootloader；• 统一的操作接口。
保证了文件系统、 OTA、 NVM 等对 Flash 有一定依赖的组件，底层 Flash 驱动的可重用性；• 自带基于 Finsh/MSH 的测试命令，可以通过 Shell 按字节寻址的方式操作（读写擦） Flash 或分区，方便开发者进行调试、测试；FAL软件包使用本笔记主要对潘多拉开发板的FAL例程进行一次梳理，所以部分表述来自于教程文档。
我们这个实验建立如下分区表：1、移植接口文件说明FAL软件包的目录如下，其中samples文件夹下为移植接口文件：其中fal_cfg.h 为fal 配置文件（Flash 设备配置和分区表配置）：fal 是 Flash 抽象层，要操作 Flash 设备必然要将 Flash 的读、写、擦接口对接到 fal 抽象层中。
一、什么是rt-thread事件集？rt-thread是一个开源的嵌入式实时操作系统，具有高度灵活性和可扩展性。
事件集是rt-thread提供的一种事件管理机制，用于实现任务之间的同步和通信。
二、事件集的创建和初始化1. 创建事件集在rt-thread中创建事件集非常简单，只需调用相应的API即可。
示例代码如下：```c/* 定义事件集变量 */static rt_event_t ev;/* 在m本人n函数中创建事件集 */int m本人n(){/* 创建事件集 */rt_event_init(ev, "event", RT_IPC_FLAG_FIFO);/* 其他代码 */}```2. 初始化事件集rt-thread的事件集初始化函数为rt_event_init，其原型为：```crt_err_t rt_event_init(rt_event_t event, const char *name,rt_uint8_t flags);```其中，event为事件集指针，name为事件集的名称，flags为事件集的标志位。
三、事件集的使用方法1. 设置事件标志位使用rt_event_send函数可以设置事件集的指定标志位，示例代码如下：```crt_uint32_t set = 0x01; // 要设置的标志位rt_event_send(ev, set);```2. 清除事件标志位使用rt_event_recv函数可以清除事件集的指定标志位，示例代码如下：```crt_uint32_t clear = 0x01; // 要清除的标志位rt_event_recv(ev, clear, RT_EVENT_AND_CLEAR, set, RT_W本人TING_FOREVER);```3. 等待事件集标志位使用rt_event_recv函数可以等待事件集的指定标志位，示例代码如下：```crt_uint32_t w本人t = 0x01; // 要等待的标志位rt_event_recv(ev, w本人t, RT_EVENT_AND, set, RT_W本人TING_FOREVER);```四、事件集的优势和适用场景事件集是一种轻量级的事件管理机制，具有以下优势：- 灵活性高：可以灵活地设置、清除和等待事件标志位，便于实现复杂的任务同步和通信。
一、RT-Thread SDK的概述RT-Thread是一个实时操作系统，具有精简、高效的特点，能够在资源有限的嵌入式系统中运行。
RT-Thread SDK是基于RT-Thread实时操作系统的开发套件，提供了丰富的示例代码、文档和工具，帮助开发者快速搭建和开发嵌入式系统。
二、RT-Thread SDK的特点1. 开源免费：RT-Thread SDK完全开源，同时免费提供给开发者使用和修改。
2. 轻量级：RT-Thread SDK采用模块化设计，能够根据具体需求选择合适的模块，减小系统的占用空间。
3. 易用性：RT-Thread SDK提供了丰富的示例代码和文档，帮助开发者快速上手，快速搭建和开发嵌入式系统。
三、RT-Thread SDK的组成部分RT-Thread SDK包含了以下重要的组成部分：1. RT-Thread内核：RT-Thread是一个轻量级的实时操作系统内核，提供了丰富的系统服务和功能模块，包括任务调度、内存管理、设备驱动、网络通信等。
2. 驱动程序：RT-Thread SDK提供了多种设备驱动程序，包括串行通信、网络、存储设备等，方便开发者在嵌入式系统中使用各种外设。
3. 中间件：RT-Thread SDK还包含了多种中间件，例如文件系统、GUI图形界面库、网络协议栈等，帮助开发者快速实现各种功能。
4. 示例代码：RT-Thread SDK提供了丰富的示例代码，覆盖了各种常见的应用场景，方便开发者参考和使用。
四、RT-Thread SDK的应用领域RT-Thread SDK适用于各种嵌入式系统的开发，包括但不限于以下领域：1. 工业控制：RT-Thread SDK提供了丰富的通信协议栈和设备驱动程序，能够满足工业控制系统的需求。
2. 智能家居：RT-Thread SDK提供了GUI图形界面库和网络通信功能，能够快速实现智能家居设备的控制和监控。
3. 汽车电子：RT-Thread SDK支持多种外设和通信协议，能够应用于汽车电子系统的开发。
