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

1、实验简介

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

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

例程源代码：https://gitee.com/Lockzhiner-Electronics/lockzhiner-rk2206-openharmony3.0lts/tree/master/vendor/lockzhiner/rk2206/samples/b21_iot_flash

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按键，通过串口助手查看日志，显示如下：

entering kernel init...
hilog will init.
[MAIN:D]Main: LOS_Start ...
Entering scheduler
OHOS # hiview init success.[FLASH:E]FlashDeinit: id 0, controller has NOT been initialized
[FLASH:I]FlashInit: blockSize 4096, blockStart 0, blockEnd 8388608
Flash erase: address = 0x700000, length = 0x1000
Flash write: address = 0x700000, length = 0x1000, ch = a
Flash read: address = 0x700000, length = 0x1000
    [0] = a
    [1] = a
    [2] = a
    [3] = a
    [4] = a
    [5] = a
    [6] = a
    [7] = a
    [8] = a
    [9] = a
    [10] = a
    [11] = a
    [12] = a
    [13] = a
    [14] = a
    [15] = a
Flash erase: address = 0x700000, length = 0x1000
Flash write: address = 0x700000, length = 0x1000, ch = b
Flash read: address = 0x700000, length = 0x1000
    [0] = b
    [1] = b
    [2] = b
    [3] = b
    [4] = b
    [5] = b
    [6] = b
    [7] = b
    [8] = b
    [9] = b
    [10] = b
    [11] = b
    [12] = b
    [13] = b
    [14] = b
    [15] = b