简介面向STM32F407嵌入式开发者的uCOSIII与LwIP整合应用代码包适用于需快速搭建RTOS网络通信TFTLCD显示的原型项目代码遵循模块化设计注释风格统一便于扩展与二次开发适合有单片机基础、希望将实时操作系统与TCP/IP协议栈落地到实际硬件的开发者。压缩包内含483个文件其中256个h头文件与192个c源文件构成主要工程逻辑12个s和10个asm汇编文件负责启动与底层调度另含ioc、uvprojx等工程配置及说明表格整体仅2.3MB结构紧凑目前已有298人学习下载。通过该工程可掌握uCOSIII多任务划分、优先级设置、中断处理与内存管理方法同时理解LwIP在STM32上的移植流程及TCP/UDP通信实现并借助TFTLCD驱动接口快速显示图形与文本。包内附带示例代码、文档与演示可直接编译运行省去从零搭建环境的繁琐过程。对需要兼顾实时性与网络功能的嵌入式项目而言这是一份既适合入门研读、也可作为产品开发基线的完整代码模板。1. 拿到 ExploreF407 的 uCOSIII 3.08 工程先拆开看这几个 .asm 在干什么从压缩包后缀就能看出这不是一个跑裸机 while(1) 的例程而是正点原子探索者 STM32F407 开发板上uCOSIII 3.08.00 与 LwIP、TFTLCD 三套代码合在一个工程里的移植包。第一次打开的人往往会对着os_cpu_a.asm、cpu_a.asm、lib_mem_a.asm、os_cpu_isr.asm这一串汇编文件发懵以为是不用动的启动代码。实际上这几个文件决定了任务切换是否可靠、临界区是否会被中断打破、FPU 寄存器会不会被任务间踩踏是整个 RTOS 移植里最不该跳过的地方。适合三类人准备从裸机转到 RTOS 的嵌入式开发、需要评估 uCOSIII 可裁剪性的产品工程师、以及正在抓 LwIP 下网络吞吐和任务栈问题的调试者。2. os_cpu_a.asm 移植点拆解PendSV 切换、FPU 入栈与 BASEPRI 临界区2.1 移植文件分工谁在管上下文谁在管原子操作uCOSIII 的汇编文件在 Cortex-M4 上各司其职理解它们的分工比背代码更有用。os_cpu_a.asm负责操作系统内核相关的上下文切换包括 OSStartHighRdy 和 PendSV_Handler这部分是任务调度的发动机cpu_a.asm是 CPU 移植层提供关中断和开中断的底层实现uCOSIII 的 OS_CRITICAL_METHOD 会直接调用到这里lib_mem_a.asm属于 uC/LIB 的汇编加速部分主要做内存拷贝、字符串操作的优化性能敏感但不影响调度逻辑os_cpu_isr.asm则封装了中断服务程序的入口与退出用于在中断里完成任务切换。文件归属模块核心作用改动频率os_cpu_a.asmuC/OS-III任务级切换、PendSV 处理移植新内核时cpu_a.asmuC/CPU临界区开/关、原子操作基本不动lib_mem_a.asmuC/LIBmemcpy/memset 汇编优化基本不动os_cpu_isr.asmuC/OS-III中断进出栈、OSIntCtxSw中断嵌套配置时建议把cpu_a.asm和lib_mem_a.asm当作编译器配套的 libc 来看出了问题优先怀疑工程配置而不是这里面的逻辑。真正需要逐行对照的是os_cpu_a.asm里的 PendSV 处理因为任务切换的所有秘密都藏在这几十行汇编里。2.2 PendSV_Handler 的关键路径保存现场与恢复现场Cortex-M4 在进入异常时硬件会自动压栈 xPSR、PC、LR、R12、R3-R0而 R4-R11 必须由软件保存。uCOS 的 PendSV_Handler 的典型流程如下以工程内实际源码为参考PendSV_Handler CPSID I ; 屏蔽中断防止切换过程被打断 MRS R0, PSP ; 取当前任务栈指针 CBZ R0, PendSV_Handler_Nosave ; PSP 为 0 说明没有任务在运行 SUBS R0, R0, #0x20 ; 为 R4-R11 预留 8 个寄存器空间 STMIA R0!, {R4-R11} ; 把当前任务寄存器压入任务栈 ; 如果启用 FPUVSTMIA R0!, {S16-S31} LDR R1, OSTCBCurPtr LDR R1, [R1] STR R0, [R1] ; 将 SP 保存到当前任务 TCB PendSV_Handler_Nosave ; 切换 OSTCBCurPtr OSTCBHighRdyPtr LDR R0, OSTCBCurPtr LDR R2, OSTCBHighRdyPtr LDR R1, [R2] STR R1, [R0] LDR R3, [R1] ; 取出新任务栈顶 LDR R0, [R3] ; 从新任务栈中恢复 R4-R11并 PSP 赋给新栈顶第一行CPSID I用 PRIMASK 关掉所有可屏蔽中断保证寄存器保存和 TCB 指针更新是一个原子过程MRS R0, PSP读取的是任务栈指针而不是主栈指针这就是双堆栈模型的用法——异常与中断用 MSP任务运行用 PSP。需要注意的是 FPU 入栈部分在 STM32F407 上如果工程开了 FPU 而这里没有保存 S16-S31高优先级任务里算过一次浮点切回低优先级任务后浮点寄存器全是脏数据表现是偶发性的计算错误。2.3 移植到 F407 时最容易踩的三个配置点第一个是 FPU 使能。F407 的 FPU 默认是关闭的要在启动文件或 SystemInit 里操作 CPACR 寄存器打开。os_cpu_a.asm里是否编译 FPU 保存代码由OS_CPU_ARM_FP_EN这个宏控制如果宏定义与 CPACR 配置不一致就会出现在调试器里单步正常、全速跑就跑飞的情况。第二个是 SysTick 和 PendSV 的中断优先级。uCOSIII 要求 PendSV 和 SysTick 的优先级必须设置为最低而且工程里如果用了NVIC_PriorityGroup_4所有中断优先级分组要统一。否则OS_ENTER_CRITICAL进入临界区后一个高优先级中断仍可能打断临界区执行最终导致任务链表被破坏调度器死循环在 OS_Sched 里。第三个是 BASEPRI 临界区。cpu_a.asm里的关中断实现用的是 BASEPRI 而不是 PRIMASKBASEPRI 可以只屏蔽优先级数字大于等于某值的中断这样高优先级实时中断在临界区内仍然可以响应。uCOSIII 的OS_CRITICAL_METHOD选 3 时走的就是这条路径代价是 NVIC 必须设置好分组否则 BASEPRI 的值会被错误解释。提示在 Keil 里把os_cpu_a.asm的汇编优化等级和 C 代码的优化等级分开设置调试阶段 C 用 -O0、汇编保持默认能大幅减少“优化导致断点无效”的干扰。3. uCOSIII 任务划分与优先级设计从裸机 while(1) 拆出 LCD、按键和网络线程3.1 先把裸机流程翻译成任务表这份工程的原始裸机框架里main 里通常是 LCD 初始化、按键扫描、网络轮询、显示刷新串在一个大循环里。移植到 uCOSIII 后第一步就是按事件源拆分任务。我的做法是先列一张表把每个功能模块的运行条件、周期、最大执行时间和优先级定下来再动手建任务。功能模块事件触发方式任务优先级任务栈大小Word说明LwIP tcpip_threadETH 中断唤醒最高如 4512协议栈主线程LCD 显示刷新定时 50ms中高如 8256刷新任务状态文本触摸扫描与校准按键/触摸中断中如 10256电阻触摸需要轮询或 ADC 中断按键扫描定时 20ms中低如 12128消抖后发消息队列空闲任务系统调度最低64统计 CPU 利用率优先级 0 是最高级uCOSIII 里同一个优先级只能有一个任务这点和 FreeRTOS 不同设计任务表时要注意。LwIP 的tcpip_thread必须给高优先级因为网络数据包到达后如果它长时间得不到调度TCP 窗口会迅速被占满表现为 PING 通但传输速度上不去而且远端会频繁重传。3.2 任务的创建参数栈大小先按“最坏情况”算uCOSIII 创建任务的 API 是OSTaskCreate原型参数比较多但核心就几个任务函数、任务名、栈顶地址、优先级、栈大小、错误码指针。工程里常见写法如下OS_TCB AppTaskLCDTCB; CPU_STK AppTaskLCDStk[256]; void AppTaskLCD (void *p_arg) { (void)p_arg; while (DEF_ON) { TFTLCD_ShowString(30, 40, uCOSIII, ...); OSTimeDlyHMSM(0, 0, 0, 50, OS_OPT_TIME_HMSM_STRICT, err); } } int main (void) { OS_ERR err; OSInit(err); OSTaskCreate(AppTaskLCDTCB, LCD Task, AppTaskLCD, 0, AppTaskLCDStk[0], 128, 8, 0, OS_OPT_TASK_STK_CHK | OS_OPT_TASK_STK_CLR, err); OSStart(err); }注意CPU_STK的单位是字4 字节而不是字节512 的栈就是 2KB。OS_OPT_TASK_STK_CHK开启栈检查后可以用OSTaskStkChk在运行一段时间后查询每个任务栈的水线用来确认 256 是否给多了或给少了。我一般会把初始栈大小按裸机函数嵌套最深路径再乘 1.5避免在屏幕驱动或 LwIP 回调里发生栈溢出。3.3 按键、触摸和网络事件怎么在任务间传递从 OS 层面看裸机里的全局标志位应该替换为内核对象。按键扫描任务检测到有效按键后不直接操作 LCD而是通过消息队列通知显示任务刷新ETH 中断里收到一个包之后也不在中断里做协议解析而是释放一个信号量唤醒tcpip_thread。uCOSIII 的队列发送函数OSQPost支持从中断里调用区别在于传参用OS_OPT_POST_FIFO且在中断里要带OS_ERR变量OS_Q KeyQ; OS_ERR err; void AppTaskKey (void *p_arg) { uint8_t key; while (DEF_ON) { key Key_Scan(); if (key ! KEY_NONE) { OSQPost(KeyQ, (void *)(CPU_ADDR)key, sizeof(key), OS_OPT_POST_FIFO, err); } OSTimeDlyHMSM(0, 0, 0, 20, OS_OPT_TIME_HMSM_STRICT, err); } } void AppTaskLCD (void *p_arg) { OS_MSG_SIZE size; uint8_t key; while (DEF_ON) { key (uint8_t)(CPU_ADDR)OSQPend(KeyQ, 0, OS_OPT_PEND_BLOCKING, size, 0, err); if (key KEY_MENU) { TFTLCD_ShowString(30, 80, Menu Pressed, ...); } } }OSQPend的第二个参数 0 表示无限等待所以显示任务在没有按键事件时完全不耗 CPU这就是 RTOS 和裸机查询的本质区别。注意从队列里取出来的指针要在同一个内存作用域里使用uCOSIII 的队列传递的是指针值如果传递局部变量地址出函数后内容就会被覆盖这是移植 RTOS 应用代码最常见的错误。提示调试阶段把OS_CFG_TS_EN打开时间戳功能可以帮你在OSQPost和OSQPend两侧打点测量事件从发送到接收的延迟。对触摸点击到屏幕刷新的全链路延迟有量化帮助。3.4 优先级反转在 uCOSIII 里的表现与对策当高优先级任务等待一个低优先级任务持有的互斥量时中优先级任务抢占低优先级任务就会形成高任务等低任务、低任务又被中任务卡死的现象。uCOSIII 的互斥量OSMutexPend默认开启优先级继承持有互斥量的低优先级任务会临时提升到等待者的优先级。但是在 LwIP 的 socket 层里内部锁并不是全部走 uCOS 的原生 mutex部分移植用信号量模拟锁此时继承机制失效所以建议直接用netconnAPI 而不是socketAPI前者与sys_arch层结合更紧密阻塞时的调度行为更可控。4. LwIP 在 uCOSIII 上的集成模型ETH 中断与内存池参数调优4.1 裸机轮询模型和 RTOS 中断驱动模型的分水岭网上常搜到的是“LwIP 裸机移植模型”那套方案里ethernetif_input放在while(1)里持续轮询简单但浪费 CPU而且拔掉网线后轮询空转非常明显。移植到 uCOSIII 之后标准做法是让 ETH 的 RX 中断去OS sem等待接收信号量ethernetif_input变成一个阻塞在信号量上的任务或者让tcpip_thread通过sys_mbox被唤醒。下面是一个在 STM32F407 DP83848 这类 PHY 方案里常见的任务连接方式static OS_SEM EthRxSem; void ETH_IRQHandler (void) { if (ETH_GetITStatus(ETH_IT_RX)) { OSIntEnter(); OSSemPost(EthRxSem, OS_OPT_POST_1, err); OSIntExit(); } ETH_ClearITPendingBit(ETH_IT_RX); } static void ethernetif_input (void *p_arg) { OS_ERR err; while (DEF_TRUE) { OSSemPend(EthRxSem, 0, OS_OPT_PEND_BLOCKING, 0, err); while (eth_rx(netif, pkt) ERR_OK) { netif-input(pkt, netif); } } }这段代码里OSIntEnter和OSIntExit必须成对出现否则任务调度器会在中断退出时被错误触发OSSemPost在中断环境下执行所以它所在的代码路径不能带阻塞操作。netif-input会把 pbuf 交给tcpip_thread处理自己不能直接调用 TCP/IP 回调否则就绕过了 LwIP 的线程保护机制。4.2 sys_arch 层到底要适配哪些东西uCOSIII 移植 LwIP 的难点不在网卡驱动而在sys_arch.c。LwIP 的sys_mbox、sys_sem、sys_mutex、sys_thread这四类对象要全部映射到 uCOS 的队列、信号量、互斥量和任务上。平时调不通网络十有八九是这里返回值的语义没对齐比如sys_arch_mbox_fetch的超时时间单位是毫秒超时后必须返回SYS_ARCH_TIMEOUT返回值 0 表示立即取到消息。我一般会专门写一个自测函数建两个任务互相发消息先确认 sys_arch 层收发延迟稳定再开始调 PHY。PHY 地址是另一个常踩的坑。STM32F407 的 ETH 驱动里通过PHY_ADDRESS宏去读 PHY 寄存器不同板子用的 PHY 不一样LAN8720A 的地址是 0x00DP83848 是 0x01如果和原理图不匹配ETH_Init会卡在读取 PHY ID 那一步。判断办法是先读寄存器 2 和 3组合出来的 OUI 值能直接确认 PHY 型号不要靠猜。4.3 lwipopts.h 参数表按内存余量来裁剪lwipopts.h是 LwIP 性能的总开关下面这几个参数在 F407 上最值得调参数推荐值LCD网口工程影响MEM_SIZE10 * 1024堆内存影响 PCB 和路由缓存PBUF_POOL_SIZE16接收队列缓冲池数量PBUF_POOL_BUFSIZE1518必须大于一个以太网帧TCP_MSS1460单段最大报文长度TCP_WND4 * TCP_MSS接收窗口影响吞吐TCP_SND_BUF4 * TCP_MSS发送缓冲影响吞吐LWIP_NETCONN1netconn API 开关LWIP_SOCKET0资源紧时关闭 socket APITCP_WND和TCP_SND_BUF是吞吐的瓶颈F407 主频 168MHz 时这两个值给到 8 倍 MSS 也没有压力但每开一个 TCP 连接都会按这个值分配 RAM。如果产品同时跑 HTTP Server 和 FTP 上传建议保持 4 倍 MSS否则内存池会被占满。用 netconn 做 TCP Server 的核心代码骨架如下static void TcpServerTask (void *p_arg) { struct netconn *conn, *newconn; struct netbuf *buf; err_t err; conn netconn_new(NETCONN_TCP); netconn_bind(conn, NULL, 8080); netconn_listen(conn); while (1) { err netconn_accept(conn, newconn); if (err ERR_OK) { while ((err netconn_recv(newconn, buf)) ERR_OK) { netconn_write(newconn, payload, len, NETCONN_COPY); netbuf_delete(buf); } netconn_close(newconn); netconn_delete(newconn); } } }NETCONN_COPY会为发送数据拷贝一份内存虽然慢一点但避免调用者 buffer 在发送完成前被改写在 RAM 充足时用NETCONN_NOCOPY能省一次拷贝。netconn_accept是阻塞调用每次连接只在主循环内串行处理实际产品要支持并发连接时应该在 accept 后为每个连接单独建任务或使用非阻塞模式。提示F407 的 64KB CCM RAM 只能被 CPU 访问ETH DMA 描述符不能放进去。可以把tcpip_thread的任务栈放在 CCM因为栈只被 CPU 读写这样可以给MEM_SIZE多腾出一块普通 SRAM。5. TFTLCD 四点校准与运行状态可视化技巧5.1 电阻触摸屏校准的本质是坐标映射TFTLCD 例程里集成的电阻触摸校准多数工程只做了两点校准但这套代码带的是四点校准。两点校准假设 X 和 Y 方向没有旋转和缩放耦合实际贴屏过程中触摸屏和 LCD 之间的角度偏差会让两点的映射误差在屏幕边缘放大。四点校准用仿射变换把物理坐标和屏幕坐标关联起来void Touch_Calibrate (void) { // 四点依次为 (x1,y1) ... (x4,y4) 分别对应对角、水平中点、垂直中点 // 解方程组: // sx a*px b*py c // sy d*px e*py f // 用最小二乘或直接代入四点求 a~f }校准流程是在 LCD 四个角依次显示十字光标触摸得到物理 ADC 值记录到数组后用高斯消元解出a到f六个系数。之后每次触摸只需要一次乘加运算不依赖查表插值所以响应速度快内存占用也就几十个字节。存储这六个系数时我习惯在 main 之前就把它们算好校准完的数据直接写入备份寄存器或外部 Flash避免每次开机都重新校准。5.2 把任务状态和网络连接画到屏幕上网络调试时容易陷入只看串口日志、看不到任务实时状态的盲区。uCOSIII 提供了OSTaskQuery和OSStatTaskCPUUsageLwIP 侧有netconn_getaddr可以拿到当前连接的远端 IP 和端口。把它们组合起来刷新到 TFTLCD 上就能在板子上直接看到哪个任务吃了多少 CPU、TCP 连接断没断。在 LCD 上显示连接状态时用到的锚点代码sprintf(lcd_buf, Remote:%d.%d.%d.%d:%d, (ip4_addr1(conn-pcb.ip-remote_ip)), (ip4_addr2(conn-pcb.ip-remote_ip)), (ip4_addr3(conn-pcb.ip-remote_ip)), (ip4_addr4(conn-pcb.ip-remote_ip)), conn-pcb.ip-remote_port); TFTLCD_ShowString(30, 160, lcd_buf, ...);这段代码直接访问netconn的pcb成员属于内部结构在调试固件里用没问题。显示任务每 500ms 查询一次任务 CPU 利用率和连接状态刷屏时只更新变化区域避免全屏重绘造成 LwIP 任务调度抖动。校准参数和 UI 坐标分开存储后续换屏只需要改校准系数不用动业务代码——这一点在量产换批次液晶屏时能省下大量返工时间。本文还有配套的精品资源点击获取
