CATALOG

芯步的智能交流控制器2路(型号UNI-KZQ-AC-2)是一款支持HTTP接口控制的设备,可以让你通过编程方式实现对两路交流回路的独立通断控制。下面我详细说一下具体的接入方案。

一、准备工作

1.1 硬件准备

  • 智能交流控制器2路(型号:UNI-KZQ-AC-2)

  • 220V交流电源

  • 需要控制的负载设备(灯具、电机等)

  • 2.4GHz WiFi网络

1.2 账号准备

首先,你需要去芯步官网注册一个账号。注册完成后,登录进入控制台,创建一个“工作台”——你可以把它理解成一个项目空间,你所有的设备都会放在这里面管理

1.3 获取关键凭证

在工作台的“物联网控制台”里,找到左侧导航栏的“开发设置”,这里有两个关键信息你需要记下来:

  • AppID(开发者ID):相当于你的“用户名”

  • AppSecret(开发者密码):相当于你的“密码”,千万不要泄露给任何人

小提示:刚开始测试的时候,可以先打开“调试模式”。这个模式下不校验签名和时间戳,可以让你先跑通流程,省去签名的麻烦。正式上线的时候再关掉就行

二、设备配网

硬件到手后,第一步是让设备连上WiFi。芯步的设备不需要网关,直接连接2.4G WiFi就行

配网步骤:

  1. 给控制器通电

  2. 用微信小程序搜“芯步小程序”,登录你的账号

  3. 在小程序里选择你创建的工作台,点击“添加设备”

  4. 输入你家路由器的WiFi名称和密码(注意:必须是2.4G频段,5G的不行)

  5. 按照提示操作,直到设备指示灯停止闪烁,变成常亮或呼吸状态,就说明连上了

配网成功后,你会在控制台的设备列表里看到这台设备,记住它的设备ID,后面调用接口时会用到。

三、接口对接:实现单路/双路独立控制

这是重点部分。这款控制器的接口是基于HTTP的,无论你用Python、Java、PHP还是Node.js,只要能发HTTP请求就行

3.1 接口地址格式

{DeviceID}换成你实际设备的ID。

3.2 请求头(Headers)

参数名说明
AppID你的应用ID
sign签名(调试模式下可忽略)
ts时间戳(调试模式下可忽略)

3.3 控制单路通断

假设你只想单独控制第一路开启,其他路保持不变,可以这样构造命令:

请求体(JSON格式):

这里的参数含义:channel: 1代表第一路,state: 1代表开启,state: 0代表关闭

如果你想关掉第一路:

3.4 控制双路独立操作

如果你想同时控制两路(比如第一路开、第二路关),可以这样发命令:

或者用另一种命令格式:

第一种是独立控制,两路互不干扰;第二种是批量控制,可以一次性把多路的状态都定义好,一次性发送

四、代码示例:10分钟上手

4.1 Python示例

4.2 JavaScript(Node.js)示例

五、场景扩展

5.1 定时控制

既然能通过API控制,那你完全可以用cron任务(Linux定时任务)或Windows计划任务,配合上面的代码,实现定时开关。比如每天早上8点自动开启某一路设备。

5.2 传感器联动

如果再加上芯步的传感器设备,你可以实现这样的逻辑:温度传感器检测到温度过高 → 自动开启第二路散热风扇 → 温度降下来后自动关闭。

5.3 局域网/私有化部署

如果你的场景对网络稳定性要求很高,或者不方便连外网,这款控制器是支持私有化部署的。你可以把消息服务器搭在本地局域网里,所有控制指令走内网,完全不经过云端

六、常见问题提醒

  1. WiFi频段:只支持2.4G,不支持5G

  2. 单路最大电流:10A,别超载

  3. 调试模式:测试时记得打开,就不用纠结签名算法了;正式上线前关掉,把签名逻辑加上

  4. 设备ID在哪找:登录控制台 → 进入工作台 → 物联网控制台 → 设备列表,就能看到了

总结

接入芯步的智能交流控制器2路,整体流程就是:注册拿凭证 → 配网连WiFi → 发HTTP指令控制。最核心的就是那个POST请求,只要把这个跑通了,单路、双路的独立控制就都搞定了。整个过程如果顺利的话,十来分钟就能完成第一次控制,剩下的就是根据你的业务场景去扩展了。