# bk_solution_xiaotai

**Repository Path**: bekencorp/bk_solution_xiaotai

## Basic Information

- **Project Name**: bk_solution_xiaotai
- **Description**: smp 小钛 解决方案
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 16
- **Forks**: 0
- **Created**: 2026-11-05
- **Last Updated**: 2026-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小钛 BK7258 解决方案

[English](README.en.md) | **简体中文**

基于 Beken BK7258 / BK-AVDK SMP 的智能终端解决方案，包含立创·实战派 BK7258 与官方
BK7258 AI 玩具开发板（觅感）两个工程。方案提供 H5 实时查看与双向对讲、AI 对讲、
微信 VoIP 和多人对讲（仅立创板），视频使用 GC0308 / GC2145 + H.264。

## 支持开发板

| 工程 | 板卡 | 说明 |
|---|---|---|
| `projects/lckfb-bk7258-xiaotai` | 立创·实战派 BK7258 | 触摸屏、FT6336、GC0308、完整产品功能 |
| `projects/mgkfb-bk7258-xiaotai` | BK7258 AI 玩具开发板（觅感） | 双屏眼睛、三实体按键、H5 与微信语音；[BEKEN淘宝购买链接](https://item.taobao.com/item.htm?abbucket=0&id=992181247861&mi_id=0000jLcG6KeRFGDwvDL9Bbl0zttt1X88LlLyeqFMDvmTYL0&ns=1&skuId=6133314322874&spm=a21xtw.29978516.product_shelf.4.600a29631cCT9X&xxc=taobaoSearch) |

## 目录结构

```text
bk_solution_xiaotai/
├── components/                         共用组件
│   ├── xiaotai_bk7258/                 会话、TiRTC、音视频、网络、显示与 UI
│   ├── xiaotai_product/                产品业务规则、协议与交互配置
│   ├── xiaotai_common/                 板级公共 C 接口与重采样
│   ├── xiaotai_board_lckfb_bk7258/     立创板 GPIO/音频/摄像头/显示/触摸
│   ├── xiaotai_board_mgkfb_bk7258/     BK7258 AI 玩具开发板（觅感）GPIO/音频/显示/按键
│   └── xiaotai_tirtc/                  TiRTC 2.5.0 预编译库、头文件与来源记录
├── projects/
│   ├── lckfb-bk7258-xiaotai/           立创板工程（AP/CP/分区/配置）
│   └── mgkfb-bk7258-xiaotai/           BK7258 AI 玩具开发板（觅感）工程
├── tools/                              解决方案构建入口、SDK 补丁、打包与诊断
└── docs/                               产品、板卡与开发文档
```

BK-AVDK SDK 不随本 solution 分发，需单独检出并用环境变量 `SDK_DIR` 指向。

## 环境准备

依赖固定版本：

| 依赖 | 版本 |
|---|---|
| BK-AVDK SMP | `release/v3.1.1.10`，commit `398cab28b938e69ba2071a597daf00845dd080b6` |
| Arm GCC | `10.3.1 20210824`（`gcc-arm-none-eabi-10.3-2021.10`） |
| TiRTC | 2.5.0 预编译库，SHA-256 `1a6327eb...d4cf9` |

```bash
# 1. 检出官方 SDK（放在 solution 之外）
git clone --depth 1 --branch release/v3.1.1.10 \
    https://gitee.com/bekencorp/bk_avdk_smp.git \
    /path/to/bk_avdk_smp-release-v3.1.1.10

# 2. 指向 SDK
export SDK_DIR=/path/to/bk_avdk_smp-release-v3.1.1.10

# 3. 工具链（默认 /opt/gcc-arm-none-eabi-10.3-2021.10/bin）
export COMPILER_TOOLCHAIN_PATH=/opt/gcc-arm-none-eabi-10.3-2021.10/bin

# 4. 自检
python3 tools/doctor.py
```

SDK 补丁仍由 `tools/patches/` 在构建时自动应用；host 侧还需要 Git、CMake、Ninja 和
Python 3，并安装以下 Python 依赖：
`pycryptodome`、`click`、`click_option_group`、`cryptography`、`jinja2`、`PyYAML`、
`cbor2`、`intelhex`。

## 从源码编译

```bash
export SDK_DIR=/path/to/bk_avdk_smp-release-v3.1.1.10
export COMPILER_TOOLCHAIN_PATH=/opt/gcc-arm-none-eabi-10.3-2021.10/bin   # 可选


# BK7258 AI 玩具开发板（觅感）
cd ../mgkfb-bk7258-xiaotai
make bk7258

# 立创·实战派 BK7258
cd projects/lckfb-bk7258-xiaotai
make bk7258
make bk7258 BUILD_ARGS=--release      # 发布构建

# 清理
make clean
```

`make bk7258` 内部调用解决方案 [tools/build.sh](tools/build.sh)，依次完成：校验
SDK/TiRTC 版本 → 应用 `tools/patches/` 下的 SDK 补丁 → 递增 `BUILD_NUMBER` 并生成
`xiaotai_build_identity.h` → 编译 AP/CP → 运行工程合同测试 → 打包并写入镜像 SHA-256。

产物固定在各工程下：

```text
projects/<工程>/build/bk7258/<工程>/package/all-app.bin   # 串口烧录，偏移 0x0
projects/<工程>/build/bk7258/<工程>/package/app_pack.rbl  # OTA 镜像（尚未专项验收）
projects/<工程>/build/bk7258/<工程>/build_identity.json   # 版本与配置身份
```

## 烧录与首次使用

使用 BKFIL v4 选择 `all-app.bin`，起始地址 `0x00000000`。首次使用需按板卡指南完成
Wi-Fi 配网（热点 `XiaoTai-XXXX`，页面 `http://192.168.6.1`）和设备绑定。详见
[立创板说明](docs/boards/lckfb-bk7258/README.md) 与
[BK7258 AI 玩具开发板（觅感）说明](docs/boards/mgkfb-bk7258/README.md)。

## 串口调试

115200 8N1 连接 CP 命令行，AP 侧命令加 `ap_cmd` 前缀：

```text
ap_cmd status
ap_cmd call-status
ap_cmd help
ap_cmd log-level app 4
```

完整命令见 [BK7258 串口命令](docs/development/BK7258_SERIAL_COMMANDS.md)。

## SDK 补丁

`tools/patches/` 保存 22 个 SDK 修改，覆盖心跳、GC0308 20 fps、触摸采样、lwIP/skb、
Wi-Fi 透传缓冲、speaker 关闭诊断等。构建时按顺序应用，已应用时自动跳过；补丁与 SDK
版本绑定，升级 SDK 前必须重新核对。

## 版本策略

- 产品版本：各工程 `VERSION.md`
- 构建号：各工程 `BUILD_NUMBER`，每次构建递增
- 构建身份：`build_identity.json` 记录版本、profile、源码 commit 和镜像 SHA-256
- 发布构建：`make bk7258 BUILD_ARGS=--release`，使用临时 `release.config`，日志限制到 INFO

## 文档

- [立创·实战派 BK7258 使用说明](docs/boards/lckfb-bk7258/README.md)
- [BK7258 AI 玩具开发板（觅感）使用说明](docs/boards/mgkfb-bk7258/README.md)
- [音视频参数与媒体处理](docs/product/MEDIA_CONTRACT.md)
- [架构说明](ARCHITECTURE.md)
- [贡献与发布流程](CONTRIBUTING.md)