CATALOG

一、先说痛点:为什么你需要这个?

搞实验室自动化或者搭建测试环境的同学都有体会——经常要控制一些低压设备,比如直流电机、电磁阀、LED灯带、小水泵之类的东西。传统做法要么是手动拨开关,要么自己搭继电器电路,还得写底层驱动,折腾半天还不一定稳定。

芯步这款2路低压直流控制板,说白了就是一个“能联网的智能开关”。你可以通过HTTP接口直接控制两路直流输出的通断,完全不用关心底层硬件细节。这篇文章就手把手告诉你,怎么把它优雅地塞进你自己的项目里。

二、硬件长啥样?先认识一下

这块板子有几个关键信息你需要知道

  • 两路独立控制:分别对应 power1power2 两个通道

  • 直流电压版:专门用于低压直流场景,别拿去接220V交流

  • WiFi连接:走2.4G WiFi,不需要额外买网关

  • 支持的命令:单路开关(power1/power2)、批量控制(batch)、先通后断(point)、先断后通(reset)

接线很简单,输入接你的直流电源(比如12V/24V),输出端接你要控制的负载就行。具体的接线图官方有产品手册,第一次用看一眼,别把正负极接反了。

三、核心思路:怎么让它听你的话?

这块板子的接入方式非常“程序员友好”——它开放了标准的HTTP API。也就是说,不管你用Python写脚本、用Java写后端、还是用Node.js搭服务,只要能发HTTP请求,就能控制它。

整体的调用流程是这样的:

你不需要维护长连接,也不需要处理MQTT重连之类的心跳逻辑,按需调用接口就行。

四、开干:具体怎么接?

第一步:把设备配网上线

拿到板子第一件事是让它连上WiFi。芯步提供了两种配网方式

方法一:物联网控制台(电脑操作)

  1. 注册账号,创建工作台,进入“物联网控制台”模块

  2. 左侧菜单找到“网络配置”,把你实验室的WiFi名称和密码填进去(注意:必须是2.4G频段)

  3. 给设备上电,它会自动搜索并连接这个WiFi

方法二:小程序(手机操作)微信搜“芯步小程序”,登录同一账号,同样是在“网络配置”里添加WiFi信息。

配网成功的标志是设备上的指示灯停止闪烁。这时候你可以在控制台看到设备变成“在线”状态,顺便记下它的设备ID——后面调用接口全靠它。

第二步:拿到你的专属密钥

要调用API,你需要三个东西:

  • AppID:你的应用ID,注册后可以在控制台看到

  • sign:请求签名,用来验证身份

  • ts:当前时间戳,防止请求重放

sign的生成规则在官方文档里有详细说明,简单说就是把你的密钥和参数按规则拼起来做哈希。Python示例大概是这样的:

小提示:第一次调试用控制台自带的API调试工具先把流程跑通,再往代码里搬。

第三步:控制设备通断

最核心的操作来了——控制那两路输出的开关

单路控制:只开关其中一路

  • power1=1 表示打开第一路,power1=0 表示关闭

  • 同理,power2=1/0 控制第二路

双路同时控制

批量控制:如果你实验室里挂了多个控制板,想一次全关掉,可以用batch命令,这里就不展开了。

返回结果长这样

code为200说明命令执行成功,设备那边应该马上就动作了。

第四步:查一下设备状态

有时候你想确认设备当前是不是在线、两路开关目前是开还是关,可以调用获取设备详情接口

返回的state字段里能看到power1power2的当前状态,online.status为1表示设备在线。

五、实战场景:代码怎么写?

假设你要写一个Python脚本,在实验流程跑到某个阶段时自动打开水泵(接在第一路),5秒后关闭:

就这么几行代码,你的实验流程就和硬件打通了。

六、几个实用小贴士

  1. 局域网模式:如果你实验室网络不稳定,或者不想走外网,芯步的设备也支持私有化部署,可以在纯局域网环境跑。具体需要联系他们开通。

  2. 超时处理:API调用是异步的,命令下发成功不代表设备一定执行了(比如设备刚好断网)。调用后等个一两秒再查询状态确认一下。

  3. 多设备管理:一个请求可以同时控制多个设备,device参数用逗号隔开就行,比如device=1002,1005。适合做批量操作。

  4. 别踩的坑

    • WiFi必须2.4G,5G频段连不上

    • 直流电压别超规格,烧了不保修

    • 如果控制大电流负载(比如直流电机启动瞬间电流很大),加中间继电器,别