Log J1939 data

J1939 is a protocol used in most heavy-duty vehicles (trucks, buses, tractors, …).

In this section we outline how to log J1939 data with your CANedge.

Note

We recommend that you read our J1939 intro before proceeding

Configure your device

J1939 data is generally broadcast, meaning that you do not need to request it. Instead, you can use the default Configuration File with automatic bit-rate detection.

Our section on reducing your log file size also contains guidance on J1939 PGN filtering.

Record J1939 data

To log J1939 data from a heavy-duty vehicle, you need to find a suitable way to connect the CANedge. Below are the most common methods:

  1. DB9-J1939: This lets you record J1939 data from most trucks, buses, engines, tractors
  2. DB9-CAT: This lets you log J1939 data from some Caterpillar vehicles/engines
  3. DB9/DB9-J1939: This lets you log 2 x J1939 networks in some vehicles (e.g. tractors)
  4. DB9/DB9-OBD2: This lets you log both J1939/OBD2 in some trucks/buses
  5. Contactless CH1 / CH2: This lets you log J1939 data directly from the CAN high/low harness

Once you have identified which adapter cable to use you can follow below steps:

  1. Connect the CANedge to your J1939 application via the adapter cable
  2. Verify that the device turns on and logs data (CH1 LED and MEM LEDs blink)
  3. Disconnect the device from power and extract the SD card
  4. Open the MF4 in asammdf and display the raw CAN trace - it should look as below:
asammdf GUI J1939 raw data

DBC decode J1939 data

To DBC decode J1939 data you need the associated DBC file. If you are not the equipment manufacturer, you can purchase our J1939 DBC file, which contains 1800+ PGNs and 12000+ SPNs. For most J1939 networks, this lets you decode the majority of the parameters.

You can decode your data via the processing tools - we recommend to start with asammdf.

asammdf GUI J1939 decoded data

Advanced: Log J1939 on-request data

In some cases, you may wish to log on-request J1939 data. To do so, you need to transmit the relevant J1939 request frame into the CAN bus - see also our J1939 simple intro.

An example is PGN 65253 (FEE5) which contains the SPN Engine Hours. Below we show what the transmit message could look like for this particular PGN. There are two key things to note:

  1. The transmit frame CAN ID is 18EAFFFA, reflecting the J1939 request PGN 59904 (EA00)
  2. Note that we use a ‘global request’ (0xFF) and an arbitrary source address (0xFA)
  3. The data contains the requested PGN FEE5 (note the byte ordering to E5FE)
CANedge J1939 on-request transmit frame

Note

A vehicle might not respond to your request - and caution should be taken when transmitting[1]

Advanced: Multi-frame J1939 data (J1939 TP)

J1939 often involves multi-frame responses as per J1939 TP, which means that data has to be reassembled before it can be DBC decoded. You can DBC decode and visualize multi-frame data using the MF4 decoders and e.g. Grafana dashboards

Advanced: Decode J1939-73 DM1 (DTCs)

If you need to DBC decode and visualize J1939-73 DM1 messages to extract Diagnostic Trouble Codes (DTCs) you should use the MF4 decoders. In particular, we recommend in this case to use Grafana-Athena as this enables relevant extensions like calculated signals (incl. a DM1-specific example) and event detection. See also our J1939-73 DM1 Grafana-Athena playground:

Grafana J1939-73 dashboard playground
[1]Be careful if transmitting data onto a vehicle while the ignition is off (as this may ‘wae up’ the ECUs and cause battery drain). If your device remains powered when the ignition is off and you need to transmit data, we recommend using a control signal to start/stop transmission dynamically (see the OBD2 section for examples).