dSPACE中ControlDesk操作说明书

ControlDesk操作
一、 启动ControlDesk：有三种启动方式
方式1：开始－>所有程序－>dSPACE Tools－>ControlDesk，如图1所示方式2：在“运行”中输入“ControlDesk”，如图2所示
方式3：双击“ControlDesk”桌面图标，如图3所示
图1 开始菜单启动
图2 运行命令框启动
图3 桌面ControlDesk图标启动
二、 主窗口介绍：
ControlDesk启动后主界面如图4所示
ControlDesk的窗口主要包括
1) Menu Bar 菜单栏：用于访问ControlDesk的功能和命令
2) Toolbars 工具栏：可以对经常使用的功能直接操作
3) Navigator导航器窗口，包括4个页面窗口
The Experiment Navigator ——实验导航器
The Instrument Navigator ——虚拟仪器导航器
Navigator——硬件平台导航器
The
Platform
Navigator——自动测试导航器
Automation
Test
The
4) Tool Window工具窗口：所包含的工具取决于当前所用的导航器
Viewer——用于显示各种相应信息，包括系统信息、操作信息等
Log
The
Interpreter ——用于执行Python命令
The
The File Selector ——用于展开各层次文件夹，查看文件及选择文件
Selector ——CD自动测试部分，用来选择Python的函数命令Function
The
如果打开模型，还会出现其它两个页面窗口 Variable Manager和 Reference Data Manager.
5) Status Bar状态栏：
6) Context Menu上下文菜单：右击窗口或工具按钮时才出现
7) Working Area工作区：用以显示和编辑实验项目。

在这个窗口中可以显示源码编辑器或者带有数据连接的虚拟仪表盘。

在动画模式（Animation Mode）下，虚拟仪表可以显示仿真的过程。

8）Instrument Selector 虚拟仪表选择器：用于创建虚拟仪表
图4 ControlDesk主窗口
图 5 下拉菜单
图 6 Navigator 导航器
图7 Tool Window工具窗口
可通过View菜单下的Toolbars和Controlbars来显示或关闭相应的窗口或工具条。

如图8所示：
图8 View下拉菜单显示与关闭工具条或窗口
三、 ControlDesk操作原理：
ControlDesk操作原理主要有：拖放（鼠标左键），上下文菜单，菜单栏，点击工具按钮：1）、拖放：
如果要将一个信号指派给一个虚拟仪器，只要将它从变量浏览器中拖入到对应的虚拟仪器即可；要加载应用程序，将系统数据文件“*.sdf ”拖入到导航器Platform中相应的硬件平台（如DS1105）。

图9 拖放变量与拖放系统数据文件下载应用程序
2）、上下文菜单：
在工具栏右键单击显示有关窗口和工具按钮的上下文菜单；在导航器窗口不同的标签页右击显示相关操作的上下文菜单；在虚拟仪表某控件上右击显示对该控件操作的上下文菜单；其他窗口类似。

3）、菜单操作：
激活窗口或控件后，通过下拉式菜单进行相应操作。

4）、工具按钮：
许多操作都有相应的工具按钮，左键单击相应按钮可执行相应的操作。

下表列出支持拖放操作的特性：
查看dSPACE设置信息：View－>dSPACE.ini。

如图10所示
图10 Dspace.ini配置信息
如何创建新文件：File－>New，选择所要创建的文件类型。

如图11所示：
图11 创建新文件
打开、保存、另存为…关闭文件：执行File菜单下相应命令。

如何检查硬件平台错误：Tools－>Check Platform(s) for Errors。

所有有关ControlDesk的操作及信息都记录在dSPACE.log 文件中，通过Log Viewer工具窗口查看，也可以从菜单栏View－>Log File在工作区打开dSPACE.log文件。

如图12所示：
图12 Log Viewer 查看操作日志信息，打开dSPACE.log文件
用户可以通过Tools－>Customize－>Toolbars/Keyboard进行自定制工具条或快捷键。

