在Hi3516DV300开发板搭载鸿蒙OS实现一个简单的Helloworld程序

 

Linux环境

1.   目标

 

理解HarmonyOS驱动框架，用户态APP和内核态驱动之间的通信机制。

具体运行结果为用户态APP向驱动发送123号cmd，内核态读取该cmd对应的字符串data，并打印出来。然后内核态驱动程序向用户态发送事件，传递的参数为reply。用户态APP通过事件监听函数获取内核态发送的消息打印出来。

2.   编写驱动程序

 

这跟Linux的驱动框架不一样，在Linux中，APP打开设备节点后，APP调用的read函数会直接进入内核态调用驱动的read函数。
在liteos-a中使用HDF时，APP需要先获得服务，然后调用服务的Dispatch函数：它可以向驱动发送数据、获得返回结果。

 

2.1 编写驱动

在HDF中，一个驱动被抽象为“HdfDriverEntry”，代码如下：

上述代码中，使用HDF_INIT定义了某些段属性的结构体，内核启动后会注册这个HdfDriverEntry。

重要的是其中的Bind函数，Init和Release函数顾名思义就是初始化和释放相关资源，这里好像和HDF_INIT有些冲突，示例函数用空函数来替代它们了。代码如下：

2.2 驱动服务函数的实现

在驱动初始化函数HdfSampLEDriverBind中会绑定一个服务函数，这个服务函数用来处理用户态APP发送过来的消息。绑定过程是给IDeviceIoService这个结构体的Dispatch元素赋值来实现的。如图所示：

你可以认为Dispatch函数相当于ioctl，在Linux中通过ioctl(fd, cmd, arg)来操作驱动。

在liteos-a中通过service->>dispatcher->Dispatch(ojb, cmd, data, replay)来操作驱动。把驱动放入内核

 

3.   把驱动源码放入内核3.1  驱动代码放进目录

3.1.1   把代码放入目录：

vendor/huawei/hdf/sampleKconfig如下：Makefile如下：如下图增加最后一行：

上一级的Kconfig：

source "../../vendor/hisi/hi35xx/platform/Kconfig"
source "../../vendor/huawei/hdf/wifi/driver/Kconfig"
source "../../vendor/huawei/hdf/input/driver/Kconfig"
source "../../vendor/huawei/hdf/display/driver/Kconfig"
source "../../vendor/huawei/hdf/sample/Kconfig"

 

3.2  修改hcs文件

3.2.1   增加sample_config.hcs文件目录：

 

vendor/hisi/hi35xx/ hi3516dv300/config /sample/sample_config.hcs：

源码：

