CATALOG

DC-10A是芯步推出的一款支持HTTP接口的智能通断器,无需网关、可直接接入各类软件项目。下面从硬件连接、接口协议到代码实现,梳理完整的接入方案。

一、 DC-10A 智能通断器选型分析

在智能办公场景中,往往需要控制会议室投影机电源、工位插座、新风系统或者饮水机等设备。传统的改装不仅需要动强电线路,还需要复杂的PLC编程。

DC-10A 的核心优势:

  1. 逻辑与强电隔离:控制端是弱电信号或HTTP请求,被控端是DC直流强电(最高10A),保障了调试人员的安全。

  2. API优先:该设备原生支持HTTP接口调用,意味着你不需要购买额外的网关硬件,直接用代码控制

  3. 断网运行:支持私有化部署和局域网直接通信,即使办公室外网断了,内部系统依然可以控制设备

适用场景:控制12V-24V的直流供电设备(如LED灯带、直流风扇、监控电源、部分工业传感器)。

二、 硬件接入与网络配网

在写代码之前,需要让设备“上网”。DC-10A 支持WiFi 2.4G直连

第一步:接线

  • 输入端:接入DC电源正负极(12V-24V,注意电流不超过10A)。

  • 输出端:接入被控设备(例如把灯带的正极线断开,两头分别接入模块的“输出”端)。

  • 控制端:模块内部已集成控制电路,无需额外接线。

第二步:配网由于设备没有屏幕,通常采用 SoftAP(热点配网)SmartConfig(一键配网) 模式。

  1. 设备通电后,会发出一个以 TB-xxx 命名的热点。

  2. 手机/电脑连接该热点,浏览器访问 192.168.4.1

  3. 在弹出的页面中,扫描并输入办公室的WiFi密码。

  4. (关键步骤)固定IP:在办公室路由器后台,将该设备的MAC地址绑定一个固定内网IP(例如 192.168.1.100)。这对接下来的API调用至关重要。

三、 接口协议深度解析

根据产品手册,设备开放HTTP接口,支持任何支持HTTP请求的编程语言接入

1. 接口基础信息

  • 协议:HTTP (支持POST/GET)

  • 数据格式:JSON

  • 寻址方式:通过设备ID局域网IP 进行寻址。

2. 核心API列表

① 查询设备状态 (Get Status)

  • 目的:在改变状态前,确认设备当前是开还是关,或者是否在线。

  • Method: GET

  • URL: http://[DEVICE_IP]/status

  • Response Example:

② 控制开关 (Control)

  • 目的:执行通断操作。

  • Method: POST

  • URL: http://[DEVICE_IP]/control

  • Header: Content-Type: application/json

  • Body:

  • 特殊参数 duration:用于办公节能场景非常实用。例如开启会议室排风扇,设定1小时后自动关闭,防止忘记关导致浪费。

③ 自定义API签名验证模式如果是远程控制(非局域网),或者为了安全性,设备支持签名验证。需要在请求头中携带signtimestamp签名算法通常是:MD5(device_id + secret_key + timestamp)

四、 项目集成实战:以Python后端为例

假设你的项目是一个办公自动化后台(Django/Flask/Spring),需要对接DC-10A。

步骤1:封装设备驱动类

步骤2:逻辑串联:根据人体传感器控制电路

在智能办公场景中,我们经常需要联动:“无人时自动断电”

业务逻辑:假设会议室安装了有人传感器/红外传感器,当传感器检测到30分钟无人,且当前是工作时间段,则切断投影幕布/灯光电源。

伪代码实现

五、 高级技巧:离线联动与自建服务器

芯步支持自建消息服务器纯局域网环境,这点对企业来说非常安全

  1. 局域网闭环:将DC-10A的内网IP固定后,你的控制服务器(如树莓派或本地工控机)直接通过内网调用API。不经过外网,延迟小于10ms,且无需申请公网带宽。

  2. 弱网保护:设备可设定5组WiFi网络,会自动选择信号最强的连接。这在移动式办公设备(如带轮子的白板、移动会议舱)中很有用,WiFi切换不断线。

六、 常见问题排查

  1. 控制无响应

    • 现象:API返回200,但设备不开。

    • 排查:检查DC-10A的负载是否短路。该设备有过载保护,电流超过10A会进入锁定状态,需断电重启。

  2. 断电后状态丢失

    • 现象:来电后设备默认是关的。

    • 解决:查阅手册中的/config接口,可以设置power_on_state参数(ON/OFF/LAST)。设置为LAST,这样停电再来电,投影仪等设备会恢复断电前的状态,防止上班时设备不开机。

  3. 远程外网访问

    • 由于我们采用了固定IP局域网方案,如果需要在外网(比如下班路上)关办公室空调,直接将设备暴露在公网。正确的做法是:搭建一个VPN(虚拟专用网络)或使用零信任方案(如Zerotier),手机连入公司内网后,再调用内网IP控制设备。

七、 方案总结

将DC-10A接入你的项目,本质上是在做 “RESTful API集成” 。你不需要关心复杂的物联网协议,只需要关心:

  1. 设备注册:在数据库里存一条记录:{device_name: "投影仪", device_ip: "192.168.1.100"}

  2. 指令下发:前端点按钮 -> 后端调HTTP -> 设备继电器吸合。

  3. 场景闭环:利用duration参数实现自动关,利用轮询/status实现UI同步。

通过这种方式,你的智能办公系统可以以极低的代码量,获得稳定可靠的工业级直流电路控制能力。