OpenHarmony（鸿蒙南向开发）——移植子系统(二)

最新推荐文章于 2024-07-31 21:31:24 发布
最新推荐文章于 2024-07-31 21:31:24 发布
阅读量113 收藏 4
点赞数 3
分类专栏： OpenHarmony 鸿蒙开发 移动开发 文章标签： 鸿蒙开发 OpenHarmony 子系统 系统移植 鸿蒙南向 驱动开发 嵌入式
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/maniuT/article/details/140824406
版权
移动开发 同时被 3 个专栏收录
878 篇文章 5 订阅
订阅专栏
OpenHarmony
617 篇文章 11 订阅
订阅专栏
鸿蒙开发
426 篇文章 0 订阅
订阅专栏

移植安全子系统

安全子系统提供网络设备连接、认证鉴权等功能，依赖mbedtls实现硬件随机数以及联网功能。

由于每个厂商芯片硬件与实现硬件随机数的方式不同，需要适配硬件随机数接口。

移植指导

OpenHarmony提供了mbedtls的开源三方库，路径为“//third_party/mbedtls”。此库中提供了“mbedtls_platform_entropy_poll”、“mbedtls_hardclock_poll”、“mbedtls_havege_poll”、“mbedtls_hardware_poll”等几种产生随机数的方式。厂商需要根据芯片适配“mbedtls_hardware_poll”方式。

移植实例

  1. “config.json”添加文件系统。 路径：“vendor/MyVendorCompany/MyProduct/config.json”

修改如下：

    {
      "subsystem": "security",
      "components": [
        { "component": "hichainsdk", "features":[] },
        { "component": "huks", "features":[]}
      ]
    },
  1. 配置宏，打开硬件随机数接口相关代码。 根据mbedtls的编译文件可以看出，配置宏的位置在"MBEDTLS_CONFIG_FILE=<…/port/config/config_liteos_m.h>"文件中。

路径：“third_party/mbedtls/BUILD.gn”

    if (ohos_kernel_type == "liteos_m") {
      defines += [
        "__unix__",
        "MBEDTLS_CONFIG_FILE=<../port/config/config_liteos_m.h>",
      ]
    }

根据代码我们可以看出需要配置“MBEDTLS_NO_PLATFORM_ENTROPY”、“MBEDTLS_ENTROPY_HARDWARE_ALT”两个宏，才能编译硬件随机数的相关代码。

路径：“third_party/mbedtls/library/entropy.c”

    #if !defined(MBEDTLS_NO_DEFAULT_ENTROPY_SOURCES)
    #if !defined(MBEDTLS_NO_PLATFORM_ENTROPY)
        mbedtls_entropy_add_source( ctx, mbedtls_platform_entropy_poll, NULL,
                                    MBEDTLS_ENTROPY_MIN_PLATFORM,
                                    MBEDTLS_ENTROPY_SOURCE_STRONG );
    #endif
    ......
    #if defined(MBEDTLS_ENTROPY_HARDWARE_ALT)
        mbedtls_entropy_add_source( ctx, mbedtls_hardware_poll, NULL,
                                    MBEDTLS_ENTROPY_MIN_HARDWARE,
                                    MBEDTLS_ENTROPY_SOURCE_STRONG );
    #endif
    ......
    #endif /* MBEDTLS_NO_DEFAULT_ENTROPY_SOURCES */
    }
  1. 适配硬件随机数接口 接口定义如下：

路径：“third_party/mbedtls/include/mbedtls/entropy_poll.h”

    int mbedtls_hardware_poll( void *data,unsigned char *output, size_t len, size_t *olen );

表1 安全子系统配置项

