sltest.xil.framework.Acquisition 类

命名空间: sltest.xil.framework

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

自 R2022a 起

全页展开

需要附加组件

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

描述

Add-On Required: 此功能需要

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

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

创建对象

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

方法

全部展开

公共方法

`setupWithVariables`	`setupWithVariables(testvar)` 配置 `sltest.xil.framework.TestVariable` 对象、`testvar` 来记录变量。每个 `TaskName` 输入的 `TestVariable` 属性指定数据记录发生的速率（参阅 `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);

版本历史记录

在 R2022a 中推出

另请参阅

sltest.xil.framework.Framework | sltest.xil.framework.FrameworkConfiguration | sltest.xil.framework.Stimulation | sltest.xil.framework.TestVariable