Quick Start

[中文]

This section explains how to get the BK7258 AI Solution code, set up the build environment, build a project, and flash the firmware, so you can get started quickly.

Get the Code

The BK7258 AI Solution and the Armino SMP SDK are published simultaneously on GitHub, Gitee, and GitLab. Choose a code source based on your network environment and access permissions.

AI Solution:

GitHub: <https://github.com/bekencorp/bk_solution_ai>
Gitee: <https://gitee.com/bekencorp/bk_solution_ai>
GitLab: <https://gitlab.bekencorp.com/armino/smp_solution/bk_solution_ai>

Armino SMP SDK:

GitHub: <https://github.com/bekencorp/bk_avdk_smp>
Gitee: <https://gitee.com/bekencorp/bk_avdk_smp>
GitLab: <https://gitlab.bekencorp.com/armino/bk_avdk_smp>

GitHub and Gitee are publicly accessible. GitLab is open to enterprise customers only; enterprise customers who need access should contact their FAE or sales representative to apply for permission.

Note for Windows users: When using Git for Windows to get the code, we recommend disabling automatic line-ending conversion before cloning, to avoid scripts or source files being converted to CRLF and causing build failures. This is not required on Linux, macOS, or WSL.

git config --global core.autocrlf false

If the code has already been cloned, changing this setting will not automatically restore the files; we recommend re-cloning after applying it.

The commands below use GitHub and the release/v3.1.1.8 tag as an example. When actually getting the code, choose the latest released tag, and make sure the solution code and the SDK use exactly the same tag. When using another code source, simply replace the corresponding repository URL.

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 Solution
git clone --branch release/v3.1.1.8 https://github.com/bekencorp/bk_solution_ai.git

Set Up the Build Environment

Armino SMP supports both local builds and Docker builds. Choose one of the following methods to set up the build environment based on your development platform.

Local Build on Linux

Enter the SDK directory and run the environment setup script:

# The setup script is located in the bk_avdk_smp repository
cd ~/armino/bk_avdk_smp
sudo bash tools/env_tools/setup/armino_env_setup.sh

Local Build on Windows

Download and install Armino Bash.

Docker Build

The Docker build image is bekencorp/armino-idk. Choose an image tag of 1.5 or higher; it supports Windows / Linux / macOS.

For detailed setup steps, see Environment Deployment and Compilation.

Build the Project

Using the beken_genie project as an example (located at projects/beken_genie), build locally by pointing SDK_DIR to the Armino SMP SDK (the root directory of the cloned bk_avdk_smp repository):

cd ~/armino/bk_solution_ai/projects/beken_genie
make bk7258 SDK_DIR=~/armino/bk_avdk_smp        # or export SDK_DIR first, then run make bk7258

Docker builds are also supported (use ./dbuild.sh on Linux / macOS, and .\dbuild.ps1 in Windows PowerShell):

cd ~/armino/bk_solution_ai/projects/beken_genie
export SDK_DIR=~/armino/bk_avdk_smp
./dbuild.sh make bk7258

After a successful build, the firmware file used for flashing is located at the following path (relative to the bk_solution_ai/ repository root):

projects/beken_genie/build/bk7258/beken_genie/package/all-app.bin

For other projects, replace the path in the commands with the corresponding projects/<project_name>.

Flash the Firmware

You can flash the firmware using either of the following methods:

Download and use the BKFIL local flashing tool
Use the BKFIL web flashing tool

When flashing, select the all-app.bin firmware file generated in the previous section.

For the detailed flashing process, see Burn Code.

APP Registration and Download

APP Download: https://docs.bekencorp.com/arminodoc/bk_app/app/en/v2.0.1/app_download/index.html (Chinese: https://docs.bekencorp.com/arminodoc/bk_app/app/zh_CN/v2.0.1/app_download/index.html)

Registration and Login: Use email to register and login

FAQ

Where should ``SDK_DIR`` point? To the root of the cloned BK AVDK SMP tree (where Makefile and tools live), not the BK AI repository root.
Missing toolchain or script errors? Complete the environment setup in Environment Deployment and Compilation first; for Docker, ensure Docker is installed and running.
Slow Docker image pull? See the mirror / download options in Environment Deployment and Compilation.