PLS: UDE¶
Bisheriger/interner Bezeichner: UDE
Herstellerinformationen
Hersteller |
Webseite |
Produktname |
Version |
|---|---|---|---|
PLS Development Tools |
Universal Debug Engine |
4.2 bis 2023 |
Kategorien
MDL 🛈 |
APL 🛈 |
BAN 🛈 |
BMA 🛈 |
SVC 🛈 |
DGN 🛈 |
FIU 🛈 |
EES 🛈 |
FCT 🛈 |
DBG 🛈 |
IMG 🛈 |
AUDIO 🛈 |
ENVSIM 🛈 |
ENVCOM 🛈 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
✓ |
Plattform
Betriebssystem |
Unterstützung |
|---|---|
Windows |
✓ |
Linux |
Info
Dieses Tool kann auf einem Host mehrfach konfiguriert und parallel verwendet werden.
Ports¶
Besonderheiten¶
Info
Wird lediglich eine ELF-Datei zum Laden angegeben, dann werden die darin enthaltenen Symbole in UDE geladen. Der Programmstand auf dem Steuergerät wird nicht geändert.
Lesen/Schreiben von Enum-Variablen¶
Um Enum-Variablen symbolisch zu schreiben oder zu lesen, muss im Testschritt die Repräsentation „Interpretierter Text“ ausgewählt werden.
Wird der Job „ReadVariable“ verwendet, dann werden Enum-Variablen standardmäßig symbolisch zurückgegeben. Ist explizit eine numerische Repräsentation gewünscht, dann muss der zu lesende Ausdruck so gewählt werden, dass UDE einen Zahlenwert zurück gibt. Das kann z.B. folgendermaßen erreicht werden (Lesen der Enum-Variable „enumVariable“):
„0 + enumVariable“
Über einen Typecast, z.B. „(char) enumVariable“ Dabei ist zu beachten, dass anstelle des Typs „char“ ggf. auch „int“ angegeben werden muss, je nachdem, wieviel Bytes die Enum-Variable intern belegt. Demzufolge wäre die erstgenannte Variante die sicherere.
Multicore-Debugging¶
Beim Debugggen von Multicore-Targets muss jeweils ein Debugger-Port für jeden im Testfall verwendeten Core in der Testbenchkonfiguration angelegt werden. Um symbolisch auf Variablen und Register jedes einzelnen Cores zugreifen zu können, muss außerdem in der Testkonfiguration ein Steuergerät für jeden Core angelegt werden. Unter Debugging können nun jedem Steuergerät der jeweilige Debugging-Port sowie ELF- und HEX-Datei zugeordnet werden.
Info
Einige Port-Jobs von UDE enthalten einen Core-Parameter, dieser ist veraltet und sollte nicht verwendet werden. Stattdessen muss der Job des entsprechenden Ports genutzt werden.
Multicore/Multiprogram loader¶
Für fortgeschrittene Anwendungsfälle kann es notwendig sein den Multicore/Multiprogram loader zum Flashen des Targets zu verwenden. Der Dialog kann mit den Tool-Jobs MclAddFile und MclRemoveAllFiles parametriert und der Flashvorgang mittels MclDoDownload gestartet werden. Beim Verwenden des Multicore/Multiprogram loaders können die Flashoptionen in der TBC frei gelassen werden.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Wiederholrate beim zyklischen schreiben ❲Hz❳ |
10 |
int |
Legt die Rate in Hz fest, mit der die Variablen beim zyklischen Schreiben manipuliert werden. ACHTUNG: Hohe zyklische Schreibraten können die Performanz von ecu.test negativ beeinflussen! |
||
Version |
‚4.2‘ |
string |
Die zu verwendende UDE-Version. |
||
Workspace-Datei |
uri |
Pfad der UDE-Workspace-Datei auf dem Tool Server-Computer (absolut oder relativ zum Basispfad des Toolhost). Falls vorhanden, wird die Workspace-Datei geöffnet. Falls nicht definiert oder nicht vorhanden, wird er neu angelegt. |
|||
Zu laufender UDE-Instanz verbinden |
☐ |
bool |
Wenn genau eine UDE-Instanz vorhanden ist, verbindet sich ecu.test zu dieser. |
||
UDE-Instanz immer schließen |
☐ |
bool |
UDE-Instanz schließen, auch wenn diese nicht von ecu.test gestartet wurde. |
||
Target-Konfigurationsdatei |
uri |
Pfad der Target-Konfigurationsdatei auf dem Tools-Server (.cfg-Datei). Kann frei gelassen werden, wenn ein vorhandener Workspace verwendet wird oder zu einer laufenden UDE-Instanz verbunden wird. Pfad kann absolut oder relativ zum Basispfad des Toolhosts angegeben werden. |
|||
Bei Tool-Start automatisch mit Target verbinden |
☑ |
bool |
UDE verbindet sich bei Start direkt mit dem Target. Bei ‚False‘ kann/muss die Verbindung über den Job ‚SetConnectState‘ manuell gestartet werden. |
||
Timeout beim Verbinden des Targets ❲s❳ |
20 |
float |
|||
Programm auf Target laden |
‚No‘ |
[‚If different‘, ‚No‘, ‚Always‘] |
string |
Programmieren des Targets nachdem der Port gestartet wurde |
|
Programm automatisch starten |
☐ |
bool |
Debugger-Ausführung direkt starten, nachdem der Port konfiguriert wurde |
||
Register abfragen |
☑ |
bool |
Um Zeit zu sparen kann durch Einstellung „False“ das Auslesen der verfügbaren Register übersprungen werden. Zugriff auf Register ist dann nur per Job möglich; sie erscheinen nicht im Debugging-Reiter. |
||
Timeout für Toolzugriffe ❲in Sek.❳ |
‚600‘ |
string |
Zeit nach der eine Anfrage an das Tool abgebrochen wird. |
Jobs 🛈¶
GetWindowContent¶
Liest den Inhalt eines Fensters aus.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
contentFormat |
‚CSV‘ |
[‚CSV‘, ‚XML‘] |
string |
Format, in dem der Fensterinhalt abgefragt werden soll. |
|
flags |
0 |
int |
Siehe UDEAutomation.chm, Stichwort „ExportWindowContent“ |
||
windowTitle |
[ONLINE] |
string |
Titel oder Beschreibung des Fensters. Außer den vorgeschlagenen Werten kann auch nur der Titel oder Alternativtitel oder nur die Beschreibung angegeben werden. Bei uneindeutiger Angabe wird das erstbeste übereinstimmende Fenster genommen. |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
string |
Inhalt des Fensters |
MclAddFile¶
Fügt eine Datei zum Multicore loader hinzu.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
binCores |
[] |
object |
Liste von Core-Namen oder -Indizes in denen die Datei als Binary geladen werden soll. |
||
containsSymbols |
True |
[False, True] |
bool |
Gibt an, ob die HEX-Datei Symboldaten enthält. |
|
path |
string |
Absoluter Pfad zur HEX- oder ELF-Datei auf dem Tool Server. |
|||
symCores |
[] |
object |
Liste von Core-Namen oder -Indizes in denen die Datei als Symbole geladen werden soll. Falls die Datei eine HEX-Datei ist, muss der Parameter ‚containsSymbols‘ auf True gesetzt werden. |
MclDoDownload¶
Startet den Flashvorgang mit der gewünschten Option.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
option |
[‚LoadAndFlash‘, ‚VerifyOnly‘, ‚ProgramAndVerify‘] |
string |
Optionen für den Flashvorgang. Siehe UDEAutomation.chm Stichwort ‚DoDownload‘. |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
[False, True] |
bool |
Gibt an, ob der Flashvorgang erfolgreich war. |
MclRemoveAllFiles¶
Entfernt alle Dateien aus dem Multicore loader.
SetUserConfigParam¶
Setzt den referenzierten Konfigurationsparameter.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
name |
string |
Name des Konfigurationsparameters |
|||
section |
string |
Name des beinhaltenden Abschnittes. Kann leer sein. |
|||
value |
object |
Wert vom Typ char, string, int, float oder bool. |