用户可以通过Tools – Customize – >User Functions来定义用户外部函数。

设置ControlDesk的各种属性选项：View –> General Properties，打开general properties对话框，如图13所示：
图13 general properties 对话框
四、 ControlDesk导航器与工作窗口：
导航器窗口一般有四个标签：
Experiment Navigator——实验导航器：显示隶当前所打开实验包含的所有东西，例如硬件平台信息、虚拟仪表、参数设置或者参考数据，同时还提供了处理实验及其组件的函数。

Instrumentation Navigator ——虚拟仪导航器：包括当前所用的虚拟仪表，以层次结构的方式显示。

Platform Navigator——硬件平台导航器：显示了系统注册平台的软硬件信息。

同时页提供了注册板卡以及处理应用程序的功能，例如下载、开始和停止应用程序。

Test Automation Navigator——测试自动化：提供了用于高级测试和自动测试所需的功能
注：用户购买的系统不同，会略有差异，如 CAN Navigator——CAN控制器局域网，Failure Simulation——故障仿真。

实验管理常用操作
图14实验管理导航页及其工具条
通过右键拖放实验管理导航页中的文件，可改变该文件的从属关系。

如何创建新实验文件：File – New Experiment，打开New Experiment对话框，图15所示：
图15 New Experiment对话框
如何下载实验：File – Open Experiment，打开Open Experiment对话框，选择要打开的实验文件（.cdx）。

保存实验：File － Save Experiment。

有关实验操作实例可见dSPACE帮助文档Managing Experiments > Using the Experiment Navigator > Example of Handling an Experiment
五、 ControlDesk硬件平台管理与应用操作
图16 硬件平台导航页及其上下文菜单
硬件平台管理器提供了对安装在PC或者扩展box内的硬件平台进行操作的功能，并且能够将应用程序分配给这些平台。

硬件平台管理器也提供了一个simulink界面用以处理simulink 的仿真。

dSPACE板卡也可以通过bus或者局域网和主机相连。

当使用局域网时，需要有其
他的网络客户端。

对硬件平台的使用，首先要对硬件板卡进行注册，有三种注册方式：
1.菜单栏：Platform – Initialization – Register
2.硬件平台导航器的上下文菜单，选择Register...
3.工具栏按钮
打开板卡注册对话框，如图17所示：
图17 Register Board对话框
指定类型：在Type中指定板卡型号，可供选择以注册的板卡类型有: DS1003, DS1005, DS1102, DS1103, DS1401, DS2301, DS2302。

在选定完板卡类型后，可以出现指定硬件平台的默认设置，包括板卡名字和端口地址。

端口地址：在 Port Address设定。

板卡名字：自动指定，用以显示硬件平台的名字，在选择板卡类型时由硬件平台管理器预先设定，不能进行更改。

可以指定硬件平台的端口地址。

端口地址必须符合所安装板卡的I/O基地址。

*注意：端口地址就是I/O基地址，其中不允许设置为000H，024H为局域网连接的默认地址，其他地址有280，300，310，380，参看DS1006InstConfig.pdf。

Mapping address(只针对DS1003) Lets you select either 0xD0000 or 0xE0000 as the mapping address reserved for the DS1003 in your host PC. Other platforms do not require a mapping address.
一些板卡支持即插即用 (DS1005, DS1103, DS1104, and DS1401)，在该情况下板卡通过ControlDesk进行注册。

如果安装在扩展box或者PC不支持即插即用，用户将不能使用注册特性。

按Register进行注册注册完板卡，将在Platform Navigator中出现处理器和IO板卡的信息。

系统设定保存在dSPACE.ini中，通过双击处理器或者IO板卡的图标可以显示详细信息
进行板卡注册后，执行：Platform－>Properties或在Platform Navigator的上下文菜单选择Properties可查看板卡信息。

