门锁

涂鸦门锁产品开发方案提供详细的开发流程介绍和 API 列表。

涂鸦门锁产品支持以下对接方案，您可以根据业务类型采用一种或者多种方案开发门锁产品：

• 各类通讯协议（蓝牙、Wi-Fi、Zigbee、NB-IoT）对接
• 云开发对接
• App SDK 对接（Wi-Fi 和蓝牙）
• RN 面板 SDK 对接
• IoT 微信小程序对接

创建门锁产品

以下步骤仅描述创建智能门锁产品的相关步骤，详细步骤请参考 创建产品。

1. 登录 涂鸦 IoT 开发平台，找到 创建产品 入口。

2. 选择门锁品类产品，以下为门锁品类：

   • 家用门锁 PRO：可选择 Wi-Fi、Zigbee、蓝牙通讯方式。

   • 家用门锁：可选择 NB-IoT、LTE Cat.1 通讯方式。

   • 公寓门锁：目前支持创建 Zigbee 通讯方式。

   • 酒店门锁：目前支持创建 Zigbee、蓝牙的酒店锁云锁芯线束方案公版

   • 保险箱：目前支持蓝牙、Wi-Fi 通讯方式的公版。

     

3. 在 创建产品 的提示框中，按页面提示设置产品名称：

   设置格式示例：XXX（品牌）+XXX（产品）+XXX（模组型号）

4. 输入产品型号（选填）为区分您的不同产品的信息，建议您补充：

   设置格式示例：XXX（TY-WF-MS-001）

5. 联网方式：请根据您的产品需求进行选择，目前门锁支持 Wi-Fi、蓝牙、Zigbee、NB-IoT 通讯方式。

6. 功耗类型：Wi-Fi 为低功耗，蓝牙和 Zigbee 为标准功耗，NB-IoT 有 PSM 和 DRX 模式。目前门锁产品均为低功耗产品，使用电池供电。如果开发者有标准功耗（5V 1A USB 供电）的情况，可联系您的门锁商务人员。

7. 单击 确定，产品创建成功。

   接下来可进入产品开发流程，参考 产品开发流程。

通讯协议对接

涂鸦门锁协议对接，支持 Wi-Fi、蓝牙、Zigbee 和 NB-IoT 等协议对接。

通讯协议	说明	适合品类	参考文档
Wi-Fi	支持 MCU 通用对接，即 Wi-Fi 联网模组对接方式，您需要实现 MCU 端逻辑。	1. 家用门锁 Wi-Fi 2. 家用门锁 PRO Wi-Fi（Wi-Fi 国际版） 3. 保险箱 Wi-Fi	Wi-Fi 门锁 MCU 对接
蓝牙	支持 MCU 通用对接 和 SDK 芯片对接 两种模式： 1. MCU 通用对接，您需要实现 MCU 端逻辑； 2. SDK 对接，涂鸦提供基于 bk 或者 Nordic 芯片 SDK 方案，客户需要在该芯片上集成 SDK，进行二次开发。	家用门锁 BLE、保险箱 BLE	SDK 对接：蓝牙门锁 SDK 对接 MCU 对接：蓝牙门锁 MCU 对接
Zigbee	支持 MCU 通用对接，即 Zigbee 联网模组对接方式，您需要实现 MCU 端逻辑。	家用门锁 Zigbee、公寓门锁 Zigbee、酒店门锁_Zigbee	Zigbee 家用门锁 & 公寓门锁 MCU 对接
NB-IoT	支持 MCU 通用对接，即 NB-IoT 联网模组对接方式，客户需要实现 MCU 端逻辑。	NB-IoT 门锁	NB-IoT 门锁 MCU 对接
保活 Wi-Fi 协议对接	支持保活 Wi-Fi 协议对接，暂未完全开放，可联系门锁商务或者项目了解协议方案。	保活 Wi-Fi 门锁	Wi-Fi 保活门锁 MCU 对接

云开发对接

本小节在 云对接方案介绍 的基础上，新增专门针对门锁品类的云开发对接开发流程。

前提条件

