共享棋牌室的痛点在于“无人值守”——商家最怕的是客人走后空调、麻将机没关导致电费流失，或者有人在包间抽烟触发烟雾报警却没人处理。针对这一场景，芯步的壁挂式人体存在雷达烟雾传感器（UNI-CGQ-RT-L-YW-BG） 提供了一个“一机双用”的解决方案：它既解决了“有没有人”的检测问题，又解决了“有没有烟”的安全问题。

以下是基于该设备开放接口（HTTP协议）的详细接入解决方案。

一、 核心设计思路：双保险逻辑

要实现真正的“人走断电”与“安全检测”，不能单纯依赖单一信号，否则容易误判（例如人去上厕所误判为无人导致断电）。我们需要建立一套“状态保持”与“紧急干预”并行的机制。

1. 针对“人走断电”：利用雷达的长时间无人信号作为断电触发条件。

2. 针对“安全检测”：利用烟雾浓度数据作为紧急断电或告警的触发条件。

二、 硬件端接入配置

在项目启动初期，需要对设备进行初始配置，以确保数据能准确送达你的棋牌室SaaS系统或自建服务器。

1. 网络配置该设备采用 WiFi 2.4G 直连方式，无需额外购买网关。在现场安装时，需要连接棋牌室的商业WiFi。在设备中预设5组WiFi信息，以保证信号稳定性。

2. 服务器推送地址设定（关键步骤）设备通电后，通过其内置的配置界面（通常是WEB端或配网APP），需要设置 “上报地址”。

• 协议选择：HTTP/HTTPS POST。

• URL配置：填写你后台服务器的公网API地址（例如 https://yourdomain.com/api/sensor/callback）。

• 数据格式：JSON。

三、 接口协议深度解析与对接

根据芯步的开放接口规范，该传感器具备上行（数据上报）和下行（指令控制）的双向通信能力。

1. 数据上行（Sensor -> Server）

传感器会实时上报状态变化。作为开发者，你需要对接以下核心字段：

（1）雷达数据（人走断电的核心）

• 参数名radarexist 或 body_detect

• 数据解析

  • 0：无人存在（此时可触发倒计时断电逻辑）。

  • 1：有人存在（复位倒计时，保持通电）。

• 附加价值：雷达能穿透烟雾进行探测，不受光线和烟雾颗粒影响，比红外更可靠。

（2）烟雾传感数据（安全检测的核心）

• 参数名smoke_value 或 mq_value

• 数据解析：通常由ADC采集，代表模拟电压值或浓度百分比。

  • 正常值：通常 < 50（具体视标定情况）。

  • 预警值（中风险）：100-200（疑似吸烟，触发小程序提醒店长）。

  • 报警值（高风险）：> 300（触发断电并报警）。

（3）设备状态

• 参数名power -> 继电器状态（1接通，0断开），用于系统后台同步当前的电源通断状态。

2. 指令下行（Server -> Sensor）

这是实现“远程断电”和“消音”的关键。你需要调用芯步的开放API来下发命令。

接口示例

• 请求方式：POST

• URLhttp://api.thingboot.com/{AppId}/device/control/

• Query参数sign={签名}&ts={时间戳}（用于验证权限，防止恶意攻击）。

• Body示例（切断电源）

  { "device": 设备ID, "order": { "power": 0 // 0=断电，1=通电 } }

• Body示例（烟雾报警器消音）

  { "device": 设备ID, "order": { "buzzer": 0 // 关闭蜂鸣器 } }

四、 业务逻辑代码实现方案

在后台系统中，你需要编写对应的业务逻辑。采用以下伪代码逻辑实现自动化控制。

1. 人走断电逻辑（状态机模式）

为了保证用户体验，避免客人还在却断电，需要引入“延时确认”机制。

• 步骤 A（状态变更）：服务器收到 radarexist=0。

• 步骤 B（缓冲期）：不立即断电，设置定时器 15-30 分钟。

• 步骤 C（二次确认）：在定时器执行前，如果收到 radarexist=1（有人回来），则取消断电任务。

• 步骤 D（执行）：若定时器结束且雷达状态始终为0，调用下行接口 power:0 切断麻将机和空调电源。

2. 安全联动逻辑（多级预警）

• 一级预警（轻度吸烟）

  • 触发：smoke_value 在 100-200 且持续 10秒。

  • 动作：向该包间对应的二维码推送微信/短信通知，内容为“【XX棋牌室提醒】8号包间检测到烟雾，请遵守禁烟规定或注意安全。”

• 二级报警（严重火情/重度吸烟）

  • 触发：smoke_value > 300 或雷达检测无人但烟雾突增。

  • 动作：

    1. 紧急调用设备API切断该包间总电源（防止电路短路起火）。

    2. 触发该设备蜂鸣器鸣叫，现场警示。

    3. 向店主手机发送紧急告警电话或高优先级推送。

五、 场景联动：不仅仅是断电

由于芯步的设备支持私有化部署和局域网通信，你还可以做更高级的整合：

1. 智能计费关联：只有当系统通过雷达检测到“有人”且收到“下单成功”指令时，才允许通过API下发 power:1 供电。这能防止客人直接开灯蹭坐。

2. 环境舒适度控制（视具体型号）：如果设备集成了温湿度传感，可以在“无人”状态下，自动联动空调进入节能模式（例如设定26°C），而不直接粗暴关机，保护压缩机寿命。

六、 常见问题与排查

1. 雷达误判问题

   • 现象：卫生间洗澡水蒸气或空调风导致雷达误判有人。

   • 解决：算法层面优化，利用RSSI信号强度判断是否为大幅运动。如果是微动（如风吹窗帘），结合烟雾数据判断环境状态。

2. 网络断线重连

   • 棋牌室路由器IP租约可能导致设备掉线。代码中需要维护长连接或利用设备的心跳包机制（Heartbeat）来判断设备在线/离线状态，并在管理后台显示“设备离线”红点。

3. HTTP响应延迟

   • 芯步接口响应速度实测约 80-120ms。在“人走断电”场景中，无需极致实时性，3-5分钟的延迟完全可以接受，但在紧急断电场景中，配合本地定时器逻辑使用，确保网络阻塞时本地也能自动断电。

通过上述步骤，你可以将芯步的壁挂式传感器无缝接入共享棋牌室系统，将传统的“计时收费”升级为“基于安全与能耗管理的智能空间”。