蓝牙门锁产品开发指南

概述

本文详细介绍如何基于 TuyaOS 蓝牙设备开发包进行蓝牙门锁的开发。通过本指南，开发者可以快速上手并完成门锁产品开发。

相关文档资料

基础文档

• TuyaOS 概述
• 开发环境搭建
• Tuya Wind IDE 使用教程

技术文档

• 蓝牙开发框架介绍
• 蓝牙能力地图
• 蓝牙产测授权
• Bluetooth LE Demo 演示

芯片手册

• BK3633 芯片手册
• FR801x 芯片手册
• GR551x 芯片手册

DP 协议参考

• 蓝牙门锁 DP 参考
• 蓝牙门锁配件 DP 参考

门锁（配件）开发包 SDK 自带文档

• 硬件设计：.\hardware\
• 开发包使用说明：
  • Markdown 格式：.\software\TuyaOS\apps\tuyaos_ble_lock_xxxxxx_demo\README.md
  • HTML 格式：.\software\TuyaOS\apps\tuyaos_ble_lock_xxxxxx_demo\doc\index.html

技术支持

• TuyaOS 开发者论坛

方案选择指南

蓝牙开发框架 + 自有门锁开发框架

• 适用场景：开发者已有成熟稳定的自研门锁开发框架，仅需蓝牙接入涂鸦平台。
• 建议：详读 蓝牙开发框架介绍 文档，调用相关 API。也可以下载门锁开发包，参考门锁开发包对 API 的调用方法。
• 注：当前版本（v3.12.1 及以下版本）蓝牙开发框架暂不包含门锁动态/离线密码相关组件，如有需要请联系涂鸦 FAE。后续版本迭代会将相关组件从门锁开发包中移入基础蓝牙开发框架。

蓝牙开发框架 + 门锁开发包

• 适用场景：开发者首次对接涂鸦开发框架或熟悉涂鸦老门锁 SDK，无需关注蓝牙 API 调用，仅调整门锁外设驱动接入和自定义声光交互等应用逻辑。

• 建议：仔细阅读开发包自带的 README.md 格式或 index.html 格式文档。

蓝牙开发框架 + 门锁配件开发包

• 适用场景：开发者需要开发如蓝牙钥匙、密码盘、KEYPAD 等涂鸦蓝牙门锁配件产品。

• 建议：仔细阅读开发包自带的 README.md 格式或 index.html 格式文档。

涂鸦蓝牙模组+自有门锁开发框架

• 使用场景：开发者已有成熟稳定的自研门锁开发框架和芯片平台，通过蓝牙模组串口指令接入涂鸦平台。

• 建议：参照 蓝牙通用串口协议。

开发资料获取步骤

获取蓝牙设备开发包

进入 VS Code 的 Tuya Wind IDE 插件资源中心，筛选目标平台 最新版本 的蓝牙设备开发包，单击 创建 将其下载到本地。

获取门锁（配件）开发包

蓝牙设备开发包创建完成后，可以在 开发框架 页面的 产品开发包 标签页进行下载。

编译和开发

在 apps 目录下选择目标开发包，右键选择 Build Project 进行编译。第一次编译后，在 .log 文件夹内生成固件和 Keil5 工程文件，后续可根据个人偏好选择 VS Code 或 Keil5 进行开发。

常见问题

关于低功耗

• 蓝牙开发框架：默认不会自动进入休眠，调用 tal_cpu_allow_sleep() 后蓝牙 MCU 进入休眠，任意外部中断、软件定时器中断、蓝牙事件都会唤醒 MCU。唤醒后如果调用 tal_cpu_force_wakeup()，芯片不会再自动进入休眠。实际进/出休眠还需要关闭/打开 UART、I2C 等外设，避免出现异常。也可以参照 Bluetooth LE Demo 演示 使用 Logic 上位机发送休眠测试等指令测试。芯片休眠功耗参照对应芯片手册对比验证。

• 门锁开发包：使能 enable low power manage（configSUPPORT_SLEEP_MODE） 后门锁开发包会自动管理进出休眠。调试阶段可以打开相关 Log。