CATALOG

DC-10A 这款智能通断器最方便的地方在于它的 HTTP 接口——不管你的项目后端用 Python、Java、PHP 还是前端 JavaScript,只要能发 HTTP 请求就能控。下面我把整个接入流程串一遍,从硬件配网到接口调用都有,代码示例我会写得口语化一些。

一、硬件接线与上电

首先,你要把 DC-10A 物理接入到灯具线路中。

这款设备是直流控制交流的。简单说:

  • 输入端:接 12-24V 的直流电源(给智能通断器本身供电)。

  • 输出端:相当于一个继电器开关,用于控制 220V 交流灯具。

  • 负载接口:将 220V 火线剪断,一端接“输入”,另一端接“输出”,零线直通。

通俗点描述:把 DC-10A 想象成一个“遥控开关”,串联在你的灯具火线上。设备本身需要 DC 供电才能工作,工作后内部的继电器可以闭合或断开 220V 线路

*(关于详细接线颜色和端子说明,参考 DC-10A 的产品手册中的配图)*

二、设备配网(让设备联网)

接好线通电后,指示灯会快闪,表示进入了待配网状态。DC-10A 走的是 2.4G WiFi,不支持 5G

配网有两种方式:

方式一:小程序配网(推荐)

  1. 微信搜索“芯步”小程序。

  2. 登录你的账号(没账号先去官网注册)。

  3. 选择你创建的工作台,点击右上角“+”添加设备。

  4. 输入家里的 2.4G WiFi 密码,按照提示让设备扫码或等待自动发现。

  5. 显示“设备在线”即成功

方式二:控制台配网

登录芯步官网 -> 进入工作台 -> 物联网控制台 -> 网络配置 -> 登记现场 WiFi,随后手机开热点辅助设备获取 WiFi 信息

三、获取凭证与设备ID

配网成功后,在控制台找到这个设备,点击详情,找到 设备ID(如 123456)并记下来,发命令时会用到。

接着点击左侧菜单的 “开发设置” ,这里有两个关键信息:

  • AppId (开发者ID)

  • AppSecret (开发者密码)

特别提示:如果只是在开发阶段做测试,先打开 “调试模式” 。开启后系统会暂时忽略签名校验,可以先不考虑签名算法,直接用 Postman 测试,能通再说

四、接口对接方案

DC-10A 接受 HTTP POST 请求控制。因为是单路通断器,所以只控制“线路1”。

1. 请求地址(生产环境)

2. 请求 Body (JSON)

  • {"power1": 1}:开灯

  • {"power1": 0}:关灯

3. 签名算法(生产环境必须)

如果你没开调试模式,需要算签名 sign

即:sign = MD5( MD5(AppSecret) + ts )

五、代码实战示例

看几个最常用的对接语言示例,你复制过去只需要改 AppIdAppSecretDevice ID

Python 示例

前端 JavaScript (浏览器/小程序)

在小程序或网页里用 fetch 请求注意跨域问题,推荐从小程序后端发起,这里展示 axios 写法:

PHP 示例

适用于后端 Server 环境

六、高级互动:状态同步

既然是普通灯具,你肯定希望知道灯当前是开还是关。DC-10A 的状态会实时上报。

你需要搭建一个公网可访问的 “消息服务器” (或者用芯步自带的可视化控制台看,但自己做项目需要自己接)。在“开发设置”里配置 “消息推送 URL”

当设备状态变化时(比如手动按了开关,或用手机控制了),平台会主动 HTTP POST 请求你的服务器,告诉你是开还是关 。拿到这个消息后,存到数据库,就能保证 App 上的开关状态始终是准的了。