PLS: UDE¶

Herstellerinformationen

Hersteller	Webseite	Produktname	Version
PLS Development Tools	http://www.pls-mc.com	Universal Debug Engine	4.2 bis 2025.2

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¶

Port DEBUGGER - DEFAULT

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	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.

Parameter

Name	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.

Parameter

Name	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.

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.

Parameter

Name	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.