MAGNA: BluePiraT¶
Vendor information
Vendor |
Web page |
Product name |
Version |
|---|---|---|---|
MAGNA Telemotive AG |
BluePiraT |
Telemotive Client Libraries 3.4 / 4.1 / 4.2.0 / 4.2.2 |
Categories
MDL 🛈 |
APL 🛈 |
BAN 🛈 |
BMA 🛈 |
SVC 🛈 |
DGN 🛈 |
FIU 🛈 |
EES 🛈 |
FCT 🛈 |
DBG 🛈 |
IMG 🛈 |
AUDIO 🛈 |
ENVSIM 🛈 |
ENVCOM 🛈 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
✓ |
✓ |
Signal recordings 🛈
File format |
Comment |
|---|---|
*.asc |
|
*.blf |
Platform
Operating system |
Support |
|---|---|
Windows |
✓ |
Linux |
Ports¶
Specifics¶
This interface allows, by means of hardware, direct CAN, LIN and FlexRay bus access. It supports the test steps read signal, read signal group (all bus systems) as well as monitor (CAN only) and supports signal recording (all bus systems).
For the interface to be available, the directory including the files BPNGClientLib.dll and
BPNGOnlineStreamingLib.dll need to be referenced in ToolLibs.ini under the section
BluePiratBusAccessLib as dllLocation.
These files are available as Telemotive Client Libraries
from MAGNA Telemotive GmbH. The interface was tested against
versions 3.4.3.0, 4.1.0.38, 4.2.0.40, and 4.2.2.24.
Recording of bus activity is performed on the logger’s hard disk with subsequent download in various formats, either individually for each bus / port, or jointly across all connected busses, as a tool log recording.
Caution
When using this interface, the port start phase during test case initialization may occasionally take extremely long (up to several minutes).
Info
If you use BLF as output format, a copy of the file binlog.dll must be
in %windir%/System32/.
The file can be obtained from Vector Informatik GmbH.
FormatIds for DownloadAllTraceData Job¶
Since BluePirat Version 3.4.3
APN: APN serial format
ASCHEX: ASCII format that writes binary data as hex values
BLF: Binary Logging Format - Vector Informatik
CANCORDER: CANCorder format
CANOE: CANOE ASCII format
DLT_BMW: BMW specific DLT Format
ESO_TRACE: Audi specific ESO Format
GNLOG: GNLog format
GPX: GPS Exchange format
IMG: DataAnalyser IMG format
KML: KML format for GPS data
KMZ: KMZ format for GPS data
MDF: Measurement data format - Vector Informatik
MDF_BUS_LOG_4_10: MDF 4.10 format for bus logging
MDF_CAN_SIG: MDF format based on CAN signals
MDF_CCP_XCP_SIG: MDF format based on CCP & XCP signals.
MDF_SIG_LOG_4_10: MDF 4.10 format for signal logging
MPEG4_BLOCKS: Camera format separated blocks
MPEG4_JOINED: Camera joined videos
NMEA: Raw format for GPS data
OP2: MOST OP” format
RAW_ETHERNET: Raw ethernet format
RAW_SERIAL: Raw Serial Format
SERIAL_DEBUG: Serial Format with “new Line”-packaging
STA: Serial Trace Analyser format
TCLOG: Trace Client format
TCLOG_TS: Trace Client format plus time stamps
TCPDUMP: TCP dump (*.pcap) format
TMASC: Telemotive ASCII format
TMBIN: Telemotive binary format
TS: Raw isochrone format
XTMT: Extended Telemotive trace file format
Additionally since BluePirat version 4.1
QXDM_RAW_SERIAL: Like RAW_SERIAL but only for tty and with file extension *.qmdl
Additionally since BluePirat version 4.2
PCAPNG: Wireshark - pcapng (*.pcapng) format
Properties 🛈¶
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
Hardware |
[‘<online query>’, ‘<no toollib start>’] |
string |
Choose the hardware which should be used |
||
Export format |
[‘<online query>’, ‘<no toollib start>’] |
string |
Save log recordings in this format |
||
Timeout for tool call ❲in sec.❳ |
‘600’ |
string |
Timeout after which a tool call is aborted. |
Jobs 🛈¶
DownloadAllTraceData¶
Downloads all recordings between the start and end markers as a zip file. If the start and/or end markers are not unique, the last marker set is used. In addition the recorded data can be converted into various formats.
Parameterization
Parameter
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
channelConversions |
{} |
object |
Dictionary of channel name to one or several BluePiraT FormatIds to be extracted from the recording. For example: {‘FlexRay-1A’: [‘BLF’, ‘CANOE’], ‘Analog-1’: ‘TMASC’} |
||
endMarkerName |
string |
Name of the end marker, as it has been returned by SetMarker |
|||
startMarkerName |
string |
Name of the start marker, as it has been returned by SetMarker |
|||
targetFile |
string |
Filename or directory the zip file should be saved to. If not given, it will be saved in the log directory using a generated Name. |
Return value
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
conversionResult |
object |
Dictionary of channel name to list of filenames which were extracted from the zip file. |
SetMarker¶
Sets an InfoEvent as a marker. Later, it can be used to download all recordings between two markers.
Parameterization
Parameter
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
markerName |
string |
Name of the marker. If not given, a name will be generated. |
Return value
Name |
Available if |
Default value |
Valid values |
Type |
Description |
|---|---|---|---|---|---|
result |
string |
Name of the marker |