芯步的智能包间控制器(Max/Mini)本身就是为这类场景设计的——麻将机、空调、门禁统统接到控制器上,通过开放API就能实现自定义联动。以下从硬件选型、接口调用到场景配置,给出完整方案。
1. 解决概述
本方案的目标是利用芯步开放的 HTTP API 接口 以及 智能包间控制器(Max 或 Mini 系列),将麻将机、空调、门禁等传统电器接入物联网系统。
通过编写自定义脚本或在芯步控制台设置场景联动,可实现如下自动化逻辑:
第一种场景:用户下单支付成功 -> 自动通电(麻将机、空调、照明) + 自动关门。
第二种场景:用户点击“结束/退租” -> 自动断电 + 语音播报提醒。
第三种场景:定时任务 -> 如晚上 10 点后自动关闭空调或进入待机模式。
2. 核心技术架构
整个方案的实现基于以下三个核心要素:
硬件层:使用 智能包间控制器 作为执行终端。它直接物理连接麻将机(插座)、空调(强电继电器)、门禁(电磁锁)。
接口层:采用 “请求-响应” 机制。业务系统(SaaS/小程序后台)通过调用芯步的
/device/control/HTTP 接口,向指定设备下发order指令(如{"power":1})。业务逻辑层:支持两种联动模式。
云端 API 直连:您的服务器根据业务逻辑触发指令。
边缘/平台联动:利用平台内置的“场景联动”功能,配置“当设备状态变化/定时时间到 -> 执行动作”。
3. 关键设备选型与接线配置
为了实现自定义联动,首先需要完成物理线路的对接。推荐使用 智能包间控制器 Max 来进行演示,因其拥有 8 路独立电路,覆盖全屋需求 。
| 设备名称 | 对接硬件 | 接入方案(物理接口) |
|---|---|---|
| 麻将机 | 智能包间控制器 Max | 接入第 4、5、6 路(16A 插座接口)。将麻将机的电源插头插入控制器对应的插座接口。 |
| 空调 (2匹) | 智能包间控制器 Max | 接入第 8 路(30A 大功率接口)。注意:此路为直接通断控制,适用于支持断电后来电自动恢复运行的空调。 |
| 门禁一体控制器 | 智能包间控制器 Max | 接入第 7 路(门禁电磁锁接口)。通过继电器控制门锁的正负极通断,实现远程开门或关门。 |
| 语音提醒 | Max-TTS 版本 | 无需接线。通过网络下发 TTS 指令,利用设备内置喇叭播报自定义内容。 |
4. 自定义联动操作实现步骤
4.1 基础指令下发(API 调用方式)
所有自定义联动的核心是向设备下发指令。根据芯步的开放接口定义,调用方式如下:
请求地址: http(s)://api.thingboot.com/{AppID}/device/control/核心参数
device:设备 ID(必填)。order:命令内容(必填)。
对接操作示例 1:远程开启麻将机(控制第 4 路)假设麻将机接在 Max 控制器的第 4 路(对应寄存器地址通常为 channel_4 或类似,需根据物模型确认,通常通断控制为 power4),下发指令为:
对接操作示例 2:远程控制门禁(控制第 7 路)对门锁执行开门动作(通电开锁或断电开锁取决于锁类型,通常持续通电几秒后断开):
4.2 复杂场景联动:自定义自动化逻辑
为了实现“用户扫码支付 -> 自动开灯、开空调、关好门”,需要利用业务系统(您的服务器)监听支付回调,触发 API 请求。
逻辑伪代码实现流程:
触发:用户在小程序完成支付,服务器收到支付成功回调。
动作:服务器发起 HTTP 请求调用芯步接口。
指令序列
请求
device/control/,order包含power1=1(照明)、power8=1(空调)。请求
device/control/,order包含power7=0(如果门锁是通电开,则下发关闭确保门锁住;如果是断电开,则下发开启)。若有 TTS 版本,下发语音指令:
{"tts_text":"欢迎光临,空调已为您打开,祝您娱乐愉快"}。
4.3 纯软件层联动:场景联动配置
如果您不想写代码,可以利用芯步平台的 “场景联动” 功能实现机器间的互联 。
场景案例:空调与门禁的互锁联动。
配置触发器:选择 设备触发。选择“门磁传感器”或“门禁控制器”的“门状态”作为触发条件。
配置执行动作
条件 A:若
门状态 = 未关严-> 执行动作:禁止空调开启(或空调 power=0)。条件 B:若
门状态 = 已锁定-> 执行动作:允许空调面板控制,或空调 power=1。
5. 关键注意事项
感性负载限制:麻将机和空调属于感性负载(电机/压缩机),在通断电时会产生浪涌电流。Max 控制器规定:第 4-6 路的感性负载需控制在 500W 以内,第 8 路控制在 1100W 以内。如果空调功率较大,使用控制器的 30A 接口仅作为接触器信号,或者直接使用大功率交流接触器进行转接 。
空调的适配性:直接断电虽然简单,但对变频空调或部分高端机型不友好(会丢失设置)。如需完美控制温度模式,搭配具备 红外遥控学习 功能的网关(需确认控制器是否支持红外扩展),或者对接空调的 485 接口。本方案侧重于使用 Max 的第 8 路直接进行电源通断控制。
门禁安全逻辑:门禁控制在接口中增加
extra字段携带订单号,以便追溯开门记录。同时,系统应设置逻辑:“订单有效期内,门禁断电即开锁(如果是断电开锁类型),确保消防紧急情况下的逃生”。异步反馈机制:由于设备可能离线,
200返回码仅代表指令被平台接收,不代表设备已执行。在要求高可靠性的场景(如扣费后通电),需订阅平台的消息推送,确认设备真正返回了执行成功的信号 。
6. 总结
选用芯步的 智能包间控制器 Max/Mini,最大的优势在于其高度的集成性。该设备内部集成了大功率继电器,无需复杂的电路设计,直接将“强电”线路接入。
开发者只需关注 API 接口的调用逻辑,即可实现“人去灯灭、扫码供电”等自定义的商业化管理,极大降低了共享棋牌室、茶室的改造成本。