OpenHarmony外设驱动移植指南

往期推文全新看点（文中附带最新·鸿蒙全栈学习笔记）

鸿蒙（HarmonyOS）北向开发知识点记录~

鸿蒙（OpenHarmony）南向开发保姆级知识点汇总~

鸿蒙应用开发与鸿蒙系统开发哪个更有前景？

嵌入式开发适不适合做鸿蒙南向开发？看完这篇你就了解了~

对于大前端开发来说，转鸿蒙开发究竟是福还是祸？

鸿蒙岗位需求突增！移动端、PC端、IoT到底该怎么选？

记录一场鸿蒙开发岗位面试经历~

持续更新中……

---

外设驱动子系统提供 OpenHarmony 专有的外部设备操作接口。本模块提供设备操作接口有：FLASH, GPIO, I2C, PWM, UART, WATCHDOG 等。

OpenHarmony 提供了两种驱动适配方式：使用外设驱动子系统、使用 HDF 驱动框架。由于轻量级系统的资源有限，这里建议使用 IOT 子系统方式。

移植指导

厂商需要根据 OpenHarmony 提供的接口定义实现其功能，IOT 子系统接口定义的头文件如下：

base/iot_hardware/peripheral/
├── BUILD.gn
└── interfaces
    └── kits
        ├── iot_errno.h
        ├── iot_flash.h
        ├── iot_gpio.h
        ├── iot_i2c.h
        ├── iot_pwm.h
        ├── iot_uart.h
        ├── iot_watchdog.h
        ├── lowpower.h
        └── reset.h

其中“base/iot_hardware/peripheral/BUILD.gn”文件如下：

import("//build/lite/config/subsystem/lite_subsystem.gni")
import("//build/lite/ndk/ndk.gni")
lite_subsystem("iothardware") {
  subsystem_components = [
    "$ohos_vendor_adapter_dir/hals/iot_hardware/wifiiot_lite:hal_iothardware",
  ]
}
if (ohos_kernel_type == "liteos_m") {
  ndk_lib("iothardware_ndk") {
    deps = [
      "$ohos_vendor_adapter_dir/hals/iot_hardware/wifiiot_lite:hal_iothardware", #依赖厂商的适配
    ]
    head_files = [ "//base/iot_hardware/peripheral/interfaces/kits" ]
  }
}

从中可以看到厂商适配相关接口的存放目录应为“$ohos_vendor_adapter_dir/hals/iot_hardware/wifiiot_lite”，且该目录下 BUILD.gn 文件中的目标应为 hal_iothardware。

移植实例

1.在“config.json”中添加 iot_hardware 子系统。
路径：“vendor/MyVendorCompany/MyProduct/config.json”
修改如下：

{ 
    subsystem": "iot_hardware", 
    components": [ 
        { "component": "iot_controller", "features":[] }
    ] 
},

2.添加适配文件。
在“vendor/MyVendorCompany/MyProduct/config.json”文件中，通常将配置“vendor_adapter_dir”配置为 “//device/MyDeviceCompany/MyBoard/adapter”。
在“vendor_adapter_dir”目录下进行适配：

hals/iot_hardware/wifiiot_lite
├── BUILD.gn
├── iot_flash.c
├── iot_gpio.c
├── iot_i2c.c
├── iot_lowpower.c
├── iot_pwm.c
├── iot_reset.c
├── iot_uart.c
└── iot_watchdog.c

其中 BUILD.gn 内容如下：

static_library("hal_iothardware") {   #目标名
    sources = [                       #厂商适配的源文件
      "iot_watchdog.c",
      "iot_reset.c",
      "iot_flash.c",
      "iot_i2c.c",
      "iot_gpio.c",
      "iot_pwm.c",
      "iot_uart.c"
    ]
    include_dirs = [ ]
}

其中，“include_dirs”需要根据工程实际情况包含两个路径：- iot 子系统的头文件路径

适配 iot 子系统所使用到的 SDK 的头文件路径