Mingcedar 手册 | Mingcedar 工业 HMI / SCADA 运行平台

<div class="manual-doc-article"><h1 id="mingcedar-工业-hmi--scada-运行平台">Mingcedar 工业 HMI / SCADA 运行平台</h1>

<p>按任务查找安装、设备接入和运行维护步骤。</p>

<blockquote>

<p>Mingcedar 使用手册：页面操作、设备与 Tag、画面、报警趋势、站点、Python、SDK、权限与维护。</p>

</blockquote>

<h2 id="手册概览">手册概览</h2>

<ul>

<li>HMI / SCADA</li>

<li>Web/App · IO · Alarm · Trend · Script</li>

<li>页面操作与配置指南</li>

</ul>

<h2 id="关键信息">关键信息</h2>

<ul>

<li><strong>运行服务:</strong> Web/App · IO · Alarm · Trend · Script</li>

<li><strong>数据与扩展:</strong> Tag · Python · IO State API</li>

<li><strong>使用范围:</strong> 运行 · 配置 · 开发 · 维护</li>

</ul>

<h2 id="按目标选择功能">按目标选择功能</h2>

<p>选择任务，查看操作步骤。</p>

<div class="doc-goal-grid">

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M12 5a7 7 0 1 0 7 7h-3a4 4 0 1 1-4-4V5Z"></path><path d="M12 2v10h10"></path></svg></span>

<h3>接入设备并管理 Tag</h3>

<span class="doc-goal-cat">操作教程</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>设备接入与 Tag 管理</dd></div>

<div><dt>为什么</dt><dd>按“选择协议 → 连接设置 → 验证并创建”接入设备，再检查配置应用、连接和采集。</dd></div>

<div><dt>操作方式</dt><dd>入口：配置中心 → 设备管理。查看需 io:view，编辑需 io:manage。准备现场协议、地址和点表。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M4 7h16v10H4z"></path><path d="M8 7V4h8v3M8 20h8"></path></svg></span>

<h3>核对实时值并诊断写入</h3>

<span class="doc-goal-cat">操作教程</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>Tag 测试：监控、质量与受控写入</dd></div>

<div><dt>为什么</dt><dd>将点位加入监控，核对已采集值、质量、时间和写入结果。</dd></div>

<div><dt>操作方式</dt><dd>操作位置：配置中心 → Tag 测试（需 io:diagnose 权限）。左侧选择设备，中间浏览 Tag，右侧监控当前值或发起写入。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M5 18V7l7-4 7 4v11l-7 4-7-4Z"></path><path d="M9 12h6M12 9v6"></path></svg></span>

<h3>发布画面并配置运行入口</h3>

<span class="doc-goal-cat">操作教程</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>画面文件、运行菜单与弹窗模板</dd></div>

<div><dt>为什么</dt><dd>上传 HTML 与资源，配置菜单和弹窗模板，再检查运行数据与访问。</dd></div>

<div><dt>操作方式</dt><dd>操作位置：配置中心 → 画面文件。查看需要 screen:view，上传与恢复需要 screen:manage。准备完整的 Mingcedar Studio 导出目录或自写 HTML 与资源文件；相对引用要保持原目录结构。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M4 17h16"></path><path d="m6 14 4-4 3 3 5-7"></path></svg></span>

<h3>连接站点并选择能力</h3>

<span class="doc-goal-cat">操作教程</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>站点与四项共享能力</dd></div>

<div><dt>为什么</dt><dd>连接其他 Mingcedar，选择画面、IO、报警与趋势来源，配置设备范围。</dd></div>

<div><dt>操作方式</dt><dd>入口：配置中心 → 站点。每个站点包含运行服务、设备、Tag 和业务配置，可加入其他站点使用其能力。以下操作均在 A 完成，以读取 B 的数据。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M4 5h16v12H4z"></path><path d="M9 21h6M12 17v4"></path></svg></span>

<h3>开发自定义运行页面</h3>

<span class="doc-goal-cat">操作教程</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>页面 SDK：快速上手</dd></div>

<div><dt>为什么</dt><dd>使用页面 SDK 读取 Tag、写入设定值并查询报警和趋势。示例适用于原生 HTML 和 Vue；发布前须替换项目点位并核对权限。</dd></div>

<div><dt>操作方式</dt><dd>将 HTML 上传到“画面文件”并从运行菜单打开，Runtime 会自动加载 SDK，无需安装 npm 包或添加 script。调用一次 ready()，后续复用返回的 api。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M8 12h8M12 8v8"></path><path d="M4 12a4 4 0 0 1 4-4h1M20 12a4 4 0 0 1-4 4h-1"></path></svg></span>

<h3>运行 Python 并安装依赖</h3>

<span class="doc-goal-cat">操作教程</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>Python 项目与模块</dd></div>

<div><dt>为什么</dt><dd>使用 CPython 3.13 创建项目、复用函数、安装依赖、读取 Tag、配置事件及受控写入。</dd></div>

<div><dt>操作方式</dt><dd>先确认 Script 服务可用。代码管理需超级管理员及 integration:manage；Run Test 另需 integration:execute；Python 模块管理另需 system:view 和 system:manage。按顺序完成计算、依赖安装、事件调用与 Tag 读写练习。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M6 5h12v14H6z"></path><path d="M9 9h6M9 13h4"></path><path d="m15 17 3 3 3-3"></path></svg></span>

