门锁

更新时间:2024-06-20 08:54:56下载pdf

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

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

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

创建门锁产品

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

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

  2. 选择门锁品类产品,以下为门锁品类:

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

    • 家用门锁:可选择 NB-IoTLTE 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 门锁 -