Communication in MATLAB

Use an A2L file to allow communication between XCP client and server modules via XCP

An A2L file is a special description file that defines the implementation of an ECU. The information in an A2L file allows an XCP client to communicate with a server module via an XCP connection. The formatted text file contains event and measurement definitions, and other configuration information, used for acquiring and stimulating data and to perform other functions.

To communicate with an XCP server over CAN, an A2L file (ECU description file) must contain at least the following property information:

ProtocolLayerInfo
TransportLayerCANInfo
Measurements
DAQInfo and Events
- MATLAB^®: DAQInfo and Events content is required if using dynamic DAQ list functionality.
- Simulink^®: Because the XCP CAN Data Acquisition block uses dynamic DAQ list functionality, DAQInfo and Events content is required.

You can connect your XCP client to a server module using the CAN protocol. This allows you to use events and access measurements on the server module. Follow the XCP Database and Communication Workflow to learn how to connect to a device using XCP.

You can perform a direct read from or write to the memory on the server module. Alternatively, create a dynamic data stimulation list and assign measurements to the list, then read acquired DAQ data and write stimulation data.

Functions

expand all

A2L Files

`xcpA2L`	Access A2L file
`getCharacteristicInfo`	Get information about specific characteristic from A2L file
`getMeasurementInfo`	Get information about specific measurement from A2L file
`getEventInfo`	Get event information about specific event from A2L file

Hardware Connection

`xcpChannel`	Create XCP channel
`connect`	Connect XCP channel to server module
`disconnect`	Disconnect from server module
`isConnected`	Connection status

Read and Write Data to Memory

`readCharacteristic`	Read and scale specified characteristic value from direct memory
`writeCharacteristic`	Scale and write specified characteristic value to direct memory
`readMeasurement`	Read and scale specified measurement value from direct memory
`writeMeasurement`	Scale and write specified measurement value to direct memory
`readAxis`	Read and scale specified axis value from direct memory
`writeAxis`	Scale and write specified axis value to direct memory
`readSingleValue`	Read single sample of specified measurement from memory
`writeSingleValue`	Write single sample to specified measurement

Acquire and Stimulate Measurements

`createMeasurementList`	Create measurement list for XCP channel
`viewMeasurementLists`	View configured measurement lists on XCP channel
`freeMeasurementLists`	Remove all measurement lists from XCP channel
`startMeasurement`	Start configured DAQ and STIM lists
`isMeasurementRunning`	Indicate if measurement is active
`readDAQ`	Read scaled samples of specified measurement from DAQ list
`readDAQList`	Read samples and times of specified measurement in DAQ list (Since R2024a)
`readDAQListData`	Read samples of specified measurement from DAQ list
`writeSTIM`	Write scaled value of specified measurement to STIM list
`writeSTIMListData`	Write to specified measurement
`stopMeasurement`	Stop configured DAQ and STIM lists

Properties

expand all

File and Channel Objects

xcp.A2L Properties	Properties of the `xcp.A2L` file object
xcp.Channel Properties	Properties of the `xcp.Channel` object

Topics

Hardware Connection

XCP Hardware Connection
Diagram for connecting XCP client and server.

Read and Write Data to Memory

Read a Calibrated Measurement
Translate pedal position to read a calibrated torque demand measurement.
Read a Single Value
Read a single value by name directly from memory.
Write a Single Value
Write a single value by name directly to memory.

Acquire and Stimulate Measurements

Acquire Measurement Data via Dynamic DAQ Lists
Create a dynamic data acquisition list and read measurements from the list events.
Stimulate Measurement Data via Dynamic STIM Lists
Create a dynamic data stimulation list and assign measurements to the list events.

Featured Examples

Get Started with A2L Files

Access and view information stored in A2L files.

Open Live Script

Read XCP Measurements with Direct Acquisition

Use the XCP protocol capability to connect and acquire data from an XCP Sample server. The XCP Sample server is specially designed for XCP examples only.

Open Live Script

Read XCP Measurements with Dynamic DAQ Lists

Use the XCP protocol capability to connect and acquire data from an XCP Sample server. The XCP Sample server is specially designed for XCP examples only.

Open Live Script

Calibrate XCP Characteristics

Use the XCP protocol capability to connect and calibrate available characteristic data from an XCP Sample server. The XCP Sample Server is specially designed for XCP examples only.

Open Live Script

Perform XCP Operations on Deployed Simulink Model

Use the XCP protocol capability to perform basic XCP operation from a Simulink® model deployed to a Windows® executable. The example performs XCP operations on TCP protocol, including modifying the characteristic parameters of the model using direct memory access and reading measurement parameters of the model using direct memory access and dynamic DAQ list.

Open Live Script