1、 AutomationDesk 操作手册 AutomationDesk 1 AutomationDesk 介绍 1.1 AutomationDesk 的应用领域 AutomationDesk 是一个创建和管理自动操作任务的通用工具。使用 AutomationDesk 可以使得测试过程更有效。 ECU 测试过程与 ECU 开发过程并行进行 。 测试开发、测试执行、结果分析和报告生产活动都要求并产生大量数据。通常需要不止一个软件工具来管理这大量的信息。使用AutomationDesk 可以将以上活动集中在一个软件工具中进行。如图 1(a,b)所示 图 1. a 没有 AutomationDesk
2、的测试过程 图 1. b 有 AutomationDesk 的测试过程 你可以利用 AutomationDesk 来管理测试所需要的所有数据。你可以创建并指定控制流程和测试参数，执行测试，记录结果。所有执行结果可内部存储，可以输出为 XML 数据并保存为 HTML 或 PDF 文件。 方式二 ： 双击 AutomationDesk 的桌面图标 方式三 ： 从运行框中输入 “ AutomationDesk” 打开 1.2 AutomationDesk 用户界面介绍 启动 AutomationDesk 用户界面如下图所示 ： AutomationDesk 操作手册 导航器 （ Navigator）
3、： 包含工程管理器 （ Project Maneger） 和 序列层次浏览器 （ Sequence Hierarchy Browser） 。 工程管理器 ： （图 2 左图 ） 构造大的工程 拖放数据对象到文件夹和序列中 从不同层次级别开始执行自动操作序列 改变自动操作序列的执行顺序 浏览结果 (通过的 , 失败的 ) 以 HTML 或 PDF 格式生成报告 序列层次浏览器（图 2 右图 ） 显示一个单独序列的结构 拖放数 据对象到序列和自动操作块中 执行序列和自动操作块 工程管理器 库浏览器 序列生成器 导航器 （包括工程管理器和序列层次浏览器） 工具窗口 （包括日志、输出、书签、不一致性、
4、查找项目和数据对象编辑器） 序列纵览 AutomationDesk 操作手册 工程管理器 序列层次浏览器 库浏览器 （ Library Browser）： 主库 ： 流程控制 基本元素 数据对象 标准库 ： 平台访问 ControlDesk 的访问 AutomationDesk 操作手册 故障仿真的访问 诊断和标定工具的访问 用户库 ： 集成用户定义的库元素 工具窗口 (Tool Window)： 包含输出观察器（ Output）、 数据对象编辑器 （ Data Object Editor） 、查找项目（ Found Items）、冲突观察器（ Inconsistencies）、记录浏览器（
5、Log）等 ： 数据对象编辑器（ Data Object Editor， 图 3） 仅仅显示选定块的数据对象 用于联合数据对象选择器参数化数据对象 数据对象编辑器 （ Data Object Editor） 记录浏览器 （ Log） 显示 AutomationDesk 的记录信息 AutomationDesk 操作手册 序列生成器 （ Sequence Builder） ： 利用自动操作序列的上下文菜单打开 打开序列生成器 通过拖放创建自动操作序列 编辑一个 自动操作块的属性 参数化一个自动操作块的数据对象 序列生成器 （ Sequence Builder） AutomationDesk 操作
6、手册 变量浏览器（ Platform） ： 变量浏览器 AutomationDesk 操作手册 结果浏览器（ Result） ： 用测试序列的上下文菜单打开 , -文件夹 , -工程 浏览结果 结果浏览器 库浏览器（ Library Browser）介绍 ： Library Browser 下有 Main Library、 Platform Access、 ControlDesk Access、 RS232 等多个子库 ，如图 所 示 。 AutomationDesk 操作手册 Main Library 子库： 提供三种库元素： Control Flows 控制流程、 Basic Elecme
7、nts 基本元素、 Data Object 数据对象 ， 控制流程 ： Serial 顺序结构： 顺序的执行子系统 . Parallel 并行结构 ： 在同一个时刻独立的执行每一个子系统，每一个子系统在一个 单独的线程执行 For 循环结构： 按预先设定的循环数目重复运行 . While 循环结构： 循环操作直到条件为 假 (条件 : 真 (!=0) 或者假 (=0). 布尔操作符 ). Repeat 循环结构： 参照 While IfThenElse 条件判断结构： 利用特定的选项执行一个条件明令 . (条件 :参照 While). 基本元素 ： assign: 将 Value2 赋值成 V
8、alue1. VariationScheme: 重复对包含在块中的任何类型的数据对象的操作 . Range:重复一个列表项目之上的操作块，每一次循环从第一个开始移动到下一个 RangeDict: 重复字典中每一个项目 (key: value)的操作块 Sleep: 对后续的操作进行固定时间的延迟 s. Exec: 运行 Python 代码 . ExecFile: 运行 Python 文件，文件的路径以 Windows 符号的形式嵌入到文件数据对象中 Eval: 求 Python 表达式的值 . 结果写到 “Result”. Decision: 生成测试的报告 . Main Library 中的
9、控制流程和基本元素 AutomationDesk 操作手册 Report 子库： 提供库元素把用户的内容添加到报告中 AddText：添加文本到报告中 AddImage：添加图片到报告 Add2DPlot：添加绘制二维图形到报告 AddTable：添加表格到报告 AddURL：添加 URL 到报告 AddDataObjects：添加数据对象到报告 Dialogs 子库： 在序列里面提供用户交互对话框 Message Dialogs：提供你想要确认的执行消息 Input Dialogs：在序列执行过程中，手动修改 值 AutomationDesk 操作手册 Platform Access 子库：
10、 提供访问仿真平台的库元素 配置仿真平台 从仿真中读取数据 写入数据到仿真的变量 从实时应用中捕捉数据 写流数据到硬盘 产生激励信号 RS232 子库： 提供串口通信库元素 配置串口 发送数据到串口 从串口接受数 据 ControlDesk Access： 提供访问 ControlDesk 的库元素 AutomationDesk 操作手册 MATLAB Access：提供访问 MATLAB 的库元素 通过 AutomationDesk 打开 MATLAB 在 AutomationDesk 与 MATLAB 之间双向交换数据 在 MATLAB 中执行命令 使用以 MAT 文件格式存储的数据 Au
11、tomationDesk 操作手册 管理工程 Managing Projects 3.1 工程要素 ： 工程要素包括： 结构元素 （ 文件夹 folders） 、 自动测试程序 （ 序列 Sequences） 、 工程特有的数据对象 (Data Objects)、 执行结果 (Result) 产生的报告 (Rport) 文件处理 ： 打开一个工程 ： File Open 创建一个新的工程 ： File New Project 保存一个工程：在工程管理器中选择要保存的工程， File Save 备份一个工程： File Save as 压缩打包工程： File Export ，创建 .zip 文
12、件 以上文件处理操作可通过工具栏完成。 AutomationDesk 操作手册 使用工程管理器 创建一个新工程： 1、从菜单栏 File New Project，打开 New Project 对话框 2、从 Project template 下拉列表中选择 “Standard Project” 3、点击 Browse 打开 Creat Project 对话框，选择文件夹，在 File name 中输入工程名称 5、点击 Creat 关闭 Creat Project 对话框 6、 New Project 对话框 点击 OK 完成。 AutomationDesk 操作手册 打开一个工程： 1、菜单
13、栏 File Open 2、在 Open 对话框中，切换到所在目录文件夹，选择 .ADP 文件 3、单击 “打开” 如何 通过增加文件夹来构建工程： 从工程的上下文菜单 选择 New Folder，新的 Folder 就作为工程的子元素出现在工程目录树中。 AutomationDesk 操作手册 如何 创建自动测试序列： 从 project 或 folder 的上下文菜单选择 New Sequence。 如何 创建工程特有的数据对象： 1、 在工程管理器中 右击 想要从属所建数据对象的元素 2、从上下文菜单选择 New Data Object 3、从类型列表中选择数据对象的类型 如何 更改同一
14、层次级别上的工程元素顺序： 1、在工程管理器中右击想要改变其子元素顺序的工程 AutomationDesk 操作手册 2、从上下文菜单选择 Change Children Order 3、选择你想要移动的子元素 4、单击 Up 或 Down 来移动元素位置 5、单击 Close 关闭对话框 如何 修改工程属性： 1、右击工程元素 2、选择 View Properties 3、覆盖元素属性值 4、关闭对话框 使用工程档案 3.3.1 如何 导出工程： 1、从工程的上下文菜单选择 Export，打开 Export Project 对话框 2、选择文件夹，输入文件名称 3、单击 Export Aut
15、omationDesk 操作手册 创建自动操作序列 使用自动操作块 如何 给 序列添加自动操作块： 1、在库浏览器中选择自动操作块 2、 从库浏览器中拖动元 素到序列生成器中 3、在序列生成器中的适当位置放置元素，当出现红线的时候表示拖放位置合法 如何 移动自动操作块： 1、从序列或连续模块的上下文菜单中选择 Change Children Order 2、 选择要移动的自动操作块 3、单击 Up 或 Down 改变元素位置 4、单击 Close 关闭对话框 如何 编辑自动操作块属性： 1、在 Sequence Builder 内右击自动操作快 2、从上下文菜单选择 View Properti
16、es 3、覆盖属性值 4、关闭对话框 如何 给自动操作块增加注释： 1、选择自动操作块 2、从菜单 栏 Sequence Builder Block Note Add 或单击工具栏图标 3、单击注释块，编辑文本 4、在注释块外部点击，完成修改 5、左键拖动注释块到所需位置 参数化序列元素 AutomationDesk 提供了不同的方法来确定自动操作序列的参数。一个自动操作块的变量可以通过直接赋值或参考其他变量来赋值。直接设置的值只属于一个块，一个参考的值可以在AutomationDesk 操作手册 一个工程里被多次使用。 用局部数据对象确定自动操作块参数： 1、在 Sequence Build
17、er 中的自动操作块的上下文菜单选择 View Data Objects 2、 在 Value 栏覆盖数据对象值 3、关闭数据对象编辑器 用工程特有数据对象确定自动操作块参数： 1、从自动操作块的上下文菜单选择 View Data Objects 2、在 Reference Name 栏单击按钮，打开 Data Object Selector 3、从 Data Object Selector 中选择所需数据对象，单击 OK 按钮 4、关闭 Data Object Selector 如何 给自动操作块增加数据对象： 只能给这些操作块添加数据对象： Serial、 Parallel、 Variat
18、ionScheme、 Exec、 ExecFile、 Eval。 1、右击以上自动操作快 2、从上下文菜单选择 New Data Object 3、选择类型列表中选择数据对象的类型 4、可以使用命令 Set Data Object As .随意的指定数据对象为输入、输出或参数 AutomationDesk 操作手册 如何 指定条件： 给 While, Repeat and IfThenElse 指定条件： 1、从上下文菜单选择 View Data Objects，打开数据对象编辑器 2、在 Condition data object 中的 Value 栏单击按钮 ，打开 Condition E
19、ditor（图 10） 3、选择 Use Editor 激活 Condition Editor 的图形部分；如果选择 Manual editing，则可以直接输入条件 4、单击 Append 创建新的条件列表 ，如果有多个条件，可在 Logic 栏指定为 AND 或 OR 来组合条件逻辑 条件编辑对话框 如何查找矛盾 ： 如果在工程中使用许多数据对象，并且修改序列是，有可能出现参考数据对象错误的情况。数据对象编辑器显示了不合法的参考，但在大型序列中一块一 块地检查是非常费力的。 使用Find Inconsistencies 命令可以非常容易地在工程、文件夹、序列中中查找错误。 1、右击所要查找
20、的元素，选择 Find Inconsistencies。 2、选择你想要检查的不一致性类型，可以使用 Select ALL 或 Deselect All 一次选择或取消所有设定 3、 单击 Find All 查找所有由 Find 命令指定的项目。单击 Find Next 只查找最近的一项。 在 AutomationDesk 中使用 Python 脚本 AutomationDesk 库的自动操作块可以实现标 准自动测试任务要求的大部分操作。用户指定的操作可用 Python 脚本编程语言来实现。 AutomationDesk 提供的 Exec、 ExecFile 和 Eval 块Automatio
21、nDesk 操作手册 可以用来集成用户定义的自动操作任务 Pyton 脚本。 如何在 AutomationDesk中集成 Python脚本： 1、 从库浏览器中拖放一个 Exec 块到序列中 2、双击块打开 Edit 对话框 3、编辑 Python 代码 4、关闭对话框 下载外部 Python 脚本到 AutomationDesk 的 Python Interpreter： 1、拖放 ExecFile 块到 序列 2、从块的上下文菜单选择 View Data Objects，打开 Data Object Editor 3、在 Value 栏单击按钮，打开 File 对话框 4、从文件系统选择
22、Python 文件，选择 Absolute Path 或 Relative Path 来指定路径类型 5、单击 OK 关闭对话框 如何注册自定义的 Python模块： 如果你想在 AutomationDesk 中使用自定义的 Python 模块，你必须把自定义模块的路径添加到 Python 搜索路径中，否则在 Exec 块中输入的 import 函数无效。 1、添加一个 Exec 块到序列中，来编辑 Python 代码 2、双击 Exec 块，打开 Edit 对话框 3、输入以下代码，添加新路径到 Python 的搜索路径 AutomationDesk 操作手册 sys.path.insert
23、(0,r”MyNewPath”) 或 sys.path.append(r”MyNewPath”) 执行自动操作序列 创建控制流程并参数化序列元素后，就可以执行自动操作序列。执行结果存储为一个单独工程树下的节点。 可以从工程树的不同层次级别上执行序列 1、从工程根层次 2、从 folder 节点 3、从 sequence 节点 当执行开始， 在工程树中位于测试开始节点以下的所有序列都将执行。 序列执行的三种操作模式 在线操作模式 ：访问外部设备或应用，如硬件平台。 离线操作模式 ：不访问外部设备或应用 在线记录 模式 ：除了操作块的结果被存储在块特有的离线值外，其他与在线模式相同 Automat
24、ionDesk 操作手册 以下库可在在线、离线和记录模式下执行： Platform Access ControlDesk Access (no online recording) RS232 Failure Simulation Access (no online recording) DTS6 DTS7 Remote Calibration Remote Calibration (COM) Remote Diagnostics (COM) MATLAB Access 记录执行日志 每一个块和它的每一个数据对象都具有称为结果级别和报告级别的属性 . Result level： 结果级别决定了一
25、个元素是否包括在结果中 Record depth： 报告级别决定了结果的一个元素是否包括在报告中 . 结果级别和报告级别可以有三个不同的值 : None: 块或者数据对象的信息不出现在结果或者报告中 (数据对象的 默认值 ). Medium: 信息可以包括在结果或者报告中 High:如果完整的生成结果或者报告，信息被加入到结果或者报告中 (自动操作块的默认值 ). 如果自动操作序列或者自动操作块的结果级别设定为 “None”，它所有的次级自动操作块和数据对象不包括在结果或者报告中。 指定自动操作块的结果层次 ： 选择 View Properties，或在工具窗口的 Data Object Ed
26、itor 中的 Result Level 栏指定 AutomationDesk 操作手册 指定自动操作块的结果层次 执行自动操作序列： 任何级别都可以执行测试 1、右击开始执行的元素 2、从上下文菜单选择 Execute，打开 Execution Configuration 对话框 3、如果不想生产报告，则取消 Create result 选项 4、如果要生产报告，则需选择 Create result 选项，并设置其他选项 AutomationDesk 操作手册 查看结果： 在工程管理器中双击结果元素，或从上下文菜单选择 View Results，打开结果浏览器。 导出结果 ： 1、在工程管理
27、器中，右击结果元素，从上下文菜 单选择 Export - PDF 或 Export HTML，打开 Save as 对话框 2、输入导出文件的文件名 3、单击 Save，保持结果到指定文件夹，并关闭对话框 AutomationDesk 操作手册 生成报告 使用 AddDataObjects 报告块： 1、从 Report 库拖放一个 AddDataObjects 到序列 2、在序列生成器中右击 AddDataObjects 块，从上下文菜单选择 New Data Object 来个块增加一个数据对象 3、打开数据对象编辑器，给所添加的数据对象一个唯一的名称。在 Refence Name 栏单击
28、按钮打开 数据对象选择器对话框，选择要参考的数据对象 对其他设备和应用的接口 访问 ControlDesk ControlDesk 访问库 ： StartControlDesk：启动 ControlDesk ShowApplication：访问 ControlDesk 窗口 AutomationDesk 操作手册 LoadExperiment：加载试验文件到 ControlDesk. StartAnimationMode：开始动画模式 StopAnimationMode：停止动画模式 HideApplication：隐藏 ControlDesk. ControlDesk 后台执行 CloseC
29、ontrolDesk：关闭 ControlDesk 注意 : ControlDesk 的消息窗口可能打断测试的执行 如何启动 ControlDesk： 从库浏览器拖放 StartControlDesk 到序列中 如何开始平台监控： 前提： ControlDesk 必须是打开的，仿真平台必须在 ControlDesk 中正确设定 1、 从库浏览器拖放 LoadExperiment 到序列中 2、在序列生成器中，从块的上下文菜单选择 View Data Object 3、指定要下载的实验文件（ *.CDX） 4、拖放 StartAnimationMode 到序列。 停止平台监控 ： 拖放 Stop
30、AnimationMode 到序列 关闭 ControlDesk： 拖放 CloseControlDesk 到序列 一个访问 ControlDesk 的序列例子 ： AutomationDesk 操作手册 AutomationDesk 操作手册 访问仿真平台 Platform Access 库 一个平台访问的例子： 平台访问的数据对象： Platform 平台 ： 包含平台的名字和应用程序中 SDF 文件的路径和文件名 . (平台的 数据对象是自动分配的 ). AutomationDesk 操作手册 Variable 变量 ： 包含一个变量的 dSPACE trc 文件路径 ； 拖放 操作；
31、ControlDesk 变量浏览器 =变量 ControlDesk 变量浏览器 = 编辑对话框 (不需要引用 ) 可以在一个 Python 文件 (.py)内导入通过列表定义的变量数组 CaptureResult 捕捉结果 ： 用于以字典的形式保存捕捉的结果 . Key： 变量名 Value： 捕捉结果 如何配置仿真平台： 1、拖放一个 Platform 数据对象到工程管理器 2、双击 Platform 元素打开 Variable Browser 对话框 3、选择 Platform 名称，选择 Simulink 模型的变量描述文件或实时应用 在仿真平台上开始仿真： 拖放 LoadVariabl
32、efile 自动操作块到序列生成器的第一个位置 写仿真器变量： 1、拖放 Write 块到序列 AutomationDesk 操作手册 2、从块的上下文菜单选择 View Data Objects 3、在 Refernce Name 栏单击按钮，打开数据对象选择器 4、选择所需数据，单击 OK 关闭数据对象选择器对话框 5、编辑变量的值 读仿真器变量： 1、拖放 Read 块到序列 2、从块的上下文菜单选择 View Data Objects 3、在 Refernce Name 栏单击按钮，打开数据对象选择器 4、选择所需数据，单击 OK 关闭数据对象选择器对话框 捕捉仿真器变量： 1、拖放
33、Capture 块到序列 2、拖放 CaptureResult 块到序列 3、通过块的上下文菜单选择 Add Capture Variable，添 加一个变量数据对象到 Capture 块 4、在序列生成器中右击块，从上下文菜单选择 View Data Objects 5、指定捕捉设置 6、从工程特有的 CaptureResult 数据对象设定一个参考给添加的想要捕捉的变量 7、从工程特有的 CaptureResult 数据对象设定一个参考给 CaptureResult 数据对象 如何初始化平台访问 ： InitPlatformAcces： 初始化访问平台的自动操作块 : 停止 Simulink 平台 Initialize 启动 Simulink 平台 初始化 : 对当前线程所有平台变量的访问以递归的形式准备好 . 读 , 写，读矩阵，写矩阵 ： Read： 读并且返回平台指定变量的当前标量值 . Write： 写一个标量值到变量 . ReadMatrix： 读并且返回指定 n 维变量的当前值。如果变量表示一个向量，返回一个列表值 (例如 , 读表中的记录 ). WriteMatrix： 写一个 n 维变量 . 如果变量表示一个向量 , 接受一个列表值 . 如果数值表示一