配置项意义
disable_huks_binary是否编译HUKS源码。
(1) 默认值： false，不编译HUKS源码。
(2) 其他值： true，编译HUKS源码。
disable_authenticate是否需要裁剪hichain认证功能。
(1) 默认值： true，不裁剪。
(2) 其他值： false，裁剪hichain认证功能。
huks_use_lite_storage是否采用轻量化存储方案。无文件系统、仅有flash存储的设备，可采用轻量化存储方案。
(1) 默认值： true，使用轻量化存储。
(2) 其他值： false，不使用轻量化存储。
huks_use_hardware_root_key是否使用硬件根密钥。设备存在硬件根密钥能力时，需要根据自身能力适配硬件根密钥方案；HUKS提供的RKC方案仅为模拟实现。
(1) 默认值：false，默认值，默认无硬件根密钥。
(2) 其他值：true，设备具有硬件根密钥相关能力时，应自行适配。
huks_config_file是否使用HUKS默认配置文件。
(1) 默认值：“”：使用HUKS默认配置文件hks_config.h。
(2) 其他文件：产品可在HUKS支持能力集合中自行选择所要支持的特性。

说明： 在添加安全子系统时，可直接通过配置feature来选择安全子系统特性。

{
   "subsystem": "security",
   "components": [
     { "component": "hichainsdk", "features":[] },
     { "component": "huks", "features":
       [
         "disable_huks_binary = false",
         "disable_authenticate = false"
       ]
     }
   ]
 },

移植通信子系统

通信子系统目前涉及Wi-Fi和蓝牙适配，厂商应当根据芯片自身情况进行适配。

移植指导

Wi-Fi编译文件内容如下：

路径：“foundation/communication/wifi_lite/BUILD.gn”

group("wifi") {
  deps = [ "$ohos_board_adapter_dir/hals/communication/wifi_lite/wifiservice:wifiservice" ]
}

从中可以看到厂商适配相关接口的.c文件存放目录应为“$ohos_board_adapter_dir/hals/communication/wifi_lite/wifiservice”，且该目录下BUILD.gn文件中的目标应为“wifiservice”。需要厂商适配的Wi-Fi接口见表1 、表2 和表3，蓝牙接口见表4和表5。

表1 wifi_device.h

接口作用
EnableWifi启用Wi-Fista模式。
DisableWifi禁用Wi-Fi sta模式。
IsWifiActive检查Wi-Fi sta模式是否启用。
Scan扫描热点信息。
GetScanInfoList获取所有扫描到的热点列表。
AddDeviceConfig配置连接到的热点信息。
GetDeviceConfigs获取配置连接到的热点信息。
RemoveDevice删除指定的热点配置信息。
ConnectTo接到指定的热点。
Disconnect断开Wi-Fi连接。
GetLinkedInfo获取热点连接信息。
RegisterWifiEvent为指定的Wi-Fi事件注册回调。
UnRegisterWifiEvent取消注册以前为指定Wi-Fi事件注册的回调。
GetDeviceMacAddress获取设备的MAC地址。
AdvanceScan根据指定参数启动Wi-Fi扫描。

表2 wifi_hotspot_config.h

接口作用
SetBand设置该热点的频段。
GetBand获取该热点的频段。

表3 wifi_hotspot.h

接口作用
EnableHotspot启用Ap热点模式。
DisableHotspot禁用Ap热点模式。
SetHotspotConfig设置指定的热点配置。
GetHotspotConfig获取指定的热点配置。
IsHotspotActive检查Ap热点模式是否启用。
GetStationList获取连接到此热点的一系列STA。
GetSignalLevel获取指定接收信号强度指示器（RSSI）和频带指示的信号电平。
DisassociateSta使用指定的MAC地址断开与STA的连接。
AddTxPowerInfo将hotspot功率发送到beacon。

表4 ohos_bt_gatt.h

接口作用
InitBtStack初始化蓝牙协议栈。
EnableBtStack使能蓝牙协议栈。
DisableBtStack禁用蓝牙协议栈。
SetDeviceName设置蓝牙设备名称。
BleSetAdvData设置广播数据。
BleStartAdv开始广播。
BleStartAdvEx传入构建好的广播数据，参数，开启蓝牙广播。
BleStopAdv停止发送广播。
BleUpdateAdv更新advertising参数。
BleSetSecurityIoCap设置蓝牙的IO能力为NONE，配对方式为justworks。
BleSetSecurityAuthReq设置蓝牙是否需要配对绑定。
BleGattSecurityRsp响应安全连接请求。
ReadBtMacAddr获取设备MAC地址。
BleSetScanParameters设置扫描参数。
BleStartScan开始扫描。
BleStopScan停止扫描。
BleGattRegisterCallbacks注册gap,GATT事件回调函数。

