基于小凌派RK2206开发板：OpenHarmony如何使用IoT接口控制FLASH外设

1、实验简介

本实验将演示如何在小凌派-RK2206开发板上使用IOT库的FLASH接口，进行FLASH编程开发。

例程将创建一个任务，实现FLASH读写操作。

例程源代码：小凌派-RK2206开发板: 小凌派-RK2206开发板鸿蒙3.0稳定版资料共享 - Gitee.com

2、基础知识

FLASH在日常设备中非常常见，以下我们将演示IOT库的FLASH接口如何进行UART口读写操作。

2.1、头文件

base/iot_hardware/peripheral/interfaces/kits/iot_flash.h

2.2、FLASH设备初始化：IoTFlashInit

unsigned int IoTFlashInit(void);

描述：

FLASH设备初始化。

参数：

无

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

hal_iot_flash.c文件在device/rockchip/rk2206/adapter/hals/iot_hardware/wifiiot_lite目录下。

unsigned int IoTFlashInit(void)
{
    return (FlashInit() == LZ_HARDWARE_SUCCESS) ? IOT_SUCCESS : IOT_FAILURE;
}

2.3、取消初始化FLASH设备：IoTFlashDeinit

unsigned int IoTFlashDeinit(void);

描述：

取消初始化FLASH设备。

参数：

无

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

hal_iot_flash.c文件在device/rockchip/rk2206/adapter/hals/iot_hardware/wifiiot_lite目录下。

unsigned int IoTFlashDeinit(void)
{
    return (FlashDeinit() == LZ_HARDWARE_SUCCESS) ? IOT_SUCCESS : IOT_FAILURE;
}

2.4、FLASH读操作：IoTFlashRead

unsigned int IoTFlashRead(unsigned int flashOffset, unsigned int size, unsigned char *ramData);

描述：

FLASH读操作。

参数：

参数	类型	描述
flashOffset	unsigned int	flash地址
size	unsigned int	长度
ramData	unsigned char *	数据指针

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

hal_iot_flash.c文件在device/rockchip/rk2206/adapter/hals/iot_hardware/wifiiot_lite目录下。

unsigned int IoTFlashRead(unsigned int flashOffset, unsigned int size, unsigned char *ramData)
{
    return (FlashRead(flashOffset, size, ramData) == LZ_HARDWARE_SUCCESS) ? IOT_SUCCESS : IOT_FAILURE;
}

2.5、FLASH写操作：IoTFlashWrite

unsigned int IoTFlashWrite(unsigned int flashOffset, unsigned int size, const unsigned char *ramData, unsigned char doErase);

描述：

FLASH写操作。

参数：

参数	类型	描述
flashOffset	unsigned int	flash地址
size	unsigned int	长度
ramData	unsigned char *	数据指针
doErase	unsigned char	无效位

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

hal_iot_flash.c文件在device/rockchip/rk2206/adapter/hals/iot_hardware/wifiiot_lite目录下。

unsigned int IoTFlashWrite(unsigned int flashOffset, unsigned int size, const unsigned char *ramData, unsigned char doErase)
{
    return (FlashWrite(flashOffset, size, ramData, doErase) == LZ_HARDWARE_SUCCESS) ? IOT_SUCCESS : IOT_FAILURE;
}

2.6、FLASH擦除操作：IoTFlashErase

unsigned int IoTFlashErase(unsigned int flashOffset, unsigned int size);

描述：

FLASH擦除操作。

参数：

参数	类型	描述
flashOffset	unsigned int	flash地址
size	unsigned int	长度

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

hal_iot_flash.c文件在device/rockchip/rk2206/adapter/hals/iot_hardware/wifiiot_lite目录下。

unsigned int IoTFlashErase(unsigned int flashOffset, unsigned int size)
{
    return (FlashErase(flashOffset, size) == LZ_HARDWARE_SUCCESS) ? IOT_SUCCESS : IOT_FAILURE;
}

3、程序设计

主要代码分析

在flash_example函数中，创建一个任务。

void flash_example(void)
{
    unsigned int ret = LOS_OK;
    unsigned int thread_id;
    TSK_INIT_PARAM_S task = {0};
​
    task.pfnTaskEntry = (TSK_ENTRY_FUNC)flash_thread;
    task.uwStackSize  = 1024 * 512;
    task.pcName       = "flash_thread";
    task.usTaskPrio   = 24;
    ret               = LOS_TaskCreate(&thread_id, &task);
    if (ret != LOS_OK) {
        printf("Falied to create flash_thread ret:0x%x\n", ret);
        return;
    }
}

4、编译调试

修改 vendor/lockzhiner/rk2206/sample 路径下 BUILD.gn 文件，指定 iot_flash_example 参与编译。

"./b21_iot_flash:iot_flash_example",

修改 device/lockzhiner/rk2206/sdk_liteos 路径下 Makefile 文件，添加 -iot_flash_example 参与编译。

hardware_LIBS = -lhal_iothardware -lhardware -lshellcmd -liot_flash_example

5、运行结果

示例代码编译烧录代码后，按下开发板的RESET按键，通过串口助手查看日志，显示如下：