| 版本 | 编写/修订说明 | 修订日期 | 备注 |
|---|---|---|---|
| 1.0.0 | 创建文档 | 20200601 | |
| 1.1.0 | 新增方案概述和接入方案说明 | 20200803 |
Wi-Fi门锁指通过非保活Wi-Fi模组实现联网控制的智能门锁。目前采用非保活WiFi模组的门锁均为低功耗方案，模组平常处于断电休眠状态，需要门锁mcu唤醒才能传输和发送数据。
目前非保活WiFi门锁支持MCU通用协议对接：涂鸦模组和开发者的门锁 MCU 通过串口通信的方式，MCU通过涂鸦模组上报设备状态，连接涂鸦云。
涂鸦提供烧录标准固件门锁的 Wi-Fi 模组，并提供一整套涂鸦WiFi门锁MCU通讯对接协议，该模组连接涂鸦云&App 和门锁的MCU，开发者需要按照串口协议开发主控 MCU 程序。为快速开发，涂鸦还提供了mcu_sdk（IoT平台创建pid可获取），可快速实现串口协议的对接开发。
公版方案门锁使用涂鸦非保活WiFi模组 MCU对接，支持门锁以下功能的对接：
| 功能 | 说明 |
|---|---|
| 全链路通信加密 | App——服务器——wifi模块，通信链路全部加密，杜绝通信安全风险 |
| 开门记录 | 解锁方式+解锁id+时间，用户可以通过app查询近12个月的开门记录，不会丢失数据。支持指纹+密码这样的组合开门 |
| 离线开门记录补传 | 重新联网后，模块会将在离线阶段发生的开门记录补传到云端 |
| 告警 | 低电报警、密码错误、指纹错误、房卡错误、防撬、高温等 |
| 时间同步 | 门锁时间与服务器保持一致，支持全球时区+冬夏令时切换 |
| 用户管理 | 通过app添加用户，与解锁id通过app手动关联 |
| 开门事件联动 | 通过app自动化配置可实现联动 |
| 电量状态显示 | 电量值或电量状态 |
| 其他事件联动 | 可以根据不同的解锁id或者类型自定义联动 |
| App远程开门 | 门锁请求后，app响应，可以同意开门或拒绝开门 |
| 动态密码 | 涂鸦wifi模块集成了动态密码算法，厂家1小时实现该功能。在app上可进行动态密码快速复制 |
| 临时密码管理 | 最多支持10组临时密码，支持创建和删除，临时密码创建后，自动复制，可以在微信、短信中粘贴，临时密码短信支持海外的手机号，可以选择不同的国家码 |
| OTA | 模块和mcu都可进行OTA |
| 劫持告警 | App标记后，特定方式开门即触发劫持报警 |
| 门铃呼叫 | 硬件进行门铃呼叫请求后，app收到通知 |
| 离线临时密码 | 不依赖网络的离线临时密码，由模块和云端实现算法，mcu调模块接口验证 |
| 门锁状态显示 | App上可参看门锁的反锁、童锁等状态信息 |
涂鸦Wi-Fi门锁接入方案支持创建以下品类：
| 品类 | 说明 |
|---|---|
| Wi-Fi家用门锁 | 使用非保活WiFi模组，适用于家用入户锁方案对接。 |
| Wi-Fi家用门锁RPO | 主推方案 。使用非保活WiFi模组，适用于家用入户锁方案对接。该版本在 Wi-Fi家用门锁的基础上，UI界面升级，新增离线密码、APP端录入解锁方式等功能。 |
| Wi-Fi保险箱 | 适用于保险箱方案对接。 |
Wi-Fi门锁产品创建总体流程：IOT注册-产品定义-面板选择-模组选择-硬件配置-拓展配置。
本小节以创建Wi-Fi家用门锁PRO方案为例，介绍如何在涂鸦 IoT 工作台创建一个智能Wi-Fi门锁。
图1：创建Wi-Fi家用门锁PRO方案
图2：创建Wi-Fi家用门锁方案：*
图3：创建Wi-Fi保险箱方案
Wi-Fi家用门锁品类 DP参考：Wi-Fi 家用门锁DP解释说明
Wi-Fi家用门锁PRO品类DP参考 ：Wi-Fi 家用门锁Pro版本DP解释说明
Wi-Fi保险箱品类 DP参考：Wi-Fi 保险箱DP解释说明
选择模组时，您需要考虑模组的功耗、联网速度等性能，综合考虑是否能适应电路板、引脚是否够用、是否需要外接天线等因素。
早期Wi-Fi门锁通用方案主要以E1S系列模组为主，目前Wi-Fi门锁通用方案，推荐选型的模组主要是XR系列。该系列模组不仅升级了硬件功能，在加快联网速度、降低功耗方面做了较大的改善，而且固件端也是做了较大的优化，同时与E1S系列是pin2pin的，新老客户对接可以迁移到XR系列。 可以模组选型介绍：XR1模组规格
Wi-Fi家用门锁Pro 可选模组：
| 方案品类 | 模组 | 固件key | 固件版本 | 状态 |
|---|---|---|---|---|
| Wi-Fi家用门锁Pro | TYWE1S 模组 | keyhup5e3ewxpfsp | 【1】最新发布 1.0.10 【2】1.0.4、1.0.9、1.0.10 可用 | 通用固件已发布，适用于Wi-Fi Pro版本，但不支持离线密码功能，DP点数量<29个 |
| TYWE1S-IPEX 模组 | keyhup5e3ewxpfsp | 【1】最新发布 1.0.10 【2】1.0.4、1.0.9、1.0.10 可用 | 通用固件已发布，适用于Wi-Fi Pro版本，但不支持离线密码功能，DP点数量<29个 | |
| TYWXR1模组（芯之联） | keyqd85c8xyafrue | 【1】最新1.0.2 | 通用固件已发布-推荐 | |
| TYWXR1-IPEX模组（芯之联） | keyqd85c8xyafrue | 【1】最新1.0.2 | 通用固件已发布-推荐 | |
| TYWXR3模组（芯之联） | keyqd85c8xyafrue | 【1】最新1.0.2 | 通用固件已发布-推荐 |
Wi-Fi家用门锁 可选模组：
| 方案品类 | 模组 | 固件key | 固件版本 | 状态 |
|---|---|---|---|---|
| Wi-Fi家用门锁 | TYWE1S 模组 | keyhup5e3ewxpfsp | 【1】最新发布 1.0.10 【2】1.0.4、1.0.9、1.0.10 可用 | 通用固件已发布 |
| TYWE1S-IPEX 模组 | keyhup5e3ewxpfsp | 【1】最新发布 1.0.10 【2】1.0.4、1.0.9、1.0.10 可用 | 通用固件已发布 | |
| TYWE2S 模组 | keyjq7qnrqxgttgm | 【1】1.0.3（等同于E1S 的1.0.4） | 通用固件已发布 | |
| TYWE3S 模组 | keyjq7qnrqxgttgm | 【1】1.0.3（等同于E1S 的1.0.4） | 通用固件已发布 | |
| TYWXR1模组（芯之联） | keyqd85c8xyafrue | 【1】最新1.0.2 | 通用固件已发布 | |
| TYWXR1-IPEX模组（芯之联） | keyqd85c8xyafrue | 【1】最新1.0.2 | 通用固件已发布 | |
| TYWXR3模组（芯之联） | keyqd85c8xyafrue | 【1】最新1.0.2 | 通用固件已发布 |
Wi-Fi保险箱 可选模组：
| 方案品类 | 模组 | 固件key | 固件版本 | 状态 |
|---|---|---|---|---|
| Wi-Fi保险箱 | TYWE1S 模组 | keyhup5e3ewxpfsp | 【1】最新发布 1.0.10 【2】1.0.4、1.0.9、1.0.10 可用 | 通用固件已发布 |
| TYWE1S-IPEX 模组 | keyhup5e3ewxpfsp | 【1】最新发布 1.0.10 【2】1.0.4、1.0.9、1.0.10 可用 | 通用固件已发布 | |
| TYWE2S 模组 | keyjq7qnrqxgttgm | 【1】1.0.3（等同于E1S 的1.0.4） | 通用固件已发布 | |
| TYWE3S 模组 | keyjq7qnrqxgttgm | 【1】1.0.3（等同于E1S 的1.0.4） | 通用固件已发布 | |
| TYWXR1模组（芯之联） | keyqd85c8xyafrue | 【1】最新1.0.2 | 通用固件已发布-推荐 | |
| TYWXR1-ipex模组（芯之联） | keyqd85c8xyafrue | 【1】最新1.0.2 | 通用固件已发布-推荐 | |
| TYWXR3模组（芯之联） | keyqd85c8xyafrue | 【1】最新1.0.2 | 通用固件已发布-推荐 |
以下文档介绍了MCU开发说明，关键步骤，关键DP（DP交互流程、告警/开门记录、恢复出厂设置流程和示例）。
更多详情，请参考：Wi-Fi家用门锁开发辅助文档
产品开发的公版通信协议，数据协议。开发者创建产品 ——> 选择模组 时可下载最新的通讯协议。
更多详情，请参考：Wi-Fi门锁MCU对接协议
Wi-Fi门锁方案属于非保活低功耗方案，不适用第三方语音开关锁。 Wi-Fi门锁方案支持Alexa语音Routines功能，目前尚在研发中，更多详情，请咨询门锁商务对接。
该文档主要罗列研发、调试过程中的常见问题，以及问题排查解决方法，问答方式的文档。
更多详情，请参考：Wi-Fi门锁对接常用FAQ
该文档提供基础测试用例，包含门锁的软件功能测试、硬件功能测试、射频测试等。
更多详情，请参考：涂鸦Wi-Fi门锁基础测试用例
更多详情，请参考： 智慧生产——>产测解决方案
Wi-Fi家用门锁支持云开发平台对接：
云开发平台对接文档，请参考：Wi-Fi家用门锁云云对接API文档
Wi-Fi家用门锁支持微信小程序对接方案。 更多详情，请参考以下小程序文档： （1）Wi-Fi家用门锁设备控制小程序SDK
（2）Wi-Fi家用门锁小程序配网插件