CATALOG

DC-10A这款智能通断器最大的好处就是接口开放、上手快,用HTTP请求就能直接控制低压直流设备的通断。下面这份方案会带你从拿到设备到调通接口,把整个对接流程走通。

一、准备工作:把东西先凑齐

在敲代码之前,咱们先把硬件和“钥匙”准备好。

  1. 硬件清单

    • 智能通断器DC-10A:这是主角。

    • 低压直流负载:比如12V或24V的LED灯带、直流电机、电磁阀之类的。注意别超过DC-10A的额定电压和10A电流。

    • 直流电源:根据你的负载来,比如12V/5A的适配器。

    • 2.4G WiFi网络:这玩意儿不支持5G频段,记得把路由器2.4G频段打开。

  2. 软件准备(拿钥匙)

    • 注册芯步账号。

    • 登录控制台,找到“开发设置”。你会看到两个关键字符串:

      • 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

  • URLhttp://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小时)后 自动断开。

这个功能对于控制自动灌溉、临时充电等场景非常实用,哪怕你的断网了,设备内部也会执行这个定时任务。

五、注意事项(避坑指南)

  1. 关于返回值200:接口返回200只代表“平台收到了指令”,不代表“设备执行了指令”。如果设备离线(比如断电了),你也会收到200,但设备其实没动。所以如果发现控制没反应,记得先去控制台看看设备是不是在线(Online)

  2. 电源匹配:DC-10A是直流版,千万别接到220V交流电上去,会烧。

  3. 局域网私有化:如果你是在内网环境(比如工厂车间没有外网),芯步这套也支持私有化部署。只需要在控制台开启局域网模式,API地址可以指向内网IP,延迟会更低

  4. 签名算法:如果你不开调试模式,签名算法是 md5(md5(AppSecret) + ts),注意嵌套顺序和字符串拼接。直接用上面给的代码示例里的函数就行

总结

对接DC-10A其实就三步:

  1. 拿参数:AppID、AppSecret、Device ID。

  2. 发指令:POST一个JSON给指定URL,带上 {"power":1}

  3. 看结果:听继电器声音。

这套接口很轻量,只要设备能上网,不管你用什么编程语言,发个HTTP请求而已,哪怕是Excel里的VBA都能轻松控制。

通断器产品方案:
如何对接AC1智能通断器10A以实现漏电保护控制
查看 >>
仓储设备电源控制:如何将AC4-30A 物联网开关对接到自己的项目中
查看 >>
普通灯具系统交流控制:怎样将智能通断器AC1-10A对接到自己的项目中
查看 >>
怎样在智能垃圾桶电源控制中接入智能硬件以实现低电压监测告警
查看 >>
校园公共设备电源管理中:怎样把AC3-10A 计量版电源开关接入到软件项目中
查看 >>
低压场景方案:
智能家居低压设备控制:怎么把2路直流电压版控制器集成到软件项目中
查看 >>
实验室低压负载控制:怎么把DC-10A 设备电源控制器接入到自己的项目中
查看 >>
怎么在普通灯具系统交流控制中对接智能硬件以实现低压直流负载通断控制
查看 >>
户外低压景观灯控制:怎样将DC-10A 低压控制开关集成到软件项目中
查看 >>
实验室低压负载控制:如何将DC-10A 物联网开关集成到软件项目中
查看 >>
通断用途方案:
怎样在共享自习室 LED 灯条控制中集成智能硬件来实现低压直流负载通断控制
查看 >>
如何对接1路智能墙壁触摸开关以实现延时通断控制
查看 >>
怎样在车间设备机柜电源控制中集成智能设备来实现延时通断控制
查看 >>
怎样在居家电器控制中集成智能硬件来实现设备电源远程通断
查看 >>
怎样在无人值守包间设备控制中接入智能设备以实现HTTP接口远程独立控制通断
查看 >>