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

1、案例简介

本案例主要是如何在小凌派-RK2206开发板上使用IOT库的GPIO接口，进行GPIO编程开发。

例程将创建一个任务，通过配置GPIO引脚，实现GPIO读写操作。

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

2、基础知识

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

2.1、头文件

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

2.2、初始化GPIO设备：IoTGpioInit

unsignedintIoTGpioInit(unsignedintid);

描述：

初始化GPIO设备。

参数：

参数	类型	描述
id	unsigned int	GPIOID编号

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

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

unsignedintIoTGpioInit(unsignedintid)
{
unsignedintret=0;

if(id>GPIO0_PC7&&id!=GPIO1_PD0) {
PRINT_ERR("id(%d) > %d || id(%d) != %d\n",id,GPIO0_PC7,GPIO1_PD0);
returnIOT_FAILURE;
}

ret=LzGpioInit(id);
if(ret!=LZ_HARDWARE_SUCCESS) {
returnIOT_FAILURE;
}

ret=PinctrlSet(id,MUX_FUNC0,PULL_KEEP,DRIVE_LEVEL0);
if(ret!=LZ_HARDWARE_SUCCESS) {
returnIOT_FAILURE;
}

returnIOT_SUCCESS;
}

2.3、取消初始化GPIO设备：IoTGpioDeinit

unsignedintIoTGpioDeinit(unsignedintid);

描述：

取消初始化GPIO设备。

参数：

参数	类型	描述
id	unsigned int	GPIOID编号

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

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

unsignedintIoTGpioDeinit(unsignedintid)
{
unsignedintret=0;

if(id>GPIO0_PC7&&id!=GPIO1_PD0) {
PRINT_ERR("id(%d) > %d || id(%d) != %d\n",id,GPIO0_PC7,GPIO1_PD0);
returnIOT_FAILURE;
}

ret=LzGpioDeinit(id);
if(ret!=LZ_HARDWARE_SUCCESS) {
returnIOT_FAILURE;
}

returnIOT_SUCCESS;
}

2.4、设置GPIO引脚的方向：IoTGpioSetDir

unsignedintIoTGpioSetDir(unsignedintid,IotGpioDirdir);

描述：

设置GPIO引脚的方向。

参数：

参数	类型	描述
id	unsigned int	GPIOID编号
dir	IotGpioDir	GPIO方向

其中，dir对应于如下表所示：

IotGpioDir	描述
IOT_GPIO_DIR_IN	输入
IOT_GPIO_DIR_OUT	输出

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

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

unsignedintIoTGpioSetDir(unsignedintid,IotGpioDirdir)
{
unsignedintret=0;

if(id>GPIO0_PC7&&id!=GPIO1_PD0) {
PRINT_ERR("id(%d) > %d || id(%d) != %d\n",id,GPIO0_PC7,GPIO1_PD0);
returnIOT_FAILURE;
}

ret=LzGpioSetDir(id, (LzGpioDir)dir);
if(ret!=LZ_HARDWARE_SUCCESS) {
returnIOT_FAILURE;
}

returnIOT_SUCCESS;
}

2.5、获取GPIO引脚的方向：IoTGpioGetDir

unsignedintIoTGpioGetDir(unsignedintid,IotGpioDir*dir);

描述：

获取GPIO引脚的方向。

参数：

参数	类型	描述
id	unsigned int	GPIOID编号
dir	IotGpioDir *	GPIO方向指针

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

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

unsignedintIoTGpioGetDir(unsignedintid,IotGpioDir*dir)
{
unsignedintret=0;

if(id>GPIO0_PC7&&id!=GPIO1_PD0) {
PRINT_ERR("id(%d) > %d || id(%d) != %d\n",id,GPIO0_PC7,GPIO1_PD0);
returnIOT_FAILURE;
}

ret=LzGpioGetDir(id, (LzGpioDir*)dir);
if(ret!=LZ_HARDWARE_SUCCESS) {
returnIOT_FAILURE;
}

returnIOT_SUCCESS;
}

2.6、设置GPIO引脚的输出电平值：IoTGpioSetOutputVal

unsignedintIoTGpioSetOutputVal(unsignedintid,IotGpioValueval);

描述：

设置GPIO引脚的输出电平值。

参数：

参数	类型	描述
id	unsigned int	GPIOID编号
val	IotGpioValue	电平

其中，val对应于如下表所示：

IotGpioValue	描述
IOT_GPIO_VALUE0	低电平
IOT_GPIO_VALUE1	高电平

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

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

