Signal Tracing Using Signal Triggering

This example shows how to trace signals using a signal triggered Simulink® Real-Time™ host scope. After the script builds and downloads the oscillator model, xpcosc, to the target computer, it adds a scope of type 'host' to the real-time application and the signals 'Integrator1' and 'Signal Generator' to the scope. The scope is then configured to trigger on the signal 'Signal Generator' when it reaches 0.0 on a rising slope (signal value goes negative to positive).

Once the trigger condition is met, the scope is monitored to determine when its data acquisition is complete. Next, the scope data is uploaded to the development computer and plotted. This process repeats 25 times. After every fifth run, the damping gain 'Gain1/Gain' is set to a new random value (between 0 and 2000).

Check Connection Between Development and Target Computers

Use 'slrtpingtarget' to test the connection between the development and target computers.

if ~strcmp(slrtpingtarget, 'success')

Open, Build, and Download Model to the Target Computer

Open the oscillator model xpcosc. The model has been configured to build for Simulink Real-Time, and building the model creates an executable image, xpcosc.mldatx, that can be run on a target booted with the Simulink Real-Time kernel.


Build the model and download the image, xpcosc.mldatx, to the target computer.

  • Configure for a non-Verbose build.

  • Build and download application.

tg = slrt('TargetPC1');
### Starting Simulink Real-Time build procedure for model: xpcosc
Warning: This model contains blocks that do not handle sample time
changes at runtime. To avoid incorrect results, only change
the sample time in the original model, then rebuild the model. 
### Successful completion of build procedure for model: xpcosc
### Created MLDATX ..\xpcosc.mldatx
### Looking for target: TargetPC1
### Download model onto target: TargetPC1

Run Model, Randomize 'Gain' Parameter, Plot Host Scope Data

This code accomplishes a number of tasks.

Task 1: Create Target Object

Create the MATLAB® variable, tg, containing the Simulink Real-Time target object. This object allows you to communicate with and control the target computer.

  • Create a Simulink Real-Time Object

  • Set sample time to 250us

  • Set stop time to a high value (10000s)

  • Start model execution

Task 2: Create, configure, and plot to the host scope during each run.

  • Get index of parameter 'Gain1/Gain'

  • Get index of signal 'Integrator1'

  • Get index of signal 'Signal Generator'

  • Define (add) a host scope object

  • Add signals to signal list of scope object

  • Set number of samples

  • Set decimation factor

  • Set trigger mode

  • Set trigger signal to 'Signal Generator'

  • Set trigger level

  • Set trigger slope

Task 3: Check for Plot Figure

Does the plot figure exist?

  • If no, create figure

  • If yes, make it the current figure

Task 4: Loop to acquire 25 data packages from the scope object.

Change parameter Gain1/Gain every fifth acquisition loop to a random value between 0 and 2000.

  • Start scope object

  • Wait until scope object has 'finished' state.

Task 5: Create time vector, upload scope data and display it.

  • Upload time vector

  • Upload acquired data and plot

tg = slrt; % create target object
tg.SampleTime = 0.000250;
tg.StopTime   = 10000;
tPar = getparamid(tg, 'Gain1', 'Gain'); % create host scope and plot
signals(1) = getsignalid(tg, 'Integrator1');
signals(2) = getsignalid(tg, 'Signal Generator');
sc = addscope(tg, 'host'); % define scope object
addsignal(sc, signals);
sc.NumSamples    = 200; % set number of samples and other settings
sc.Decimation    = 4;
sc.TriggerMode   = 'Signal';
sc.TriggerSignal = signals(2);
sc.TriggerLevel  = 0.0;
sc.TriggerSlope  = 'Rising';
figh = findobj('Name', 'scsignaldemo');
if isempty(figh)
  figh = figure; set(figh, 'Name', 'scsignaldemo', 'NumberTitle', 'off');
figh = findobj('Name', 'scsignaldemo'); % check for plot figure
if isempty(figh)
  figh = figure;
  set(figh, 'Name', 'scsignaldemo', 'NumberTitle', 'off');
m = 1; flag = 0; % loop to acquire data
for n = 1 : 25
  if isempty(find(get(0, 'Children') == figh, 1)), flag = 1; break; end
  if ~m
    setparam(tg, tPar, 2*1000*rand);
  m = rem(m + 1, 5);
  start(sc); % start scope object
  while ~strcmpi(sc.Status,'finished'), end;
  t = sc.Time; % create time vector and display it
  plot(t, sc.Data);
  title(['scsignaldemo: ', num2str(n), ' of 25 data packages']);
  set(gca,'XLim',[t(1), t(end)], 'YLim', [-10, 10]);
if ~flag, title('scsignaldemo: finished'); end

Stop and Close Model

When done, stop the application and close the model.

  • Stop model

  • Close model