Main Content

j1939ParameterGroup

Create J1939 parameter group

Description

example

pg = j1939ParameterGroup(database,name) creates a parameter group using the name defined in the specified database.

pg = j1939ParameterGroup(database,j1939TimeTable) creates parameter groups from the specified J1939 parameter group timetable. This allows you to convert parameter group timetables into arrays of parameter group objects to be used in code from earlier versions of the toolbox. For performance reasons, it is recommended that you work with timetables instead of parameter group objects.

Examples

collapse all

This example shows how to attach a database to a parameter group name and view the signal information in the group.

Create a database handle.

db = canDatabase('C:\j1939Demo.dbc');

Create a parameter group.

pg = j1939ParameterGroup(db,'PackedData')
pg = 

  ParameterGroup with properties:

   Protocol Data Unit Details:
   ---------------------------
                  Name: 'PackedData'
                   PGN: 57344
              Priority: 6
         PDUFormatType: 'Peer-to-Peer (Type 1)'
         SourceAddress: 50
    DestinationAddress: 255

   Data Details:
   -------------
             Timestamp: 0
                  Data: [255 255 255 255 255 255 255 255]
               Signals: [1x1 struct]

   Other Information:
   ------------------
              UserData: []

Examine the signals in the parameter group.

pg.Signals
ans = 

       ToggleSwitch: -1
       SliderSwitch: -1
       RockerSwitch: -1
    RepeatingStairs: 255
         PushButton: 1

Input Arguments

collapse all

Handle to CAN database, specified as a CAN database object. The specified database contains J1939 parameter group definitions.

Example: db = canDatabase('C:\database.dbc')

Parameter group name, specified as a character vector or string. The name must match the name specified in the attached CAN database.

Example: 'pgName'

Data Types: char | string

Output Arguments

collapse all

J1939 parameter group, returned as a parameter group object, with j1939.ParameterGroup Properties.

Introduced in R2015b