快速入门

[English]

本节说明 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/<工程名>。

烧录固件

可选择以下任一方式烧录固件:

烧录时请选择上一节编译生成的 all-app.bin 固件文件。

详细烧录流程请参阅 烧录代码。

APP注册和下载

APP下载:https://docs.bekencorp.com/arminodoc/bk_app/app/zh_CN/v2.0.1/app_download/index.html

注册登录:使用邮箱注册登录

常见问题

  • ``SDK_DIR`` 应指向哪里? 指向已克隆的 BK AVDK SMP 仓库根目录(含 Makefile、tools 等),不是 BK AI 仓库根目录。

  • 编译报错找不到工具链或脚本? 先完成 环境部署及编译 中的环境部署;Docker 方式需本机已安装并启动 Docker。

  • 国内网络拉 Docker 镜像较慢? 请参阅 环境部署及编译 中的镜像 / 下载说明。