芯步这套二合一传感器挺有意思的——一个设备同时搞定“有没有人”和“有没有烟”，刚好解决园区公区安全的两个痛点。下面我把“怎么接入、怎么联动、代码怎么写”串起来讲清楚。
一、这个“二合一”到底是什么来头？
咱们先把这个硬件摸透。这玩意儿全称叫“智能人体存在雷达和烟雾传感器[壁挂]”，型号是 UNI-CGQ-RT-L-YW-BG。
它最大的特点就是把两种探测手段揉进了一个86式壁挂盒子里：
雷达探测（雷达模块）：它能探测到人的微动（比如呼吸带来的胸腔起伏）和大幅移动。官方数据是4米内能感知人体存在，6米内能感应到运动，角度大概120度。这意味着它比普通红外感应灵敏多了，人坐着不动写代码也不会误判为“无人”。
烟雾探测（烟感模块）：这就是传统的烟雾报警器功能，探测空气中的烟雾颗粒浓度。
为什么推荐用这个？在园区公区（比如卫生间、楼道、会议室、甚至储藏间），以前要装一个雷达感应器用来控制灯光或者做人员统计，还得再装一个烟雾报警器。现在二合一，少打一个孔，少接一根线，维护起来也省事。
二、接入的“地基”：两套核心机制
要把这东西接入你的软件项目，不用关心它底层的射频电路，把它看成一个有 WiFi 模块的小电脑就行。它支持直接连接 2.4G WiFi，不需要买额外的网关，通上电配好网就行。
芯步的开放接口主要有两个动作，你得让你的后端服务器跑起来：
机制 1：设备主动“喊”你（接收数据/消息推送）
传感器是不会等人来问的。一旦雷达扫到有人，或者烟感浓度超标，它会立刻把数据往你的服务器推。
怎么设置：在芯步的后台，配置一个 HTTP/HTTPS 的 URL 地址（比如
http://你的域名/api/yoyo/callback）。数据长啥样：当有人走进卫生间，你的服务器会收到类似这样的 JSON 数据包，告诉你哪个设备、什么时间、检测到了什么。
机制 2：软件命令设备（下发指令）
如果你想远程关掉那个烦人的蜂鸣器，或者远程自检，就需要主动调用芯步的 Open API。
接口地址
http(s)://api.thingboot.com/{AppID}/device/control/核心参数：设备ID（device）、你要下的命令（order）。
签名机制：为了安全，调用接口需要算签名
md5(md5(你的密钥) + 时间戳)。
三、实战演练：园区场景“软件接入”全流程
我们假设一个具体场景：园区某科技展馆的配电室。要求：一旦检测到有人非法闯入（非工作时间），同时烟雾浓度异常，软件平台不仅要弹窗，还要自动触发声光报警，并给安保队长手机发通知。
第一步：让后端跑起来（接收数据）
你需要写一个 Web API 接口，用来接收传感器发来的消息。这里用 Python Flask 举个例子（口语化解释逻辑）：
第二步：实现“一键消音”和“远程控制”（下发指令）
假设保安大叔赶到现场，发现是虚惊一场（比如有人在配电室门口抽电子烟导致误报），他想通过软件界面关掉设备的蜂鸣器，不然一直响吵死人。
这时候你的前端界面点一下“消音”按钮，后端就要去调用芯步的接口了。
请求示例
请求地址
https://api.thingboot.com/你的AppID/device/control/?sign=计算出的签名&ts=当前时间戳请求方式
POST请求 Body (JSON)
第三步：更高级的联动（场景自动化）
这一部分主要是后台代码的逻辑编排。这个二合一传感器最妙的地方在于，它把“人”和“烟”的逻辑结合在了一起。
逻辑案例：防止恶意破坏有时候烟雾报警可能是人故意遮挡或破坏导致的。
规则：如果雷达先检测到有人靠近，紧接着 10秒内烟雾传感器被触发（可能是喷漆或者堵住）。
代码判定：这不是火灾，而是人为破坏事件。
联动：立即截取附近的摄像头画面，派发工单让最近的巡逻保安去查看。
逻辑案例：节能减排 + 安全联动
规则：雷达检测到“无人”状态持续 30 分钟。
联动：软件平台自动向该设备下发指令，关闭其内部某些高功耗的探测模块，或者标记该区域为“空闲/安全”状态。一旦雷达切回“有人”，立刻激活全功能探测。
四、一个小提醒：关于“状态”
接入的时候有一个点要注意，官方文档里提到：
200 仅代表平台收到了指令，不代表设备执行成功了。
什么意思呢？比如你发指令关蜂鸣器，返回 code 200，只能说明网络通了、云平台收到请求了。但如果那台设备刚好 WiFi 断了、停电了，它其实还在那里嗷嗷叫。
解决方案你得监听设备的上行消息。设备如果成功执行了指令，它会发一条执行结果的推送给你。你的软件界面要根据这个“执行结果”来显示“消音成功”或“设备离线”。别只根据接口返回的 200 就把界面按钮变灰了。
总结一下这套方案的好处
硬件极简：一个设备搞定存在感应 + 烟雾探测，不用买两个硬件回来自己接线组网。
接口透明：就是标准的 HTTP 请求，不需要特定的物联网协议栈，哪怕你是用 Excel VBA 写程序都能调通。
数据鲜活：雷达能探测静坐的人，解决了普通感应器“人还在灯灭了”的尴尬，这能让你在做园区人员密度统计时数据更准。
按照这个路子，你只需要专心写好业务逻辑（比如怎么判非法、怎么发工单、怎么定阈值），硬件端的事，芯步的接口都帮你封装好了。