Linux下编译海思WS63 SDK全攻略

目录

引言

准备工作

编译方法

UTF-8问题的解决

结束语

---

引言

一般使用海思的WS63 SDK都是在Windows进行编译，以前在我博客也介绍过。不过以我多年的经验，总会有学生的电脑因为各种原因无法编译成功，所以还需要试试Linux下编译的方法作为备份推荐给学生。我基本上是按照官方文档做的（docs/zh-CN/software/SDK开发环境搭建用户指南/WS63V100 SDK开发环境搭建 用户指南.md · HiSpark/fbb_ws63 - Gitee.com），记录了几个自己遇到的问题。

准备工作

Linux系统推荐使用Ubuntu 20.04及以上版本，Shell使用bash ，SDK使用Cmake编译（3.14.1以上），编译工具还包括Python（3.8.0以上）等。这里我使用的是华为云免费提供的开发者云电脑。海思的WS63 SDK体积较小，所以使用这个云电脑也是可以的，而且默认的云电脑的环境也是符合要求的。

安装Kconfiglib 14.1.0+，使用命令“sudo pip install kconfiglib”（需root/sudo权限安装）。

安装pycparser，使用pip install pycparser进行安装。

编译方法

使用下面的命令下载代码：

git clone https://gitee.com/HiSpark/fbb_ws63.git

在src目录下执行“python3 build.py”指令运行脚本编译，即可编译出对应的SDK程序。编译命令列表如表1所示。

表 1 build.sh参数列表

参数	示例	说明
无	python3 build.py ws63-liteos-app	启动ws63-liteos-app目标的增量编译。
-c	python3 build.py -c ws63-liteos-app	启动ws63-liteos-app目标的全量编译。
menuconfig	python3 build.py ws63-liteos-app menuconfig	启动ws63-liteos-app目标的menuconfig图形配置界面。

表 2 编译目标介绍

编译目标	说明
python3 build.py -c ws63-liteos-app	app版本编译目标（自动包含flashboot编译）
python3 build.py -c ws63-flashboot	flashboot镜像编译目标
python3 build.py -c ws63-liteos-xts	openharmony xts认证版本编译目标（详情请参考“鸿蒙XTS认证指导书”）
python3 build.py -c ws63-liteos-app-iot	Harmony connect版本编译目标（详情请参考“HiLink编译使用指南”）
python3 build.py -c ws63-liteos-hilink	Harmony connect独立升级版本编译目标（详情请参考“HiLink编译使用指南”）

编译得到的烧录镜像在“output/ws63/fwpkg/ws63-liteos-app”目录下（如表3所示）。

表 3 烧录镜像

文件名	说明
ws63-liteos-app_all.fwpkg	空片烧录时，需要烧录此文件。包含了所有的需要升级的内容。包含：root_loaderboot_sign.bin、root_params.bin、flashboot_sign.bin、ws63_all_nv.bin、ws63-liteos-app-sign.bin。 各文件介绍如下： root_loaderboot_sign.bin：loaderboot的镜像文件。升级开始时，芯片中固化的romboot会接收此镜像文件，加载到内存并运行，loadboot负责接收后续的镜像文件。注：此镜像只在升级阶段放在RAM中运行，并不存放在flash中。 root_params.bin：flash分区信息的镜像文件。分区信息供romboot、loaderboot和flashboot使用。 flashboot_sign.bin：flashboot的镜像文件。 ws63_all_nv.bin：参数区的镜像文件。 ws63-liteos-app-sign.bin：版本镜像文件。
ws63-liteos-app_load_only.fwpkg	版本升级打包文件，包含：root_loaderboot_sign.bin、ws63-liteos-app-sign.bin。不包含flashboot相关内容。 当芯片烧录过“ws63-liteos-app_all.fwpkg”镜像后，如果后续修改不涉及root_params、flash_boot、nv的修改，则可以用此文件升级。

注：编译得到的中间文件在“output/ws63/acore/ws63-liteos-app”目录下。

UTF-8问题的解决

按照上述步骤编译的时候，程序快要编译结束时遇到一个问题：

../../../../../output/ws63/acore/boot_bin/ws63-liteos-mfg.bin  generated successfully!!![100%] Built target WS63_GENERAT_SIGNBIN[100%] Built target GENERAT_ASM[100%] Built target GENERAT_LST[100%] MEM_LIMIT[100%] Built target GENERAT_MEM_LIMITTraceback (most recent call last):File "/home/developer/fbb_ws63/src/build/script/utils/mem_stats.py", line 716, in <module>main(sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4])File "/home/developer/fbb_ws63/src/build/script/utils/mem_stats.py", line 704, in mainlst_file.process()File "/home/developer/fbb_ws63/src/build/script/utils/mem_stats.py", line 394, in processsection = self.get_first_section()File "/home/developer/fbb_ws63/src/build/script/utils/mem_stats.py", line 337, in get_first_sectionif(self.find_file_sections()):File "/home/developer/fbb_ws63/src/build/script/utils/mem_stats.py", line 346, in find_file_sectionsfile_line = self.file.readline()File "/usr/lib/python3.10/codecs.py", line 322, in decode(result, consumed) = self._buffer_decode(data, self.errors, final)UnicodeDecodeError: 'utf-8' codec can't decode byte 0xb3 in position 4093: invalid start bytemake[2]: *** [CMakeFiles/GENERAT_MEM.dir/build.make:71：CMakeFiles/GENERAT_MEM] 错误 1make[1]: *** [CMakeFiles/Makefile2:5080：CMakeFiles/GENERAT_MEM.dir/all] 错误 2make: *** [Makefile:91：all] 错误 2######### Build target:ws63_liteos_app failed

这个问题是因为Python脚本在处理ws63-liteos-app.lst文件时遇到非标准的Unicode字符，所以报错了。要解决这个问题，可以修改一下 /home/developer/fbb_ws63/src/build/script/utils/mem_stats.py脚本，在696行，   在“with open(lst_file_name, "r") as fp_lst_file_name, open(”加上“,  errors='ignore'”，意思是遇到非法字符就忽略，从而避免了报错的发生。

这样就可以最终完成编译了。

 经过实际烧写测试，程序可以正常运行。 

结束语

至此，完成了Linux下的编译操作，作为一个备选项，可以在下学期的课程中推荐给学生。