HDF驱动开发流程解析

#include "hdf_device_desc.h"          // HDF框架对驱动开发相关能力接口的头文件
#include "hdf_log.h"                  // HDF框架提供的日志接口头文件
#define HDF_LOG_TAG "sample_driver"   // 打印日志所包含的标签，如果不定义则用默认定义的HDF_TAG标签。
// 驱动对外提供的服务能力，将相关的服务接口绑定到HDF框架。
int32_t HdfSampleDriverBind(struct HdfDeviceObject *deviceObject)
{
    HDF_LOGD("Sample driver bind success");
    return 0;
}
// 驱动自身业务初始化的接口
int32_t HdfSampleDriverInit(struct HdfDeviceObject *deviceObject)
{
    HDF_LOGD("Sample driver Init success");
    return 0;
}
// 驱动资源释放的接口
void HdfSampleDriverRelease(struct HdfDeviceObject *deviceObject)
{
    HDF_LOGD("Sample driver release success");
    return;
}

// 定义驱动入口的对象，必须为HdfDriverEntry（在hdf_device_desc.h中定义）类型的全局变量。
struct HdfDriverEntry g_sampleDriverEntry = {
    .moduleVersion = 1,
    .moduleName = "sample_driver",
    .Bind = HdfSampleDriverBind,
    .Init = HdfSampleDriverInit,
    .Release = HdfSampleDriverRelease,
};
// 调用HDF_INIT将驱动入口注册到HDF框架中。在加载驱动时HDF框架会先调用Bind函数，再调用Init函数加载该驱动；当Init调用异常时，HDF框架会调用Release释放驱动资源并退出。
HDF_INIT(g_sampleDriverEntry);

// Initialize the driver service.
static int32_t HdfHelloLiteosDriverInit(struct HdfDeviceObject *deviceObject) {
    HDF_LOGI("Hello LiteOS");
    GpioSetDir(19,GPIO_DIR_OUT);//引脚设置为输出
    GpioWrite(19,GPIO_VAL_HIGH);//输出高电平，绿色LED亮
    return 0;
}

// Initialize the driver service.
static int32_t HdfHelloLinuxDriverInit(struct HdfDeviceObject *deviceObject) {
    HDF_LOGI("Hello Linux");
    GpioSetDir(41,GPIO_DIR_OUT);//引脚设置为输出
    GpioWrite(41,GPIO_VAL_HIGH);//输出高电平，红外灯亮
    return 0;
}

include $(LITEOSTOPDIR)/../../drivers/adapter/khdf/liteos/lite.mk#导入hdf预定义内容
HELLO_LITEOS_ROOT_DIR = $(LITEOSTOPDIR)/../../drivers/framework/model/hello_liteos
ifeq ($(LOSCFG_DRIVERS_HDF_HELLO_LITEOS), y)
MODULE_NAME := hdf_hello_liteos_driver #生成的结果文件
LOCAL_INCLUDE := $(HELLO_LITEOS_ROOT_DIR)/../../../../../third_party/FreeBSD/sys/dev/evdev#本驱动的头文件目录
LOCAL_SRCS += $(HELLO_LITEOS_ROOT_DIR)/driver/hello_liteos_driver.c#本驱动的源代码文件
endif
include $(HDF_DRIVER)#导入Makefile模板完成编译

ifeq ($(LOSCFG_DRIVERS_HDF_HELLO_LITEOS), y)
    LITEOS_BASELIB += -lhdf_hello_liteos_driver #链接生成的静态库
    LIB_SUBDIRS    += $(LITEOS_DRIVERS_HDF)/model/hello_liteos #驱动代码Makefile的目录
endif

import("//drivers/adapter/khdf/liteos/hdf.gni")
module_switch = defined(LOSCFG_DRIVERS_HDF_HELLO_LITEOS)
module_name = "hdf_hello_liteos_driver"#模块名
hdf_driver(module_name) {
  FRAMEWORKS_HELLO_LITEOS_ROOT = "$HDF_FRAMEWORKS_PATH/model/hello_liteos"
  #模块要编译的源码文件
  sources = ["$FRAMEWORKS_HELLO_LITEOS_ROOT/driver/hello_liteos_driver.c"]
  #依赖的头文件目录 
  include_dirs = [
    "//third_party/FreeBSD/sys/dev/evdev/"
  ]
}

import("//drivers/adapter/khdf/liteos/hdf.gni")

