符号配置编辑器

概述

符号配置功能让您能够配置对变量的外部访问。符号和变量然后可以在 Web 服务器中监视，并由外部应用程序（如 Vijeo-Designer 或 OPC 服务器）访问。

要为应用程序配置符号，可双击工具树内的符号配置节点。符号配置编辑器视图打开。

编辑器包含表格。根据设置的过滤器，它会显示可用的变量或者仅显示已经为符号配置选择的变量。为此，将相关的包含 POU 定义或库的弹出信息列于符号列中。您可将它们扩展以显示相应的变量。

注意：可配置的变量数不受限制。

相关限制取决于不同的监控平台：

Platform	上限
Web 服务器	16000 字节
OPC-UA	10000 个变量
HMI	取决于每个型号的 RAM

工具栏的元素

元素	描述
查看按钮	查看按钮让您可以设置以下过滤条件，从而减少所显示的变量数量：
	未在项目中配置	甚至会显示尚未添加至符号配置但是可用于项目中该用途的变量。
	未在库中配置	同样也会显示库中尚未添加至符号配置但是可用于项目中该用途的变量。
	通过属性导出的符号	此设置仅在显示未配置的变量时有效（请参见上述两个过滤条件）。它还能列出已经选择以便其声明中的 {attribute 'symbol' := 'read'} 获得符号的那些变量。这类符号会显示为灰色。属性列显示 pragma 为变量设置了哪种访问权限。请参阅以下对访问权限列的描述。
生成按钮	生成按钮让您能够生成项目。生成运行能够刷新符号配置编辑器中的变量视图。
设置按钮	设置按钮让您能够激活以下选项：
	支持 OPC UA 功能	不支持此功能。
	在 XML 中包含注释	该选项可让分配至变量的注释也导出为符号文件。
	在 XML 中包含节点标志	该选项可让包含命名空间的标志也导出为符号文件。在 OPC UA 处于活动状态时，它们提供有关命名空间中节点的起源的附加信息。
	配置注释和属性...	打开注释和属性对话框，该对话框让您能够配置符号配置和 XML 文件的内容。
	Configure synchronisation with IEC tasks...	打开所选控制器属性对话框的选项选项卡。请参阅EcoStruxure Machine Expert 菜单命令在线帮助中 Access variables in sync with IEC tasks 选项的描述。注意：对于注重运动和实时的应用，不要激活选项 Configure synchronisation with IEC tasks...，因为 IEC 任务的延迟启动会引起更大的抖动。有关更多信息，请参阅有关“Configure synchronisation with IEC tasks...”选项的更多信息文段。
	Compatibility Layout	选择此选项，可以与 V4.3 前的 SoMachine / SoMachine Motion 版本相同的方式计算数据输出。不要将此布局与使用属性 pack_mode 或 relative_offset 的导出 STRUCT 一起使用。为客户端创建的数据布局应尽可能适应编译器创建的布局。
	Optimized Layout	选择此选项，可以优化的形式计算数据输出，不受内部编译器布局的影响。优化仅影响结构化类型的变量和功能块。比如，不为未发布的成员生成包含补齐码的间隔，因为符号配置中禁用了这些间隔。对于内部成员（比如，实现接口的功能块），也不创建间隔。对于用 EcoStruxure Machine Expert 创建的项目，此选项缺省为已选择。在项目更新之后，保留此设置。
工具按钮	保存 XML Scheme 文件...	打开用于在文件系统中保存文件的对话框。让您能够创建 XSD（XML Schema 定义）格式的符号文件，以便用在外部程序中。

表格描述

符号配置表格的列：

列	描述
符号	此列列出 POU。您可以选择要导出的变量。如果选择了结构化数据类型的变量，结构中的所有成员都将被导出。您也可以在 Symbol Configuration for Data Type 对话框中仅选择特定的成员变量。单击成员列中的 ... 浏览按钮打开该对话框。有关更多信息，请参阅成员列的描述。
访问权限	要修改所选项目的访问权限，可单击访问权限列。每次单击鼠标，即可切换一下定义内的符号： o：读和写 o：只写 o：只读 o无
最大	显示最大访问权限。
类型	显示变量的数据类型。别名数据类型的变量的显示如以下的变量示例所示： myVar : MY_INT,，其中 MY_INT 被声明为：TYPE MY_INT : INT; END_TYPE。在这种情况下，类型列显示 MY_INT : INT。
成员	单击成员列中的 ... 按钮，打 Symbol Configuration for Data Type 对话框。它让您能够仅选择特定的成员变量。对于嵌套类型，此对话框也提供了用于打开另一个 Symbol Configuration for Data Type 对话框的按钮。此选择适用于此数据类型的导出了符号的所有实例。如果未导出结构化类型的所有成员，则在成员的复选框中会显示星号 (*)，指示并未导出该类型的所有可导出成员。
注释	显示已经在变量声明中添加的任何注释。

