CAN-Viewer

446 301 585 0 (de)

446 301 599 0 (en)
of version 1.10
Operating Instructions

2nd Edition

This publication is not subject to any update service.

You will find the new version in INFORM under
www.wabco-auto.com

© 2010 WABCO



The right of amendment is reserved

Version 002/03.10
8150101183 815 010 118 3(en)
 CAN-Viewer Table of Contents

Table of Contents

1 General safety instructions 3 4.8 Creating / Editing an identifier 11

4.9 Creating a configuration file with your
2 Introduction 4 own settings 12
2.1 CAN-VIEWER 4 4.10 Loading your own configuration file 12
2.2 CAN Bus 4 4.11 Recording and saving a protocol with
CAN messages to a file 12

3 Program surface 5
5 Administration 13

4 Application of the CAN-Viewer 8 5.1 Program settings 13

4.1 Set-up of cable connection to vehicle 5.2 Creating a configuration file for
via ISO 763 (7-pin) 8 decoding CAN messages in plain text 13
5.2.1 Section [FileInfo] 14
4.2 Set-up of cable connection to vehicle
via ISO 12098 (15-pin) 8 5.2.2 Section [Config] 14
4.3 Software installation and activation 9 5.2.3 Section [Identifier] 15

4.4 Display of messages from the tractor

vehicle / trailer interface 6 Further information on the CAN bus 18
(ISO 11992-2 or 11992-3) 9
6.1 Transmission method 18
4.5 Display of messages from any CAN
6.2 Transfer rate and line length 18
bus 10
6.3 Object identifier 19
4.6 Display of one or a number of specific
CAN message(s) 10 6.4 Arbitration (negotiating media access),
priority 19
4.7 Filtering the displayed CAN
messages (identifier configuration) 11 6.5 Frame structure 19

Explanation of symbols

Additional instructions, information or tips that you

! should always observe.
• List

– Step

2
 General safety instructions CAN-Viewer 1

1 General safety instructions

Only trained and qualified personnel may work with the Make sure that the gearbox is in neutral and the hand
CAN-Viewer. brake is applied. When working on the brake system,
the vehicle must be secured against rolling away.
You must follow the specifications and instructions of
the vehicle manufacturer unconditionally. Wear any necessary protective clothing.

Comply with the company and national accident pre- The workplace has to be dry and sufficiently lighted and
vention/health & safety regulations. ventilated.

3
2 CAN-Viewer Introduction

2 Introduction

2.1 CAN-Viewer introduced jointly with Intel to reduce cable harnesses

and thereby weight.
By means of the CAN-Viewer, CAN messages from [Source: www.wikipedia.de - Die freie Enzyklopädie
any CAN bus can be easily read out, decoded in plain (03/2006)]
text, and saved. This is accomplished without compli-
cated measuring technology and time. Instead of using an electrical circuit for each transmit-
ted signal, the "bus" is based on a communication plat-
Main field of application for the CAN-Viewer is tracing form which regulates the relaying of messages be-
the flow of messages from EBS CAN bus to trailer inter- tween several devices.
face.
In a practical context, the process may be imagined as
The ability to display the communication between follows:
! tractor vehicle and trailer permits checking the data While the rear light was actuated by means of guiding
exchange function, which is part of the duty of care a current to the rear light, the bus system only relays a
required for acceptance of the vehicle. message: "Light switch to rear light: Switch on!"

Translating all control signals into messages requires a

"greater intelligence" of the connected devices, at the
2.2 CAN bus same time this implies that many devices can ex-
change information, virtually at same time, using a very
Controller Area Network (CAN) bus limited number of cable connections. For systems such
The CAN bus is an asynchronous (time-shifted), serial as EBS it is also possible to exchange much more com-
bus system, originally developed by Bosch to connect plex information e. g. on current pad wear or on individ-
electronic control devices in motor vehicles and was ual wheel speeds in the case of ABS.

4
 Program surface CAN-Viewer 3

3 Program surface

CAN message timestamp CAN message identifier

Loaded
Menu configuration
Menu
buttons CAN
messages
as plain text

Available
Configurations

Receive
buffer

Help text on menu item (if available)

Fig. 1 Program surface with display of current CAN messages

CAN
messages
as value

Memory
status when
recording
CAN
messages

