app_flashdb.h 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344
  1. /*
  2. * Copyright (c) 2006-2021, RT-Thread Development Team
  3. *
  4. * SPDX-License-Identifier: Apache-2.0
  5. *
  6. * Change Logs:
  7. * Date Author Notes
  8. * 2026-07-08 Administrator the first version
  9. */
  10. #ifndef APPLICATIONS_APP_FLASHDB_C_
  11. #define APPLICATIONS_APP_FLASHDB_C_
  12. #include <flashdb.h>
  13. #include <stddef.h>
  14. typedef struct
  15. {
  16. uint8_t iSave; //存储标志位
  17. uint8_t freq_filter; //滤网自动更换周期
  18. uint8_t worked_day; //已采集天数
  19. uint32_t tape_max; //胶带最大使用量(长度)
  20. uint32_t filter_max; //滤网最大使用量(长度)
  21. uint32_t tape_used; //胶带使用量
  22. uint32_t filter_used; //滤网使用量
  23. }Flashdb_typedef;
  24. /* 全局参数实例(定义在 app_flashdb.c / dtu_uart2.c, 依赖 -fcommon 合并),
  25. * 这里补一份 extern 声明: 其它模块(如 hmi.c 的参数重置)引用时不必再自己写 tentative 定义 */
  26. extern Flashdb_typedef flashdb_value;
  27. int app_flashdb_init(void);
  28. /* 2026-09-28 修正: 增加 len 参数。
  29. * 原实现内部用 sizeof(value) 取长度, 而 value 是指针, sizeof 恒为 4:
  30. * - uint32_t 字段侥幸正确;
  31. * - uint8_t 字段(worked_day / freq_filter)会被越界读 3 字节并越界写回, 踩坏相邻成员。
  32. * 现在由调用点显式传入 sizeof(目标变量)。 */
  33. int app_flashdb_save(const char *key, const void *value, size_t len);
  34. int app_flashdb_load(const char *key, void *value, size_t len);
  35. /* EasyFlash 兼容接口(底层为 FlashDB KVDB),业务代码无需改动 */
  36. size_t ef_get_env_blob(const char *key, void *value_buf, size_t buffer_len, size_t *saved_value_len);
  37. int ef_set_env_blob(const char *key, const void *value_buf, size_t size);
  38. #endif /* APPLICATIONS_APP_FLASHDB_C_ */