7.7.37. J1939 DM21 transmit (pj1939_Dm21Transmit)

Transmit a J1939/73 DM21 message containing the diagnostic readiness 2 data.

7.7.37.1. Supported targets

All targets

7.7.37.2. Required license

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

7.7.37.3. Description

A J1939/73 DM21 message is a fixed length message transmitted by a network node to the specified destination address. The DM21 message contents detail the diagnostic readiness data (part 2). Refer to J1939-73 Feb2010 section 5.7.21 for details. Direct support is provided (rather than using the pj1939_PgTransmit block).

7.7.37.4. Inports

  • sim_error_flag

    The simulation inport for the error_flag outport.

    Value type:Boolean
    Calibratable:No
  • transmit

    Set to 1 to transmit a DM21 message, set to zero otherwise.

    Range: 0 or 1.

    Value type:Boolean
    Calibratable:No
  • priority

    J1939 priority of the DM21 message to be transmitted.

    Range: [0, 7]

    Value type:Integer
    Calibratable:No
  • mil_on_time

    The accumulated count (in minutes) run by the engine while the MIL is activated. Refer to J1939-73 Feb2010 section 5.7.21.3 for details. The platform will limit the transmitted value to the range specified below.

    Range: [0, 64255] minutes

    Value type:Integer
    Calibratable:No
  • mil_on_distance

    The distance travelled (in kilometres) while the MIL is activated. Refer to J1939-73 Feb2010 section 5.7.21.1 for details. The platform will limit the transmitted value to the range specified below.

    Range: [0, 64255] kilometres

    Value type:Integer
    Calibratable:No
  • time_since_dtc_clear

    The engine running time (in minutes) accumulated since emission related DTCs were cleared. Refer to J1939-73 Feb2010 section 5.7.21.4 for details. The platform will limit the transmitted value to the range specified below.

    Range: [0, 64255] minutes

    Value type:Integer
    Calibratable:No
  • dist_since_dtc_clear

    The distance accumulated (in kilometres) since emission related DTCs were cleared. Refer to J1939-73 Feb2010 section 5.7.21.2 for details. The platform will limit the transmitted value to the range specified below.

    Range: [0, 64255] kilometres

    Value type:Integer
    Calibratable:No
  • dest_addr

    J1939 destination address for the response message (usually the source address of the corresponding request).

    Range: [0, 254]

    Value type:Integer
    Calibratable:No

7.7.37.5. Outports

  • error_flag

    Set to 1 when the DM21 message could not be buffered for transmission, or if a previous request to send a DM21 message has not completed.

    Value type:Boolean
    Calibratable:No

7.7.37.6. Mask parameters

  • J1939 Channel

    The logical J1939 channel on which to transmit. Must be a channel declared with a pj1939_ChannelConfiguration block.

    Value type:Integer
    Calibratable:No

7.7.37.7. Notes

None.