C 语言工业级通用组件手写 27：配置参数管理组件

#ifndef CFG_MGR_H
#define CFG_MGR_H

#include <stdint.h>
#include <stdbool.h>

#ifdef __cplusplus
extern "C" {
#endif

// 配置参数结构体
typedef struct {
    uint32_t baudrate;
    uint8_t  dev_addr;
    uint16_t calib_value;
    uint8_t  work_mode;
    uint8_t  reserve[10];
} cfg_params_t;

// 初始化：加载参数，非法则恢复默认
bool cfg_init(void);

// 加载参数到 RAM
bool cfg_load(cfg_params_t *cfg);

// 保存参数到 Flash
bool cfg_save(const cfg_params_t *cfg);

// 恢复出厂默认
bool cfg_restore_default(void);

// 获取默认参数
void cfg_get_default(cfg_params_t *cfg);

#ifdef __cplusplus
}
#endif

#endif

cfg_mgr.c

复制代码

#include "cfg_mgr.h"
#include "crc32.h"  // 使用第9篇组件

// 存储地址（根据硬件修改）
#define CFG_STORE_ADDR     0x0800F800
#define CFG_BACKUP_ADDR    0x0800FC00

static cfg_params_t s_cfg;

// 底层 Flash 读写（需根据平台实现）
static bool flash_write(uint32_t addr, const void *buf, uint32_t len);
static bool flash_read(uint32_t addr, void *buf, uint32_t len);

bool cfg_init(void) {
    if (cfg_load(&s_cfg)) {
        return true;
    }
    return cfg_restore_default();
}

bool cfg_load(cfg_params_t *cfg) {
    if (!cfg) return false;

    uint8_t buf[sizeof(cfg_params_t) + 4];
    if (!flash_read(CFG_STORE_ADDR, buf, sizeof(buf))) {
        return false;
    }

    uint32_t crc_calc = crc32_calc(buf, sizeof(cfg_params_t), 0xFFFFFFFF);
    uint32_t crc_store = *(uint32_t *)(buf + sizeof(cfg_params_t));

    if (crc_calc != crc_store) {
        return false;
    }

    __builtin_memcpy(cfg, buf, sizeof(cfg_params_t));
    return true;
}

bool cfg_save(const cfg_params_t *cfg) {
    if (!cfg) return false;

    uint8_t buf[sizeof(cfg_params_t) + 4];
    __builtin_memcpy(buf, cfg, sizeof(cfg_params_t));

    uint32_t crc = crc32_calc(buf, sizeof(cfg_params_t), 0xFFFFFFFF);
    *(uint32_t *)(buf + sizeof(cfg_params_t)) = crc;

    if (!flash_write(CFG_STORE_ADDR, buf, sizeof(buf))) {
        return false;
    }

    // 冗余备份
    flash_write(CFG_BACKUP_ADDR, buf, sizeof(buf));
    return true;
}

void cfg_get_default(cfg_params_t *cfg) {
    if (!cfg) return;
    cfg->baudrate = 115200;
    cfg->dev_addr = 0x01;
    cfg->calib_value = 1000;
    cfg->work_mode = 0;
}

bool cfg_restore_default(void) {
    cfg_params_t def;
    cfg_get_default(&def);
    return cfg_save(&def);
}

// 空实现，需用户根据硬件移植
static bool flash_write(uint32_t addr, const void *buf, uint32_t len) {
    return true;
}

static bool flash_read(uint32_t addr, void *buf, uint32_t len) {
    __builtin_memset(buf, 0, len);
    return true;
}

五、实战演示

复制代码

#include <stdio.h>
#include "cfg_mgr.h"

int main(void) {
    cfg_init();

    cfg_params_t cfg;
    cfg_load(&cfg);

    printf("波特率: %d\n", cfg.baudrate);
    printf("设备地址: 0x%02X\n", cfg.dev_addr);

    // 修改并保存
    cfg.dev_addr = 0x05;
    cfg_save(&cfg);

    // 恢复出厂
    // cfg_restore_default();
    return 0;
}

六、进阶优化方向

多分区滚动存储，延长 Flash 寿命
A/B 双区镜像，彻底防止掉电变砖
参数版本管理，兼容旧版本结构
加锁机制，防止非法改写
在线监控参数变化

七、面试考点与易错坑点

面试问答

Q1：为什么参数存储要加 CRC？

答：防止 Flash 干扰、静电、掉电导致数据损坏，避免设备启动异常。

Q2：为什么要做默认参数？

答：新设备无参数、参数损坏时可自动恢复，保证设备可正常运行。

Q3：为什么需要冗余备份？

答：存储区损坏时可从备份区恢复，提高可靠性。

Q4：直接操作 Flash 有什么风险？

答：并发冲突、掉电损坏、未对齐写入、数据错乱、死机。

Q5：参数结构体为什么要预留 reserve？

答：方便后续升级扩展，不改变存储结构。

Q6：量产设备参数管理最重要的是什么？

答：可恢复、可校验、不掉电、不异常。

常见坑点

未做 CRC 校验，脏数据导致死机
存储地址重叠，破坏程序代码
掉电过程写 Flash 导致分区损坏
结构体无对齐，解析异常
未实现默认参数，新设备无法启动

总结

配置参数管理组件是嵌入式量产设备稳定性核心组件，通过校验、备份、默认值三重机制保证参数安全可靠，彻底解决掉电丢失、数据异常、启动失败问题。

接口统一、移植简单，是工业控制、传感器、智能设备必备基础模块。

创作不易，如果对你有帮助，欢迎点赞、收藏、转发。