基于小凌派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

unsignedintIoTFlashInit(void);

描述：

FLASH设备初始化。

参数：

无

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

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

unsignedintIoTFlashInit(void)
{
    return (FlashInit() ==LZ_HARDWARE_SUCCESS) ?IOT_SUCCESS : IOT_FAILURE;
}

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

unsignedintIoTFlashDeinit(void);

描述：

取消初始化FLASH设备。

参数：

无

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

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

unsignedintIoTFlashDeinit(void)
{
    return (FlashDeinit() ==LZ_HARDWARE_SUCCESS) ?IOT_SUCCESS : IOT_FAILURE;
}

2.4、FLASH读操作：IoTFlashRead

unsignedintIoTFlashRead(unsignedintflashOffset, unsignedintsize, unsignedchar*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目录下。

unsignedintIoTFlashRead(unsignedintflashOffset, unsignedintsize, unsignedchar*ramData)
{
    return (FlashRead(flashOffset, size, ramData) ==LZ_HARDWARE_SUCCESS) ?IOT_SUCCESS : IOT_FAILURE;
}

2.5、FLASH写操作：IoTFlashWrite

unsignedintIoTFlashWrite(unsignedintflashOffset, unsignedintsize, constunsignedchar*ramData, unsignedchardoErase);

描述：

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目录下。

unsignedintIoTFlashWrite(unsignedintflashOffset, unsignedintsize, constunsignedchar*ramData, unsignedchardoErase)
{
    return (FlashWrite(flashOffset, size, ramData, doErase) ==LZ_HARDWARE_SUCCESS) ?IOT_SUCCESS : IOT_FAILURE;
}

2.6、FLASH擦除操作：IoTFlashErase

unsignedintIoTFlashErase(unsignedintflashOffset, unsignedintsize);

描述：

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目录下。

unsignedintIoTFlashErase(unsignedintflashOffset, unsignedintsize)
{
    return (FlashErase(flashOffset, size) ==LZ_HARDWARE_SUCCESS) ?IOT_SUCCESS : IOT_FAILURE;
}

3、程序设计

主要代码分析

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

voidflash_example(void)
{
    unsignedintret=LOS_OK;
    unsignedintthread_id;
    TSK_INIT_PARAM_Stask= {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按键，通过串口助手查看日志，显示如下：

enteringkernelinit...
hilogwillinit.
[MAIN:D]Main:LOS_Start...
Enteringscheduler
OHOS# hiview init success.[FLASH:E]FlashDeinit: id 0, controller has NOT been initialized
[FLASH:I]FlashInit:blockSize4096, blockStart0, blockEnd8388608
Flasherase:address=0x700000, length=0x1000
Flashwrite:address=0x700000, length=0x1000, ch=a
Flashread: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
Flasherase:address=0x700000, length=0x1000
Flashwrite:address=0x700000, length=0x1000, ch=b
Flashread: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