generated from hulk/gd32e23x_template_cmake_vscode
38 lines
1.3 KiB
C
38 lines
1.3 KiB
C
/**
|
||
* @file calib_store.h
|
||
* @brief VL53L4CD 校准数据 Flash 持久化存储接口
|
||
* @details 利用主 Flash 最后一页（1KB，地址按运行时检测到的 Flash 容量计算）
|
||
* 保存偏移校准与串扰校准结果，掉电不丢失。
|
||
* 注意：链接脚本已将代码区缩小 1KB，为 16K 容量器件保留该页。
|
||
*/
|
||
#ifndef CALIB_STORE_H
|
||
#define CALIB_STORE_H
|
||
|
||
#include <stdbool.h>
|
||
#include <stdint.h>
|
||
|
||
/**
|
||
* @brief 从 Flash 读取校准数据
|
||
* @param[out] offset_mm: 返回保存的偏移量，单位 mm
|
||
* @param[out] xtalk_kcps: 返回保存的串扰值，单位 kcps
|
||
* @retval true: 校准数据有效; false: 无数据、版本不匹配或校验失败
|
||
*/
|
||
bool calib_store_load(int16_t *offset_mm, uint16_t *xtalk_kcps);
|
||
|
||
/**
|
||
* @brief 保存校准数据到 Flash（整页擦除后写入）
|
||
* @details 操作期间会短暂暂停串口接收中断，耗时约几十毫秒
|
||
* @param[in] offset_mm: 偏移量，单位 mm
|
||
* @param[in] xtalk_kcps: 串扰值，单位 kcps，0..127
|
||
* @retval true: 保存成功; false: Flash 操作失败
|
||
*/
|
||
bool calib_store_save(int16_t offset_mm, uint16_t xtalk_kcps);
|
||
|
||
/**
|
||
* @brief 擦除 Flash 中的校准数据页
|
||
* @retval true: 擦除成功; false: Flash 操作失败
|
||
*/
|
||
bool calib_store_erase(void);
|
||
|
||
#endif /* CALIB_STORE_H */
|