一、先说痛点:为什么你需要这个?
搞实验室自动化或者搭建测试环境的同学都有体会——经常要控制一些低压设备,比如直流电机、电磁阀、LED灯带、小水泵之类的东西。传统做法要么是手动拨开关,要么自己搭继电器电路,还得写底层驱动,折腾半天还不一定稳定。
芯步这款2路低压直流控制板,说白了就是一个“能联网的智能开关”。你可以通过HTTP接口直接控制两路直流输出的通断,完全不用关心底层硬件细节。这篇文章就手把手告诉你,怎么把它优雅地塞进你自己的项目里。
二、硬件长啥样?先认识一下
这块板子有几个关键信息你需要知道
两路独立控制:分别对应
power1和power2两个通道直流电压版:专门用于低压直流场景,别拿去接220V交流
WiFi连接:走2.4G WiFi,不需要额外买网关
支持的命令:单路开关(
power1/power2)、批量控制(batch)、先通后断(point)、先断后通(reset)
接线很简单,输入接你的直流电源(比如12V/24V),输出端接你要控制的负载就行。具体的接线图官方有产品手册,第一次用看一眼,别把正负极接反了。
三、核心思路:怎么让它听你的话?
这块板子的接入方式非常“程序员友好”——它开放了标准的HTTP API。也就是说,不管你用Python写脚本、用Java写后端、还是用Node.js搭服务,只要能发HTTP请求,就能控制它。
整体的调用流程是这样的:
你不需要维护长连接,也不需要处理MQTT重连之类的心跳逻辑,按需调用接口就行。
四、开干:具体怎么接?
第一步:把设备配网上线
拿到板子第一件事是让它连上WiFi。芯步提供了两种配网方式
方法一:物联网控制台(电脑操作)
注册账号,创建工作台,进入“物联网控制台”模块
左侧菜单找到“网络配置”,把你实验室的WiFi名称和密码填进去(注意:必须是2.4G频段)
给设备上电,它会自动搜索并连接这个WiFi
方法二:小程序(手机操作)微信搜“芯步小程序”,登录同一账号,同样是在“网络配置”里添加WiFi信息。
配网成功的标志是设备上的指示灯停止闪烁。这时候你可以在控制台看到设备变成“在线”状态,顺便记下它的设备ID——后面调用接口全靠它。
第二步:拿到你的专属密钥
要调用API,你需要三个东西:
AppID:你的应用ID,注册后可以在控制台看到
sign:请求签名,用来验证身份
ts:当前时间戳,防止请求重放
sign的生成规则在官方文档里有详细说明,简单说就是把你的密钥和参数按规则拼起来做哈希。Python示例大概是这样的:
小提示:第一次调试用控制台自带的API调试工具先把流程跑通,再往代码里搬。
第三步:控制设备通断
最核心的操作来了——控制那两路输出的开关。
单路控制:只开关其中一路
power1=1表示打开第一路,power1=0表示关闭同理,
power2=1/0控制第二路
双路同时控制
批量控制:如果你实验室里挂了多个控制板,想一次全关掉,可以用batch命令,这里就不展开了。
返回结果长这样
code为200说明命令执行成功,设备那边应该马上就动作了。
第四步:查一下设备状态
有时候你想确认设备当前是不是在线、两路开关目前是开还是关,可以调用获取设备详情接口
返回的state字段里能看到power1和power2的当前状态,online.status为1表示设备在线。
五、实战场景:代码怎么写?
假设你要写一个Python脚本,在实验流程跑到某个阶段时自动打开水泵(接在第一路),5秒后关闭:
就这么几行代码,你的实验流程就和硬件打通了。
六、几个实用小贴士
局域网模式:如果你实验室网络不稳定,或者不想走外网,芯步的设备也支持私有化部署,可以在纯局域网环境跑。具体需要联系他们开通。
超时处理:API调用是异步的,命令下发成功不代表设备一定执行了(比如设备刚好断网)。调用后等个一两秒再查询状态确认一下。
多设备管理:一个请求可以同时控制多个设备,
device参数用逗号隔开就行,比如device=1002,1005。适合做批量操作。别踩的坑
WiFi必须2.4G,5G频段连不上
直流电压别超规格,烧了不保修
如果控制大电流负载(比如直流电机启动瞬间电流很大),加中间继电器,别