STM32F103裸机编程实战：时间片轮询调度与ILI9481驱动详解-育师

简介：这是一套面向嵌入式初学者与STM32裸机开发者的综合功能验证程序，专为PZ6806D开发板（搭载STM32F1系列MCU）及ILI9481驱动的TFT-LCD显示屏设计，解决裸机环境下显示驱动初始化、图形绘制、色彩控制与稳定性验证等核心问题。压缩包共313个文件，含135个头文件（h）定义寄存器与接口，111个C源文件（c）实现底层驱动（如tftlcd.c、stm32f10x_tim.c）、FatFS文件系统（ff.c）及中文编码支持（cc936.c等），另有PNG/GIF图像资源、PDF技术文档、Keil工程文件（uvprojx/uvoptx）及批处理脚本（bat），整体2.39MB，结构完整、模块清晰，便于逐层理解与调试。已有66人学习下载，读者可直接编译运行获取全功能演示：包括屏幕初始化校验、多色图形填充、中英文字符显示、动态刷新测试及硬件时序验证，是掌握STM32F1外设驱动与ILI9481控制器通信协议的实用入门范例。

1. 项目概述：一个经典的嵌入式“练手”项目

最近在整理硬盘，翻出来一个老项目——“PZ6806D-STM32F1综合测试程序-裸机-ILI9481.zip”。看到这个名字，估计不少玩过STM32的朋友都会心一笑。这几乎是一个时代的缩影：一块基于STM32F103ZE（或类似型号）的核心板，搭配一块3.5寸或4.3寸的TFT液晶屏，驱动芯片是ILI9481，然后写一个“裸机”程序，把GPIO、定时器、中断、ADC、PWM、SPI、I2C这些外设功能都测一遍，最后在屏幕上画点线面、显示文字和图片，做一个简陋的UI界面。这个项目本身技术栈并不前沿，但它就像嵌入式开发的“九九乘法表”，是理解MCU如何从零开始工作的绝佳范例。尤其在今天“RTOS”、“HAL库”、“CubeMX”大行其道的环境下，回头看看纯粹的寄存器操作和裸机调度，对夯实底层基础、理解计算机系统本质有着不可替代的价值。

这个项目适合谁呢？首先是嵌入式初学者，尤其是那些已经学完C语言和单片机基本概念，但面对一个实际开发板不知从何下手的同学。通过复现这个综合测试程序，你能把书本上孤立的知识点（如串口通信、ADC采样）串联成一个完整的系统。其次，是有一定经验的开发者，想深入理解“裸机”编程思想，为后续学习实时操作系统（RTOS）的任务调度、资源管理打下坚实基础。最后，对于硬件工程师或测试工程师，这也是一套验证硬件平台基本功能的可靠代码框架。

2. 核心硬件平台与驱动解析

2.1 PZ6806D开发板与STM32F103核心

“PZ6806D”通常指的是一种特定型号的STM32开发板，其核心是意法半导体的STM32F103ZET6。这是一颗基于ARM Cortex-M3内核的微控制器，拥有512KB的Flash和64KB的RAM，144个引脚，资源非常丰富。为什么当年这类项目如此流行？原因就在于它的“甜点”特性：性能足够（72MHz主频），外设齐全（包括多个定时器、ADC、DAC、通信接口），价格在当时极具竞争力，而且社区资料和海量例程支撑起了庞大的生态。

在裸机编程中，我们通常不依赖STM32标准库（StdPeriph_Lib）或HAL库，而是直接操作芯片的寄存器。这听起来很底层，但其实更有助于理解硬件的工作原理。例如，配置一个GPIO引脚为推挽输出，你需要直接向对应的“配置寄存器”和“数据寄存器”写入特定的值。这种方式代码效率极高，对时序的控制也最精确，是驱动像ILI9481这类对时序有严格要求的液晶屏的理想选择。

2.2 ILI9481 TFT-LCD屏驱动详解

