为什么要自己写这一层
菜单逻辑在电脑上跑通以后,要落到 STM32F103C8T6 + SSD1306 + 四个按键上。培训推荐 HAL,我选的是寄存器裸机:不是觉得 HAL 不好,而是想借这次把时钟、GPIO、中断、I2C 时序真正弄懂。换 HAL 时,firmware/menu/ 那一层逻辑不用改。
代价是启动、链接、寄存器都得自己写。仓库里 startup.c、linker.ld、regs.h 是复用的模板,hw.c 是自己按实验一个个补的。
启动文件其实只做三件事:
- 把
.data段的初值从 Flash 搬到 RAM; - 把
.bss段清零(全局变量默认是 0 靠的就是这一步); - 跳进
main()。
向量表必须放在 Flash 最前面(0x08000000),因为上电时硬件固定从那里读栈顶指针和复位入口。
先让时间是对的:SysTick 1ms
菜单的 LED 交替、以后电机的加减速、串口超时,都需要一个"开机以来过了多少毫秒"的数。这个数只能来自硬件定时器。
| |
几个容易写错的点:
LOAD要写8000 - 1,不是8000。 计数器从 LOAD 数到 0 算一轮,所以 8000 个周期对应 7999。CTRL = 7是三个位一次写:使能、中断、用内核时钟。也可以分开|=,但使能那一位要放最后。- 中断里只做
start_ms++。 不要在 SysTick 里画屏、不要放长循环——刷一屏要一百多毫秒,中断会把主循环拖死。 delay_ms用无符号差值,start_ms回绕(49 天)时也不会算错。但它是忙等,只适合初始化,不能放进主循环。
注意这里按 8 MHz 算:代码还没开 PLL,芯片跑在内部 HSI 上。数据手册写的 72 MHz 是上限,不是现在的频率。以后开 PLL,LOAD 和下面软件 I2C 的延时都要按新频率重算——这是上板阶段最容易埋的雷。
为什么时间不能数循环
一开始最容易想到的是"循环 1000 次大约 1 ms"。在这块板子上这条路是死的:
menu_draw() 整屏刷一次 OLED 大约 120~150 ms(1 KB 显存,软件 I2C 一位一位发)。如果主循环靠数圈数累加时间,刷一次屏就等于"过了 150 ms",而 LED 交替要求 500 ms 翻一次——误差直接几十倍,按键响应也会被拖慢。
所以主循环只做一件事:拿 millis() 的差值喂给菜单。板端主循环要长成这样(还没接完):
| |
menu_tick() 只是把毫秒转给 action.c 的 tick(),翻转逻辑在那儿,跟平台无关。PC 版没有真实时间源,所以电脑上看不到灯真的闪,只有状态行会变。
软件 I2C:先能控制时序,再谈速度
OLED 是 SSD1306,128×64,I2C 接口,模块把 SCL / SDA 接在 PB11 / PB10。我没用芯片自带的 I2C 外设,而是 GPIO 翻转模拟:
| |
理由很实际:模块的接线已经定了,软件模拟只受 GPIO 速度限制,时序看得见、改得动;I2C 外设的 CR2 / CCR / OAR 配置和状态位对初学者是另一层黑盒。代价是慢:这段代码在 8 MHz 下大约 100 kHz,刷 1 KB 显存要上百毫秒。
oled_init() 会先探 0x3C,不应答再试 0x3D,返回 0 表示没找到屏幕。这个返回值现在还没被用起来(板载 PC13 的故障闪灯是计划中的用法)。
1 KB 显存怎么和屏幕对上
SSD1306 的显存是 8 页 × 128 列,每页 8 行像素,一个字节竖着管 8 个点。我直接把显存按同样的格式放:
| |
这样 oled_flush() 不用做任何转换:按页发 0xB0 | page、列地址 0,然后连续写 128 字节,正好是屏上的一页。
| |
字库有两套,接口完全一样,编译时二选一:
| 文件 | 字库 | 一个字符占 | 适用 |
|---|---|---|---|
gfx.c + font5x7.c | 5×7 ASCII | 6×8 | 英文界面,代码小 |
gfx_zh.c + font12.c | 12px 中文 + 8×12 ASCII | 12×12 / 8×12 | 中文界面,字库大 |
把菜单画上去
板端的 menu_render() 只做布局,不碰 I2C 时序:
| |
13 + 3×12 = 49,再加 12 像素字高是 61,正好在 64 行内。标题 + 分隔线 + 四行菜单,一屏塞得下。
踩过的坑
1. undefined reference to 'SysTick_Handler'
startup.c 的向量表里写了 SysTick_Handler,但 hw.c 里还没有这个函数时,链接直接失败。向量表里的名字不是"随便起的回调",必须和 C 里定义的函数名完全一致,否则中断来了会跳进 Default_Handler 的死循环。这也是为什么 hw.c 补 SysTick_Handler 的那次提交之前,make -C firmware/hw 是编不过的。
2. 8 MHz 还是 72 MHz
LOAD = 8000 - 1 只在 8 MHz 下是 1 ms。芯片标称 72 MHz、板子也能跑到 72 MHz,但那是开了 PLL 之后的事。这个仓库现在没有配置 PLL,复位后就是内部 HSI 8 MHz。如果照着数据手册的 72 MHz 去算 LOAD,灯会慢 9 倍。先确认 RCC->CFGR 的当前频率,再算定时器。
3. oled_init() 里的 delay_ms(100) 依赖 SysTick
oled_init() 发初始化命令前要等 100 ms。如果 hw_init() 没先跑、SysTick 没开,delay_ms() 会死等(start_ms 永远不涨)。初始化顺序必须是 hw_init() → oled_init()。
4. 中文超出字库会静默变 ?
font12.c 只收了 62 个汉字。菜单文案里出现字库外的字,cjk_index() 返回 -1,画出来是 ?,不报错。加一句文案就要同步补点阵。
5. 文件在 src/ 里 ≠ 已经编进固件
oled.c、gfx.c、字库、menu_board.c 都已经提交,但 firmware/hw/Makefile 的 SRCS 还只有 main.c startup.c hw.c,产物还是 led_test.bin。现在烧进去的仍然是"按住 PB1 点亮 PA5"的验证程序,不是菜单固件。这是下一步要改的第一件事。
现在到哪了
| 实验 | 状态 |
|---|---|
| E1 点亮 PA5 | ✅ 上板验证过 |
| E2 空循环闪灯 | ✅ 做过,后来被 E3 的按键点灯版替换 |
| E3 读 PB1 按键 | ✅ 上板验证,当前 main.c 就是这一版 |
| E4 按键消抖 | 进行中:hw.h 定了 keys_scan(),hw.c 还没实现 |
| E5 SysTick 1ms | ✅ 代码已补 SysTick_Handler / millis / delay_ms(README 还停在"进行中",待同步) |
| OLED / 字库 / menu_render | 已入库,未进构建、未上板 |
| 菜单接入 | 未开始 |
下一步
hw.c补keys_scan()(5 ms 扫一次、连续 3 次一致才认)和led2_set()firmware/hw/Makefile把 OLED / 字库 /menu_board.c/menu.c/action.c加进SRCSaction.c的printf/time(NULL)换成led1_set()/led2_set()/millis()- 主循环接
menu_tick(millis() - last),上板看 LED 交替和 OLED 刷新能不能同时跑