12 工具
从站协议栈代码工具允许根据用户特定要求和设置创建新的从站文件。
从站文件列表:
C源代码文件
源代码文档(可选)
设备描述(ESI)(可选)
支持的操作系统:Windows XP, Vista, 7 (32位)
所需框架:.NET (4.0)
注册了两个新文件扩展名:SSC配置文件 (.escfg) 和 从站项目文件 (.esp)。配置文件随每个SSC版本提供,包含所有设置和关于代码的信息。从站项目文件由配置器创建,用于保存从站项目。
主用户界面(图32:配置器主用户界面)结构如下:上方是工具条(文件、项目、工具和帮助),下方是3个独立的窗口(从站项目导航、从站设置和冲突)。
图32:配置器主用户界面
(图注:展示了SSC Tool的主界面布局,包含菜单栏、项目导航树、设置区域和冲突信息窗口。)
以下章节更详细地描述了各个元素。
12.1 默认启动对话框
[使用信息]
SSC工具使用信息,在开始工作前需要确认。
[供应商信息]
用于输入供应商信息的对话框,包括供应商ID和供应商名称。这些信息将自动添加到新的从站项目中。也可以通过选项对话框添加此信息。
[运行向导]
启动项目向导以创建新的从站项目。
12.2 主用户界面元素
12.2.1 工具条
12.2.1.1 文件
文件菜单(图33:配置器文件菜单)包含项目文件操作。
图33:配置器文件菜单
(图注:展示“File”菜单下拉选项,包含“新建”(Ctrl+N)、“打开”(Ctrl+O)、“保存”(Ctrl+S)、“另存为”和“退出”。)
[新建]
基于本地SSC文件创建一个新的从站项目。项目可以基于默认配置或自定义配置创建(图34:创建新项目)。要导入第三方配置,请参见12.6。
[打开]
打开一个现有的项目文件。
[保存]
将当前设置保存到当前项目文件(如果之前未创建项目文件,则会出现文件浏览器对话框以创建新文件)。
[另存为]
将当前设置保存到新的项目文件。
[退出]
关闭当前会话。
12.2.1.2 项目
图35:配置器源菜单
(图注:展示“Project”菜单下拉选项,包含“项目更新”、“查找设置”(Ctrl+F)和“创建新的从站文件”(F5)。)
[项目更新]
检查新的从站协议栈代码版本并更新当前项目。更多信息请参见第12.5章。
[查找设置]
打开一个对话框以查找设置。
图36:查找设置对话框
(图注:展示查找设置对话框的界面,包含搜索框和设置列表,列表显示设置名称、值和描述。)
[创建新的从站文件]
打开一个对话框,根据当前设置创建新的从站文件。
12.2.1.3 工具
图37:工具菜单
(图注:展示“Tool”菜单下拉选项,包含“显示冲突窗口”、“EEPROM编程器”和“选项”。)
[显示冲突窗口]
隐藏或显示冲突窗口。
[EEPROM编程器]
打开EEPROM编程器工具。此工具可用于创建EEPROM头文件或二进制文件,或对EtherCAT从站的EEPROM进行编程。更多细节请参见13.2 EEPROM编程。
[选项]
打开选项对话框(见图38:工具选项)。
图38:工具选项
(图注:展示选项对话框界面,包含“通用”、“编辑器”、“创建文件”和“配置”等标签页。)
通用
[启动时打开上一个项目]下次启动工具时重新加载上一个从站项目。
[启动时显示使用信息]每次启动时显示工具使用信息(使用信息也可以通过[帮助] -> [使用信息]显示)。
[创建新项目前更新SSC]如果设置此标志,从站协议栈代码工具在创建新项目前检查是否有新的SSC版本可用。
注意:在每次项目更新([项目] -> [项目更新])之前,将触发本地SSC文件的更新。本地SSC文件存储在应用程序数据文件夹中。[更新本地SSC]更新本地SSC文件。
[供应商名称]在此处添加您的供应商名称。此信息将添加到从站项目。
[供应商ID]在此处添加您的供应商ID。此信息将添加到从站项目。如果您还没有供应商ID,请联系 info@ethereat.org。
编辑器
[显示高级设置]同时显示标记为高级的设置(例如编译器设置)。
[显示只读设置]显示标记为只读的设置(但保持只读)。只读设置标有锁形符号(见图39:配置器锁定设置)。
图39:配置器锁定设置
(图注:展示一个只读设置的示例,旁边有一个锁形图标。)
创建文件
[如果跳过了过时代码则添加注释]指定在删除代码(与默认从站协议栈代码相比)时是否添加源代码注释。
[创建文档]基于先前创建的源文件创建代码文档。此功能需要外部工具,这些工具不包含在SSC倍福许可协议中!请注意工具特定的使用许可。
基本上需要Doxygen。可以使用特定的Doxygen配置文件,否则使用默认配置,该配置另外需要GraphViz和HTML Help Workshop。[使用配置文件]使用用户特定的doxygen配置文件。
[所需软件]选择所需软件的位置。
[创建设备描述 (ESI)]如果勾选此选项,将创建应用程序特定的设备描述。
配置
在此选项标签页中,可以更改自定义配置的列表。配置包含设置列表、文件和ESI片段,这些是在特定平台上运行SSC或添加新应用程序所需的。配置以xml格式描述。请联系 EtherCATSSC@beckhoff.com 获取相应的模式。[+]导入新配置。
[-]从列表中移除配置。
图40:配置列表
(图注:展示“配置”标签页下的一个配置列表示例。)
12.2.1.4 帮助
[使用信息]
显示关于使用SSC工具的使用信息和法律声明。
[联系]
使用您的标准电子邮件客户端创建发送至 EtherCATSSC@beckhoff.com 的新电子邮件。
[关于]
显示关于SSC工具的信息。
12.2.2 窗口
I. [从站项目导航]
从站项目导航窗口列出了所有可配置的设置类型。选择其中一个节点,相应的设置将显示在从站设置窗口中。如果项目至少保存过一次,根节点名称等于项目名称。此窗口也支持拖放。
II. [从站设置]
此窗口中显示的信息取决于在从站项目导航窗口中选择的节点。
如果选择了根项目节点,则有两个标签页可用:
信息标签页包括SSC版本、配置文件版本、配置器评估的所有从站协议栈代码文件的列表以及用户文件(见图42:配置器项目信息)。文件列表内提供了右键上下文菜单(见图43:配置器文件上下文菜单)。
配置标签页包括多个预配置设置的列表,例如用于EL9800评估板或FC1100应用程序的设置。
[重新加载文件]
重新加载缓存的文件(仅适用于用户文件)。
[移除文件]
从项目中移除文件(仅适用于用户文件)。
[添加文件]
向项目添加一个或多个文件。这些文件不会被评估,只会复制到输出文件夹。如果添加了新的硬件访问文件,可以通过在硬件设置中定义“HW_ACCESS_FILE”将其包含到通用文件中(例如“#include “myhw.h”)。
如果添加了新的应用程序文件,还需添加对“APPLICATION_FILE”的引用(例如“#include “myappl.h””)。
注意:需要激活“高级编辑器设置”才能编辑文件引用设置。
编辑文件(双击文件)
要编辑用户特定的源文件,请双击该文件。将打开此文件类型的默认编辑器。
如果在从站项目导航中选择了其中一个设置节点,则相应的设置显示在从站设置窗口中(图44:配置器从站设置)。
图42:配置器项目信息
(图注:展示项目信息标签页,显示SSC版本、配置版本以及项目使用的文件列表。)
图43:配置器文件上下文菜单
(图注:展示在文件列表上点击右键出现的菜单,包含“重新加载文件”、“移除文件”和“添加文件”选项。)
图44:配置器从站设置
(图注:展示选中“Hardware”节点后,右侧设置区域显示的具体硬件相关配置选项列表。)
III. [冲突窗口]
此窗口显示设置的冲突。冲突分为错误、警告和信息。冲突设置由相应的冲突符号表示。
注意:并非所有设置的组合都会被检查。因此,创建逻辑配置取决于用户。
[错误]表示配置器无法使用当前配置创建有效的从站协议栈。
[警告]标有警告符号的设置应在创建新的从站文件之前进行检查。
[信息]关于当前配置的附加信息。
12.3 创建文件
创建新文件是创建新从站协议栈的最后一步。通过选择 [项目] -> [创建新的从站文件] 打开对话框。
a) 选择输出文件夹。
b)[开始]开始创建新文件。
c) 输出窗口显示进度信息。
图45:配置器创建文件
(图注:展示“创建新的从站文件”对话框,包含输出路径选择、进度窗口以及“浏览”、“取消”、“关闭”、“开始”按钮。)
[浏览]
为新的从站文件选择输出文件夹。
[取消]
不创建新文件关闭对话框。
[关闭]
创建新文件后关闭对话框。
[开始]
在指定文件夹中创建新的从站文件。
创建新的从站文件后,会出现一个对话框,用于打开指定的输出文件夹或返回到配置器。
12.4 本地SSC更新
每个新项目都基于本地从站协议栈代码文件。这些文件在项目更新开始之前或创建新项目时(如果设置了此选项)更新。
从站协议栈代码文件存储在SSC工具的应用程序文件夹中。
更新对话框如图46所示:配置器从站协议栈代码更新。
图46:配置器从站协议栈代码更新
(图注:展示“Slave Stack Code Update”对话框,包含“在线”和“离线”两种更新模式选项。)
[在线]
从倍福FTP服务器加载SSC文件。
[离线]
从本地SSC zip存档加载SSC文件。
两种选项都需要外部存档工具(7-Zip、WinRAR® 或 WinZip®)。
12.5 项目更新
SSC工具提供了将当前项目中的通用文件更新到最新版本的可能性。
如果有新文件可用,则显示更新对话框(图47:配置器项目更新对话框)。
图47:配置器项目更新对话框
(图注:展示“Project Update”对话框,包含当前版本、新版本信息,一个显示更改的列表框,以及“仅显示当前项目相关更改”复选框和“OK”、“Cancel”按钮。)
[当前版本]
当前项目的从站协议栈代码版本。
[新版本]
可用的最新从站协议栈代码版本。
[仅显示当前项目相关更改]
如果勾选,仅显示与当前项目设置相关的更改。否则显示所有更改。
注意:如果勾选,仅显示最新更改。早于一个版本的相关更改不会显示。
[确定]
更新当前项目。如果显示感叹号,则在项目更新前需要确认重要信息。
[取消]
取消项目更新。
12.6 导入配置
配置提供了操作SSC设置、引用源文件和添加新ESI元素的可能性。默认情况下,提供了一系列与应用相关的配置,但也可以导入新的配置,例如用于德州仪器AM335x的配置。
导入配置可以通过新项目对话框(图48:新项目 | 导入配置)或选项菜单(图49:选项 | 导入配置)完成。
图48:新项目 | 导入配置
(图注:展示创建新项目时的第一步对话框,左侧有“配置”列表,右侧有“导入”按钮。)
图49:选项 | 导入配置
(图注:展示在“工具”->“选项”的“配置”标签页下,有配置列表和“+”、“-”按钮用于导入和移除配置。)
注意:配置可能引用不受倍福自动化有限公司许可协议涵盖的文件。请联系配置供应商了解更多信息。
来源:AN_ET9300.pdf
用作个人学习和分享,侵删