Main Content

xcp.A2L Properties

Properties of the xcp.A2L file object

Use the following properties to examine xcp.A2L file object settings. Use xcpA2L to create an A2L-file object.

xcp.A2L

expand all

This property is read-only.

The FileName property displays the name of the referenced A2L file as a character vector.

Data Types: char

This property is read-only.

The FilePath property displays the full file path to the A2L file, including the A2L-file name, as a character vector.

Data Types: char

This property is read-only.

The SlaveName property displays the name of the slave node as specified in the A2L file, as a character vector.

Data Types: char

This property is read-only.

The ProtocolLayerInfo property displays an xcp.ProtocolLayerInfo object containing general information about the XCP protocol implementation of the slave as defined in the A2L file. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
pli = a2lfile.ProtocolLayerInfo
pli = 

  ProtocolLayerInfo with properties:

    AddressGranularity: 'ADDRESS_GRANULARITY_BYTE'
             ByteOrder: 'BYTE_ORDER_MSB_LAST'
                MaxCTO: 8
                MaxDTO: 8
                    T1: 1000
                    T2: 200
                    T3: 0
                    T4: 0
                    T5: 0
                    T6: 0
                    T7: 0

Data Types: xcp.ProtocolLayerInfo

This property is read-only.

DAQ related information, returned as a DAQInfo object. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
di = a2lfile.DAQInfo
di = 

  DAQInfo with properties:

              AddressExtension: 'ADDRESS_EXTENSION_FREE'
                    ConfigType: 'DYNAMIC'
    GranularityODTEntrySizeDAQ: 'GRANULARITY_ODT_ENTRY_SIZE_DAQ_BYTE'
       IdentificationFieldType: 'IDENTIFICATION_FIELD_TYPE_ABSOLUTE'
                        MaxDAQ: 0
              MaxEventChannels: 6
            MaxODTEntrySizeDAQ: 7
                        MinDAQ: 0
              OptimizationType: 'OPTIMISATION_TYPE_DEFAULT'
            OverloadIndication: 'OVERLOAD_INDICATION_PID'
                          STIM: [1×1 struct]
            PrescalerSupported: 'PRESCALER_SUPPORTED'
               ResumeSupported: 'RESUME_NOT_SUPPORTED'
                     Timestamp: [1×1 struct]

Data Types: xcp.DAQInfo

This property is read-only.

CAN specific transport layer information, returned as a TransportLayerCANInfo object. For example,

a2lfile = xcpA2L('XCPSIM.a2l');
tlci = a2lfile.TransportLayerCANInfo
tlci = 

  TransportLayerCANInfo with properties:

                 BaudRate: 500000
              SamplePoint: 62
               SampleRate: 'SINGLE'
                BTLCycles: 8
                      SJW: 1
                 SyncEdge: 'SINGLE'
           MaxDLCRequired: []
              CANIDMaster: 1
    CANIDMasterIsExtended: 0
               CANIDSlave: 2
     CANIDSlaveIsExtended: 0

Data Types: xcp.TransportLayerCANInfo

This property is read-only.

UDP transport layer information, returned as an xcp.TransportLayerUDPInfo object. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
tlui = a2lfile.TransportLayerUDPInfo
tlui = a2lfile.TransportLayerUDPInfo

tlui = 

  TransportLayerUDPInfo with properties:

          Address: 2.1307e+09
    AddressString: '127.0.0.1'
             Port: 5555

Data Types: xcp.TransportLayerUDPInfo

This property is read-only.

TCP transport layer information, returned as a xcp.TransportLayerTCPInfo object.

Data Types: xcp.TransportLayerTCPInfo

This property is read-only.

Event names, returned as a cell array of character vectors. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
a2lfile.Events
ans =

  1×6 cell array

    {'Key T'}    {'10 ms'}    {'100ms'}    {'1ms'}    {'FilterBypassDaq'}    {'FilterBypassSt'}

Data Types: cell

This property is read-only.

Measurement names, returned as a cell array of character vectors. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
a2lfile.Measurements(10:15)
ans =

  1×6 cell array

    {'FW1'}    {'KL1Output'}    {'MaxChannel1'}    {'MinChannel1'}    {'PWM'}    {'PWMFiltered'}

Data Types: cell

This property is read-only.

Names of characteristics, returned as a cell array of character vectors. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
a2lfile.Characteristics(10:15)
ans =

  1×6 cell array

    {'a0'}    {'b0'}    {'c0'}    {'map1'}    {'map1Counter'}    {'map4_80_uc'}

Data Types: cell

This property is read-only.

Event information, returned as an array of xcp.Event objects. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
ei = a2lfile.EventInfo(1)
ei = 

  Event with properties:

                         Name: 'Key T'
                    Direction: 'DAQ'
                   MaxDAQList: 255
                ChannelNumber: 0
             ChannelTimeCycle: 0
              ChannelTimeUnit: 6
              ChannelPriority: 0
    ChannelTimeCycleInSeconds: 0

Data Types: xcp.Event

This property is read-only.

Measurement information, returned as a Map object. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
mi = a2lfile.MeasurementInfo
mi = 

  Map with properties:

        Count: 45
      KeyType: char
    ValueType: any

Data Types: containers.Map

This property is read-only.

Characteristic information, returned as a Map object. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
ci = a2lfile.CharacteristicInfo
ci = 

  Map with properties:

        Count: 16
      KeyType: char
    ValueType: any

Data Types: containers.Map

This property is read-only.

Axis information, returned as a Map object. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
ai = a2lfile.AxisInfo
ai = 

  Map with properties:

        Count: 1
      KeyType: char
    ValueType: any

Data Types: containers.Map

This property is read-only.

Container for characteristic objects, returned as a containers.Map object. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
rl = a2lfile.RecordLayouts
rl = 

  Map with properties:

        Count: 41
      KeyType: char
    ValueType: any

Data Types: containers.Map

This property is read-only.

Container for computation method objects, returned as a containers.Map object. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
cm = a2lfile.CompuMethods
cm = 

  Map with properties:

        Count: 16
      KeyType: char
    ValueType: any

Data Types: containers.Map

This property is read-only.

Container for ComputationTAB (conversion table) method objects used for interp, returned as a containers.Map object. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
ct = a2lfile.CompuTabs
ct = 

  Map with properties:

        Count: 0
      KeyType: char
    ValueType: any

Data Types: containers.Map

This property is read-only.

Container for ComputationVTAB (verbal conversion table) method objects used for enum, returned as a containers.Map object. For example:

a2lfile = xcpA2L('XCPSIM.a2l');
cvt = a2lfile.CompuVTabs
cvt = 

  Map with properties:

        Count: 2
      KeyType: char
    ValueType: any

Data Types: containers.Map

Introduced in R2013a