我想先确认系统运行状态
运行监控- 推荐功能
- 运行监控 · 系统状态
- 为什么
- 主机、模块、服务和实时数据集中在系统状态页，适合作为排查起点。
- 操作方式
- 进入系统状态，先确认模块状态，再检查关键 Tag 是否有实时值。
文档手册
HQControl 手册 | 把画面、设备数据和报警趋势，变成一套能交付的现场系统
HQControl 是现场运行端。它把 HQ VISU Designer 导出的画面、HQ Scan 整理的点位、设备采集、报警趋势、用户权限、授权和第三方接口放在一起，让一台工控机或一台服务器真正变成可交付的 HMI / SCADA 系统。
把画面、设备数据和报警趋势，变成一套能交付的现场系统
HQControl 负责加载导出的画面包，接入 PLC 与 Tag 实时值，管理报警、趋势、用户权限、授权和运行维护，使项目具备可交付的现场运行环境。
这份手册写给第一次接触 HQControl 的实施、运维和现场工程师。先讲它能做什么，再讲安装、接设备、发布画面、报警趋势、权限授权、迁移备份、联邦冗余和排障顺序。
手册概览
- C/S 架构
- Windows / Linux
- 联邦 / 冗余
- 模块化运行平台
- IO / 报警 / 趋势 / 脚本
关键信息
- 采集对象: 西门子 S7 / OPC UA / Modbus
- 运行环境: Windows / Linux
- 对外能力: 实时接口 · 报警趋势 · 多端访问
按目标选择功能
选择当前目标，查看对应页面和处理步骤。
我想把现场的 PLC 和点位接进系统
主数据- 推荐功能
- 主数据 · 设备连接与 Tag 管理
- 为什么
- 画面、报警、趋势、接口都依赖同一份设备和 Tag。
- 操作方式
- 先建设备填协议和地址模式，再建或导入 Tag，最后用 Tag 诊断确认读到值。
我想让某个数值超限就报警、还能回看历史曲线
运行监控- 推荐功能
- 运行监控 · 报警配置与趋势配置
- 为什么
- 报警和趋势都基于已经稳定的 Tag 实时值来配置。
- 操作方式
- 确认 Tag 有值后，开启参与状态，填阈值、采样和归档规则再保存。
我想让现场报警时从指定喇叭播放声音
报警声音- 推荐功能
- 报警与趋势 · 报警声音配置
- 为什么
- 同一套报警可以按区域、PLC、岗位或 Tag 范围播放不同音频，避免所有工位一起响。
- 操作方式
- 先建喇叭输出，再配置声音规则、音频文件、音量、重复间隔和报警范围，最后在目标浏览器验证声音。
我想让用户从菜单点进正确的画面
画面- 推荐功能
- 画面 · 画面文件、菜单与弹窗
- 为什么
- 画面文件决定有什么页面，菜单决定从哪进，弹窗决定点设备看到什么。
- 操作方式
- 先发布画面文件，再在菜单配置里挂入口，需要设备详情就配弹窗模板。
我想给第三方系统提供实时数据，或让系统执行定时任务
接口- 推荐功能
- 接口 · IO State API 与集成脚本
- 为什么
- 第三方读取实时值使用接口，定时任务和跨系统联动使用集成脚本。
- 操作方式
- 给第三方分配独立 Key 并限定可读范围；现场联动用集成脚本配置定时或 HTTP/MQTT。
我想把系统迁移到另一台服务器并保留数据
维护- 推荐功能
- 维护 · 迁移、备份与恢复
- 为什么
- 只复制安装目录或画面文件会丢失数据库和配置内容。
- 操作方式
- 备份数据库、配置和画面资源，在新机器重装恢复，再到授权页重新激活。
使用前说明
HQControl 是现场运行端。它把 HQ VISU Designer 导出的画面、HQ Scan 整理的点位、设备采集、报警趋势、用户权限、授权和第三方接口放在一起，让一台工控机或一台服务器真正变成可交付的 HMI / SCADA 系统。
功能定位
画面设计工具负责制作页面，点位整理工具负责准备数据。HQControl 负责把页面资源和现场数据接入运行环境：让画面可访问、Tag 有实时值、报警可记录、趋势可回看、用户有权限边界、授权可交付。
首次进入系统的关键检查项
先确认系统状态是否正常，再确认设备与 Tag 是否能读到实时值，最后确认画面菜单是否进入正确页面。报警、趋势、权限、脚本和接口应建立在这些基础检查通过之后。
交付不是只把软件装上
正式交付要确认运行健康、设备在线、关键 Tag 有值、报警趋势可用、画面入口正确、普通用户权限正确、授权已激活、脚本和接口有记录。以后现场出问题，也按这个顺序排查。
按这个顺序实际操作
可以把 HQControl 理解成六步：装起来，看状态，接设备，做报警趋势，发布画面，最后收权限、接口、脚本和授权。现场遇到问题，也基本按这个顺序倒着查。第一步：先完成 HQControl 安装
Windows 上运行 HQControlSetup.exe，安装器会自动避开虚拟机光驱盘符，只把固定本地磁盘作为默认安装盘。Linux 上先用 uname -m 确认架构，x86_64 使用 HQControl-linux-x86_64.tar.gz，aarch64 / arm64 使用 HQControl-linux-aarch64.tar.gz。云服务器也使用同一套 Linux 包；如果使用外部 PostgreSQL，要先确认 TimescaleDB 可用。
第二步：登录管理端，先打开系统状态
打开 HQControl 地址，使用管理员账号登录，进入配置中心。先点“System Status / 系统状态”。这里相当于系统体检页：主机、内存、运行时长、模块、服务、联邦拓扑和当前采集节点都在这里看。橙色或告警项先处理。
第三步：建设备，再建或导入 Tag
进入“Devices / 设备连接”新增 PLC 或数据源，填协议、地址模式、Host、Port、Rack、Slot、轮询周期并保存。S7 绝对地址走 102 和 Rack/Slot；S7 符号地址走 OPC UA Endpoint，通常是 4840。然后进入“Tags / Tag 管理”新增或导入点位，绝对地址填 DB/偏移，符号地址填 symbolicAddress，最后用 Tag 诊断确认实时值。
第四步：给稳定的 Tag 配报警、趋势和留存
Tag 能读到值以后，再进入“Alarm Config / 报警配置”和“Trend Config / 趋势配置”。选择点位，开启参与状态，设置阈值、采样、归档规则并保存。然后进入“Data Retention / 数据留存”确认历史数据保留周期。
第五步：发布画面，配置菜单和弹窗
进入“Screen Files / 画面文件”上传或确认页面资产并发布。再进入“Menus / 菜单配置”把页面挂到运行端导航，设置目标、排序、首页和权限。需要设备详情时，进入“Popup Templates / 弹窗模板”配置点击设备后的弹窗内容。
第六步：整理权限、接口、脚本和授权
进入“Access Control / 权限配置”创建角色和用户，管理员账号只给维护人员。再检查“Modules / 模块中心”、“IO State API”、“Integration Script”。正式部署前打开 /settings 检查数据库、Redis、访问端口、授权服务和脚本 Python 路径，再打开 /license 完成在线或离线激活。客户机只需要访问 8080；数据库、缓存、脚本执行都是本机内部服务，不对外开放。