表5 ohos_bt_gatt_server.h

接口作用
BleGattsRegister使用指定的应用程序UUID注册GATT服务器。
BleGattsUnRegister断开GATT服务器与客户端的连接。
BleGattsDisconnect断开GATT服务器与客户端的连接。
BleGattsAddService添加了一个服务。
BleGattsAddIncludedService将包含的服务添加到指定的服务。
BleGattsAddCharacteristic向指定的服务添加特征。
BleGattsAddDescriptor将描述符添加到指定的特征。
BleGattsStartService启动一个服务。
BleGattsStopService停止服务。
BleGattsDeleteService删除一个服务。
BleGattsClearServices清除所有服务。
BleGattsSendResponse向接收到读取或写入请求的客户端发送响应。
BleGattsSendIndication设备侧向APP发送蓝牙数据。
BleGattsSetEncryption设置GATT连接的加密类型。
BleGattsRegisterCallbacks注册GATT服务器回调。
BleGattsStartServiceEx根据传入的服务列表，创建gatt服务。
BleGattsStopServiceEx传入gatt服务句柄，停止gatt服务。

说明： 不同版本接口可能存在差异，需要根据当前版本的具体文件进行适配。

适配实例

  1. 在“config.json”中添加communication子系统。 路径：“vendor/MyVendorCompany/MyProduct/config.json”

修改如下：

    { 
        "subsystem": "communication", 
        "components": [ 
            { "component": "wifi_lite", "features":[] }
        ] 
    },
  1. 添加适配文件。

在“vendor/MyVendorCompany/MyProduct/config.json”文件中，通常将配置“ohos_board_adapter_dir”配置为 “//vendor/MyVendorCompany/MyProduct/adapter”。

在“ohos_board_adapter_dir”目录下根据上述适配指导中提到的头文件，适配Wi-Fi、蓝牙接口。

移植外设驱动子系统

外设驱动子系统提供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":[] }
        ] 
    },
  1. 添加适配文件。

在“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的头文件路径

配置其他子系统

除上述子系统之外，还有一些必要但是无需进行移植的子系统。如：分布式任务调度子系统、DFX子系统。

这些子系统添加方式比较简单，在“vendor/MyVendorCompany/MyProduct/config.json”文件中进行如下配置即可：

{
  "subsystem": "distributed_schedule",
  "components": [
    { "component": "system_ability_manager", "features":[] }  # 此处部件名不同版本可能有变化，请根据实际代码填写
  ]
},
{
  "subsystem": "hiviewdfx",
  "components": [
    { "component": "hilog_lite", "features":[] },
    { "component": "hievent_lite", "features":[] }
  ]
},

如果大家想更加深入的学习 OpenHarmony（鸿蒙南向） 开发的全栈内容，不妨可以参考以下相关学习文档进行学习，助你快速提升自己：

OpenHarmony 开发环境搭建：https://qr18.cn/CgxrRy

《OpenHarmony源码解析》：https://qr18.cn/CgxrRy

  • 搭建开发环境
  • Windows 开发环境的搭建
  • Ubuntu 开发环境搭建
  • Linux 与 Windows 之间的文件共享
  • ……

系统架构分析：https://qr18.cn/CgxrRy

  • 构建子系统
  • 启动流程
  • 子系统
  • 分布式任务调度子系统
  • 分布式通信子系统
  • 驱动子系统
  • ……

OpenHarmony 设备开发学习手册：https://qr18.cn/CgxrRy

在这里插入图片描述

OpenHarmony面试题（内含参考答案）：https://qr18.cn/CgxrRy

写在最后

  • 如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
  • 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
  • 关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
  • 想要获取更多完整鸿蒙最新学习资源，请移步前往小编：https://qr21.cn/FV7h05

