DG Diagnostics (DGD) : User Manual For Version 2.82
DG Diagnostics (DGD) : User Manual For Version 2.82
DG Diagnostics (DGD) : User Manual For Version 2.82
This software works only in conjunction with Dearborn Group Technology RP1210 devices. Any attempt to modify the
software, or PC environment, so that this program would connect and use a non-DG RP1210 device will be considered a
breach of the programs’ copyright.
IMPORTANT
To ensure your success with this product, it is essential that you read this document carefully before using the hardware.
Damage caused by misuse of the hardware is not covered under DPA product warranty.
When using this manual, please remember the following:
This manual may be changed, in whole or in part, without notice.
DG Technologies assumes no responsibility for any damage resulting from the use of this software.
Specifications presented herein are provided for illustration purposes only and may not accurately represent the
latest revision of software.
No license is granted, by implication or otherwise, for any patents or other rights of Dearborn Group, Inc. or of any
third party.
The “DG” square logo is a registered trademark of Dearborn Group, Inc. Other products that may be referenced in this
manual are trademarks of their respective manufacturers.
This product is for use with the DG Technologies DPA Product line, which has been awarded the following U.S. Patents:
DG Technologies
33604 West 8 Mile Road
Farmington Hills, MI 48335
Phone (248) 888-2000
Fax (248) 888-9977
www.dgtech.com
[email protected]
[email protected]
It is essential that the user read this document carefully before using the hardware.
DG Diagnostics is to be used by those trained in the troubleshooting and diagnostics of light-duty through heavy-duty
vehicles. The user is assumed to have a very good understanding of the electronic systems contained on the vehicles
and the potential hazards related to working in a shop-floor environment.
DG Technologies understands that there are numerous safety hazards that cannot be foreseen, so we recommend that
the user read and follow all safety messages in this manual, on all of your shop equipment, from your vehicle manuals, as
well as internal shop documents and operating procedures.
Always block drive, steer, and trailer wheels both front and back when testing.
Use extreme caution when working around electricity. When diagnosing any vehicle, there is the risk of electric
shock both from battery-level voltage, vehicle voltages, and from building voltage.
Do not smoke or allow sparks or open flames near any part of the vehicle fueling system or vehicle batteries.
Always work in an adequately ventilated area, and route vehicle exhaust outdoors.
Do not use this product in an environment where fuel, fuel vapor, exhaust fumes, or other potentially hazardous
liquids, solids, or gas/vapors could collect and/or possibly ignite, such as in an unventilated area or other confined
space, including below-ground areas.
DG Diagnostics is a highly useful, general purpose diagnostics program provided “free-of-charge” to DG’s DPA
customers.
This program provides the essentials needed in a generic J1708/J1587 and CAN/J1939 diagnostics program, such as:
DG Diagnostics is an outstanding “triage” tool that can be ran immediately when connecting to a vehicle. If faults or other
displayed data suggest that running an OEM application is required, that OEM application can be started from DG
Diagnostics without having to go through the Windows “Start” menu.
When the DG Diagnostics program is first launched, the program defaults to the “Home” tab. This tab is where you initiate
and terminate your DG Diagnostics session. The “Run OEM Diagnostics”, “Truck Data Report”, “Launch PDF”, “Exit
Application” and “Help” buttons are visible at all times. The main components on the “Home” tab are described in the
following sections. Note that the last adapter that you connected with will be defaulted the next time you run the
application.
3.1. Vendor
Depending on which DPA drivers you have installed, the field will display:
DG121032 – Dearborn Group RP1210A
o This entry covers the DPA 4 Plus and all prior DPA versions (II, III, III Plus, 4, etc).
DPA4PSA – DPA 4 Plus (Single Application)
o This entry is the latest driver set for the DPA 4 Plus and allows only one RP1210 application to be ran
at a time. It does not support any prior adapters.
DPA4PMA – DPA 4 Plus (Multi Application)
o This entry is the latest driver set for the DPA 4 Plus and allows multiple RP1210 applications to be
run at the same time. It does not support any prior adapters.
DGDPA5MA – DPA 5 (Multi Application)
o This entry is the latest driver set for the DPA 5 and allows multiple RP1210 applications to be run at
the same time. It does not support any prior adapters.
DGDPA5SA – Dearborn Group DPA 5
o This entry is for the DPA 5 series of adapters and allows only one RP1210 application to be ran at a
time. It does not support any prior adapters.
DR121032 – Allison Transmission Specific DPA Drivers (DPA 4, DPA 4 Plus, DPA 5)
o This entry will allow a user that has the Allison Specific drivers installed to use their DPA. The latest
DR121032 release will cover the DPA 5, DPA 4 Plus, and the DPA 4 in a single application mode.
Select the correct DPA drivers for the DPA you are going to use. Note that the DG Diagnostics program will only work
with Dearborn Group DPA Adapters.
When clicking on the “Connect” button, the DG Diagnostics application will attempt to initiate a diagnostics connection
on both the J1708/J1587 and CAN/J1939 data buses simultaneously using the “Vendor” and “Device” selected. A
message will appear in the “Status Message Display” as to whether the connection was successful or not. If
successful, the button will change to a “Disconnect” button. When clicked, the diagnostics session on both the
J1708/J1587 and CAN/J1939 data buses will be terminated. The button then changes back to a “Connect” button.
The J1939 Address field shows the J1939 address that has been claimed if the program has connected to the J1939
data bus through the DPA.
You can run an OEM application at any time by pressing the "Run OEM Diagnostics" button at the bottom of the
screen. More information is in the section covering the “OEM Apps” screen.
You can configure and run Adobe reader on any PDF file. OEMs typically include PDF files with their diagnostic
programs, and DGD can be configured to launch Adobe on those PDF files without having to enter into the OEM
diagnostic application first. This feature was added on request by the US Army.
After a successful “Connect” and data is seen on a data bus, the fields on this form will “slowly” populate as the responses
to applications requests come into the application (it could take 30 seconds or more). This screen is described in the
following sections.
Not all vehicles will send faults on both the J1939 and J1587 data buses, and not all fault codes may be displayed. OEMs
have many “proprietary fault codes” that they do not publish on the generic data bus and are available only through their
diagnostic application or their “heads up display/message center”. This is not a defect in the DG Diagnostics program!
There are three fault lamps (which are initially white, but will “illuminate” if turned on by a vehicle controller):
1. Stop Lamp (red). This lamp is used to relay trouble code information that is of a severe enough condition that it
warrants stopping the vehicle or equipment. Most equipment manufacturers populate this lamp on the dashboard
or control panel.
2. Warning Lamp (amber). This lamp is used to relay trouble code information that is reporting a problem with the
vehicle system but the vehicle need not be immediately stopped. Most equipment manufacturers populate this
lamp on the dashboard or control panel.
3. MIL Lamp (amber). A lamp used to relay only emissions-related trouble code information. This lamp is illuminated
when there is an emission-related trouble code active.
This button also sends out a DM11 message (“Diagnostic Data Clear/Reset For Active DTCs”) to the “global” J1939
address (255) as well as is sent to each individual ECU address. For OBD regulated products, DM11 is used to clear
all applicable diagnostic data. Emission related components shall clear/reset diagnostic data for all active, pending,
and previously active DTCs. For more information on DM11, see the J1939-73 document.
Clearing faults is a “request” that some ECUs do not honor. This is not a defect in the DG Diagnostics program!
Select the “Clear Active” or “Clear Inactive” entry, enter your source address (typically 249 – Offboard PC #1), the
destination address (0 – Engine, 3 – Transmission, 11 – ABS), and the SPN/FMI to clear. The response from the
ECM will appear below after pressing the “Send” button. Refer to your J1939/73 document for more information on
the DM22 message.
Clearing faults is a “request” that some ECUs do not honor. This is not a defect in the DG Diagnostics program!
This button will bring up a dialog box that will display any J1939 “pending” faults for controller responding to a request
for the DM6 message. For more information on DM6 or the fields displayed on this dialog box, see the J1939-73
document.
This button will bring up a dialog box that will display any J1939 “freeze frames” faults for controllers having faults.
This information comes from the DM4 message. For more information on DM4 or the fields displayed on this dialog
box, see the J1939-73 document.
After a successful “Connect” and data is seen on a data bus, the fields on this form will “slowly” populate as the responses
to applications requests come into the application (it could take 30 seconds or more). This screen is described in the
following sections.
This display grid shows information about the current vehicle and the controllers on the vehicle. Not all fields will be
populated, as some controllers choose not to respond to the various requests. The fields are as follows:
MID – J1587 Message Identifier (Source Address) of the Electronic Control Unit.
MID Description – Textual Representation for the “MID” Field.
VIN – Vehicle Identification Number.
Make – Vehicle Maintenance Reporting Standard (VMRS) Code for the Manufacturer of the Component.
Model – Unique ID Number Assigned by the Manufacturer of the Component.
Serial # – Unique Serial Number Assigned by the Manufacturer of the Component.
Unit # - Sometimes Used by Fleets to Represent Asset (Door) Numbers.
Software ID - Field Assigned by the Manufacturer of the Component to Indicate What Version of Software is
Being Used by the Component.
This screen is used to view common “dashboard” type of parameters in both Metric and English units from both the J1939
and J1587 data buses.
Note that not all vehicles will populate the screens in the same way, as some engines, transmissions, ABS systems and
other controllers report different parameters than others. This is not a defect in the DG Diagnostics program!
NOTE: The command used to reset trip data (PGN 56832) is a “REQUEST” and the engine or other controllers
storing trip data do not have to respond positively. Different vehicles will respond differently. Some engines require
their diagnostics software to reset trip data. This is not a defect in DG Diagnostics!
NOTE: Trip reset is a J1939 only parameter. If a vehicle or engine is not on the J1939 data bus, executing this
command will not work.
When you press the “Reset J1939 Trip 1 Parameters” you will see the following box if no traffic has been detected on the
J1939 data bus. After pressing Ok, the program sends the RESET command. If no data has been seen, most likely the
RESET is not going to work anyway.
If traffic has been seen on the J1939 bus it immediately sends out the RESET command. The screen will show that the
RESET command has been sent to all addresses that are transmitting on the J1939 data bus. As acknowledgment
messages come in from the different controllers, the screen should look something like this. GREEN means that the
controller responsible for the resetting of trip parameters has “agreed” to reset them. RED means they did not. Normally,
just the engine controller (ECM #0) will respond. If all controllers responded RED, then trip parameters cannot be reset
and you will probably have to use an OEM diagnostics program to do so.
This screen is used to view common “total vehicle data” parameters in both Metric and English units from both the J1939
and J1587 data buses. It also allows a user to display the J1939 engine configuration message, which shows information
about programmed torques and speed information.
Note that not all vehicles will populate the screens in the same way, as some engines, transmissions, ABS systems and
other controllers report different parameters than others. This is not a defect in the DG Diagnostics program!
Press the “Display Engine Configuration (EC1)” button and the following information dialog will be displayed. This data
contains a lot of information depicting how the engine is configured. For more information on the EC1 message (PGN
#65251), please refer to J1939-71.
This screen is used to view common “total vehicle trip data” parameters in both Metric and English units from the J1939
data bus. DG Diagnostics displays all possible trip data defined in the J1939 and J1587 specifications as of November of
2011. Many of these parameters are new, and may not be displayed for several years. If you need a particular
parameter, please contact your local vehicle dealership, they may be able to configure the ECM to send it.
Note that not all vehicles will populate the screens in the same way, as some engines, transmissions, ABS systems and
other controllers report different parameters than others. This is not a defect in the DG Diagnostics program!
This screen is used to set up your OEM applications that can be run by double clicking on a fault or component in one of
those grids, or by pressing the “Run OEM Diagnostics” button at the bottom of the screen. Note that when the program
first runs, the program writes configuration information to an INI file. This INI contains the default program information for
running of OEM applications like CAT, Cummins, WABCO, etc. If the default entries do not work (programs installed in a
non-standard location), they can be edited. You can also add or delete OEM applications.
You can also add PDF files that can be launched using the “Launch PDF” button.
The fields will be explained later in this chapter, after explaining how the “Run OEM Diagnostics” concept works.
You can run an OEM application at any time by pressing the "Run OEM Diagnostics" button at the bottom of the screen,
or by double clicking on a fault or component in one of those grids. If the fault or component that you selected matches
up to a "Make" (a TMC VMRS code), then DG Diagnostics will disconnect from the data buses and launch the OEM
application required by that “Make”.
Understanding the “Make” to “OEM Application” concept is easier explained by showing the US Marine Corps version of
DG Diagnostics (which has the faults and components grids close together). The “J1708/J1587 Faults” grid shows MID
128 (Engine #1) has a fault code. The “Component Information” grid shows that for “MID 128” the VMRS “Make” is
CTRPL (Caterpillar). If the user double clicked either line, the CAT ET application (if it were installed) would launch.
Followed by the “OEM Diagnostics Launcher” screen. Note that only applications that are installed on the PC’s hard drive
will appear (meaning DG Diagnostics has verified that the executable application physically exists on the hard drive for
that entry). Note that on this particular PC, Cummins INSITE, CAT ET, and the DPA 5 Users manual (PDF) installed.
This is the physical executable program for the application. This includes a drive, path, and EXE file name.
Some OEM applications (i.e. Bendix ACOM) require specific command line parameters. Enter those here.
9.6. Type
If it is an executable OEM program, select EXE. If you are configuring a PDF, enter PDF.
This screen is used to control data recording and playback as well as logging of parameters. The screen is set up into
three sections accordingly.
This program can record both J1939 and J1587 raw data messages to an ASCII text file of your choice. This file
can then be played back, or examined/decoded by hand.
Click the “File Name” button to select which file the parameters will be logged to.
Click the On/Off checkbox to turn data recording on or off (a check means “On”).
o If you want GPS information in your log file, you must first start the GPS system (see the section on
GPS and Mapping below).
The default data recording file is the same directory in which the DG Diagnostics executable resides (typically
C:\Program Files\Dearborn Group Products\DPA 4 Plus\Utilities) and is named “datalog.txt”.
For experienced databus engineers, the file format is very easy to parse programmatically or by hand, as seen
below:
Rx J1939 TS=[ 40249] GPS=[3745.779400N_pc|-8415.656400W_pc|284.00000M_pc|UNK|UNK|02/04/11_pc|23:43:07.000UTC_pc] Chan=[ 1] EB=[off]
PGN=[65217|0xFEC1] PF=[0xFE|254] PS=[PDU2-GE|0xC1|193] HOW=[N/A] P=[3] SRC=[ 0] DST=[ 0] DL=[ 8]
DATA-HEX[80][84][1E][00][80][84][1E][00]
This program can play back a data file that was recorded by DG Diagnostics. When playback is in progress, all
fields in the program “react” to the data as if it DG Diagnostics were actually “on” the data bus when the data was
being recorded. Therefore you can record a fault scenario (such as a rough shift) and then send it to the
transmission OEM, where they can see exactly what you were seeing and determine what happened. The
program can playback the file in two ways (based on the “Playback Method” field):
1. Click the “File Name” button to select which file the program will playback from.
a. A dialog box will appear stating how many messages were on both the J1587 and J1939 buses.
NOTE: During a playback session, all features of the program (data logging, parameter logging, reporting,
launching of OEM applications) are active.
To make the "playback" appear as real as possible, you can configure the “percent of the wait time". For
example, if there were 500 milliseconds between two messages, the amount of sleep time that the program
actually does is “DelayBetweenMessages * PercentageOfWaitTime”. If the percent of wait time was set to 20%,
then the wait would be 100 milliseconds. We have found that about 30%-40% makes the playback externally look
"real", and 60%-70% makes playback internal look "real".
10.6. Playing Back GPS Data to Serial Port (RMC and GGA)
Some developers of Telematics systems use DG Diagnostics with a NMEA 0183 compliant device to record GPS
information in with the logged data. These developers can now use DGD to play back that GPS information to a
serial port to simulate being connected to a NMEA 0183 compliant device. If you also want to do this, you select
the COM Port and Baud Rate and then check the Playback GPS Data to COM Port radio button. DG
Diagnostics will turn each message with GPS data into a RMC and GGA message and transmit that on the COM
port selected.
This program will record all monitored J1587 and J1939 parameters found on the “Total Truck Data”, “Total Trip
Data” and “Dynamic Truck Data” tabs to a Comma Separated Values (CSV) file of your choosing. This file can
later be opened by Microsoft Excel or any other program that can handle reading of a CSV file.
Some fleets with onboard computers are currently using this feature to record potential fuel theft situations, driver
performance in general, as well as long idling periods.
Click the On/Off checkbox to turn data recording on or off (a check means “On”).
Click the “File Name” button to select which file the parameters will be logged to.
Change the value in the “Seconds” edit box to reflect how often parameters are to be logged.
The default data recording file is the same directory in which the DG Diagnostics executable resides and is
named “parameterlog.csv”.
As mentioned above, DG Diagnostics can be configured to use an external NEMA 0183 compliant GPS device to record
the GPS location in with logged data (see GPS and Mapping section). This makes it very easy for someone to log a fault
or anomaly in a strange setting (i.e. at high altitude) where that fault might be intermittent and then send that data log back
to the OEM to help remedy the situation. Also the use of the GPS allows fleets to do driver tracking without having to
have a more expensive tracking system on the vehicle.
Note that the device (even though it may be a USB device) needs to be configured to a “virtual” COM port. The devices
that DG Technologies used initially for the development of this feature are from the Pharos company
(http://www.pharosgps.com), and these devices can be found in copies of Microsoft Streets and Trips
(http://www.microsoft.com/streets/en-us/default.aspx ) for under USD$75. When you install Streets and Trips, the
installation automatically creates the virtual COM port. If you use another GPS device, refer to its manual on how to
configure it into a COM port.
Dots DMS
Decimal Degrees
Degrees, Minutes, Seconds as Defined by NEMA 0183 Degrees only. Typical format used by mapping
This is the RAW data format returned from the GPS. programs. A (-) negative sign in Latitude indicates
South and in the Longitude field indicates West.
Satellites Used is the number of satellites used for the GPS fix. This changes based on location.
Satellites in View is the number of satellites currently in view of the GPS.
Data Valid comes back from the GPS and tells whether or not it has enough information to give a good fix.
Satellite Fix Quality comes from the GPS (GPS or Differential GPS).
Date and Time called for in NEMA are defaulted to UTC time.
For more information on GPS devices, you can Google “NEMA 0183”, and you can also refer to Wikipedia
regarding latitudes and longitudes.
If you are connected to the internet while you engage the GPS system or start playing back of data that has GPS
information in the data, DG Diagnostics will use the Google Maps Application Programming Interface (API) to display map
data. There are different map types and different zoom levels that can be chosen. For more information on the mapping
types (roadmap, satellite, terrain, and hybrid), you can Google “Google MAPS API”. You can also control the zoom level.
This screen will display a list of all J1939 PGNs and J1708/J1587 PIDs being broadcasted and those being sent in
response to DGD requests, and the raw data associated with those PGNs and PIDs. The engine distributor that this
screen was initially developed for has been asked several times by the engine manufacturer to view the raw data being
sent and then “hand decode” the data bytes and provide feedback.
This screen also addresses another need of DG customers, just obtaining a list of PGNs and PIDs that a vehicle sends.
This dialog box allows the user to request a J1939 PGN (PGN to Request field) using the J1939 Request PGN
(59904) from all controllers (Destination Address To Use = 255), or from an individual controller (i.e. Engine:
Destination Address To Use = 0).
Since some controllers may not respond to Offboard Diagnostics PC #1 (249), or Offboard Diagnostics PC #2 (250),
you can also add the source address you would like to use for the request.
If a controller responds, the raw data will show up in the PGNs/PIDs tab, and in the Truck Data Report.
The PGN request dialog “requests” information. Some controllers may choose not to respond; therefore the data may
not show up in the grid. This is not a defect in the DG Diagnostics program!
This dialog box allows the user to request a J1587 PID (PID to Request field) using the J1587 Request PID (0). This
message will be sent to all controllers.
Since some controllers may not respond to Offboard Diagnostics PC #1 (172), you can also add the source address
(MID) you would like to use for the request.
If a controller responds, the raw data will show up in the PGNs/PIDs tab, and in the Truck Data Report.
The PID request dialog “requests” information. Some controllers may choose not to respond; therefore the data may
not show up in the grid. This is not a defect in the DG Diagnostics program!
DG Diagnostics is evolving in the area of displaying more emissions-related diagnostic data parameters. This screen
displays DM12 (“Emissions-Related Active Diagnostic Trouble Codes”) as well as DM23 (“Previously Active Emission
Related Faults”). For more information in emissions related faults, please refer to the J1939-73 document, or contact your
vehicle manufacturer.
The Stop/Warning/MIL lamps act exactly the same as they do on the “Faults” tab.
To clear any faults on this screen, go to the “Faults” tab and press the “Clear J1939 Faults (DM3/DM11)” button.
DM24 is an emissions related parameter set that is used to identify SPNs supported by the product for DM25, test
results, expanded freeze frame and data stream messages. More information can be found on this in the J1939-73
document. The screen labels are as follows.
DG Technologies has placed a lot of effort into providing you with a high-quality, generic diagnostics utility that we provide
“free-of-charge”. We appreciate and value your business and we hope that you will take a minute to register the DG
Diagnostics product with us.
If you take the time to register, we will e-mail you with updates to the DPA drivers or to DG Diagnostics, as well as
subscribe you to our DG Networker e-newsletter. If you select the “I would like to beta test future versions of DG
Diagnostics” radio button, we will also e-mail you with beta versions of DG Diagnostics so that you can provide us with
feedback and potential bug reports. Our beta testers have provided great feedback that culminated in the many changes
and enhancements that were added to DG Diagnostics over the years.
NOTE: Your personal information will not be shared in any way with any third party outside of
DG Technologies. We value your privacy, as we value our own. We will not “spam” you with
unsolicited e-mail other than the occasional periodic DPA/DGD updates or the DG Networker
newsletter. You can expect to receive one or two e-mails per quarter.
We would like to know who our users are, and we would like to have your comments on what we can do to make the DG
Diagnostics and DPA products better for you. Please feel free to e-mail us with suggestions to [email protected]
and we will look at your request for a potential future version of the product.
When the user presses the “Truck Data Report” button, the user will be prompted to save the report as an HTML file
that can later be printed, e-mailed, or stored. The user will then be prompted for a sub-title for the report along with
allowing the user to configure which sections of the report they want to see. This allows the technician to provide a
vehicle ID number or other pertinent data to the title section of the report.
Note that the configuration will be saved for the next time the user wants to produce a report.
The HTML is formatted in such a way as to be easily parsed by a fleet’s IT department. DG knows of several fleets
that are taking this report, parsing out the data, and then storing this information in their asset database.
This program is provided “AS IS” and is “free-of-charge” for DPA product owners. It was intended to be a value-added
feature to enhance the value of the Dearborn Protocol Adapter (DPA) product line.
DG Technologies disclaims all warranties, either expresses or implied, including any implied warranty of merchantability
or fitness for any particular purpose. DG Technologies shall have no liability to anyone for incidental or consequential
damages for merchandise which is provided "AS IS".
DG Technologies makes no warranty as to the performance of this product. DG Technologies has placed this program
through extensive testing, however as with any software, there could be deficiencies. Therefore we cannot guarantee that
any parameters displayed are accurate.
We hope that you enjoy this tool and find it of value. If you find deficiencies, or have requests for the addition of non-
OEM-proprietary functionality, please do not hesitate to contact us at:
DG Technologies
Attention: DPA Product Manager
33604 West 8 Mile Road
Farmington Hills, MI 48335
Phone (248) 888-2000
www.dgtech.com
[email protected]