涂鸦门锁云开发对接需要满足以下条件：

• 条件一：采用支持涂鸦方案的门锁。 该门锁首先需要支持过涂鸦的通讯协议（蓝牙、Wi-Fi、Zigbee、NB-IoT）对接，然后可使用自建云平台与涂鸦对接。
• 条件二：对接涂鸦全屋功能。需要对接配网、设备管理、成员管理等通用云 API 接口。
• 条件三：对接涂鸦门锁云 API 功能。涂鸦门锁云 API 由两部分组成，一部分是 门锁功能云 API，另一部分是门锁功能标准指令集，门锁的告警记录、开门记录以及设置指令通过标准指令集实现。

对接方案

目前 Wi-Fi 和 Zigbee 门锁业务使用同一套开放云服务 API。暂未开放蓝牙 BLE 云服务 API，您可联系涂鸦门锁业务咨询。

方案	说明	适用品类	参考文档
家用门锁 Wi-Fi	支持 Wi-Fi 门锁云开发对接，厂商和您可使用涂鸦门锁云 API 构建 App、微信小程序、H5、Web 应用，对接涂鸦 Wi-Fi 门锁功能。	1. 家用门锁 Wi-Fi 2. 家用门锁 Pro Wi-Fi（Wi-Fi 国际版） 3. 保险箱 Wi-Fi	1. 家用门锁标准指令集 2. 家用门锁标准状态集
家用门锁 Zigbee	支持 Zigbee 门锁云开发对接，厂商和您可使用涂鸦门锁云 API 构建 App、微信小程序、H5、Web 应用，对接涂鸦 Zigbee 门锁功能。	家用门锁_Zigbee、家用门锁 PRO_Wi-Fi	1. 家用门锁标准指令集 2. 家用门锁标准状态集
家用门锁蓝牙	待开放，敬请期待。可联系涂鸦门锁商务咨询。	蓝牙 BLE 门锁	暂未开放

App SDK 对接

本小节在 App 端-SDK 开发 的基础上，新增专门针对门锁品类的 App 端 SDK 开发对接流程。

前提条件

涂鸦门锁 App SDK 对接条件：

• 条件一：需要采用支持涂鸦方案的门锁，该门锁首先需要支持过涂鸦的通讯协议（蓝牙、Wi-Fi、Zigbee、NB-IoT）对接，然后开发者 App 可集成 Tuya 门锁 App SDK。
• 条件二：Tuya 门锁 App SDK 是在 HomeSDK 的基础上封装的门锁相关业务。部分 App 未集成的门锁功能可以使用云开放平台对接。

对接方案

目前支持家用门锁 Wi-Fi 和家用门锁蓝牙 App SDK 对接，支持 iOS 和安卓平台。暂未开放 Zigbee App SDK 方案，您可联系涂鸦门锁业务咨询。

涂鸦门锁 App SDK 是基于涂鸦智能生活 App SDK 进行的二次封装，主要封装门锁业务。

App SDK	说明	适用品类	参考文档
家用门锁 Wi-Fi App SDK	支持 Wi-Fi 门锁 App SDK 对接，该 SDK 使用 iOS 和安卓原生代码封装 Wi-Fi 门锁的业务接口和云端 API	1. 家用门锁 Wi-Fi 2. 家用门锁 Pro Wi-Fi（Wi-Fi 国际版） 3. 保险箱 Wi-Fi	-
家用门锁蓝牙 App SDK	支持蓝牙门锁 App SDK 对接，该 SDK 使用 iOS 和安卓原生代码封装蓝牙门锁的业务接口和云端 API	蓝牙 BLE 门锁	-

面板 SDK 对接

本小节在 面板端-SDK 开发-通用 SDK 开发 的基础上，新增专门针对门锁品类的面板 SDK 开发对接流程。

面板 SDK	说明	适用品类	参考文档
面板 SDK 对接	面板 SDK 可使用涂鸦公版 App。客户基于面板 SDK 进行门锁业务开发，面板 RN 资源包上传到服务器。	Wi-Fi、蓝牙、Zigbee 门锁	-