# 蓝牙Mesh智能零火1/2/3/4/6键开关（动态注册）
本文档用于指导设备厂商，采用一套原理图、一块PCBA、一个固件快速实现开关1/2/3/4/6键零火开关智能化升级。
文档更新记录：
更新日期 | 版本号 | 更新内容 |
2024.12.04 | v1.0 | 初始版本 |
#1. 产品简介
#1.1. 工作原理
产品采用同一个原理图和PCBA，烧录同一个固件，即可适配 5 种开关面板，如图。
配置方法：
- 软件配置：通过专业配置工具（BAT-Bota）写入不同的KV值，实现不同按键功能，见键位配置表。【暂未实现】
键位配置KV值（KeyConfig） | 0 | 1 | 2 | 3 | 4 |
按键功能 | 6键 | 1键 | 2键 | 3键 | 4键 |
硬件检测原理：
* <span class="ne-text" style="font-size: 14px">开关上电时，首先检查键位配置KV值（默认为0）。如有其它配置，表示实体键位数（1，2，3，4），则执行对应按键功能；</span>
* <span class="ne-text" style="font-size: 14px">若KV值为0，则检查硬件配置。请按照“按键键位配置表”，则执行对应的按键功能。</span>
- 硬件配置：通过检测图中 3 路电阻（R64，R63，R62）的组合状态，来配置按键键位。
R62 | R63 | R64 | 备注(模组管脚位) | |
1键开关 | √ | NC | NC | KEY1_PB09 |
2键开关 | NC | √ | NC | KEY3_PB10 |
3键开关 | NC | NC | √ | KEY5_PB11 |
4键开关 | √ | NC | √ | KEY1_PB09+KEY5_PB11 |
6键开关 | NC | NC | NC | / |
软件检测原理：开关上电时，检测模组KEY1_PB09管脚电路为高电平，则判定为1键开关。
#1.2. 硬件功能
项目 | 功能说明 | 备注 |
按键 |
| - |
继电器 |
| - |
指示灯 |
| 软件可设置关闭 |
#1.3. 接线示意图
以 “四/六键开关接线图”为例示意：
注：
- 一键仅接L1，二键接L1、L2，三键接L1、L2、L3，四键、六键接L1-L4。
- 当做场景面板时，不接负载，仅需接L、N接口即可。
#2. 硬件设计
#2.1. 硬件框图
#2.2. 参考设计
以下参考设计图适用于：1键、2键、3键、4键、6键 零火开关。
#2.2.1. 模组主控（必须）
模组上板注意事项：
电源设计注意事项
- 工作电压：DC 3.3V。
- 供电电流： 模组最大工作电流为35mA，建议DC3.3V供电电流大于100mA。
- 纹波要求：要求使用LDO电源方案。如果用DCDC为模组供电，要特别注意模组输出电压的纹波需小于30mV，过大会导致BLE配网失败及影响模组工作。
天线使用注意事项
- 天线类型选择：默认提供PCB板载天线模组—EMB1012-P。如果天线环境不佳或者模组包在金属壳体内，请选用IPEX外接天线模组—EMB1012-E，否则会影响蓝牙通信距离。
- PCB天线净空区要求：使用PCB板载天线模组时，需要确保模组PCB天线部分和其它金属器件、连接器、PCB过孔、走线、覆铜的距离至少15mm以上。
下图阴影区域需要：远离金属器件、传感器、干扰源以及其它可能造成信号干扰的材料。
需要特别注意：黄色和网状天线净空区的垂直方向上15mm范围内，绝对不要放置金属器件、传感器、干扰源以及其它可能造成信号干扰的材料，否则会影响模组射频性能。
#2.2.2. 继电器和过零检测接口
固件默认支持过零检测方案。元器件推荐如下：
- 过零信号检测芯片：817光耦
- 继电器型号：凡华 FH17-1A2TE。
注意：如果继电器型号不一致，需要提供继电器相关规格型号和过零参数，固件做相应适配。
#2.2.3. 按键及键位配置电阻说明
Notes: 模组固件默认按键配置表如下：
开关键位数 | PCB板原理图按键位 | 负载输出 | LED指示灯 | 按键组合 |
1键开关 | Key3 & Key4 | Relay1 | LED3 & LED4 | 1+1 |
2键开关 | Key1 & Key2 | Relay1 | LED1 & LED2 | 1+1 |
Key5 & Key6 | Relay2 | LED5 & LED6 | 1+1 | |
3键开关 | Key1 & Key2 | Relay1 | LED1 & LED2 | 1+1 |
Key3 & Key4 | Relay2 | LED3 & LED4 | 1+1 | |
Key5 & Key6 | Relay3 | LED5 & LED6 | 1+1 | |
4键开关 | Key1 | Relay1 | LED1 | 1 |
key2 | Relay2 | LED2 | 1 | |
Key5 | Relay3 | LED5 | 1 | |
Key6 | Relay4 | LED6 | 1 | |
6键开关 | Key1 | Relay1 | LED1 | 1 |
Key2 | Relay2 | LED2 | 1 | |
Key3 | Relay3 | LED3 | 1 | |
Key4 | Relay4 | LED4 | 1 | |
Key5 | / | LED5 | 1 | |
Key6 | / | LED6 | 1 |
#2.2.4. 按键LED
#2.2.5. 预留测试点
#2.3. 参考设计附件
#2.3.1. 硬件参考设计
- 参考设计图：
#2.3.2. 模组相关资料
- 模组规格书： 📎模组规格书_EMB1012_V1.2.pdf
- 型号核准证书：📎EMB1012-P_SRRC_型号核准证书.pdf
- 封装及参考设计：📎模组封装参考设计_EMB1012_V1.2.zip
#3. 功能验证
模组出厂默认已烧录好通用固件及产品ID。
特别提醒：
- 若有软件定制开发、自主品牌产品发布需求，请联系我司商务，完成平台产品创建和软件开发及固件发布。
- 若使用我司公版产品名称及型号，可直接对接商务采购模组（含固件、设备连云三元组），进行批量生产。
#3.1. 下载APP
应用商店搜索“智家精灵“并下载安装， 或 扫描下方二维码，根据引导下载安装，注册账号并登录。
#3.2. 设备配网
打开手机蓝牙功能，打开智家精灵APP；
设备进入配网状态 ：
- 若为首次上电，默认进入配网状态，无需触发动作；
- 若非首次上电，需通过按键触发进入配网，即：短按任意键5次后，3s内再长按该键大于5s，观察到LED灯闪烁后，设备即进入配网状态。
APP中，点击右上角 “+”——>“添加设备”——>选择“自动发现”，设备列表中找到“智能零火键开关”，点击下方“添加设备”，等待设备添加成功；
当APP首页出现设备卡片时，表示配网成功。
注意：
- 若进入配网状态后，未能及时操作添加设备，超时5分钟，设备会自动退出配网状态，若要配网需重新触发；
- 若不知道触发设备配网的方法，在添加设备时，可选择“手动添加”—>选择“电工” —>找到“开关”， —>选择“智能零火”，即可查询触发配网方法，按指引完成配网。
#3.3. 功能验证
设备配网成功后，即可开始功能验证。
测试用例请参考：📎智能开关测试用例（4键为例）.xlsx
#3.4. 恢复出厂设置
如需重置设备，请长按任意键保持15s以上，指示灯闪烁后，按键指示灯常亮，即可恢复出厂状态，设备默认进入配网状态。
验证过程中如遇其他问题请联系我司技术支持工程师。