OpenHarmony_小贾
关注
  • 3
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
OpenHarmony（鸿蒙南向开发）——移植子系统(三)
maniuT的博客
07-31 465
OpenHarmony芯片移植完成后，需要开展OpenHarmony兼容性测试以及芯片SDK功能性测试。除可获得测试认证之外，还可以在开发阶段提前发现缺陷，大幅提高代码质量。
OpenHarmony（鸿蒙南向开发）——移植子系统(一)
maniuT的博客
07-31 191
OpenHarmony系统功能按照“系统 > 子系统 > 部件”逐级展开，支持根据实际需求裁剪某些非必要的部件，本文以部分子系统、部件为例进行介绍。若想使用OpenHarmony系统的能力，需要对相应子系统进行适配。OpenHarmony芯片适配常见子系统列表如下（详见表1），需结合具体芯片再做增删减操作。表1 OpenHarmony子系统子系统作用应用程序demo。可将应用相关源码存放在此目录下。kernel内核子系统。负责任务调度、内存管理等常见的内核功能。hiviewdfx。
OpenHarmony（鸿蒙南向开发）——小型系统芯片移植指南（二）
maniuT的博客
07-31 76
LiteOS-A当前支持ARMv7-a指令集架构，如果三方芯片为ARMv7-a架构，可以进行内核基础适配；否则还需要先根据芯片的架构来新增内核对该芯片架构的支持，这个工作较为复杂，不在这篇文章范围内。
OpenHarmony（鸿蒙南向开发）——标准系统移植指南（一）
最新发布
maniuT的博客
07-31 140
本文以移植名为MyProduct的开发板为例讲解移植过程，假定MyProduct是MyProductVendor公司的开发板，使用MySoCVendor公司生产的MySOC芯片作为处理器。在名称的目录下创建一个config.json文件，该文件用于描述产品所使用的SOC 以及所需的子系统。配置如下：},...主要的配置内容配置项说明（必填）产品名称version（必填）版本type（必填）配置的系统级别，包含（small、standard等)target_cpu。
Android系统级深入开发——移植与调试.pdf
12-04
Android系统级深入开发——移植与调试.pdf 高清完整版下载
Android系统级深入开发——移植与调试
07-16
Android系统级深入开发——移植与调试.pdf 文件太大，上传网盘，提供下载地址 如果地址失效，请给我邮件，邮件标题注明： csdn Android系统级深入开发——移植与调试.pdf 失效，我将会提供新链接。否则勿扰。
Android系统级深入开发——移植与调试 pdf
08-31
《Android系统级深入开发——移植与调试》这本书深入探讨了Android系统的内部工作原理，涵盖了从系统移植到调试的全过程。在Android开发领域，系统级的深入理解是提升开发者能力的关键，下面将对其中的主要知识点...
windows USB 设备驱动开发-创建安装 Winusb.sys 的驱动程序包
苏洛的博客
07-27 438
要将 WinUSB 用作设备的功能驱动程序，请创建一个驱动程序包
【北京迅为】《i.MX8MM嵌入式Linux开发指南》-第三篇 嵌入式Linux驱动开发篇-第五十八章 中断下文之tasklet
BeiJingXunWei的博客
07-26 1076
tasklet 采用无差别的队列机制，有中断时才执行，免去了循环查表之苦，tasklet 机制的优点：无类型数量限制，效率高，无需循环查表，支持 SMP 机制，一种特定类型的 tasklet只能运行在一个 CPU 上，不能并行，只能串行执行。如果要使用 tasklet，必须先定义一个 tasklet，然后使用 tasklet_init 函数初始化 tasklet，taskled_init 函。为了提高中断处理数量，顺道改。如上图所示，和我们预期结果是一样的，先打印start，再打印end，再打印0-99。
如何成为一个单片机软件工程师
美容仪发烧友
07-28 271
单片机工程师是嵌入式系统领域的重要人才，他们需要具备扎实的嵌入式系统基础、熟练的编程能力、丰富的硬件设计经验和良好的团队协作能力。单片机工程师的就业前景非常广阔，随着物联网、智能家居、智能交通、智能医疗等领域的快速发展，单片机技术的应用越来越广泛，对单片机工程师的需求也在不断增加。通信协议：熟悉常见的通信协议和接口，如串口通信、I2C、SPI、CAN、UART等，能够实现单片机与外部设备的数据交换。单片机技术：了解不同单片机的体系结构和指令集，掌握寄存器的操作、中断处理、定时器、计数器等技术。
嵌入式初学-C语言-七
MaBaB的博客
07-29 485
分支结构 分支结构：又被称之为选择结构 概念 选择结构：根据条件成立与否，选择相应的操作。
【权威发布】第二届机械电子工程与软件工程国际会议（MEESE 2024）
wx19980549140的博客
07-25 1642
第二届机械电子工程与软件工程国际会议是一个专注于机械电子工程与软件工程领域交叉融合的国际盛会。会议旨在汇聚全球范围内的专家学者、研究人员及行业精英，共同探讨机械电子工程与软件工程领域的最新科研成果、技术进展及未来发展趋势。会议内容广泛而深入，涵盖了机械电子系统的设计与控制、智能传感与检测技术、嵌入式系统与物联网、软件架构设计、软件测试与维护、人工智能与机器学习在软件工程中的应用等多个方面。这些议题紧密结合当前科技发展的前沿，为参会者提供了丰富的学术内容和交流机会。
【ESP01开发实例】-驱动OLED SSD1306显示屏
视觉与物联智能
07-28 37
本文介绍如何将 ESP8266 (ESP-01) 模块与 SSD1306 OLED 显示屏连接，该项目中使用的显示屏分辨率为 128×64 像素，工作在 I2C 模式。
backtrace
MrPeng的博客
07-27 407
arm平台的调用栈与x86平台的调用栈大致相同，稍微有些区别，主要在于栈帧的压栈内容和传参方式不同。在arm平台的不同程序，采用的编译选项不同，程序运行期间的栈帧也会不同。有些工具在对arm的调用栈回溯时，可能会遇到无法回溯的情况。例如gdb在使用bt查看core dump文件调用栈时，有时会出现的情况,有可能就是栈空间的压栈顺序导致的。当工具无法回溯时，就需要人工结合汇编代码对栈进行回溯，或者使用unwind进行回溯。
基于STC8H系列单片机的定时器系统
CWQLTYH的博客
07-27 300
main.c#define uchar unsigned char//自定义无符号字符型为uchar#define uint unsigned int//自定义无符号整数型为uintvoid PortModeSet()//单片机端口模式设置函数//允许访问XSFR(扩展特殊功能寄存器)//设置P0.0~P0.3为准双向口//设置P0.4~P0.7为准双向口//设置P1.0~P1.3为准双向口//设置P1.4~P1.7为准双向口//设置P2.0~P2.3为准双向口。
GPS定位系统（VUE框架）
激萌の小宅的博客
07-27 175
版本，并没有做到前后端分离，不太适合多人协作开发，这边博主分享一个基于asp.net web api + vue3的GPS定位系统框架，本框架继承了MVC框架的所有功能，如果想用这个框架进行调试的话，可以参考MVC框架的调试方法，当前系列博主也会进行调试演示。GPS定位系统主要实现的功能是基于GPS对远程物体进行无线追踪，GPS模块采用安信可的A9G。3、STM32中GPS定位程序的功能实现（型号：STM32F103ZET6）。我们GPS设备采用安信可的A9G模块，同时支持GPS和GPRS功能。
STM32Cubemxide使用DMA实现USART
热爱科技，物联，程序开发等
07-25 290
进入Project Manager(项目管理)–(Advanced Settings)(高级设置)在菜单栏Categories(分类)–Connectivity(连接)–USART1(串行通信)Parameter Settings(参数设置)先保持系统默认。Mode选择Asynchronous(异步)DMA的初始化一定要比USART1的初始化先。
【NPU 系列专栏 3.2 -- ARM NPU 周易(Zhouyi) 与 周易 X2 详细介绍】
CodingCos的博客
07-27 629
ARM China 的自研产品线包括 “周易”NPU、“星辰”CPU、“山海”SPU、“玲珑”ISP、“玲珑”VPU，160家，累计出货量突破2亿颗。周易 NPU 是 ARM 推出的一款专用神经处理单元（NPU），旨在为嵌入式设备提供高效的人工智能（AI）和机器学习（ML）加速能力。周易 NPU 主要面向中低端市场，适用于智能家居设备、物联网（IoT）设备等。周易 X2 NPU 是周易系列的高端版本，进一步提升了算力和性能，适用于需要更高 AI 处理能力的应用场景，如高端智能手机、平板电脑等。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值