Fig. 2 CAN-Viewer in recording mode

5
3 CAN-Viewer Program surface

Button Menu/Menu item Description

File management
Open Opening and loading a configuration file

Save Saving the current settings to a configuration file

Exit Exiting the program and the CAN connection

Function
Starting CAN reception Starting the reception and display of CAN messages

Recording of the CAN data Recording the CAN messages in a protocol

Stop Stopping the recording process and saving to a file

Searching CAN messages Search and display of all CAN messages from any CAN bus

indicator
Decimal or hexadecimal dis- Switching display of protocol between decimal and hexadecimal val-
play ues

The hexadecimal system Not activated:

! has the value 16 as its Display using hexadecimal notation
base. (our decimal system
has the base 10.) Numeri- Activated:
cal values are written using Display using decimal notation
the numerals 0 to 9 and the
This function is ignored if the CAN data is displayed as plain text
capital letters A to F.
! (see menu item "CAN data display").
CAN data display Switching display of protocol between CAN data as value or plain text

Not activated:
Display of CAN data as value

Activated:
Display of CAN data as plain text

The plain text of values can only be displayed if a description of

! these values is available in the configuration file.

6
 Program surface CAN-Viewer 3

Button Menu/Menu item Description

Options
CAN configuration... Setting the CAN bus parameters (see chapter 4.5 Display of one or a
number of specific CAN message(s))

Identifier configuration... Setting the CAN messages filter (see chapter 4.6 Filtering the dis-
played CAN messages (identifier configuration))

Settings ... Adjusting general program settings e.g. interface, data file location, ...
(see chapter 5.1 Program settings)
Help
About ... Opening the program information (e.g. version, serial number, ...)

7
4 CAN-Viewer Application

4 Application

4.1 Set-up of cable connection to 4.2 Set-up of cable connection to

vehicle via ISO 7638 (7-pin) vehicle via ISO 12098 (15-pin)

Fig. 3 Cable connection via ISO 7638 Fig. 4 Cable connection via ISO 12098

Required components: Required components:

• 446 301 001 0 Diagnostic interface with order • 446 301 001 0 Diagnostic interface with order
number 446 301 022 0 or 446 301 030 0 from ver- number 446 301 022 0 or 446 301 030 0 from ver-
sion 1.20 (or alternatively the diagnostic interface sion 1.20 (or alternatively the diagnostic interface
446 301 000 0 with order number 446 301 021 0 to- 446 301 000 0 with order number 446 301 021 0 to-
gether with CAN Converter 446 300 470 0) gether with CAN Converter 446 300 470 0)
• 446 300 360 0 CAN diagnostic adapter • 446 300 459 0 CAN-Viewer connection cable for
• 446 300 458 0 CAN-Viewer connection cable for ISO 12098
ISO 7638
A fault-free cable connection to the vehicle is a ba-
A fault-free cable connection to the vehicle is a ! sic requirement for the following instructions.
! basic requirement for the following instructions.

8
 Application CAN-Viewer 4

4.3 Software installation and activation 4.4 Display of messages from the
tractor vehicle trailer interface
– Plug the USB flash drive into the USB port of the PC. (ISO 11992-2 or 11992-3)
– To install the software on the PC, start the file In the event that the CAN-Viewer is currently receiving
SETUP.EXE in the main directory of the USB flash CAN messages, proceed as follows:
drive.
– Click this button to end receive mode.
– Follow the installation instructions on the screen.

After you have installed the software you must activate

– From the list of Available Configurations,
it; the preferred mode is online.
select the corresponding ISO by clicking
Activation means linking the software with the PC hard- the respective button.
ware. Use of the software is limited to one PC per ob- The CAN-Viewer automatically starts the reception of
tained licence. CAN messages.
WABCO permits you to use the software in accordance – Click the button if you want to switch the
with the licensing conditions for ten days without activa- current display of CAN data to plain text.
tion.

If you have any questions, the WABCO website If you only want to view specific CAN messages, you
! www.wabco-auto.com, or your WABCO partner, can also filter them (see chapter 4.6 Filtering the dis-
played CAN messages (identifier configuration)).
will also provide further assistance.
Scope and content of the CAN messages corre-
! sponds to the selected ISO. There you will also
find specific information.

9
4 CAN-Viewer Application

