getCallbackDataForSignal

Get callback data for a signal in real-time instrument object

Since R2020b

Syntax

[time,data] = getCallbackDataForSignal(instrument_object,event_data,blockPath,portIndex,Name,Value)

[time,data] = getCallbackDataForSignal(instrument_object,event_data,signalName)

Description

[time,data] = getCallbackDataForSignal(instrument_object,event_data,blockPath,portIndex,Name,Value) gets callback data from the target computer for a signal by using the block path and the port index.

[time,data] = getCallbackDataForSignal(instrument_object,event_data,signalName) gets callback data from the target computer for a signal by using the signal name. The eventData for the callback shares all the new data available from the target computer since the last time the callback was executed.

Examples

Get Callback Data by Using Block Path and Port Index

Get callback data for a signal by using the block path and port index of the signal in the real-time application file. Because the getCallbackDataForSignal function takes event data as an input argument, call this function from inside an slrealtime.instrument callback function.

mldatxfile = 'slrt_ex_tank.mldatx';
hInst = slrealtime.Instrument(mldatxfile);
connectCallback(hInst,@my_callback);
addSignal(hInst,'slrt_ex_tank/ControlValue',1);
% . . . inside the my_callback (an slrealtime.instrument callback), 
% . . . you can call getCallbackDataForSignal
[cv_time,cv_data] = getCallbackDataForSignal(hInst,hEvnt,'slrt_ex_tank/ControlValue',1);

Get Callback Data by Using Signal Name

Get callback data for a signal by using the signal name of the signal in the real-time application file. Because the getCallbackDataForSignal function takes event data as an input argument, call this function from inside an slrealtime.instrument callback function.

mldatxfile = 'slrt_ex_tank.mldatx';
hInst = slrealtime.Instrument(mldatxfile);
connectCallback(hInst,@my_callback);
addSignal(hInst,'ControlValue');
% . . . inside the my_callback (an slrealtime.instrument callback), 
% . . . you can call getCallbackDataForSignal
[cv_time,cv_data] = getCallbackDataForSignal(hInst,hEvnt,'ControlValue');

Input Arguments

instrument_object — Object that represents real-time instrument

object

To create the instrument object, use the Instrument function.

Example: hInst

event_data — Event that triggers the callback operation

object

The eventData object identifies the event that triggers callback operation.

Example: hEvnt

blockPath — Block path for block with signal connected to one of its outports

character vector

For the selected block, gcb returns the full block path name.

Example: slrt_ex_tank/ControlValue

portIndex — Index of block port that is connected to signal for streaming

integer

For the selected signal, the output port index and signal name are visible in the signal hierarchy available in Simulink Real-Time explorer or in the Model Data Editor.

Example: 1

signalName — Name of signal for streaming

character vector

For the selected signal, the port index and signal name are visible in the signal hierarchy available in Simulink Real-Time explorer or in the Model Data Editor.

Example: ControlValueOut

Output Arguments

time — Time data from target computer

time data

The time value is the current time returned from the target computer.

data — Signal data from target computer

signal data

The data value is the current signal data returned from the target computer.

Version History

Introduced in R2020b