DC-10A是芯步推出的一款支持HTTP接口的智能通断器,无需网关、可直接接入各类软件项目。下面从硬件连接、接口协议到代码实现,梳理完整的接入方案。
一、 DC-10A 智能通断器选型分析
在智能办公场景中,往往需要控制会议室投影机电源、工位插座、新风系统或者饮水机等设备。传统的改装不仅需要动强电线路,还需要复杂的PLC编程。
DC-10A 的核心优势:
逻辑与强电隔离:控制端是弱电信号或HTTP请求,被控端是DC直流强电(最高10A),保障了调试人员的安全。
API优先:该设备原生支持HTTP接口调用,意味着你不需要购买额外的网关硬件,直接用代码控制。
断网运行:支持私有化部署和局域网直接通信,即使办公室外网断了,内部系统依然可以控制设备。
适用场景:控制12V-24V的直流供电设备(如LED灯带、直流风扇、监控电源、部分工业传感器)。
二、 硬件接入与网络配网
在写代码之前,需要让设备“上网”。DC-10A 支持WiFi 2.4G直连。
第一步:接线
输入端:接入DC电源正负极(12V-24V,注意电流不超过10A)。
输出端:接入被控设备(例如把灯带的正极线断开,两头分别接入模块的“输出”端)。
控制端:模块内部已集成控制电路,无需额外接线。
第二步:配网由于设备没有屏幕,通常采用 SoftAP(热点配网) 或 SmartConfig(一键配网) 模式。
设备通电后,会发出一个以
TB-xxx命名的热点。手机/电脑连接该热点,浏览器访问
192.168.4.1。在弹出的页面中,扫描并输入办公室的WiFi密码。
(关键步骤)固定IP:在办公室路由器后台,将该设备的MAC地址绑定一个固定内网IP(例如
192.168.1.100)。这对接下来的API调用至关重要。
三、 接口协议深度解析
根据产品手册,设备开放HTTP接口,支持任何支持HTTP请求的编程语言接入。
1. 接口基础信息
协议:HTTP (支持POST/GET)
数据格式:JSON
寻址方式:通过
设备ID或局域网IP进行寻址。
2. 核心API列表
① 查询设备状态 (Get Status)
目的:在改变状态前,确认设备当前是开还是关,或者是否在线。
Method:
GETURL:
http://[DEVICE_IP]/statusResponse Example:
② 控制开关 (Control)
目的:执行通断操作。
Method:
POSTURL:
http://[DEVICE_IP]/controlHeader:
Content-Type: application/jsonBody:
特殊参数
duration:用于办公节能场景非常实用。例如开启会议室排风扇,设定1小时后自动关闭,防止忘记关导致浪费。
③ 自定义API签名验证模式如果是远程控制(非局域网),或者为了安全性,设备支持签名验证。需要在请求头中携带sign和timestamp。签名算法通常是:MD5(device_id + secret_key + timestamp)。
四、 项目集成实战:以Python后端为例
假设你的项目是一个办公自动化后台(Django/Flask/Spring),需要对接DC-10A。
步骤1:封装设备驱动类
步骤2:逻辑串联:根据人体传感器控制电路
在智能办公场景中,我们经常需要联动:“无人时自动断电”。
业务逻辑:假设会议室安装了有人传感器/红外传感器,当传感器检测到30分钟无人,且当前是工作时间段,则切断投影幕布/灯光电源。
伪代码实现
五、 高级技巧:离线联动与自建服务器
芯步支持自建消息服务器和纯局域网环境,这点对企业来说非常安全。
局域网闭环:将DC-10A的内网IP固定后,你的控制服务器(如树莓派或本地工控机)直接通过内网调用API。不经过外网,延迟小于10ms,且无需申请公网带宽。
弱网保护:设备可设定5组WiFi网络,会自动选择信号最强的连接。这在移动式办公设备(如带轮子的白板、移动会议舱)中很有用,WiFi切换不断线。
六、 常见问题排查
控制无响应
现象:API返回200,但设备不开。
排查:检查DC-10A的负载是否短路。该设备有过载保护,电流超过10A会进入锁定状态,需断电重启。
断电后状态丢失
现象:来电后设备默认是关的。
解决:查阅手册中的
/config接口,可以设置power_on_state参数(ON/OFF/LAST)。设置为LAST,这样停电再来电,投影仪等设备会恢复断电前的状态,防止上班时设备不开机。
远程外网访问
由于我们采用了固定IP局域网方案,如果需要在外网(比如下班路上)关办公室空调,不直接将设备暴露在公网。正确的做法是:搭建一个VPN(虚拟专用网络)或使用零信任方案(如Zerotier),手机连入公司内网后,再调用内网IP控制设备。
七、 方案总结
将DC-10A接入你的项目,本质上是在做 “RESTful API集成” 。你不需要关心复杂的物联网协议,只需要关心:
设备注册:在数据库里存一条记录:
{device_name: "投影仪", device_ip: "192.168.1.100"}。指令下发:前端点按钮 -> 后端调HTTP -> 设备继电器吸合。
场景闭环:利用
duration参数实现自动关,利用轮询/status实现UI同步。
通过这种方式,你的智能办公系统可以以极低的代码量,获得稳定可靠的工业级直流电路控制能力。