SuperAPI AI 工具集

tia-hmi-operations

编程与开发

查看项目

更新于 10-15 20:30

技能介绍

用途:该技能用于通过 C# Openness 完成 TIA Portal 的 HMI 工程组态,覆盖 Classic WinCC(WinCC.dll,HmiTarget)与 WinCC Unified(WinCCUnified.dll,HmiSoftware)两套对象模型。使用前需先加载 tia-csharp-common,且整个方案保持 C#,不与 Python 包装调用混用。

主要能力:Classic 侧支持 HmiTarget 初始化与编译、画面与画面文件夹管理、画面组成树(弹出画面、滑入画面、模板、全局元素)、画面项属性、报警/配方/报表 API、HMI 变量表与变量管理、VB 脚本、周期、连接、文本列表与图形列表。Unified 侧支持 HmiSoftware 入口与组成映射、变量与报警(报警类别、离散/模拟报警、审计类别)、画面层级与 ScreenBase/ScreenGroup/ScreenWindow、图形与控件(按钮、IO 域、仪表)、复杂部件(DataGrid、AlarmView、TrendArea、ControlBar)、动态化(脚本、变量/表达式、映射表、闪烁条件)、事件处理、UI 特性接口、日志(数据日志、报警日志、审计跟踪)、连接与驱动属性、运行系统设置(报表、遥测、OpcUaServer)、工厂模型与系统服务、枚举列表。

使用方式:按任务只加载相关参考文件,不一次性全部加载。先按调用方给出的精确选择器解析 HMI 设备,零个或多个匹配即失败;再判断 Classic 或 Unified 并分类任务(变量、画面、报警、脚本、日志、导入导出、编译);递归遍历嵌套 DeviceItem.DeviceItems,因为 HMI 软件不一定位于顶层项;支持事务时使用 Openness 事务,修改后编译、检查全部错误、验证后再提交;仅在明确要求持久化时调用 project.Save()。

限制与安全:Classic 与 Unified 是彼此独立的对象模型,不得互相强制转换,也不得依赖设备发现顺序推断模型。创建、导入、覆盖、重命名、重连或删除必须获得对所选对象与操作的明确授权。导入的 XML、JavaScript、VBScript、驱动设置、地址与对象名视为不可信工程输入,应用前需校验路径与目标值。批量或破坏性操作前先盘点依赖的画面、变量、报警、脚本、日志与连接,证据不完整时应失败关闭。Compile() 与 Unified Validate() 结果是门禁而非日志,存在错误时不得提交或保存。官方文档与具体版本兼容性暂未提供。