module_group("model") {
  modules = [
    "audio",
    "bus/usb",
    "display",
    "input",
    "hello_liteos", //新增模块
    "misc/dsoftbus",
    "misc/light",
    "misc/vibrator",
    "network/ethernet",
    "network/wifi",
    "sensor",
    "storage",
    "usb/device",
    "usb/host",
  ]
}

HELLO_LINUX_ROOT_DIR = ../../../../../framework/model/hello_linux/driver
obj-$(CONFIG_DRIVERS_HDF_HELLO_LINUX) += \
               $(HELLO_LINUX_ROOT_DIR)/hello_linux_driver.o##将hello_linux_driver.o文件编译
ccflags-y += -I$(srctree)/drivers/hdf/framework/include/core \
             -I$(srctree)/drivers/hdf/framework/core/common/include/host \
             -I$(srctree)/drivers/hdf/framework/include/utils \
             -I$(srctree)/drivers/hdf/framework/include/osal \
             -I$(srctree)/drivers/hdf/framework/ability/sbuf/include \
             -I$(srctree)/drivers/hdf/framework/include/platform \
             -I$(srctree)/drivers/hdf/framework/include/config \
             -I$(srctree)/drivers/hdf/framework/core/host/include \
             -I$(srctree)/drivers/hdf/framework/core/shared/include \
             -I$(srctree)/drivers/hdf/framework/utils/include \
             -I$(srctree)/drivers/hdf/khdf/osal/include
ccflags-y +=-I$(srctree)/bounds_checking_function/include \
            -I$(srctree)/drivers/hdf/evdev

obj-$(CONFIG_DRIVERS_HDF) += manager/
obj-$(CONFIG_DRIVERS_HDF_PLATFORM) += platform/
obj-$(CONFIG_DRIVERS_HDF_DISP) += model/display/
obj-$(CONFIG_DRIVERS_HDF_INPUT) += model/input/
obj-$(CONFIG_DRIVERS_HDF_WIFI) += model/network/wifi/
obj-$(CONFIG_DRIVERS_HDF_USB_PNP_NOTIFY) += model/usb/host/
obj-$(CONFIG_DRIVERS_HDF_USB_F_GENERIC) += model/usb/device/
obj-$(CONFIG_DRIVERS_HDF_SENSOR) += model/sensor/
obj-$(CONFIG_DRIVERS_HDF_STORAGE) += model/storage/
obj-$(CONFIG_DRIVERS_HDF_BT) += model/network/bluetooth/
obj-$(CONFIG_DRIVERS_HDF_LIGHT) += model/misc/light/
obj-$(CONFIG_DRIVERS_HDF_VIBRATOR) += model/misc/vibrator/
obj-$(CONFIG_DRIVERS_HDF_AUDIO) += model/audio/
obj-$(CONFIG_DRIVERS_HDF_DSOFTBUS) += model/misc/dsoftbus/
obj-$(CONFIG_DRIVERS_HDF_HELLO_LINUX) += model/hello_linux/#新增的模块目录

sample_host :: host{
            hostName = "host0";    // host名称，host节点是用来存放某一类驱动的容器。
            priority = 100;        // host启动优先级（0-200），值越大优先级越低，建议默认配100，优先级相同则不保证host的加载顺序。
            caps = ["DAC_OVERRIDE", "DAC_READ_SEARCH"];   // 用户态进程Linux capabilities配置。
            device_sample :: device {        // sample设备节点
                device0 :: deviceNode {      // sample驱动的DeviceNode节点
                    policy = 1;              // policy字段是驱动服务发布的策略，在驱动服务管理章节有详细介绍。
                    priority = 100;          // 驱动启动优先级（0-200），值越大优先级越低，建议默认配100，优先级相同则不保证device的加载顺序。
                    preload = 0;             // 驱动按需加载字段，在本章节最后的说明有详细介绍。
                    permission = 0664;       // 驱动创建设备节点权限
                    moduleName = "sample_driver";      // 驱动名称，该字段的值必须和驱动入口结构的moduleName值一致。
                    serviceName = "sample_service";    // 驱动对外发布服务的名称，必须唯一。
                    deviceMatchAttr = "sample_config"; // 驱动私有数据匹配的关键字，必须和驱动私有数据配置表中的match_attr值相等。
                }
            }
        }

root {
    SampleDriverConfig {
        sample_version = 1;
        sample_bus = "I2C_0";
        match_attr = "sample_config";   // 该字段的值必须和device_info.hcs中的deviceMatchAttr值一致
    }
}

#include "device_info/device_info.hcs"
#include "sample/sample_config.hcs"