Main Content

Perform XCP Data Acquisition in Simulink

This example shows you how to use XCP blocks to acquire measurement values in Simulink® from the XCP Sample server. The XCP Sample Server is specially designed for XCP examples only.

Vehicle Network Toolbox™ provides XCP blocks for interfacing with a server over multiple transport layers including Controller Area Networks (CAN), Controller Area Network Flexible Data-Rate (CAN FD) and User Datagram Protocol (UDP). This example uses the XCP CAN Configuration, XCP CAN Data Acquisition, and XCP CAN Transport Layer blocks to perform data transfer over the CAN protocol.

XCP is a high-level protocol used for accessing and modifying internal parameters and variables of a model, algorithm, or ECU. For more information, refer to the ASAM standards.

Open the A2L File

An A2L file is required to establish a connection to the XCP server. The A2L file describes all of the functionality and capability that the XCP server provides, as well as the details of how to connect to the server. Use the xcpA2L function to open the A2L file that describes the server model.

a2LInfo = xcpA2L("SampleECU.a2l")
a2LInfo = 
  A2L with properties:

   File Details
                 FileName: 'SampleECU.a2l'
                 FilePath: '/tmp/Bdoc24a_2528353_1101874/tp8faccd1d/vnt-ex11419635/SampleECU.a2l'
               ServerName: 'SampleServer'
                 Warnings: [0x0 string]

   Parameter Details
                   Events: {'Event DAQ 100ms'}
                EventInfo: [1x1 xcp.a2l.Event]
             Measurements: {'Line'  'PWM'  'Sine'}
          MeasurementInfo: [3x1 containers.Map]
          Characteristics: {'Gain'  'yData'}
       CharacteristicInfo: [2x1 containers.Map]
                 AxisInfo: [1x1 containers.Map]
            RecordLayouts: [3x1 containers.Map]
             CompuMethods: [1x1 containers.Map]
                CompuTabs: [0x1 containers.Map]
               CompuVTabs: [0x1 containers.Map]

   XCP Protocol Details
        ProtocolLayerInfo: [1x1 xcp.a2l.ProtocolLayer]
                  DAQInfo: [1x1 xcp.a2l.DAQ]
    TransportLayerCANInfo: [1x1 xcp.a2l.XCPonCAN]
    TransportLayerUDPInfo: [0x0 xcp.a2l.XCPonIP]
    TransportLayerTCPInfo: [1x1 xcp.a2l.XCPonIP]

Start the XCP Sample Server

The XCP Sample server mimics the behavior of a real XCP server in a controlled way. In this case, it serves ONLY for examples with limited functionalities. Use local SampleECU class to create the sampleServer object. A sampleServer will be created in the MATLAB Workspace.

sampleServer = SampleECU(a2LInfo,"CAN","MathWorks","Virtual 1",1);

Open the Example Model


Setting up XCP Block Parameters

Create a model to set up XCP data acquisition for the measurements, PWM, Sine and Line, from the Sample server.

  • Use an XCP Configuration block and select the A2L file, SampleECU.a2l.

  • Use an XCP CAN Transport Layer block and set the Device to Mathworks Virtual 1 Channel 2. The transport layer is configured to transfer XCP messages over CAN via the specified virtual channel.

  • Use XCP Data Acquisition blocks to receive selected measurements at specified events. For this example, we have selected an XCP Data Acquisition block for all three measurements.

Visualize Measurement Values Received From Server

Run the model and plot the results to see the measurement values for PWM, Sine and Line from the server. The X-axis corresponds to the simulation timestep. Initially the scope has no data output as the Sample server requires time to initialize.


Close the Model and Clean Up

clear sampleServer a2LInfo