很多做蓝牙键盘、桌面小键盘这类外设项目的开发者前期最兴奋的阶段是“能连上蓝牙、能打出字”。等进入功能迭代期痛苦才真正开始用户想要调节背光亮度想要修改按键重复率想要自定义组合键结果发现每一个配置都写死在代码里改一个参数就要重新编译烧录一版固件。更麻烦的是如果按键映射、UI菜单、显示文本全都耦合在一起后面加一个页面就可能牵扯出一堆改动。这个问题的本质不是代码写得不够好而是数据没有和代码分离。单片机资源有限一个 NRF52840 虽然拥有 1MB Flash、256KB RAM但如果你不规划存储分区不设计参数读写接口资源再多也会在项目复杂度面前败下阵来。这篇文章是 B站AI创造公开赛参赛项目“NRF52840蓝牙键盘”系列的第四期重点解决三个问题单片机 OLED UI 怎么设计才不乱、Flash 分区怎么规划才安全、参数分离怎么落地才好维护。读完你会有完整的工程思路从屏驱动到菜单状态机从分区表到磨损均衡从结构体定义到掉电保护手把手把一套可用的框架搭起来。1. 为什么蓝牙键盘需要 OLED UI 和参数分离1.1 从“能工作”到“好维护”中间差了什么先看一个典型的裸机开发路径。前期功能简单代码长这样#define BACKLIGHT_LEVEL 3 #define KEY_REPEAT_DELAY 300编译下载功能正常一切看起来没问题。但这个项目一旦做完第一版你会发现一个尴尬的事实任何用户可调项都变成了“改代码才能解决”的需求。用户觉得键盘背光太亮你要改BACKLIGHT_LEVEL。用户发现按键重复太快你要改KEY_REPEAT_DELAY。用户想设置默认层数你要加一个新的宏定义。这还只是“功能层面”。如果项目里还有 OLED 菜单问题会进一步扩大菜单页面的布局、焦点状态、显示内容都写在同一个文件中页面越多代码越臃肿。真正的工程问题不是“写不出来”而是改起来太痛苦。1.2 分区和参数分离的实际价值把 Flash 分区、参数分离引入 NRF52840 单片机项目后开发流程会发生这样的变化旧流程改需求 - 改代码 - 重新编译 - 烧录固件 - 回归测试 新流程设备上通过 UI 修改参数 - 写入参数区 - 重启后自动恢复这个转变的收益在项目后期尤其明显用户配置不再依赖重刷固件。固件代码可以聚焦功能参数管理交给独立模块。升级固件时可以保留用户配置。出问题时可以快速恢复默认值。更直接地说学会 Flash 分区与参数分离是从“能跑 demo”走向“能交付产品”的关键一步。2. NRF52840 核心资源与存储模型2.1 NRF52840 芯片简介NRF52840 是 Nordic Semiconductor 推出的一款低功耗蓝牙 SoC核心参数如下参数数值内核ARM Cortex-M4F主频64 MHzFlash1 MBRAM256 KB蓝牙版本Bluetooth 5.0外设USB、I2C、SPI、UART、ADC、PWM 等对于蓝牙键盘项目NRF52840 的资源和外设足够支撑矩阵扫描、BLE 通信、OLED 显示、背光控制等多任务并行。2.2 Flash 存储结构NRF52840 的 Flash 按页管理1MB Flash 通常分为 256 页每页 4KB。写入 Flash 有以下特点只能将 1 写成 0。写入前必须先擦除擦除以页为单位。Flash 擦写寿命有限数据手册给出的大致寿命在 10000 次左右。这意味着不能直接拿 Flash 当“变量存储区”来频繁写值。合理的做法是在 Flash 中划分固定区域专门存放参数。写入时先擦除整页再写入新数据。通过分区、备份、磨损均衡等手段延长使用寿命。2.3 为什么分区比“随便找个地址写”更可靠没有分区规划的项目常见问题不知道哪个地址存了什么时间久了团队内部都不清楚。写坏了参数可能覆盖了固件区代码。固件升级时不小心清掉了用户配置。地址漂移后旧版本固件读不到新参数。分区能解决这些问题本质上是把 Flash 当作一个小型“文件系统”来管理先约定区域边界再规定读写接口最后才是具体数据格式。3. 环境准备硬件接线与 SDK 配置3.1 硬件清单本篇文章的核心硬件NRF52840 开发板0.96 英寸 OLED 显示屏SSD1306 驱动I2C 接口蓝牙键盘矩阵扫描电路本期不做重点连接线、按键、电池供电模块可选3.2 OLED 接线参考以 I2C 方式连接 SSD1306 OLED 为例OLED 引脚NRF52840 引脚说明VCC3.3V供电GNDGND地SCLP0.20I2C 时钟线SDAP0.21I2C 数据线注意具体引脚编号请以你手头开发板的丝印和 SDK 配置文件为准本例只是演示思路。3.3 编译与开发环境推荐使用以下工具链之一nRF5 SDK arm-none-eabi-gccnRF5 SDK Keil MDKNordic nRF Connect SDK如果使用 Zephyr思路类似但接口不同以 nRF5 SDK 为例一个最小工程需要确认已配置好sdk_config.h开启 I2C 相关组件。已添加 SSD1306 驱动文件可以自己写也可以移植开源库。已在链接脚本中预留 Flash 参数区。如果暂时不熟悉特定 SDK 版本建议先基于官方示例blinky或ble_app_uart修改这样编译问题会少很多。4. OLED UI 设计核心页面状态机与帧缓冲区4.1 不要把 UI 逻辑和屏幕驱动混在一起很多人第一次做 OLED 界面习惯把oled_draw()、oled_show_string()直接写在 main 里。页面少的时候没问题页面多了就会变成“屎山”菜单切换、焦点移动、按键响应全在一个函数里。更合理的做法是分层UI 层页面节点、菜单切换、焦点状态 渲染层根据状态绘制到帧缓冲区 驱动层把帧缓冲区发送到 SSD13064.2 OLED 驱动最小实现SSD1306 是常见 OLED 控制器先看最基本的 I2C 写入函数。// 文件路径drv_oled.c核心逻辑示意 #define OLED_ADDR 0x3C static void oled_write_cmd(uint8_t cmd) { uint8_t buf[2] {0x00, cmd}; // 假设已有 i2c_write 函数第一个参数为从机地址 i2c_write(OLED_ADDR, buf, sizeof(buf)); } static void oled_write_data(uint8_t data) { uint8_t buf[2] {0x40, data}; i2c_write(OLED_ADDR, buf, sizeof(buf)); } void oled_init(void) { oled_write_cmd(0xAE); // display off oled_write_cmd(0x20); // memory addressing mode oled_write_cmd(0x00); // horizontal addressing mode oled_write_cmd(0xA8); // multiplex ratio oled_write_cmd(0x3F); oled_write_cmd(0xD3); // display offset oled_write_cmd(0x00); oled_write_cmd(0x40); // start line oled_write_cmd(0x8D); // charge pump oled_write_cmd(0x14); // enable charge pump oled_write_cmd(0xAF); // display on }4.3 帧缓冲区与屏幕刷新128x64 的 OLED 在单色模式下一个完整的帧需要 1024 字节。建议在 RAM 中维护一个帧缓冲区#define OLED_WIDTH 128 #define OLED_HEIGHT 64 static uint8_t framebuffer[OLED_WIDTH * OLED_HEIGHT / 8]; void oled_refresh(void) { for (int page 0; page 8; page) { oled_write_cmd(0xB0 page); oled_write_cmd(0x00); oled_write_cmd(0x10); for (int col 0; col OLED_WIDTH; col) { oled_write_data(framebuffer[page * OLED_WIDTH col]); } } }这种“先画后刷”的模式有一个直接好处页面切换时不会出现屏幕闪烁也不容易出现撕屏现象。4.4 页面状态机设计OLED UI 的本质是一个状态机。每个页面可以看作一个状态按键事件决定状态如何迁移。// 文件路径ui_menu.h typedef struct { uint8_t id; void (*on_enter)(void); void (*on_draw)(void); uint8_t (*on_key)(uint8_t key_code); } menu_page_t;具体菜单切换伪代码如下// 文件路径ui_menu.c static menu_page_t *current_page; void ui_process_key(uint8_t key) { uint8_t next_id current_page-on_key(key); if (next_id ! PAGE_NONE) { menu_set_page(next_id); } } void menu_set_page(uint8_t page_id) { current_page page_list[page_id]; current_page-on_enter(); current_page-on_draw(); }通过这个方法页面代码可以拆开写每个页面只关心自己的绘制和按键逻辑互不干扰。5. Flash 分区规划让存储边界明确5.1 分区表设计在 NRF52840 的 1MB Flash 中常见的分区方式如下分区名称起始地址大小用途固件区APP0x00000最高 960KB存放固件代码参数区0xF800016KB存放用户参数OTA 升级区可选不定存放升级包这个表格只是一个参考实际地址偏移需要结合固件大小、SoftDevice、Bootloader 一起规划。5.2 参数区内部的细分16KB 参数区进一步细分为 4 个页每页 4KB页序号起始地址用途页 00xF8000参数主区页 10xF9000参数备份区页 20xFA000保留区页 30xFB000保留区双备份的意义是写入参数时如果发生掉电主区数据损坏启动时可以从备份区恢复。5.3 在链接脚本中预留参数区如果使用 GCC 工具链需要在链接脚本中明确参数区地址防止固件编译后溢出到参数区。示例片段/* nrf52840_xxaa.ld片段 */ MEMORY { FLASH (rx) : ORIGIN 0x00000000, LENGTH 0xF8000 PARAM (rx) : ORIGIN 0x000F8000, LENGTH 0x4000 RAM (rwx) : ORIGIN 0x20000000, LENGTH 0x40000 }如果不做这一步编译器不知道预留区域而链接脚本中地址规划错误会导致两个严重后果固件编译超过 Flash 边界。参数写入覆盖固件区造成程序跑飞。6. 参数分离实战数据结构、CRC 校验与备份恢复6.1 参数结构体设计参数分离的第一步是定义统一的用户参数结构体。以下是一个键盘项目常见的参数集// 文件路径user_config.h #define CONFIG_MAGIC 0x4B424458 // KBDX #define CONFIG_VERSION 2 typedef struct { uint32_t magic; uint32_t version; uint32_t crc32; uint8_t backlight_level; // 背光亮度 0-10 uint8_t key_repeat_delay; // 按键重复延迟 uint8_t key_repeat_rate; // 按键重复速率 uint8_t default_layer; // 默认层 uint16_t ble_tx_power; // 蓝牙发射功率 } user_config_t;结构体中同时放入了 magic、version、crc32这三点分别是magic识别参数块是否有效。version升级固件时判断参数结构是否兼容。crc32校验参数数据是否被破坏。6.2 保存与加载核心逻辑下面演示一个最小可用的 Flash 参数读写框架重点展示流程而不是具体寄存器操作。// 文件路径flash_param.c #include string.h #include user_config.h #include app_timer.h // 假设 SDK 环境 #define PARAM_PAGE0_ADDR 0x000F8000 #define PARAM_PAGE1_ADDR 0x000F9000 static user_config_t g_config; static uint32_t compute_crc32(const uint8_t *data, uint32_t len) { // 这里可以接入 zlib 的 crc32 实现或移植一个轻量 CRC 函数 // 演示时返回固定值实际项目请使用完整实现 return 0x12345678; } static bool config_is_valid(const user_config_t *cfg) { if (cfg-magic ! CONFIG_MAGIC) { return false; } if (cfg-version ! CONFIG_VERSION) { return false; } if (cfg-crc32 ! compute_crc32((const uint8_t*)cfg 12, sizeof(user_config_t) - 12)) { return false; } return true; } bool config_load(void) { memcpy(g_config, (void*)PARAM_PAGE0_ADDR, sizeof(user_config_t)); if (config_is_valid(g_config)) { return true; } // 主区无效尝试备份区 memcpy(g_config, (void*)PARAM_PAGE1_ADDR, sizeof(user_config_t)); if (config_is_valid(g_config)) { return true; } // 都无效加载默认值 config_set_default(); return false; } bool config_save(void) { g_config.crc32 compute_crc32((const uint8_t*)g_config 12, sizeof(user_config_t) - 12); // 擦除备份页先写入备份区再擦除主区写入主区 flash_erase(PARAM_PAGE1_ADDR); flash_write(PARAM_PAGE1_ADDR, g_config, sizeof(user_config_t)); flash_erase(PARAM_PAGE0_ADDR); flash_write(PARAM_PAGE0_ADDR, g_config, sizeof(user_config_t)); return true; }这段代码有几个关键点写备份区优先降低掉电损坏风险。校验失败时回退到备份区再回退默认值。crc32 的范围跳过头部 12 字节因为 magic/version/crc32 本身不是有效载荷。6.3 修改参数时的保存策略参数保存不能“每次按键都写 Flash”。更合理的做法是UI 修改 - 更新 RAM 缓存 - 启动延迟保存定时器如 1 秒- 定时器触发后写 Flash这个策略很关键既保证掉电前有机会写入又避免频繁擦除导致 Flash 寿命快速耗尽。举例来说如果用户按一次加号就写一次 Flash一个 10000 次寿命的参数区很快就会被写坏。7. 完整工程示例菜单调整背光 参数恢复7.1 工程目录结构一个适合做键盘项目的工程结构如下nrf52840_kbd/ |-- src/ | |-- main.c | |-- key_matrix.c | |-- ble_kbd.c | |-- drv_oled.c | |-- ui_menu.c | |-- flash_param.c | -- user_config.c |-- inc/ | |-- drv_oled.h | |-- ui_menu.h | |-- flash_param.h | -- user_config.h |-- sdk_config.h -- nrf52840_xxaa.ld7.2 main 函数框架这里展示调用流程不展开全部代码。// 文件路径src/main.c演示工程主流程 #include drv_oled.h #include ui_menu.h #include flash_param.h #include key_matrix.h int main(void) { // 1. 硬件初始化 oled_init(); key_matrix_init(); // 2. 加载配置 config_load(); // 3. 初始化菜单显示初始页面 ui_init(); // 4. 主循环按键扫描 - UI 更新 - OLED 刷新 while (1) { uint8_t key key_matrix_scan(); if (key ! KEY_NONE) { ui_process_key(key); // 如果页面做了参数修改可能触发保存 config_save_if_needed(); } oled_refresh(); // 进入低功耗 / 处理蓝牙事件 } }实际项目里主循环还需要处理 BLE 协议栈事件不能写死在 while 里这里只是用来说明模块调用关系。7.3 菜单页面示例背光亮度调节以背光亮度调节页为例按键会修改 RAM 中的配置并触发延迟保存。// 文件路径src/ui_page_backlight.c #include ui_menu.h #include user_config.h #include flash_param.h static uint8_t page_id_backlight; static uint8_t on_key(uint8_t key) { switch (key) { case KEY_LEFT: if (g_config.backlight_level 0) { g_config.backlight_level--; config_save_if_needed(); } break; case KEY_RIGHT: if (g_config.backlight_level 10) { g_config.backlight_level; config_save_if_needed(); } break; case KEY_BACK: return MENU_PAGE_HOME; default: break; } return PAGE_NONE; }8. 运行验证与常见问题排查8.1 怎么验证参数分离成功完成工程后可通过以下步骤验证上电后进入菜单页面查看背光亮度显示。通过按键把背光从 3 调到 7。重启设备确认背光仍然为 7。修改参数后立刻断电再上电确认备份恢复机制生效。将参数区擦除确认系统能恢复默认值并重新创建参数。8.2 预期日志或屏幕输出调试阶段建议在 UART 输出日志[BOOT] start [CONFIG] load from primary page [CONFIG] backlight: 7 [KEY] scan: 0x12 [UI] backlight change: 8 [CONFIG] save triggered [CONFIG] write primary page OK [CONFIG] write backup page OK8.3 常见问题排查表问题现象可能原因排查方式解决方案OLED 无显示I2C 地址不对或接线错误读取设备地址检查 SCL/SDA 电平确认 OLED 模块地址换用正确地址OLED 花屏帧缓冲刷新逻辑错误单步调试 oled_refresh检查页地址和列地址设置参数重启后丢失没有正确加载或写入流程出错查看 config_load 返回值检查地址是否越界、magic 值是否一致参数区被写入后程序跑飞地址覆盖了固件区打印分区地址检查链接脚本在链接脚本中明确预留参数区写 Flash 后读取 CRC 失败CRC 计算范围不一致对比保存和校验的 CRC 范围统一 CRC 覆盖长度频繁按键时 Flash 快速损坏每次按键都写 Flash查看 Flash 擦写计数改为延迟保存策略9. 最佳实践与工程化建议9.1 分区地址要写进头文件在多个模块需要访问参数区地址时建议集中定义// 文件路径flash_map.h #ifndef FLASH_MAP_H #define FLASH_MAP_H #define FLASH_REGION_APP_START 0x00000000 #define FLASH_REGION_PARAM_START 0x000F8000 #define FLASH_REGION_PARAM_END 0x000FC000 #endif这样比分散在代码里定义更安全也方便团队统一修改。9.2 参数结构体要保证向后兼容写入参数结构体时 version 字段的意义是当结构体增加字段时旧固件不能读取新结构体的全部内容。处理方式有两种版本不兼容时丢弃旧参数写入默认值。在结构体尾部追加新字段并保留旧字段位置。具体选用哪种取决于新字段语义是否改变旧字段含义。如果只是新增一个配置项建议保留旧字段在尾部追加字段并升级 version。9.3 写入前先擦除写入后必须验证Flash 写入容易受到掉电、干扰影响。最好的保护方法是擦除目标页。写入数据。回读校验关键字段。不一致则重试。重试次数建议限制在 3 次以内避免死循环消耗 Flash。9.4 参数保存放在主循环或低功耗事件中不要在中断回调里直接执行 Flash 擦写。Flash 擦写期间 CPU 可能被阻塞影响蓝牙协议栈的实时性。常见做法是设置一个保存请求标志。在主循环或后台任务中执行实际写操作。写之前关闭全局中断或确认没有关键操作正在执行。9.5 调试时不要烧录测试参数到正式参数区开发阶段可以使用一个独立的调试参数区地址避免反复擦写正式参数区的数据。9.6 结合 OTA 升级做好分区联动如果后续要做 OTA 升级需要在分区表中预留升级缓存区并确保升级失败时可以回滚到旧固件。参数区地址也需要在 Bootloader 中保持一致否则升级后参数可能读错。10. 小结与下一步实践建议这篇文章围绕 NRF52840 蓝牙键盘项目讲清楚了 OLED UI 设计和 Flash 分区参数分离的核心思路。如果你项目里还是所有参数都写死代码建议先尝试把配置集中到一个结构体中如果已经做了结构体下一步可以引入 mag鉴权、双备份和延迟保存。这些改进不需要一次做完可以逐步叠加。下一步值得继续深入的方向有三个一是把自己的菜单页面用状态机重构看看代码会不会更容易扩展二是在参数区中增加磨损均衡让参数可以满 Flash 区域滚动写入三是结合 BLE 无线连接在手机 App 或配套上位机中调整键盘参数让参数分离的收益延伸出去。这套思路不仅适用于 NRF52840换成 STM32、GD32、ESP32 也适用。Flash 分区和参数分离的本质是让项目在功能和数据两个维度上都具备可维护性越早想清楚这一点后面迭代就越轻松。
很多做蓝牙键盘、桌面小键盘这类外设项目的开发者前期最兴奋的阶段是“能连上蓝牙、能打出字”。等进入功能迭代期痛苦才真正开始用户想要调节背光亮度想要修改按键重复率想要自定义组合键结果发现每一个配置都写死在代码里改一个参数就要重新编译烧录一版固件。更麻烦的是如果按键映射、UI菜单、显示文本全都耦合在一起后面加一个页面就可能牵扯出一堆改动。这个问题的本质不是代码写得不够好而是数据没有和代码分离。单片机资源有限一个 NRF52840 虽然拥有 1MB Flash、256KB RAM但如果你不规划存储分区不设计参数读写接口资源再多也会在项目复杂度面前败下阵来。这篇文章是 B站AI创造公开赛参赛项目“NRF52840蓝牙键盘”系列的第四期重点解决三个问题单片机 OLED UI 怎么设计才不乱、Flash 分区怎么规划才安全、参数分离怎么落地才好维护。读完你会有完整的工程思路从屏驱动到菜单状态机从分区表到磨损均衡从结构体定义到掉电保护手把手把一套可用的框架搭起来。1. 为什么蓝牙键盘需要 OLED UI 和参数分离1.1 从“能工作”到“好维护”中间差了什么先看一个典型的裸机开发路径。前期功能简单代码长这样#define BACKLIGHT_LEVEL 3 #define KEY_REPEAT_DELAY 300编译下载功能正常一切看起来没问题。但这个项目一旦做完第一版你会发现一个尴尬的事实任何用户可调项都变成了“改代码才能解决”的需求。用户觉得键盘背光太亮你要改BACKLIGHT_LEVEL。用户发现按键重复太快你要改KEY_REPEAT_DELAY。用户想设置默认层数你要加一个新的宏定义。这还只是“功能层面”。如果项目里还有 OLED 菜单问题会进一步扩大菜单页面的布局、焦点状态、显示内容都写在同一个文件中页面越多代码越臃肿。真正的工程问题不是“写不出来”而是改起来太痛苦。1.2 分区和参数分离的实际价值把 Flash 分区、参数分离引入 NRF52840 单片机项目后开发流程会发生这样的变化旧流程改需求 - 改代码 - 重新编译 - 烧录固件 - 回归测试 新流程设备上通过 UI 修改参数 - 写入参数区 - 重启后自动恢复这个转变的收益在项目后期尤其明显用户配置不再依赖重刷固件。固件代码可以聚焦功能参数管理交给独立模块。升级固件时可以保留用户配置。出问题时可以快速恢复默认值。更直接地说学会 Flash 分区与参数分离是从“能跑 demo”走向“能交付产品”的关键一步。2. NRF52840 核心资源与存储模型2.1 NRF52840 芯片简介NRF52840 是 Nordic Semiconductor 推出的一款低功耗蓝牙 SoC核心参数如下参数数值内核ARM Cortex-M4F主频64 MHzFlash1 MBRAM256 KB蓝牙版本Bluetooth 5.0外设USB、I2C、SPI、UART、ADC、PWM 等对于蓝牙键盘项目NRF52840 的资源和外设足够支撑矩阵扫描、BLE 通信、OLED 显示、背光控制等多任务并行。2.2 Flash 存储结构NRF52840 的 Flash 按页管理1MB Flash 通常分为 256 页每页 4KB。写入 Flash 有以下特点只能将 1 写成 0。写入前必须先擦除擦除以页为单位。Flash 擦写寿命有限数据手册给出的大致寿命在 10000 次左右。这意味着不能直接拿 Flash 当“变量存储区”来频繁写值。合理的做法是在 Flash 中划分固定区域专门存放参数。写入时先擦除整页再写入新数据。通过分区、备份、磨损均衡等手段延长使用寿命。2.3 为什么分区比“随便找个地址写”更可靠没有分区规划的项目常见问题不知道哪个地址存了什么时间久了团队内部都不清楚。写坏了参数可能覆盖了固件区代码。固件升级时不小心清掉了用户配置。地址漂移后旧版本固件读不到新参数。分区能解决这些问题本质上是把 Flash 当作一个小型“文件系统”来管理先约定区域边界再规定读写接口最后才是具体数据格式。3. 环境准备硬件接线与 SDK 配置3.1 硬件清单本篇文章的核心硬件NRF52840 开发板0.96 英寸 OLED 显示屏SSD1306 驱动I2C 接口蓝牙键盘矩阵扫描电路本期不做重点连接线、按键、电池供电模块可选3.2 OLED 接线参考以 I2C 方式连接 SSD1306 OLED 为例OLED 引脚NRF52840 引脚说明VCC3.3V供电GNDGND地SCLP0.20I2C 时钟线SDAP0.21I2C 数据线注意具体引脚编号请以你手头开发板的丝印和 SDK 配置文件为准本例只是演示思路。3.3 编译与开发环境推荐使用以下工具链之一nRF5 SDK arm-none-eabi-gccnRF5 SDK Keil MDKNordic nRF Connect SDK如果使用 Zephyr思路类似但接口不同以 nRF5 SDK 为例一个最小工程需要确认已配置好sdk_config.h开启 I2C 相关组件。已添加 SSD1306 驱动文件可以自己写也可以移植开源库。已在链接脚本中预留 Flash 参数区。如果暂时不熟悉特定 SDK 版本建议先基于官方示例blinky或ble_app_uart修改这样编译问题会少很多。4. OLED UI 设计核心页面状态机与帧缓冲区4.1 不要把 UI 逻辑和屏幕驱动混在一起很多人第一次做 OLED 界面习惯把oled_draw()、oled_show_string()直接写在 main 里。页面少的时候没问题页面多了就会变成“屎山”菜单切换、焦点移动、按键响应全在一个函数里。更合理的做法是分层UI 层页面节点、菜单切换、焦点状态 渲染层根据状态绘制到帧缓冲区 驱动层把帧缓冲区发送到 SSD13064.2 OLED 驱动最小实现SSD1306 是常见 OLED 控制器先看最基本的 I2C 写入函数。// 文件路径drv_oled.c核心逻辑示意 #define OLED_ADDR 0x3C static void oled_write_cmd(uint8_t cmd) { uint8_t buf[2] {0x00, cmd}; // 假设已有 i2c_write 函数第一个参数为从机地址 i2c_write(OLED_ADDR, buf, sizeof(buf)); } static void oled_write_data(uint8_t data) { uint8_t buf[2] {0x40, data}; i2c_write(OLED_ADDR, buf, sizeof(buf)); } void oled_init(void) { oled_write_cmd(0xAE); // display off oled_write_cmd(0x20); // memory addressing mode oled_write_cmd(0x00); // horizontal addressing mode oled_write_cmd(0xA8); // multiplex ratio oled_write_cmd(0x3F); oled_write_cmd(0xD3); // display offset oled_write_cmd(0x00); oled_write_cmd(0x40); // start line oled_write_cmd(0x8D); // charge pump oled_write_cmd(0x14); // enable charge pump oled_write_cmd(0xAF); // display on }4.3 帧缓冲区与屏幕刷新128x64 的 OLED 在单色模式下一个完整的帧需要 1024 字节。建议在 RAM 中维护一个帧缓冲区#define OLED_WIDTH 128 #define OLED_HEIGHT 64 static uint8_t framebuffer[OLED_WIDTH * OLED_HEIGHT / 8]; void oled_refresh(void) { for (int page 0; page 8; page) { oled_write_cmd(0xB0 page); oled_write_cmd(0x00); oled_write_cmd(0x10); for (int col 0; col OLED_WIDTH; col) { oled_write_data(framebuffer[page * OLED_WIDTH col]); } } }这种“先画后刷”的模式有一个直接好处页面切换时不会出现屏幕闪烁也不容易出现撕屏现象。4.4 页面状态机设计OLED UI 的本质是一个状态机。每个页面可以看作一个状态按键事件决定状态如何迁移。// 文件路径ui_menu.h typedef struct { uint8_t id; void (*on_enter)(void); void (*on_draw)(void); uint8_t (*on_key)(uint8_t key_code); } menu_page_t;具体菜单切换伪代码如下// 文件路径ui_menu.c static menu_page_t *current_page; void ui_process_key(uint8_t key) { uint8_t next_id current_page-on_key(key); if (next_id ! PAGE_NONE) { menu_set_page(next_id); } } void menu_set_page(uint8_t page_id) { current_page page_list[page_id]; current_page-on_enter(); current_page-on_draw(); }通过这个方法页面代码可以拆开写每个页面只关心自己的绘制和按键逻辑互不干扰。5. Flash 分区规划让存储边界明确5.1 分区表设计在 NRF52840 的 1MB Flash 中常见的分区方式如下分区名称起始地址大小用途固件区APP0x00000最高 960KB存放固件代码参数区0xF800016KB存放用户参数OTA 升级区可选不定存放升级包这个表格只是一个参考实际地址偏移需要结合固件大小、SoftDevice、Bootloader 一起规划。5.2 参数区内部的细分16KB 参数区进一步细分为 4 个页每页 4KB页序号起始地址用途页 00xF8000参数主区页 10xF9000参数备份区页 20xFA000保留区页 30xFB000保留区双备份的意义是写入参数时如果发生掉电主区数据损坏启动时可以从备份区恢复。5.3 在链接脚本中预留参数区如果使用 GCC 工具链需要在链接脚本中明确参数区地址防止固件编译后溢出到参数区。示例片段/* nrf52840_xxaa.ld片段 */ MEMORY { FLASH (rx) : ORIGIN 0x00000000, LENGTH 0xF8000 PARAM (rx) : ORIGIN 0x000F8000, LENGTH 0x4000 RAM (rwx) : ORIGIN 0x20000000, LENGTH 0x40000 }如果不做这一步编译器不知道预留区域而链接脚本中地址规划错误会导致两个严重后果固件编译超过 Flash 边界。参数写入覆盖固件区造成程序跑飞。6. 参数分离实战数据结构、CRC 校验与备份恢复6.1 参数结构体设计参数分离的第一步是定义统一的用户参数结构体。以下是一个键盘项目常见的参数集// 文件路径user_config.h #define CONFIG_MAGIC 0x4B424458 // KBDX #define CONFIG_VERSION 2 typedef struct { uint32_t magic; uint32_t version; uint32_t crc32; uint8_t backlight_level; // 背光亮度 0-10 uint8_t key_repeat_delay; // 按键重复延迟 uint8_t key_repeat_rate; // 按键重复速率 uint8_t default_layer; // 默认层 uint16_t ble_tx_power; // 蓝牙发射功率 } user_config_t;结构体中同时放入了 magic、version、crc32这三点分别是magic识别参数块是否有效。version升级固件时判断参数结构是否兼容。crc32校验参数数据是否被破坏。6.2 保存与加载核心逻辑下面演示一个最小可用的 Flash 参数读写框架重点展示流程而不是具体寄存器操作。// 文件路径flash_param.c #include string.h #include user_config.h #include app_timer.h // 假设 SDK 环境 #define PARAM_PAGE0_ADDR 0x000F8000 #define PARAM_PAGE1_ADDR 0x000F9000 static user_config_t g_config; static uint32_t compute_crc32(const uint8_t *data, uint32_t len) { // 这里可以接入 zlib 的 crc32 实现或移植一个轻量 CRC 函数 // 演示时返回固定值实际项目请使用完整实现 return 0x12345678; } static bool config_is_valid(const user_config_t *cfg) { if (cfg-magic ! CONFIG_MAGIC) { return false; } if (cfg-version ! CONFIG_VERSION) { return false; } if (cfg-crc32 ! compute_crc32((const uint8_t*)cfg 12, sizeof(user_config_t) - 12)) { return false; } return true; } bool config_load(void) { memcpy(g_config, (void*)PARAM_PAGE0_ADDR, sizeof(user_config_t)); if (config_is_valid(g_config)) { return true; } // 主区无效尝试备份区 memcpy(g_config, (void*)PARAM_PAGE1_ADDR, sizeof(user_config_t)); if (config_is_valid(g_config)) { return true; } // 都无效加载默认值 config_set_default(); return false; } bool config_save(void) { g_config.crc32 compute_crc32((const uint8_t*)g_config 12, sizeof(user_config_t) - 12); // 擦除备份页先写入备份区再擦除主区写入主区 flash_erase(PARAM_PAGE1_ADDR); flash_write(PARAM_PAGE1_ADDR, g_config, sizeof(user_config_t)); flash_erase(PARAM_PAGE0_ADDR); flash_write(PARAM_PAGE0_ADDR, g_config, sizeof(user_config_t)); return true; }这段代码有几个关键点写备份区优先降低掉电损坏风险。校验失败时回退到备份区再回退默认值。crc32 的范围跳过头部 12 字节因为 magic/version/crc32 本身不是有效载荷。6.3 修改参数时的保存策略参数保存不能“每次按键都写 Flash”。更合理的做法是UI 修改 - 更新 RAM 缓存 - 启动延迟保存定时器如 1 秒- 定时器触发后写 Flash这个策略很关键既保证掉电前有机会写入又避免频繁擦除导致 Flash 寿命快速耗尽。举例来说如果用户按一次加号就写一次 Flash一个 10000 次寿命的参数区很快就会被写坏。7. 完整工程示例菜单调整背光 参数恢复7.1 工程目录结构一个适合做键盘项目的工程结构如下nrf52840_kbd/ |-- src/ | |-- main.c | |-- key_matrix.c | |-- ble_kbd.c | |-- drv_oled.c | |-- ui_menu.c | |-- flash_param.c | -- user_config.c |-- inc/ | |-- drv_oled.h | |-- ui_menu.h | |-- flash_param.h | -- user_config.h |-- sdk_config.h -- nrf52840_xxaa.ld7.2 main 函数框架这里展示调用流程不展开全部代码。// 文件路径src/main.c演示工程主流程 #include drv_oled.h #include ui_menu.h #include flash_param.h #include key_matrix.h int main(void) { // 1. 硬件初始化 oled_init(); key_matrix_init(); // 2. 加载配置 config_load(); // 3. 初始化菜单显示初始页面 ui_init(); // 4. 主循环按键扫描 - UI 更新 - OLED 刷新 while (1) { uint8_t key key_matrix_scan(); if (key ! KEY_NONE) { ui_process_key(key); // 如果页面做了参数修改可能触发保存 config_save_if_needed(); } oled_refresh(); // 进入低功耗 / 处理蓝牙事件 } }实际项目里主循环还需要处理 BLE 协议栈事件不能写死在 while 里这里只是用来说明模块调用关系。7.3 菜单页面示例背光亮度调节以背光亮度调节页为例按键会修改 RAM 中的配置并触发延迟保存。// 文件路径src/ui_page_backlight.c #include ui_menu.h #include user_config.h #include flash_param.h static uint8_t page_id_backlight; static uint8_t on_key(uint8_t key) { switch (key) { case KEY_LEFT: if (g_config.backlight_level 0) { g_config.backlight_level--; config_save_if_needed(); } break; case KEY_RIGHT: if (g_config.backlight_level 10) { g_config.backlight_level; config_save_if_needed(); } break; case KEY_BACK: return MENU_PAGE_HOME; default: break; } return PAGE_NONE; }8. 运行验证与常见问题排查8.1 怎么验证参数分离成功完成工程后可通过以下步骤验证上电后进入菜单页面查看背光亮度显示。通过按键把背光从 3 调到 7。重启设备确认背光仍然为 7。修改参数后立刻断电再上电确认备份恢复机制生效。将参数区擦除确认系统能恢复默认值并重新创建参数。8.2 预期日志或屏幕输出调试阶段建议在 UART 输出日志[BOOT] start [CONFIG] load from primary page [CONFIG] backlight: 7 [KEY] scan: 0x12 [UI] backlight change: 8 [CONFIG] save triggered [CONFIG] write primary page OK [CONFIG] write backup page OK8.3 常见问题排查表问题现象可能原因排查方式解决方案OLED 无显示I2C 地址不对或接线错误读取设备地址检查 SCL/SDA 电平确认 OLED 模块地址换用正确地址OLED 花屏帧缓冲刷新逻辑错误单步调试 oled_refresh检查页地址和列地址设置参数重启后丢失没有正确加载或写入流程出错查看 config_load 返回值检查地址是否越界、magic 值是否一致参数区被写入后程序跑飞地址覆盖了固件区打印分区地址检查链接脚本在链接脚本中明确预留参数区写 Flash 后读取 CRC 失败CRC 计算范围不一致对比保存和校验的 CRC 范围统一 CRC 覆盖长度频繁按键时 Flash 快速损坏每次按键都写 Flash查看 Flash 擦写计数改为延迟保存策略9. 最佳实践与工程化建议9.1 分区地址要写进头文件在多个模块需要访问参数区地址时建议集中定义// 文件路径flash_map.h #ifndef FLASH_MAP_H #define FLASH_MAP_H #define FLASH_REGION_APP_START 0x00000000 #define FLASH_REGION_PARAM_START 0x000F8000 #define FLASH_REGION_PARAM_END 0x000FC000 #endif这样比分散在代码里定义更安全也方便团队统一修改。9.2 参数结构体要保证向后兼容写入参数结构体时 version 字段的意义是当结构体增加字段时旧固件不能读取新结构体的全部内容。处理方式有两种版本不兼容时丢弃旧参数写入默认值。在结构体尾部追加新字段并保留旧字段位置。具体选用哪种取决于新字段语义是否改变旧字段含义。如果只是新增一个配置项建议保留旧字段在尾部追加字段并升级 version。9.3 写入前先擦除写入后必须验证Flash 写入容易受到掉电、干扰影响。最好的保护方法是擦除目标页。写入数据。回读校验关键字段。不一致则重试。重试次数建议限制在 3 次以内避免死循环消耗 Flash。9.4 参数保存放在主循环或低功耗事件中不要在中断回调里直接执行 Flash 擦写。Flash 擦写期间 CPU 可能被阻塞影响蓝牙协议栈的实时性。常见做法是设置一个保存请求标志。在主循环或后台任务中执行实际写操作。写之前关闭全局中断或确认没有关键操作正在执行。9.5 调试时不要烧录测试参数到正式参数区开发阶段可以使用一个独立的调试参数区地址避免反复擦写正式参数区的数据。9.6 结合 OTA 升级做好分区联动如果后续要做 OTA 升级需要在分区表中预留升级缓存区并确保升级失败时可以回滚到旧固件。参数区地址也需要在 Bootloader 中保持一致否则升级后参数可能读错。10. 小结与下一步实践建议这篇文章围绕 NRF52840 蓝牙键盘项目讲清楚了 OLED UI 设计和 Flash 分区参数分离的核心思路。如果你项目里还是所有参数都写死代码建议先尝试把配置集中到一个结构体中如果已经做了结构体下一步可以引入 mag鉴权、双备份和延迟保存。这些改进不需要一次做完可以逐步叠加。下一步值得继续深入的方向有三个一是把自己的菜单页面用状态机重构看看代码会不会更容易扩展二是在参数区中增加磨损均衡让参数可以满 Flash 区域滚动写入三是结合 BLE 无线连接在手机 App 或配套上位机中调整键盘参数让参数分离的收益延伸出去。这套思路不仅适用于 NRF52840换成 STM32、GD32、ESP32 也适用。Flash 分区和参数分离的本质是让项目在功能和数据两个维度上都具备可维护性越早想清楚这一点后面迭代就越轻松。
