快速入门
本节说明 BK7258 AI 解决方案如何获取代码、安装编译环境、编译工程以及烧录固件,帮助您快速上手。
获取代码
BK7258 AI 解决方案和 Armino SMP SDK 均同步发布至 GitHub、Gitee 和 GitLab,可根据网络环境及访问权限选择代码源。
AI 解决方案:
Armino SMP SDK:
GitHub 和 Gitee 可公开访问。GitLab 仅面向企业客户开放;企业客户如需访问,请联系对接的 FAE 或销售人员申请开通权限。
Windows 用户注意:使用 Git for Windows 获取代码时,建议在克隆前关闭自动换行符转换,避免脚本或源文件被转换为 CRLF 而导致编译失败。Linux、macOS 和 WSL 环境无需执行。
git config --global core.autocrlf false
如果代码已经克隆,修改该配置不会自动恢复文件,建议设置后重新克隆。
以下命令以 GitHub 和 release/v3.1.1.8 标签为例。实际获取代码时,请选择最新发布的标签,并确保方案代码与 SDK 使用完全相同的标签。使用其他代码源时,替换对应的仓库地址即可。
mkdir -p ~/armino && cd ~/armino
# Armino SMP SDK
git clone --branch release/v3.1.1.8 https://github.com/bekencorp/bk_avdk_smp.git
# AI 解决方案
git clone --branch release/v3.1.1.8 https://github.com/bekencorp/bk_solution_ai.git
编译环境安装
Armino SMP 支持本地编译和 Docker 编译,可根据开发平台选择以下方式部署编译环境。
Linux 本地编译
进入 SDK 目录并运行环境安装脚本:
# 安装脚本位于 bk_avdk_smp 仓库内
cd ~/armino/bk_avdk_smp
sudo bash tools/env_tools/setup/armino_env_setup.sh
Windows 本地编译
下载并安装 Armino Bash。
Docker 编译
Docker 编译镜像为 bekencorp/armino-idk,请选择 1.5 或更高版本的镜像标签,支持 Windows / Linux / macOS。
详细安装步骤请参阅 环境部署及编译。
编译工程
以 beken_genie 工程为例(位于 projects/beken_genie),通过 SDK_DIR 指向 Armino SMP SDK(即已克隆的 bk_avdk_smp 仓库根目录)后本地编译:
cd ~/armino/bk_solution_ai/projects/beken_genie
make bk7258 SDK_DIR=~/armino/bk_avdk_smp # 也可先 export SDK_DIR 再执行 make bk7258
也支持 Docker 编译(Linux / macOS 用 ./dbuild.sh,Windows PowerShell 用 .\dbuild.ps1):
cd ~/armino/bk_solution_ai/projects/beken_genie
export SDK_DIR=~/armino/bk_avdk_smp
./dbuild.sh make bk7258
编译成功后,用于烧录的固件文件位于以下路径(相对于 bk_solution_ai/ 仓库根目录):
projects/beken_genie/build/bk7258/beken_genie/package/all-app.bin
其他工程请将命令中的路径替换为对应的 projects/<工程名>。
烧录固件
可选择以下任一方式烧录固件:
下载并使用 BKFIL 本地烧录工具
使用 BKFIL 网页烧录工具
烧录时请选择上一节编译生成的 all-app.bin 固件文件。
详细烧录流程请参阅 烧录代码。
APP注册和下载
APP下载:https://docs.bekencorp.com/arminodoc/bk_app/app/zh_CN/v2.0.1/app_download/index.html
注册登录:使用邮箱注册登录