MATLAB Examples

XCP Direct Data Acquisition

This example shows how to use XCP connections to directly acquire measurement values from a slave. It uses a freely available XCP slave simulator from Vector and Vector virtual CAN channels. For access to virtual channels, Vector device drivers must be installed. It is also recommended to run Vehicle CAN Bus Monitor in conjunction with this example.

Contents

Run a Slave Simulator

This example requires installing a free, third-party XCP implementation from Vector. The package includes an XCP slave simulator and A2L file. To install this driver, please follow these instructions:

  1. Go to www.vector.com and navigate to the "DOWNLOADS" page.
  2. Search for "Demos" under "Categories" and "XCP" under "Standards".
  3. Download and install the available version of "XCP Sample Implementation".
  4. In MATLAB, navigate to where you installed the sample package, and then go to .\Samples\XCPSim\CANape.
  5. The MATLAB XCP examples will use the XCPSIM.a2l file and the XCPsim.exe slave simulator. Run XCPsim.exe.

Open the A2L File

Establishing a connection to an XCP slave requires using the A2L file that describes the slave module.

a2lObj = xcpA2L('XCPSIM.a2l')
a2lObj = 

  A2L with properties:

                 FileName: 'XCPSIM.a2l'
                 FilePath: '\\central-mi\home\jpyle\documents\MATLAB\examples\vnt-ex81955136\XCPSIM.a2l'
                SlaveName: 'CPP'
        ProtocolLayerInfo: [1×1 xcp.ProtocolLayerInfo]
                  DAQInfo: [1×1 xcp.DAQInfo]
    TransportLayerCANInfo: [1×1 xcp.TransportLayerCANInfo]
    TransportLayerUDPInfo: [1×1 xcp.TransportLayerUDPInfo]
    TransportLayerTCPInfo: []
                   Events: {1×6 cell}
             Measurements: {1×45 cell}
          Characteristics: {1×16 cell}
                EventInfo: [1×6 xcp.Event]
          MeasurementInfo: [45×1 containers.Map]
       CharacteristicInfo: [16×1 containers.Map]
                 AxisInfo: [1×1 containers.Map]
            RecordLayouts: [41×1 containers.Map]
             CompuMethods: [16×1 containers.Map]
                CompuTabs: [0×1 containers.Map]
               CompuVTabs: [2×1 containers.Map]

Create an XCP Channel

Create an XCP channel to prepare a connection to the slave.

xcpCh = xcpChannel(a2lObj, 'CAN', 'Vector', 'Virtual 1', 1)
xcpCh = 

  Channel with properties:

               SlaveName: 'CPP'
             A2LFileName: 'XCPSIM.a2l'
          TransportLayer: 'CAN'
    TransportLayerDevice: [1×1 struct]
              SeedKeyDLL: []

Connect to the Slave

To make communication with the slave active, connect to it.

connect(xcpCh)

Directly Acquire Measurement Samples

Acquire some samples of a measurement from the slave.

readSingleValue(xcpCh, 'channel3')
readSingleValue(xcpCh, 'channel3')
readSingleValue(xcpCh, 'channel3')
ans =

  single

   -3.0390


ans =

  single

   -4.8650


ans =

  single

   -5.5284

Directly Acquire a Series of Measurement Samples

Using a loop, acquire and plot many measurement samples from the slave.

allSamples = [];
for ii = 1:50
    newSample = readSingleValue(xcpCh, 'channel3');
    allSamples = [allSamples newSample];
end
plot(allSamples)

Disconnect from the Slave

To make communication with the slave inactive, disconnect from it.

disconnect(xcpCh)