图18所示：
图18 Processor Board Properties对话框
如何设置工作板卡：当安装组件系统，有多个板卡可供选择时，需设定工作板卡，方法如下：方法一：Platform – Set Working Board，在弹出的Set Working Board对话框中选择要设为工作板卡的型号，点击OK即可。

方法二：右键单击Platform Navigator中想设为工作板卡的型号，在弹出的上下文菜单中选择Set Working Board。

如何在dSPACE实时板卡上处理应用程序：
方法一：下载并开始运行一个实时程序
在File Selector中选择系统描述文件（.sdf），将其拖放到Platform Navigator中相应的板卡图标，即可下载并运行程序，如图19所示：
图19 拖放下载系统描述文件（.sdf）
方式二：停止并重新下载一个实时应用程序
1、在Platform Navigator中，选择正在运行的板卡
2、从菜单栏选择：Platform – Application – Stop Real-Time Processor.
3、从菜单栏选择：Platform – Application – Reload Application.
工具窗口：所提供的工具取决于所当前的导航器，图20所示
图20 工具窗口
Log Viewer：显示ControlDesk产生的信息。

所有信息都保存在log文件中dSPACE.log (用工具栏和菜单栏分别都打开该文件）
Interpreter：用于处理Python命令以及CD和自动测试所用的脚本文件。

Function Selector：是CD自动测试的一部分，可以显示Python模块中的函数并运行产生函数调用。

File Selector：能够通过拖拉方式选择应用程序并下载到工作板卡上，并且只显示相关的文件。

如果应用程序下载到硬件平台后，变量管理器（Variable Manager）自动打开。

Variable Manager以打开的trace文件名来标记，包括变量浏览器和参数编辑器。

它可以访问应用程序的变量和参数。

每打开一个trace文件就在工具窗口中添加一个标签。

如果数据被存储，则参考数据管理器（Reference Data Manager）被打开。

Reference Data Manager用以管理对采集数据或参考数据的访问。

通过拖放可以将信号分配给plotter并进行数据分析。

六、 ControlDesk实验管理器：
Experiment包括一系列文件，这些文件的相关信息保存在C ontrol D eskE x periment文件(.cdx)，其中还包括了版本、作者信息以及描述信息（在.cdd）中。

这些文件在Experiment Navigator中以层次次序排列。

Experiment Manager提供三种不同上下文菜单，图21所示：
1) @ControlDesk Experiment文件
2)@其他文件
3) @Navigator（白色区域）
4) Experiment Manager工具栏
图21 Experiment Navigator Context菜单
创建实验：
菜单栏方式：File－>New Experiment
在弹出的New Experiment对话框中输入实验文件名称（.CDX），指定工作路径，版本信息，创建者，描述，实验图标等。

保存实验：
菜单方式：File – Save Experiment、File – Save Experiment As …
打开实验：
菜单栏方式：File – Open Experiment、File – Recent Experiment
注：创建、保存和打开实验都有相应的工具按钮，可直接单击按钮进行操作。

浏览器 (Experiment 页)：
导航器种的层次次序可以选择 (Tool Bar, 最后的一个按钮):
•依赖性层次: 通过文件的依赖关系以及载入次序来分类
•组件结构层次: 通过CD组件来分类(Instrumentation - ..., VariableBrowser - ...)
•目录层次: 通过文件的位置分类 (View – General Properties – Experiment, more to the Experiment Manager on the next slide)
为实验添加文件：
•在打开窗口的上下文菜单种选择“Add to experiment”
•选择“File – Add All Opened Files”
•File – Import Files ...
七、 ControlDesk虚拟仪表：
建立虚拟仪表盘需要两个主要步骤：
1、建立layout文，选择并排列虚拟仪表
2、连接虚拟仪表与仿真变量
虚拟仪表盘及虚拟仪表导航页如图22所示
图22 虚拟仪表盘及其导航页
对layout中的仪表进行布局时，除了可以用拖动的方式外，还可使用layouting工具条进行
规则布局，图23所示
创建虚拟仪器面板(layout)
一个实验可以包括多个layout
两种方法创建layout：菜单栏或者是工具栏
设计虚拟仪表面板
1)创建虚拟仪表所需要的工具：虚拟仪表选择器以及layout工具栏，图26所示。