4.5 Display of messages from any CAN – In the dialog, select the corresponding
bus Baudrate and the Identifier for the desired
bus.
In the event that the CAN-Viewer is currently receiving
CAN messages, proceed as follows: – Click OK to close the dialog.
– Click the button to end this mode. – Click the button to open the dialog for fil-
tering the CAN messages.

– Click the button to open the CAN config- Since no identifiers are yet known or have been de-
uration dialog. fined, proceed as follows:

– Click the button New to define a new

– In the dialog, select the corresponding Baudrate
identifier.
and the Identifier for the desired bus.

– Click OK to close the dialog.

The CAN-Viewer automatically starts the reception of

CAN messages.

It is not possible to display the values as plain text

! because the required decoding of the CAN data is
not been stored.

4.6 Display of one or a number of spe- Fig. 6 Dialog for editing an identifier
cific CAN message(s)
– In this dialog, enter the ID and any name
In the event that the CAN-Viewer is currently receiving you choose (see fig. 6).
CAN messages, proceed as follows:
– Click OK to close this dialog.
– Click this button to end receive mode.
You may repeat this procedure for all desired CAN
messages.

– Click the button to open the CAN configu- – Click OK to close the dialog for defining
ration dialog (see fig. 5) . identifiers as well.

– Click this button to start reception.

It is not possible to display the values as plain text

! because the required decoding of the CAN data is
not been stored.

Fig. 5 Dialog for the CAN configuration

10
 Application CAN-Viewer 4

4.7 Filtering the displayed CAN mes- 4.8 Creating / Editing an identifier
sages (identifier configuration)
In the event that the CAN-Viewer is currently receiving
In the event that the CAN-Viewer is currently receiving CAN messages, proceed as follows:
CAN messages, proceed as follows:
– Click this button to end receive mode.
– Click this button to end receive mode.

– Click the button to open the dialog for fil-

– Click the button to open the dialog for fil- tering the CAN messages.
tering the CAN messages.
– Click the button New to define a new
– In the upper choice list (IDENTIFIER), se- identifier.
lect the desired identifier by checking the
– To change an identifier, you need to se-
corresponding checkbox.
lect it first.
– In the lower choice list (PARAMETER),
– Click the Edit button to start the dialog.
select the desired parameter for the se-
lected identifier by checking the corre-
sponding checkbox.

– Click OK to close this dialog.

Only the desired CAN messages will now be dis-

played in the program window.

List of all available

Fig. 8 Dialog for editing an identifier
identifiers
– In this dialog, enter the ID of the identifier
and any name you choose .

– Click OK to close this dialog.

List of all available parameters You may repeat this procedure for all desired CAN
for the selected identifier messages.

– Click OK to close the dialog for defining

identifiers as well.

Fig. 7 Dialog for filtering the displayed CAN messages (identifier

configuration)

11
4 CAN-Viewer Application

4.9 Creating a configuration file with 4.11 Recording and saving a protocol
your own settings with CAN messages to a file

– Adjust the display of the CAN messages In the event that the CAN-Viewer is currently receiving
as required. CAN messages, proceed as follows:

– Click the button to open the dialog for – Click this button to start reception.
saving a configuration dialog.

– Specify a location and a name for the – Click this button to start the recording
configuration file. mode.

– Click the button Save to close this dialog.

– Click this button to stop recording after
When saving a configuration file, the information the desired time.
! for decoding to plain text is lost.
After recording has been stopped, the dialog for sav-
ing the record file is opened automatically.

4.10 Loading your own configuration file – Specify a location and a name for the
record file.
– Click this button to open the dialog. – Click the button Save to close this dialog.

The CAN-Viewer is only able to record a limited

– Select the desired configuration file.
! number of CAN messages. You can see the cur-
rent memory status in the bottom left corner of the
– Click the button Open to close this dialog. program window (see fig. 2).

The CAN-Viewer automatically starts the reception of As soon as all the memory has been used up, the re-
CAN messages. cording process is stopped automatically and a dialog
for saving the record file is opened.

The default setting for the number of CAN messages

that can be received may be adjusted in the menu Op-
tions/Settings between 10,000 and max. 1,000,000.
To achieve this, values between 10 and 1,000 need to
be entered.

The content of the CAN messages is only saved

! as a value not as plain text.

12
 Administration CAN-Viewer 5

