sltest.xil.framework.Acquisition 类

命名空间: sltest.xil.framework

控制信号数据在测试平台记录并检索记录的数据

自 R2022a 起

全页展开

需要附加组件

本课程要求您安装并设置 ASAM XIL 标准的 Simulink Test 支持包。

描述

使用 sltest.xil.framework.Acquisition 类在测试平台设置变量来记录数据、控制数据采集并检索获取的记录数据。

sltest.xil.framework.Acquisition 类是 handle 类。

创建对象

您无法创建 sltest.xil.framework.Acquisition 对象。Acquisition 对象仅作为 sltest.xil.framework.Framework 对象的成员存在。首先创建一个 Framework 对象，然后使用该 Framework 对象中的 Acquisition 方法。

方法

全部展开

公共方法

`setupWithVariables`	`setupWithVariables(testvar)` 配置 `sltest.xil.framework.TestVariable` 对象、`testvar` 来记录变量。每个 `TestVariable` 输入的 `TaskName` 属性指定数据记录发生的速率（参见 `sltest.xil.framework.FrameworkConfiguration`）。使用可选的名称值参量来设置触发。`setupWithVariables` 自动创建采集配置。输入参量 `testvar` — 在测试平台设置用于记录的变量，指定为单个 `sltest.xil.framework.TestVariable` 对象或 `TestVariable` 对象数组。名称-值对输入 `TriggerVariables` — 用于触发的变量，指定为 `sltest.xil.framework.TestVariable` 对象或 `TestVariable` 对象数组。触发变量不需要与被记录的变量相同。 `StartTriggerType` — 启动日志数据采集的触发器类型，指定为 `'no trigger'`（默认）或 `'condition'`。如果您指定 `'no trigger'`，则采集将立即在测试平台开始。对于您的测试平台，采集可能在调用 `start` 或 `Framework.start` 时开始，具体取决于您的测试平台硬件。（请参阅您的特定测试平台硬件的文档。）当您指定 `'condition'` 时，采集将在条件满足时开始。 `StartTriggerVal` — 启动日志数据采集的触发器的值，指定为字符数组表达式。此输入仅当 `StartTriggerType` 为 `'condition'` 时适用。 `StartTriggerTimeout` — 如果 `StartTriggerType` 是 `'condition'` 且条件未发生，则在测试平台开始日志数据采集的时间（以秒为单位）。将 `StartTriggerTimeout` 指定为双精度值。 `StopTriggerType` — 停止日志数据采集的触发器类型，指定为 `'no trigger'`（默认）、`'condition'` 或 `'duration'`。如果指定 `'no trigger'`，则采集将继续，直到仿真停止。如果指定 `'condition'`，则采集将继续，直到满足停止条件。如果指定 `'duration'`，则采集将在采集开始后指定的持续时间结束。 `StopTriggerVal` — 停止日志数据采集的触发器的值，当 `StopTriggerType` 为 `'condition'` 时指定为字符数组表达式，当 `StopTriggerType` 为 `'duration'` 时指定为双精度值。 `StopTriggerTimeout` — 如果 `StartTriggerType` 是 `'condition'` 且条件未发生，则在测试平台停止日志数据采集的时间（以秒为单位）。此超时后，测试平台将进入下一个触发状态。将 `StopTriggerTimeout` 指定为双精度型。
`start`	`start` 根据您使用 `setupWithVariables` 方法指定的设置和触发启用数据记录。在大多数硬件平台上，当您调用 `framework.start` 时触发和数据记录就开始。在某些平台上，当您调用此 `Acquisition.start` 方法时，触发和数据记录会立即开始。
`stop`	`stop` 立即停止日志数据采集，即使触发尚未完成。
`wait`	`wait` `wait(Name=Value)` 等待触发完成。当触发完成时，数据采集停止。然后，您可以使用 `fetch` 来获取记录的数据。名称-值对 `Timeout` — 主机上等待触发完成的时间（以秒为单位），指定为双精度值。如果指定了超时，则如果超时在测试平台完成采集之前结束，则 `wait` 返回 `false`，如果采集完成，则返回 `true`。
`fetch`	`data = fetch` 立即停止日志数据获取并返回 `Simulink.SimulationData.Dataset` 对象，即使触发尚未完成。
`clearConfiguration`	`clearConfiguration` 清除当前的采集配置。

示例

全部折叠

设置无触发采集

import sltest.xil.framework.*
frm = Framework;

frm.Configuration.addModelAccessPort(...
    'MAPort1','asamxil.v2_1',...
    VendorName='ABC Co.'...
    ProductName='ABC Test Bench',
    ProductVersion='1.7',
    PortConfigFile=fullfile(pwd,'myConfigFile.xml'));

frm.Configuration.addTestVariableMapping(...
    'RPM','MAPort1','simpleXIL/Gain:1'...
    'TaskName','SubRate1');
frm.Configuration.addTestVariableMapping(...
    'Throttle','MAPort1','simpleXIL/Gain/Gain');

frm.init;

rpm = frm.createVariable('RPM');
throttle = frm.createVariable('Throttle');

frm.Acquisition.setupWithVariables([throttle,rpm]);
frm.Acquisition.start;

frm.start;

设置触发采集

要将上述示例更改为使用触发，请更改 setupWithVariables 方法来指定触发变量、启动和停止触发类型以及启动和停止触发值。

frm.Acquisition.setupWithVariables([throttle,rpm],...
   TriggerVariables=rpm,...
   StartTriggerType='condition',StartTriggerVal='rpm > 500',...
   StopTriggerType='duration',StopTriggerVal=3);