为什么要自己写这一层

菜单逻辑在电脑上跑通以后,要落到 STM32F103C8T6 + SSD1306 + 四个按键上。培训推荐 HAL,我选的是寄存器裸机:不是觉得 HAL 不好,而是想借这次把时钟、GPIO、中断、I2C 时序真正弄懂。换 HAL 时,firmware/menu/ 那一层逻辑不用改。

代价是启动、链接、寄存器都得自己写。仓库里 startup.c、linker.ld、regs.h 是复用的模板,hw.c 是自己按实验一个个补的。

启动文件其实只做三件事:

  1. 把 .data 段的初值从 Flash 搬到 RAM;
  2. 把 .bss 段清零(全局变量默认是 0 靠的就是这一步);
  3. 跳进 main()。

向量表必须放在 Flash 最前面(0x08000000),因为上电时硬件固定从那里读栈顶指针和复位入口。

先让时间是对的:SysTick 1ms

菜单的 LED 交替、以后电机的加减速、串口超时,都需要一个"开机以来过了多少毫秒"的数。这个数只能来自硬件定时器。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
static volatile uint32_t start_ms = 0;

void SysTick_Handler(void) { start_ms++; }   /* 1ms 进一次,只做加法 */

void hw_init(void) {
    /* ... GPIO 初始化 ... */

    SYSTICK->LOAD = 8000U - 1U;   /* 8MHz / 8000 = 1ms */
    SYSTICK->VAL  = 0;            /* 计数器清零 */
    SYSTICK->CTRL = 7U;           /* bit0 使能 | bit1 中断 | bit2 内核时钟 */
}

uint32_t millis(void) { return start_ms; }

void delay_ms(uint32_t ms) {
    uint32_t start = start_ms;
    while ((start_ms - start) < ms) { }
}

几个容易写错的点:

  • 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() 的差值喂给菜单。板端主循环要长成这样(还没接完):

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
uint32_t last = millis();

for (;;) {
    uint32_t now = millis();
    menu_tick((int)(now - last));   /* 真实经过的毫秒 */
    last = now;

    int key = keys_scan();
    if (key) menu_key(key);
    if (menu_dirty()) menu_draw();
}

menu_tick() 只是把毫秒转给 action.c 的 tick(),翻转逻辑在那儿,跟平台无关。PC 版没有真实时间源,所以电脑上看不到灯真的闪,只有状态行会变。

软件 I2C:先能控制时序,再谈速度

OLED 是 SSD1306,128×64,I2C 接口,模块把 SCL / SDA 接在 PB11 / PB10。我没用芯片自带的 I2C 外设,而是 GPIO 翻转模拟:

1
2
3
4
5
6
7
8
#define SCL_PIN   11U
#define SDA_PIN   10U
#define I2C_DELAY 5

/* 粗延时:8MHz 下每圈约几个周期,5 圈约 3µs */
static void i2c_delay(void) {
    for (volatile int i = 0; i < I2C_DELAY; i++) { }
}

理由很实际:模块的接线已经定了,软件模拟只受 GPIO 速度限制,时序看得见、改得动;I2C 外设的 CR2 / CCR / OAR 配置和状态位对初学者是另一层黑盒。代价是慢:这段代码在 8 MHz 下大约 100 kHz,刷 1 KB 显存要上百毫秒。

oled_init() 会先探 0x3C,不应答再试 0x3D,返回 0 表示没找到屏幕。这个返回值现在还没被用起来(板载 PC13 的故障闪灯是计划中的用法)。

1 KB 显存怎么和屏幕对上

SSD1306 的显存是 8 页 × 128 列,每页 8 行像素,一个字节竖着管 8 个点。我直接把显存按同样的格式放:

1
2
3
4
5
6
7
8
9
static uint8_t s_fb[GFX_WIDTH * GFX_HEIGHT / 8];   /* 128 × 64 / 8 = 1024 */

void gfx_pixel(int x, int y, int on) {
    uint16_t index = (uint16_t)x + (uint16_t)(y / 8) * GFX_WIDTH;
    uint8_t  mask  = (uint8_t)(1U << (y % 8));

    if (on) s_fb[index] |= mask;
    else    s_fb[index] &= (uint8_t)~mask;
}

这样 oled_flush() 不用做任何转换:按页发 0xB0 | page、列地址 0,然后连续写 128 字节,正好是屏上的一页。

1
2
索引 = x + (y / 8) * 128
位   = y % 8

字库有两套,接口完全一样,编译时二选一:

文件字库一个字符占适用
gfx.c + font5x7.c5×7 ASCII6×8英文界面,代码小
gfx_zh.c + font12.c12px 中文 + 8×12 ASCII12×12 / 8×12中文界面,字库大

把菜单画上去

板端的 menu_render() 只做布局,不碰 I2C 时序:

1
2
3
4
5
6
7
8
9
void menu_render(void) {
    gfx_clear();
    gfx_text_center(0, title[screen]);   /* 标题居中,贴顶 */
    gfx_hline(0, GFX_WIDTH - 1, 9);      /* 标题下一条分隔线 */
    for (int i = 0; i < LINE; i++)
        if (lines[i][0] != '\0')
            gfx_text(0, 13 + i * 12, lines[i]);
    oled_flush();
}

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已入库,未进构建、未上板
菜单接入未开始

下一步

  1. hw.c 补 keys_scan()(5 ms 扫一次、连续 3 次一致才认)和 led2_set()
  2. firmware/hw/Makefile 把 OLED / 字库 / menu_board.c / menu.c / action.c 加进 SRCS
  3. action.c 的 printf / time(NULL) 换成 led1_set() / led2_set() / millis()
  4. 主循环接 menu_tick(millis() - last),上板看 LED 交替和 OLED 刷新能不能同时跑

代码:YYUN64/Debug-Car