<h3>对接外部只读客户端</h3>

<span class="doc-goal-cat">操作教程</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>IO State API：授权、精确读取与实时订阅</dd></div>

<div><dt>为什么</dt><dd>创建 Profile 和 Access Key，读取 SignalRef，获取单次 Ticket 并订阅 WebSocket。</dd></div>

<div><dt>操作方式</dt><dd>准备启用 IO State 的 HTTPS 地址、质量正常的点位及具备 io:manage 的账号。外部客户端仅读取已采集状态；API 不连接 PLC，也不提供写入、报警或历史趋势。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M12 5a7 7 0 1 0 7 7h-3a4 4 0 1 1-4-4V5Z"></path><path d="M12 2v10h10"></path></svg></span>

<h3>保存配置并确认应用</h3>

<span class="doc-goal-cat">操作教程</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>设备与 Tag 配置：保存、应用与运行核对</dd></div>

<div><dt>为什么</dt><dd>设备和 Tag 保存后自动开始应用。依次核对保存、应用、设备连接和 Tag 数据。</dd></div>

<div><dt>操作方式</dt><dd>操作位置：配置中心 → 设备管理或 Tag 管理。仅编辑当前本地站点中需要变更的设备或 Tag。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M4 7h16v10H4z"></path><path d="M8 7V4h8v3M8 20h8"></path></svg></span>

<h3>查询和导出事件记录</h3>

<span class="doc-goal-cat">操作教程</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>事件记录：查询、追踪与导出</dd></div>

<div><dt>为什么</dt><dd>按时间、人员、对象和结果追踪操作；事件记录、报警历史和趋势分别查询。</dd></div>

<div><dt>操作方式</dt><dd>操作位置：配置中心 → 事件记录（需 event:view 权限）。默认范围“用户操作”、时间近 30 天；搜索、处理结果和记录范围在已加载记录中筛选。</dd></div>

</dl>

</article>

<article class="doc-goal-card">

<span class="doc-goal-icon"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M5 18V7l7-4 7 4v11l-7 4-7-4Z"></path><path d="M9 12h6M12 9v6"></path></svg></span>

<h3>配置归档和数据留存</h3>

<span class="doc-goal-cat">操作教程</span>

<dl class="doc-goal-lines">

<div><dt>推荐功能</dt><dd>数据留存：保留周期与执行核查</dd></div>

<div><dt>为什么</dt><dd>按项目要求设置事件、报警、原始趋势和汇总趋势的保留期限，再核对后台执行结果。</dd></div>

<div><dt>操作方式</dt><dd>操作位置：配置中心 → 数据留存（需 retention:manage 权限）。</dd></div>

</dl>

</article>

</div>

<h2 id="使用前说明">使用前说明</h2>

<p>首次使用从“首次配置”开始；已有部署按目录查找任务。</p>

<div class="doc-card-list">

<article class="doc-card">

<h3 id="preface-item-1">运行服务</h3>

<p>Web/App 提供浏览器入口；IO 采集设备数据；Alarm、Trend、Script 处理报警、历史和项目逻辑。在系统状态页查看服务及数据基础设施。</p>

</article>

<article class="doc-card">

<h3 id="preface-item-2">配置中心</h3>

<p>配置设备、Tag、计算 Tag、画面文件、菜单、弹窗、站点、权限、语言与集成。入口显示取决于账号权限与已安装模块。</p>

</article>

<article class="doc-card doc-card-warn">

<h3 id="preface-item-3">运行页面</h3>

<p>从前台菜单打开工程画面、报警和趋势。查看数据、确认报警与设备写入分别遵循各自的访问和操作权限。</p>

</article>

<article class="doc-card doc-card-tip">

<h3 id="preface-item-4">Settings</h3>

<p>管理显示与操作、设备采集、Python、站点互联和视频服务。界面偏好、报警分类与采集策略独立保存，其余参数按字段提示生效。</p>

</article>

</div>

<h2 id="tutorial">首次配置流程</h2>

先确认服务与授权，再接入数据、发布画面并配置访问。

<div class="doc-card-list">

<article class="doc-card">

<h3>1. 确认入口与服务</h3>

<p>用管理账号打开配置中心 → 系统状态，检查站点、版本、五项服务、数据库与 Redis，并查看授权页。顶部菜单选择语言，权限配置管理用户与角色。</p>

</article>

<article class="doc-card">

<h3>2. 创建设备和 Tag</h3>

<p>在本机站点按协议创建设备，检查配置应用与连接。添加 Tag 的编码、地址和类型；完整编码为设备编码.Tag编码。在 Tag 诊断确认值、质量和时间，再配置报警、趋势、计算或脚本。</p>

</article>

<article class="doc-card">

<h3>3. 发布画面并配置访问</h3>

<p>上传并发布完整画面目录，保留相对路径。配置菜单名称、入口、排序、登录要求和所需弹窗。用操作员账号检查画面、数据与操作；需要远端能力时，在站点页连接并选择范围。</p>

</article>

</div></div>