CATALOG

共享桌游室是典型的“高需求、低保障”空间——玩家需要随时调节灯光亮度来匹配游戏氛围,同时空调又常常因无人管理而整夜运转。本文将介绍如何利用芯步AC3-10A计量版线路控制器,通过HTTP接口快速实现空调与照明的智能化控制。

一、 解决概述

本方案的核心是利用 UNI-TDQ-AC3-10A-P 智能通断器(计量版),在不改动原有墙内线路和电气设备的前提下,将其串联在桌游室的空调或灯光电路前端。通过调用芯步提供的开放 API,将硬件的通断电控制、电量计量功能集成进你的“共享桌游室管理系统”中。

架构逻辑:

用户端(小程序/Web) -> 业务后端(你的服务器) -> 芯步云平台(API) -> WiFi 2.4G -> AC3-10A计量版 -> 空调/灯光设备

二、 硬件选型与参数

在选择硬件时,本文选定 “计量版” 而非普通版,主要基于两点:一是桌游室按小时计费需要精确统计耗电成本,二是需要监测空调功率以判断用户是否真实关闭设备。

  • 产品型号:UNI-TDQ-AC3-10A-P

  • 核心参数:额定电流10A,最大支持2200W(阻性),足以覆盖单台壁挂空调或整屋LED/灯带照明。

  • 优势特性

    • 无网关直连:直接连2.4G Wi-Fi,部署成本低。

    • 计量功能:实时反馈电压、电流、功率,可用于判断空调压缩机是否在工作

    • HTTP API:具备标准的Sign/TS鉴权机制,通信协议标准且开放程度高

三、 接口接入开发实战

芯步的接口设计类似于“云云对接”,不需要复杂的设备端SDK嵌入,仅需后端服务器发起HTTP请求即可。

1. 准备开发凭证

在开始编码前,需要先在芯步控制台获取以下三要素:

  • AppID:你的应用唯一标识。

  • AppSecret(开发者密码):用于生成签名,请严格保密,切勿放在前端代码中

  • Device ID:设备上贴的标签或配网后在后台查看的序列号。

2. 核心鉴权算法(Sign生成)

为了防止接口被恶意篡改,每次请求都需要携带签名。算法规则如下:

sign=MD5(MD5(AppSecret)+ts)sign = MD5( MD5( AppSecret ) + ts )

注意ts 必须是当前的10位秒级时间戳。服务器会校验时间差,防止重放攻击。例如:假设 AppSecret 是 “abc123”,计算其32位小写MD5值,拼接上 ts,再算一次 MD5 得到 Sign

3. 典型场景接口调用实例

第一种场景:用户扫码开台(开启空调/灯光)当用户在小程序支付成功后,你的后端需要向设备下发“开启”指令。

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

  • 请求方法:POST

  • URL参数sign={计算值}&ts={当前时间戳}

  • Body (JSON)

  • 逻辑说明power 字段值为 1 代表开启,0 代表关闭。实际测试中,从发起请求到继电器吸合,通常响应在80-120ms之间

第二种场景:实时读取电量与结束计费计量版的价值在于数据反馈。当用户点击“结束包场”时,你需要获取本次使用的耗电量来作为结算依据。

  • 请求指令:下发 {"metering":"1"} 命令。

  • 返回数据

    • 通常包含:voltage(电压)、current(电流)、power(功率)、energy(电量累计)。

  • 业务结合:如果检测到当前功率 > 10W,说明空调未关闭,你的系统可以提示“检测到空调未关,已为您强制切断电源”,并执行 power:0 操作。

四、 共享场景的特殊逻辑设计

为了让这套系统符合共享经济的商业模式,在软件逻辑上做以下优化:

1. 状态自检与防拉闸

  • 场景:用户恶意断电或跳闸。

  • 方案:你的后端应设有一个定时任务(如每10秒)去调用 API 读取设备状态(power 字段)。如果状态是在线但仍然是 0,或者设备直接离线(Wi-Fi断电),后端应自动标记该订单异常并通知管理员。

2. 超功率保护联动

  • 场景:用户私接大功率用电器(如取暖器)导致跳闸风险。

  • 方案:利用计量版接口,在代码中设置阈值。例如一旦检测到电流 > 9.5A,立即执行 power:0 切断并上报告警,保护线路安全

3. 自动化的平稳过渡

  • 场景:两个订单无缝衔接。

  • 方案:上一个用户结束 -> 后端发送 power:0 -> 等待 10-30秒(空调压缩机保护机制) -> 下一个用户扫码 -> 发送 power:1

五、 总结

通过接入 UNI-TDQ-AC3-10A-P,我们可以用极低的硬件改造成本,为共享桌游室赋能:

  1. 成本控制:无需更换昂贵的智能空调,普通壁挂机秒变智能,利用计量功能精准核算电费分成。

  2. 运维提效:远程管理灯光空调,可在非营业时段统一关闭所有设备,无需上门巡检。

  3. 用户体验:用户扫码即通电,一键掌控环境氛围。

这套方案的核心在于芯步提供的免费、无QPS限制的API接口,使得开发者只需关注业务逻辑(订单、计费、告警),无需处理复杂的物联网底层通信协议