5 Administration

5.1 Program settings

Tab (Function) Description

Serial port Configure connection to the Interface
Currently selected interface or USB device Displays the currently set interface, e. g. COM1 or USB
Change interface Configuring the interface
Data file location Defining storage locations for the files
Reading directory Reading directory for reading out the configuration files
Writing directory Default directory for saving files
Program options General program options
Start program in full screen mode The program window is opened in full screen mode.
Display help texts (bubble help) A help text is displayed when the mouse cursor is held in posi-
tion over the respective button.
Number of CAN messages when recording For a more detailed description see chapter 4.11
User data User details
Company Company name
User name Name of the registered user
Serial number Serial number

5.2 Creating a configuration file for • [Config]: This section contains details regarding
decoding CAN messages in plain the CAN bus configuration. The standard config-
text urations also contain the description texts.

• [Identifier]: This section contains all the data re-

The following remarks apply with respect to creating a lated to the CAN identifiers and the standard
configuration file: configurations also contain the descriptions on
• A configuration file is structured according to a syn- interpreting the content of the CAN data.
tax similar to Windows INI files.
• Comment lines begin with a semicolon ; and are • Each section is described by keywords and apper-
thereby ignored during the process of interpreting taining values separated by an equals sign =. Here
the file. the syntax must be strictly adhered to, otherwise the
configuration cannot be read in correctly.
• The structure consists of three sections which are
marked accordingly: • The predefined configuration files in the CAN-View-
• [FileInfo]: This section contains information on er reading directory may be of assistance.
the configuration file.

13
5 CAN-Viewer Administration

5.2.1 Section [FileInfo]:

Keyword Value Description Explanation

FileType CANLOGGERCONFIG Standard
configuration Describes whether this configuration file is
a standard configuration or one of your
CANLOGGERUSERCONFIG Own own.
configuration
FileStructureVersion 1.0 This number indicates the file structure ver-
sion. So far, version 1.0 is the only one.

Table 3 - Keywords from section [FileInfo]

Example:
[FileInfo]
FileType = CANLOGGERCONFIG
FileStructureVersion = 1.0

5.2.2 Section [Config]

Keyword Value Description Explanation

Name Free text This key contains the text that is used in the
configuration button in the main dialog. It is
only taken into account for the standard
configurations.

The text in the button does not wrap and

should therefore be kept short (single-line).
Hint Free text This key contains the text that is displayed
underneath the configuration button in the
main dialog and is only taken into account
for standard configurations.

The text is wrapped automatically and may

therefore be a little longer than the name.
ExtIdentifier 0 Standard Here is specified whether it is a standard
Identifier (11 bit) (11 bit) or extended (29 bit) identifier.
1 Extended
Identifier (29 bit) ! This entry is mandatory.
baud rate 0 125 kBit Here the CAN baud rate is set.
1 250 kBit
2 500 kBit ! This entry is mandatory.

Table 4 - Keywords from section [Config]

Example:
[Config]
Name = ISO11992 (2001)
Hint = Tractor vehicle / Trailer interface
ExtIdentifier =1
Baud rate =1

14
 Administration CAN-Viewer 5

5.2.3 Section [Identifier]

The structure of entries is always as follows: The bit encoding of parameters is structured as fol-
lows:
IDxxx_ • xxx is a serial number
(001..0.099). IDxxx_Pyy_BCzzz • zzz is a serial number
• A maximum of 99 identifiers (001...256).
are supported. • There must not be any gaps
• There must not be any gaps within the numbering system.
within the numbering system.
The parameters pertaining to the identifier are always
structured as follows:
IDxxx_Pyy • yy is a serial number
(001...99).
• A maximum of 99 parameters
are supported.
• There must not be any gaps
within the numbering system.
.

Keyword Value Description Explanation

This entry contains the name of the identifier in
plain text. If this name is available, it will be dis-
played in the CAN-Viewer during the receiving
IDxxx_Name Free text process.

! This entry is not mandatory.

