Specification
CAN and General BLF Logging Format
Author:
Version:
Status:
Geyer, Stefan
1.41 of 2016-06-22
released
(in process / completed / inspected / released)
Number of Pages: 39
Specification --- CAN and General BLF Logging Format
II
Document Management
Release and Release History
Name
Tinnirello, Gianfranco (Gia) /
Document Owner
Tinnirello, Gianfranco (Gia) /
Document Owner
Tinnirello, Gianfranco (Gia) /
Document Owner
Tinnirello, Gianfranco (Gia) /
Document Owner
Tinnirello, Gianfranco (Gia) /
Document Owner
Tinnirello, Gianfranco (Gia) /
Document Owner
Tinnirello, Gianfranco (Gia) /
Document Owner
Tinnirello, Gianfranco (Gia) /
Document Owner
Tinnirello, Gianfranco (Gia) /
Document Owner
Tinnirello, Gianfranco (Gia) /
Document Owner
Tinnirello, Gianfranco (Gia) /
Document Owner
Tinnirello, Gianfranco (Gia) /
Document Owner
Tinnirello, Gianfranco (Gia) /
Document Owner
Hesselmaier, Bodo (Hb) /
Document Owner
Wist, Wolfgang (Wwi) /
Document Owner
Role
DEV
DEV
DEV
DEV
DEV
DEV
DEV
DEV
DEV
DEV
DEV
DEV
DEV
DEV
DEV
Version
Date
1.0
1.2
1.2
1.5
1.8
2008-06-19
2008-09-24
2009-05-18
2010-09-24
2010-12-23
1.10
2011-04-07
1.11
2011-05-20
1.12
2011-09-05
1.14
2011-10-24
1.15
2011-03-04
1.16
2012-05-07
1.20
2012-10-22
1.22
2013-04-23
1.26
2014-02-13
1.27
2014-03-04
2016 Vector Informatik GmbH
CAN_and_General_BLF_Format.doc
Version 1.41 of 2016-06-22
Specification --- CAN and General BLF Logging Format
III
Revision list
Version Date
Editor Section
Changes, comments
0.1
0.2
1.0
1.2
1.3
1.4
1.5
1.6
1.7
1.8
1.9
2008-06-09
2008-06-17
2008-06-19
2008-09-24
2009-05-18
2010-01-15
2010-08-12
2010-10-26
2010-11-29
2010-12-21
2011-01-19
Gey
Gey
Gey
Ae
Gia
Sc
Jr
Sha
Hb
Hb
Sha
All
All
All
3.1
1
3.1
Initial version created.
Rework after review
Added BL_OBJ_* values to the object types.
Added VBLObjectHeader2
Extended CAN message flags
Added Disclaimer
New member mObjectVersion in
VBLObjectHeader and VBLObjectHeader2
3.13
Added example for VBLEthernetFrame
3.2; 3.3
Added VBLCANMessage2
3.5
3.5
3.2; 3.3
VBLCANErrorFrameExt extensions
VBLCANErrorFrameExt extensions
Hints added to VBLCANMessage and
VBLCANMessage2 description
1.10
2011-04-07
Mp
3.17
Added Comment event (for comments in Trace
Window)
1.11
1.12
1.13
1.14
1.15
1.16
1.17
1.18
1.19
1.20
1.21
1.22
1.23
1.24
1.25
1.26
1.27
1.28
1.29
1.30
1.31
2011-05-20
2011-08-29
2011-09-08
2011-10-24
2012-03-01
2012-05-07
2012-08-23
2012-09-06
2012-09-06
2012-10-22
2013-04-15
2013-04-23
2013-04-23
2013-07-12
2013-10-15
2014-02-13
2014-03-04
2014-12-10
2014-12-10
2014-12-11
2015-01-21
Jr
Jr
Sha
Mp
Wwi
Wwi
Chk
Chk
Chk
Gia
Fsi
Jr
Hb
Hb
Chk
Hb
Wwi
Jmi
Hb
Wwi
Uru
3.15, 3.16 Added WLAN events
3.15
3.3
3.20
Modified signal strength of WLAN event
Clarification to CAN message length
Added global marker event (for global markers)
3.21, 3.22 Added AFDX events
3.21
3.1.2,3.4 Added CAN FD message flag description, Added
AFDX flag bit enumeration updated
3.4
3.4
3.19
VBLCANFDMessage description
VBLCANFDMessage format modified
VBLCANFDMessage format modified
Some modifications for VBLAppText
CAN FD BLF Logging
3.4, 3.7
3.17. 3.18 Added Ethernet status and Rx error
3.4
3.4
CAN FD BLF Logging
CAN message-flags added
3.4,3.7
Data length for CAN remote frames
Clarifications
3.4, 3.7
3.25–3.29 Added AFDX status event and new bus statistic
3.18
Added Ethernet bus statistic event
Extended CAN FD events
3.4, 3.7
3.31-3.35 Added AFDX error event and all A429 events
3.32, 3.35 A429 message and A429 Statistic format
modified
2016 Vector Informatik GmbH
CAN_and_General_BLF_Format.doc
Version 1.41 of 2016-06-22
Specification --- CAN and General BLF Logging Format
IV
Revision list
Version Date
Editor Section
Changes, comments
2015-01-26
2015-01-28
2015-02-13
2015-02-17
2015-04-01
2015-04-07
2015-04-23
2015-09-01
Rue
Lt
Chk
Chk
Lke
Chk
Lke
Lke
3.14
3.1.4
3.6
3.4
3.36
3.4, 3.7
3.36
3.36
2016-02-15
Wwi
3.25–3.29
mRepresentation flag for system variable
mClientIndex for internal use
Add Ack Error failure code
Changed description of mFlag Bit 19, because
differ to source code description
Added test structure events
Replace EDL by FDF
Test structure events modified
Corrected description for
VBLTestStructure::mUniqueNo
Improve description for AFDX/A429
2016-06-22
Jr
3.17
Moved Ethernet events to own document
1.32
1.33
1.34
1.35
1.36
1.37
1.38
1.39
1.40
1.41
2016 Vector Informatik GmbH
CAN_and_General_BLF_Format.doc
Version 1.41 of 2016-06-22
Specification --- CAN and General BLF Logging Format
V
Table of contents
1 Disclaimer .................................................................................................................... 1
2 Overview ...................................................................................................................... 1
3 Format Description ..................................................................................................... 1
3.1 Common Data Types ............................................................................................................. 1
3.1.1 CAN Message Flags .................................................................................................... 1
3.1.2 Driver Error Codes ...................................................................................................... 2
3.1.3 VBLObjectHeaderBase ............................................................................................... 3
3.1.4 VBLObjectHeader ....................................................................................................... 4
3.1.5 VBLObjectHeader2 ..................................................................................................... 4
3.2 Obsolete Types ...................................................................................................................... 5
3.2.1 VBLCANMessage ....................................................................................................... 5
3.3 VBLCANMessage2 ............................................................................................................... 5
3.4 VBLCANFDMessage64 ........................................................................................................ 6
3.5 VBLCANErrorFrame ............................................................................................................ 9
3.6 VBLCANErrorFrameExt ....................................................................................................... 9
3.7 VBLCANFDErrorFrame64 ................................................................................................. 11
3.8 VBLCANOverloadFrame .................................................................................................... 12
3.9 VBLCANDriverStatistic ...................................................................................................... 13
3.10 VBLCANDriverError .......................................................................................................... 13
3.11 VBLCANDriverErrorExt .................................................................................................... 14
3.12 VBLCANDriverHwSync ..................................................................................................... 14
3.13 VBLEnvironmentVariable ................................................................................................... 14
3.14 VBLSystemVariable ............................................................................................................ 16
3.15 VBLGPSEvent ..................................................................................................................... 19
3.16 VBLWlanFrame .................................................................................................................. 19
3.17 VBLWlanStatistic ................................................................................................................ 20
3.18 VBLAppTrigger .................................................................................................................. 20
3.19 VBLAppText ....................................................................................................................... 21
3.20 VBLEventComment ............................................................................................................ 22
3.21 VBLGlobalMarker ............................................................................................................... 22
3.22 VBLAfdxFrame ................................................................................................................... 23
3.23 VBLAfdxStatistic ................................................................................................................ 24
3.24 VBLAfdxBusStatistic .......................................................................................................... 25
3.25 VBLAfdxLineStatus ............................................................................................................ 26
3.26 VBLAfdxStatus ................................................................................................................... 27
3.27 VBLAfdxErrorEvent ........................................................................................................... 27
3.28 VBLA429Message .............................................................................................................. 28
3.29 VBLA429ErrorEvent ........................................................................................................... 29
3.30 VBLA429Status ................................................................................................................... 29
3.31 VBLA429BusStatistic ......................................................................................................... 30
3.32 VBLTestStructure ................................................................................................................ 31
2016 Vector Informatik GmbH
CAN_and_General_BLF_Format.doc
Version 1.41 of 2016-06-22
Specification --- CAN and General BLF Logging Format
VI
2016 Vector Informatik GmbH
CAN_and_General_BLF_Format.doc
Version 1.41 of 2016-06-22
Specification --- CAN and General BLF Logging Format
1
1 Disclaimer
Severability clause - Restrictions for the usage of Vector logging data formats outside of Vector
products
The format specification / access functions for the Vector BLF and ASC logging data formats are
made available under the restrictions and conditions cited hereafter.
Please note that Vector Informatik neither gives any guarantee nor assumes any liability beyond
compulsory legal regulations for the BLF or ASC logging format respectively as well as for the
access functions to the single objects.
Vector Informatik disclaims all liability for errors which might be contained in the access functions
or the format specification itself.
Vector Informatik does neither provide support for the integration into your software nor for
problems occurring inside your software on the customer side.
Beyond that Vector Informatik reserves the right to change the BLF or ASC data format
respectively anytime without prior notification. Therefore, the compatibility of the format is not
ensured.
2 Overview
The document specifies the format of CAN events and general objects in the CANoe/CANalyzer
BLF logging. The described structures can be used to read and write BLF logging files using the
binlog.dll, which can be found in the CANoe/CANalyzer User Data folder:
\Programming\BLF_Logging
3 Format Description
3.1 Common Data Types
3.1.1 CAN Message Flags
The following flags are valid for the mFlags members of CAN objects.
1. Direction of CAN frame (DIR)
2. Remote Transmission Request (RTR).
3. Single wire operation (NERR)
4. Wake Up Message (high voltage) (WU)
RTR (Bit 7)
WU (Bit 6)
NERR (Bit 5)
DIR (Bit 3-0)
0:
No RTR
0:
No WU
0:
No NERR
0:
RX
1:
RTR
1:
WU
1:
NERR
1:
TX
2016 Vector Informatik GmbH
CAN_and_General_BLF_Format.doc
Version 1.41 of 2016-06-22
Specification --- CAN and General BLF Logging Format
2
Use the following macros to determine the values of RTR, WU, NERR and DIR:
#define CAN_MSG_DIR( f) ( BYTE)( f & 0x0F)
#define CAN_MSG_RTR( f) ( BYTE)( ( f & 0x80) >> 7)
#define CAN_MSG_WU( f) ( BYTE)( ( f & 0x80) >> 6)
#define CAN_MSG_NERR( f) ( BYTE)( ( f & 0x80) >> 5)
Use the following macro to set the values of RTR and DIR:
#define CAN_MSG_FLAGS( dir, rtr) ( BYTE)( ( ( BYTE)( rtr & 0x01) << 7) | \
( BYTE)( dir & 0x0F))
Use the following macro to set the values of RTR, WU, NERR and DIR:
#define CAN_MSG_FLAGS_EXT( dir, rtr, wu, nerr) \
( BYTE)( ( ( BYTE)( rtr & 0x01) << 7) | \
( ( BYTE)( wu & 0x01) << 6) | \
( ( BYTE)( nerr & 0x01) << 5) | \
( BYTE)( dir & 0x0F))
To set the RTR flag to true and the frame direction to a send frame, execute:
BYTE flags = CAN_MSG_FLAGS( 1, 1)
To set the RTR flag to true, the WU flag to true, the NERR flag to true and the frame direction to
a send frame, execute:
BYTE flags = CAN_MSG_FLAGS_EXT( 1, 1, 1, 1)
3.1.2 Driver Error Codes
The following values are error codes valid for CAN driver error information
Value
Description
0
1
2
3
4
5
6
8
9
10
11
12
14
timeout during board initialization
no events in the rx queue / no event available for dvGetEvent
tx queue full, tx request refused
unknown Controller-Nr.
timeout during command
DPRAM-Overflow
not allowed event in dvPutCommand
driver detected another hardware (see CANIB)
parameter error in dvMeasureInit
parameter error in dvMeasureInit and dvPutCommand
not (yet) implemented function in this version of driver
82526: no access to imp
last msg wasn't transferred
100
unknown send id (FullCAN only)
101
102
103
rx queue overrun
chip state busoff
chip state error passive
2016 Vector Informatik GmbH
CAN_and_General_BLF_Format.doc
Version 1.41 of 2016-06-22