DC-10A这款智能通断器最大的好处就是接口开放、上手快,用HTTP请求就能直接控制低压直流设备的通断。下面这份方案会带你从拿到设备到调通接口,把整个对接流程走通。
一、准备工作:把东西先凑齐
在敲代码之前,咱们先把硬件和“钥匙”准备好。
硬件清单
智能通断器DC-10A:这是主角。
低压直流负载:比如12V或24V的LED灯带、直流电机、电磁阀之类的。注意别超过DC-10A的额定电压和10A电流。
直流电源:根据你的负载来,比如12V/5A的适配器。
2.4G WiFi网络:这玩意儿不支持5G频段,记得把路由器2.4G频段打开。
软件准备(拿钥匙)
注册芯步账号。
登录控制台,找到“开发设置”。你会看到两个关键字符串:
AppID(开发者ID):相当于你的“用户名”。
AppSecret(开发者密码):相当于你的“密码”,千万别泄露给前端。
强烈:刚开始对接时,先在控制台打开“调试模式”。这样接口就不校验签名(Sign)了,省去前期算签名的麻烦,先调通业务逻辑再说。
二、设备配网:让设备连上WiFi
拿到手的DC-10A还没联网,得先把它“拉”进家里或公司的网络。长按设备上的按钮(通常是5-10秒),直到指示灯快速闪烁(像心跳一样快闪),这时候它就进入“配网模式”了。
怎么配? 用微信小程序搜“芯步”,登录后跟着提示走,输入WiFi密码就行。配网成功指示灯会常亮或慢闪。
三、核心对接:用代码“点灯”
这是最关键的一步。我们要通过发HTTP请求,让DC-10A执行“闭合”或“断开”的动作。
1. 搞清接口地址和命令格式
芯步的接口设计得比较规整,控制设备的地址是固定的
针对 DC-10A,官方手册里写明了控制命令就是 power 字段
开启(通电)
{"power":1}关闭(断电)
{"power":0}
2. 实战:用在线工具(Postman)测试
先别急着写代码,用Postman调一下。
Method:POST
URL
http://api.thingboot.com/你的AppID/device/control/?ts=当前时间戳&sign=你的签名(如果在调试模式,sign随便写个123也行)Body (JSON)
如果返回 {"code": 200},说明命令已经成功下发了,这时候去听一下,通断器里应该会有继电器“咔哒”一声的吸合声,你的灯就亮了!
3. 代码示例(Python)
假设你已经在控制台看到了设备ID是 123456。
四、进阶玩法:定时和点动
有时候我们不只需要简单的开和关,比如想按一下按钮,让电机转1秒钟自动停,这就是“点动”。DC-10A支持通过命令直接实现,不用你写定时器去发“关”命令。
如果你想实现 “接通1小时后再断开” ,可以直接发这条命令:
power: 1代表立即接通。reset: 3600000代表 3600000毫秒(即1小时)后 自动断开。
这个功能对于控制自动灌溉、临时充电等场景非常实用,哪怕你的断网了,设备内部也会执行这个定时任务。
五、注意事项(避坑指南)
关于返回值200:接口返回200只代表“平台收到了指令”,不代表“设备执行了指令”。如果设备离线(比如断电了),你也会收到200,但设备其实没动。所以如果发现控制没反应,记得先去控制台看看设备是不是在线(Online)。
电源匹配:DC-10A是直流版,千万别接到220V交流电上去,会烧。
局域网私有化:如果你是在内网环境(比如工厂车间没有外网),芯步这套也支持私有化部署。只需要在控制台开启局域网模式,API地址可以指向内网IP,延迟会更低。
签名算法:如果你不开调试模式,签名算法是
md5(md5(AppSecret) + ts),注意嵌套顺序和字符串拼接。直接用上面给的代码示例里的函数就行。
总结
对接DC-10A其实就三步:
拿参数:AppID、AppSecret、Device ID。
发指令:POST一个JSON给指定URL,带上
{"power":1}。看结果:听继电器声音。
这套接口很轻量,只要设备能上网,不管你用什么编程语言,发个HTTP请求而已,哪怕是Excel里的VBA都能轻松控制。