Here the identifier value is specified. This value
may be entered in decimal or hexadecimal nota-
decimal or
tion.
IDxxx_ID hexadeci-
mal
! This entry is not mandatory.
Identifier is not
IDxxx_Visible 0 At this point it is specified whether or not the iden-
displayed
tifier should be displayed during reception.
1 Identifier is displayed
Name of the parameter as it is to be displayed.
IDxxx_Pyy_Name Free text
This entry is mandatory.
Identifier is not
IDxxx_Pyy_Visible 0
displayed At this point it is specified whether or not the iden-
Parameter is tifier should be displayed during reception.
1
displayed
Description in which data byte of the CAN mes-
sage the parameter begins. The numbering sys-
tem begins with 1.
IDxxx_Pyy_BytePos Integer

! This entry is mandatory.

15
5 CAN-Viewer Administration

Keyword Value Description Explanation

Description of how many data bytes the parameter
comprises. The numbering system begins with 1.
IDxxx_Pyy_ByteSize Integer
This entry is not mandatory. The default value
! is 1.
Description at which bit position the parameter be-
gins. The numbering system begins with 1.
IDxxx_Pyy_BitPos Integer

! This entry is mandatory.

Description of how many data bits the parameter
comprises. The numbering system begins with 1.
IDxxx_Pyy_BitSize Integer

! This entry is mandatory.

Display bit-encoded
IDxxx_Pyy_ShowType 1 (a text is assigned to
each bit combination)
Display as integer
2
value
Display as Description of how the parameter is displayed.
3
hexadecimal value
Display as floating-
4 point number (with two
decimal digits)
5 Binary display
IDxxx_Pyy_Formula 0 Y = C0 * X +C1
1 Y = C0 * (X + C1)
2 Y = C0 / (X + C1) + C2
3 Y = X / C0 + C1 The parameter values may be converted prior to
4 Y = (X + C0) / C1 being displayed.
5 Y = (X + C0) / C1 + C2 This entry is mandatory. If it is not available, no
6 Y = C0 * X ! conversion will occur.
7 Y = X / C0
8 Y = X + C0
9 Y = X * C0 / C1
IDxxx_Pyy_Formula_C0 Constant 1
Here the three possible constants may be speci-
IDxxx_Pyy_Formula_C1 Constant 2
fied for the conversion by means of a formula.
IDxxx_Pyy_Formula_C2 Constant 3
The values for bit-encoded display are stored here.
IDxxx_Pyy_BCzzz_Value
In this context, xxx is a serial number. The text for
this number must also be specified.
IDxxx_Pyy_BCzzz_Text Free text The text for the corresponding value.
IDxxx_Pyy_MinVal Minimum value Minimum and maximum values of the computed
parameters. If the computed value is outside these
IDxxx_Pyy_MaxVal Maximum value limits, "NTBU" is displayed in the CAN-Viewer.
Table 5 - Keywords from section [Identifier]

16
 Administration CAN-Viewer 5

Example (one identifier with two parameters):

[Identifier]
ID001_Name = EBS11 (Truck)
ID001_ID = 201508896
ID001_Visible =1
ID001_P01_Name = Vehicle ABS
ID001_P01_Visible =1
ID001_P01_BytePos =1
ID001_P01_ByteSize =1
ID001_P01_BitPos =1
ID001_P01_BitSize =2
ID001_P01_ShowType =1
ID001_P01_BC001_Value =0
ID001_P01_BC001_Text = passive, but installed
ID001_P01_BC002_Value =1
ID001_P01_BC002_Text = active
;-----------------------------------
ID001_P02_Name = Vehicle retarder control
ID001_P02_Visible =1
ID001_P02_BytePos =1
ID001_P02_ByteSize =1
ID001_P02_BitPos =3
ID001_P02_BitSize =2
ID001_P02_ShowType =1
ID001_P02_BC001_Value =0
ID001_P02_BC001_Text = passive
ID001_P02_BC002_Value =1
ID001_P02_BC002_Text = active

17
6 CAN-Viewer Further information on the CAN bus

6 Further information on the CAN bus

6.1 Transmission method 6.2 Transfer rate and line length

The CAN bus is either a copper wire or fibre glass de-

