这是一份解决方案，主要面向有开发能力的集成商或个人开发者，结合芯步的开放接口，把壁挂式红外雷达存在感应器接入自己的商场店铺照明项目里。

一、 咱们先捋一捋：为什么要这么干？

如果你是商场的业主或者做智能化改造的，肯定遇到过这种情况：顾客试衣服或者站在柜台前看商品，稍微不动，灯“啪”一下就灭了，非常尴尬。这是因为传统的红外感应器只能感知“动态”，人静止它就瞎了。

所以我们现在要用 “红外雷达存在感应器” 。这玩意儿牛在哪儿？它能探测到人的呼吸和微动，哪怕你站着不动看手机，灯也一直亮。

这篇方案就是教你：怎么把这种高级传感器，通过芯步的开放接口，接到你自己写的后台系统或者小程序里，实现真正的“人来灯亮，人走灯灭”。

二、 硬件选型：别买错了，要买这种

在淘宝或者芯步的生态里买设备时，记得认准 “人体存在” 这四个字，不要买普通的红外探头。

推荐特征：

1. 技术： 必须是 24GHz 毫米波雷达 或 红外+雷达双模 的 。普通的被动红外（PIR）不行。

2. 安装： 既然是壁挂式，说明你是装在墙上侧扫的（比如对着走廊或者货架）。

3. 参数： 一般这种设备在芯步平台上注册后，会自带“有人/无人”这个数据属性。

举个例子： 海凌科的 LD2410 系列或者类似的成品，只要接入了芯步生态，就能用下面的方法控制 。

三、 核心步骤：把这玩意儿“塞”进你的项目

这里不贴大段代码，直接告诉你逻辑怎么走。

第一步：设备“上网”与注册

你得先把感应器通电，配网，让它在芯步的“控制台”里显示为“在线”状态。这时候你会拿到两个最重要的身份证：

• 设备ID (Device ID): 这串数字就是这盏灯/这个传感器的身份证。

• AppID/API Key: 你的项目调用接口的入场券。

第二步：搞定你的“大脑”（服务器端）

你的项目需要一个后端服务。你要做的，就是让你的服务器能跟芯步的云端说话。

核心接口：HTTP API芯步提供了一个 向设备下发指令 的接口 。

• 地址：http(s)://api.thingboot.com/{你的AppID}/device/control/

• 核心参数：

  • device: 填你刚才拿到的感应器ID。

  • order: 这是重点！你要告诉感应器干什么。

最关键的“订单”逻辑：对于商场照明，我们最关心的是读取感应器的状态。但实际上，在物联网架构里，通常有两种玩法：

1. 主动问（HTTP 拉取）： 你的服务器每隔几秒问一次“现在有人吗？”（不推荐，太慢）。

2. 被动收（MQTT/回调 推荐）： 感应器一旦发现人来了，立马“告诉”你的服务器。

怎么收数据？你需要在你项目里设置一个“接收地址”作为消息推送的端点。感应器检测到状态变化（比如从无人变成有人），芯步云端会主动往你这个地址发一个 POST 请求，里面带着类似这样的数据：

你的后台收到这个，就知道：哦，该开灯了。

第三步：下发指令（让灯亮）

你的后台处理完逻辑后，最终要做的就是控灯。这也是调用 device/control 接口：

芯步的接口支持 JSON 格式，你直接用 POST 请求发过去就行了 。如果返回 {"code":200}，就代表指令下达成功，灯应该亮了。

四、 手把手教你写代码逻辑（伪代码版）

假设你正在写一个 Node.js 或 Python 的后端，逻辑大概是这样的：

场景：商场走廊，感应器发现有人走过来。

1. 接收事件：你写了一个接口 /yoyo_callback，专门等着收消息。

   # 芯步那边有人经过，就会自动调用这个接口 def receive_sensor_data(request): data = request.body device_id = data['device_id'] status = data['order']['presence'] # 假设这个字段代表有没有人 # 2. 业务逻辑处理 if status == "detected": # 查一下这个传感器关联的是哪几盏灯 light_ids = get_light_ids_by_sensor(device_id) # 3. 控制开灯 for light_id in light_ids: control_light(light_id, "ON") return "OK"

2. 封装控制函数：你写一个专门发指令的函数：

   def control_light(light_id, action): url = f"http://api.thingboot.com/{APP_ID}/device/control/" params = { "device": light_id, "order": json.dumps({"power": action}), # 发JSON字符串下去 "sign": generate_sign(...), # 别忘了签名算法 "ts": get_timestamp() } requests.post(url, data=params)

特别注意： 芯步的接口有个小细节，返回200只代表云端收到了，不代表设备执行了。如果设备离线，你也会收到200但灯不亮。解决方案： 需要监听异步消息推送，确认设备真的“已执行”，或者在代码里加入重试机制。

五、 针对“壁挂式”的几个调试小

壁挂式和吸顶式不一样，装在墙上有几个坑要注意，不然你的项目会被客户骂：

1. 不要对着空调/风扇吹：商场里空调风口多。24G 雷达虽然牛，但对风吹动的绿植、窗帘或者冷气气流还是有微弱影响的 。做法： 在芯步的控制台或者你代码里，如果能调 “灵敏度” ，记得把“静止检测”的阈值调低一点点，或者开启 “底噪自适应” 功能，让它自动过滤干扰。

2. 划区域（如果支持）：高端的雷达（比如 LD2410-AA）可以划分距离门 。项目场景： 你只想要当人走到距离墙3米以内才亮灯，3米外是通道不要管。做法： 你的代码里可以下发配置参数，把 0-3米设为“高灵敏度”，3米外设为“0”（不检测）。这样省电又精准。

3. 光线联动（省电绝招）：很多这种感应器是自带光照传感器的 。你的代码必须加上这一行判断：*if (light > 200 lux) return; // 白天光线好，有我也不开灯*只在天黑或者室内光线暗的时候才触发人体感应逻辑。这才是专业的商场节能方案。

六、 总结一下

把芯步的壁挂感应器接入项目，其实就是三步走：

1. 设备注册（拿到身份证）；

2. 订阅消息（等着收“有人”的信号）；

3. 下发指令（收到信号就去开灯）。

说白了，芯步帮你把底层的通信和连接搞定了，你只需要在你的项目里写好 “如果 A 传感器说有人，那么 B 灯就开” 这段简单的 If This Then That 逻辑就行。

你要是搞不定签名算法（sign），直接把芯步官方的 SDK 下载下来，基本都是一行 client.controlDevice(id, order) 搞定的事情。