Target Object Events

Use listeners for target object events to monitor the target computer state

Since R2020b

Syntax

Target Object Events

Many Target object functions produce event status. You can use the MATLAB listener function to monitor event states.

Connecting, ConnectFailed, Connected

These events relate to connecting a target computer by using the Real-Time tab in the Simulink Editor, Simulink Real-Time Explorer, or the connect function. The Connecting event indicates the connection process has started (for example, a connect(tg) function call occurred), but no connection actions have yet occurred. When the connection process completes, the Connected or ConnectFailed events occur.

Disconnecting, Disconnected

These events relate to disconnecting a target computer by using the Real-Time tab in the Simulink Editor, Simulink Real-Time Explorer, or the disconnect function. The Disconnecting event indicates the disconnection process has started (for example, a disconnect(tg) function call occurred), but no disconnection actions have yet occurred. When the disconnection process completes, the Disconnected event occurs.

Installing, InstallFailed, Installed

These events relate to installing a real-time application on a target computer by using the install function. The Installing event indicates the installation process has started (for example, an install(tg) function call occurred), but no installation actions have yet occurred. When the installation process completes, the Installed or InstallFailed events occur.

Loading, LoadFailed, Loaded

These events relate to loading a real-time application on a target computer by using the Real-Time tab in the Simulink Editor, Simulink Real-Time Explorer, or the load function. The Loading event indicates the load process has started (for example, a load(tg) function call occurred), but no load actions have yet occurred. When the load process completes, the Loaded or LoadFailed events occur.

Starting, StartFailed, Started

These events relate to starting a real-time application on a target computer by using the Real-Time tab in the Simulink Editor, Simulink Real-Time Explorer, or the start function. The Starting event indicates the start process has started (for example, a start(tg) function call occurred), but no start actions have yet occurred. When the start process completes, the Started or StartFailed events occur.

Stopping, StopFailed, Stopped

These events relate to stopping a real-time application on a target computer by using the Real-Time tab in the Simulink Editor, Simulink Real-Time Explorer, or the stop function. The Stopping event indicates the stop process has started (for example, a stop(tg) function call occurred), but no stop actions have yet occurred. When the stop process completes, the Stopped or StopFailed events occur.

Rebooting, RebootFailed, RebootIssued

These events relate to rebooting a target computer by using the Simulink Real-Time Explorer or the reboot function. The Rebooting event indicates the reboot process has started (for example, a reboot(tg) function call occurred), but no reboot actions have yet occurred. When the reboot process completes, the RebootIssued or RebootFailed events occur.

UpdateBegin, UpdateFailed, UpdateCompleted

These events relate to updating target computer RTOS software by using the Simulink Real-Time Explorer or the update function. The UpdateBegin event indicates the update process has started (for example, an update(tg) function call occurred), but no update actions have yet occurred. When the update process completes, the UpdateCompleted or UpdateFailed events occur.

SetIPAddressBegin, SetIPAddressFailed, SetIPAddressCompleted

These events relate to changing a target computer IP address by using the Simulink Real-Time Explorer or the setipaddr function. The SetIPAddressBegin event indicates the IP set process has started (for example, an setipaddr(tg) function call occurred), but no IP set actions have yet occurred. When the set IP process completes, the SetIPAddressCompleted or SetIPAddressFailed events occur.

StartupAppChanged

This event relates to changing a target computer startup application by using the Simulink Real-Time Explorer or the setStartupApp or clearStartupApp functions. The StartupAppChanged event indicates the app set process has completed. For example, a setStartupApp(tg) function call completes the app set process.

StopTimeChanged

This event relates to changing a real-time application stop time by using the Simulink Real-Time Explorer or the setStopTime function. The StopTimeChanged event indicates the stop time set process has completed. For example, a setStopTime(tg) function call completes the stop time set process.

ParamChanged

This event relates to changing a real-time application parameter by using the Simulink Real-Time Explorer or the setparam function. The ParamChanged event indicates the parameter set process has completed. For example, a setparam(tg) function call completes the parameter set process.

ParamSetChanged

This event relates to changing a real-time application parameter set by using the loadParamSet function. The ParamSetChanged event indicates the load parameter set process has completed. For example, a loadParamSet(tg) function call completes the load parameter set process.

CalPageChanged

This event relates to changing the currently used real-time application calibration page by using the setECUPage, setXCPPage, setECUAndXCPPage, or copyPage functions. The CalPageChanged event indicates the page change process has completed. For example, a setECUPage(tg) function call completes the page change process.

RecordingStarted

This event relates to recording start of real-time application signal streaming by using the Simulink Real-Time Explorer Start Recording button or the startRecording function. The RecordingStarted event indicates the recording process has started. For example, a startRecording(tg) function call completes the recording start process.

RecordingStopped

This event relates to recording stop of real-time application signal streaming by using the Simulink Real-Time Explorer Stop Recording button or the stopRecording function. The RecordingStopped event indicates the recording process has stopped. For example, a stopRecording(tg) function call completes the recording stop process.

ApplicationRemoved

This event relates to removing a real-time application from the target computer by using the removeApplication function. The ApplicationRemoved event indicates the application removal process has completed. For example, a removeApplication(tg) function call completes the application removal process.

Version History

Introduced in R2020b