學習于:
https://docs.openharmony.cn/pages/v5.0/zh-cn/device-dev/driver/driver-platform-gpio-develop.md
https://docs.openharmony.cn/pages/v5.0/zh-cn/device-dev/driver/driver-platform-gpio-des.md
通過OpenHarmony官方文檔指導可獲知:芯片廠商應當按照系統的平臺驅動接口實現GPIO控制器驅動后,設備開發人員就可以按照系統GPIO的HDI接口使用GPIO,具體接口函數有:
其中函數參數gpioName指定IO口名,gpio指定IO口的ID,參數具體值由芯片廠商在.hcs配置文件中描述,如海思Hi3516中GPIO控制器驅動的描述:
Hi3516 GPIO控制器驅動自定義屬性的描述:
其中屬性groupNum指定Hi3516共有12組IO口,bitNum指定每組有8個IO口,由0 ~ 95數值分別表示96個IO,如GPIO2_3,則由數值19表示(2*8 + 3 = 19)。
屬性gpioCustomName指定IO口的名稱,依此名稱可通過函數GpioGetByName獲取IO口對應的ID。
接下來通過應用GPIO實現LED驅動:
開發板LED原理圖
通過原理圖可發現有: GPIO2_3 GPIO3_4 GPIO5_1控制LED的工作。
簡單的LED驅動
在上篇簡單的HDF驅動驅動源碼基礎上加入控制一個LED的代碼,具體驅動源碼:
#include <hdf_device_desc.h>
#include <hdf_log.h>
#include <hdf_base.h>
#include <gpio_if.h> // GPIO驅動調用接口static int idGpio = 0;static int32_t myDispatch(struct HdfDeviceIoClient *client, int id, struct HdfSBuf *data, struct HdfSBuf *reply)
{HDF_LOGD("### in %s : %d\n", __func__, id);GpioWrite(idGpio, id%2); //配置GPIO輸出高低電平return HDF_SUCCESS;
}int32_t myBind(struct HdfDeviceObject *obj)
{static struct IDeviceIoService testService = {.Dispatch = myDispatch,};obj->service = &testService;HDF_LOGD("#### in %s\n", __func__);idGpio = GpioGetByName("GPIO2_3"); //獲取GPIO的IDGpioSetDir(idGpio, GPIO_DIR_OUT); //配置GPIO作輸出用途return HDF_SUCCESS;
}
int32_t myInit(struct HdfDeviceObject *obj)
{HDF_LOGD("#### in %s\n", __func__);return HDF_SUCCESS;
}
void myRelease(struct HdfDeviceObject *obj)
{HDF_LOGD("#### in %s\n", __func__);
}struct HdfDriverEntry myTestEntry = {.Bind = myBind,.Init = myInit,.Release = myRelease,.moduleName = "myTestDriver",.moduleVersion = 1
};
HDF_INIT(myTestEntry);
沿用上篇里的應用程序,當應用程序執行起來后,開發板的LED會在GPIO輸出高電平時亮,低電平時熄。
硬件資源分離與可重用的LED驅動
按照OpenHarmony文檔指導,硬件相關的資源應當在.hcs配置文件中描述。這里三個LED分別作為一個設備進行描述 :
然后在vendor/hisilicon/hispark_taurus/hdf_config/目錄下創建myLight文件夾,并在文件夾里創建myLight.hcs配置文件,描述設備自定義的屬性:
每個節點通過match_attr與設備節點的deviceMatchAttr進行匹配,相同值表示此節點資源由對應的設備使用。 gpioName自定義屬性向LED驅動提供LED設備的控制IO。
然后修改vendor/hisilicon/hispark_taurus/hdf_config/hdf.hcs配置文件,增加myLight.hcs文件的使用:
驅動源文件myTestDriver.c代碼修改為:
#include <hdf_device_desc.h>
#include <hdf_log.h>
#include <hdf_base.h>
#include <gpio_if.h>
#include <device_resource_if.h>
#include <osal_mem.h>struct myLightService {struct IDeviceIoService service;int idGpio;const char *gpioName;
};static int32_t myDispatch(struct HdfDeviceIoClient *client, int id, struct HdfSBuf *data, struct HdfSBuf *reply)
{struct HdfDeviceObject *obj = client->device;struct myLightService *srv = (struct myLightService *)(obj->service);HDF_LOGD("### in %s, %s %d\n", __func__, srv->gpioName, id);GpioWrite(srv->idGpio, !!id);return HDF_SUCCESS;
}int32_t myBind(struct HdfDeviceObject *obj)
{struct myLightService *srv = NULL;struct DeviceResourceIface *dr = DeviceResourceGetIfaceInstance(HDF_CONFIG_SOURCE);srv = OsalMemCalloc(sizeof(struct myLightService));dr->GetString(obj->property, "gpioName", &srv->gpioName, NULL);srv->service.Dispatch = myDispatch;srv->idGpio = GpioGetByName(srv->gpioName);GpioSetDir(srv->idGpio, GPIO_DIR_OUT);obj->service = &srv->service;return HDF_SUCCESS;
}
int32_t myInit(struct HdfDeviceObject *obj)
{return HDF_SUCCESS;
}
void myRelease(struct HdfDeviceObject *obj)
{struct myLightService *srv = (struct myLightService *)(obj->service);OsalMemFree(srv);
}struct HdfDriverEntry myTestEntry = {.Bind = myBind,.Init = myInit,.Release = myRelease,.moduleName = "myTestDriver",.moduleVersion = 1
};
HDF_INIT(myTestEntry);
應用程序mytest.c代碼修改為:
#include <fcntl.h>
#include <sys/stat.h>
#include <sys/ioctl.h>
#include <unistd.h>
#include "hdf_log.h"
#include "hdf_sbuf.h"
#include "hdf_io_service_if.h"int main(int argc, char *argv[])
{if (3 != argc){printf("usage: %s serviceName num \n", argv[0]);return 1;}struct HdfIoService *srv = HdfIoServiceBind(argv[1]);if (srv == NULL) {printf("fail to get service\n");return 1;}int ret = srv->dispatcher->Dispatch(&srv->object, atoi(argv[2]), NULL, NULL);printf("test end\n");HdfIoServiceRecycle(srv);return 0;
}
應用程序執行時通過指定不同的服務名與電平值控制LED,如:
./bin/mytest myTestService0 1 ./bin/mytest myTestService1 1