7.7.33. J1939 DM7 decode (pj1939_Dm7Decode)

Decodes the contents of a received J1939/73 DM7 message.

7.7.33.1. Supported targets

All targets

7.7.33.2. Required license

EXT_DIAG (Extended diagnostics library). (See Section 2.3, “Licensed Features”.)

7.7.33.3. Description

A J1939/73 DM7 message is a fixed length message. The purpose of a DM7 message is to command tests or last measured test results. Direct blockset support is provided (rather than relying on the pj1939_PgReceive block).

Refer to J1939-73 FEB2010 section 5.7.7 for details of the DM7 message.

7.7.33.4. Inports

  • sim_test_commanded

    The simulation value for the outport test_commanded.

    Value type:Boolean
    Calibratable:No

7.7.33.5. Outports

  • test_commanded

    Set to 1 (true) if a DM7 message has been received containing a commanded test which matches the Test identifier only (when parameter Test identifier is in the range [1, 64]) or if a DM7 message has been received containing a commanded test which matches the Test identifier and Suspect parameter number and Failure mode indicator parameters (when parameter Test identifier is in the range [247, 250]). Note that this is a one-shot pulse which will remain high only until the next block iteration.

    Value type:Boolean
    Calibratable:No
  • source_addr

    The source address of the DM7 message received.

    Value type:Integer
    Calibratable:No
  • dest_addr

    The destination address of the DM7 message received.

    Value type:Integer
    Calibratable:No

7.7.33.6. Mask parameters

  • J1939 Channel

    The logical J1939 channel on which to receive the request. Must be a channel declared with a pj1939_ChannelConfiguration block.

    Value type:Integer
    Calibratable:No
  • Test identifier

    The value of the TID of the commanded test to match against. In the case where a DM30 response is required, the parameters Suspect parameter number, Failure mode indicator and Test identifier uniquely identify the commanded test. If a DM8 response is required then only the Test identifier is needed.

    Range: [0, 255]

    Value type:Integer
    Calibratable:No
  • Suspect parameter number

    The value of the SPN of the commanded test to match against. The parameters Suspect parameter number, Failure mode indicator and Test identifier uniquely identify the commanded test. Only applicable if the Test identifier parameter is in the range [247, 250]. A DM30 response is required when the requested DM7 test consists of a valid SPN/FMI/TID combination.

    Range: [0, 524287]

    Value type:Integer
    Calibratable:No
  • Failure mode indicator

    The value of the FMI of the commanded test to match against. The parameters Suspect parameter number, Failure mode indicator and Test identifier uniquely identify the commanded test. Only applicable if the Test identifier parameter is in the range [247, 250]. A DM30 response is required when the requested DM7 test consists of a valid SPN/FMI/TID combination.

    Range: [0, 31]

    Value type:Integer
    Calibratable:No
  • Sample time

    The periodicity of the block execution.

    Range: [0.001, 3600] seconds

    Value type:Real
    Calibratable:No

7.7.33.7. Notes

None.