这是一份基于芯步（ThingBoot）硬件特性的店铺人体感应照明解决方案。我已经尽力避免了官方文档那种冷冰冰的语调，尽量写得像技术伙伴在跟你聊天一样。
1. 唠唠嗑：为什么我们要这么搞？
各位开发者、项目负责人，大家好。
在店铺运营中，照明往往是一个“既简单又麻烦”的问题。顾客来了，灯没开，显得冷清；顾客走了，灯忘关，电费哗哗地涨。
我们要解决的，就是利用芯步的壁挂式人体活动监测器，做一个“聪明”的照明系统。核心逻辑就一句话：“有人咱就亮，没人咱就歇，而且怎么亮、亮多久，你说了算。”
对于开发者来说，我们的优势在于：这东西不用买昂贵的网关，连上 WiFi 就能干活，通过 HTTP 接口分分钟集成到你现有的店铺管理后台或者小程序里。
下面，我们直接上干货，聊聊怎么把这家伙“塞”进你的项目里。
2. 首先，认识一下我们的“探测员”
我们要集成的硬件是 [UNI-CGQ-RT-H-BG]（壁挂式）。它有几个很实在的特点，集成前你得知道：
它是“双保险”探测：这玩意不仅有传统的红外（感应大动作），还有雷达（能探测微动，比如人坐在那玩手机）。只有当红外和雷达都觉得“没人”了，它才敢关灯。这就避免了大晚上人还坐那儿，灯突然灭了的尴尬 。
它自带“开关”：这家伙屁股后面带一路继电器输出。你可以直接把灯线的零火线接上去，它能扛 2200W 的阻性负载（比如白炽灯）或者 350W 的感性负载（比如 LED 灯、节能灯）。这意味着大多数店铺的一路灯光，它能直接控制，不需要你再外接个几百块的智能断路器。
它会上报数据：只要探测状态变了（从没人变有人，或有人变没人），它立马会给你的服务器发一条 HTTP 请求 。
3. 架构怎么搭？
我们不要搞太复杂，推荐 “端 + 云”直连 的轻量级架构：
设备端：壁挂传感器（连店铺 WiFi）。
云端：你的业务服务器（控制台 / API）。
控制端：你的后台管理系统或店员手机端。
工作流程图解：
客户进店 -> 2. 传感器雷达/红外探测到 -> 3. 传感器发数据给你的服务器 -> 4. 你的服务器返回“开灯”指令 -> 5. 传感器接通继电器 -> 6. 灯亮。
4. 动手干：集成步骤详解
这里我们不讲废话，直接看你代码里要处理哪几件事。
第一步：配网与注册
设备上电后，用芯步的配网工具把设备连上店铺 WiFi。关键点：设备联网后，会去请求你预设的服务器地址。你需要准备一个公网地址或者内网地址（支持局域网），告诉设备往哪发数据 。
第二步：处理“上报”（核心逻辑）
这是最关键的一步。当有人经过，你的服务器会收到这样的 JSON 数据包：
你需要做的：写一个接口来接收这个数据。收到“有人”（infrared_target=1）的数据后，执行逻辑：
查一下这个店铺是不是在营业时间内。
如果是，调用下面的“下发指令”接口，让设备把灯打开。
第三步：下发指令（远程控制）
当你的服务器判断需要开灯时，向芯步的开放平台发一个 POST 请求。
接口地址示例：https://api.thingboot.com/{你的AppId}/device/control/
请求代码示例（思维版）：
特别注意：签名计算稍微有点绕（md5(md5(AppSecret)+ts)），封装成一个工具函数，避免每次都去翻文档 。
5. 进阶玩法：让你的项目更智能
既然数据都上来了，单纯控制开关有点浪费。你可以玩点花的：
玩法一：分段调光（如果接的是智能灯）
虽然这个传感器是开关量输出，但你可以结合那些可以调节亮度色温的智能灯泡。逻辑：例如下午 2 点光线好，有人进来只开 50% 亮度；晚上 8 点天黑了，有人进来开 100% 亮度。传感器只负责“触发”，具体怎么亮由你的业务逻辑决定。
玩法二：无人延时 + 防误判
店铺里有时候营业员可能站那不动（比如看手机），红外可能探测不到，但雷达能探测到呼吸带来的微动 。可以在你的代码里设定：收到“无人”信号后，延迟 3 分钟再关灯，防止频繁开关损耗灯具寿命。如果雷达一直探测到微动，就保持有人状态。
玩法三：客流统计（附加功能）
虽然主要是照明方案，但既然每个“有人”事件都上报了，你可以顺便统计一下进店人数。做法：在服务器端写个计数器，每当状态从“无人”切换到“有人”时，count++。结合 POS 系统，你甚至能算出进店转化率——照明系统顺便把客流的活儿也干了。
6. 踩坑指南 & 小贴士
关于 WiFi：这玩意只支持 2.4G WiFi，配置的时候记得把手机连到 2.4G 信号下，别连 5G 。
关于安装位置：既然是壁挂式，安装高度要注意一下。说明书提到雷达探测距离 5 米左右 。别挂得太高，不然只能探测到头顶；也别对着空调出风口（虽然这款抗干扰还行，但冷风流动太快有时会误报）。
关于本地控制 vs 云端控制：如果你对稳定性要求比较高（比如断网也得亮），直接用它的硬件联动模式（出厂设置好：有人继电器吸合）。但如果你要玩“根据时间段亮度不同”这种骚操作，就得走云端逻辑。
关于负载：如果店铺灯带特别长（超过 350W 感性负载），千万不要直接接在传感器上！会烧坏板子。解决方案：用传感器去控制一个交流接触器，再用接触器控制大功率灯具。传感器只是小信号，不要硬抗大电流 。
7. 总结
通过芯步这款壁挂传感器的开放 HTTP 接口，你要做的就是：写一个回调接口（收数据） + 写一个调用脚本（发指令）。
剩下的就是业务逻辑的 if-else 了。这种“设备只负责感知，服务器负责决策”的模式非常灵活，能让你在两天之内，就把一个普通的照明项目升级成物联网智能照明项目。
如果需要调整灵敏度或者继电器的触发模式，去产品的配置项（Config）里改一下红外开机状态、发现有人时的线路动作就行，不用改代码 。
希望这份方案对你有帮助，祝你项目顺利，把店铺照明玩出新花样！