Signal Tracing With a Host Scope in Freerun Mode

This example shows how to do freerun signal tracing using an 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 application is started and the host scope is used for data acquisition and display. Note:

  • The model sample time is 250 usec.

  • The scope is set to acquire 200 samples with a decimation factor of 4.

  • This corresponds to a display length of 250e-6 * 200 * 4 = 0.2 seconds.

The scope is started in Freerun mode, and its status is monitored until it reaches the 'Finished' state. 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.

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. Under the model's configuration parameter Simulink Real-Time option settings, the system target file has been set to slrt.tlc. Hence, building the model will create an executable image, xpcosc.dlm, that can be run on a computer booted with the Simulink Real-Time kernel.


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

set_param('xpcosc','RTWVerbose','off'); % Configure for a non-Verbose build.
rtwbuild('xpcosc');                     % Build and download application.
### Starting Simulink Real-Time build procedure for model: xpcosc
### Generated code for 'xpcosc' is up to date because no structural, parameter or code replacement library changes were found.
### Successful completion of build procedure for model: xpcosc
### Looking for target: TargetPC1
### Download model onto target: TargetPC1

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

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

tg =;           % Create a Simulink Real-Time target object
tg.SampleTime = 0.000250;               % Set sample time to 250us
tg.StopTime   = 10000;                  % Set stop time to a high value (10000s)
start(tg);                              % Start model execution

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

tPar = getparamid(tg, 'Gain1', 'Gain');             % Get index of parameter 'Gain1/Gain'
signals(1) = getsignalid(tg, 'Integrator1');        % Get index of signal 'Integrator1'
signals(2) = getsignalid(tg, 'Signal Generator');   % Get index of signal 'Signal Generator'

sc = addscope(tg, 'host');              % Define (add) a host scope object
addsignal(sc, signals);                 % Add signals to signal list of scope object

sc.NumSamples  = 200;                   % Set number of samples
sc.Decimation  = 4;                     % Set decimation factor
sc.TriggerMode = 'Freerun';             % Set trigger mode

figh = findobj('Name', 'scfreerundemo');% Does the plot figure exist?
if isempty(figh)
  figh = figure;                        % No: Create figure
  set(figh, 'Name', 'scfreerundemo', 'NumberTitle', 'off');
  figure(figh);                         % Yes: Make it the current figure

% Loop to acquire 25 data packages from the scope object.
m = 1; flag = 0;
for n = 1 : 25
  if isempty(find(get(0, 'Children') == figh, 1)), flag = 1; break; end
  % Change parameter Gain1/Gain every fifth acquisition loop
  % to a random value between 0 and 2000.
  if ~m
    setparam(tg, tPar, 2*1000*rand);
  m = rem(m + 1,  5);

  start(sc);                            % Start scope object

  % Wait until scope-object has 'finished' acquiring the data.
  while ~strcmpi(sc.Status,'finished');

  % Create time vector, upload scope data and display it.
  t = sc.Time;                          % Upload time vector
  plot(t,sc.Data);                      % Upload acquired data and plot
  title(['scfreerundemo: ',num2str(n),' of 25 data packages']);
  set(gca,'XLim',[t(1), t(end)]);
  set(gca,'YLim',[-10,  10]);
if ~flag, title('scfreerundemo: finished'); end

Stop and Close Model

When done, stop the application and close the model.

stop(tg);                               % Stop model
close_system('xpcosc',0);               % Close model
Was this topic helpful?