2)创建过程：从选择器中选择需要的仪表；在属性对话框中设置各个仪表的属性；在属性对话框可以设置仪表外观、标题、参数等；使用工具栏进行仪表的排列
如何创建虚拟仪表：
1、在Instrument Selector中点击所要绘制的虚拟仪表的图标
2、在layout面板上点击左键拖拉矩形框，松开左键即可创建一个虚拟仪表
3、在工具窗口中的model_name.sdf标签页中选择要查看的变量，将其拖放到所建立的虚拟仪表，则虚拟仪表的红色边框消失，即可建立仪表与变量的连接。

点击Instrumentation工具条（图24所示）的动作模式按钮即可查看变量的时间历程。

图24 Instrumentation 工具条
Instrumentation 工具条对应三种模式
编辑模式Edit ：可定义实验，设计Layout ，定义数据连接 测试模式Test ：核对layout 设计，分析数据
动作模式Animation ：运行程序，修改参数，获取和显示数据
图25 菜单栏创建layout
图26 创建layout 及其工具
选组按钮
Layout
使用Layout toolbar 来排列仪表
仪
表
面
板
选择仪表
Instrument Selector
对每个仪表设置属性 预调整(presetting) 外观 Captions
每个控键的独立参数
属性对话框
显示/隐藏栅格
分组仪表和仪表浏览器
对于复杂的仪表面板，可能需要进行分组以使外观更为清晰，分组过程：
用shift键选择多个虚拟仪表
用菜单中Edit – Instrument Layout – Group
编辑仪表属性：
未分组: 双击仪表面板即可打开属性窗口
分组: 双击仪表面板组，或者上下文菜单–Properties -> properties of the single instrument
从虚拟仪表页可以看到所有layout以及里面的虚拟仪表名称，并显示出层次结构
在建立了虚拟仪表之后，需要将数据和对应的仪表联系起来，进行数据连接的过程：
从变量文件中找到对应的数据；
将数据拖放到对应的虚拟仪表内；
数据连接过程中，模型可能存在很多变量，如何快速准确的找到所需要的变量呢：从变量窗口中的上下文菜单中选择FindVariable，输入关键字和搜索属性，开始搜索即可。

要确定虚拟仪表所连接的数据：
在虚拟仪表的上下文菜单中，选择HightLigh Variable，在变量文件中可以显示出所连接的变量。

如何修改虚拟仪表所连接的变量：
在虚拟仪表的上下文菜单中，选择Edit Data Connection
在对话框中可以选择数据触发的时间、数据源和数据目标等。

如何将多个变量连接到一个控键:
应用：在一个仪表内更改多个变量
步骤：拖放第一个连接，用鼠标右键拖放其他连接，为第二个连接选择Write To Variable
在建立完虚拟仪表以及数据连接之后，需要保存layout文件。

layout文件的保存有两种形式，除了要保存layout文件外，还需要保存对应的数据连接关系。

同样的，对应的也有两种加载的方法。

Layout可以保存为
f独立目标
f实验的一部分
Layout保存为独立目标
f File – Save As ...
选择 layout 类型 (*.lay)
保存数据连接
f Instrumentation - Export Data Connections
选择连接文件类型 (*.con)
加载layout
f作为实验的一部分
f作为独立目标
Layout作为独立目标加载
f File – Open
选择 layout 类型 (*.lay)
加载数据连接
f Instrumentation –Import Data Connections
选择连接文件类型(*.con)
当模型很大时，可能会因为变量太多不好寻找变量，CD提供了过滤工具，可以从大量的变量中过滤出用户需要的变量来。

从变量浏览器的上下文菜单中可以选择Filter Tree，在过滤器对话框中可以选择过滤算法，并进行逻辑组合，由此过滤出所需要的变量。