注意：通过 POU 属性始终链接，可强制将未编译的对象下载至控制器。如果在所选 POU 的属性对话框的生成选项卡中设置了这个属性，则该 POU 中声称的所有变量都将可用，即使对象本身并未被其他编码引用。或者，您可使用 pragma {attribute linkalways} 让未编译的变量可在符号配置中使用。

用红色显示配置为导出但是在应用程序中无效的变量，例如由于其声明被删除而无效。这也适用于相关的 POU 或库名称。

默认情况下，通过运行代码生成来创建符号文件。在下次下载时，将把该文件传输至设备。如果您希望在不执行下载的情况下创建文件，可使用命令生成代码，该命令默认位于生成菜单。

注意：如果全局变量列表 (GVL) 的变量中至少有一个用在编程代码中，则这些变量将仅在符号配置中可用。

注释和属性对话框

单击设置 > 配置注释和属性后，即打开注释和属性对话框。它包含以下元素：

元素	描述
符号表内容
Enable extended OPC UA information	不支持此功能。
包含注释
包含属性
Also include comments and attributes for type nodes
XML 符号文件内容
包含命名空间节点标志	命名空间节点标志提供有关命名空间中节点的起源的附加信息。在激活了 OPC UA 时，节点标志在符号表中可用。如果解析器无法处理命名空间节点标志，则取消选择此选项，以防在 XML 文件中插入这些标志。
包含注释	选择此选项，可将注释保存在 XML 文件中。在 V4.4 之前的 SoMachine / SoMachine Motion 版本中，这包括 Prefer docu comments 这一设置。
包含属性	选择此选项，可将属性保存在 XML 文件中。
Also include comments and attributes for type nodes	只有在激活了选项包含注释或选项包含属性时，此选项才可用。如果选择了此选项，则还会包含节点类型的信息（用户定义类型，如 STRUCT 和 ENUM 元素）。如未选择此选项，注释和属性仅可用于直接导出的变量。
选择注释这些参数只有在激活了其中一个包含注释选项后才可用。
Include docu comments: ///其以三道斜线开头，通常为 /// 格式的 ReST（库文档）	选择这些选项，可确定符号配置中保存的注释类型。
Include normal comments: （IEC/ Pascal 形式的注释）// 包含双斜线的 C++-形式的注释
始终包含两种类型的注释
Prefer docu comments, fallback to normal ones
Prefer normal comments, fallback to docu comments
Filter Attributes (case insensitive) 这些参数只有在激活了其中一个包含属性选项后才可用。
包含所有属性（“foo”、“bar”、“foo.bar”）	选择这些选项，可确定符号配置中保存的属性。
Match simple identifiers (“foo”, “bar”)
Include attributes starting with:
Filter Attributes with regular expression

有关 Configure synchronisation with IEC tasks... 的附加信息

为了实现同步且一致的访问，运行时系统推迟处理象征性客户端的读取或写入请求，直到没有 IEC 任务被执行。一旦发现这种间隔，便会推迟重启 IEC 任务，直到已将请求的值复制到变量列表。

此选项适用于不包含生产计时的永久运行系统，比如，要以固定的时间间隔循环写入过程值的情况。

注意：对于注重运动和实时的应用，不要激活选项 Configure synchronisation with IEC tasks...，因为 IEC 任务的延迟启动会引起更大的抖动。

如果您希望使用 Configure synchronisation with IEC tasks... 选项，那么在定义被读取和写入的变量列表时，应考虑一下几点：

o仅为那些必要的变量配置同步且一致的访问。

o为一致的变量以及可能不一致的变量分别创建列表。

o创建多个包含一致变量的小列表，而不是创建一个大列表。

o将循环读取值的时间间隔定义得尽可能大。

Configure synchronisation with IEC tasks...位于 EcoStruxure Machine Expert 中的两个不同的位置：

o在符号配置编辑器中，作为设置按钮的选项。（如果符号配置在应用程序中可用。）

o在所选控制器属性对话框的选项选项卡中。

注意：为了使设置生效，可对控制器上的应用程序执行下载或在线修改，并更新启动应用程序。