芯步24路控制器提供HTTP/MQTT两种接口模式，既支持云端API远程控制，也支持局域网直连——后者对机房场景尤为关键，可在外网中断时保障本地控制链路畅通。以下方案涵盖接口对接流程、代码示例及机房联动策略设计。

解决方案：基于芯步智能24路远程通用控制器的机房设备集成方案

1. 概述

在机房动环监控系统中，执行层的控制往往是最难标准化的环节。芯步的智能24路远程通用控制器（UNI-KZQ-TY-24） 充当了软件系统与物理设备（如照明、风扇、空调、水泵、除湿机等）之间的“机械手”。

本方案的目标是解决如何通过软件接口，将这台24路控制器无缝对接到现有的机房监控软件、运维平台或SCADA系统中，实现对每一路继电器的独立控制、状态读取及逻辑联动。

2. 核心集成架构

该设备支持局域网内网直连和云端API两种模式。针对机房高可用的要求，采用双模冗余架构

• 本地直连（优先） ：软件服务器通过机房局域网，直接调用控制器的本地HTTP接口。即使外网中断，机房本地控制依然不受影响 。

• 云端API（备用/远程） ：当需要通过APP或外部网络进行远程运维时，通过芯步云端接口下发指令 。

3. 接口对接详细步骤

3.1 设备接入准备：获取“现场钥匙”

在开始编码前，需要从设备外壳或配置后台获取以下三个核心信息：

1. 设备IP地址：控制器在机房局域网内被分配的唯一地址（例如 192.168.1.100）。

2. 设备ID (Device ID)：设备的唯一硬件标识，用于云端API寻址 。

3. 指令集（Order Definitions）：确认每一路继电器对应的控制参数。通常情况下，power1代表第1路，power2代表第2路，以此类推，值为 1（开）或 0（关）。

3.2 第一种场景：内网直连模式（推荐）

此模式适用于在机房内部的动环主机上运行的本地服务，无需经过外网，延迟最低。

• 请求地址： http://<设备IP>/control

• 请求方式： POST

• 请求Body (JSON) ：

  { "power1": 1, // 开启第1路（例如:机柜风扇） "power2": 0, // 关闭第2路（例如:照明灯） "power3": 1 // 开启第3路（例如:除湿机） }

• 集成逻辑示例（Python） ：

  import requests import json def control_local_device（ip， channel， action）: """ 机房内网直控函数 :param ip: 控制器的局域网IP :param channel: 路数 （1-24） :param action: 动作 （0或1） """ url = f"http://{ip}/control" payload = {f"power{channel}": action} try: # 超时设置不宜过长，机房内网2秒 response = requests.post（url， data=json.dumps（payload）， timeout=2） if response.status_code == 200: print（f"指令已送达， 第{channel}路执行{action}"） return True except Exception as e: print（"本地控制失败， 检查网络或设备状态"） return False

3.3 第二种场景：跨网段/远程API模式

适用于在外网环境下的运维人员通过手机APP或总部集中管理平台控制设备。

• 请求地址： https://api.thingboot.com/{AppID}/device/control/

• 鉴权机制： 需要动态计算签名（Sign）。规则为：Sign = md5（md5（AppSecret） + Ts）。

• 请求参数

  • device： 设备ID（例如： 1878）

  • order： JSON字符串（例如： {“power1”： 1}）

• 代码片段（Core逻辑） ：

  import hashlib import time import requests def control_cloud_device（app_id， app_secret， device_id， channel， action）: # 1. 生成动态签名 ts = str（int（time.time（））） md5_secret = hashlib.md5（app_secret.encode（））.hexdigest（） sign_str = md5_secret + ts sign = hashlib.md5（sign_str.encode（））.hexdigest（） # 2. 构建请求 url = f"https://api.thingboot.com/{app_id}/device/control/" params = { "sign": sign， "ts": ts， "device": device_id， "order": f‘{{"power{channel}": {action}}}’ # 构造命令 } # 3. 发起请求 resp = requests.get（url， params=params） return resp.json（）

4. 应用场景联动策略

将24路控制器接入软件后，不仅仅是“手动开关”，更重要的是实现“自动化联动”：

• 温湿度联动策略在软件中设定阈值，当机房温度超过28℃时，系统自动调用控制接口，将连接着排风扇的第5路、第6路继电器闭合通电；当温度回落，自动断开 。

• 水浸与紧急切断一旦机房地板下方的水浸传感器告警，软件应立即向控制器的第1路（连接紧急排水泵）发送开启指令，同时向第24路（连接警号喇叭）发送报警指令。

• 定时与巡检任务利用软件的定时引擎（Cron Job），每天凌晨2点自动关闭不必要的“机柜氛围灯”或“大屏展示墙”电源，实现节能。

5. 高级集成技巧和需要注意的点

• 状态反馈的闭环处理纯HTTP控制是“发后即忘”（Fire and Forget）模式。对于关键设备，软件系统中应增加“回读”机制。即发送开启指令5秒后，再去查询设备状态接口，确认继电器确实吸合，若未吸合需触发重试或告警 。

• 私有化部署的安全性芯步设备支持私有化部署。在涉密机房场景，完全断开设备与公网的连接，仅在纯局域网内部通过本地接口通信，确保数据不出园区 。

• 分组控制软件集成时，可以利用分组接口。例如将“所有非核心散热风扇”设为一组。当发生火灾消防告警时，调用分组接口一键切断该组电源，避免火灾蔓延或风助火势 。

6. 总结

通过本方案，开发者只需利用标准的HTTP请求库（无论在C、Java、Python或Node.js环境），即可将芯步的24路控制器抽象为软件中的 “24个可编程的开关对象” 。这使得传统的机房动环系统能够越过复杂的硬件电路改造，以低成本、高效率的方式完成智能化升级，实现“少人或无人值守”的最终目标。