root {
    module = "sample_driver";
    author = "zhangfeidz for test";
    serviceName = "sample_service";

 

3.2.2   在上级hcs中引用sample_config.hcs文件3.2.3    在全局设备节点中增加device_sample节点目录：

 

vendor/hisi/hi35xx/ hi3516dv300/config /device_info/device_info.hcs：3.3   修改mk文件

目录：vendor/huawei/hdf/hdf_vendor.mk:增加2行：

 

4.   编写APP

 

APP先获得服务，在调用Dispatch即可。需要注意的是里面用的是HdfSBuf传递数据。以下是hello_test.c的源码。

 

4.1 绑定服务注册监听机制及设置回调函数

 

4.2  调用内核服务函数

要分配两个HdfBuf：data、reply。data用于向驱动传参数，reply用来保存驱动返回的数据。
代码如下

4.3  取出内核发送过来的数据

4.4   内核驱动初始化（绑定）服务程序4.5  读取用户态程序（sample_test）发送过来的消息并向用户态发送响应消息

4.6   源码5.   把APP源码放入BUILD.gn文件

 

先在整个系统源码的根目录下创建一个子目录，比如myapp，在里面放入sample_test.c。
再修改drivers/hdf/lite/manager/BUILD.gn。源码如下：

import("//build/lite/config/component/lite_component.gni")

HDF_FRAMEWORKS = "//drivers/hdf/frameworks"

shared_library("hdf_core") {
    sources = [
        "$HDF_FRAMEWORKS/core/shared/src/hdf_io_service.c",
        "$HDF_FRAMEWORKS/ability/sbuf/src/hdf_sbuf.c",
        "../adapter/syscall/src/hdf_syscall_adapter.c"
    ]

    include_dirs = [
        "../adapter/syscall/include",
        "../adapter/vnode/include",
        "$HDF_FRAMEWORKS/core/shared/include",
        "$HDF_FRAMEWORKS/core/host/include",
        "$HDF_FRAMEWORKS/core/manager/include",
        "$HDF_FRAMEWORKS/ability/sbuf/include",
        "$HDF_FRAMEWORKS/include/core",
        "$HDF_FRAMEWORKS/include/utils",
        "$HDF_FRAMEWORKS/utils/include",
        "$HDF_FRAMEWORKS/include/osal",
        "//third_party/bounds_checking_function/include",
    ]

    deps = [
        "//drivers/hdf/lite/adapter/osal/posix:hdf_posix_osal",
        "//third_party/bounds_checking_function:libsec_shared",
    ]

    defines = [
        "__USER__",
    ]

    cflags = [
        "-Wall",
        "-Wextra",
        "-Werror",
        "-fsigned-char",
        "-fno-common",
        "-fno-strict-aliasing",
    ]
}


executable("sample_test") {
    sources = [
        "//myapp/sample_test.c"
    ]

    include_dirs = [
        "../adapter/syscall/include",
        "../adapter/vnode/include","$HDF_FRAMEWORKS/ability/sbuf/include",
        "$HDF_FRAMEWORKS/core/shared/include",
        "$HDF_FRAMEWORKS/core/host/include",
        "$HDF_FRAMEWORKS/core/master/include",
        "$HDF_FRAMEWORKS/include/core",
        "$HDF_FRAMEWORKS/include/utils",
        "$HDF_FRAMEWORKS/utils/include",
        "$HDF_FRAMEWORKS/include/osal",
        "//third_party/bounds_checking_function/include",
    ]

    deps = [
        "//drivers/hdf/lite/manager:hdf_core",
        "//drivers/hdf/lite/adapter/osal/posix:hdf_posix_osal",
    ]

    public_deps = [
        "//third_party/bounds_checking_function:libsec_shared",
    ]
    defines = [
        "__USER__",
    ]

    cflags = [
        "-Wall",
        "-Wextra",
        "-Werror",
    ]
}

lite_component("hdf_manager") {
    features = [
        ":hdf_core",
        ":sample_test",
    ]
}

 

sample_test.c文件信息加入BUILD.gn文件后，编译系统时，就会按照指定的规则（程序源码，编译依赖，生成可执行程序的名字，以及可执行程序在HarmonyOS系统中的目录）进行编译。

 

6.   编译、烧写、测试6.1 编译

Hi3516dv300开发板：python build.py ipcamera_hi3516dv300 -b debug
Hi3518ev300开发板：python build.py ipcamera_hi3518ev300 -b debug
Hi3516dv300开发板：python build.pyipcamera –p hi3516dv300_liteos_a
Hi3518ev300开发板：python build.pyipcamera –p hi3518ev300_liteos_a

 

6.1  烧写6.1.1    烧写文件所在目录：out/ipcamera_hi3516dv300_liteos_a/6.1.2   烧写文件6.1.2.1 操作系统文件：OHOS_Image.bin6.1.2.2 文件系统文件（光盘镜像文件）:rootfs6.1.2.3 用户文件（光盘镜像文件）:useRFs

网口烧录配置

 

6.2   测试6.2.1   Uboot设置

 

在uboot里面输入命令，配置启动设置，具体方法如下。

命令1：

Hi3516dv300开发板：
setenv bootcmd 'sf probe 0;sf read 0x80000000 0x100000 0x600000;go 0x80000000';saveenv;
Hi3518ev300开发板：
setenv bootcmd 'sf probe 0;sf read 0x40000000 0x100000 0x600000;go 0x40000000';saveenv;

 

这条命令作用是选择从0x80000000（或者0x40000000）这个地址启动HarmonyOS。在flash内部，0x100000是起始地址，0x6000000是OHOS_Image.bin的大小（本示例中，该文档大小为6M）

 

命令2：
setenv bootargs "ttyAMA0,115200n8root=flash fstype=jffs2 rw rootaddr=7M rootsize=8M";saveenv;
该命令的作用是进行串口配置。rootaddr是文件系统的起始地址，rootsize是文件的大小。实际开发时，请具体情况具体分析。

配置完成后，输入命令 go 0x80000000，就可以进入鸿蒙系统了。

6.2.2   测试结果

 

鸿蒙系统目录结构如下：

进入bin文件夹，运行sample_test程序：