ILI9481是一颗经典的16位并口（8080接口）TFT液晶控制器，支持262K色，分辨率常见为480x320。驱动它，是该项目在硬件层面的核心挑战之一。

通信接口：ILI9481主要支持8位/16位并行8080接口。在PZ6806D上，通常使用FSMC（灵活的静态存储器控制器）来模拟8080时序，这能极大减轻CPU负担。FSMC是STM32F1系列的一个强大外设，它可以将一片外部存储区域（如Bank1）映射到CPU的地址空间，我们像读写内存一样（*（volatile uint16_t*）0x60000000 = data;）就能完成对LCD的数据写入，硬件自动产生片选、写使能、地址等控制信号。

初始化序列：这是驱动LCD最繁琐的一步。ILI9481上电后需要一系列特定的命令（Command）和数据（Data）进行初始化，包括设置伽马校正、驱动方向、像素格式等。这些命令序列通常由屏厂提供，但需要根据你的具体接线（尤其是RGB引脚顺序）进行微调。一个常见的坑是初始化后屏幕白屏或花屏，多半是某个初始化命令的参数不对，或者FSMC的时序配置（如地址建立时间、数据保持时间）与屏幕不匹配。

显存与绘图：在裸机环境下，我们通常没有真正的“显存”。所谓的显示缓冲区（Framebuffer）就是一片在RAM中开辟的数组，大小等于屏幕分辨率乘以每个像素的字节数（对于16位色深，是2字节）。所有绘图操作（画点、画线、填充）都是对这个数组进行操作。当需要更新屏幕时，再将这片缓冲区的内容通过FSMC一次性搬运到LCD的GRAM中。这就是所谓的“全屏刷新”。为了优化，可以只刷新局部区域（脏矩形更新），但这需要更复杂的逻辑。

注意：STM32F103的64KB RAM是宝贵资源。一个480x320x2的完整帧缓冲区就需要300KB，远超其容量。因此，常见的做法是使用“部分缓冲”或“直接绘制”模式。要么只开辟一行或一小块区域的缓冲区，绘制完立即写入LCD；要么不设缓冲区，每个绘图函数都直接操作LCD。前者平衡了速度和内存，后者最省内存但频繁操作总线可能导致闪烁。

3. 裸机程序架构与任务调度框架

“裸机”并不意味着代码是一锅粥。一个结构良好的裸机程序，同样需要清晰的架构，这就是标题中“综合测试程序”的内涵，也暗合了网络热词中“裸机程序任务调度框架”的关注点。

3.1 时间片轮询调度器

这是最经典、最实用的裸机多任务管理方法。其核心是一个由系统定时器（如SysTick）驱动的计数器，以及一个任务函数数组。

