MAGNA: BluePiraT¶
Herstellerinformationen
Hersteller |
Webseite |
Produktname |
Version |
|---|---|---|---|
MAGNA Telemotive AG |
BluePiraT |
Telemotive Client Libraries 3.4 / 4.1 / 4.2.0 / 4.2.2 |
Kategorien
MDL 🛈 |
APL 🛈 |
BAN 🛈 |
BMA 🛈 |
SVC 🛈 |
DGN 🛈 |
FIU 🛈 |
EES 🛈 |
FCT 🛈 |
DBG 🛈 |
IMG 🛈 |
AUDIO 🛈 |
ENVSIM 🛈 |
ENVCOM 🛈 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
✓ |
✓ |
Signalaufnahmen 🛈
Dateiformat |
Kommentar |
|---|---|
*.asc |
|
*.blf |
Plattform
Betriebssystem |
Unterstützung |
|---|---|
Windows |
✓ |
Linux |
Ports¶
Besonderheiten¶
Diese Schnittstelle ermöglicht mit der Hardware direkte Buszugriffe auf CAN, LIN und FlexRay. Sie erlaubt die Testschritte Signal-Lesen und Signalgruppe Lesen (alle Bussysteme) sowie Überwachen (nur CAN) und unterstützt Signalaufzeichnung (alle Bussysteme).
Damit die Schnittstelle zur Verfügung steht, muss das Verzeichnis mit den Dateien
BPNGClientLib.dll und BPNGOnlineStreamingLib.dll in die
ToolLibs.ini unter der Sektion BluePiratBusAccessLib als dllLocation
eingetragen werden.
Diese Dateien sind als Telemotive Client Libraries von der
MAGNA Telemotive GmbH erhältlich. Die Schnittstelle wurde gegen
die Versionen 3.4.3.0, 4.1.0.38, 4.2.0.40 und 4.2.2.24 getestet.
Die Aufzeichnung von Bus-Aktivität erfolgt grundsätzlich auf der Festplatte des Loggers mit anschließendem Download in verschiedenen Formaten, entweder einzeln für jeden Bus / Port, oder gemeinsam über alle angeschlossenen Busse hinweg als Tool-Log-Aufzeichnung.
Vorsicht
Bei dieser Schnittstelle kann der Port-Start bei Testfallbeginn teils extrem lang dauern (mehrere Minuten).
Info
Wird das Ausgabeformat BLF verwendet, ist es notwendig, dass
die Datei binlog.dll in %windir%/System32/ liegt. Die Datei
kann von der Vector Informatik GmbH bezogen werden.
FormatIds für DownloadAllTraceData Job¶
Ab 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
Zusätzlich ab BluePirat Version 4.1
QXDM_RAW_SERIAL: Like RAW_SERIAL but only for tty and with file extension *.qmdl
Zusätzlich ab BluePirat Version 4.2
PCAPNG: Wireshark - pcapng (*.pcapng) format
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Hardware |
[‚<online query>‘, ‚<no toollib start>‘] |
string |
Wählen Sie hier die zu verwendende Hardware aus |
||
Export-Format |
[‚<online query>‘, ‚<no toollib start>‘] |
string |
Logaufnahmen in diesem Format speichern |
||
Timeout für Toolzugriffe ❲in Sek.❳ |
‚600‘ |
string |
Zeit nach der eine Anfrage an das Tool abgebrochen wird. |
Jobs 🛈¶
DownloadAllTraceData¶
Lädt alle Aufnahmen zwischen Anfangs- und Endmarkierung als Zipfile herunter. Sind Anfangs- und/oder Endmarkierung nicht eindeutig, wird jeweils die zuletzt gesetzte verwendet.Zusätzlich können die enthaltenen Daten in verschiedene Formate konvertiert werden.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
channelConversions |
{} |
object |
Dictionary von Kanalname auf eine oder mehrere BluePiraT FormatIds die aus der Aufnahme extrahiert werden sollen. Zum Beispiel: {‚FlexRay-1A‘: [‚BLF‘, ‚CANOE‘], ‚Analog-1‘: ‚TMASC‘} |
||
endMarkerName |
string |
Name der Endmarkierung, wie von SetMarker zurückgegeben |
|||
startMarkerName |
string |
Name der Anfangsmarkierung, wie von SetMarker zurückgegeben |
|||
targetFile |
string |
Dateiname oder Verzeichnis unter dem das Zipfile abgelegt werden soll. Wenn nicht angegeben, wird es unter generiertem Namen im Logverzeichnis abgelegt. |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
conversionResult |
object |
Dictionary von Kanalname auf Liste von Dateinamen die aus der Aufnahme extrahiert wurden. |
SetMarker¶
Setzt ein InfoEvent als Markierung. Es kann später zum Download aller Aufnahmen zwischen zwei Markierungen dienen.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
markerName |
string |
Name der Markierung. Falls nicht angegeben, wird ein Name generiert. |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
string |
Name der Markierung |