This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.


Look up value of table text for signal


vtt = valueTableText(db,MsgName,SignalName,TableVal)



vtt = valueTableText(db,MsgName,SignalName,TableVal) returns the text from the value table for a specified message signal.


collapse all

Create a CAN database object, and select a message and signal to retrieve their table text.

Identify a message.

db = canDatabase('J1939DB.dbc');
m = db.MessageInfo(1)
m = 
             Name: 'A1'
          Comment: 'This is a A1message'
               ID: 419364350
         Extended: 1
            J1939: [1x1 struct]
           Length: 8
          Signals: {2x1 cell}
       SignalInfo: [2x1 struct]
          TxNodes: {'AerodynamicControl'}
       Attributes: {4x1 cell}
    AttributeInfo: [4x1 struct]

Select one of the message signals.

s = m.signalInfo(2)
s = 
             Name: 'EngGasSupplyPress'
          Comment: 'Gage pressure of gas supply to fuel metering device.'
         StartBit: 8
       SignalSize: 16
        ByteOrder: 'LittleEndian'
           Signed: 0
        ValueType: 'Integer'
            Class: 'uint16'
           Factor: 0.5000
           Offset: 0
          Minimum: 0
          Maximum: 3.2128e+04
            Units: 'kPa'
       ValueTable: [4x1 struct]
      Multiplexor: 0
      Multiplexed: 0
    MultiplexMode: 0
          RxNodes: {'Aftertreatment_1_GasIntake'}
       Attributes: {3x1 cell}
    AttributeInfo: [3x1 struct]

Retrieve second table text for specified signal.

vtt = valueTableText(db,m.Name,s.Name,2)
vtt =
pump error

Input Arguments

collapse all

CAN database, specified as a CAN database object.

Example: db = canDatabase(_____)

Message name, specified as a character vector or string. You can view available message names from the db.Messages property.

Example: 'A1'

Data Types: char | string

Signal name, specified as a character vector or string. You can view available signal names from the db.MessageInfo(n).Signals property.

Example: 'EngGasSupplyPress'

Data Types: char | string

Table value, specified as a numeric value.

Example: 2

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Output Arguments

collapse all

Table text, returned as a character vector.

Introduced in R2015b