7.7.48. J1939 DM38 transmit (pj1939_Dm38Transmit)

Transmit a J1939/73 DM38 message containing the Harmonised Global Technical Regulation (GTR) description. Refer to J1939-73 Feb2010 section 5.7.38 for details.

7.7.48.1. Supported targets

All targets

7.7.48.2. Required license

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

7.7.48.3. Description

A J1939/73 DM38 message is a variable length message. The DM38 message contents detail the GTR description. Direct support is provided (rather than using the pj1939_PgTransmit block).

7.7.48.4. Inports

  • sim_error_flag

    The simulation inport for the error_flag outport.

    Value type:Boolean
    Calibratable:No
  • sim_transport_errors

    Simulation value of the outport transport_errors.

    Value type:Integer
    Calibratable:No
  • transmit

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

    Range: 0 or 1.

    Value type:Boolean
    Calibratable:No
  • priority

    J1939 priority of the DM38 message to be transmitted.

    Range: [0, 7]

    Value type:Integer
    Calibratable:No
  • dest_addr

    J1939 destination address for the DM38 message (This could be the source address of the corresponding PGN request, or the global address (255) if the request was sent to the global address). If use_dest_addr is false or a PDU2 message is shorter than 9 bytes, this value is ignored and the message is sent to the global address.

    Range: [0, 255]

    Value type:Integer
    Calibratable:No
  • use_dest_addr

    Whether to send the DM38 to a specified destination address. If false (0), the message will always be sent to the global address. Set to true (1) to allow the message to be sent to a specific destination address, such as the source address of a PGN request.

    Range: 0 or 1.

    Value type:Boolean
    Calibratable:No

7.7.48.5. Outports

  • error_flag

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

    Value type:Boolean
    Calibratable:No
  • transport_errors

    Saturated count of transport errors (timeout or aborts) for this message.

    Range: [0, 255]

    Value type:Integer
    Calibratable:No

7.7.48.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
  • GTR description

    A description of the UN/ECE WWH OBD Global Technical Regulation (GTR) to which the sub-system or component complies. See J1939-73 Feb2010 section 5.7.38.1 for details. The entered string must be enclosed within single quotes. The single quotes are not, however, included in the transmitted string. The platform will limit the individual character ASCII values to the range specified below. Should a character fall outside, it is rejected and no further characters are processed. The platform will also limit the string length to the range specified below.

    Range (ASCII character): [0, 127]

    Range (string length): [0, 200] characters

    Value type:String
    Calibratable:No

7.7.48.7. Notes

None.