7.7.47. J1939 DM37 transmit (pj1939_Dm37Transmit)

Transmit a J1939/73 DM37 message containing the vehicle harmonised roadworthiness data. Refer to J1939-73 Feb2010 section 5.7.37 for details.

7.7.47.1. Supported targets

All targets

7.7.47.2. Required license

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

7.7.47.3. Description

A J1939/73 DM37 message is a fixed length message transmitted by a network node to the global network address. The DM37 message contents detail the system harmonised roadworthiness information. Direct support is provided (rather than using the pj1939_PgTransmit block).

7.7.47.4. Inports

  • sim_error_flag

    The simulation inport for the error_flag outport.

    Value type:Boolean
    Calibratable:No
  • force_transmission

    Set to 1 if the DM37 message should be transmitted in addition to the periodic transmission and regardless of any change in input data.

    Range: 0 or 1.

    Value type:Boolean
    Calibratable:No
  • priority

    J1939 priority of the DM37 message to be transmitted.

    Range: [0, 7]

    Value type:Integer
    Calibratable:No
  • snrw_count

    The number of components that the system has determined to be non-roadworthy. Refer to J1939-73 Feb2010 section 5.7.37.1 for details. A change of data on this inport causes transmission of a DM37 message. The transmission is delayed, if necessary, until the minimum inter-message interval has elapsed. Refer to J1939-73 Feb2010 section 5.7.37 for details of permitted transmission rates.

    Range: [0, 250]

    Value type:Integer
    Calibratable:No
  • continuous_mil

    A code indicating whether the system requires that the MIL be steady (continuous) burning. Refer to J1939-73 Feb2010 section 5.7.37.2 for details. A change of data on this inport causes transmission of a DM37 message. The transmission is delayed, if necessary, until the minimum inter-message interval has elapsed. Refer to J1939-73 Feb2010 section 5.7.37 for details of permitted transmission rates.

    Range: [0, 3]

    Value type:Integer
    Calibratable:No
  • mil_strategy

    A code indicating whether the system is configured to employ a discriminatory MIL display. Refer to J1939-73 Feb2010 section 5.7.37.3 for details. A change of data on this inport causes transmission of a DM37 message. The transmission is delayed, if necessary, until the minimum inter-message interval has elapsed. Refer to J1939-73 Feb2010 section 5.7.37 for details of permitted transmission rates.

    Range: [0, 3]

    Value type:Integer
    Calibratable:No
  • mil_activation_mode

    A code indicating the most severe form of MIL display required by the failure status the system or component. Refer to J1939-73 Feb2010 section 5.7.37.4 for details. A change of data on this inport causes transmission of a DM37 message. The transmission is delayed, if necessary, until the minimum inter-message interval has elapsed. Refer to J1939-73 Feb2010 section 5.7.37 for details of permitted transmission rates.

    Range: [0, 15]

    Value type:Integer
    Calibratable:No
  • incomplete_monitors

    The number of incomplete diagnostic monitors for a given sub-system or component. Refer to J1939-73 Feb2010 section 5.7.37.5 for details. A change of data on this inport causes transmission of a DM37 message. The transmission is delayed, if necessary, until the minimum inter-message interval has elapsed. Refer to J1939-73 Feb2010 section 5.7.37 for details of permitted transmission rates. The platform will limit the value to the range specified below. This range is chosen to match that of the 'Vehicle Incomplete Monitor Count' sent on DM36 message.

    Range: [0, 64255]

    Value type:Integer
    Calibratable:No

7.7.47.5. Outports

  • error_flag

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

    Value type:Boolean
    Calibratable:No

7.7.47.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.47.7. Notes

In order to meet the minimum transmission rate requirements in J1939-73 FEB2010 section 5.7.37, the block should be scheduled at a 0.1Hz or faster rate. It is recommended that the rate be faster than 1Hz in order that the transmission of DM37 messages is able to meet the maximum allowable frequency for those transmitted on change of input data. When there is no change in the data on the inports, and no forced transmission, the block will transmit the DM37 messages at the rate of 0.1Hz (1 message every 10 seconds).