CATALOG

针对自助设备的安全监测,烟感传感器是最基础也最关键的防线。芯步的产品特色是提供开放的HTTP接口,这意味着你不需要复杂的嵌入式开发,通过标准的API调用就能把烟感数据集成到现有的管理后台、APP或小程序中。

以下是一份相对详细、偏口语化的解决方案,供你参考。

——基于芯步开放接口的低代码集成方案

一、 为啥我们要聊这个?

咱们做自助设备的(比如自助售货机、快递柜、共享充电宝机柜、银行ATM防护舱等),最怕啥?最怕着火

设备放在那里没人看,一旦因为电路老化或者有人扔烟头起火,等发现时可能已经烧光了。现在的需求就是:需要一个能实时监测烟雾、能报警、甚至能自动断电的“安全管家”,而且这个管家的数据得直接送到咱们现有的管理系统里,不能各玩各的。

芯步的烟感传感器和配套硬件刚好解决了这个问题——它们自带开放接口,你可以像调用天气API一样,把烟感数据拉回你自己的平台

二、 咱们准备拿哪些硬件干活?

在动手写代码前,咱们得先搞清楚物理设备。针对“自助设备”这个场景,选这款:

推荐硬件:智能人体存在雷达和烟雾传感器[壁挂] (或者吸顶款)为什么要选这个组合?因为自助柜体空间小,这款设备 “二合一” ,性价比高:

  1. 烟感模块:探测烟雾浓度,判断是否起火。

  2. 雷达模块:探测是否有人靠近。这个很有用!比如发生火情时,如果雷达探测到有人在柜子旁边,报警策略可以不一样(先语音驱离再断电);或者用来统计客流。

  3. 语音/蜂鸣器:设备自带 buzzer(蜂鸣器),发生险情可以本地大声报警,把准备扫码的群众吓跑,也能震慑纵火的人

辅助硬件:智能语音音柱如果你想在发现烟雾时,不只是软件弹窗,还要远程喊话(比如:“后台检测到烟雾,设备即将断电,请立即离开!”),可以加一个这个,也是HTTP接口控制,逻辑一模一样

三、 核心思路:云云对接(设备不直连你的数据库)

很多新手会问:“设备是不是要插网线连到我的服务器?”

其实不用这么麻烦。 芯步的做法是 “设备上行,指令下行” ,架构是这样的:

  1. 设备端:烟感连上wifi/4G网络,它只负责连接芯步的云平台。

  2. 中间层(关键):芯步的云平台开放了 HTTP API

  3. 你的服务器:你的后端程序去调用芯步的这个API,获取数据或发送指令。

这样做的好处是:无论你的自助设备在北京还是上海,只要有网,你的总后台就能管,不用拉专线,不用固定IP,甚至支持局域网私有化部署

四、 实操步骤:从拆箱到跑通代码

咱们分三步走,搞定对接。

第一步:准备工作(拿到两把“钥匙”)

  1. 注册&登录:去芯步官网注册账号,进工作台。

  2. 绑定设备:给烟感通电,用App给它配上网。在后台的“设备列表”里,你能看到一个设备ID(比如 1234567),这就是你将来要操作的对象。

  3. 拿AppID和AppSecret:在“开发设置”里找到这两个字符串。AppID是账号,AppSecret是密码,调用接口时需要。

第二步:核心代码逻辑(像发快递一样简单)

芯步的接口调用只需要构造一个HTTP请求。这里以大家最常用的 PHP / Python / Java 思维来写逻辑(附伪代码示例),你不需要关心硬件协议,只需要会发Curl请求。

接口地址格式:https://api.thingboot.com/{你的AppId}/device/control/?sign={签名}&ts={时间戳}

关键点:签名计算(Sign)为了防止接口被别人乱刷,要对请求进行加密。规则有点绕,但其实就是 “把你密码MD5加密后,再拼接上当前时间,再MD5一次”

口语化解释:

先把你的 AppSecret 做一次MD5变成字符串A;然后拿字符串A加上当前的时间戳(比如 1712553600)变成字符串B;再把字符串B做一次MD5,得到的就是 sign

请求体(POST Body):你要告诉系统控制谁、控制啥。

注:mq_enable 是烟感模块的开关命令,1是开启监测,0是关闭;如果你想让它响警笛,可能用的是 buzzer 命令

第三步:场景实战——当“烟感”遇上“断电”

光看API文档太枯燥,咱们直接上 “业务场景代码逻辑”

场景需求:当你开发的运维APP或者Web后台检测到烟感上报了“烟雾浓度过高”时,系统自动做两件事:

  1. 给管理员发短信(这是你系统的事)。

  2. 自动远程关闭自助设备的总电源,避免触电或扩大火灾(这是控制的事)。

芯步是如何帮你实现的?

虽然烟感本身切不了220V的高压电,但你可以利用芯步生态里的 “智能触摸墙壁开关”“通断器” 配合实现

对接逻辑流程图:

  1. 数据上行你的服务器通过 “轮询” 或者配置 “回调/Webhook” (芯步平台支持消息推送到你的服务器),收到了一条JSON数据。数据内容大概是:{ "device_id": "10086", "smoke_value": 500, "alarm": true }你的系统分析:500?这浓度是要着大火了!

  2. 逻辑判断你的代码里写死了一个规则:如果烟感ID 10086 报警,且属于点位 B区3号柜,则执行紧急预案。

  3. 指令下发(联动断电)你的服务器再次发起HTTP请求,这次目标不是烟感,而是控制电源的 “开关设备”请求Body变成:{ "device": "开关设备的ID", "order": {"power": 0} } (这里的power 0就是断电)

结果:用户还没反应过来,设备已经自动切断了电源,同时你的值班大屏弹出了红色弹窗:“B区3号柜 检测到火灾风险,已自动断电,请立即处理!

五、 避坑指南(稍微啰嗦两句)

在实际写代码对接的时候,有几个小细节需要注意一下:

  1. 签名时效性(TS)接口里的 ts 是时间戳。芯步的平台会校验这个时间和你服务器时间是否一致。如果你的服务器时间比标准时间慢了几分钟,接口会报错签名错误。解决办法:让服务器自动同步一下北京时间。

  2. 千万别在主线程里等设备响应调用接口下发命令(比如关电源),网络延迟大约在 80-120ms 左右。这个速度虽然快,但如果你在UI线程(比如点击按钮后)直接同步请求,界面可能会卡一下。用异步去发指令。

  3. 调试模式对接初期,可以直接在芯步的后台打开 “调试模式” 。这个模式下它会暂时忽略签名计算,你可以直接用Postman之类的工具先测试通不通,通了之后再写代码算签名,省得被签名算法搞崩溃

  4. 关于私有化如果你做的是银行、政府项目,要求数据不出内网,芯步的设备支持私有化部署。也就是设备直接把数据发到你指定的局域网服务器IP上,不经过芯步的公有云。这点对于涉密要求高的自助网点非常友好。

六、 总结

把芯步的安全烟感接到你的软件项目里,其实就是三个接口的事

  • 一个接口access_token(或者说计算Sign);

  • 一个接口查设备状态(或等平台推送);

  • 一个接口发控制命令(关电、响铃)。

只要你后端能发HTTP请求,哪怕是用Excel的VBA都能调通。剩下的就是把烟感的报警状态你业务系统的处置逻辑串联起来,比如“报警即断电”、“断电即派单”。这套方案跑通之后,你的自助设备就真的有了一层智能防护罩了。