unsignedintIoTGpioSetOutputVal(unsignedintid,IotGpioValueval)
{
unsignedintret=0;

if(id>GPIO0_PC7&&id!=GPIO1_PD0) {
PRINT_ERR("id(%d) > %d || id(%d) != %d\n",id,GPIO0_PC7,GPIO1_PD0);
returnIOT_FAILURE;
}

ret=LzGpioSetVal(id, (LzGpioValue)val);
if(ret!=LZ_HARDWARE_SUCCESS) {
returnIOT_FAILURE;
}

returnIOT_SUCCESS;
}

2.7、获取GPIO引脚的输出电平值：IoTGpioGetOutputVal

unsignedintIoTGpioGetOutputVal(unsignedintid,IotGpioValue*val);

描述：

获取GPIO引脚的输出电平值。

参数：

参数	类型	描述
id	unsigned int	GPIOID编号
val	IotGpioValue *	电平指针

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

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

unsignedintIoTGpioGetOutputVal(unsignedintid,IotGpioValue*val)
{
unsignedintret=0;

if(id>GPIO0_PC7&&id!=GPIO1_PD0) {
PRINT_ERR("id(%d) > %d || id(%d) != %d\n",id,GPIO0_PC7,GPIO1_PD0);
returnIOT_FAILURE;
}

ret=LzGpioGetVal(id, (LzGpioValue*)val);
if(ret!=LZ_HARDWARE_SUCCESS) {
returnIOT_FAILURE;
}

returnIOT_SUCCESS;
}

2.8、获取GPIO引脚的输入电平值：IoTGpioGetInputVal

unsignedintIoTGpioGetInputVal(unsignedintid,IotGpioValue*val);

描述：

获取GPIO引脚的输入电平值。

参数：

参数	类型	描述
id	unsigned int	GPIOID编号
val	IotGpioValue *	电平指针

返回值：

返回值	描述
IOT_SUCCESS	成功
IOT_FAILURE	失败

实现：

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

unsignedintIoTGpioGetInputVal(unsignedintid,IotGpioValue*val)
{
unsignedintret=0;

if(id>GPIO0_PC7&&id!=GPIO1_PD0) {
PRINT_ERR("id(%d) > %d || id(%d) != %d\n",id,GPIO0_PC7,GPIO1_PD0);
returnIOT_FAILURE;
}

ret=LzGpioGetVal(id, (LzGpioValue*)val);
if(ret!=LZ_HARDWARE_SUCCESS) {
returnIOT_FAILURE;
}

returnIOT_SUCCESS;
}

3、程序设计

主要代码分析

gpio_example函数中，创建一个任务。

voidgpio_example()
{
unsignedintthread_id;
TSK_INIT_PARAM_Stask={0};
unsignedintret =LOS_OK;

task.pfnTaskEntry=(TSK_ENTRY_FUNC)gpio_thread;
task.uwStackSize =2048;
task.pcName ="gpio_thread";
task.usTaskPrio =24;
ret =LOS_TaskCreate(&thread_id,&task);
if(ret!=LOS_OK) {
printf("Falied to create gpio_thread ret:0x%x\n",ret);
return;
}
}

gpio_thread任务中调用IOT库的GPIO接口初始化、配置、读写GPIO。

voidgpio_thread()
{
unsignedintcur =0;
IotGpioValuevalue=IOT_GPIO_VALUE0;

IoTGpioInit(GPIO_TEST);

while(1) {
printf("***************GPIO Example*************\r\n");
printf("Write GPIO\n");
IoTGpioSetDir(GPIO_TEST,IOT_GPIO_DIR_OUT);
if(cur==0) {
IoTGpioSetOutputVal(GPIO_TEST,cur);
IoTGpioGetOutputVal(GPIO_TEST,&value);
printf("\tgpio set %d => gpio get %d\n",cur,value);
cur=1;
}else{
IoTGpioSetOutputVal(GPIO_TEST,cur);
IoTGpioGetOutputVal(GPIO_TEST,&value);
printf("\tgpio set %d => gpio get %d\n",cur,value);
cur=0;
}
/* 睡眠1秒 */
LOS_Msleep(1000);

printf("Read GPIO\n");
IoTGpioSetDir(GPIO_TEST,IOT_GPIO_DIR_IN);
IoTGpioGetInputVal(GPIO_TEST,&value);
printf("\tgpio get %d\n",value);
/* 睡眠1秒 */
LOS_Msleep(1000);

printf("\n");
}
}

4、编译调试

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

"./b18_iot_gpio:iot_gpio_example",

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

hardware_LIBS=-lhal_iothardware-lhardware-lshellcmd-liot_gpio_example

5、运行结果

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

***************GPIOExample*************
WriteGPIO
gpioset0=>gpioget0
ReadGPIO
gpioget0

***************GPIOExample*************
WriteGPIO
gpioset1=>gpioget1
ReadGPIO
gpioget1