RA Consulting: DiagRA D¶
Bisheriger/interner Bezeichner: DIAGRA
Herstellerinformationen
Hersteller |
Webseite |
Produktname |
Version |
|---|---|---|---|
RA Consulting GmbH |
DiagRA D |
ab 4.6.30.22 Beta 6849 |
|
RA Consulting GmbH |
Silver Scan-Tool |
Kategorien
MDL 🛈 |
APL 🛈 |
BAN 🛈 |
BMA 🛈 |
SVC 🛈 |
DGN 🛈 |
FIU 🛈 |
EES 🛈 |
FCT 🛈 |
DBG 🛈 |
IMG 🛈 |
AUDIO 🛈 |
ENVSIM 🛈 |
ENVCOM 🛈 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
✓ |
Plattform
Betriebssystem |
Unterstützung |
|---|---|
Windows |
✓ |
Linux |
Ports¶
Besonderheiten¶
Einrichtung des WebServices für die Fernsteuerung¶
Voraussetzung: WebService-Fernsteuerung in DiagRA muss aktiviert sein. Sie kann im DiagRA unter Einstellungen –> Fernsteuerung –> Fernsteuerung über Web Services verwenden aktiviert werden.
Bestimmung der Parameter für die Testbenchkonfiguration¶
Die für die Konfiguration von DiagRA notwendigen Werte „Baudrate“, „Interface“ und „Protokoll“ können DiagRA unter Einstellungen –> Kommunikation entnommen werden, wobei die Angabe der Baudrate ohne Einheit erfolgen muss.
Die OBD Adresse zur Konfiguration des OBD-Ports kann dem DiagRA Hauptfenster entnommen werden. Hierbei handelt es sich um die erste Zahl (z.B. 33) der Auswahl in der im folgenden Bild markierten Auswahlbox.
Ansteuerung von Silver Scan-Tool¶
Das Silver Scan-Tool von RA Consulting kann ebenfalls über den DiagRA Tool-Adapter angesteuert werden. Anders als DiagRA muss Silver Scan-Tool aber manuell gestartet werden, bevor sich ecu.test verbinden kann.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Version |
‚<system default>‘ |
string |
Verwendete DiagRA-Version |
||
Benutzer |
‚diagra‘ |
string |
Verwende angegebenen Nutzernamen für die Automatisierungsschnittstelle |
||
Baudrate |
string |
Baudrate |
|||
Interface |
string |
Interface |
|||
Protokoll |
string |
Protokoll |
|||
Einstellungen überprüfen |
☐ |
bool |
Überprüft bei True ob die Einstellungen in DiagRA korrekt gesetzt sind und bricht bei falschen Einstellungen den Portstart ab. (Bei False kommt im Log-Fenster eine Warnmeldung) |
||
Alternative DiagRA-Installation |
string |
Optional kann hier eine DiagRA_D.exe angegeben werden, die anstelle der in der Registry eingetragenen DiagRA-Installation gestartet wird, falls noch kein DiagRA WebService läuft. |
|||
Sprache |
‚<keep>‘ |
string |
Setzt die Programmsprache von DiagRA, die für Job-Aufrufe verwendet wird und beispielsweise Einfluss auf die Sprache der Rückgabewerte der Jobs hat. Standardwert „<keep>“, um die aktuell eingestellte Sprache zu verwenden. Gültige Werte sind z.B. „en“ oder „de“. |
||
Timeout für Toolzugriffe ❲in Sek.❳ |
‚600‘ |
string |
Zeit nach der eine Anfrage an das Tool abgebrochen wird. |
Jobs 🛈¶
Configure¶
Ändert die Konfiguration der Diagnoseschnittstelle über den DiagRA-WebService mittels Schlüssel-Wert-Paaren, z.B. Name „TIMEOUTVALUE“ und Wert „20“ setzt das Timeout zum Warten auf Antwort von der ECU auf 20 Sekunden.
Als Sprache wird standardmäßig die Sprache aus der entsprechenden TBC-Option gesetzt.
Informationen zu den Schlüsselwörtern gibt es im Hilfe-Dokument von DiagRA im Abschnitt „Configure“. Das Dokument befindet sich im Installationsverzeichnis, z.B. unter „C:\RA Consulting\DiagRA Automation\Samples\WebServices\Doc\WebserviceFunktionen.pdf“.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
name |
string |
Name der Konfiguration, die geändert wird. |
|||
value |
string |
Einstellung für die Konfiguration. Wert, auf den die Konfiguration für das angegebene Schlüsselwort gesetzt werden soll. |
ReadInterfaces¶
Ermittelt alle bekannten Interfaces der angegebenen Typen/Standards.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
deviceTypes |
[] |
object |
Liste von Gerätetypen, z.B. [„RP1210“]; Leer lassen für alle Geräte. |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
jobResult |
object |
Liste der Interfaces |
SaveCurrentPage¶
Diese Funktion speichert die Daten der aktuellen Seite.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Name |
string |
Name einer Datei, in der die Daten gespeichert werden. |
|||
Page |
string |
Name einer Seite in DiagRA, deren Daten gespeichert werden. |
|||
SubPage |
string |
Name einer Unterseite, deren Daten gespeichert werden. |
SelectInterface¶
Wählt ein Interface aus - flexibler als Configure(‚Interface‘, …). Wenn die Angaben nicht eindeutig sind, wird das erstbeste übereinstimmende Interface gewählt
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
deviceType |
string |
Interfacetyp (wie in Interfaceauswahl). Darf auch leer bleiben, dann wird in allen Typen gesucht. |
|||
manufacturer |
string |
Hersteller (Teilstrings sind möglich). Darf auch leer bleiben, dann wird in allen Herstellern gesuchht. |
|||
name |
‚*‘ |
string |
Name eines Interface. Kann Wildcards * und ? enthalten. |
||
version |
string |
Version (Teilstrings sind möglich). Darf auch leer bleiben, dann wird in allen Versionen gesucht. |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
jobResult |
string |
Gewähltes Interface (per ReadConfig(‚Interface‘) ermittelt). |