使用 CLI 完成第一次开发#
本教程使用 FBB CLI,在 Windows PowerShell 或 Linux Bash 中完成 WS53 Hello World。两种系统使用相同的 SDK、Target、Kconfig 配置、固件格式和完成判据;命令壳层和串口名称按系统选择。
选择主机系统#
在本页每组标签中选择所用系统;相同标签会同步切换。
使用 Windows PowerShell 执行命令。
使用 Linux Bash 执行命令。WSL 2 使用本页 Linux 命令。
前置条件#
已按 Git 官方安装说明 和 Git LFS 官方安装说明安装 Git 与 Git LFS,且
git --version、git lfs version可以正常输出版本。具有安装工具和使用串口的权限。
有足够空间保存 SDK、工具链和构建输出,工作目录不含中文字符和空格。
已准备 HH-D170 星闪开发板 和可传输数据的 Type-C USB 数据线。
1. 获取 SDK#
在终端进入用于保存 SDK 的工作目录,执行以下命令:
git lfs install
git clone --branch master --single-branch https://gitcode.com/HiSpark/fbb_ws53.git
cd fbb_ws53
git lfs pull
进入 SDK 的 src 目录:
cd src
预期结果:Git LFS 文件下载完成,当前目录包含 build.py。如果 LFS 文件仍为指针文件,不要继续构建,先重新执行 git lfs pull。
2. 准备 CLI 和工具链#
按所用系统执行对应的 CLI 安装命令。已经安装 CLI 时可跳过安装命令。
在 PowerShell 中执行:
irm https://dl.hispark.hisilicon.com/bootstrap.ps1 | iex
在 Bash 中执行:
curl -fsSL https://dl.hispark.hisilicon.com/bootstrap.sh | sh
详细安装说明和手动配置方式见配置 WS53 开发环境。WS53 SDK 要求 fbb 不低于 1.1.0。
检查 CLI:
fbb -V
在 SDK 的 src 目录准备工具链和构建依赖:
fbb setup --sdk-dir .
检查环境:
fbb doctor
查看 SDK、Target 和工具链识别结果:
fbb describe --json
预期结果:fbb doctor 成功退出,fbb describe --json 能识别 ws53、ws53_liteos_app 和 WS53 所需工具链。
3. 配置 Hello World#
确认当前配置文件没有未保存的本地修改:
git diff --exit-code -- build/config/target_config/ws53/menuconfig/acore/ws53_liteos_app.config
使用 CLI 设置 Hello World 配置:
fbb config --target ws53_liteos_app set CONFIG_SAMPLE_ENABLE=y
fbb config --target ws53_liteos_app unset CONFIG_ENABLE_BT_SAMPLE
fbb config --target ws53_liteos_app set CONFIG_ENABLE_PERIPHERAL_SAMPLE=y
fbb config --target ws53_liteos_app set CONFIG_SAMPLE_SUPPORT_HELLOWORLD=y
检查配置值:
fbb config --target ws53_liteos_app get CONFIG_SAMPLE_ENABLE
fbb config --target ws53_liteos_app get CONFIG_ENABLE_BT_SAMPLE
fbb config --target ws53_liteos_app get CONFIG_ENABLE_PERIPHERAL_SAMPLE
fbb config --target ws53_liteos_app get CONFIG_SAMPLE_SUPPORT_HELLOWORLD
预期结果依次为 y、n、y、y。如果结果不同,重新执行对应的 set 或 unset 命令;不要直接编辑生成的 .config 文件。
4. 构建固件#
配置改变后执行干净构建:
fbb build --clean ws53_liteos_app
构建较慢时#
首次执行完整构建时会编译目标及其依赖,耗时可能较长。保持终端运行,等待命令完成,不要在构建过程中中断命令。
预期结果:命令以 0 退出,并生成以下两个文件:
output/ws53/acore/ws53_liteos_app/application.elf
output/ws53/fwpkg/pack_all_core/ws53_liteos_app/ws53_liteos_app_all_in_one.fwpkg
检查文件是否生成:
Test-Path .\output\ws53\acore\ws53_liteos_app\application.elf
Test-Path .\output\ws53\fwpkg\pack_all_core\ws53_liteos_app\ws53_liteos_app_all_in_one.fwpkg
test -s output/ws53/acore/ws53_liteos_app/application.elf && echo "ELF: OK"
test -s output/ws53/fwpkg/pack_all_core/ws53_liteos_app/ws53_liteos_app_all_in_one.fwpkg && echo "FWPKG: OK"
5. 连接开发板并确认串口#
使用 Type-C USB 数据线连接开发板,关闭占用串口的其他程序。
在 PowerShell 中列出串口:
[System.IO.Ports.SerialPort]::GetPortNames()
记录开发板对应的端口,例如 COM3。
查看串口设备:
ls /dev/ttyUSB* /dev/ttyACM* 2>/dev/null
记录开发板对应的设备路径,例如 /dev/ttyUSB0。
6. 烧录完整固件#
烧录会覆盖开发板中的现有固件。需要保留原固件时,先取得可恢复的固件包。
将 <PORT> 替换为实际端口,在 SDK 的 src 目录执行:
fbb flash ws53_liteos_app --port <PORT> --baud 921600 --manual-reset
工具提示连接设备时,按下开发板的 RST 按钮。预期结果:命令正常退出,并报告 All images burnt successfully 或等价成功结果。
7. 监视并验证 Hello World#
将 <PORT> 替换为实际端口:
fbb monitor --chip ws53 --port <PORT> --baud 115200
打开监视器后按一次开发板的 RST 按钮。成功日志必须包含:
start helloworld sample
hello world
随后应约每秒重复输出 hello world。只看到系统启动日志不能判定 Hello World 成功。验证完成后按 Ctrl+C 退出监视器。
完成判据#
FBB CLI、工具链和
ws53_liteos_appTarget 通过环境检查;ELF 和完整固件包均由本次构建生成;
完整固件以
921600波特率烧录成功;串口以
115200波特率看到启动标志和重复的hello world。
目标板端到端验证完成后,再将页面验证等级更新为 verified。