目录
引言
一般使用海思的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问题的解决
按照上述步骤编译的时候，程序快要编译结束时遇到一个问题：
bash
../../../../../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_LIMIT
Traceback (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 main
lst_file.process()
File "/home/developer/fbb_ws63/src/build/script/utils/mem_stats.py", line 394, in process
section = self.get_first_section()
File "/home/developer/fbb_ws63/src/build/script/utils/mem_stats.py", line 337, in get_first_section
if(self.find_file_sections()):
File "/home/developer/fbb_ws63/src/build/script/utils/mem_stats.py", line 346, in find_file_sections
file_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 byte
make[2]: *** [CMakeFiles/GENERAT_MEM.dir/build.make:71：CMakeFiles/GENERAT_MEM] 错误 1
make[1]: *** [CMakeFiles/Makefile2:5080：CMakeFiles/GENERAT_MEM.dir/all] 错误 2
make: *** [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下的编译操作，作为一个备选项，可以在下学期的课程中推荐给学生。