主要内容

本页采用了机器翻译。点击此处可查看英文原文。

Target

实时呈现应用程序和目标计算机的状态

说明

Target 对象表示一台 Speedgoat® 目标计算机,并提供访问与该目标计算机相关的 对象函数Target Object PropertiesTarget Object Events 的途径。

该对象提供对以下方法和属性的访问:

  • 启动和停止实时应用程序。

  • 读取并设置参数。

  • 记录并流式传输信号。

  • 检索目标计算机的状态信息。

  • 重新启动目标计算机。

  • 加载实时应用程序。

  • 启动、停止并从探查器中检索信息。

函数名区分大小写。输入全名。属性名称不区分大小写。若您输入的字符在该属性中具有唯一性,则无需输入完整名称。

当实时应用程序加载完成后,您可从目标计算机的命令行调用部分对象属性与函数。有关详细信息,请参阅目标计算机命令行接口

创建对象

target_object = slrealtime 构建一个目标对象,该对象代表默认目标计算机。

target_object = slrealtime(target_name) 构建一个目标对象,该对象代表由 target_name 指定的目标计算机。

slrealtime 函数接受以下参数:

  • target_name - 目标计算机的名称(字符向量或字符串标量)。例如,'TargetPC1'

  • target_object - 表示目标计算机的对象。例如,tg

示例: 为默认目标计算机创建目标对象

示例: 构建并运行实时应用程序

属性

请参阅 Target Object Properties

对象函数

addInstrumentAdd instrument object to target object
clearStartupApp清除目标计算机上的启动应用程序选择
connectMATLAB 连接到目标计算机
copyPage在实时应用程序中将一个校准页面复制到另一个页面
deleteParamSet从应用程序中删除选定的参数集文件
deleteProfilerDataDelete execution profiler data from target computer
disconnect断开与目标计算机的 MATLAB 连接
exportParamSetParameterSet 对象数据写入参数集文件
getAllInstruments获取添加到目标对象的仪表信息
getApplicationFile获取实时应用程序文件的名称
getAvailableProfileGet information about available execution profiler data
getECUPage获取实时应用程序中 ECU 使用的当前页码
getInstalledApplications获取已安装的实时应用程序文件列表
getLastApplication获取目标计算机上最近运行的实时应用程序名称
getNumPages获取内存中页面的数量以供实时应用程序使用
getPersistentVariables将持久变量从目标计算机 Simulink Real-Time 获取到 MATLAB
getProfilerDataRetrieve profile data object
getStartupApp获取目标计算机上初始化应用程序配置的相关信息
getXCPPage获取实时应用程序中 XCP 使用的当前页码
getparam在实时应用中读取可观测参数的值
getsignal从实时应用程序中读取信号值
getVersion获取 MATLAB、支持包以及 Speedgoat I/O 模块集的版本信息
importParamSet创建 ParameterSet 对象
install在目标计算机上安装实时应用程序
isConnected获取目标计算机连接状态
isLoaded获取实时应用程序加载状态
isRunning获取实时应用程序运行状态
listParamSet列出应用程序可用的参数集文件
load将应用程序部署到目标计算机并加载实时应用程序
loadParamSet还原指定文件中保存的参数值
reboot重新启动目标计算机
removeAllInstruments从目标对象中移除仪表对象
removeAllApplications从目标计算机中移除所有 Simulink Real-Time 应用程序
removeApplication从目标计算机 Speedgoat 中卸载应用程序 Simulink Real-Time
removeInstrument从目标对象中移除选定的仪表对象
reset重置目标对象
resetProfiler将探查服务状态重置为 Ready
saveParamSet保存实时应用程序参数值
setECUAndXCPPage将 XCP 和 ECU 使用的内存页设置为实时应用程序选定的内存页
setECUPage将 ECU 使用的内存页设置为实时应用程序选定的内存页
setStartupApp为目标计算机配置启动实时应用程序
setStopTime为实时应用程序配置停止时间
setXCPPage将 XCP 使用的内存页设置为实时应用程序选定的内存页
setipaddr在目标计算机上设置 IP 地址和子网掩码
setparam在实时应用中更改可调参数的值
setPersistentVariablesSet persistent variables from MATLAB to the Simulink Real-Time target computer
startStart execution of real-time application on target computer
startProfiler在目标计算机上启动探查服务
startRecording启动信号数据实时流传输和文件日志记录
status获取目标计算机上实时应用程序的状态
stop停止实时应用程序的执行并将其从目标计算机卸载
stopProfiler停止在目标计算机上对服务进行探查
stopRecording停止信号数据实时流传输和文件日志记录
update在目标计算机上更新实时操作系统版本

示例

全部折叠

创建一个目标对象,该对象代表默认目标计算机。

为默认目标计算机创建目标对象 tg。您可以使用 Simulink Real-Time Explorer 选择默认目标计算机。

tg = slrealtime

创建一个目标对象,该对象代表目标计算机 TargetPC1

通过显式名称为目标计算机创建目标对象 tg

tg = slrealtime('TargetPC1')

构建并下载 slrt_ex_osc,然后执行实时应用程序。

打开、构建并下载实时应用程序:

tg = slrealtime;
mdlSTF = getSTFName(tg);
mdlName = 'slrt_ex_osc';
openExample(mdlName);
set_param(mdlName,"SystemTargetFile",mdlSTF);
slbuild(mdlName);
load(tg,mdlName);
start(tg);

请按照以下步骤将目标计算机设置(TargetSettings 属性)从一台目标计算机共享到另一台目标计算机。

  1. 在与目标计算机相连且设置为共享的开发计算机上,创建名为 Target 的对象 tg。创建一个名为 s 的变量,用于存储目标对象的设置。将设置保存为 MAT 文件 tgSettingsShared.mat

    tg = slrealtime;
    s = tg.TargetSettings;
    save("tgSettingsShared","s");
  2. 在用于开发且连接至目标计算机的计算机上(该计算机上的设置将应用于另一台目标计算机),加载 MAT 文件 tgSettingsShared.mat 并创建 Targets 对象 tgs

    load('tgSettingsShared.mat');
    tgs=slrealtime.Targets();
  3. 如果目标计算机名称(例如 TargetPC3)已在开发计算机上存在,请将其删除。此步骤是必要的,因为如果名称已存在,则在应用变量 s 的设置时,该名称会被重置为空。如果目标计算机名称尚未存在,则可以跳过此步骤。

    removeTarget(tgs,'TargetPC3');
  4. 若使用与原始目标计算机名称不同的名称,请在变量 s 中定义目标计算机名称。应用目标计算机设置。

    % If using a different target computer name, 
    % define the name in s. For example:
    % s.name = 'TargetPC4';
    tgs.addTarget(s);

版本历史记录

在 R2020b 中推出

全部展开