如何接入壁挂式红外雷达融合感应器来实现照明设备电源控制_解决方案

CATALOG

芯步的硬件开放接口挺简单的，HTTP请求就能调。下面我结合壁挂式红外雷达融合感应器和照明控制器，写一份“人来灯亮、人走灯灭”的接入方案，稍微口语化一点，但该有的技术细节都有。

1. 咱们先聊聊这个方案是要干啥

你是否有过这样的体验？走进会议室，摸黑找开关；离开卫生间，灯还亮着没人关。传统的照明控制方式不仅麻烦，还特别浪费电。

现在有了物联网技术，这事儿就能变得特别“聪明”了。咱们今天的主题，就是利用芯步的“壁挂式红外雷达融合感应器”和“智能照明控制器”，通过他们开放的HTTP接口，自己动手写点代码，实现人来灯亮、人走灯灭的自动控制效果。

说白了，就是用传感器当“眼睛”，看有没有人；用控制器当“手”，去开关灯；用你的服务器当“大脑”，做决策。整个过程完全不需要依赖芯步官方的云平台，你可以把这段逻辑集成到自己的小程序、App或者管理后台里。

2. 硬件

要搭这个系统，需要两位主角出场：

主角一：壁挂式红外雷达融合感应器 (型号：UNI-CGQ-RT-BG-HL)
- 这玩意儿牛在哪？ 它是红外和雷达的融合。纯红外感应容易被热源（比如暖气、阳光）干扰，人不动它就以为没人了。加上雷达之后，就算你坐在那儿看手机一动不动，它也能探测到微小的肢体动作，确保不会“误判”关灯，把你黑在屋里。
- 怎么联网？ 直接连Wi-Fi（2.4G），不需要买额外的网关，插电就能用。
主角二：智能照明控制器 (例如：UNI-KZQ-ZM-4 或 8路型号)
- 它的任务： 负责物理上的通电和断电。你可以把它想象成一个能用手机APP控制的“空气开关”或者“继电器”。
- 怎么接？ 把灯的零火线接在控制器上。如果只控制一个区域，买1路或4路的就够了；如果是大办公室，可以选8路的，分区域单独控制。

3. 接入“脑回路”

这套系统的逻辑非常简单，三步走：

感知： 传感器检测当前区域是否有人。
上报： 一旦“有人”或“无人”的状态发生变化，传感器主动发个请求到你的服务器（注意：是传感器主动告诉你，而不是你的服务器一直去问，这样效率更高）。
执行： 你的服务器根据接收到的状态，通过HTTP接口给“照明控制器”下命令：“开灯”或者“关灯”。

整个闭环跑在局域网或公网上都行，延迟很低，大概在80-120毫秒左右。

4. 动手开发

这部分比较接地气，纯干货。

在芯步的体系里，所有设备都开放了HTTP接口。你需要先在他的控制台里注册一个开发者账号，拿到两个关键凭证：AppID（你的应用ID）和 AppSecret（你的应用密钥）。这两个东西是为了保证接口安全，防止别人随便控制你的设备。

第一步：让传感器“说话”（数据上报）

当有人进入或离开感应范围时，传感器会向你的服务器地址（需要预先在设备设置里配置好）推送数据。假设你的服务器收到了传感器发来的数据，格式大概是这样：

你的后台代码只需要解析这个参数，拿到 radar_status 的状态就行。

第二步：大脑做“决策”（逻辑处理）

你的服务器写一段简单的逻辑：

小贴士：加上延时。比如检测到“无人”后，等待30秒甚至1分钟再关灯，避免人只是稍微动了一下灯就灭了。

第三步：指挥控制器“干活”（下发命令）

这是最核心的一步。当你的服务器决定“开灯”时，需要向芯步的API接口发一个请求。接口地址是：

请求方式：POST请求头Content-Type: application/json

请求体 (Body) 里面要包含两个东西

device：控制器的设备ID（比如 "Light_01"）。
order：具体的动作指令。

具体的请求体示例假设你想让“1路线路”通电开灯，命令如下：

如果你的控制器接了多个灯，想把第2路关掉，就把 power2 设为 0。

有个关键点：签名算法

很多朋友在这步犯迷糊，其实特别简单。官方要求的签名算法是 md5(md5(AppSecret) + ts)。

拆解一下：

把你拿到的 AppSecret 做一次MD5加密。
把加密后的字符串加上当前的Unix时间戳（ts，精确到秒）。
把拼接后的字符串再做一次MD5。这样就得到了sign。

这种双重加密比较安全，就算时间戳被看到了，没有你的Secret也解不出正确的签名。

第四步：看看完整代码示例

如果你用Python写后端服务，核心代码也就十几行，非常简洁

import requests
import hashlib
import time

# 配置你的账号信息
app_id = "你的AppID"
app_secret = "你的AppSecret"
device_id = "控制器的设备ID" # 例如:ZN1001

# 1. 生成签名（照抄模版即可）
def generate_sign(secret, ts):
    # 官方规则:md5(md5(secret) + ts)
    step1 = hashlib.md5(secret.encode()).hexdigest()
    step2 = (step1 + str(ts)).encode()
    sign = hashlib.md5(step2).hexdigest()
    return sign

# 2. 控制灯的函数
def control_light(action): # action = 1 开灯, action = 0 关灯
    ts = int(time.time())
    sign = generate_sign(app_secret, ts)
    
    url = f"https://api.thingboot.com/{app_id}/device/control/?sign={sign}&ts={ts}"
    
    # 组装命令
    payload = {
        "device": device_id,
        "order": {"power1": action}
    }
    
    try:
        response = requests.post(url, json=payload)
        print(f"指令已发送，服务器返回:{response.text}")
    except Exception as e:
        print(f"控制失败，错误信息:{e}")

# 3. 模拟收到传感器数据
def on_sensor_data(data):
    if data == "someone": # 有人
        print("检测到有人，开灯")
        control_light(1)
    else: # 无人
        print("检测到无人，关灯")
        control_light(0)

# ---------- 实际运行 ----------
# 假设这是你的服务器收到了传感器的消息
test_data = "someone"
on_sensor_data(test_data)

5. 实战小贴士

关于“持续无人”策略：在代码里最好不要“收到无人信号立马关灯”。配合传感器的“无人重复上报”功能，或者你在代码里加个定时器。比如：收到无人信号，等30秒再发关灯命令，30秒内如果又收到有人信号，就取消关灯。
支持局域网私有化：如果你担心网络延迟或者数据安全，芯步这套设备是支持私有化部署的。你可以在本地服务器上跑API，设备只在内网通信，稳如泰山。
感应距离调节：壁挂式雷达的灵敏度通常是可以调的。如果是装在卫生间或小会议室，灵敏度调低一点，避免隔墙误判；如果是大走廊，调高一点。

6. 总结

芯步的这套方案，本质上就是把“传感器”和“控制器”变成了可以通过HTTP调用的API。

你不需要关心底层硬件是怎么通信的，只需要关注业务逻辑：收到“有人”信号 -> 调用“开灯”接口；收到“无人”信号 -> 调用“关灯”接口。

只要你的服务器能连网，不管是Java、Python、PHP还是Node.js，甚至是低代码平台，都能在10分钟内把这套自动化逻辑跑通，实现真正的智能照明。