CATALOG

这是一份基于芯步智能直流控制器2路(UNI-KZQ-DC-2)的软件集成解决方案

该方案面向安防系统集成商、弱电项目经理或后台开发人员,旨在解决如何将硬件控制能力平滑嵌入现有软件架构的问题。

1. 背景与概述

在安防项目中,往往需要远程重启摄像机、控制报警灯启停、管理门禁锁电源或触发警示器。传统的做法依赖人工现场拔插电源或复杂的PLC布线,维护成本高且无法满足自动化响应需求。

芯步智能直流控制器2路 是一款支持Wi-Fi 2.4G直连的直流电压控制终端。其核心价值在于开放标准的HTTP API接口,允许任何支持HTTP请求的编程语言(Java, Python, PHP, C#等)对其进行控制,无需私有SDK或网关中转

本方案将详细阐述如何以极低的代码侵入成本,将该硬件的“电路通断控制”能力集成到现有的安防管理软件中,实现电路控制的数字化与自动化。

2. 集成设计

在安防场景中,推荐采用端-云-管的极简架构。无需购置额外的硬件控制器,直接利用现场已有的2.4G WiFi网络。

  • 设备层:智能直流控制器2路,接驳12V/24V直流安防设备(如摄像机电源适配器后端、报警灯、电磁锁)。

  • 传输层:利用设备自有的WiFi模块,直连现场路由器。

  • 软件层:安防管理平台(SaaS/本地化)。

3. 核心集成步骤

将控制器集成到软件项目中,主要分为三个阶段:设备准备、接口鉴权对接、业务逻辑联调。

3.1 硬件初始化与网络配置

在写代码之前,需要先确保设备处于在线状态。

  1. 注册与创建:在芯步官网注册账号,并创建工作台及“物联网控制台”模块。

  2. 设备配网:控制器通电后,通过手机App或“物联网控制台”中的配网模块,将设备加入现场的2.4G WiFi网络。注意:该设备不支持5G WiFi

  3. 获取凭证:在控制台的“开发设置”中获取 AppIDAppSecret;在设备列表中找到这部控制器的唯一标识 Device ID。这三个值是后续接口调用的钥匙

3.2 软件接口对接(HTTP API 集成)

芯步的接口设计遵循无状态原则,任何后端语言均可通过构造标准的HTTP POST请求来完成控制。

3.2.1 鉴权机制(签名计算)

为防止接口被恶意调用,需要对请求进行签名。算法逻辑如下

  1. AppSecret 进行一次 MD5 加密,得到字符串 S1

  2. 获取当前的Unix时间戳(秒级) ts

  3. S1ts 拼接,得到字符串 S2

  4. S2 再次进行 MD5 加密,得到最终的 Sign

公式Sign = md5( md5(AppSecret) + ts )

3.2.2 API 调用示例

请求地址https://api.thingboot.com/{AppId}/device/control/?sign={Sign}&ts={ts}

Method:POST

Content-Type:application/json

请求Body示例

命令集说明

业务场景order值 (JSON字符串)说明
开启线路1{“power1”: 1}控制该控制器的第1路继电器吸合,电路导通
关闭线路1{“power1”: 0}第1路断开
开启线路2{“power2”: 1}控制第2路
关闭线路2{“power2”: 0}第2路断开
批量控制{“power1”:1,“power2”:0}同时设置第1路开,第2路关
总复位{“reset”: 1}先全断,再全通,用于重启网络

3.2.3 代码实现片段

以下为一个通用的后端集成逻辑(伪代码/Python思路):

4. 典型安防场景应用集成

4.1 视频监控“死机”自动恢复

痛点:IPC摄像头偶发死机,需人工爬杆断电。集成方案

  1. 硬件连接:在摄像机电源适配器与电源之间串入控制器。

  2. 软件逻辑:安防平台集成定时心跳检测ONVIF探针

  3. 执行动作:当软件检测到摄像头Ping不通或拉流失败时,自动调用API下发:

    • {“power1”: 0} (断电)

    • sleep(10000) (等待10秒)

    • {“power1”: 1} (重启通电)

  4. 结果:摄像机硬重启,恢复正常,实现无人值守。

4.2 声光报警联动

痛点:报警事件发生时,现场警示不足。集成方案

  1. 硬件连接:将12V声光报警器的正负极接入控制器线路2。

  2. 软件逻辑:在安防平台的报警订阅逻辑中,注入控制代码。

  3. 执行动作:当平台收到“红外入侵”或“门磁开启”信号时,立即调用 {“power2”: 1}。报警结束后调用 {“power2”: 0}

  4. 优势:此方案比有线继电器更灵活,可随时调整报警时长和触发策略。

4.3 多设备混合控制

利用控制器的 batch 或双路独立控制能力,可在一个HTTP包内同时管理两个独立的安防设备。例如:触发报警时,同时关闭摄像机的红外切换(避免反光干扰)并开启补光灯。

5. 安全与运维

  1. 网络稳定性:由于设备使用2.4G WiFi,在强电磁干扰或高密度AP环境下,保证信号强度(RSSI > -50dBm)。支持设定5组WiFi,优先连接信号最强的网络,以保障链路冗余

  2. 接口调用机制处理:在软件项目中,若遇到网络抖动重试请求时,需注意业务逻辑的调用机制。例如:发送“关闭”指令后,若未收到响应,不要立即无脑重发“关闭”,可先查询设备状态再决定

  3. 私有化部署:若安防项目涉及涉密网络(如监狱、军工),该控制器支持私有化部署。可将消息服务器地址指向自建的服务器,数据不经过芯步公有云,满足内网纯局域网运行需求

6. 总结

将芯步智能直流控制器2路集成到安防软件项目中,本质上是调用极简的 HTTP API 完成对物理电路的通断控制。

  • 开发门槛:仅需具备基础的HTTP请求构造能力和MD5加密计算能力。

  • 集成价值:赋予了传统安防软件“物理执行”的能力,解决了远端设备无法重启、无法联动硬件的最后一公里难题。

通过上述步骤,开发人员可在 30分钟内 完成从接口调试到业务逻辑联调的全过程,并快速在Web端或手机端实现对直流安防设备的电路控制。