另外还可以将过滤器算法保存下以下次使用。

过滤的算法可以是变量名、子系统变量、模块名和模型类型等。

八、 ControlDesk数据分析：
在数据分析过程中，可以使用PlotterArray显示和分析所采集的数据，图27为PlotterArray 及其分析工具。

PlotterArray中包括三种图形方式，这三种图形方式从PlotterArray的属性对话框添加：Plotter可以将信号按时间序列显示出；
XYPlotter可以将两个信号按照XY显示出；
LogicAnalyzer用以显示逻辑信号。

在这里，图形可以自动排列，并可以全屏显示。

另外，CD还提供多种工具进行数据分析，用户可以使用鼠标跟踪曲线的x、y值以及差值。

注意，在同一plot中可以绘制多个变量的曲线。

图27 PlotterArray及其分析工具
将数据图形和变量联系在一起：
采用拖放就能将变量连接在一起。

如果要将多个变量和图形连续在一起，可以将多个变量拖放到同一个plot中。

采用拖放的plot左边的话，会出现多个坐标轴；
采用拖放到plot右边的话，只有一个坐标轴；
Plot中的图形可以打印或者保存为bmp，在Plot的上下文菜单中选择Copy Plotter as Bitmap。

ControlDesk还提供了数据获取的工具Capture Settings。

在虚拟仪表的上下文菜单中选择Edit Capture Settings，如图28所示。

Capture Setting Instruments允许用户自己设置数据获取的参数，在模型中可以建立多个数据获取的service。

在数据获取的service中，可以启动或停止数据采集，设置触发信号。

图28 Captrue Settings对话框
如何构建capture settings：
1）使用 Capture Settings
- 工具栏的上下文菜单
- PlotterArray的上下文菜单
2）指定Start / Stop, Auto Repeat，Downsampling
3）如何设置触发:
将变量拖放到触发区域(灰色区域)
指定：触发沿触发电平预-/后-触发(延迟)
激活触发
九、 参数编辑器：
在实验中，用户需要对参数进行调整，最后得到最合适的参数。

因此在实验过程中需要将所调的参数记录下，以便于结合实验数据一起进行分析。

另外，用户在实验中可能需要进行重复，需要调出原来的实验参数。

ControlDesk提供了参数编辑器，图29所示。

可以通过Parameter Editor工具条（图30）将实验的参数保存、导入等操作。

如何写参数
f变量文件(.par)被加载
y可以加载多个PAR文件
y可以加入到实验
f设置参数文件的参数文件选项Declare Status Set
f Parameter Editor – Write Parameters
图29 Parameter Editor
图30 Parameter Editor工具条
十、 表格编辑器：
TableEditor包括一个图表和一个独立的表格用于显示表的值，图31所示。

在图中，当前正在编辑的数据点在图中用一个红点来表示，在表格中用方框表示出。

图中工作点用绿色表示。

表格编辑器的功能：
可以从仿真平台上读写表格数据。

表格可以是1D或者2D。

表格的格式可以是一个矩阵或者查表。

可以当场更改表格数据。

数据改变后，图形和数据表内的数据也同时改变。

改变的数据根据它们是增加（蓝）或减小（红）而改变颜色。

编辑表格：
f通过工具栏改变数值
f在表中改变数值
f左键修改绘图区的节点
保存的Mat文件包括变量：
f data_xindex (x-数值)
f data_yindex (y-数值)
f data_tables (表格数值)
数据关联:
f将表格数据和图表或矩阵关联
f将输入行和列与x，y关联
f将工作点输入和表格的x\y 点关联（先x 值后y 值）如何将变量关联到Table Editor (1D)，图32、33所示：
1) 将表格的OutputValues关联到表格的绘图区或矩阵的参数区
2) 将表格的InputValues关联到第一行
3) 将表格的input signal拖到表格的x/y处
图31 TableEditor
图32将变量关联到Table Editor（一维）
图33将变量关联到Table Editor（二维）。