typedef struct { void (*task_func)(void); // 任务函数指针 uint32_t interval_ticks; // 执行间隔（滴答数） uint32_t last_run_ticks; // 上次执行时间 } task_t; task_t task_list[] = { {task_led_blink, 500, 0}, // 500ms闪烁LED {task_key_scan, 20, 0}, // 20ms扫描按键 {task_adc_sample, 100, 0}, // 100ms采样ADC {task_lcd_refresh, 50, 0}, // 50ms刷新LCD（局部） // ... 更多任务 }; void SysTick_Handler(void) { // 1ms中断一次 static uint32_t systick_counter = 0; systick_counter++; for(int i=0; i<sizeof(task_list)/sizeof(task_t); i++) { if((systick_counter - task_list[i].last_run_ticks) >= task_list[i].interval_ticks) { task_list[i].task_func(); task_list[i].last_run_ticks = systick_counter; } } }

在这个框架下，每个任务就像一个个独立的小函数，它们根据预设的频率自动执行。task_led_blink控制指示灯，task_key_scan检测按键并更新状态，task_adc_sample读取电位器电压，task_lcd_refresh根据标志位决定是否更新屏幕某一部分。这种方法的优点是简单、可预测、无优先级反转问题。缺点是任务不能阻塞，必须快速执行完毕，否则会影响其他任务的准时性。

3.2 前后台系统与状态机

对于更复杂的事件处理，如串口接收一帧数据、触摸屏校准流程，就需要引入“状态机”的概念。主循环（后台）不断轮询各个模块的状态，而中断服务程序（前台）负责触发状态变更。

例如，处理串口命令解析：

typedef enum {UART_IDLE, UART_RECEIVING, UART_CMD_READY} uart_state_t; uart_state_t uart_state = UART_IDLE; uint8_t uart_buffer[64]; uint8_t uart_index = 0; void USART1_IRQHandler(void) { // 串口接收中断 if(USART1->SR & USART_SR_RXNE) { uint8_t data = USART1->DR; if(uart_state == UART_IDLE && data == 0xAA) { // 帧头 uart_state = UART_RECEIVING; uart_index = 0; } else if(uart_state == UART_RECEIVING) { if(data == 0x55) { // 帧尾 uart_state = UART_CMD_READY; } else { uart_buffer[uart_index++] = data; } } } } void task_uart_process(void) { // 主循环中轮询的任务 if(uart_state == UART_CMD_READY) { process_command(uart_buffer, uart_index); // 解析处理命令 uart_state = UART_IDLE; // 恢复空闲状态 } }

这种“中断+状态机+轮询”的组合，构成了裸机程序处理异步事件的核心模式，它能有效处理外设响应，同时保持主程序逻辑的清晰。

4. 外设功能测试模块实现

综合测试程序的价值在于将多个外设集成并协同工作。下面拆解几个关键模块的实现要点。

4.1 ADC采样与电压显示

STM32F1的12位ADC精度不错，常用它来采样电位器电压，并在LCD上实时显示波形或数值。

配置ADC：选择ADC1的某个通道（如通道1），配置为单次转换模式，对齐方式为右对齐。
触发与读取：可以在定时器中断里触发ADC转换，也可以在任务中手动启动。转换完成后读取ADC1->DR寄存器得到原始值。
软件滤波：ADC值通常会有抖动。简单的做法是连续采样N次（如16次），然后取平均值。更高级一点可以用一阶低通滤波算法：filtered_val = alpha * raw_val + (1-alpha) * filtered_val，其中alpha是滤波系数。
电压计算与显示：Voltage = (ADC_Value / 4095.0) * Vref。Vref是参考电压，通常是3.3V。将计算出的浮点数转换为字符串，调用LCD显示函数绘制到屏幕指定位置。为了动态效果，可以绘制一个简单的柱状图或曲线图，每次采样后只更新图的一小部分。

4.2 PWM输出与呼吸灯效果

利用定时器的PWM功能控制LED亮度，实现呼吸灯效果，是测试定时器输出的好方法。

配置定时器：以TIM3的通道2为例。将对应引脚（如PB5）重映射为PWM输出。配置定时器为向上计数模式，预分频器（PSC）和自动重载值（ARR）共同决定PWM频率。例如，72MHz主频，PSC=71，ARR=999，则PWM频率为72MHz / (71+1) / (999+1) = 1kHz。
配置PWM模式：设置捕获/比较模式寄存器为PWM模式1，使能预装载寄存器，最后设置比较寄存器（CCR2）的初始值。CCR2的值决定了占空比。
实现呼吸效果：在主循环或一个单独的任务中，以一定间隔（如10ms）修改CCR2的值。可以使用一个方向标志位：亮度值从0递增到ARR，然后递减回0，如此循环。改变递增/递减的步进值可以调节呼吸速度。

4.3 按键扫描与菜单界面

用几个独立按键实现一个简单的多层菜单，是综合测试程序UI部分的核心。

按键消抖：机械按键会产生抖动，必须在软件中处理。最可靠的方法是“状态机+延时消抖”。检测到引脚电平变化后，不是立即认为按键按下，而是等待10-20ms再次检测，如果状态一致才确认。
菜单数据结构：可以定义一个菜单项结构体，包含显示文本、上级菜单索引、下级菜单索引、以及按键（确认、返回）对应的处理函数指针。

typedef void (*menu_func_t)(void); typedef struct { const char* text; int parent_index; int child_index; menu_func_t ok_func; menu_func_t back_func; } menu_item_t; menu_item_t menu[] = { {"主菜单", -1, 1, NULL, NULL}, {"ADC测试", 0, -1, enter_adc_test, back_to_main}, {"PWM测试", 0, 2, enter_pwm_test, back_to_main}, {"设置频率", 2, -1, set_freq, back_to_pwm_test}, // ... };

界面渲染：用一个全局变量current_menu_index记录当前菜单索引。当按键触发切换时，清屏（或局部刷新），然后根据menu[current_menu_index].text绘制标题和当前菜单下的子项，并用高亮条指示选中项。
事件处理：在按键扫描任务中，检测到“确认”键，就执行menu[current_menu_index].ok_func()；检测到“返回”键，就将current_menu_index更新为menu[current_menu_index].parent_index，并触发界面刷新。

5. 显示系统优化与图形绘制

在资源受限的STM32F1上流畅地显示图形和文字，需要一些优化技巧。

5.1 字体与图片存储与显示

中英文字符和图标通常以位图形式存储。

取模与存储：使用PC端工具（如PCtoLCD2002）将字体或图片转换为像素数组（字模）。为了节省空间，常使用横向取模、高位在前的格式。这些数组可以存储在代码区（const数组），如果很大，可以考虑存储在外部的SPI Flash中，使用时再加载到RAM。
显示函数：一个通用的显示字符函数需要参数：起始坐标（x, y）、字符的像素数据指针、前景色、背景色。函数内部通过两层循环，根据像素数据是1还是0，来决定向LCD写入前景色还是背景色。显示图片原理类似，但像素数据直接对应颜色值（16位RGB565）。
优化技巧：对于纯色背景的文字，可以先设置一个矩形区域为背景色，再绘制文字前景，这比逐个像素判断更快。利用FSMC的连续写模式，一次性发送多行像素数据，能大幅提升填充和图片显示速度。

5.2 局部刷新与双缓冲策略

如前所述，全屏刷新在STM32F1上不现实。局部刷新是必须的。

脏矩形机制：为需要更新的屏幕区域定义一个“脏矩形”（dirty rectangle），记录其左上角和右下角坐标。在LCD刷新任务中，只将这个矩形区域的数据从逻辑显示缓冲区复制到LCD。这需要你的所有绘图函数（画点、画线、写字）在修改缓冲区的同时，能更新这个脏矩形的范围（取并集）。
极致的直接绘制：对于实时性要求高的动态元素（如波形曲线的移动），可以不用缓冲区。计算新曲线的位置，直接向LCD发送绘图命令，同时发送命令擦除旧曲线的痕迹（用背景色重画）。这种方法对时序控制要求高，容易因计算和通信延迟导致闪烁，但内存占用最小。

6. 项目集成、调试与问题排查

将各个模块整合在一起，并解决随之而来的问题，是项目最考验人的部分。

6.1 模块化集成与头文件管理

一个清晰的目录结构至关重要。建议如下：

/Project ├── CMSIS/ （存放CMSIS核心文件，如core_cm3.h） ├── User/ │ ├── main.c │ ├── stm32f10x_conf.h │ ├── system_stm32f10x.c │ └── ... ├── Driver/ │ ├── gpio/ │ ├── usart/ │ ├── adc/ │ ├── timer/ │ ├── fsmc/ │ └── ili9481/ （LCD驱动，含初始化序列、基本绘图API） ├── App/ │ ├── task.c/.h （任务调度器） │ ├── menu.c/.h │ ├── waveform.c/.h （波形显示逻辑） │ └── ... └── Utilities/ （延时函数、简单滤波算法等）

每个.c文件都有对应的.h头文件，头文件中用#ifndef __XXX_H宏防止重复包含。在stm32f10x_conf.h中集中管理所有用到的外设头文件。这样，当你想复用ILI9481驱动到另一个项目时，直接拷贝Driver/ili9481目录即可。

6.2 常见问题与调试实录

在开发此类项目时，我踩过不少坑，这里记录几个典型的：

问题一：LCD显示花屏、错位或颜色不对。

排查思路：
1. 检查FSMC时序：这是最常见的原因。尤其是FSMC_BTR寄存器中的地址建立时间（ADDSET）、数据建立时间（DATAST）。ILI9481数据手册有最小时间要求，STM32的时钟周期是已知的，需要计算并留有余量。可以尝试逐步增大这些值。
2. 检查数据线连接：确认FSMC数据线D0-D15与LCD的DB0-DB15是否一一对应，尤其注意高低字节顺序。有时需要调整FSMC_BCR寄存器中的数据宽度和字节序模式。
3. 检查初始化序列：逐条核对初始化命令和数据，特别是设置像素格式（0x3A）、内存访问控制（0x36）等命令。内存访问控制命令决定了扫描方向、颜色格式，设置错误会导致显示旋转或颜色通道错乱。
4. 检查电源和复位：确保LCD的VCC、背光电压稳定，复位引脚在上电后有正确的延时复位过程。

问题二：按键反应不灵或连击。

排查思路：
1. 消抖算法：确保使用了可靠的消抖逻辑，如前述的状态机法。简单的延时消抖在任务调度框架中可能不可靠。
2. 扫描频率：按键扫描任务的执行间隔不宜太短（如小于5ms）或太长（如大于50ms）。10-20ms是个不错的范围。
3. 上拉电阻：如果硬件上没有接上拉电阻，需要在软件中配置GPIO为内部上拉输入模式。
4. 连击处理：如果需要区分短按和长按，需要在状态机中加入计时。当按键按下状态持续超过某个阈值（如1秒），则触发长按事件。

问题三：ADC采样值跳动大。

排查思路：
1. 硬件滤波：在ADC输入引脚对地加一个0.1uF的电容，可以滤除高频噪声。
2. 软件滤波：务必使用软件滤波。平均滤波最简单有效。对于变化缓慢的信号，一阶低通滤波效果更好。
3. 参考电压：确保Vref+引脚连接了稳定的电源（通常是3.3V），并且去耦良好。如果使用VDDA作为参考，要确保它干净。
4. 采样周期：适当增加ADC的采样周期（通过SMPx位），让采样电容有更长时间充电，可以提高精度，尤其对于高阻抗信号源。

问题四：程序运行一段时间后死机。

排查思路：
1. 堆栈溢出：这是裸机程序最常见的死机原因。检查启动文件中的堆栈大小设置（如Stack_Size）。如果使用了大量局部变量或深层次函数调用，需要增大堆栈。
2. 数组越界或指针错误：使用调试器（如J-Link配合IDE）设置内存访问断点，或者检查是否有可能写穿了数组边界。
3. 中断冲突：确保没有中断服务程序执行时间过长，或者在非原子操作中被打断。对于共享的全局变量，在访问时应考虑关中断进行保护。
4. 看门狗：如果开启了看门狗，确保在主循环或任务中定期喂狗。

这个“PZ6806D-STM32F1综合测试程序”项目，虽然技术点看似基础，但完整地走一遍，从寄存器配置到驱动编写，从模块测试到系统集成，再到问题排查，它所构建的知识体系和解决问题的能力，是任何高端框架都无法替代的。在RTOS和各类框架封装越来越深的今天，偶尔回归“裸机”，亲手操控每一个比特，能让你对“系统”二字有更透彻的理解。当你再面对更复杂的系统时，你会清楚地知道，底层究竟发生了什么。

本文还有配套的精品资源，点击获取