如何接入智能 8 路远程通用控制器以实现8路独立线路控制_解决方案

CATALOG

芯步的8路控制器本身就是为开发者设计的——开放式HTTP接口，任何能发网络请求的编程语言都能调用。下面这篇方案会从硬件准备、接口鉴权、单路/批量控制命令到场景代码示例一步步展开，尽量写得接地气一些，方便你直接上手。

一、我们面对的是什么设备？（先认识一下硬件）

在开始写代码之前，咱们先得知道控制的是什么。芯步的这款 “智能8路远程通用控制器” （型号通常为 UNI-KZQ-TY-8），简单来说就是一个拥有 8 个开关的“遥控插座”。

它有两个常见的版本，购买时看你具体要控制什么电器：

1. 交流电压版

2. 直流电压版

核心亮点： 这设备不需要买网关，直接连你家的 2.4G WiFi，通电配网就能用，接口完全开放。

在接入之前，需要准备好三样东西：

硬件设备： 把控制器通上电，用网线或 WiFi 配置好网络（通常是用微信小程序配网，让设备连上云端）。
开发者账号： 去芯步的开发者平台注册一个账号。
拿到钥匙：
- AppID / AppSecret： 在控制台的“开发设置”里找。
- Device ID： 就是你买的那个设备的唯一编号，在设备列表里能看到。

芯步的接口比较直接，用的是 HTTP POST 请求。为了安全，它在 URL 里带了签名（Sign）。

请求地址： https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
参数解读
- {AppID}：你的应用 ID。
- {ts}：当前的时间戳（Unix 时间戳）。这是为了防止恶意攻击，时间差太大服务器会拒绝。
- {sign}：签名。

签名算法（通常是这样，具体看官方文档更新）：sign = md5(md5(AppSecret) + ts)

白话解释：把 AppSecret 做一次 MD5，算出来的结果再拼接上时间戳，然后再做一次 MD5。这样就算别人抓到包，没有 AppSecret 也造不出合法的签名。

现在进入正题，怎么通过代码把某一盏灯点亮，又把另一盏灯关掉？

我们需要往服务器 POST 一段 JSON 数据，核心是 order 这个参数。

如果想独立控制第 3 路接通（开），第 5 路断开（关）：

数据结构：

简单解释：powerX 代表第 X 路，“1” 代表闭合/通电，“0” 代表断开/断电。可以一条指令控制多路。

想一次性打开所有灯，或者下班了一键全关：

全关命令：

全开命令：

假如一个自习室有 8 个座位，你想让 1、3、5、7 号座位的灯通电（开），2、4、6、8 断电（关）：

命令：

这样就可以同时控制任意组合，非常高效。

这个功能非常实用，比如控制电动卷帘门或者饮水机加热（需要触发后自动停止）。

先通后断：相当于“点按”，先打开，隔几秒自动关闭。{“point”： {“interval”： 500}} *// 所有线路接通，500毫秒后断开*{“point”： {“relay”： [2，4]， “interval”： 1000}}*// 仅第2、4路接通，1秒后断开*
先断后通：相当于“复位重启”，先断开，隔几秒再接通。

“Talk is cheap， show me the code.” 以下是用几种不同语言的接入示例，你可以根据自己的后端语言直接拿去用。

如果你是在做小程序或者网页前端（注意跨域问题，在云端转发），可以直接用 wx.request 或 fetch

如果你是在 Linux 服务器上通过脚本触发（比如结合传感器自动控制）：

在实际开发接入中，新手容易遇到几个小坑，顺手帮你排一下：

WiFi 只支持 2.4G：现在的路由器很多是双频合一的，配置设备时，如果手机连着 5G WiFi，可能发现不了设备。解决办法：配置时关掉路由器的 5G 频段，或者用 2.4G 手机热点试一下。
负载不要超限：虽然是 8 路独立控制，但整机总功率是有限制的。交流版全开总负载不超过 4400W（阻性），感性负载（电机类）更小，大概 700W。如果是控制灯带（阻性负载