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 。
配网有两种方式:
方式一:小程序配网(推荐)
微信搜索“芯步”小程序。
登录你的账号(没账号先去官网注册)。
选择你创建的工作台,点击右上角“+”添加设备。
输入家里的 2.4G WiFi 密码,按照提示让设备扫码或等待自动发现。
显示“设备在线”即成功 。
方式二:控制台配网
登录芯步官网 -> 进入工作台 -> 物联网控制台 -> 网络配置 -> 登记现场 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 )。
五、代码实战示例
看几个最常用的对接语言示例,你复制过去只需要改 AppId、AppSecret 和 Device ID。
Python 示例
前端 JavaScript (浏览器/小程序)
在小程序或网页里用 fetch 请求注意跨域问题,推荐从小程序后端发起,这里展示 axios 写法:
PHP 示例
适用于后端 Server 环境
六、高级互动:状态同步
既然是普通灯具,你肯定希望知道灯当前是开还是关。DC-10A 的状态会实时上报。
你需要搭建一个公网可访问的 “消息服务器” (或者用芯步自带的可视化控制台看,但自己做项目需要自己接)。在“开发设置”里配置 “消息推送 URL” 。
当设备状态变化时(比如手动按了开关,或用手机控制了),平台会主动 HTTP POST 请求你的服务器,告诉你是开还是关 。拿到这个消息后,存到数据库,就能保证 App 上的开关状态始终是准的了。