CATALOG

芯步这套接口走的是HTTP协议,签名验证也做了标准化封装,联动逻辑完全由你的业务服务器控制,自由度很高。下面按对接顺序来写,从接线到代码实现都有。

1. 痛点与解决思路

很多开棋牌室、茶室或影咖的朋友都有个烦恼:包间里只要人一多,或者到了夏天,空调要么忘记关,要么客人觉得太冷太热找不到遥控器。如果靠服务员人工巡查,不仅累,还很难做到及时响应。

我们要实现的效果是:在包间里放一个温湿度传感器,它实时把数据传给后台。当温度高于26度时,后台自动给控制板发指令,把第4路(接空调的那一路)打开;当温度低于18度时,自动关闭空调。湿度高了,自动开启第1路(排风扇)。全程不需要客人动手,老板在手机上也能看到每一个包间的环境状态。

2. 硬件选型与接线

这次用到的两样东西,都来自芯步的生态,它们之间通过局域网或互联网通信,不需要布线,改造起来很方便。

主角一:4路大功率包间电源控制板 MINI

  • 关键参数 :这款控制板最大的特点就是“大功率”和“分路明确”。它支持4路独立控制

    • 第1路 (16A) :一般接照明、排气扇、吸烟灯。我们用它来控制排湿。

    • 第2路 (16A) :接普通插座,比如麻将机、饮水机。

    • 第3路 (10A) :接门锁。

    • 第4路 (30A) :这才是重点,专门用来接2匹以下的空调,功率完全够用。

  • 接线:把空调插头直接插在第4路插座上,或者将空调电源线接入第4路对应的接线端子。排风扇接第1路。

主角二:环境“鼻子”——温湿度传感器

  • 作用:这是我们系统的“侦察兵”。把它挂在包间墙壁上,不需要任何操作,它会自动上报数据。

3. 联动逻辑架构

我们不直接让传感器去叫控制板干活(点对点通信比较难维护),而是通过你的业务服务器 做“大脑”。

  1. 数据上报:温湿度传感器检测到温度是28度,湿度80%。它立即通过HTTP协议,把这个消息推送到你指定的服务器地址。

  2. 逻辑判断:你的服务器收到数据后,代码里写死判断:if 温度 > 26 , then 开启空调

  3. 下发指令:服务器调用芯步的开放接口,找到对应包间的控制板,发送一条{"power4":1}的命令(1代表开,0代表关)。

  4. 执行动作:控制板第4路接通,空调启动。

4. 对接开发实操(偏口语版)

芯步的接口是标准的HTTP API,不需要特定的SDK,用Python、PHP、Java、Go甚至命令行工具curl都能调。这里以最常见的场景——“接收传感器数据并下发指令”为例。

第一步:获取凭证(AppID 和 AppSecret)

登录芯步的开发者后台,找到“开发设置”。这里你会拿到两个字符串:

  • AppID:就像你的账号ID。

  • AppSecret:密码,千万别泄露给前端

第二步:让传感器把数据发给你

在后台配置传感器的“数据上报URL”(也叫Webhook)。就像填快递收货地址一样,填上你的服务器地址,例如:http://your-domain.com/api/sensor/callback

当传感器上报数据时,你的服务器会收到类似这样的消息:

第三步:服务器处理逻辑(核心代码思路)

当你的服务器收到上面的数据后,马上执行一个函数。这里以伪代码举例,逻辑很直接:

第四步:如何调用接口开启空调?

这一步是核心,看芯步给的文档,调用接口时必须要做签名计算,防止别人随便乱开你的设备

  • 请求地址https://api.thingboot.com/{你的AppID}/device/control/

  • 参数

    1. ts:当前时间戳。

    2. sign:需要你计算的签名。公式是 md5( md5(AppSecret) + ts )

    3. body:包含设备ID和命令。

具体操作(以上面的开启空调为例):

  1. 准备命令{"power4":1}。如果你想把第1、2、4路全开了,可以传{"power1":1, "power2":1, "power4":1}

  2. 发送请求:你需要在代码里发一个POST请求,带上计算好的签名。

给开发小哥的小贴士很多人在这一步会踩坑,记得 Sign 的生成规则 是:先把 AppSecret 进行一次 MD5 转成小写,然后拼接上 ts(秒级时间戳),再把整个字符串做一次 MD5千万别搞反了顺序

5. 几个常见的联动场景

除了温湿度联动,这块控制板因为功率大、接口开放,其实能玩出很多花样:

  1. 无人自动节能配合人体传感器,如果检测到包间10分钟无人,服务器自动下发{"power4":0}(关空调)和{"power1":0}(关灯/排气)。客人回来再次感应到人时,再恢复空调。参考了行业通用的人感联动策略

  2. 远程手动应急比如客人在小程序上呼叫“太冷了”,服务员不需要去包间,在后台直接调接口设置{"power4":0}或者调整温控阈值。

  3. 定时全量关闭晚上12点,服务器定时任务跑一个脚本,给店里所有控制板下发{"power1":0, "power2":0, "power4":0},防止通宵浪费电。

6. 总结

通过这种方案,你就把物理设备变成了数字化的API。核心点有三个:

  1. 硬件基础:利用MINI控制板的大功率第4路直连空调,解决了普通智能插座带不动空调的问题

  2. 数据采集:利用温湿度传感器作为触发源,解决了“什么时候该开/该关”的判断依据

  3. 联动逻辑:通过中间服务器 + 开放HTTP接口,实现了自动化闭环。

这套方案不仅省去了买所谓“智能空调”的高昂成本,还能把现有的普通壁挂空调、排风扇全都利用起来,全部改造成本可能就是几百块的硬件费,但省下的电费和人工费是长期的。

控制器产品方案:
高端会所包间设备管理:怎样把8 路包间场景联动控制器接入到项目中
查看 >>
怎样在共享自习室 LED 灯条控制中集成智能硬件来实现低压直流负载通断控制
查看 >>
怎样接入8路防水防尘控制箱来实现远程控制8路线路
查看 >>
怎样对接智能直流控制器4路以实现联动场景逻辑控制
查看 >>
怎样对接 8 路智能交流控制模块以实现交流负载通断控制
查看 >>
联动场景方案:
怎样对接24 路智能分体远程集中控制模块来实现联动场景逻辑控制
查看 >>
怎么接入2路智能墙壁开关以实现场景联动照明门禁控制
查看 >>
怎么在商场店铺安全监测中对接智能设备来实现多设备联动控制
查看 >>
怎样在智能快递柜信号控制中集成智能硬件以实现多设备联动控制
查看 >>
如何在共享棋牌室设备电源集中管理中接入智能设备来实现自定义场景联动控制
查看 >>
温湿度用途方案:
智能办公温湿度控制:怎样把高精度温湿度探测器集成到项目中
查看 >>
如何在学校活动室环境管理中接入智能设备来实现温湿度数据实时采集
查看 >>
培训教室温湿度控制:如何把联动型温湿度控制器集成到软件项目中
查看 >>
怎么二次开发4路包间电器覆盖控制器MINI以实现包间温湿度联动控制
查看 >>
怎么在展会现场环境管理中集成智能设备以实现远程温湿度阈值设置
查看 >>