EasyFlash - 嵌入式小型数据库学习

嵌入式老吴

已于 2023-12-03 16:36:20 修改

阅读量1.8k

点赞数 22

文章标签：嵌入式实时数据库

于 2023-12-03 16:31:51 首次发布

本文链接：https://blog.csdn.net/wu_chaowei/article/details/134765524

版权

1. 简介

在嵌入式产品开发时，需要存储一些用户数据，如：设备账户密码、SN、校准参数等，可以使用一款叫做EasyFlash的开源轻量级存储库，该存储库资源占用极低，移植简单。

GitHub连接：https://github.com/armink/EasyFlash

2. 移植介绍

2.1 init接口

EfErrCode ef_port_init(ef_env const **default_env, size_t *default_env_size) {
    EfErrCode result = EF_NO_ERR;

    *default_env = default_env_set;
    *default_env_size = sizeof(default_env_set) / sizeof(default_env_set[0]);
	
	// 存储硬件初始化
	drv_flash_init();
    return result;
}

2.2 read接口

EfErrCode ef_port_read(uint32_t addr, uint32_t *buf, size_t size) {
    EfErrCode result = EF_NO_ERR;

	// 存储硬件read接口
	drv_flash_read(addr, size, (uint8_t *)buf);

    return result;
}

2.3 erase接口

EfErrCode ef_port_erase(uint32_t addr, size_t size) {
    EfErrCode result = EF_NO_ERR;
    // 存储硬件erase接口
    drv_flash_erase(addr, size);
    return result;
}

2.4 write接口

EfErrCode ef_port_write(uint32_t addr, const uint32_t *buf, size_t size) {
    EfErrCode result = EF_NO_ERR;
    // 存储硬件write接口
    drv_flash_write(addr, size, (const uint8_t *)buf);
    return result;
}

2.5 lock接口

void ef_port_env_lock(void) {
    
	//关闭全局中断
   __disable_irq();
}

void ef_port_env_unlock(void) {
    
	//打开全局中断
	__enable_irq();
    
}

2.5 调试日志信息打印接口

在定义PRINT_DEBUG宏后，打印调试日志信息。

void ef_log_debug(const char *file, const long line, const char *format, ...)

2.6 普通日志信息打印接口

void ef_log_info(const char *format, ...)

2.7 无格式信息打印接口

该方法输出无固定格式的打印信息，为ef_print_env方法所用（如果不使用ef_print_env则可以忽略）。而ef_log_debug及ef_log_info可以输出带指定前缀及格式的打印日志信息。

void ef_print(const char *format, ...)

2.8 默认环境变量集合

在 ef_port.c 文件顶部定义有 static const ef_env default_env_set[] ，我们可以将产品上需要的默认环境变量集中定义在这里。当 flash 第一次初始化时会将默认的环境变量写入。

static uint32_t boot_count = 0;
static time_t boot_time[10] = {0, 1, 2, 3};
static const ef_env default_env_set[] = {
        {"username", "armink", 0},   //类型为字符串的环境变量可以设定值的长度为 0 ，此时会在初始化时会自动检测其长度
        {"password", "123456", 0},
        {"boot_count", &boot_count, sizeof(boot_count)},  //整形
        {"boot_time", &boot_time, sizeof(boot_time)},  //数组类型，其他类型使用方式类似
};