返回上一页 工业可视化运行平台 运行 Windows / Linux 实时 Tag + WebSocket 交付 授权 + 覆盖升级
HQControl
HQControl 是现场运行平台，负责加载画面包、连接设备与 Tag，并统一管理菜单、权限、报警、趋势、脚本、接口、授权和运维。项目需要报表、看板或诊断页时，可通过自写页 SDK 在受控范围内扩展。
它承接 Designer 导出的画面资源，让页面进入现场运行；数据、权限、报警、趋势和运维记录由平台统一管理。高可用、接口和脚本能力按项目交付范围继续配置。
现场运行设备与 Tag报警 / 趋势自写页 SDK
画面包需要接入 Tag、权限、报警、报警声音、趋势、自写页和脚本并正式运行时使用。
统一承载模块、设备数据、用户授权、监控、联邦和冗余。
画面源文件制作与原始画面包导出由 PowerPoint 插件完成。
使用路径
产品使用路径
先确认当前产品在交付链路中的位置，再进入安装、配置、扩展和验收细节。
安装运行平台，确认服务和基础配置正常。
接入画面、Tag、菜单、权限、报警、报警声音和趋势。
配置菜单、权限、报警、报警声音、趋势、脚本、接口和运行监控。
需要专用报表或看板时再使用自写页 SDK，同时持续管理授权、联邦、冗余和维护状态。
定位
软件定位
HQControl 是工业运行系统的服务端与运行平台，用于承接项目上线后的画面资源、Tag 主数据、菜单、多语言、权限、接口和运维管理。
画面资源、IO、报警、报警声音、趋势、事件和脚本模块在平台内统一运行。
权限、授权、模块状态、脚本入口、实时接口和自写页扩展由平台统一管理。
安装部署、运行维护、授权管理、站点联邦、冗余切换和跨平台交付在同一体系内完成。
能力
运行平台能力
HQControl 先承担现场运行、数据治理和交付运维；自写页 SDK 在这个基础上为项目专用页面提供受控数据接口。
集中管理运行画面、IO 采集、报警、报警声音、趋势、事件记录、脚本、联邦和冗余模块。
内置 Siemens S7、OPC UA、Modbus TCP 和内部变量接入；采集结果统一汇总为实时数据，再供画面、报警、报警声音、趋势、接口和脚本使用。
提供配置中心、权限管理、授权管理和模块状态管理，便于现场维护和统一治理。
脚本、IO、报警、报警声音、趋势、接口和第三方接入按模块扩展，降低项目后续维护成本。
支持服务器侧 Python 脚本，提供 ReadTag、ReadTags、WriteTag 访问 HQControl IO；正式包内置 requests、数据库、MQTT 等常用包，也可按项目安装、更新第三方 Python 包或引入本地包目录完成自动化。
第三方系统通过 IO State API 的 HTTP GET 和 WebSocket 订阅读取已采集 IO；MQTT 对接由 Integration Script 承担。
自写 HTML 页面在沙箱 iframe 中运行，通过 HQVISU_CUSTOM_PAGE.ready() 获取受控 API；页面可在声明范围内读取、订阅、写入 Tag，并查询历史数据和报警数据。
SDK 提供数据桥、语言接口和 renderTable / bindJsonTable 表格辅助；项目可自行实现班次报表、能耗看板、设备诊断或客户专用页面，不作为平台内置报表模块固化。
覆盖安装部署、授权激活、运行监控、站点联邦、冗余接管和后续维护。
界面示例
PC 管理端、现场弹窗、趋势与自写页扩展
HQControl 首先承担运行配置、系统状态、现场操作和趋势复核；自写页用于项目需要专用报表、看板或诊断页时的受控扩展。
自写页 SDK
自写页 SDK：项目报表与专用页面扩展
SDK 面向部署在 HQControl 运行端的自写 HTML 页面。它提供受控数据 API 和页面辅助能力，页面形态由项目自行实现，可用于报表、看板、诊断或客户专用视图。
示例图展示自写页如何组合实时 Tag、历史趋势、报警摘要和表格数据。它用于说明 SDK 能承接的页面形态，不代表平台内置固定报表模块。
自写页在 sandbox iframe 中运行，不直接继承主应用登录环境，只通过宿主桥访问授权能力。
页面通过 JSON 配置声明 readableTags 和 writableTags；宿主机据此签发页面能力凭证。
SDK 提供实时值、订阅、写入、历史、报警、语言和表格辅助能力，项目页面可组织为专用报表或看板。
Workflow
从 HTML 页面到运行端
先声明范围，再等待 SDK ready，随后按业务页面读取数据、订阅变化、查询历史或报警。
在 HTML 中写入 hqvisu-custom-page JSON 配置，列出可读和可写 Tag。
调用 HQVISU_CUSTOM_PAGE.ready() 获取 SDK API，避免在宿主未就绪前访问数据。
使用 read、subscribe、history.query 和 alarms.* 组织页面所需的数据。
项目页面自行绘制报表、看板或诊断视图，必要时使用 renderTable 辅助表格展示。
声明页面可访问点位
宿主机只会把声明范围内的点位能力交给自写页。
<script type="application/json" id="hqvisu-custom-page">
{
"readableTags": ["Line1.Temperature", "Line1.RunState"],
"writableTags": ["Line1.Setpoint"]
}
</script>组合实时、历史和报警
报表页或看板页的 UI 由项目自行实现，数据从 SDK 受控接口取得。
const api = await HQVISU_CUSTOM_PAGE.ready();
const temp = api.readNumber("Line1.Temperature", 0);
const trend = await api.history.query({
tags: ["Line1.Temperature"],
start,
end,
interval: "1h",
aggregate: "avg"
});
const alarms = await api.alarms.getActive();
api.renderTable("#alarm-table", alarms.items || []);读取班次时间范围内的历史趋势和关键 Tag，按项目格式生成产量、能耗、质量摘要。
把实时值、报警摘要、质量状态和外部业务信息组织成客户现场需要的专用页面。
围绕单台设备聚合状态位、报警、趋势和维护提示，减少操作员跨页面查找。
支持
支持平台与交付形态
HQControl 面向正式项目交付，支持本地、边缘节点和服务器部署场景。
核心架构
HQControl 基于 C/S 架构，统一承接脚本、IO、报警、报警声音、趋势、联邦、冗余和治理能力。
支持平台
支持 Windows 和 Linux 部署，项目交付时可按现场架构选择本机、边缘节点或服务器运行。
授权与更新维护
HQControl 采用平台统一授权，授权支持更新包、平台内功能和后续扩展能力，功能模块不拆成单独收费项；HQ VISU Designer 与 HQControl 是两套独立授权，应按实际使用产品分别确认。
支持的设备连接
当前内置 Siemens S7 绝对地址、S7 符号地址 / OPC UA、独立 OPC UA、Modbus TCP 和内部变量。S7 绝对地址通常走 102 + Rack/Slot；符号地址和 OPC UA 通常走 opc.tcp://...:4840；Modbus TCP 默认 502。
支持的脚本能力
系统脚本使用服务器侧 Python。Integration Script 提供 ReadTag、ReadTags、WriteTag；正式包内置 requests、psycopg、pymysql、pyodbc、paho-mqtt、websocket-client、cryptography 等常用包，也可按项目安装第三方 Python 包或放置本地 Python 包目录。
系统集成
第三方系统读取实时值走 IO State API；需要推送 MQTT、访问 MES / ERP / 数据库、定时任务或事件联动时，放到 Integration Script 中实现。
自写页 SDK 边界
自写页需要在 HTML 配置中声明 readableTags 和 writableTags；历史查询、报警查询和实时订阅均按页面可读点位范围限制，写入还需具备页面声明与用户权限。
高可用能力
平台支持联邦与冗余，适合把多站点协同、节点切换和正式运行稳定性一起纳入交付范围。
典型场景
适用场景
当 PPT 画面包需要进入现场运行，并与设备数据、报警、报警声音、趋势、自写页、权限管理和正式交付结合时，HQControl 承担运行平台职责。
从画面包进入现场运行
将 HQ VISU Designer 导出的画面资源、设备数据和 Tag 主数据接入平台，形成可部署、可维护的运行系统。
现场部署与长期维护
用于客户现场安装、模块配置、站点联邦、冗余接管、授权管理和后续运维。
项目专用运行页面
当现场需要班次报表、能耗汇总、设备诊断或客户专用看板时，可用自写页 SDK 在授权数据范围内实现。
下一步
继续了解
继续查看运行入口、配置方式、正式交付、演示和下载页。