A CAN bus is differentiated as either a high speed or a
sign. The CAN bus system is used for fast transmission
low speed bus. A high speed bus has a maximum
of data between control units. The CAN bus operates
according to the "multi-master principle": A number of transmission rate of 1 Mbit/s, a low speed bus
control devices (= bus nodes) with equal priority are in- 125 kBit/s.
terconnected by a topological arrangement.
The maximum (theoretical) line length is, for 1 Mbit/s
In the case of copper cables, the CAN bus operates us- 40 m, for 500 kBit/s 100 m and for 125 kBit/s 500 m.
ing differential signals. Generally, 3 lines are integrat- These maximum values derive from the fact that the
ed: time a signal is present on the bus (bit time, bit/sec-
• CAN_HIGH onds) is correspondingly shorter the higher the transfer
• CAN_LOW rate. With increasing line length, the bit also requires
• CAN_GND (ground) more time to reach the other end of the bus. The time
that a signal is present on the bus must therefore not be
CAN_LOW contains the complementary level of shorter than the time required for the signal to spread.
CAN_HIGH against ground. Common-mode interfer-
ences are suppressed by these means because the dif- The maximum number of bus nodes at the physical lay-
ferential remains the same. er depends on the bus driver components used. Ordi-
CAN transmits data through a binary model of either nary modules permit 32, 64 or up to 110 (with restric-
"dominant" bits and "recessive" bits, relative to status, tions up to 128) nodes per line.
acting on the bus lines. A dominant bit here overwrites
a recessive bit.

... ... Application X3

Brake Lighting controller Application X2

I-plate Engine chassis Application X1

CAN Bus Power Train CAN Bus Chassis & Safety CAN Bus XXX

Gateway Gateway Gateway Gateway

CAN Bus Vehicle

Gateway

Diagnostic connection K-Line

Fig. 9 Example of a CAN bus set-up

[Contents in chapters 6.1 - 6.5 from source: www.wikipedia.de - Die freie Enzyklopädie (03/2006)]
18
 Further information on the CAN bus CAN-Viewer 6

6.3 Object identifier other node. This process is detected by the other node,
which then stops the attempt to transmit so that the oth-
The object identifier designates the content of a mes- er node may transfer its data. If both nodes use the
sage, not the device. In a measuring system, it is pos- same identifier, an error frame is generated (see struc-
sible, for example, to assign an identifier to each of the ture 6.5 Frame structure). For this reason, the standard
parameters temperature, voltage, pressure. The recip- recommends that an identifier should only be used by a
ients use the identifier to determine whether or not the maximum of one node.
message is relevant to them. The object identifier also
serves the purpose of assigning a priority to messages. This procedure also establishes a hierarchy of messag-
es in relation to one another. The message with the
The specification defines two different identifier for- lowest identifier may "always" be transmitted. For the
mats: transmission of time-critical messages it is therefore
• 11bit identifiers, also called "base frame format“. possible to assign an identifier of high priority (= low ID,
e.g. 0) to grant priority during transmission. However,
• 29 bit identifiers, also called "extended frame for-
even for messages with a high priority it is not possible
mat".
to determine the precise moment of transmission in ad-
A node may be recipient and sender of messages with vance (non-deterministic behaviour).
any number of identifiers. However, a maximum of one
sender may be assigned to an identifier (for the arbitra-
tion to function).
6.5 Frame structure

There are two types of frames:

6.4 Arbitration (negotiating media
access), priority Data Frame is used to transport up to 8 objects
of data
Bus access is resolved free of losses by means of a bit- Remote Frame is used to request a data frame
wise arbitration (as just an allocation of resources to the from another node
different devices as possible) on the basis of the identi- Error Frame signals to all nodes that a fault
fiers of the messages to be transmitted. For this pur- condition was detected in trans-
pose, each transmitter senses the bus while he is send- mission
ing the identifier. In the event that two nodes are
transmitting simultaneously, the first dominant bit of the Overload Frame is used to enforce an intermission
two overwrites the corresponding recessive bit of the between data and remote frames

recessive

1 11 1 1 1 4 0...64 15 1 1 1 7 3

dominant
Acknowledgement Delimiter
Remote Transmission Bit

Acknowledgement Slot
Identifier Extension Bit

Data Length Field

CRC Checksum

CRC Delimiter
Start of Frame

End Of Frame
Identifier Field

Intermission
Data Field
Reserved

Bus Idle

Fig. 10 CAN data frame with 11bit identifier (source: www.wikipe-

dia.de - Die freie Enzyklopädie)

[Contents in chapters 6.1 - 6.5 from source: www.wikipedia.de - Die freie Enzyklopädie (03/2006)]
19
 CAN-Viewer Notes

20