CATALOG

针对芯步 UNI-TDQ-AC1-10A 智能通断器(2200W适用于10A规格),结合其开放接口,以下提供一套完整的远程控制与状态查询技术解决方案。

1. 产品概述与准备

芯步智能通断器 AC1(型号:UNI-TDQ-AC1-10A)是一款支持 2200W 负载的单路大功率通断控制器。该设备核心优势在于:

  • 直连 WiFi:无需额外购买网关,支持 2.4G 网络

  • 开放 HTTP API:芯步全系产品(包括此通断器)开放标准的 HTTP 接口,这意味着你可以绕过其官方 App,直接将设备集成到自己的系统中(如:自建智能家居平台、工厂设备监控系统、远程灌溉中控等)

  • 状态反馈:支持主动查询设备当前开关状态。

准备工作

  1. 硬件:UNI-TDQ-AC1-10A 通断器,接入 2200W 以下负载(如热水器、大功率灯组)。

  2. 网络:设备通电并配置连接至 Internet(通过 2.4G WiFi)。

  3. 账号与凭证

    • 注册 芯步 开发者/平台账号。

    • 在控制台获取 AppIDAPI Token(用于签名计算)。

    • 获取目标设备的 Device ID(设备配网后在控制台可见)。

2. 技术实现:接口调用逻辑

实现“远程开关控制”和“状态查询”主要涉及两个核心 API 接口。

2.1 鉴权机制

所有请求都需要携带签名(sign)和时间戳(ts)。

  • API 地址http(s)://api.thingboot.com/{AppID}/...

  • 核心 Header:通常需要携带 Content-Type: application/json 以及 X-APISpace-Token

2.2 核心接口实现

第一种场景:远程开关控制

功能:下发指令让设备立即开启或关闭。

  • 请求方式:POST

  • 接口路径/{AppID}/device/control

  • 参数详情

    • device:设备 ID(字符串)。

    • order:命令(JSON 字符串)。

      • 开启{"power1":"1"}

      • 关闭{"power1":"0"}

代码示例 (Python)

第二种场景:开关状态查询

功能:主动获取设备当前是开还是关。

  • 逻辑说明:根据芯步的通用架构,状态查询通常可以通过两种方式实现:

    1. 主动拉取:调用 device/status 接口(若有)或查询设备详情。

    2. 事件监听:设置 WebHook(消息推送),设备状态变化时即时推送。

实现方案:拉取状态数据通常可以通过 HTTP 接口查询设备的最新数据点。

  • 请求方式:POST / GET

  • 接口路径/{AppID}/device/info (部分版本使用此路径) 或 device/status

  • 参数device=device_id

代码示例 (Python 状态查询)

3. 高级功能与应用扩展

此通断器 AC1 绝不仅仅是只能开关,它的开放接口还支持以下高阶玩法,对于 2200W 的大功率设备管理尤其有用:

3.1 设备状态保持(防误触)

在工业或公共场所,防止现场人员误触开关导致机器停机?

  • 接口支持:可以使用 keep 参数锁定状态。

  • 命令示例{"power1":{"keep":"1","revert":"3"}}

    • 效果:强制保持开启状态,如果有人手动关掉,3秒后设备会自动恢复开启

3.2 脉冲控制(点动模式)

如果你需要控制电动门、电锁或排气扇定时关闭(避免忘记关):

  • 命令示例{"point1":"2000"} (先通后断,开启持续 2 秒后自动关闭)

  • 应用场景:控制 2200W 的大型水泵抽水 5 秒后自动停。

3.3 断电重启状态设置

2200W 设备通常功耗较大,针对电网不稳定的区域,你可以设定断电来电后设备的状态。虽然这通常在 Web 控制台配置,但接口也支持类似逻辑。

4. 常见问题排查

  1. 签名错误 (Sign Error)

    • 芯步的签名通常涉及 AppIDTokents 的组合哈希。注意参数顺序及时间戳的有效期(通常为 5 分钟内)。

  2. 设备离线

    • AC1 仅支持 2.4G WiFi。请确保路由器关闭了 5G 融合或设备连接的是 2.4G 频段。

    • 2200W 负载提醒:虽然 AC1 标称支持 2200W,但如果是感性负载(如电机、空调压缩机),启动电流较大,预留余量,控制在 1800W 以内更为稳妥。

  3. 状态查询延迟

    • 如果是通过 HTTP 轮询查询状态,会有一定的延迟(取决于你轮询的频率)。如果需要实时反馈(如按钮按下瞬间 UI 更新),配置消息服务器(WebSocket 或 MQTT)接收设备主动推送的状态。

5. 总结

通过上述方案,你可以通过几行代码轻松调用芯步的开放接口,实现对 UNI-TDQ-AC1-10A 通断器的远程开关和状态查询。这套基于 HTTP 的方案具有语言无关性(Java/C#/PHP 均可),且无需网关,非常适合集成进企业内部的管理系统(如 ERP、OA)或智能场景自动化脚本中。