西门子HMI函数集

函数概要ActivateCleanScreen在HMI设备上激活洁屏画面。ActivatePreviousScreen将画面切换到在当前画面之前激活的画面。ActivateScreen将画面切换到指定的画面。ActivateScreenByNumber根据变量值将画面切换到另一画面。AlarmViewEditAlarm对给定报警画面内选择的全部报警，触发“编辑”事件。AlarmViewAcknowledgeAlarm确认在给定报警视图中选择的报警。AlarmViewShowOperatorNotes在给定报警画面中显示为所选报警组态的操作员注释。AcknowledgeAlarm确认选择的所有报警。CalibrateTouchScreen调用用于校准触摸屏幕的程序。ClearAlarmBuffer删除HMI设备报警缓冲区中的报警。ClearAlarmBufferProtoolLegacy该系统函数用来确保兼容性。CloseAllLogs断开WinCCflexibleSMART与所有日志之间的连接。断开与正在使用的PLC的连接，然后建立一个与给定PLC的新连接。ChangeConnection删除给定日志中的所有数据记录。ClearLogGetUserName在给定的变量中写入当前登录到HMI设备的用户的用户名。GetGroupNumber读取登录到HMI设备的用户所属组的编号，并将其写入给定的变量。GetPassword在给定的变量中写入当前登录到HMI设备的用户的口令。GoToHome在HMI设备上执行Home键功能GoToEnd在HMI设备上执行End键功能从变量值中减去给定的值。X=X-aDecreaseValue将配方的一条或全部数据记录导出到CSV文件中。为每个配方创建一个文件。ExportDataRecords从CSV文件中导入配方的一条或全部数据记录。ImportDataRecordsInvertBit对给定的“Bool”型变量的值取反。Logoff在HMI设备上注销当前用户LogTag将给定变量的值保存在给定的数据日志中。OpenAllLogs重新建立WinCCflexibleSMART和日志之间的连接，从而可继续记录。PageDown在HMI设备上执行Pagedown键功能PageUp在HMI设备上执行Pageup键功能。ResetBit将“Bool”型变量的值设置为0（假）。SetDeviceMode切换HMI设备上的运行模式。SetBit将“Bool”型变量的值设置为1（真）。从CSV文件中导入配方的一条或全部数据记录。ImportDataRecords将给定值添加到变量值上。X=X+aIncreaseValue使用线性函数X=(Y-b)/a，将通过给定变量Y的值计算得出的数值赋给变量X。InverseLinearScaling为变量Y赋值，该变量通过线性函数Y=(a*X)+b利用给定变量X的值计算得出。LinearScaling在HMI设备上登录当前用户Logon检查是否具有对外部存储介质的读写访问权。SafelyRemoveHardwareSetLanguage切换HMI设备上的语言。ScreenObjectCursorDown在给定的画面对象中执行Down键功能。ScreenObjectCursorUp在给定的画面对象中执行Up键功能。SetBitWhileKeyPressed只要用户按下已组态的键，给定变量中的位即设置为1(真)。连接或断开给定的连接。SetConnectionMode将新值赋给给定的变量。SetValue仿真变量和动态对象（如文本列表）的特性，而无需将HMI设备与PLC相连。SimulateTagScreenObjectPageDown在给定的画面对象中执行Down键功能。ScreenObjectPageUp在给定的画面对象中执行Up键功能。ShowOperatorNotes显示所选对象已组态的信息文本。此系统函数将源变量的输入位组合格式转换成目标变量的输出位组合格式。ShiftAndMaskShowLogonDialog在HMI设备上打开用户可用于登录到HMI设备的对话框。StopRuntime退出运行系统软件，从而退出运行在HMI设备上的项目。TraceUserChange输出显示当前哪个用户正登录到HMI设备的系统事件。TrendViewScrollForward在趋势视图中向右滚动一个显示宽度。TrendViewScrollBack在趋势视图中向左回滚一个显示宽度。TrendViewExtend减少在趋势视图中显示的时间段。TrendViewCompress增加在趋势视图中显示的时间段。TrendViewRulerForward在趋势视图中向前(右)移动标尺。TrendViewRulerBackward在趋势视图中向后(左)移动标尺。TrendViewSetRulerMode在趋势视图中隐藏或显示标尺。标尺显示与X值相关联的Y值。TrendViewStartStop停止或继续趋势视图中的趋势记录。TrendViewBackToBeginning在趋势视图中向后翻页到趋势记录的开始处。趋势记录的起始值将显示在此处。UpdateTag从PLC读取带有指定更新标识符的变量的当前值。.StopLogging停止在指定日志中记录过程值或报警。隐藏或显示HMI设备上的报警窗口。ShowAlarmWindowStartLogging启动在指定日志中记录数据或报警。功能参数在指定的时间内禁用HMI设备的显示屏。当取消激活HMI设备的显示屏时，可对其进行清洁，而不会因无意间触发了触摸函数而受到影响。Timeperiod如果先前没有激活任何画面，则画面切换不执行。最近调用的10个画面被保存。当切换到不再保存的画面时，会输出一条系统消息。/使用“ActivateScreenByNumber”系统函数可以从根画面切换到永久性窗口，反之亦然。画面名称画面由其画面号标识。画面号当不能使用ActiveX控件的集成按钮时，使用该系统函数。可以在“编辑”事件上依次组态系统函数。例如，可以切换到出现报警的过程画面。如果要编辑的报警尚未被确认，则在调用该系统函数时自动确认。画面对象当不能使用ActiveX控件的集成按钮时，使用该系统函数。画面对象/画面对象该系统函数用于HMI设备没有ACK键时或报警屏幕的集成键不能使用时。/在校准过程中，将会提示触摸屏幕显示上的五个位置。在30秒内触摸屏幕显示以确认校准过程。如果在该时间间隔内没有完成校准，校准设置被放弃。用户提示为英语。首次启动操作员设备时使用该系统函数。/Connection地址插槽机架尚未确认的报警也被删除。Alarmclassnumber它具有与系统函数“ClearAlarmBuffer”相同的功能，但使用旧的ProTool编号方式。Alarmclassnumber日志类型日志在关闭日志前，必须首先在日志中停止记录功能。使用系统函数“StopLogging”即可停止。/ChangeConnection”函数用于将HMI设备与不同地址的PLC互连。请避免更改为已被其它HMI设备使用的地址。支持以下地址类型：MPI地址PROFIBUS地址/变量Value配方编号/名称数据记录编号/名称文件名覆盖输出状态消息处理状态如果给出的变量具有控制连接，则用户名在PLC上也可用。该系统函数将使诸如执行某些功能与用户有关的版本成为可能。TagTag确保给定变量的值未显示在项目中的其它位置。无法读取用户SIMATICLogon的密码。Tag当HMI设备在缺省情况下不具有该功能时使用此系统函数。/当HMI设备在缺省情况下不具有该功能时使用此系统函数。/文件名数据记录编号/名称覆盖系统函数使用同一变量作为输入和输出值。当该系统函数用于转换数值时，必须使用帮助变量。可使用系统函数“SetValue”将变量值分配给帮助变量。如果在报警事件中组态了函数但变量未在当前画面中使用，则无法确保在PLC中使用实际的变量值。通过设置“连续循环”采集模式可以改善这种情况。ExportDataRecords(配方编号/名称,数据记录编号/名称,文件名,覆盖,输出状态消息,处理状态)。在脚本中是否可用：是(ExportDataRecords)ImportDataRecords(文件名,数据记录编号/名称,覆盖,输出状态消息,处理状态)输出状态消息处理状态变量值XYba如果变量具有值1（真），它将被设置为0（假）。变量XYab/密码Username该系统函数用于归档特定时刻的过程值。变量运行系统函数“StartLogging”以重新开始记录。//////变量路径结果可以有下列操作类型：“在线”、“离线”和“传送”Operatingmode变量ImportDataRecords(文件名,数据记录编号/名称,覆盖,输出状态消息,处理状态)系统函数使用同一变量作为输入和输出值。当该系统函数用于转换数值时，必须使用帮助变量。可使用系统函数“SetValue”将变量值分配给帮助变量。如果在报警事件中组态了函数但变量未在当前画面中使用，则无法确保在PLC中使用实际的变量值。通过设置“连续循环”采集模式可以改善这种情况。变量X和Y不能相同。与此函数相反的系统函数是“LinearScaling”。变量X和Y不能相同。如果要将变量转换为其自身，必须使用一个帮助变量。可用系统函数“SetValue”将要转换变量的值分配给帮助变量。与此函数相反的系统函数是“InverseLinearScaling”。/如果没有，则可以断开外部存储介质，而不会丢失数据。TagBit所有组态的文本和系统事件以新设置的语言显示在HMI设备上。LanguageModeConnection变量ValueTag周期最大值最小值Value当不能使用画面对象的集成按钮时使用该系统函数。系统函数可用于以下画面对象：用户视图报警视图配方视图画面对象在给定的画面对象中执行Up键功能。当不能使用画面对象的集成按钮时使用该系统函数。系统函数可用于以下画面对象：用户视图报警视图配方视图画面对象在改变了给定位之后，系统函数将整个变量传送回PLC，但是并不检查变量中的其它位是否同时改变。在变量被传送回PLC之前，操作员和PLC可能除读取该变量外，不能进行其它操作。仅应使用该函数访问BOOL类型的变量，以避免发生同时访问相同变量的问题。即使该键保持按下状态，与事件“释放”有关的所有函数均将通过为某个键所组态的画面变化来立即执行。如果PLC支持BOOL型变量，不要使用该系统函数。而使用系统函数“SetBit”。只有在HMI设备上设置了“在线”运行模式后，才能建立至PLC的连接。可以使用系统函数“SetDeviceMode”实现此操作。/只有数据类型为整型的变量可用于仿真。当不能使用画面对象的集成按钮时使用该系统函数。系统函数可用于以下画面对象：用户视图报警视图配方视图画面对象在给定的画面对象中执行Up键功能。当不能使用画面对象的集成按钮时使用该系统函数。系统函数可用于以下画面对象：用户视图报警视图配方视图画面对象SourcetagBitstoshiftBitstomaskTargettag（输出）如果功能键上组态了该函数，则将显示当前具有焦点的画面对象的帮助文本。如果操作员注意事项是为画面本身组态的，那么可以通过按下Enter或双击帮助窗口切换到该文本。Displaymode如果按钮上组态了该函数，则只显示当前画面的帮助文本。如果在按钮自身上组态了帮助文本，则最初只显示此按钮的帮助文本。按下Enter或Displaymode这包括移动位和掩码位。///Objectname/Displaymode日志类型日志日志类型日志/Mode//Screenobject/Screenobject/Screenobject/画面对象为了能够移动标尺，必须将标尺打开。可以使用系统函数“TrendViewSetRulerMode