# bk_solution_doorbell

**Repository Path**: bekencorp/bk_solution_doorbell

## Basic Information

- **Project Name**: bk_solution_doorbell
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: release/v3.1.1
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-20
- **Last Updated**: 2026-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 博通集成 BK7258 门铃解决方案

- [English](./README.md)

## 概述

**BK7258 门铃解决方案**是 BEKEN 发布并开源的可视门铃与智能门锁音视频解决方案。该方案基于 **BK7258** 主控芯片，并依赖 Armino 基础 SDK **BK_AVDK_SMP**，提供从摄像头采集、本地显示到网络图传与双向对讲的完整端到端示例工程，覆盖 UVC/DVP 摄像头采集、MJPEG 解码与 H.264 编码、LCD 显示与 LVGL、双向音频与 AEC 回声消除、Wi-Fi 图传、BLE 配网，以及 AP 掉电低功耗保活等门铃门锁常用能力。

## 文档

- [BK7258 门铃方案在线文档](https://docs.bekencorp.com/arminodoc/bk_doorbell/bk7258/zh_CN/v3.1.1/index.html)
- [Armino SMP SDK（BK AVDK SMP）](https://docs.bekencorp.com/arminodoc/bk_avdk_smp/smp_doc/bk7258/zh_CN/v3.1.1/index.html)

## 硬件

本方案基于 BK7258 开发板运行。该开发板配合 LCD 显示屏、UVC/DVP 摄像头模块、板载 Speaker/Mic 或 UAC 音频设备，即可完成门铃门锁的图像采集、显示与双向对讲功能。

- [开发板硬件资料](https://docs.bekencorp.com/arminodoc/bk_avdk_smp/ap_doc/bk7258/zh_CN/v3.1.1/hw-reference/index.html)
- [BK7258 Datasheet](https://docs.bekencorp.com/spec/BK7258/BK7258%C2%A0Datasheet.pdf)

[BK7258 购买链接](https://item.taobao.com/item.htm?id=795814346530)

## 版本策略

本方案采用“维护分支 + 发布标签（Tag）”的版本管理方式：

- `release/v3.1.1` 为持续维护分支，用于该版本系列的功能迭代和问题修复，始终包含最新代码，但其中可能包含尚未完成完整发布测试的改动。
- `release/v3.1.1.x` 为正式发布标签，例如 `release/v3.1.1.2`、`release/v3.1.1.4`。每个标签均经过完整的测试与发布流程，可作为量产版本使用。
- BK7258 门铃方案与 Armino SMP SDK 必须使用完全相同的版本标签。例如，方案代码使用 `release/v3.1.1.8` 时，SDK 也必须使用 `release/v3.1.1.8`。

建议客户选择 `release/v3.1.1.x` 系列中版本号最大的标签进行开发和量产。仅需体验最新功能或参与开发时，才建议使用 `release/v3.1.1` 分支。

## 获取代码

BK7258 门铃方案和 Armino SMP SDK 均同步发布至 GitHub、Gitee 和 GitLab，可根据网络环境及访问权限选择代码源。

BK7258 门铃方案：

- GitHub：[https://github.com/bekencorp/bk_solution_doorbell](https://github.com/bekencorp/bk_solution_doorbell)
- Gitee：[https://gitee.com/bekencorp/bk_solution_doorbell](https://gitee.com/bekencorp/bk_solution_doorbell)
- GitLab：[https://gitlab.bekencorp.com/armino/smp_solution/bk_solution_doorbell](https://gitlab.bekencorp.com/armino/smp_solution/bk_solution_doorbell)

Armino SMP SDK：

- GitHub：[https://github.com/bekencorp/bk_avdk_smp](https://github.com/bekencorp/bk_avdk_smp)
- Gitee：[https://gitee.com/bekencorp/bk_avdk_smp](https://gitee.com/bekencorp/bk_avdk_smp)
- GitLab：[https://gitlab.bekencorp.com/armino/bk_avdk_smp](https://gitlab.bekencorp.com/armino/bk_avdk_smp)

GitHub 和 Gitee 可公开访问。GitLab 仅面向企业客户开放；企业客户如需访问，请联系对接的 FAE 或销售人员申请开通权限。

**Windows 用户注意**：使用 Git for Windows 获取代码时，建议在克隆前关闭自动换行符转换，避免脚本或源文件被转换为 CRLF 而导致编译失败。Linux、macOS 和 WSL 环境无需执行。

```bash
git config --global core.autocrlf false
```

如果代码已经克隆，修改该配置不会自动恢复文件，建议设置后重新克隆。

以下命令以 GitHub 和 `release/v3.1.1.8` 标签为例。**实际获取代码时，请选择最新发布的标签，并确保方案代码与 SDK 使用完全相同的标签**。使用其他代码源时，替换对应的仓库地址即可。

```bash
mkdir -p ~/armino && cd ~/armino

# Armino SMP SDK
git clone --branch release/v3.1.1.8 https://github.com/bekencorp/bk_avdk_smp.git

# BK7258 门铃方案
git clone --branch release/v3.1.1.8 https://github.com/bekencorp/bk_solution_doorbell.git
```

代码获取的更多说明见 [Armino SMP 快速入门](https://docs.bekencorp.com/arminodoc/bk_avdk_smp/smp_doc/bk7258/zh_CN/v3.1.1/get-started/index.html)。

## 编译环境安装

Armino SMP 支持本地编译和 Docker 编译，可根据开发平台选择以下方式部署编译环境。

### Linux 本地编译

进入 SDK 目录并运行环境安装脚本：

```bash
# 安装脚本位于 bk_avdk_smp 仓库内
cd ~/armino/bk_avdk_smp
sudo bash tools/env_tools/setup/armino_env_setup.sh
```

### Windows 本地编译

下载并安装 [Armino Bash](https://dl.bekencorp.com/tools/arminosdk/WindowsInstaller/Armino-Bash-Setup_0.3.0.exe)。

### Docker 编译

Docker 编译镜像为 [`bekencorp/armino-idk`](https://hub.docker.com/r/bekencorp/armino-idk/tags)，请选择 `1.5` 或更高版本的镜像标签，支持 Windows / Linux / macOS。

详细安装步骤请参阅 [Armino SMP 快速入门：环境部署及编译](https://docs.bekencorp.com/arminodoc/bk_avdk_smp/smp_doc/bk7258/zh_CN/v3.1.1/get-started/index.html)。

## 编译工程

以 `doorbell` 工程为例（位于 `projects/doorbell`），通过 `SDK_DIR` 指向 Armino SMP SDK 后本地编译：

```bash
cd ~/armino/bk_solution_doorbell/projects/doorbell
make bk7258 SDK_DIR=~/armino/bk_avdk_smp        # 也可先 export SDK_DIR 再执行 make bk7258
```

也支持 Docker 编译（Linux / macOS 用 `./dbuild.sh`，Windows PowerShell 用 `.\dbuild.ps1`）：

```bash
cd ~/armino/bk_solution_doorbell/projects/doorbell
export SDK_DIR=~/armino/bk_avdk_smp
./dbuild.sh make bk7258
```

编译成功后，用于烧录的固件文件位于以下路径（相对于 `bk_solution_doorbell/` 仓库根目录）：

```text
projects/doorbell/build/bk7258/doorbell/package/all-app.bin
```

其他工程请将命令中的路径替换为对应的 `projects/<工程名>`。

## 烧录固件

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

- 下载并使用 [BKFIL 本地烧录工具](https://dl.bekencorp.com/tools/flash/)
- 使用 [BKFIL 网页烧录工具](https://connect.aclsemi.com/)

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

详细烧录流程请参阅 [Armino SMP 快速入门](https://docs.bekencorp.com/arminodoc/bk_avdk_smp/smp_doc/bk7258/zh_CN/v3.1.1/get-started/index.html)。

## 参考工程

| 工程名 | 主要功能 | 详细说明 |
| --- | --- | --- |
| [doorbell](../projects/doorbell/) | H.264 网络图传、LCD 显示、双向对讲、BLE 配网。 | [详细说明及使用说明在线文档](https://docs.bekencorp.com/arminodoc/bk_doorbell/bk7258/zh_CN/v3.1.1/projects/doorbell/index.html) |
| [doorviewer](../projects/doorviewer/) | MJPEG 网络图传、LCD 显示，兼容性更好。 | [详细说明及使用说明在线文档](https://docs.bekencorp.com/arminodoc/bk_doorbell/bk7258/zh_CN/v3.1.1/projects/doorviewer/index.html) |
| [doorbell_lp](../projects/doorbell_lp/) | 在 doorbell 基础上增加 AP 掉电低功耗保活。 | [详细说明及使用说明在线文档](https://docs.bekencorp.com/arminodoc/bk_doorbell/bk7258/zh_CN/v3.1.1/projects/doorbell_lp/index.html) |
| [doorbell_4M](../projects/doorbell_4M/) | MJPEG 图传、LCD 显示，音频支持板载 Speaker 与 UAC。 | [详细说明及使用说明在线文档](https://docs.bekencorp.com/arminodoc/bk_doorbell/bk7258/zh_CN/v3.1.1/projects/doorbell_4M/index.html) |

各工程的适用场景与差异说明，请参阅在线文档的 [示例工程](https://docs.bekencorp.com/arminodoc/bk_doorbell/bk7258/zh_CN/v3.1.1/projects/index.html) 页面。

## BEKEN 相关资源

- [BEKEN 官网](https://www.bekencorp.com/)
- [ARMINO 开发者论坛](https://armino.bekencorp.com/)
- [BEKEN 文档中心](https://docs.bekencorp.com/)
- 哔哩哔哩: 博通集成产品解决方案