• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1
2
3# 轻量带屏解决方案之恒玄芯片移植案例
4
5本文章基于恒玄科技`BES2600W`芯片的欧智通[Multi-modal V200Z-R开发板](https://gitee.com/openharmony/device_board_fnlink),进行轻量带屏开发板的标准移植,开发了智能开关面板样例,同时实现了`ace_engine_lite`、`graphic_ui`、`aafwk_lite`、`appexecfwk_lite`、`HDF`等部件基于`OpenHarmony LiteOS-M`内核的适配。移植架构上采用`Board`与`SoC`分离的方案,工具链`Newlib C`库与`Musl C`库可选,`LiteOS-M`内核编译采用`gn`结合`Kconfig`图形化配置等需求。
6
7## 编译构建
8
9### 目录规划
10
11本案例在芯片移植架构方面进行了一些改进,以前的芯片适配目录规划为:
12
13```
14device
15└── <device_company>
16    └── <device_name>
17```
18
19这样会导致,小熊派`BearPi-HM Nano`开发板与润和的`HiSpark Pegasus`开发板使用小海思的`hi3861`的`SoC`时,需要在这两款开发板里面都放置一份重复的代码。为了解决该问题,本案例将单板厂商与`SoC`厂商进行分离,可以参考[Board和SoC解耦的设计思路](https://gitee.com/openharmony-sig/sig-content/blob/master/devboard/docs/board-soc-arch-design.md),并把芯片适配目录规划为:
20
21```
22device
23├── board                                --- 单板厂商目录
24│   └── fnlink                           --- 单板厂商名字:欧智通
25│       └── v200zr                       --- 单板名:v200zr
26└── soc									 --- SoC厂商目录
27    └── bestechnic                       --- SoC厂商名字:恒玄
28        └── bes2600						 --- SoC Series名:bes2600是一个系列,里面包含bes2600w等SoC名
29```
30
31产品样例目录规划为:
32
33```
34vendor
35└── bestechnic							 --- 开发产品样例厂商目录,恒玄开发的带屏样例,因此以bestechnic命名
36    └── display_demo         			 --- 产品名字:以智能开关面板的带屏显示样例
37```
38
39### 预编译适配
40
41在进行移植之前,需要进行预编译适配。
42
43预编译适配主要使用`hb set`命令,设置整个项目的根目录、单板目录、产品目录、单板公司名等环境变量,为编译做准备。
44
45具体的预编译适配步骤如下:
46
471. 在`vendor/bestechnic/display_demo`目录下新增`config.json`文件,用于描述这个产品样例所使用的单板、内核等信息,描述信息可参考如下内容:
48
49```
50{
51  "product_name": "display_demo",       --- 用于hb set进行选择时,显示的产品名称
52  "type": "mini",                       --- 构建系统的类型,mini/small/standard
53  "version": "3.0",                     --- 构建系统的版本,1.0/2.0/3.0
54  "device_company": "fnlink",           --- 单板厂商名,用于编译时找到/device/board/fnlink目录
55  "board": "v200zr",                    --- 单板名,用于编译时找到/device/board/fnlink/v200zr目录
56  "kernel_type": "liteos_m",            --- 内核类型,因为OpenHarmony支持多内核,一块单板可能适配了多个内核,所以需要指定某个内核进行编译
57  "kernel_version": "3.0.0",            --- 内核版本,一块单板可能适配了多个linux内核版本,所以需要指定某个具体的内核版本进行编译
58  "subsystems": [ ]                     --- 选择所需要编译构建的子系统
59}
60```
61
622. 在`device/board/fnlink/v200zr/liteos_m`目录下新增`config.gni`文件,用于描述这个产品样例所使用的单板、内核等信息,描述信息可参考如下内容:
63
64```
65# Kernel type, e.g. "linux", "liteos_a", "liteos_m".
66kernel_type = "liteos_m"                --- 内核类型,跟config.json中kernel_type对应
67
68# Kernel version.
69kernel_version = "3.0.0"                --- 内核版本,跟config.json中kernel_version对应
70```
71
723. 验证`hb set`配置是否正确,输入`hb set`能够显示如下图片表示配置正确。
73
74   执行`hb set`输入项目根目录,并且回车,`hb`命令会遍历所有`//vendor/<product_company>/<product_name>`目录下的`config.json`,给出可选产品编译选项,`config.json`的`product_name`用于显示产品名,`device_company`和`board`用于关联出`//device/board/<device_company>/<board>`目录,并且匹配`<any_dir_name>/config.gni`文件,如果能够匹配多个文件,表示该单板适配了多个内核,那么可以根据`config.json`的`kernel_type`和`kernel_version`来唯一匹配`config.gni`的`kernel_type`和`kernel_version`,即可确定了需要编译适配了哪个内核的单板。
75![hb set](figures/bes2600_hb_set.png)
76
77			通过`hb env`可以查看选择出来的预编译环境变量。
78
79![hb env](figures/bes2600_hb_env.png)
80
81在执行`hb build`之前,需要准备好`LiteOS-M`内核适配,具体适配步骤请参[内核移植](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/porting/porting-bes2600w-on-minisystem-display-demo.md#%E5%86%85%E6%A0%B8%E7%A7%BB%E6%A4%8D)82
83## 内核移植
84
85内核移植需要完成`LiteOS-M Kconfig`适配、`gn`的编译构建和内核启动最小适配。
86
87### LiteOS-M Kconfig适配
88
89在`//kernel/liteos_m`目录下执行`make menuconfig`命令,完成编译配置选项的选择。在`Makefile`文件中,会将`hb env`的结果转换成环境变量,即`PRODUCT_PATH`、`DEVICE_PATH`和`BOARD_COMPANY`。如下代码块所示:
90
91```
92$(foreach line,$(shell hb env | sed 's/\[OHOS INFO\]/ohos/g;s/ /_/g;s/:_/=/g' || true),$(eval $(line)))
93ifneq ($(ohos_kernel),liteos_m)
94$(error The selected product ($(ohos_product)) is not a liteos_m kernel type product)
95endif
96--- 将hb env的每一行输出转化为变量形式,例如将[OHOS INFO] device company: fnlink转换为ohos_device_company=fnlink
97
98……
99
100ifeq ($(BOARD_COMPANY),)
101BOARD_COMPANY:=$(ohos_device_company)
102endif
103……
104export BOARD_COMPANY
105--- 将ohos_device_company转化为BOARD_COMPANY环境变量
106```
107
108在`//kernel/liteos_m/Kconfig`文件中使用这些导出的环境变量,`Kconfiglib`采用`ulfalizer`开发基于`python`的版本,[源码地址](https://github.com/ulfalizer/Kconfiglib),[功能介绍连接参考](https://github.com/zephyrproject-rtos/zephyr/blob/main/scripts/kconfig/kconfiglib.py),里面用到了`orsource`关键字,其中`o`表示`optional`,表示这个文件是否存在可选,`r`表示`relative`,表示这个文件相对当前文件的相对路径。
109
110```
111config SOC_COMPANY
112    string "SoC company name to locate soc build path"
113    help
114      This option specifies the SoC company name, used to locate the build path for soc. This option is set by the
115      SoC's Kconfig file, and should be exactly the same with SoC company path, and the user should generally avoid
116       modifying it via the menu configuration.
117
118orsource "../../device/board/*/Kconfig.liteos_m.shields"                                 --- 将所有扩展板配置信息加载进来,因为单板厂商A提供扩展板可以给单板厂商B使用,所以这里使用*匹配所有的扩展板,而非BOARD_COMPANY。另外由于OpenHarmony支持多内核设计,Kconfig文件采用liteos_m作为后缀,在进行单板适配过程中,其他内核在适配过程中,可以使用对应的内核名作为后缀名进行扩展。
119
120orsource "../../device/board/$(BOARD_COMPANY)/Kconfig.liteos_m.defconfig.boards"         --- 加载BOARD_COMPANY的所有单板预定义配置
121
122choice
123    prompt "Board Selection"
124
125orsource "../../device/board/$(BOARD_COMPANY)/Kconfig.liteos_m.boards"                   --- 提供Board选择列表
126
127endchoice
128
129orsource "../../device/soc/*/Kconfig.liteos_m.defconfig"                                 --- 加载所有SoC的默认配置定义
130
131choice
132    prompt "SoC Series Selection"
133
134orsource "../../device/soc/*/Kconfig.liteos_m.series"                                    --- 提供所有SoC Series选择列表
135
136endchoice
137
138orsource "../../device/soc/*/Kconfig.liteos_m.soc"                                       --- 加载所有SoC配置
139```
140
141从`//kernel/liteos_m/Kconfig`文件可以看出需要在`//device/board/fnlink`目录下新增如下`Kconfig`文件进行适配:
142
143```
144.
145├── v200zr                                       --- v200zr单板配置目录
146│   ├── Kconfig.liteos_m.board                   --- 提供v200zr单板的配置选项
147│   ├── Kconfig.liteos_m.defconfig.board         --- 提供v200zr单板的默认配置项
148│   └── liteos_m
149│       └── config.gni
150├── Kconfig.liteos_m.boards                      --- 提供fnlink单板厂商下Boards配置信息
151├── Kconfig.liteos_m.defconfig.boards			 --- 提供fnlink单板厂商下Boards默认配置信息
152├── Kconfig.liteos_m.shields					 --- 提供fnlink单板厂商下扩展板配置信息
153└── shields										 --- fnlink单板厂商的扩展板目录
154    ├── v200zr-t0								 --- fnlink单板厂商的扩展板v200zr-t0
155    │   ├── Kconfig.liteos_m.defconfig.shield	 --- 扩展板v200zr-t0默认配置
156    │   └── Kconfig.liteos_m.shield				 --- 扩展板v200zr-t0配置信息
157    ├── v200zr-t1
158    │   ├── Kconfig.liteos_m.defconfig.shield
159    │   └── Kconfig.liteos_m.shield
160    └── Kconfig.liteos_m.shields
161```
162
163在 `v200zr/Kconfig.liteos_m.board`需要配置选择该单板的选项,以及它依赖的`SoC`,如下:
164
165```
166config BOARD_v200zr
167    bool "select board v200zr"
168    depends on SOC_BES2600W		 --- v200zr单板用的bes2600w的SoC,只有 bes2600w的SoC被选择后,v200zr单板配置选项才可见,可以被选择。
169```
170
171在 `v200zr/Kconfig.liteos_m.defconfig.board`需要配置选择该单板后,默认定义 `BOARD` 的名字为 `"v200zr"` ,如下:
172
173```
174if BOARD_v200zr
175config BOARD
176    string		 --- string后没有带提示,因此用户不可见
177    default "v200zr"
178
179endif # BOARD_v200zr
180```
181
182从`//kernel/liteos_m/Kconfig`文件可以看出需要在`//device/soc/bestechnic`目录下新增如下`Kconfig`文件进行适配:
183
184```
185.
186├── bes2600									 --- bes2600 SoC系列
187│   ├── Kconfig.liteos_m.defconfig.bes2600w	 --- bestechnic芯片厂商bes2600w SoC Series配置
188│   ├── Kconfig.liteos_m.defconfig.series	 --- bestechnic芯片厂商bes2600默认配置
189│   ├── Kconfig.liteos_m.series				 --- bestechnic芯片厂商bes2600 SoC Series配置
190│   └── Kconfig.liteos_m.soc				 --- bestechnic芯片厂商bes2600 SoC配置
191├── Kconfig.liteos_m.defconfig				 --- bestechnic芯片厂商SoC默认配置
192├── Kconfig.liteos_m.series					 --- bestechnic芯片厂商SoC Series配置
193└── Kconfig.liteos_m.soc					 --- bestechnic芯片厂商 SoC配置
194```
195
196在 `bes2600/Kconfig.liteos_m.series` 需要配置`bes2600 SoC series`,以及它的芯片架构等信息,如下:
197
198```
199config SOC_SERIES_BES2600			 --- 提供bes2600 SoC Series选项
200    bool "Bestechnic 2600 Series"
201    select ARM						 --- 选择bes2600后,默认选择ARM架构
202    select SOC_COMPANY_BESTECHNIC    --- 选择bes2600后,默认选择bestechnic芯片公司,驱动会依赖这个宏配置,选择配置编译对应厂商的驱动
203    select CPU_CORTEX_M33			 --- 选择bes2600后,默认选择cortex-m33 CPU
204    help
205        Enable support for Bestechnic 2600 series
206```
207
208在 `bes2600/Kconfig.liteos_m.soc` 需要提供`bes2600 SoC series`下有多少个具体的`SoC`可供选择,如下:
209
210```
211choice
212    prompt "Bestechnic 2600 series SoC"
213    depends on SOC_SERIES_BES2600	 --- 只有选择了bes2600 Series后,才会出现如下配置选项
214
215config SOC_BES2600W					 --- 增加bes2600w SoC配置选择项
216    bool "SoC BES2600w"
217
218endchoice
219```
220
221在 `bes2600/Kconfig.liteos_m.defconfig.series` 需要提供`bes2600 SoC series`选择后的默认配置,如下:
222
223```
224if SOC_SERIES_BES2600							 --- 选择了bes2600 Series后,才会增加如下默认配置选项
225
226rsource "Kconfig.liteos_m.defconfig.bes2600w"	 --- 增加bes2600w SoC的默认配置
227
228config SOC_SERIES								 --- 增加SOC_SERIES的默认配置
229    string
230    default "bes2600"
231
232endif
233```
234
235配置完成后,还需要根据 `kernel/liteos_m/Makefile` 文件配置`make menuconfig`的`defconfig`保存路径:
236
237```
238ifeq ($(TEE:1=y),y)
239tee = _tee
240endif
241ifeq ($(RELEASE:1=y),y)
242CONFIG ?= $(PRODUCT_PATH)/kernel_configs/release$(tee).config
243else
244CONFIG ?= $(PRODUCT_PATH)/kernel_configs/debug$(tee).config		 --- 配置文件保存在$(CONFIG)中,由产品最终定义
245endif
246
247……
248
249update_config menuconfig:
250	$(HIDE)test -f "$(CONFIG)" && cp -v "$(CONFIG)" .config && menuconfig $(args) && savedefconfig --out "$(CONFIG)"
251```
252
253在这个例子中,`defconfig`配置路径为 `$(PRODUCT_PATH)/kernel_configs/debug.config`,创建该文件后,内容为空,产品的目录文件结构如下:
254
255```
256.
257└── display_demo
258    ├── config.json
259    └── kernel_configs
260        └── debug.config
261```
262
263配置完成后,在 `kernel/liteos_m` 目录下执行 `make menuconfig`能够对`SoC Series`/`SoC`/`Board`进行选择,如下:
264
265![board make menuconfig](figures/bes2600_board_make_menuconfig.png)
266
267结果将自动保存在`$(PRODUCT_PATH)/kernel_configs/debug.config`,下次执行`make menuconfig`时会导出保存的结果。
268
269### gn编译适配
270
271在上一步`Kconfig`的图形化配置后,将其生成的配置结果可以作为`gn`编译的输入,以控制不同模块是否编译。另外为了解决之前`gn`编写时,随意include的问题,内核编译做了模块化编译的设计,使得整个编译逻辑更加清晰,设计思路请参考[LiteOS-M内核BUILD.gn编写指南](https://gitee.com/caoruihong/kernel_liteos_m/wikis/LiteOS-M%E5%86%85%E6%A0%B8BUILD.gn%E7%BC%96%E5%86%99%E6%8C%87%E5%8D%97)272
273在 `kernel/liteos_m/BUILD.gn` 中,指定了`Board`和`SoC`的编译入口为`//device/board/fnlink`和`//device/soc/bestechnic`。
274
275```
276deps += [ "//device/board/$device_company" ]
277deps += [ "//device/soc/$LOSCFG_SOC_COMPANY" ]
278```
279
280在`//device/board/fnlink/BUILD.gn`中,新增内容如下:
281
282```
283if (ohos_kernel_type == "liteos_m") {                    --- 由于多内核设计,对于LiteOS-M内核适配,需要用宏来隔离
284  import("//kernel/liteos_m/liteos.gni")				 --- 引入内核gn编写模板
285  module_name = get_path_info(rebase_path("."), "name")	 --- 动态获取当前文件目录作为模块名,防止目录名修改后,这里还需要跟着修改
286  module_group(module_name) {							 --- 采用module_group模板
287    modules = [											 --- 添加需要编译的模块
288    ]
289  }
290}
291```
292
293同理`//device/soc/bestechnic/BUILD.gn`也是一样。
294
295### 内核启动适配
296
297系统启动流程分为三个阶段:
298
299| 阶段名称  | 分区规划                 | 描述                          |
300| --------- | ------------------------ | ----------------------------- |
301| BOOT1     | [0, 0x10000]             | 第一阶段启动,进行固件启动    |
302| BOOT2     | [0x2C010000, 0x2C020000] | 第二阶段启动,进行OTA升级启动 |
303| RTOS_MAIN | [0x2C080000, 0x2C860000] | 第三阶段启动,进行内核启动    |
304
305在第三阶段内核启动中,需要适配的文件路径在 `//device/soc/bestechnic/bes2600/liteos_m/sdk/bsp/rtos/liteos/liteos_m/board.c`
306
307内核启动适配总体思路如下:
308
3091. 中断向量的初始化`os_vector_init` ,初始化中断的处理函数。
3102. 内核初始化`osKernelInitialize` 。
3113. 创建线程`board_main`,进行芯片平台初始化。
3124. 内核启动,开始调度线程`osKernelStart` 。
313
314其中,本章节详细对第3步进行展开,其他几步为对内核函数调用,不作详细描述。
315
316第3步中`board_main`在启动`OHOS_SystemInit`之前,需要初始化必要的动作,如下:
317
318```
319...
320    if(!ret) {
321        ...
322        OhosSystemAdapterHooks();    --- 系统启动时候设置钩子,启动OpenHarmonyOHOS_SystemInit的之前完成打印和驱动的初始化
323        ...
324        OHOS_SystemInit(); 			 --- 启动OpenHarmony服务,以及组件初始化
325    }
326....
327```
328
329`OhosSystemAdapterHooks`函数在`device/soc/bestechnic/bes2600/liteos_m/components/utils/src/hm_sys.c`文件中,如下:
330
331```
332int OhosSystemAdapterHooks(void)
333{
334    init_trace_system(); 	 --- 初始化打印函数
335    DeviceManagerStart(); 	 --- 调用DeviceManagerStart函数进行HDF驱动初始化,这个过程会调用单板代码中的驱动配置文件hdf.hcs以及drivers源码实现
336    return 0;
337}
338
339```
340
341### littlefs文件系统移植
342
343 `V200Z-R`开发板开发板采用最大`32MB`的支持`XIP`的`Nor Flash`,文件系统可以使用`example`,适配过程中,需要在指定路径下放置文件系统预置文件,根据配置可自动生成文件系统镜像,可以实现自动化生成和打包到烧录包中。
344
3451. 配置指定目录放置打包文件系统`config.json`,通过`flash_partition_dir`指定目录:
346
347```
348  "flash_partition_dir": "fs" 	 --- 表示在vendor/bestechnic/display_demo/fs目录下放置文件系统预置文件
349```
350
3512. 在指定目录`vendor/bestechnic/display_demo/fs`下放置两部分内容:
352
353  - `wifi_Download_cfg.yaml`:镜像的烧录配置文件,可以根据实际情况调整分区。
354  - `/data/data`:第一个/`data`是挂载的根目录;第二个`data`是根目录里面的`data`目录,里面可以存放预置文件,或者在第二个`data`的同级目录再创建一个目录,打包的时候只认第一个`data`挂载根目录。
355
3563. `config.json`中根据`wifi_Download_cfg.yaml`最后调整结果。
357
358  - `fs_src`配置文件系统挂载名字。
359  - `fs_name`是最后生成文件系统的名字。
360  - `block_size`配置成`4K`对齐,建议不修改。
361  - `fs_size`是生成文件系统的大小。
362  - `burn_name`是烧录`bin`名字的大小。
363  - `enable` 表示是否生成这个文件系统
364
3654. 在`//device/soc/bestechnic/bes2600/liteos_m/components/hdf_config/hdf.hcs`文件配置文件系统的烧录的起始地址、文件系统的大小以及读数据块的大小`block_size`等信息,参考配置如下:
366
367```
368    misc {
369        fs_config {
370            example_config {
371                match_attr = "littlefs_config";
372                mount_points = ["/data"];
373                partitions = [10];
374                block_size = [4096];
375                block_count = [1024];
376            }
377        }
378        storage_config {
379            flash_config {
380                match_attr = "flash_config";
381                partitions = [10];
382                owner = [0];
383                description = ["littlefs"];
384                start_addr = [0xB60000];
385                length = [0x400000];
386                options = [3];
387            }
388        }
389    }
390```
391
392最后在`device/soc/bestechnic/bes2600/liteos_m/components/fs/fs_init.c`中,通过`hdf`加载数据,进行读写`flash`,如下:
393
394```
395static int32_t FsDriverInit(struct HdfDeviceObject *object)
396{
397    if (object == NULL) {
398        return HDF_FAILURE;
399    }
400    if (object->property) {
401        if (FsGetResource(fs, object->property) != HDF_SUCCESS) {
402            HDF_LOGE("%s: FsGetResource failed", __func__);
403            return HDF_FAILURE;
404        }
405    }
406    for (int i = 0; i < sizeof(fs) / sizeof(fs[0]); i++) {
407        if (fs[i].mount_point == NULL)
408            continue;
409
410        fs[i].lfs_cfg.read = littlefs_block_read;
411        fs[i].lfs_cfg.prog = littlefs_block_write;
412        fs[i].lfs_cfg.erase = littlefs_block_erase;
413        fs[i].lfs_cfg.sync = littlefs_block_sync;
414
415        fs[i].lfs_cfg.read_size = 256;
416        fs[i].lfs_cfg.prog_size = 256;
417        fs[i].lfs_cfg.cache_size = 256;
418        fs[i].lfs_cfg.lookahead_size = 16;
419        fs[i].lfs_cfg.block_cycles = 1000;
420
421        int ret = mount(NULL, fs[i].mount_point, "littlefs", 0, &fs[i].lfs_cfg);
422        HDF_LOGI("%s: mount fs on '%s' %s\n", __func__, fs[i].mount_point, (ret == 0) ? "succeed" : "failed");
423    }
424    return HDF_SUCCESS;
425}
426```
427
428
429
430### C库适配
431
432在轻量系统中,C库适配比较复杂,设计思路请参考[LiteOS-M内核支持musl与newlib平滑切换方案](https://gitee.com/arvinzzz/ohos_kernel_design_specification/blob/master/liteos_m/%E6%94%AF%E6%8C%81newlib/%E5%86%85%E6%A0%B8%E9%80%82%E9%85%8Dnewlib%E6%96%B9%E6%A1%88%E6%80%9D%E8%B7%AF.md),由于我们的工具链采用 [gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2](https://gitee.com/link?target=https%3A%2F%2Fdeveloper.arm.com%2F-%2Fmedia%2FFiles%2Fdownloads%2Fgnu-rm%2F10.3-2021.10%2Fgcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2) 自带`newlib`的C库,那么系统移植整体采用`newlib`的C库。那么在内核的`make menuconfig`中选择`newlib`,如下图:
433
434![image-20211212191013553](figures/bes2600_newlib_make_menuconfig.png)
435
436#### malloc适配
437
438malloc适配参考[The Red Hat newlib C Library-malloc](https://sourceware.org/newlib/libc.html#malloc)。实现malloc适配有以下两种方法:
439
440- 实现 `_sbrk_r` 函数。这种方法中,内存分配函数使用`newlib`中的。
441
442- 实现 `_malloc_r`, `_realloc_r`, `_reallocf_r`, `_free_r`, `_memalign_r`, 和 `_malloc_usable_size_r`。这种方法中,内存分配函数可以使用内核的。
443
444为了方便地根据业务进行内存分配算法调优和问题定位,在这两种方法中,本案例选择后者。
445
446首先,由于`newlib`中已经存在这些函数的符号,因此需要用到`gcc`的`wrap`的链接选项替换这些函数符号为内核的实现,内核的实现为 `//kernel/liteos_m/kal/libc/newlib/porting/src/malloc.c`。
447
448然后,在`//device/board/fnlink/v200zr/liteos_m/config.gni`的新增这些函数的`wrap`链接选项。
449
450```
451board_ld_flags += [
452     "-Wl,--wrap=_malloc_r",
453     "-Wl,--wrap=_realloc_r",
454     "-Wl,--wrap=_reallocf_r",
455     "-Wl,--wrap=_free_r",
456     "-Wl,--wrap=_memalign_r",
457     "-Wl,--wrap=_malloc_usable_size_r",
458]
459```
460
461#### vsprintf等适配
462
463参考 https://sourceware.org/newlib/libc.html#vfprintf ,实现 `vprintf`, `vfprintf`, `printf`, `snprintf` 和`sprintf`。
464
465类似`malloc`适配,首先要提供这些函数的实现,`//device/soc/bestechnic/bes2600/liteos_m/components/utils/src/printf.c`,本案例直接采用开源协议友好的实现。与`malloc`适配不同的是,这个函数由芯片原厂提供。因为就打印来说,根据项目的需要,实现可大可小,内核不方便提供统一的实现。
466
467然后,在`//device/board/fnlink/v200zr/liteos_m/config.gni`的新增这些函数的wrap链接选项。
468
469```
470board_ld_flags += [
471     "-Wl,--wrap=printf",
472     "-Wl,--wrap=sprintf",
473     "-Wl,--wrap=snprintf",
474     "-Wl,--wrap=vsnprintf",
475     "-Wl,--wrap=vprintf",
476]
477```
478
479#### open等适配
480
481这部分实现由内核统一实现,芯片适配无须关注,内核文件`//kernel/liteos_m/kal/libc/newlib/porting/src/fs.c`,适配了`newlib`的`_read`、`_write`等函数,如下:
482
483```
484……
485ssize_t _read(int fd, void *buf, size_t nbyte)
486{
487    return LOS_Read(fd, buf, nbyte);
488}
489
490ssize_t _write(int fd, const void *buf, size_t nbyte)
491{
492    return LOS_Write(fd, buf, nbyte);
493}
494
495off_t _lseek(int fd, off_t offset, int whence)
496{
497    return LOS_Lseek(fd, offset, whence);
498}
499……
500```
501
502## 板级系统移植
503
504### 驱动移植
505
506#### SoC芯片平台HDF驱动移植
507
508驱动适配相关文件放置在`drivers/adapter/platform`中,对应有`gpio`,`i2c`,`pwm`,`spi`,`uart`,`watchdog`,都是通过`HDF`机制加载,本章节以`gpio`为例进行详细说明。
509
510##### GPIO驱动适配
511
512`gpio`驱动适配需要完成编译的适配、源码的适配。
513
514在`//drivers/adapter/platform/gpio/BUILD.gn`文件中,描述了恒玄`gpio`驱动的编译适配。如下:
515
516```
517module_switch = defined(LOSCFG_DRIVERS_HDF_PLATFORM_GPIO)	 --- 如果打开HDF的GPIO配置开关,才进行如下编译
518module_name = get_path_info(rebase_path("."), "name")
519
520hdf_driver(module_name) {
521  sources = []
522  if (defined(LOSCFG_SOC_COMPANY_BESTECHNIC)) {				 --- 如果打开恒玄的芯片配置开关,才进行恒玄GPIO的驱动编译
523    sources += [ "gpio_bes.c" ]
524  }
525
526  include_dirs = [ "." ]
527}
528```
529
530在`//drivers/adapter/platform/gpio/gpio_bes.c`文件中,描述了恒玄`gpio`驱动的源码适配。
531首先,按照`OpenHarmony`的`HDF`驱动框架加载驱动基本适配框架,如下:
532
533```
534struct HdfDriverEntry g_GpioDriverEntry = {
535    .moduleVersion = 1,
536    .moduleName = "BES_GPIO_MODULE_HDF",
537    .Bind = GpioDriverBind,
538    .Init = GpioDriverInit,
539    .Release = GpioDriverRelease,
540};
541HDF_INIT(g_GpioDriverEntry); 	 --- 通过HDF_INIT 加载GPIO驱动
542```
543
544然后,在初始化的时候会获取`hcs`参数进行初始化,如下:
545
546```
547static int32_t GpioDriverInit(struct HdfDeviceObject *device)
548{
549    int32_t ret;
550    struct GpioCntlr *gpioCntlr = NULL;
551
552    if (device == NULL) {
553        HDF_LOGE("%s: device is NULL", __func__);
554        return HDF_ERR_INVALID_PARAM;
555    }
556
557    gpioCntlr = GpioCntlrFromDevice(device); 	 --- gpioCntlr节点变量就可以获取具体gpio配置
558    if (gpioCntlr == NULL) {
559      ...
560```
561
562编码规范和设计思想见[bes 驱动适配PR](https://gitee.com/openharmony/drivers_adapter/pulls/278)的评论。
563
564#### Board外设器件HDF驱动移植
565
566`Board`外设器件表示通过`SoC`平台总线连接的外设器件,在本案例中,显示屏属于外设器件,其驱动适配放在`//device/board/fnlink/drivers/liteos_m`目录中。
567
568##### 显示驱动适配
569
570同`SoC`驱动适配,在`//device/board/fnlink/drivers/liteos_m/display/BUILD.gn`文件中,根据`hdf_driver`模板加载驱动模块,如下:
571
572```
573module_name = get_path_info(rebase_path("."), "name")
574hdf_driver(module_name) {
575  sources = [
576    "zzw395.c",
577  ]
578  include_dirs = [
579    "//drivers/peripheral/display/interfaces/include",
580  ...
581  ]
582}
583```
584
585在`//device/board/fnlink/drivers/liteos_m/display/zzw395.c`文件中,根据驱动框架加载显示驱动,如下:
586
587```
588static struct HdfDriverEntry g_ZZW395DriverEntry = {
589    .moduleVersion = 1,
590    .moduleName = "HDF_PANEL_ZZW395",
591    .Bind = PanelDriverBind,
592    .Init = PanelDriverInit,
593    .Release = PanelDriverRelease,
594};
595
596HDF_INIT(g_ZZW395DriverEntry);
597```
598
599其中的驱动参数根据`hcs`配置,在`PanelDriverInit`初始化时加载,如下:
600
601```
602static int32_t PanelDriverInit(struct HdfDeviceObject *object)
603{
604    if (object == NULL) {
605        return HDF_FAILURE;
606    }
607    HDF_LOGD("%s entry !!!", __func__);
608    if (object->property) {
609        if (PanelGetResource(&priv, object->property) != HDF_SUCCESS) {
610            HDF_LOGE("%s: PanelGetResource failed", __func__);
611            return HDF_FAILURE;
612        }
613    }
614...
615```
616
617### OpenHarmony子系统适配
618
619`OpenHarmony`子系统适配一般包含两部分:
620
621- 在`config.json`中增加对应子系统和部件,这样编译系统会将该部件纳入编译目标中。
622- 针对该部件的`HAL`层接口进行硬件适配,或者可选的软件功能适配。
623
624#### 分布式软总线子系统适配
625
626##### wifi_lite部件适配
627
628首先,在`config.json`文件中,增加`communication`子系统的`wifi_lite`部件,如下:
629
630```
631    {
632      "subsystem": "communication",
633      "components": [
634        {
635          "component": "wifi_lite",
636          "optional": "true"
637        }
638      ]
639    },
640```
641
642`wifi_lite`部件在`//build/lite/components/communication.json`文件中,描述如下:
643
644```
645    {
646      "component": "wifi_lite",
647……
648      "targets": [
649        "//foundation/communication/wifi_lite:wifi"		 --- wifi_lite的编译目标
650      ],
651……
652    },
653
654```
655
656在`//foundation/communication/wifi_lite/BUILD.gn`文件中,描述需要适配的接口头文件路径,如下:
657
658```
659config("include") {
660  include_dirs = [ "interfaces/wifiservice" ]	 --- 因为wifi_lite只提供头文件,不提供wifi的具体实现,所以wifi模块暴露出适配的目录路径提供给硬件厂商来适配,厂商提供wifi协议栈源码实现。
661}
662
663group("wifi") {
664  public_configs = [ ":include" ]
665}
666```
667
668因为在本案例中,`wifi`属于`SoC`提供的功能,所以适配源码放在`SoC`的`//device/soc/bestechnic/hals/communication/wifi_lite/wifiservice`目录下,包含`wifi_device.c`和`wifi_hotspot.c`分别适配`wifi_device.h`和`wifi_hotspot.h`。如下:
669
670```
671……
672WifiErrorCode Scan(void)	 --- wifi_device.c中扫描wifi热点的函数,对wifi_device.h中Scan函数的适配实现
673{
674    WifiErrorCode ret = ERROR_WIFI_BUSY;
675
676
677    if (IsWifiActive() != WIFI_STA_ACTIVE)
678        return ERROR_WIFI_IFACE_INVALID;
679
680    if (g_HalHmosWifiInfo.scan_state == SCAN_REQUEST ||
681        g_HalHmosWifiInfo.scan_state == SCAN_TRIGGER)
682        return ERROR_WIFI_BUSY;
683
684    HalHmosWifiLock();
685    ret = ((HalHmosSendEvent(HMOS_ON_WIFI_SCAN_STATE_CHANGED, NULL) == 0) ? WIFI_SUCCESS : ERROR_WIFI_BUSY);
686    HalHmosWifiUnLock();
687
688    return ret;
689}
690……
691int GetSignalLevel(int rssi, int band)	 --- wifi_hotspot.c中获取wifi信号热点函数,对wifi_hotspot.h中GetSignalLevel函数的适配实现。
692{
693    if (band == HOTSPOT_BAND_TYPE_2G) {
694        if (rssi >= RSSI_LEVEL_4_2_G)
695            return RSSI_LEVEL_4;
696        if (rssi >= RSSI_LEVEL_3_2_G)
697            return RSSI_LEVEL_3;
698        if (rssi >= RSSI_LEVEL_2_2_G)
699            return RSSI_LEVEL_2;
700        if (rssi >= RSSI_LEVEL_1_2_G)
701            return RSSI_LEVEL_1;
702    }
703
704    if (band == HOTSPOT_BAND_TYPE_5G) {
705        if (rssi >= RSSI_LEVEL_4_5_G)
706            return RSSI_LEVEL_4;
707        if (rssi >= RSSI_LEVEL_3_5_G)
708            return RSSI_LEVEL_3;
709        if (rssi >= RSSI_LEVEL_2_5_G)
710            return RSSI_LEVEL_2;
711        if (rssi >= RSSI_LEVEL_1_5_G)
712            return RSSI_LEVEL_1;
713    }
714    return ERROR_WIFI_INVALID_ARGS;
715}
716```
717
718##### LWIP部件适配
719
720`LiteOS-M kernel`目录下默认配置了`lwip`,因而具有编译功能,可以在`kernel`组件中指定`lwip`编译的目录。如下:
721
722```
723    {
724      "subsystem": "kernel",
725      "components": [
726        {
727          "component": "liteos_m",
728          "features": [
729            "ohos_kernel_liteos_m_lwip_path = \"//device/soc/bestechnic/bes2600/liteos_m/components/net/lwip-2.1\""		 --- 指定在芯片厂商目录中进行适配
730          ]
731        }
732      ]
733    },
734```
735
736在`//device/soc/bestechnic/bes2600/liteos_m/components/net/lwip-2.1/BUILD.gn`文件中,描述了`lwip`的编译,如下:
737
738```
739import("//kernel/liteos_m/liteos.gni")
740import("$LITEOSTHIRDPARTY/lwip/lwip.gni")
741import("$LITEOSTOPDIR/components/net/lwip-2.1/lwip_porting.gni")
742
743module_switch = defined(LOSCFG_NET_LWIP_SACK)
744module_name = "lwip"
745kernel_module(module_name) {
746  sources = LWIP_PORTING_FILES + LWIPNOAPPSFILES -
747            [ "$LWIPDIR/api/sockets.c" ] + [ "porting/src/ethernetif.c" ]		 --- 增加ethernetif.c文件,用以适配ethernet网卡的初始化适配
748  defines = [ "LITEOS_LWIP=1" ]
749  defines += [ "CHECKSUM_BY_HARDWARE=1" ]
750}
751
752config("public") {
753  defines = [ "_BSD_SOURCE=1" ]
754  include_dirs =
755      [ "porting/include" ] + LWIP_PORTING_INCLUDE_DIRS + LWIP_INCLUDE_DIRS
756}
757
758```
759
760在`//device/soc/bestechnic/bes2600/liteos_m/components/net/lwip-2.1/porting/include/lwip/lwipopts.h`文件中,说明原有`lwip`配置选项保持不变,软总线会依赖这些配置选项,并且新增硬件适配的配置项,如下:
761
762```
763#ifndef _PORTING_LWIPOPTS_H_
764#define _PORTING_LWIPOPTS_H_
765
766#include_next "lwip/lwipopts.h"				 --- 保持原来的配置项不变
767
768#define LWIP_NETIF_STATUS_CALLBACK      1
769#define LWIP_CHECKSUM_ON_COPY           0
770#define CHECKSUM_GEN_UDP                0	 --- 新增硬件适配选项
771
772#endif /* _PORTING_LWIPOPTS_H_ */
773
774```
775
776在`//device/soc/bestechnic/bes2600/liteos_m/components/net/lwip-2.1/porting/src/ethernetif.c`文件中,说明对`ethernet`网卡初始化的适配,如下:
777
778```
779err_t
780ethernetif_init(struct netif *netif)
781{
782……
783#ifdef CHECKSUM_BY_HARDWARE
784    eth_hw_checksum_init();
785#endif
786……
787    netif->linkoutput = low_level_output;
788
789    netif->drv_send = liteos_low_level_output;
790    netif->hwaddr_len = NETIF_MAX_HWADDR_LEN;
791    low_level_init(netif);
792    driverif_init(netif);
793    return ERR_OK;
794……
795}
796```
797
798##### dsoftbus部件适配
799
800在`config.json`中增加`dsoftbus`部件配置如下:
801
802```
803{
804  "component": "dsoftbus",
805  "features": [
806    "softbus_adapter_config = \"//vendor/bestechnic/mini_distributed_music_player/dsoftbus_lite_config\""
807  ]
808},
809```
810
811`dsoftbus`部件在`//foundation/communication/dsoftbus/dsoftbus.gni`文件中提供了`softbus_adapter_config`配置选项可供移植过程进行配置,该配置设定了软总线移植适配的路径。
812
813在本案例中,`softbus_adapter_config`配置为`//vendor/bestechnic/mini_distributed_music_player/dsoftbus_lite_config`路径,该路径下的内容为:
814
815```
816.
817├── feature_config					--- 软总线功能特性配置,例如是否开启自发现功能等
818│   └── mini
819│       └── config.gni
820└── spec_config						--- 软总线规格特性配置,例如设置软总线日志级别设置
821    ├── softbus_config_adapter.c
822    ├── softbus_config_adapter.h
823    └── softbus_config_type.h
824```
825
826在`config.gni`文件中规定了以下配置项:
827
828| 配置项                                     | 描述                     |
829| ------------------------------------------ | ------------------------ |
830| dsoftbus_feature_disc_ble         | 是否开启BLE发现功能      |
831| dsoftbus_feature_disc_coap        | 是否开启COAP发现功能     |
832| dsoftbus_feature_conn_tcp         | 是否开启TCP连接功能      |
833| dsoftbus_feature_conn_br          | 是否开启BR连接功能       |
834| dsoftbus_feature_conn_ble         | 是否开启BLE连接功能      |
835| dsoftbus_feature_conn_p2p         | 是否开启P2P连接功能      |
836| dsoftbus_feature_trans_udp        | 是否开启UDP传输功能      |
837| dsoftbus_feature_trans_udp_stream | 是否开启UDP传输流功能    |
838| dsoftbus_feature_trans_udp_file   | 是否开启UDP传输文件功能  |
839| dsoftbus_feature_ip_auth          | 是否开启认证传输通道功能 |
840| dsoftbus_feature_auth_account     | 是否开启基于账号认证功能 |
841| dsoftbus_feature_qos              | 是否开启QoS功能          |
842
843在`softbus_config_adapter.c`文件中规定了以下配置项:
844
845| 配置项                               | 描述                          |
846| ------------------------------------ | ----------------------------- |
847| SOFTBUS_INT_MAX_BYTES_LENGTH         | SendBytes发送最大Bytes长度    |
848| SOFTBUS_INT_MAX_MESSAGE_LENGTH       | SendMessage发送最大消息的长度 |
849| SOFTBUS_INT_CONN_BR_MAX_DATA_LENGTH  | 蓝牙最大接收数据量            |
850| SOFTBUS_INT_CONN_RFCOM_SEND_MAX_LEN  | 蓝牙最大接收数据量            |
851| SOFTBUS_INT_ADAPTER_LOG_LEVEL        | 日志级别设置                  |
852| SOFTBUS_STR_STORAGE_DIRECTORY        | 存储目录设置                  |
853
854因为软总线配置了后,不会默认启动,所以需要在通过启动框架调用`InitSoftBusServer`函数,如下:
855
856```
857static void DSoftBus(void)
858{
859    osThreadAttr_t attr;
860    attr.name = "dsoftbus task";
861    attr.attr_bits = 0U;
862    attr.cb_mem = NULL;
863    attr.cb_size = 0U;
864    attr.stack_mem = NULL;
865    attr.stack_size = 65536;
866    attr.priority = 24;
867
868    extern void InitSoftBusServer(void);
869    if (osThreadNew((osThreadFunc_t) InitSoftBusServer, NULL, &attr) == NULL) {
870        printf("Failed to create WifiSTATask!\n");
871    }
872}
873
874APP_FEATURE_INIT(DSoftBus);
875```
876
877##### RPC部件适配
878
879在`config.json`中增加`rpc`部件配置如下:
880
881```
882{
883  "component": "rpc"
884},
885```
886
887同样地,`rpc`部件需要通过启动框架调用`StartDBinderService`函数,由于该函数正常运行依赖主机已经获取`IP`地址,因此在`LWIP`协议栈注册`IP`地址变化事件的回调函数中调用该函数,如下:
888
889```
890static void RpcServerWifiDHCPSucCB(struct netif *netif, netif_nsc_reason_t reason,
891                                   const netif_ext_callback_args_t *args)
892{
893    (void) args;
894    if (netif == NULL) {
895        printf("%s %d, error: input netif is NULL!\n", __FUNCTION__, __LINE__);
896        return;
897    }
898    if (reason == LWIP_NSC_IPSTATUS_CHANGE) {
899        if (netif_is_up(netif) && !ip_addr_isany(&netif->ip_addr)) {
900            printf("%s %d, start rpc server!\n", __FUNCTION__, __LINE__);
901            StartDBinderService();
902        }
903    }
904}
905
906static void WifiDHCPRpcServerCB(void)
907{
908    NETIF_DECLARE_EXT_CALLBACK(WifiReadyRpcServerCallback);
909    netif_add_ext_callback(&WifiReadyRpcServerCallback, RpcServerWifiDHCPSucCB);
910}
911
912APP_FEATURE_INIT(WifiDHCPRpcServerCB);
913```
914
915#### 启动恢复子系统适配
916
917启动恢复子系统适配`bootstrap_lite`/`syspara_lite`两个部件。请在`vendor/bestechnic_bak/display_demo/config.json`中新增对应的配置选项。
918
919```
920{
921  "subsystem": "startup",
922  "components": [
923	{
924	  "component": "bootstrap_lite"		 --- bootstrap_lite 部件
925	},
926	{
927	  "component": "syspara_lite",		 --- syspara_lite 部件
928	  "features": [
929		"enable_ohos_startup_syspara_lite_use_posix_file_api = true"
930	  ]
931	}
932  ]
933},
934```
935
936适配`bootstrap_lite`部件时,需要在连接脚本文件`//device/soc/bestechnic/bes2600/liteos_m/sdk/bsp/out/best2600w_liteos/_best2001.lds`中手动新增如下段:
937
938```
939       __zinitcall_bsp_start = .;
940      KEEP (*(.zinitcall.bsp0.init))
941      KEEP (*(.zinitcall.bsp1.init))
942      KEEP (*(.zinitcall.bsp2.init))
943      KEEP (*(.zinitcall.bsp3.init))
944      KEEP (*(.zinitcall.bsp4.init))
945      __zinitcall_bsp_end = .;
946      __zinitcall_device_start = .;
947      KEEP (*(.zinitcall.device0.init))
948      KEEP (*(.zinitcall.device1.init))
949      KEEP (*(.zinitcall.device2.init))
950      KEEP (*(.zinitcall.device3.init))
951      KEEP (*(.zinitcall.device4.init))
952      __zinitcall_device_end = .;
953      __zinitcall_core_start = .;
954      KEEP (*(.zinitcall.core0.init))
955      KEEP (*(.zinitcall.core1.init))
956      KEEP (*(.zinitcall.core2.init))
957      KEEP (*(.zinitcall.core3.init))
958      KEEP (*(.zinitcall.core4.init))
959      __zinitcall_core_end = .;
960      __zinitcall_sys_service_start = .;
961      KEEP (*(.zinitcall.sys.service0.init))
962      KEEP (*(.zinitcall.sys.service1.init))
963      KEEP (*(.zinitcall.sys.service2.init))
964      KEEP (*(.zinitcall.sys.service3.init))
965      KEEP (*(.zinitcall.sys.service4.init))
966      __zinitcall_sys_service_end = .;
967      __zinitcall_sys_feature_start = .;
968      KEEP (*(.zinitcall.sys.feature0.init))
969      KEEP (*(.zinitcall.sys.feature1.init))
970      KEEP (*(.zinitcall.sys.feature2.init))
971      KEEP (*(.zinitcall.sys.feature3.init))
972      KEEP (*(.zinitcall.sys.feature4.init))
973      __zinitcall_sys_feature_end = .;
974      __zinitcall_run_start = .;
975      KEEP (*(.zinitcall.run0.init))
976      KEEP (*(.zinitcall.run1.init))
977      KEEP (*(.zinitcall.run2.init))
978      KEEP (*(.zinitcall.run3.init))
979      KEEP (*(.zinitcall.run4.init))
980      __zinitcall_run_end = .;
981      __zinitcall_app_service_start = .;
982      KEEP (*(.zinitcall.app.service0.init))
983      KEEP (*(.zinitcall.app.service1.init))
984      KEEP (*(.zinitcall.app.service2.init))
985      KEEP (*(.zinitcall.app.service3.init))
986      KEEP (*(.zinitcall.app.service4.init))
987      __zinitcall_app_service_end = .;
988      __zinitcall_app_feature_start = .;
989      KEEP (*(.zinitcall.app.feature0.init))
990      KEEP (*(.zinitcall.app.feature1.init))
991      KEEP (*(.zinitcall.app.feature2.init))
992      KEEP (*(.zinitcall.app.feature3.init))
993      KEEP (*(.zinitcall.app.feature4.init))
994      __zinitcall_app_feature_end = .;
995      __zinitcall_test_start = .;
996      KEEP (*(.zinitcall.test0.init))
997      KEEP (*(.zinitcall.test1.init))
998      KEEP (*(.zinitcall.test2.init))
999      KEEP (*(.zinitcall.test3.init))
1000      KEEP (*(.zinitcall.test4.init))
1001      __zinitcall_test_end = .;
1002      __zinitcall_exit_start = .;
1003      KEEP (*(.zinitcall.exit0.init))
1004      KEEP (*(.zinitcall.exit1.init))
1005      KEEP (*(.zinitcall.exit2.init))
1006      KEEP (*(.zinitcall.exit3.init))
1007      KEEP (*(.zinitcall.exit4.init))
1008      __zinitcall_exit_end = .;
1009```
1010
1011需要新增上述段是因为`bootstrap_init`提供的对外接口,见`//utils/native/lite/include/ohos_init.h`文件,采用的是灌段的形式,最终会保存到上述链接段中。主要的服务自动初始化宏如下表格所示:
1012
1013| 接口名                 | 描述                             |
1014| ---------------------- | -------------------------------- |
1015| SYS_SERVICE_INIT(func) | 标识核心系统服务的初始化启动入口 |
1016| SYS_FEATURE_INIT(func) | 标识核心系统功能的初始化启动入口 |
1017| APP_SERVICE_INIT(func) | 标识应用层服务的初始化启动入口   |
1018| APP_FEATURE_INIT(func) | 标识应用层功能的初始化启动入口   |
1019
1020![](../public_sys-resources/icon-note.gif) **说明:**
1021	通过上面加载的组件编译出来的lib文件需要手动加入强制链接。
1022
1023​	如在 `vendor/bestechnic/display_demo/config.json` 中配置了`bootstrap_lite` 部件
1024
1025```
1026    {
1027      "subsystem": "startup",
1028      "components": [
1029        {
1030          "component": "bootstrap_lite"
1031        },
1032        ...
1033      ]
1034    },
1035```
1036
1037​	`bootstrap_lite`部件会编译`//base/startup/bootstrap_lite/services/source/bootstrap_service.c`,该文件中,通过`SYS_SERVICE_INIT`将`Init`函数符号灌段到`__zinitcall_sys_service_start`和`__zinitcall_sys_service_end`中,由于`Init`函数是没有显式调用它,所以需要将它强制链接到最终的镜像。如下:
1038
1039```
1040static void Init(void)
1041{
1042    static Bootstrap bootstrap;
1043    bootstrap.GetName = GetName;
1044    bootstrap.Initialize = Initialize;
1045    bootstrap.MessageHandle = MessageHandle;
1046    bootstrap.GetTaskConfig = GetTaskConfig;
1047    bootstrap.flag = FALSE;
1048    SAMGR_GetInstance()->RegisterService((Service *)&bootstrap);
1049}
1050SYS_SERVICE_INIT(Init);   --- 通过SYS启动即SYS_INIT启动就需要强制链接生成的lib
1051```
1052
1053​	在`//base/startup/bootstrap_lite/services/source/BUILD.gn`文件中,描述了在`out/v200zr/display_demo/libs` 生成 `libbootstrap.a`,如下:
1054
1055```
1056static_library("bootstrap") {
1057  sources = [
1058    "bootstrap_service.c",
1059    "system_init.c",
1060  ]
1061  ....
1062```
1063
1064​	那么需要在 `vendor/bestechnic/display_demo/config.json` 配置强制链接库`bootstrap`,如下:
1065
1066```
1067  "bin_list": [
1068    {
1069      "elf_name": "wifiiot",
1070      "bsp_target_name": "best2600w_liteos",
1071      "signature": "false",
1072      "burn_name": "rtos_main",
1073      "enable": "true",
1074      "force_link_libs": [
1075        "bootstrap",	 --- 强制链接libbootstrap.a
1076        ...
1077      ]
1078    },
1079```
1080
1081
1082
1083适配`syspara_lite`部件时,系统参数会最终写到文件中进行持久化保存。在轻量系统中,文件操作相关接口有`POSIX`接口与`HalFiles`接口这两套实现。
1084
1085因为对接内核的文件系统,采用`POSIX`相关的接口,所以`features`字段中需要增加`enable_ohos_startup_syspara_lite_use_posix_file_api = true`。
1086
1087如果对接`HalFiles`相关的接口实现的,则无须修改。
1088
1089在适配`GetSerial`接口时,开发板不像产线生产过程那样,会写入一个具体的`Serial Number`,因而需要确定一个数据对开发板进行唯一标识。本案例采用`WiFi Mac`地址进行适配。
1090
1091```
1092#define ETH_ALEN 6
1093#define MAC_BITS 4
1094#define MAC_HIGH_MASK 0xf0
1095#define MAC_LOW_MASK 0x0f
1096#define HEX_A 0xa
1097#define CHAR_NUM_OFFSET 0x30
1098#define CHAR_CAPITAL_OFFSET 0x37
1099#define STR_END_FLAG '\0'
1100
1101typedef unsigned char               u8;
1102
1103static char serialNumber[2*ETH_ALEN + 1];		 --- 最后一位留作'\0'结束符标识
1104
1105
1106static char Hex2Char(u8 hex)
1107{
1108    if (hex < HEX_A) {
1109        return hex + CHAR_NUM_OFFSET;			 --- 将数值0转为char的'0'
1110    } else {
1111        return hex + CHAR_CAPITAL_OFFSET;		 --- 将数值0xa转为char的'A'
1112    }
1113}
1114
1115const char* HalGetSerial(void)
1116{
1117    char macAddr[ETH_ALEN];
1118    // as devboard has no production serial number, we just
1119    // use wifi mac address as device serial number.
1120    if (serialNumber[0] == STR_END_FLAG) {		 --- 只有第一次调用时,才去获取mac地址
1121        extern int bwifi_get_own_mac(u8 *addr);
1122        bwifi_get_own_mac(macAddr);				 --- 获取mac地址
1123        int j = 0;
1124        for (int i = 0; i < ETH_ALEN; i++) {
1125            u8 lowFour, highFour;
1126            highFour = (macAddr[i] & MAC_HIGH_MASK) >> MAC_BITS;
1127            serialNumber[j] = Hex2Char(highFour);
1128            j++;
1129            lowFour = macAddr[i] & MAC_LOW_MASK;
1130            serialNumber[j] = Hex2Char(lowFour);
1131            j++;
1132        }		 --- 将mac地址值转化为serial number
1133    }
1134    return serialNumber;
1135}
1136```
1137
1138#### DFX子系统适配
1139
1140进行`DFX`子系统适配需要添加`hilog_lite`部件,直接在`config.json`文件配置即可。
1141
1142```
1143{
1144  "subsystem": "hiviewdfx",
1145  "components": [
1146	{
1147	  "component": "hilog_lite",
1148	  "optional": "true"
1149	}
1150  ]
1151},
1152```
1153
1154配置完成之后,在`//device/soc/bestechnic/bes2600/liteos_m/components/utils/src/hm_sys.c`中注册日志输出实现函数。
1155
1156```
1157boolean HilogProc_Impl(const HiLogContent *hilogContent, uint32 len)
1158{
1159    char tempOutStr[LOG_FMT_MAX_LEN] = {0};
1160    if (LogContentFmt(tempOutStr, sizeof(tempOutStr), hilogContent) > 0) {
1161        printf(tempOutStr);
1162    }
1163	return TRUE;
1164}
1165
1166HiviewRegisterHilogProc(HilogProc_Impl);
1167```
1168
1169#### 系统服务管理子系统适配
1170
1171进行系统服务管理子系统适配需要添加`samgr_lite`部件,直接在`config.json`配置即可。
1172
1173```
1174{
1175  "subsystem": "systemabilitymgr",
1176  "components": [
1177	{
1178	  "component": "samgr_lite",
1179	  "features": [
1180		"config_ohos_systemabilitymgr_samgr_lite_shared_task_size = 4096"
1181	  ]
1182	}
1183  ]
1184},
1185```
1186
1187在轻量系统中,`samgr_lite`配置的共享任务栈大小默认为`0x800`。当函数调用栈较大时,会出现栈溢出的问题。在本次适配过程中,将其调整为`0x1000`。
1188
1189#### 安全子系统适配
1190
1191进行安全子系统适配需要添加`huks/deviceauth_lite`部件,直接在`config.json`配置即可。
1192
1193```
1194    {
1195      "subsystem": "security",
1196      "components": [
1197        {
1198          "component": "huks",
1199          "features": [
1200            "huks_use_lite_storage = true",
1201            "huks_use_hardware_root_key = true",
1202            "huks_config_file = \"hks_config_lite.h\"",
1203            "huks_key_store_path = \"/data/\"",
1204            "ohos_security_huks_mbedtls_porting_path = \"//device/soc/bestechnic/hals/mbedtls\""
1205          ]
1206        },
1207        {
1208          "component": "deviceauth_lite",
1209          "features": [
1210            "deviceauth_storage_path = \"/data/\"",
1211            "deviceauth_hichain_thread_stack_size = 9472"
1212          ]
1213        }
1214      ]
1215    }
1216```
1217
1218`huks`部件适配时,`huks_key_store_path`配置选项用于指定存放秘钥路径,`ohos_security_huks_mbedtls_porting_path`配置选项用于指定进行`mbedtls`适配的目录,用于芯片对`mbedtls`进行硬件随机数等适配。
1219
1220`deviceauth_lite`部件适配时,`deviceauth_storage_path`配置选项用于指定存放设备认证信息的路径,`deviceauth_hichain_thread_stack_size`用于指定线程栈大小。
1221
1222#### 媒体子系统适配
1223
1224进行媒体子系统适配需要添加`histreamer`部件,直接在`config.json`配置即可。
1225
1226```
1227{
1228  "subsystem": "multimedia",
1229  "components": [
1230    {
1231      "component": "histreamer",
1232      "features": [
1233        "multimedia_histreamer_enable_plugin_hdi_adapter = true",
1234        "multimedia_histreamer_enable_plugin_minimp3_adapter = true",
1235        "multimedia_histreamer_enable_plugin_ffmpeg_adapter = false",
1236        "config_ohos_multimedia_histreamer_stack_size = 65536"
1237      ]
1238    }
1239  ]
1240},
1241```
1242
1243`histreamer`部件配置项说明如下:
1244
1245| 配置项                                              | 说明                            |
1246| --------------------------------------------------- | ------------------------------- |
1247| multimedia_histreamer_enable_plugin_hdi_adapter     | 是否使能histreamer对接到hdi接口 |
1248| multimedia_histreamer_enable_plugin_minimp3_adapter | 是否使能插件适配minimp3         |
1249| multimedia_histreamer_enable_plugin_ffmpeg_adapter  | 是否使能插件适配FFmpeg          |
1250| config_ohos_multimedia_histreamer_stack_size        | histreamer栈大小设置            |
1251
1252#### 公共基础库子系统适配
1253
1254进行公共基础库子系统适配需要添加`kv_store`/`js_builtin`/`timer_task`/`kal_timer`部件,直接在`config.json`配置即可。
1255
1256```
1257{
1258  "subsystem": "utils",
1259  "components": [
1260	{
1261	  "component": "kv_store",
1262	  "features": [
1263		"enable_ohos_utils_native_lite_kv_store_use_posix_kv_api = true"
1264	  ]
1265	},
1266	{
1267	  "component": "js_builtin"
1268	},
1269	{
1270	  "component": "timer_task"
1271	},
1272	{
1273	  "component": "kal_timer",
1274	}
1275  ]
1276},
1277```
1278
1279与适配`syspara_lite`部件类似,适配`kv_store`部件时,键值对会写到文件中。在轻量系统中,文件操作相关接口有`POSIX`接口与`HalFiles`接口这两套实现。因为对接内核的文件系统,采用`POSIX`相关的接口,所以`features`需要增加`enable_ohos_utils_native_lite_kv_store_use_posix_kv_api = true`。如果对接`HalFiles`相关的接口实现的,则无须修改。
1280
1281#### 图形子系统适配
1282
1283进行图形子系统适配需要添加`graphic_utils`部件,直接在`config.json`配置即可。
1284
1285```
1286    {
1287      "components": [
1288        {
1289          "component": "graphic_utils",
1290          "features": [
1291            "enable_ohos_graphic_utils_product_config = true"
1292          ]
1293        },
1294        {
1295          "component": "ui"
1296        }
1297      ]
1298    },
1299```
1300
1301`graphic`配置文件见 `//vendor/bestechnic/display_demo/graphic_config/product_graphic_lite_config.h`。
1302
1303`graphic`适配见`//device/soc/bestechnic/bes2600/liteos_m/components/ui`, 主要功能如下:
1304
1305- `display_device`:实例化`BaseGfxEngine`。
1306- `touch_input`:实例化`PointerInputDevice`。
1307- `UiMainTask`:初始化字体引擎,执行渲染任务等。
1308
1309图形子系统层次:
1310
1311```
1312aafwk_lite + appexecfwk_lite    (AAFWK + APPEXECFWK)
1313      |
1314ace_engine_lite + jerryscript + i18n_lite + resmgr_lite + utils/native/lite/... (ACE,JS引擎及其依赖)
1315      |
1316graphic_ui + graphic_utils      (图形框架)
1317      |
1318giflib + libjpeg + libpng + qrcodegen + freetype... (图形第三方库)
1319```
1320
1321图形应用示例见文件`//vendor/bestechnic/display_demo/tests/app.cpp`,如下:
1322
1323```
1324/* ui app entry */
1325void RunApp()
1326{
1327#ifdef UI_TEST
1328    AnimatorDemoStart(); 	 --- native ui demo
1329#elif defined(ABILITY_TEST)
1330    StartJSApp(); 			 --- js demo
1331#endif
1332}
1333
1334void AppEntry(void)
1335{
1336    UiMain();
1337}
1338
1339APP_FEATURE_INIT(AppEntry);
1340```
1341
1342#### ACE开发框架子系统适配
1343
1344进行`ACE`开发框架子系统适配需要添加`ace_engine_lite`部件,直接在`config.json`配置即可。
1345
1346    {
1347      "subsystem": "ace",
1348      "components": [
1349        {
1350          "component": "ace_engine_lite",
1351          "features": [
1352            "enable_ohos_ace_engine_lite_product_config = true"
1353          ]
1354        }
1355      ]
1356    },
1357
1358`ace_engine_lite`部件配置文件见 `//vendor/bestechnic/display_demo/ace_lite_config/product_acelite_config.h`。
1359
1360`ace_lite`的应用采用js语言进行开发,详细步骤如下:
1361
13621. 用`DevEco Studio`编写js应用,参考[轻量级智能穿戴开发](https://developer.harmonyos.com/cn/docs/documentation/doc-references/lite-wearable-file-0000001176751380)13632. 使用预览功能进行预览,并且得到js包:`entry\.preview\intermediates\res\debug\lite\assets\js\default`。
13643. 将js包放到对应的文件系统目录下,文件系统路径为`vendor/bestechnic/display_demo/fs/data/data/js`,如下:
1365
1366```
1367├── app.js
1368├── common
1369├── i18n
1370├── manifest.json
1371└── pages
1372```
1373
13744. 最终编译生成系统镜像,烧录到单板后,系统会从`app.js`加载启动`ace`的应用。
1375
1376#### 元能力子系统适配
1377
1378进行元能力子系统适配需要添加`aafwk_lite`部件,直接在`config.json`配置即可。
1379
1380```
1381    {
1382      "subsystem": "aafwk",
1383      "components": [
1384        {
1385          "component": "aafwk_lite",
1386          "features": [
1387            "enable_ohos_appexecfwk_feature_ability = true",	 --- 支持FA特性,即包含图形能力
1388            "config_ohos_aafwk_ams_task_size = 4096"			 --- 配置aafwk栈的大小
1389          ]
1390        }
1391      ]
1392    },
1393```
1394
1395`aafwk_lite`相关的应用样例见`vendor/bestechnic/display_demo/tests/ability`目录,包含`launcher`和`js app`这两类应用,应用的函数调用流程描述如下:
1396
13971. `launcher`应用,通过`InstallLauncher`安装`BundleName`为 `"com.example.launcher"`的`native ui`应用,在`AbilityMgrSliteFeature`启动后会调用`AbilityMgrHandler::StartLauncher()`启动`launcher`应用。
1398
13992. `StartJSApp`应用,通过`StartAbility`启动任意`Want`,通过将`want data`传递`JS_APP_PATH`,
1400   `SetWantData(&want, JS_APP_PATH, strlen(JS_APP_PATH) + 1)`。
1401
1402#### 包管理子系统适配
1403
1404进行包管理子系统适配需要添加`appexecfwk_lite`部件,直接在`config.json`配置即可。
1405
1406```
1407    {
1408      "subsystem": "appexecfwk",
1409      "components": [
1410        {
1411          "component": "appexecfwk_lite"
1412        }
1413      ]
1414    },
1415```
1416
1417## 兼容性认证
1418
1419### 产品兼容性规范
1420
1421产品兼容性规范文档请参考[产品兼容性SIG介绍](https://gitee.com/openharmony-sig/compatibility/tree/master)1422
1423### XTS用例
1424
1425`XTS`测试参考资料见[xts参考资料](../device-test/xts.md),进行`XTS`子系统适配需要添加`xts_acts`/`xts_tools`部件,直接在`config.json`配置即可,配置如下:
1426
1427    {
1428      "subsystem": "xts",
1429      "components": [
1430        { "component": "xts_acts", "features":
1431          [
1432            "config_ohos_xts_acts_utils_lite_kv_store_data_path = \"/data\"",
1433            "enable_ohos_test_xts_acts_use_thirdparty_lwip = true"
1434          ]
1435        },
1436        { "component": "xts_tools", "features":[] }
1437      ]
1438    }
1439
1440其中,
1441
1442- `config_ohos_xts_acts_utils_lite_kv_store_data_path` 是配置挂载文件系统根目录的名字。
1443- `enable_ohos_test_xts_acts_use_thirdparty_lwip` 表示如果使用`thirdparty/lwip`目录下的源码编译,则设置为`true`,否则设置为`false`。
1444
1445全部跑完会有显示`xx Tests xx Failures xx Ignored`,如下:
1446
1447```
1448...
1449[16:53:43:438]../../../test/xts/acts/utils_lite/kv_store_hal/src/kvstore_func_test.c:793:testKvStoreMaxSize004:PASS
1450[16:53:43:438]+-------------------------------------------+
1451[16:53:43:438]
1452[16:53:43:438]-----------------------
1453[16:53:43:438]32 Tests 0 Failures 0 Ignored
1454[16:53:43:438]OK
1455[16:53:43:439]All the test suites finished!
1456```
1457
1458### 报告提交
1459
1460将上图`XTS`用例的情况保存为测试报告,上传到`OpenHarmony`兼容性测试网站进行认证,作为`sig`仓库转正到`master`仓库的必要条件。详细步骤如下:
1461
1462步骤1:将`XTS`测试报告压缩成`zip`文件。
1463
1464步骤2:生成测试报告的`SHA`校验码。本案例是将`zip`文件传到在线生成`hash`的[网站]( https://tool.lmeee.com/jiami/filehash)生成`SHA`校验码。
1465
1466步骤3:进入`OpenHarmony`[兼容性测试网站](https://www.openharmony.cn/old/#/Compatibility_test)上传报告。
1467
1468 - 其中`API Level`填写报告中的`"sdkApiLevel"`字段
1469 - `OS`版本号填写报告中的`"OS Version"`字段。
1470
1471## todo
1472
1473后续会补充以下方面的移植:
1474
1475- 蓝牙
1476- `bms`包安装
1477- 验证运行`JS`的`bytecode`
1478- 分布式能力:`dms`、`dm`
1479- 分布式音乐播放器样例
1480
1481porting-bes2600w-on-minisystem-display-demo.md