怎么二次开发壁挂式智能双鉴感应开关以实现人体移动探测_解决方案

CATALOG

芯步的壁挂式智能“双模”感应开关集成了红外和雷达双重探测技术，配合其开放的HTTP接口，你可以通过二次开发实现人体移动探测的实时响应。以下是完整的实施方案。

解决方案：基于芯步开放接口的壁挂式智能“双模”感应开关二次开发（人体移动探测）

1. 概述

本方案的目标是利用芯步壁挂式智能“双模”感应开关（型号：UNI-CGQ-RT-H-BG）开放的 HTTP API 接口，进行二次开发。

该设备内置红外传感模块和雷达传感模块（“双模”）。二次开发的核心逻辑是：设备主动探测 -> 状态变更上报 -> 开发者服务器接收 -> 业务逻辑处理（如告警、记录、联动）。

2. 核心技术原理

在二次开发前，需要理解该设备的两大核心检测机制，这对编写逻辑至关重要：

“双模”融合逻辑：该设备采用“与”逻辑。
- 有人状态红外 AND 雷达 同时探测到人体/微动。
- 无人状态红外 AND 雷达 均未探测到人体。
- 开发提示：这种机制能有效减少因窗帘飘动、电器散热等引起的红外误报，但也意味着单纯的红外触发不一定会上报“有人”，需要雷达确认。
上报机制：当人体存在状态发生变化时（即由“有人”变为“无人”，或“无人”变为“有人”），设备会实时向预设的服务器地址上报状态数据。

3. 二次开发环境准备

在进行代码编写前，需要完成以下准备工作：

获取凭证：登录芯步开放平台控制台，在“开发设置”中获取 AppID 和 AppSecret。
获取设备ID：在控制台设备列表中找到已激活的壁挂式“双模”感应开关的 Device ID。
配置服务器接收地址（关键步骤）
- 这是二次开发的核心。你需要拥有一台具备公网IP或域名且可访问的服务器。
- 在芯步控制台中，将设备的“数据上报URL”或“消息推送URL”指向你的服务器接口地址（例如：http://yourdomain.com/api/yoyo_callback）。
- 一旦设备状态改变，芯步云平台会通过HTTP POST请求将消息推送到这个地址。

4. 接口调用与开发实战

二次开发主要包含两个动作：接收设备上报的数据（下行）和主动查询/控制设备（上行）。

4.1 接收人体探测数据（消息推送）

这是实现人体移动探测的主要手段。当有人进入或离开探测区域，你的服务器会收到如下格式的JSON数据。

你需要开发的接收端代码逻辑（以Python Flask为例）：

注：如果不想自己搭建公网服务器，在开发测试阶段可以使用“内网穿透”工具（如ngrok、frp）将本地端口暴露到公网进行调试。

4.2 主动查询设备状态与控制

有时候你需要主动查询当前是否有人，或者主动开启/关闭设备的探测功能（如关闭雷达模块省电）。这需要调用芯步的下行API。

签名算法（Sign生成规则）：根据平台要求，请求签名需经过双重MD5加密

先将 AppSecret 进行MD5加密得到 secret_md5。
将 secret_md5 拼接上当前时间戳 ts，组成新字符串。
将新字符串再次进行MD5加密，得到最终的 sign。
公式：sign = MD5( MD5(AppSecret) + ts )

代码实现（Python 示例）：

import requests
import hashlib
import time

class YoYoController:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.api_base = "https://api.thingboot.com"

def _generate_sign(self, ts):
        # 第一次MD5
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 拼接时间戳
        sign_str = md5_secret + str(ts)
        # 第二次MD5
        sign = hashlib.md5(sign_str.encode()).hexdigest()
        return sign

def get_device_status(self, device_id):
        """
        主动查询设备当前状态（是否有人）
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"{self.api_base}/{self.app_id}/device/control/"
        params = {"sign": sign, "ts": ts}
        
        # 这里的 order 需要查询具体设备的命令手册，假设是查询状态
        payload = {
            "device": device_id,
            "order": {"get_status": 1}  # 具体命令请查阅官方文档
        }
        
        response = requests.post(url, params=params, json=payload)
        return response.json()

def disable_detection(self, device_id, module="radar"):
        """
        如果需要维修或节能，远程关闭雷达模块
        module: ‘radar’ 或 ‘infrared’
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/device/control/"
        
        # 根据该产品手册:[citation:1]，支持 radar_enable 和 infrared_enable 命令
        # 命令发送格式: {"radar_enable":0} 表示关闭雷达
        cmd = {f"{module}_enable": 0}
        
        payload = {
            "device": device_id,
            "order": cmd
        }
        
        response = requests.post(url, params={"sign": sign, "ts": ts}, json=payload)
        return response.json()

5. 高级应用场景集成

通过二次开发，你不仅仅能获得“有人/无人”的二元状态，还能构建复杂的自动化系统。

第一种场景：人来灯亮，人走灯灭（联动另一路控制器）

逻辑：接收Webhook human_status=1 -> 调用HTTP接口控制另一个智能控制器（或本设备自带的AC输出 power 线路）接通电源 -> 灯亮。
注意：该壁挂开关自带一路电源输出，你可以直接通过下发 {"power1":1} 命令控制连接在它上面的灯具，无需额外控制器。

第二种场景：存在时长统计分析

逻辑：服务器记录每次 human_status 变为 1 和 0 的时间戳。
输出：生成报表《办公室A在XX日的工作时长利用率》，帮助企业优化空间资源。

第三种场景：无人自动布防

逻辑：在办公时间外（如晚上10点），若收到“无人”状态上报，系统自动开启摄像头移动侦测。
处理：若在此状态下再次收到“有人”上报，立即触发高等级告警。

6. 常见问题与最佳实践

“双模”探头的覆盖盲区
- 雷达对微动敏感（如呼吸、点头），红外对切向移动敏感（横走）。安装时避免正对空调出风口（热源/冷源流动干扰红外）和风扇（叶片转动干扰雷达）。
网络波动与数据重传
- 当你的服务器返回的HTTP状态码非200或响应超时，芯步平台会尝试重传数据。
- 最佳实践：你的接收接口应保证处理逻辑快速执行（异步处理），避免因处理耗时导致响应超时，引发不必要的重传。
时钟同步
- 生成签名时，时间戳 ts 用于防止重放攻击。请确保开发服务器的系统时间与标准时间误差不超过几分钟，否则会导致签名验证失败。

7. 总结

通过上述步骤，你可以利用芯步开放的双模检测能力与标准HTTP接口，快速完成对壁挂式智能“双模”感应开关的二次开发。关键在于正确处理数据回调接收与签名认证，并结合业务需求编写状态变更的触发器逻辑。