ediabakas

EDIABASElektronik Diagnose Basissystem

BENUTZERHANDBUCH

INSTALLATIONSHANDBUCH

VERSION 6a

Copyright BMW AG, created by Softing AG

USER.DOC

EDIABAS — BENUTZERHANDBUCH

2

INHALT

INHALT ............................................................................................................2

1. Änderungshistorie .................................................................................5

2. Einführung..............................................................................................62.1. Über diese Dokumentation ..............................................................62.2. Konventionen...................................................................................62.3. Besonderheiten, Begriffe, Akronyme...............................................72.4. Warenzeichen .................................................................................7

3. Allgemeines ............................................................................................83.1. Diagnose und Codierung von elektronischen Steuergeräten ..........83.2. Problemstellung...............................................................................83.3. Lösungsansatz ................................................................................103.4. Lösungsrealisierung mit EDIABAS ..................................................123.5. Struktur ............................................................................................133.6. Jobkonzept ......................................................................................153.7. Beschreibungssprache ....................................................................163.8. Abläufe ............................................................................................163.9. Verfügbarkeit ...................................................................................19

4. Installation und Administration ............................................................214.1. Übersicht der Lieferpakete ..............................................................21

4.1.1. RUNTIME SYSTEM............................................................214.1.1.1. Dateien unter WIN32................................................214.1.1.2. Dateien unter WIN16................................................224.1.1.3. Dateien unter SCO-UNIX .........................................224.1.1.4. Dateien unter QNX ...................................................234.1.1.5. Dokumente ...............................................................24

4.1.2. APPLICATION DEVELOPMENT KIT .................................244.1.2.1. Dateien unter WIN32................................................244.1.2.2. Dateien unter WIN16................................................25


3

4.1.2.3. Dateien unter SCO-UNIX .........................................254.1.2.4. Dateien unter QNX ...................................................264.1.2.5. Dokumente ...............................................................27

4.1.3. BEST DEVELOPMENT KIT................................................284.1.3.1. Dateien unter WIN32................................................284.1.3.2. Dateien unter WIN16................................................284.1.3.3. Dokumente ...............................................................29

4.2. Systemvoraussetzungen .................................................................294.2.1. MS-WINDOWS...................................................................294.2.2. SCO-UNIX ..........................................................................304.2.3. QNX ....................................................................................30

4.3. Erstinstallation .................................................................................30MS-WINDOWS................................................................................304.3.2. SCO-UNIX ..........................................................................304.3.3. QNX ....................................................................................31

4.4. Pfad der EDIABAS-Programme ......................................................334.4.1. MS-WINDOWS...................................................................334.4.2. SCO-UNIX ..........................................................................334.4.3. QNX ....................................................................................33

4.5. EDIABAS-Konfiguration...................................................................334.5.1. Suchreihenfolge von EDIABAS.INI .....................................344.5.2. Konfigurationsübersicht ......................................................344.5.3. Auswahl des Hardwareinterfaces........................................374.5.4. MS-WINDOWS...................................................................374.5.5. SCO-UNIX ..........................................................................384.5.6. QNX ....................................................................................384.5.7. Verzeichnis der Steuergerätebeschreibungsdateien ..........384.5.8. Zeichensatzumsetzung .......................................................384.5.9. WIN16/32-Umsetzung.........................................................39

4.6. Starten und Beenden von EDIABAS ...............................................39WIN32 39


4

4.6.2. WIN16.................................................................................404.6.3. SCO-UNIX ..........................................................................404.6.4. QNX ....................................................................................41

4.7. Deinstallation ...................................................................................414.7.1. MS-WINDOWS...................................................................414.7.2. SCO-UNIX ..........................................................................414.7.3. QNX ....................................................................................43

4.8. Schutzmechanismus .......................................................................434.9. Ferndiagnose...................................................................................44

4.9.1. EDIABAS.INI auf dem lokalem PC .....................................454.9.2. EDIABAS.INI auf dem fernzusteuerndem PC.....................454.9.3. Vorgehensweise für die Ferndiagnose................................46

4.10. EDIABAS-Parallelbetrieb.................................................................46

4.11. EDIABAS-Serverbetrieb ..................................................................47

5. Hilfsprogramme......................................................................................48UINSTALL................................................................................................48

SCO-UNIX .......................................................................................485.1.2. QNX ....................................................................................48

5.2. PE....................................................................................................495.3. DEVCLOSE .....................................................................................505.4. BESTINFO.......................................................................................505.5. BESTVER........................................................................................515.6. XTRACT ..........................................................................................525.7. STRIP..............................................................................................54

A. GLOSSAR ...............................................................................................56

B. LITERATURVERZEICHNIS.....................................................................58

C. INDEX ......................................................................................................59


5

1. Änderungshistorie

Version 3.0 Erstellung von Übersicht und Installations- und BenutzerhandbuchVersion 3.0A Zusammenfassung dieser DokumenteVersion 3.0B Hinzufügen der Änderungsdoku, des Glossars und der EinleitungVersion 4.1 Überarbeitung für EDIABAS V4.1.0Version 5 Überarbeitung für EDIABAS V5.1.0Version 5a Erweitert für EDIABAS V5.5.0Version 5b Erweitert für die Ferndiagnose Win32Version 5c Konfiguration für IFH-TraceVersion 5d Überarbeitung der XTRACT-AusgabefunktionalitätVersion 5e Erweitert für QNXVersion 6 Erweitert für EDIABAS V6.0.0Version 6a Überarbeitung für EDIABAS V6.4.0


6

2. Einführung

2.1. Über diese Dokumentation

Diese Dokumentation beschreibt die Handhabung und Funktion des ElektronikDiagnose Basissystem.

2.2. Konventionen

Diese Dokumentation verwendet die folgenden typographischen Konventionen:Beispiel BeschreibungSAMPLE.B2V Großschrift kennzeichnet Dateinamen, Register und

Betriebssystemkommandos.job, string,while

Fettschrift kennzeichnet Schlüsselwörter undOperatoren der Sprachen BEST/2 und BEST/1sowie der API-Funktionen.In Beschreibungen der Syntax müssen diese Wörterwie angegeben geschrieben werden.

ausdruck Kursivschrift kennzeichnet Platzhalter für vomProgrammierer einzutragende Werte, wie z.B.Dateinamen.

[option] Wörter in eckigen Klammern bedeuten optionaleAngaben.

{ result |argument }

Geschweifte Klammern und senkrechte Strichekennzeichnen Eingaben, von denen jeweils einegewählt werden muß, außer wenn sie in eckigenKlammern steht.

[constant...] job... Drei Punkte, die direkt einem Ausdruck folgen,kennzeichnen, daß mehrere Ausdrücke der selbenForm folgen können.

hallo="Test"; Diese Schriftart kennzeichnet Beispiele,Benutzereingaben, Programmausgaben undFehlermeldungen.

while() {..}

Eine Spalte oder eine Zeile aus drei Punktenkennzeichnet, daß ein Teil eines Beispielsabsichtlich weggelassen wurde.

[1] Verweis auf ein Dokument aus demLiteraturverzeichnis.


7

2.3. Besonderheiten, Begriffe, Akronyme

Eine Erklärung der in dieser und allen anderen EDIABAS-Dokumentationenverwendeten Abkürzungen befinden sich im Kapitel "GLOSSAR".

2.4. Warenzeichen

Microsoft, MS, MS-DOS, Windows und Win32 sind registrierte Warenzeichen derMicrosoft Corporation.

SCO, SCO UNIX und OpenServer sind registrierte Warenzeichen der Santa CruzOperation, Inc.

QNX ist registriertes Warenzeichen der QNX Software Systems Ltd.


8

3. Allgemeines

3.1. Diagnose und Codierung von elektronischen Steuergeräten

Elektronische Steuergeräte werden bei Zulieferern der Automobilindustrie, bei denFahrzeugherstellern selbst sowie bei beauftragten Unternehmen entwickelt. Die beiZulieferern gefertigten und getesteten Steuergeräte werden beim Automobilherstellerin das Fahrzeug verbaut, gegebenenfalls über ihre Diagnoseschnittstellefahrzeugspezifisch codiert (programmiert) und auf ihre Funktion im Fahrzeug geprüft.Bei Auftreten eines Fehlers wird mittels elektronischer Diagnose und einesrechnergestützten Testsystems die Fehlerursache ermittelt und der Fehler behoben.Nach Auslieferung des Fahrzeugs werden im Rahmen von Inspektion und Serviceauftretende Fehler in der Werkstatt wiederum mit Unterstützung der elektronischenDiagnose behoben. Beim Tausch eines elektronischen Steuergerätes in derWerkstatt wird das defekte Gerät beim Hersteller instandgesetzt und seine korrekteFunktion mittels elektronischer Diagnose überprüft. Das neu eingebaute Steuergerätmuß eventuell vor Ort fahrzeugspezifisch nachcodiert werden.

Codierung und Prüfung von elektronischen Steuergeräten ist gemäß diesem»Lebenslauf« eine mehrmals wiederkehrende Aufgabenstellung bei:

� Entwicklung des Steuergerätes� Labortests des Steuergerätes� Versuchen im Testfahrzeug� Fertigung des Steuergerätes� Endprüfung des Steuergerätes� Verbau und Check des Steuergerätes in der Vormontage� fahrzeugbezogener Codierung des Steuergerätes� Funktionstest im Fahrzeug� Endprüfung des Fahrzeugs� Service oder Fehlersuche im Rahmen des Kundendienstes� Austausch und Neuprogrammierung in der Werkstatt� Reparatur des Steuergerätes

3.2. Problemstellung

Wird in mehreren Modellreihen in den Fahrzeugen eine größere Anzahl vonSteuergeräten eingesetzt, die zum Teil von mehreren Herstellern entwickelt undgeliefert werden, so entsteht ein sehr hoher »Fluktuationsanteil« von Steuergeräten,da in der Laufzeit einer Fahrzeugreihe ständig Weiterentwicklungen der Subsystemestattfinden. Vergleichend können hier Motore betrachtet werden, die in mehreren


9

unterschiedlichen Ausführungen in der gleichen Karosse einer Fahrzeugreiheeingesetzt werden.

Durch Auslauf und Neueinsatz von Steuergeräten sowie Änderungen anSteuergeräten wachsen die notwendigen Änderungen in den Codier- undPrüfsystemen (Änderung, Inbetriebnahme, Test) überproportional an. Steigen dieAufwendungen für Dokumentation und die Fehlerrisiken.

Durch die starke »Zergliederung« von Aufgaben in großen Unternehmen, sowiedurch sequentielles Arbeiten führen die oben genannten Schritte von derEntwicklung eines Steuergerätes über die Fertigung bis zum Kundendienst zu einermehrfachen Bearbeitung:

Bild 3.2-1: Bisheriger Zustand

Codier- und Prüfprogramme werden beim Steuergeräteentwickler, in derVersuchsabteilung, in der Fertigungsvorbereitung, im Kundendienst und für dieReparatur der Steuergeräte jeweils individuell erstellt. Das heißt, auf Basis einerDokumentation zum Steuergerät werden die Schritte Entwicklung bzw.Weiterentwicklung und Test von Programmen mehrfach durchlaufen. Dieoffensichtlichen Unterschiede in den Aufgabenstellungen und Zielsetzungen dereinzelnen Phasen trüben den Blick für die Gemeinsamkeit, nämlich die jeweilsgleiche Komponente Steuergerät.


10

3.3. Lösungsansatz

Die Gleichteile der o.g. Systeme können nach einer einmaligen Erstellungsphasevon allen Anwendungsprogrammen mehrfach genutzt werden. Dies geschieht imSinne einer Art »Betriebssystem« für Steuergerätekommuniktion, das für jedesSteuergerät einen passenden »Kommunikationstreiber« zur Verfügung stellt.

Bild 3.3-1: Gewünschter Zustand

So wie ein herkömmliches Betriebssystem Informationen über den genauen Zugriffauf Festplatten oder den Bildschirm hinter speziellen Funktionen verbirgt, so verbirgtdieses »Betriebssystem« die genauen Informationen über den Zugriff auf einSteuergerät.

Dieses »Betriebssystem« ist nicht fest an die Anwendungsprogramme gebundenoder gar in Datenbereichen miteinander verknüpft. Es stellt nur »Dienste« zurVerfügung. Diese Dienste können vom Anwendungsprogramm ausgelöst werdenund laufen dann (wenn gewünscht) zeitlich unabhängig von dieser ab. Das Ergebnisdieses »Dienstes« kann nach dessen Abarbeitung dann vom Anwendungsprogrammbearbeitet werden. Das Anwendungsprogramm (der »Client«) und das


11

»Betriebssystem« (der »Server«) tauschen untereinander nur Nachrichten undDaten aus.

Der Server übersetzt die vom Steuergerät kommenden Rohdaten in die vomAnwendungsprogramm gewünschten symbolischen Daten.

Drehzahl = 2000 /min

Auftrag Ergebnis

0011110 10101100

Bild 3.3-2: Übersetzerfunktion

Dabei ist der Server an sich nicht mit eigener Intelligenz ausgestattet, sondernspeichert sein Wissen über die einzelnen Steuergeräte, in leicht (d.h. auch zurLaufzeit) austauschbaren Datenmodulen. Diese Datenmodule enthalten daskomplette (oder nur das benötigte) Wissen über die Übersetzung der binärenSteuergerätedaten in symbolische Daten.

Jedem Client (sprich Anwendungsprogramm) wird eine Softwareschnittstelle zurVerfügung gestellt, die den betriebssystemabhängigen Teil zum Austausch derNachrichten unter einer einheitlichen prozeduralen Schnittstelle verbirgt. MehrereAnwendungsprogramme können dem Server im Time-Sharing-Verfahren ihreAufträge übermitteln. Das heißt, sobald ein Anwendungsprogramm den Serverfreigibt, kann die nächste ihren Auftrag an den Server senden.

Client

Steuergerät

Server


12

3.4. Lösungsrealisierung mit EDIABAS

Die oben genannten Lösungsansätze wurden alle in EDIABAS realisiert. EDIABASkann somit als »Betriebssystem zur Kommunikation mit Steuergeräten inClient/Server Architektur« betrachtet werden. Da der Begriff »Betriebssystem« indiesem Zusammenhang jedoch äußerst mißverständlich wäre, und hier einegemeinsame Basis für andere Anwendungsprogramme geschaffen wurde, wird vonSOFTING der Begriff »Basissystem« verwendet. Wegen des einheitlichen Zweckesder elektronischen Diagnose heißt es:

Elektronik DIAgnose BASissystem = EDIABAS


13

3.5. Struktur

EDIABAS hat unabhängig vom verwendeten Betriebssystem eine feste Struktur.

Anwendung

EDIABAS-API

EDIABAS-Laufzeitsystem

Ablaufsteuerung SGBDen

SGBD-Interpreter

Interfacehandler

Steuergerät

Bild 3.5-1: EDIABAS-Struktur


14

Bild 3.5-1 zeigt ein grobes Abbild der einzelnen Teilkomponenten und der Daten-und Kommunikationspfade.

Das steuergerätespezifische Wissen von EDIABAS steht in denSteuergerätebeschreibungsdateien (SGBDen). Die SGBDen sind variantenorientierterstellt. Das heißt, für jede Steuergerätevariante gibt es genau einevariantenspezifische SGBD. Für alle Steuergeräte einer Gruppe, das sind imallgemeinen Steuergeräte mit gleicher Adresse, kann eine übergeordneteGruppenbeschreibungsdatei existieren. Diese Datei enthält Methoden mit denen sichfeststellen läßt, welche Variante dieser Gruppe am Diagnosebus angeschlossen ist.

Die SGBDen werden vom EDIABAS Laufzeitsystem, bei Auftragserteilung durch einAnwendungsprogramm, geladen und interpretiert. Der Dateiname der SGBD (ohneExtension) ist der Name mit dem die Anwendungsprogramme eineSteuergerätevariante oder Steuergerätegruppe referenzieren.

DME

DME V1 DME V2 DME V3

Bild 3.5-2: SGBD u Gruppen SGBD

Wesentlicher Bestandteil von EDIABAS ist das Laufzeitsystem. DiesesLaufzeitsystem gliedert sich in drei wesentliche Bestandteile:

� Ablaufsteuerung (Kernel)� SGBD-Interpreter� Interfacehandler (IFH)


15

Die Ablaufsteuerung bestimmt das Verhalten des Gesamtsystems und beinhaltet dieKommunikationsschnittstelle zu den Anwendungsprogrammen. Sie ist verantwortlichfür die Dateiverwaltung und die Fehlerverwaltung.

Der SGBD-Interpreter übernimmt die eigentliche Umsetzung der binärenSteuergerätedaten in symbolische Daten. Er interpretiert die in den SGBDenenthaltenen Daten, Methoden und Abläufe, initiiert die Kommunikation mit demSteuergerät und liefert die von ihm gewonnenen Ergebnisse der Ablaufsteuerung zurWeiterleitung an das Anwendungsprogramm zurück.

Der Interfacehandler ist ein austauschbares Softwaremodul, das je nachverwendetem Hardwareinterface in verschiedenen Versionen vom Benutzerhinzugebunden wird. Eine Datenanforderung an das Steuergerät wird vomInterfacehandler in einen Auftrag an das jeweils verwendete Hardwareinterfaceumgesetzt. Die von diesem zurückgelieferten Daten werden von interfaceabhängigenAnteilen bereinigt und können so unabhängig von der verwendetenInterfacehardware ausgewertet werden. Auch vom Interface zurückgegebene Fehlerwerden auf die internen Fehlermeldungen normiert. Der Interfacehandler bietetaußerdem eine Simulation von Steuergeräten an. Somit können auf EDIABASbasierende Anwendungsprogramme auch dann getestet werden, wenn dieverwendeten Steuergeräte nicht vorhanden sind.

Um den Zugriff auf EDIABAS zu vereinfachen, wird jedem Anwendungsprogrammeine Softwareschnittstelle hinzugebunden, die den Zugriff auf EDIABAS über einefest definierte prozedurale Schnittstelle regelt. Dieses sogenannte »ApplicationProgrammers Interface« (EDIABAS-API) übernimmt die systemabhängigeKommunikation zum Laufzeitsystem. Die vom Laufzeitsystem empfangenen Datenwerden innerhalb des EDIABAS-API für das Anwendungsprogramm verwaltet.Dadurch wird das Laufzeitsystem von der Verwaltung dieser Daten entlastet undkonnte somit weitaus kompakter gestaltet werden.

3.6. Jobkonzept

Wie in den generellen Lösungsansätzen bereits gezeigt, bietet EDIABAS als Serverden Clients Dienste an. Die Dienste, die EDIABAS anbietet, werden Jobs genannt.Ein Job ist ein in sich abgeschlossener Auftrag, Daten vom Steuergerät auszulesenund auszuwerten. Er darf jederzeit ohne Berücksichtigung der Auftragsreihenfolgeaufgerufen werden (Grundsatz der Abgeschlossenheit). Der Job liefert nachBearbeitungsende Ergebnisse zurück, die vom Anwendungsprogramm verwendetwerden können. Die Jobs sind nicht fest in EDIABAS programmiert, sondern sindBestandteil der SGDBen. Sie werden nach ihrer Funktion benannt, wie z.B.FEHLERSPEICHER_LESEN oder DREHZAHL_LESEN. Es gibt auch Jobs, dieautomatisch vom Laufzeitsystem aufgerufen werden und somit in jeder


16

Beschreibungsdatei obligatorisch oder optional vorhanden sein müssen. Dazu gehörtder Job INITIALISIERUNG zur Initialisierung der SGBD, der optionale Job ENDE zurDeinitialisierung der SGBD und der Job IDENTIFIKATION in einerGruppenbeschreibungsdatei, der die aktuell verbaute Steuergerätevariante ermittelt.

3.7. Beschreibungssprache

Formuliert werden Jobs in einer eigenen BEschreibungssprache für STeuergeräte(BEST). Diese Beschreibungssprache existiert in zwei Variationen. Es gibt eine low-level, assemblerähnliche Sprache mit Namen BEST/1 und die HochsprachenversionBEST/2 mit 'C'-ähnlicher Syntax.

Im allgemeinen werden alle SGBDen in BEST/2 formuliert. In BEST/2 werden Jobsähnlich wie Funktionen definiert. Das heißt, es gibt einen Jobheader, der alle Ein-und Ausgangsparameter auflistet. Innerhalb eines Jobs können Variablen und Felderdefiniert und benutzt werden. Es stehen alle nötigen arithmetischen Operatoren zurVerfügung. Eine umfangreiche Bibliothek enthält Funktionen zur Manipulation vonDaten und zur Kommunikation mit dem Steuergerät. Die Sprache selbst enthält fastalle aus 'C' bekannten Kontrollstrukturen. Die so formulierten SGBDen müssen vorder Benutzung in EDIABAS mit einem Compiler (BEST2WIN) in ein für dasLaufzeitsystem lesbares Format gebracht werden. Dies geschieht zum einen ausPerfomancegründen und zum anderen sind damit auch Syntaxfehler während derLaufzeit ausgeschlossen.

Zum Test der übersetzten BEST/2 Beschreibungsdateien existiert derQuelltextdebugger BestView. Mit Hilfe von BestView kann der Ablauf eines Jobsgenau verfolgt werden; man kann Variableninhalte überwachen, anzeigen undändern.

3.8. Abläufe

Die Auslösung eines Jobs geschieht im Anwendungsprogramm mittels der API-Funktionen apiJob, apiJobData oder apiJobExt. Diese Funktionen benötigenmindestens zwei Angaben: Das anzusprechende Steuergerät bzw. dieSteuergerätegruppe und der Job der ausgeführt werden soll.

Diese beiden Daten werden an das EDIABAS Laufzeitsystem übertragen. Diesesstellt zuerst fest ob es sich um eine Steuergerätevariante oder um eineSteuergerätegruppe handelt. Wurde eine Gruppe angesprochen, so wirdautomatisch der Job IDENTIFIKATION in der Gruppenbeschreibungsdateiabgearbeitet. Wurde vom Job IDENTIFIKATION eine gültige Steuergerätevarianteermittelt, wird mit Hilfe des Ergebnisses VARIANTE automatisch die zugehörige


17

Variantendatei geladen, so als wäre der Name bereits vom Anwendungsprogrammübergeben worden. In der Variantendatei wird der vom Anwendungsprogrammgeforderte Job bearbeitet. Ein Job kann entweder direkt in der Variantendatei stehenoder er kann in einer Basisdatei stehen. Basisdateien sind SGBDen, auf die von derVariantendatei aus verwiesen wird und die als Teil der Variantendatei betrachtetwerden können. Danach werden die Ergebnisse dieses Jobs demAnwendungsprogramm zur Verfügung gestellt.

Immer wenn eine Beschreibungsdatei neu angesprochen wird, das heißt nach jedemWechsel, wird zuerst der Job ENDE, der zuletzt geladenen SGBD aufgerufen. DieserAufruf erfolgt nur, wenn der Job ENDE in der Datei existiert. Er ermöglicht eineDeinitialisierung der Hardware. Danach wird in der neuen Beschreibungsdatei derJob INITIALISIERUNG aufgerufen. Dieser Job muß obligatorisch in jederBeschreibungsdatei vorhanden sein, und kann zur Initialisierung derInterfacehardware dienen. Erst jetzt wird der im Auftrag angegebene Job ausgeführt.Nach dem erneuten Aufruf des gleichen Jobs wird kein Standardjob mehrausgeführt.

Tritt bei der Verarbeitung eines Jobs ein Fehler in einer der Teilkomponenten auf, sowird die Verarbeitung sofort abgebrochen und eine Fehlermeldung an dasAnwendungsprogramm zurückgegeben. Eventuelle Ergebnisse werden in diesemFall gelöscht. Vor dem erneuten Aufruf des gleichen Jobs wird in diesem Fallautomatisch wieder der Job .INITIALISIERUNG aufgerufen.


18

Bild 3.8-1: SGBD u. Job Auswahl

Während der Abarbeitung eines Jobs werden dessen Befehle sequentiellinterpretiert. Eventuelle Kommunikationsaufträge zum Steuergerät werden vomInterfacehandler weitergereicht und verarbeitet. Die ermittelten Ergebnisse werdenan das Anwendungsprogramm übermittelt.


19

Applikation EDIABAS Steuergerätint data;

apiJob("DMEV3",

"DREHZAHL_LESEN"...);

job ( name:DREHZAHL_LESEN;

result: DREHZAHL;

type: integer

... ) {

char antwort[];send_and_receive(antwort,

tel_drehzahllesen);

-> 59 04 02 03

<- 59 05 03 05 05

DREHZAHL=antwort[3]*256 +

antwort[4];

}

apiResultInt(&variable, "DREHZAHL",set);

printf("Drehzahl: %d",variable);

Bild 3.8-2: Job Ablauf

Das Anwendungsprogramm kann die von EDIABAS gelieferten Ergebnisse mittelsder Funktion apiResultXXX in verschiedenen Formaten auslesen. Dabei wird wennmöglich eine Konvertierung durchgeführt. So kann z.B. Das Ergebnis Drehzahl, dasals Integer in der Beschreibungsdatei errechnet wurde, vom Anwendungsprogrammim Realformat angefordert werden.

3.9. Verfügbarkeit

Das EDIABAS Laufzeitsystem und die EDIABAS-Applikationsentwicklungsumgebungsind als einfach portierbare Systeme entworfen worden. Sie sind derzeit für folgendePlattformen verfügbar:

� MS-WINDOWS 95/98/ME/NT4/2000/XP (WIN32)� MS-WINDOWS 3.11/95/98/ME (WIN16)� SCO OpenServer 5


20

� QNX 4.23

Im Rest des Dokuments wird der Begriff MS-WINDOWS verwendet, wenn eineDarstellung sowohl für WIN32 als auch WIN16 gültig ist.

Die Entwicklungsumgebung für SGBDen ist nur unter MS-WINDOWS verfügbar.

Im Rest des Dokuments wird der Begriff SCO-UNIX gleichbedeutend für SCOOpenServer 5 verwendet.


21

4. Installation und Administration

4.1. Übersicht der Lieferpakete

Insgesammt sind derzeit drei Pakete verfügbar, deren Umfänge im folgenden nähererläutert werden. Dies sind die Pakete

RUNTIME SYSTEMAPPLICATION DEVELOPMENT KITBEST DEVELOPMENT KIT

4.1.1. RUNTIME SYSTEM

Das RUNTIME SYSTEM ist für alle im Kapitel "Verfügbarkeit" aufgeführten Systemeverfügbar. Dieses Lieferpaket ist die Grundlage für alle weiteren EDIABAS-Lieferpakete. Das RUNTIME-SYSTEM muß immer installiert werden.

Das Paket ermöglicht den Anwendungsprogrammen Diagnoseabläufe überEDIABAS zu betreiben.

4.1.1.1. Dateien unter WIN32

Das Lieferpaket RUNTIME SYSTEM enthält folgende Dateien:

README32 InstallationshinweiseBIN\<Paßwortdatei> Der Name der Passwortdatei besteht aus 8 zufälligen

Zeichen. Die Datei hat keine Extension.Beispiel: 07DE3473

BIN\PE.EXE PaßworteditorBIN\ANSI2OEM.TAB Codemapping TabelleBIN\EDIABAS.INI.Example EDIABAS-Konfigurationsdatei (Beispiel)BIN\EBAS32.DLL EDIABAS-LaufzeitsystemBIN\EBAS32.EXE EDIABAS-VisualisierungBIN\API32.DLL Zugriff auf das EDIABAS-Laufzeitsystem BIN\APIVB32.DLL Visual-Basic-Zugriff auf das EDIABAS-LaufzeitsystemBIN\TRACEX32.EXE Trace-Server BIN\BESTINFO.EXE Inhaltsanzeige von BEST-ObjektdateienBIN\BESTVER.EXE Versionskontrolle von BEST-ObjektdateienBIN\XTRACT.EXE Anzeige der Hilfstexte in BEST-ObjektdateienBIN\STRIP.EXE Entfernen der Debug- und Hilfstexte in BEST-

Objektdateien


22

BIN\IFHSRV32.EXE IFH Server für die FerndiagnoseBIN\NMSIFH32.DLL IFH-Service für die FerndiagnoseBIN\VMC32.DLL Verbindungsmanageranbindung für die FerndiagnoseBIN\XEDIC32.DLL EDIC-IFHBIN\XREMOT32.DLL IFH für die FerndiagnoseBIN\NETTCP32.DLL Kommunikations DLL für die FerndiagnoseBIN\NETPRO32.DLL Kommunikations DLL für die FerndiagnoseECU\TMODE.PRG Steuergerätebeschreibungsdatei für den

Transparentmodus


Das Lieferpaket RUNTIME SYSTEM enthält folgende Dateien:

README InstallationshinweiseBIN\PE.EXE PaßworteditorBIN\ANSI2OEM.TAB Codemapping TabelleBIN\EDIABAS.INI EDIABAS-KonfigurationsdateiBIN\EDIABASW.EXE EDIABAS-LaufzeitsystemBIN\API.DLL Zugriff auf das EDIABAS-LaufzeitsystemBIN\APIVB.DLL Visual-Basic-Zugriff auf das EDIABAS-LaufzeitsystemBIN\BESTINFO.EXE Inhaltsanzeige von BEST-ObjektdateienBIN\BESTVER.EXE Versionskontrolle von BEST-ObjektdateienBIN\XTRACT.EXE Anzeige der Hilfstexte in BEST-ObjektdateienBIN\STRIP.EXE Entfernen der Debug- und Hilfstexte in BEST-

ObjektdateienBIN\XEDIC.DLL EDIC-IFHECU\TMODE.PRG Steuergerätebeschreibungsdatei für den

Transparentmodus

4.1.1.3. Dateien unter SCO-UNIX

Bei Installation des Lieferpakets RUNTIME-SYSTEM werden folgende Dateien aufdem Zielsystem angelegt:

readme Installationshinweiseinstall Installationsprogrammuinstall Deinstallationsprogrammprofile Profileerweiterungapiset Script zum Setzen von Environmentvariablen/bin/api.que Referenzdatei/bin/apiboot Start-Script für EDIABAS/bin/apiclose Ende-Script für EDIABAS


23

/bin/apihost.cfg Hilfsdatei für die Kommunikationssoftware/bin/apikill Programm zum Beenden der Kommunikationssoftware/bin/apisys Programm zum Starten der Kommunikationssoftware/bin/apisys.cfg Kommunikationssoftware Konfigurationsdatei/binapisys.raw Template fürKommunikationssoftware

Konfigurationsdatei/bin/apitest EDIABAS Testprogramm/bin/apitrace Kommunikationssoftware Trace/bin/asppatch Hilfsprogramm für Kommunikationssoftware /bin/bestinfo Inhaltsanzeige von BEST-Objektdateien/bin/change Hilfsprogramm für Kommunikationssoftware/bin/das.shm Referenzdatei/bin/das1.trc Tracedatei/bin/das2.trc Tracedatei/bin/devclose Script zum Schließen des Schnittstellentreibers/bin/pe Paßworteditor/bin/ediabas EDIABAS-Laufzeitsystem/bin/ediabas.que Referenzdatei/bin/host Hilfsprogramm für Kommunikationssoftware/bin/setlog Script zur Steuerung der Installationsmeldungen/bin/sigserv Signalserver/bin/sigserv.que Referenzdatei/bin/trace.que Referenzdatei/ecu/edic.prg Beschreibungsdatei für den EDIC-Selbsttest/ecu/tmode.prg Beschreibungsdatei für den Transparentmode

4.1.1.4. Dateien unter QNX

Bei Installation des Lieferpakets RUNTIME-SYSTEM werden folgende Dateien aufdem Zielsystem angelegt:

readme Installationshinweiseinstall Installationsprogrammuinstall Deinstallationsprogrammsysinit.add Erweiterung für Systeminitialisierungsdateiediabas.ini EDIABAS-Konfigurationsdatei/bin/apiboot Start-Script für EDIABAS/bin/apiclose Ende-Script für EDIABAS/bin/apikill Programm zum Beenden der Kommunikationssoftware/bin/apisys Programm zum Starten der Kommunikationssoftware/bin/apisys.cfg Kommunikationssoftware Konfigurationsdatei/bin/apitest EDIABAS Testprogramm/bin/apitrace Kommunikationssoftware Trace/bin/bestinfo Inhaltsanzeige von BEST-Objektdateien


24

/bin/devclose Script zum Schließen des Schnittstellentreibers/bin/ediabas EDIABAS-Laufzeitsystem/bin/pe Paßworteditor/bin/pinstall Installationshilfsprogramm/bin/setlog Script zur Steuerung der Installationsmeldungen/bin/sigserv Signalserver/ecu/tmode.prg Beschreibungsdatei für den Transparentmode

4.1.1.5. Dokumente

Folgende Dokumente beziehen sich auf das RUNTIME-SYSTEM Paket, oder aufEDIABAS im allgemeinen:

BEMERKUNGEN Anmerkungen speziell zu dieserVersion (optional)

BENUTZERHANDBUCH UNDINSTALLATIONSHANDBUCH Dieses DokumentFEHLERREFERENZ Enthält eine Übersicht aller EDIABAS

FehlermeldungenSTEUERGERÄTE-SIMULATOR Beschreibung des Steuergeräte-

Simulators

4.1.2. APPLICATION DEVELOPMENT KIT

Der APPLICATION DEVELOPMENT KIT ist für alle im Kapitel "Verfügbarkeit"aufgeführten Systeme verfügbar. Dieses Lieferpaket ermöglicht die Entwicklung vonAnwendungsprogrammen, die EDIABAS benutzen wollen.

Folgende Entwicklungssysteme werden unter MS-WINDOWS unterstützt:

� Microsoft Visual C/C++ 6.0 (WIN32)� Microsoft Visual C/C++ 1.52 (WIN16)� Microsoft Visual Basic 6.0 (WIN32)� Microsoft Visual Basic 4.0 (WIN32 und WIN16)� Microsoft Visual Basic 3.0 (WIN16)


Das Lieferpaket APPLICATION DEVELOPMENT KIT enthält folgende Dateien:

README32.ADK Installationshinweise


25

API\WIN32API.H Allgemeines C/C++ Headerfile für alleBibliotheken

API\WIN32\APICALLS.C C/C++ Quellcode zu APIW32.LIB undAPIW32MT.LIB

API\WIN32\APIDLL.H C/C++ Headerfile zu API32.DLL(Windows-DLL-Schnittstelle)

API\WIN32\VC60\APIW32.LIB API-Library für single-ThreadAPI\WIN32\VC60\APIW32MT.LIB API-Library für multi-ThreadAPI\ WIN32\VB60\API.BAS Basic-Modul für Visual Basic 6.0API\ WIN32\VB40\API.BAS Basic-Modul für Visual Basic 4.0BIN\APITST32.EXE EDIABAS TestapplikationECU\TESTG.PRG Beispiel-GruppenbeschreibungsdateiECU\TESTV.PRG Beispiel-Variantenbeschreibungsdatei


Das Lieferpaket APPLICATION DEVELOPMENT KIT enthält folgende Dateien:

README.ADK InstallationshinweiseAPI\WIN16\API.H Allgemeines C/C++ Headerfile für alle BibliothekenAPI\WIN16\APICALLS.C C/C++ Quellcode zu APIW.LIB API\WIN16\APIDLL.H C/C++ Headerfile zu API.DLL

(WINDOWS-DLL-Schnittstelle)API\WIN16\VC15\APIW.LIB API-Library für Microsoft Visual C++ 1.52 (Large

Model)API\ WIN16\VB30\API.BAS Basic-Modul für Visual Basic 3.0API\ WIN16\VB40\API.BAS Basic-Modul für Visual Basic 4.0BIN\APITESTW.EXE EDIABAS TestapplikationECU\TESTG.PRG Beispiel-GruppenbeschreibungsdateiECU\TESTV.PRG Beispiel-Variantenbeschreibungsdatei

4.1.2.3. Dateien unter SCO-UNIX

Folgende Dateien sind auf der Lieferdiskette APPLICATION-DEVELOPMENT-KITenthalten und werden auf das Zielsystem kopiert.

readme Installationshinweiseinstall Installationsprogramm/api/cc/api.c Sourcefile für die Erzeugung von libapi.a/api/cc/apiipc.c Sourcefile für die Erzeugung von libapi.a/api/cc/callback.c Sourcefile für die Erzeugung von libapi.a/api/cc/errors.c Sourcefile für die Erzeugung von libapi.a


26

/api/cc/errortxt.c Sourcefile für die Erzeugung von libapi.a/api/cc/help.c Sourcefile für die Erzeugung von libapi.a/api/cc/job.c Sourcefile für die Erzeugung von libapi.a/api/cc/jobdata.c Sourcefile für die Erzeugung von libapi.a/api/cc/results.c Sourcefile für die Erzeugung von libapi.a/api/cc/sco.c Sourcefile für die Erzeugung von libapi.a/api/cc/trace.c Sourcefile für die Erzeugung von libapi.a/api/include/api.h Includefile für die Erzeugung von libapi.a/api/include/apimsg.h Includefile für die Erzeugung von libapi.a/api/include/aspekte.h Includefile für die Erzeugung von libapi.a/api/include/ bip.h Includefile für die Erzeugung von libapi.a/api/include/callback.h Includefile für die Erzeugung von libapi.a/api/include/config.h Includefile für die Erzeugung von libapi.a/api/include/ediabas.h Includefile für die Erzeugung von libapi.a/api/include/error.h Includefile für die Erzeugung von libapi.a/api/include/help.h Includefile für die Erzeugung von libapi.a/api/include/job.h Includefile für die Erzeugung von libapi.a/api/include/jobdata.h Includefile für die Erzeugung von libapi.a/api/include/kernel.h Includefile für die Erzeugung von libapi.a/api/include/msgipc.h Includefile für die Erzeugung von libapi.a/api/include/results.h Includefile für die Erzeugung von libapi.a/api/include/sco.h Includefile für die Erzeugung von libapi.a/api/include/sigserv.h Includefile für die Erzeugung von libapi.a/api/include/trace.h Includefile für die Erzeugung von libapi.a/api/include/traceapi.h Includefile für die Erzeugung von libapi.a/api/include/typedef.h Includefile für die Erzeugung von libapi.a/api/include/unixdef.h Includefile für die Erzeugung von libapi.a/api/include/version.h Includefile für die Erzeugung von libapi.a/api/lib/libapi.a API-Library/api/make/makefile Makefile für die Erzeugung von libapi.a/api/obj/message.o Objectfile für die Erzeugung von libapi.a/api/obj/msgplus.o Objectfile für die Erzeugung von libapi.a/api/obj/signal.o Objectfile für die Erzeugung von libapi.a/api/ecu/testg.prg Test Gruppen-Beschreibungsdatei/api/ecu/testv.prg Test Varianten-Beschreibungsdatei

4.1.2.4. Dateien unter QNX

Folgende Dateien sind auf der Lieferdiskette APPLICATION-DEVELOPMENT-KITenthalten und werden auf das Zielsystem kopiert.

readme Installationshinweiseinstall Installationsprogramm/api/cc/api.c Sourcefile für die Erzeugung von libapi.a


27

/api/cc/apiipc.c Sourcefile für die Erzeugung von libapi.a/api/cc/callback.c Sourcefile für die Erzeugung von libapi.a/api/cc/errors.c Sourcefile für die Erzeugung von libapi.a/api/cc/errortxt.c Sourcefile für die Erzeugung von libapi.a/api/cc/help.c Sourcefile für die Erzeugung von libapi.a/api/cc/job.c Sourcefile für die Erzeugung von libapi.a/api/cc/jobdata.c Sourcefile für die Erzeugung von libapi.a/api/cc/qnx.c Sourcefile für die Erzeugung von libapi.a/api/cc/results.c Sourcefile für die Erzeugung von libapi.a/api/cc/trace.c Sourcefile für die Erzeugung von libapi.a/api/include/api.h Includefile für die Erzeugung von libapi.a/api/include/apimsg.h Includefile für die Erzeugung von libapi.a/api/include/aspekte.h Includefile für die Erzeugung von libapi.a/api/include/ bip.h Includefile für die Erzeugung von libapi.a/api/include/callback.h Includefile für die Erzeugung von libapi.a/api/include/config.h Includefile für die Erzeugung von libapi.a/api/include/ediabas.h Includefile für die Erzeugung von libapi.a/api/include/error.h Includefile für die Erzeugung von libapi.a/api/include/help.h Includefile für die Erzeugung von libapi.a/api/include/job.h Includefile für die Erzeugung von libapi.a/api/include/jobdata.h Includefile für die Erzeugung von libapi.a/api/include/kernel.h Includefile für die Erzeugung von libapi.a/api/include/msgipc.h Includefile für die Erzeugung von libapi.a/api/include/qnx.h Includefile für die Erzeugung von libapi.a/api/include/results.h Includefile für die Erzeugung von libapi.a/api/include/sigserv.h Includefile für die Erzeugung von libapi.a/api/include/trace.h Includefile für die Erzeugung von libapi.a/api/include/traceapi.h Includefile für die Erzeugung von libapi.a/api/include/typedef.h Includefile für die Erzeugung von libapi.a/api/include/unixdef.h Includefile für die Erzeugung von libapi.a/api/include/version.h Includefile für die Erzeugung von libapi.a/api/lib/libapi.a API-Library/api/make/makefile Makefile für die Erzeugung von libapi.a/api/obj/aspekte.o Objectfile für die Erzeugung von libapi.a/api/ecu/testg.prg Test Gruppen-Beschreibungsdatei/api/ecu/testv.prg Test Varianten-Beschreibungsdatei

4.1.2.5. Dokumente

Folgende Dokumente beziehen sich auf das APPLICATION-DEVELOPMENT-KITPaket:API-BENUTZERHANDBUCH Beschreibung der Verwendung der API-

Bibliotheken. Programmbeispiele.Bedienung des APITEST-Programms.


28

API-SCHNITTSTELLENBESCHREIBUNG Beschreibung der API-Schnittstelle undIhrer Bedienung.

API-FUNKTIONSREFERENZ Beschreibung der API-FunktionenTRANSPARENTMODE- Beschreibung der Schnittstelle zumSCHNITTSTELLENBESCHREIBUNG Transparentmode

4.1.3. BEST DEVELOPMENT KIT

Der BEST DEVELOPMENT KIT ist nur für MS-WINDOWS verfügbar. DiesesLieferpaket ermöglicht die Entwicklung von Steuergerätebeschreibungsdateien.

Das Lieferpaket umfaßt u.a. BEST/2 Übersetzer, BEST/2 Debugger und BEST-Entwicklungsumgebung.

Folgende Dateien sind auf der Lieferdiskette BEST-DEVELOPMENT-KIT enthalten:


Das Lieferpaket BEST-DEVELOPMENT-KIT enthält folgende Dateien:

README32.BDK InstallationshinweiseBIN\BEST2WIN.EXE BEST/2 CompilerBIN\BEST2WIN.HLP Hilfedatei zum BEST/2 CompilerBIN\B2RUNTIM.LIB BEST/2 LaufzeitbibliothekBIN\BESTVW32.EXE BEST/2 Debugger: BestViewBIN\BESTVW32.HLP Hilfedatei zum BEST/2 DebuggerBIN\BESTBD32.EXE BEST Entwicklungsumgebung: BestBoardBIN\RUN1632.EXE Hilfsprogramm für BestBoardBIN\RUN16.EXE Hilfsprogramm für BestBoardBIN\APITST32.EXE EDIABAS TestapplikationBIN\APITAL32.EXE EDIABAS TestapplikationBIN\JOBLOO32.EXE EDIABAS TestapplikationECU\TMODE.B1V Transparentmode Beschreibungsdatei (Quelle)ECU\TESTG.B1G Beispiel-Gruppenbeschreibungsdatei, BEST/1ECU\TESTV.B2V Beispiel-Variantenbeschreibungsdatei, BEST/2TUTORIAL\*.* BEST-Tutorial Dateien


Das Lieferpaket BEST-DEVELOPMENT-KIT enthält folgende Dateien:

README.BDK InstallationshinweiseBIN\BEST2WIN.EXE BEST/2 Compiler


29

BIN\BEST2WIN.HLP Hilfedatei zum BEST/2 CompilerBIN\B2RUNTIM.LIB BEST/2 LaufzeitbibliothekBIN\BESTVIEW.EXE BEST/2 Debugger: BestViewBIN\BESTVIEW.HLP Hilfedatei zum BEST/2 DebuggerBIN\BESTBRD.EXE BEST Entwicklungsumgebung: BestBoardBIN\APITESTW.EXE EDIABAS TestapplikationBIN\APITALKW.EXE EDIABAS TestapplikationBIN\JOBLOOPW.EXE EDIABAS TestapplikationECU\TMODE.B1V Transparentmode Beschreibungsdatei (Quelle)ECU\TESTG.B1G Beispiel-Gruppenbeschreibungsdatei, BEST/1ECU\TESTV.B2V Beispiel-Variantenbeschreibungsdatei, BEST/2TUTORIAL\*.* BEST-Tutorial Dateien

4.1.3.3. Dokumente

Folgende Dokumente beziehen sich auf das BEST-DEVELOPMENT-KIT Paket:

BEST-BENUTZERHANDBUCH Beschreibung der Programmierungeiner BEST/2 Beschreibungsdatei.Bedienung des mitgeliefertenProgramme.

BEST/2-FUNKTIONSREFERENZ Beschreibung der BEST/2-FunktionenBEST/2-SPRACHBESCHREIBUNG Syntaktische Beschreibung der BEST/2

Sprache.

4.2. Systemvoraussetzungen

4.2.1. MS-WINDOWS

Um EDIABAS unter MS-WINDOWS benutzen zu können sind die Voraussetzungenfür das jeweilige System zu erfüllen. Es wird ein IBM PC/AT bzw. 100% kompatiblesSystem mit 80386 Prozessor oder besser vorausgesetzt.

Das EDIABAS RUNTIME SYSTEM für WIN32 benötigt unter den Systemen MS-WINDOWS 95/98/ME grundsätzlich eine vorhandene Netzwerkinstallation.

Für die Benutzung der Ferndiagnose-Funktionalität des EDIABAS RUNTIMESYSTEM für WIN32 ist eine Netzwerkinstallation mit TCP/IP erforderlich.


30

4.2.2. SCO-UNIX

Um das EDIABAS unter SCO-UNIX zu benutzen wird ein Computersystem benötigt,das folgende Voraussetzungen erfüllt:

IBM-PC oder 100% kompatibel mit 80486 Prozessor oder besser

� SCO OpenServer 5� 12MB RAM� 3,5" Diskettenlaufwerk (5,25" auf Anfrage)

4.2.3. QNX

Um das EDIABAS unter QNX zu benutzen wird ein Computersystem benötigt, dasfolgende Voraussetzungen erfüllt:

IBM-PC oder 100% kompatibel mit 80386 Prozessor oder besser

� QNX 4.23� 12MB RAM� 3,5" Diskettenlaufwerk

4.3. Erstinstallation

4.3.1. MS-WINDOWS

Die Installationsbeschreibung unter MS-WINDOWS ist nicht Bestandteil diesesDokuments.

4.3.2. SCO-UNIX

Alle in diesem Kapitel aufgeführten Shell-Scripts erfordern zur Ausführung die Korn-Shell.

WICHTIG: Eine bereits installierte EDIABAS-Software ab Version 1.3.0 kannwährend des Installationsvorganges automatisch entfernt werden (optional). ÄltereEDIABAS-Versionen müssen jedoch VOR Installation des neuen EDIABASRUNTIME SYSTEM's manuell gelöscht werden (siehe auch readme-Datei). ImAnschluß ist die Vorgehensweise bei der Installation Schritt für Schritt aufgeführt.

1. Login als Root oder Super-User


31

login root

2. Kopieren und Einrichten des (neuen) EDIABAS RUNTIME SYSTEM's

Aufruf von 'install' (anstelle von '?' ist das Laufwerk anzugeben)

mount /dev/fd?135ds18 /mnt/mnt/install /mntumount /dev/fd?135ds18

Konfigurieren von EDIABAS mittels der EDIABAS-Konfigurationsdatei ediabas.ini(siehe EDIABAS-Konfiguration).

z.B.

;EDIABAS Beispielkonfiguration in ediabas.ini[Configuration]Interface = EDICEcuPath = /usr/ediabas/ecuTracePath = /usr/ediabasSimulationPath = /usr/ediabas/ecuApiTrace = 0IfhTrace = 0Simulation = 0

3. Kopieren und Einrichten des (neuen) APPLICATION DEVELOPMENT KIT's

Aufruf von 'install' (anstelle von '?' ist das Laufwerk anzugeben)

mount /dev/fd?135ds18 /mnt/mnt/install /mntumount /dev/fd?135ds18

4.3.3. QNX


login root

2. Kopieren und Einrichten des EDIABAS RUNTIME SYSTEM's

Nach Einlegen der Diskette "EDIABAS RUNTIME SYSTEM" ist 'install'aufzurufen (anstelle von '?' ist das Laufwerk anzugeben):


32

mount /dev/fd? /mnt/mnt/install /mntumount /mnt

Während der Installation wird abgefragt, ob EDIABAS bei jedem Hochfahren desSystems automatisch gestartet werden soll. Wenn dieser automatische Starterwünscht ist wird die System-Initialisierungsdatei sysinit.<node> von 'install'entsprechend angepasst.

EDIABAS benötigt den Message-Queue-Server 'Mqueue' von QNX, welcher bereitsVOR dem Start von EDIABAS laufen muß.

Beispiel für den Start von 'Mqueue' in sysinit.<node>:

/bin/mqueue &

Konfigurieren Sie EDIABAS über die Konfigurationsdatei /etc/ediabas.ini (sieheEDIABAS-Konfiguration).

z.B.

[Configuration]EcuPath = /usr/ediabas/ecuTracePath = /usr/ediabasSimulationPath = /usr/ediabas/ecuApiTrace = 0IfhTrace = 0Simulation = 0

3. Kopieren und Einrichten des APPLICATION DEVELOPMENT KIT's

Nach Einlegen der Diskette "EDIABAS APPLICATION DEVELOPMENT KIT"ist 'install' aufzurufen (anstelle von '?' ist das Laufwerk anzugeben):

mount /dev/fd? /mnt/mnt/install /mntumount /mnt


33

4.4. Pfad der EDIABAS-Programme

4.4.1. MS-WINDOWS

Das EDIABAS-Unterverzeichnis BIN ist in den Suchpfad des Systems aufzunehmen.

Beispiel für AUTOEXEC.BAT:

SET OLDPATH=%PATH%PATH=c:\ediabas\bin;%OLDPATH%

4.4.2. SCO-UNIX

Das EDIABAS-Unterverzeichnis "bin" wird bei der Installation automatisch imSuchpfad aufgenommen.

4.4.3. QNX

Der Suchpfad wird während der Installation nicht verändert, beim Aufruf vonEDIABAS-Programmen ist der vollständige Pfad anzugeben.

4.5. EDIABAS-Konfiguration

Das Laufzeitverhalten von EDIABAS ist über die EDIABAS-Konfigurationbeeinflußbar.

Die EDIABAS-Konfiguration besteht aus Informationspaaren, welche im Bereich[Configuration] der Datei EDIABAS.INI aufgeführt sind. Jede Zeile beschreibt dabeiein Konfigurationselement und dessen Konfigurationseinstellung:

Konfigurationselement = Konfigurationseinstellung

Zum Zeitpunkt der ersten Initialisierung von EDIABAS werden dieKonfigurationseinstellungen aus der Datei EDIABAS.INI eingelesen. Bei fehlendenKonfigurationseinstellungen wird die Default-Einstellung (s. Tabelle Kap. 4.5.1)angenommen, ebenso wenn die Datei EDIABAS.INI nicht vorhanden ist.

Alle Konfigurationseinstellungen der Datei EDIABAS.INI müssen manuellvorgenommen werden. Die dabei durchgeführten Änderungen werden beimnächsten Start von EDIABAS berücksichtigt.


34

Bestimmte Konfigurationselemente können auch von Anwendungsprogrammen zurLaufzeit von EDIABAS geändert werden. Diese Konfigurationsänderungen sind abernur bis zur nächsten Initialisierung von EDIABAS gültig.

Auch Steuergeräte-Beschreibungsdateien können zur Laufzeit von EDIABASbestimmte Konfigurationsänderungen vornehmen, diese sind aber nur während desJobs gültig.

4.5.1. Suchreihenfolge von EDIABAS.INI

Unter MS-WINDOWS sucht EDIABAS die Datei EDIABAS.INI zuerst entsprechendder Environment-Variable EDIABAS_CONFIG_DIR. Wenn die Environment-Variablenicht gesetzt ist oder im angegebenen Verzeichnis die Datei nicht vorliegt, wird dieSuche im Windows-Verzeichnis fortgesetzt. Falls die Datei auch im Windows-Verzeichnis nicht gefunden wurde, erfolgt die Suche im EDIABAS-Programmverzeichnis (Unterverzeichnis BIN).

Unter SCO-UNIX und QNX sucht EDIABAS die Datei EDIABAS.INI zuerstentsprechend der Environment-Variable EDIABAS_CONFIG_DIR. Wenn dieEnvironment-Variable nicht gesetzt ist oder im angegebenen Verzeichnis die Dateinicht vorliegt, wird die Suche im Verzeichnis /etc fortgesetzt. Falls die Datei auch imVerzeichnis /etc nicht gefunden wurde, erfolgt die Suche im EDIABAS-Programmverzeichnis (Unterverzeichnis BIN).

4.5.2. Konfigurationsübersicht

Nachfolgend sind alle Konfigurationselemente mit Einstellungmöglichkeiten undDefault-Einstellung aufgeführt.

Für jedes Konfigurationselement ist beschrieben, ob und wie eine Änderungvorgenommen werden kann (INI: über EDIABAS.INI, API: durch Anwendung, BEST:durch Steuergeräte-Beschreibungsdatei).

Alle Konfigurationselement in der nachfolgenden Tabelle stehen in der SektionCONFIGURATION.


35

ELEMENT BEMERKUNG EINSTELLUNG ÄNDERUNG DEFAULT

ApiTrace Steuerung von API-Trace 0 (aus)

1 User-Trace

2 + Zeitstempel

3 + Prozeß-ID**

4 API-Trace

5 + Zeitstempel

6 + Laufzeit

7 + Prozeß-ID**

8 Debug-Trace

INI API BEST 0

BipDebugLevel Debug-Level in Steuergeräte-Beschreibungsdateien

0 .. 32767 INI API BEST 0

EcuPath Pfad der Steuergeräte-Beschreibungsdateien

Pfad INI API BEST .

EdiabasIniPath Pfad der verwendetenKonfigurationsdatei EDIABAS.INI(nur falls diese vorhanden ist)

Pfad INI API BEST

EdiabasVersion EDIABAS-Version String INI API BEST

IfhTrace Steuerung von IFH-Trace 0 (aus)

1 UserSchnittstelle

2 + InterfaceSchnittstelle

3 + Zeitstempel

INI API BEST 0

IfhnTrace Steuerung von IFH-Netzwerk-Trace. Dieser Trace ist nur imXREMOTE verfügbar.

0 (aus)

1 UserSchnittstelle

2 + InterfaceSchnittstelle

3 + Zeitstempel

INI API BEST 0

IfhVersion IFH-Version String INI API BEST

Interface Hardwareinterface String INI API BEST EDIC


36

IgnitionHandling Zündung ein/aus wie Fehlerbehandeln

0 (aus)

1 (ein)

INI API BEST 1

LoadWin32 Auswahl des zu verwendendenEDIABAS-Systems für WIN16-Anwendungen (EDIABAS fürWIN16 oder automatischeUmsetzung auf EDIABAS fürWIN32)

0 (EDIABAS fürWIN16)

..

1 (EDIABAS fürWIN32)

INI API BEST Windows9x/ME: 0

WindowsNT/2000/XP: 1

NetworkProtocol Auswahl der Netzwerkprotokollsfür die Ferndiagnose

TCP INI API BEST -

RetryComm Wiederholung bei Kommunika-tionsfehler

0 (aus) .. 1 (ein) INI API BEST 1

Simulation Steuerung von Steuergeräte-Simulation


SimulationPath Pfad der Steuergeräte-Simulationsdateien

Pfad INI API BEST .

SystemResults Steuerung ob Zündungs-,Versorgungsspannungs-, undJobstatus- Systemergebnisseanzulegen sind

0 (nicht anlegen)..1 (anlegen)

INI API BEST 1

TaskPriority Einstellung der Priorität fürEDIABAS (0 = optimaleEinstellung, 1 = NiedrigstePriorität)

0 .. 10 INI API BEST 0

TracePath Pfad der Trace-Dateien Pfad INI API BEST .

TraceSize max. Trace-Dateiengröße in KB 0 .. 32767 INI API BEST 1024

CodeMapping Dateipfad derZeichenumsetztabelle

(nur bei Zeichensatzumsetzung)

Pfad INI API BEST .

UbattHandling Versorgungsspannung ein/aus wieFehler behandeln


** Hinweis: Prozeß-ID wird nur bei EDIABAS für WIN32 ausgegeben

In der nachfolgenden Tabelle stehen die Konfigurationselemente für dasNetzwerkprotokoll TCP (Sektion TCP). Diese Sektion wird nur benötigt, wenn in der


37

Sektion CONFIGURATION dem Konfigurationselement NetworkProtocol der WertTCP zugewiesen wurde.

ELEMENT BEMERKUNG EINSTELLUNG ÄNDERUNG DEFAULT

Port Portnummer 1000...30000 INI API BEST -

RemoteHost Name oder IP-Adresse desfernzusteuerndenRechners

Name/Adresse INI API BEST -

TimeoutConnect Timeout in Millisekundenfür den Verbindungsaufbau

1000 ... 59000 INI API BEST 5000

TimeoutReceive Timeout in Millisekundenfür den Empfang einerMessage

1000 ... 59000 INI API BEST 5000

TimeResponsePending Zeit in Millisekundenzwischen den Alive-Messages (Wird vonEDIABAS V6.4.0 nichtunterstützt)

500 ... 59000 INI API BEST 2000

TimeoutFunction Timeout in Millisekundenfür die Bearbeitung einerlangen IFH-Funktion (z.B.send_and_receive). DerGesamt-Timeoutberechnet sich ausTimeoutFunction +TimeoutReceive.

5000 ... 59000 INI API BEST 59000

4.5.3. Auswahl des Hardwareinterfaces

4.5.4. MS-WINDOWS

Die Bestimmung des zu verwendenden Hardwareinterfaces erfolgt über dieKonfigurationsdatei EDIABAS.INI (Interface).

Derzeit werden folgende Hardwareinterfaces unterstützt:

� SOFTING EDIC


38

Der entsprechende Schnittstellentreiber ist NICHT Bestandteil des Pakets RUNTIMESYSTEM.

4.5.5. SCO-UNIX

Der Schnittstellentreiber ist unter SCO-UNIX nicht konfigurierbar (EinstellungInterface in EDIABAS.INI wird ignoriert) und NICHT Bestandteil des RUNTIMESYSTEM's.

4.5.6. QNX

Der Schnittstellentreiber ist unter QNX nicht konfigurierbar (Einstellung Interface inEDIABAS.INI wird ignoriert) und NICHT Bestandteil des RUNTIME SYSTEM's.

4.5.7. Verzeichnis der Steuergerätebeschreibungsdateien

Das Verzeichnis der zu verwendenden Steuergerätebeschreibungsdateien istmanuell in die Konfigurationsdatei EDIABAS.INI einzutragen (EcuPath).

Weitere Informationen sind in dem Kap. Administration nachzulesen.

4.5.8. Zeichensatzumsetzung

Die Darstellung von nicht im 7-Bit ASCII-Zeichensatz definierten Zeichen (z.B. ö, ä)ist abhängig von der vom Betriebssystem verwendeten Codetabelle. Wenn dieEntwicklung von SGBDs auf einem anderen Rechner als dem Zielrechner erfolgt,kann es bei abweichenden Codetabellen der Rechner zu unterschiedlicherDarstellung der EDIABAS-Ergebnis-Strings kommen.

Dieses Problem ist mit der EDIABAS-Konfiguration CodeMapping vermeidbar. Einehierüber festlegbare Umsetztabelle (Datei mit 256 Zeichen) wird beim Start vonEDIABAS in den Programmspeicher geladen und bewirkt eine automatischeUmsetzung aller EDIABAS-Ergebnis-Strings ins gewünschte Zeichensatzformat.

Die im Lieferpaket enthaltene Umsetztabelle ANSI2OEM.TAB konvertiert den ANSI(Windows) Zeichensatz in den OEM (DOS) Zeichensatz.

Für die Umsetzung wird jedes Zeichen eines EDIABAS-Ergebnis-Strings durch dasentsprechende Zeichen aus der Umsetztabelle ersetzt. Bei der Umsetzung dient daszu ersetzende Zeichen als Index auf das neue Zeichen in der Umsetztabelle.


39

Beispiel:ANSI Zeichensatz (Windows) OEM Zeichensatz (DOS)G (0x47) G (0x47)

E (0x45) E (0x45)

R (0x52) R (0x52)

Ä (0xC4) Ä (0x8E)

T (0x54) T (0x54)

Für die Umsetzung des ANSI Zeichensatzes (Windows) in den OEM Zeichensatz(DOS) ist z.B. für das Zeichen 'Ä' an der Position 0xC4 der Code 0x8E erforderlich.

Für Zeichen, die in der anderen Codetabelle keine Entsprechung haben, wird dasZeichen "." angegeben.

4.5.9. WIN16/32-Umsetzung

Unter den Betriebssystemen Windows 9x/ME/NT4/2000/XP ist eine automatischeUmsetzung von EDIABAS/WIN16-Aufrufen nach EDIABAS/WIN32 möglich.

Das von WIN16-Anwendungen zu verwendende EDIABAS-System kann mit demKonfigurationselement LoadWin32 vorgegeben werden:

� LoadWin32 = 0Der Konfigurationswert 0 bewirkt die Verwendung von EDIABAS/WIN16.

� LoadWin32 = 1Der Konfigurationswert 1 bewirkt die Verwendung von EDIABAS/WIN32 mitautomatischer Umsetzung aller API-Aufrufe.

4.6. Starten und Beenden von EDIABAS

4.6.1. WIN32

Beim Start einer Anwendung mit Zugriff auf EDIABAS werden automatisch dieEDIABAS-Komponenten API32.DLL, EBAS32.DLL, EBAS32.EXE undTRACEX32.EXE geladen. EBAS32.DLL lädt beim ersten Zugriff auf EDIABAS denkonfigurierten Interface-Handler.


40

Der Zugriff von Anwendungen auf EDIABAS erfolgt über API32.DLL.

EDIABAS beendet sich automatisch bei Beendigung der jeweiligen Anwendung.

4.6.2. WIN16

Beim ersten Zugriff einer Anwendung auf EDIABAS wird automatisch das ProgrammEDIABASW.EXE gestartet.

EDIABASW.EXE lädt daraufhin den konfigurierten Interface-Handler.

Der Zugriff von Anwendungen auf EDIABASW.EXE erfolgt über API.DLL.

EDIABASW.EXE steht nach dessen Start bis zum Ausschalten des Systems fürAnwendungen zur Verfügung. EDIABASW.EXE kann über das SystemmenüSchließen wieder beendet werden.

4.6.3. SCO-UNIX

Nach der Installation von EDIABAS (Siehe "Erstinstallation von Diskette") Shutdowndes Systems durchführen und System neu booten

EDIABAS wird während des System-Boot-Vorgangs automatisch hochgefahren undwährend des Shutdown-Vorgangs wieder heruntergefahren. Die EDIABAS-Konfigurationsdatei ediabas.ini wird nur einmal - beim ersten Zugriff einesAnwendungsprogramms - eingelesen.

Der Zugriff von Anwendungen auf EDIABAS erfolgt über die zumAnwendungsprogramm gebundene Library libapi.a.

Normalerweise erfolgt der EDIABAS-Startup/Shutdown automatisch während desSystem-Startup/Shutdown. Zusätzlich kann mit Super-User-Berechtigung einmanueller Startup/Shutdown von EDIABAS durchgeführt werden.

Manueller EDIABAS-Startup (falls EDIABAS noch nicht läuft):

/usr/ediabas/bin/apiboot

Manueller EDIABAS-Shutdown (falls EDIABAS bereits läuft):

/usr/ediabas/bin/apiclose


41

4.6.4. QNX

Wurde während der Installation der automatische Start von EDIABAS gewählt, so istdas System neu zu starten.

Andernfalls ist EDIABAS manuell (mit Super-User-Berechtigung) zu starten:

/usr/ediabas/bin/apiboot

Die EDIABAS-Konfigurationsdatei ediabas.ini wird nur einmal - beim ersten Zugriffeines Anwendungsprogramms - eingelesen.

Der Zugriff von Anwendungen auf EDIABAS erfolgt über die zumAnwendungsprogramm gebundene Library libapi.a.

Normalerweise ist die Beendigung von EDIABAS nicht notwendig, kann aber ggf. mitfolgender Anweisung vorgenommen werden:

/usr/ediabas/bin/apiclose

4.7. Deinstallation

Mit der Deinstallation werden alle installierten EDIABAS-Lieferpakete vom Systementfernt. Das Unterverzeichnis ECU (bzw. ecu unter SCO-UNIX) mit denSteuergeräte-Beschreibungsdateien wird nur gelöscht, wenn dies vom Bedienerverlangt wird. Unter QNX wird das Unterverzeichnis ECU sowie die darin abgelegtenSteuergeräte-Beschreibungsdateien generell nicht gelöscht.

4.7.1. MS-WINDOWS

Die Deinstallationsbeschreibung ist nicht Bestandteil dieses Dokuments.

4.7.2. SCO-UNIX

Das Entfernen der EDIABAS-Software ist mit dem Programm UINSTALL möglich.Vor der Deinstallation müssen alle Programme, die auf EDIABAS zugreifen beendetwerden. Die EDIABAS-Software ist folgendermaßen wieder zu entfernen:


login root


42

2. Eventuell aktive EDIABAS-Software stoppen und EDIABAS-Software mit uinstalllöschen

/usr/ediabas/uinstall

Das Deinstallationsprogramm uinstall ermöglicht das Entfernen der EDIABAS-Software ohne Entfernen der Steuergeräte-Beschreibungsdateien (optional).

Vergewissern Sie sich VORHER, daß sich KEINE Softing-fremde Softwareinnerhalb des Verzeichnisses /usr/ediabas befindet , da diese mitgelöscht wird!!!

3. Alle API bzw. EDIABAS-Einträge in /etc/profile löschen


43

4.7.3. QNX

Das Entfernen der EDIABAS-Software ist mit dem Programm UINSTALL möglich.Vor der Deinstallation müssen alle Programme mit Zugriff auf EDIABAS beendetwerden. Die EDIABAS-Software ist folgendermaßen wieder zu entfernen:


login root

2. Eventuell aktive EDIABAS-Software stoppen und EDIABAS-Software mit uinstalllöschen


Vergewissern Sie sich VORHER, daß sich KEINE Softing-fremde Software innerhalbdes Verzeichnisses /usr/ediabas befindet , da diese mitgelöscht wird!!!

4.8. Schutzmechanismus

EDIABAS greift zur Bearbeitung von API-Aufträgen auf Steuergeräte-Beschreibungsdateien (SGBDen) zu (siehe Kapitel 3). SGBDen werden alsSourcecode (B2V-, bzw. B2G-Datei) in BEST/2 entwickelt und danach für denEinsatz mit EDIABAS mit dem BEST-Compiler in ein Objektformat (PRG-, bzw.GRP-Datei) übersetzt. Zur Laufzeit werden die Objektdateien vom Laufzeitsystemgeladen und ausgeführt.

Um SGBDen im Objektformat zum einen gegen das unbefugte Auslesen vonDateiinhalten (Jobnamen, Tabellennamen, Tabelleninhalte usw.), zum anderen,gegen die Benutzung von unbefugten Anwendern (nicht autorisierte Fremdfirmenoder Privatpersonen) zu schützen, bietet EDIABAS einen Schutzmechanismus fürSGBDen. Die SGBDen werden geschützt, indem Informationen in einer SGBD nichtim Klartext stehen und unter einem nicht autorisierten EDIABAS-Laufzeitsystemnicht ablauffähig sind, d.h. von EDIABAS nicht geladen werden. Damit können wederInformationen aus den SGBDen gelesen noch darin enthaltene Jobs ausgeführtwerden.

Nach der Installation befindet sich das EDIABAS-Laufzeitsystem zunächst in einemZustand, in dem nur ungeschützte SGBDen ausgeführt werden können. Der Schutzder SGBDen erfolgt über die Vergabe von Paßwörtern für das Laufzeitsystem undfür die SGBDen. Die Paßwörter für das Laufzeitsystem werden mit demPaßworteditor (PE) vergeben (siehe Kapitel 5.3). Der Eintrag der Paßwörter in die


44

SGBDen erfolgt mit dem BEST-Compiler BEST2WIN (siehe BESTBenutzerhandbuch Kapitel 5.1 und 5.2).

Für die Vergabe von Paßwörtern können nur die zu einer EDIABAS-Installationgehörenden Programme PE und BEST2WIN verwendet werde.

Der Schutz eines EDIABAS-Systems erfolgt in zwei Schritten:

� Um das EDIABAS-Laufzeitsystem zu schützen müssen dem System mit demPaßworteditor zuerst Paßwörter (mindestens eins) bekannt gemacht werden(siehe Kapitel 5.3).

� Als nächstes müssen alle verwendeten SGBDen mit mindestens einem Paßwortaus der Liste der oben eingegebenen Paßwörter übersetzt werden (siehe BESTBenutzerhandbuch Kapitel 5.1 und 5.2).

Zur Laufzeit werden beim Laden einer SGBD die eingelesenen Daten zuerstentschlüsselt. Danach wird vom Laufzeitsystem geprüft, ob eines der Paßwörter ausder SGBD dem Laufzeitsystem bekannt ist. Ist dem Laufzeitsystem mindestens einPaßwort aus der SGBD bekannt, kann die SGBD ausgeführt werden. SGBDen, dienicht mit einem Paßwort geschützt sind, können von jedem EDIABAS-Laufzeitsystem (geschützt oder ungeschützt) ab der Version 5.5 ausgeführt werden.

4.9. Ferndiagnose

EDIABAS für WIN32 ermöglicht den Zugriff auf Diagnose-Interfaces und damitverbundene Steuergeräte, welche an einem anderen PC angeschlossen sind.

Voraussetzung hierfür ist eine Netzwerkverbindung von lokalem undfernzusteuerndem PC über TCP/IP sowie ein von EDIABAS unterstütztes WIN32-Betriebssystem.

Auf dem lokalen PC laufen Anwendung und EDIABAS, auf dem fernzusteuerndenPC laufen Interface-Handler (IFH) sowie IFH-Server. Vor dem Zugriff auf denfernzusteuernden PC ist dort der IFH-Server IFHSRV32.EXE zu starten.

Die Fernsteuerung wird über die EDIABAS-Konfigurationsdatei EDIABAS.INIeingeschaltet bzw. gesteuert. Die EDIABAS-Konfiguration ist auf beiden PC'smanuell vorzunehmen.

Die EDIABAS-Konfigurationen TracePath und SimulationPath werden nicht vomlokalen PC an den fernzusteuernden PC übertragen, sondern die entsprechendenKonfigurationen der auf dem fernzusteuerndem PC sich befindenden DateiEDIABAS.INI verwendet.


45

Auf beiden PC's ist das Netzwerkprotokoll TCP (Eintrag NetworkProtocol) sowieeine frei wählbare Portnummer anzugeben. Die Portnummer muß auf beiden PC'sidentisch sein und darf nicht mit anderen TCP-Anwendungen kollidieren (1000 <Portnummer < 30000).

4.9.1. EDIABAS.INI auf dem lokalem PC

Auf dem lokalen PC muß die Konfigurationsdatei EDIABAS.INI entsprechend derunten dargestellten Liste erweitert werden. Die Zuweisung REMOTE an dasKonfigurationselement Interface bewirkt die Fernsteuerung des PC's, welcher mitdem Eintrag RemoteHost angegeben wird. Die Angabe eines logischenComputernamens erfordert eine entsprechende HOSTS-Datei bzw. einen DNS-Service.

[Configuration]Interface = REMOTENetworkProtocol = TCP

[TCP]RemoteHost = <Name/Adresse von fernzusteuerndem PC>Port = <Port von fernzusteuerndem IFH>TimeoutConnect=<Timeout für Verbindungsaufbau>TimeoutReceive=<Timeout für Empfang>TimeoutFunction=<Timeout für Verarbeitung im IFH>

Beispiel für die EDIABAS.INI des lokalen PC's:

[Configuration]Interface=REMOTENetworkProtocol=TCP

[TCP]RemoteHost=193.29.29.175Port=5000TimeoutConnect=2000TimeoutReceive=2000TimeoutFunction=50000

4.9.2. EDIABAS.INI auf dem fernzusteuerndem PC

Auf dem fernzusteuernden PC muß die Konfigurationsdatei EDIABAS.INIentsprechend der unten dargestellten Liste erweitert werden.


46

[Configuration]Interface=<Interface>NetworkProtocol=TCP

[TCP]Port=<Port von ferngesteuertem IFH>

Beispiel für EDIABAS.INI des fernzusteuernden PC's:

[Configuration]Interface=EDICNetworkProtocol=TCP

[TCP]Port=5000

4.9.3. Vorgehensweise für die Ferndiagnose

1. EDIABAS auf dem lokalem und fernzusteuerndem PC installieren

2. EDIABAS-Konfiguration auf dem lokalem und fernzusteuerndem PC einrichten

3. IFH-Server auf dem fernzusteuerndem PC starten

4. Anwendung auf dem lokalem PC starten

4.10. EDIABAS-Parallelbetrieb

EDIABAS für WIN32 ermöglicht den gleichzeitigen Zugriff mehrererAnwendungsprogramme auf EDIABAS.

Im Unterschied zu den anderen EDIABAS-Plattformen gibt es unter WIN32 kein 1xauf dem System laufendes EDIABAS, welches nacheinander alleAnwendungsprogramme bedient. Statt dessen läuft für jedes Anwendungsprogrammein eigenes EDIABAS, welches automatisch mit den Anwendungsprogrammengestartet und wieder beendet wird.

Der Parallelbetrieb mehrerer Interfaces gleichen Typs ist nur dann möglich, wenndies von der jeweiligen Interface-Software unterstützt wird.


47

4.11. EDIABAS-Serverbetrieb

Hinweis: Die in diesem Kapitel beschriebene Funktionalität ist nur im BMW-Lieferumfang enthalten!

Der EDIABAS-Server für WIN32 bietet eine Serverfunktionalität entsprechend denfrüheren EDIABAS Versionen 4 und 5. Der gleichzeitige Zugriff mehrererAnwendungen auf EDIABAS (Parallelbetrieb) wird bei Betrieb des EDIABAS-Serversverhindert (Applikations-Locking).

Der EDIABAS-Server bietet jedoch die Funktion, zwischen Serverbetrieb(Applikations-Locking) und Parallelbetrieb umzuschalten. Zum Zeitpunkt derUmschaltung darf KEINE Anwendung bei EDIABAS angemeldet sein, d.h. dieUmschaltung darf nicht während apiInit/apiInitExt..apiEnd einer Anwendung erfolgen.


48

5. Hilfsprogramme

5.1. UINSTALL

Entfernen der EDIABAS-Software.

Dieses Programm ist nur unter SCO-UNIX und QNX verfügbar. Das ProgrammUINSTALL löscht alle installierten EDIABAS-Lieferpakete. Das UnterverzeichnisECU (bzw. ecu unter SCO-UNIX und QNX) mit den Steuergeräte-Beschreibungsdateien wird nicht gelöscht.

5.1.1. SCO-UNIX

Der Aufruf dieses Programms ist nur als Superuser möglich. Mit UINSTALL werdenalle Programme im EDIABAS-Verzeichnis gelöscht (auch EDIABAS-fremdeSoftware). Nach dem Aufruf sollten alle API bzw. EDIABAS-Einträge in /etc/profilegelöscht werden.

Aufruf:


Beispiel:login root/usr/ediabas/uinstall

5.1.2. QNX

Der Aufruf dieses Programms ist nur als Superuser möglich. Mit UINSTALL werdenalle Programme im EDIABAS-Verzeichnis gelöscht (auch EDIABAS-fremdeSoftware).

Aufruf:


Beispiel:login root/usr/ediabas/uinstall


49

5.2. PE

Mit dem Paßworteditor werden die Paßwörter eines geschützten EDIABAS verwaltet.Der Paßworteditor hat den Namen PE.EXE. Ein Paßworteintrag besteht aus einemöffentlichen Label und dem zugehörigen geheimen Paßwort. Das Paßwort wird nureinmal bei der Eingabe verwendet. Für alle weiteren Zugriffe wird nur noch das Labeldes Paßwortes verwendet.

Es können maximal 10 Label/Paßwörter eingegeben werden.

Einmal eingegebene Label/Paßwörter können nicht mehr entfernt werden. Falls dieserwünscht ist, muß EDIABAS neu installiert werden.

Jedes Label/Paßwort kann gesperrt oder freigegeben werden (mehrfach möglich).Ein gesperrtes Label /Paßwort verhält sich zur Laufzeit wie nicht vorhanden.

Ein <Label> besteht aus 1 bis 10 ASCII-Zeichen im ANSI Code. Dabei sind nurASCII-Zeichen zugelassen im Bereich: 20h <= <ASCII-Zeichen> <= 7Eh. DasZeichen '@' (40h) ist nicht erlaubt.

Ein <Paßwort> besteht aus 6 bis 10 ASCII-Zeichen im ANSI Code. Dabei sind nurASCII-Zeichen zugelassen im Bereich: 20h <= <ASCII-Zeichen> <= 7Eh.

Der Paßworteditor wird über die Kommandozeile gesteuert. Der Editor bietetfolgende Funktionalitäten:

� Anzeigen aller Kommandos des PaßworteditorsDiese Funktion des Paßworteditors stellt eine Hilfefunktion dar und zeigt alleverfügbaren Kommandos an.Aufruf: pe

� Anzeigen (view) aller Labels der PaßwortdateiMit dem Paßworteditor können die Labels aller Paßwörter, die demLaufzeitsystem bekannt sind, mit ihrem Status (freigegeben/gesperrt) angezeigtwerden.Aufruf: pe -v

� Eingabe (add) eines neuen Eintrags in die PaßwortdateiEintragen eines neuen Label/Paßworts in das EDIABAS-Laufzeitsystem. Eskönnen insgesamt maximal 10 Einträge gemacht werden. Bei der Eingabeerhalten die Einträge automatisch den Status "freigegeben".Aufruf: pe -a <Label>=<Paßwort>


50

� Freigeben (enable) eines Eintrags der PaßwortdateiGesperrte Einträge können wieder freigegeben werden. Mehfach möglich.Aufruf: pe -e <Label>

� Sperren (disable) eines Eintrags der PaßwortdateiEingegebene Einträge können gesperrt werden. Gesperrte Einträge verhaltensich beim Ablauf von SGBDen wie nicht vorhandene Einträge. Mehrfachmöglich.Aufruf: pe -d <Label>

� Prüfen (check), ob eine SGBD auf dem installierten EDIABAS-Systemlauffähig wäre.Mit dem Paßworteditor kann außerdem geprüft werden, ob SGBDen inVerbindung mit dem installierten EDIABAS-Systems ablauffähig sind. Für diesePrüfung holt sich der Paßworteditor die Paßwörter aus der SGBD und vergleichtsie mit den Paßwörtern des Systems.Aufruf: pe -c <SGBD>

Der Paßworteditor liefert als Exitcode im Fehlerfall den Wert 1, sonst 0.

Es kann nur der zu einer EDIABAS-Installation gehörende Paßworteditorverwendet werden.

5.3. DEVCLOSE

Schliessen des Schnittstellentreibers.

Dieses Programm ist nur unter SCO-UNIX und QNX verfügbar. Falls nachBenutzung von EDIABAS eine EDIABAS-fremde Software auf denSchnittstellentreiber zugreifen möchte und sich dieser noch im geöffneten Zustandbefindet, kann mit dem Programm DEVCLOSE der Schnittstellentreibergeschlossen werden.

Aufruf:

devclose

5.4. BESTINFO

Inhaltsanzeige von Steuergeräte-Beschreibungsdateien

Das Programm BESTINFO ermöglicht die Ausgabe folgender Informationenbezüglich der angegebenen Steuergeräte-Beschreibungsdatei (Objektformat):


51

DateinameRevisionsnummerLetzter Bearbeiter (Ausgabe von max. 63 Zeichen), Datum der letzten ÄnderungListe aller Jobs

Aufruf:

bestinfo sgbd

Beispiel:

bestinfo testv.prg

Erzeugt folgende Ausgabe (Beispiel) :

BEST object file : testv.prgBIP version : 03.03.00.00Revision number : 2.0

Last modification by softing.sag.Os , Thu Mar 25 16:33:101993

5 Jobs: INITIALISIERUNG IDENT CHECK BINPARA WAIT

BESTINFO ready.

5.5. BESTVER

Versionskontrolle von Steuergeräte-Beschreibungsdateien

Dieses Programm ist nur unter MS-WINDOWS verfügbar. Es ermöglicht dieDurchführung einer Versionskontrolle von Steuergeräte-Beschreibungsdateien(Objektformat). Es ermöglicht die Vergabe einer einheitlichen Paketversionsnummerfür mehrere Beschreibungsdateien.

Aufruf:

BESTVER[-R RevMAJ.RevMIN username] [-V Packageversion] sgbd(en)


52

Beispiel:

bestver -R 1.6 Softing -V 20 testv.prg

Ändert den Revisionseintrag (Revision 2.0 wird 1.6 und Autor wird Softing) undvergibt ein Paketversionsnummer (20). Es wird folgendes ausgegeben :

TESTV.PRG BIP version : 03.03.00.00 Revisionnumber : 2.0 Last change : Thu Mar 25 16:33:10 1993 By : softing.sag.Os Package version : 00000000 ==> Revisionnumber : 1.6 Last change : Wed Nov 24 12:41:50 1993 By : Softing Package version : 00000020

Die Ausgabe des letzten Bearbeiters ist auf max. 63 Zeichen beschränkt.

5.6. XTRACT

Anzeige von Hilfstexten aus Steuergeräte-Beschreibungsdateien

Dieses Programm ist nur unter MS-WINDOWS verfügbar. Mit dem ProgrammXTRACT können die in den BEST-Objectdateien angelegten Hilfetexte angezeigtwerden.

Aufruf:

XTRACT [-F] objectfile(s) [outdir]XTRACT -? (Zeigt eine Optionsübersicht)

Die Option -F leitet die Ausgabe in eine Datei mit der Extension .biv oder .big um.Es kann das Directory angegeben werden, wo die Ausgabedatei erzeugt werden soll.In objectfile können Wildcard verwendet werden.

Beispiel:

xtract -F testv.prg

Erzeugt eine Datei testv.biv mit folgendem Inhalt:

ECU:TESTV


53

ORIGIN:softing.sag.Os REVISION:2.0AUTHOR:softing.sag.Os ECUCOMMENT:Beschreibungsdatei OHNE Zugriff auf das Interface ECUCOMMENT:Ursprung: TESTV.B1V JOBNAME:initialisierungJOBCOMMENT:InitialisierungRESULT:DONERESULTTYPE:intRESULTCOMMENT:1 falls ok, sonst 0JOBNAME:IDENTJOBCOMMENT:Ermittlung des Identifikations-StringsRESULT:JOB_STATUSRESULTTYPE:stringRESULTCOMMENT:Liefert: OKAY od. ERROR_PARAMETER...RESULTCOMMENT:Liefert: OKAY oder ERROR_PARAMETER


54

Automatische Tabellenausgabe:

Zur besseren Dokumentationsmöglichkeit von BEST-Objects bietet XTRACT auchdie Funktionalität, anstelle eines BEST/2-Kommentars die Einträge einer Tabelleauszugeben. Ein BEST/2-Kommentar muß hierfür folgenden Aufbau aufweisen:

comment: table <Tabellenname> <Spalte> [ <Spalte> ... ]

Beispiel einer BEST/2-Quelldatei:

...table beispielTabelle[2][]={{ "SPALTE1", "SPALTE2", "SPALTE3" },

{ "Zeile1", "xtract", "generiert" },{ "Zeile2", "diese", "Texte" },{ "Zeile3", "automatisch", "!" }};

job ( name = beispielJob; comment : Kommentaranfang comment : table beispielTabelle SPALTE2 SPALTE3

comment : Kommentarende...

XTRACT gibt für obiges Beispiel folgende Zeilen aus:

...JOBNAME:beispielJobJOBCOMMENT:KommentaranfangJOBCOMMENT: "xtract" "generiert"JOBCOMMENT: "diese" "Texte"JOBCOMMENT: "automatisch" "!"JOBCOMMENT:Kommentarende...

5.7. STRIP

Entfernen von Zusatzinformationen aus Steuergeräte-Beschreibungsdateien

Dieses Programm ist nur unter MS-WINDOWS verfügbar. Mit dem Programm STRIPkönnen die in den BEST-Objectdateien angelegten Hilfetextes und Debuginformationentfernt werden.


55

Aufruf:

STRIP [-N] dh sourcefile(s) [outdir]STRIP -? (Zeigt eine Optionsübersicht)

Der Parameter d zeigt an, das die Debuginformation entfernt werden sollen. DerParameter h bedeutet, daß die Hilfetexte entfernt werden. Es kann das Directoryangegeben werden, wo die Ausgabedatei erzeugt werden soll. Wird eine bereitsbestehende Objectdatei überschrieben, so fragt STRIP den Benutzer davor. DieseAbfrage kann mit der Option -N unterbunden werden.

Beispiel:

strip -N dh testv.prg

Entfernt die Debuginformation und die Hilfetexte aus der Datei testv.prg.


56

A. GLOSSAR

API:Schnittstelle des EDIABAS zur Applikation hin (Application-Programmers-Interface).

Applikation:Anwendungsprogramm zur Durchführung der Diagnose und Codierung vonSteuergeräten.

BEST:BEschreibungssprache für STeuergeräte.

Beschreibungsdatei:Enthält alle zur Daten und Methoden die zur Beschreibung der Diagnosefunktioneines Steuergeräts nötig sind.

Device:Logisches Gerät, das zur Anbindung an das Interface benutzt wird.

Diagnosekonzepte:Konventionen nach ISO, in denen der Zugriff auf Diagnosedaten in Steuergerätenbeschrieben wird.

DLL:Dynamic Link Library, dynamische Funktionsbibliothek unter MS-Windows, wird erstzur Laufzeit an die Applikation gebunden.

ECM:Electronic Control Module = Abkürzung für Steuergerät

ECU:Electronic Control Unit = Abkürzung für Steuergerät

EDIABAS:Elektronik DIAgnose BASissystem (API, Laufzeitsystem und Interface-Handler).

EDIC:Enhanced Diagnostic Interface Computer.

IFH:InterFace-Handler, Software-Interface zur Bedienung der EDIC-Funktionen. DieKommunikation mit dem EDIC-Interface erfolgt über den EDIC-Treiber.

Job:


57

Methode in einer SGBD, die Daten aus dem Steuergerät ausliest.

Laufzeitsystem:Laufzeitsystem von EDIABAS mit BEST-Interpreter.Das Laufzeitsystem handelt einen über API abgesetzten Auftrag ab, indem esentsprechende Steuergeräte-Beschreibungsdateien lädt und interpretiert. In diesenSteuergeräte-Beschreibungsdateien sind neben den steuergerätespezifischenParametern die entsprechenden Vorschriften, Methoden und Abläufe zurAuftragsbearbeitung aufgeführt.

SGBD:Abkürzung für Steuergerätebeschreibungsdatei(->Beschreibungsdatei).

SG:Abkürzung für Steuergerät

Steuergerätevariante:Funktionsunterschiedliche Ausführungen einer Steuergerätegruppen, Es erfolgtkeine Unterscheidung in Ausführungstypen (z.B. Länderausführung, Codier-Variante).Bei nur 1 Ausführung innerhalb einer Steuergerätegruppe ist das Steuergerätebenfalls als Steuergeräte-Variante aufzufassen.


58

B. LITERATURVERZEICHNIS


59

C. INDEX

Ablaufsteuerung 15API 58API.DLL 42API32.DLL 41apiJob 17apiJobData 17apiJobExt 17ApiTrace 36Applikation 58

Basissystem 13Beschreibungsdatei 58BEST 17, 58BestView 17BipDebugLevel 36

Client/Server 13Client-Server 11CodeMapping 38, 40CONFIGURATION 36

Default-Konfiguration 35, 36, 39Device 58Diagnosekonzepte 58DLL 58

EBAS32.DLL 41EBAS32.EXE 41ECM 58ECU 58EcuPath 36EDIABAS 58EDIABAS.INI 35, 36EDIABAS_CONFIG_DIR 35EdiabasIniPath 36EdiabasVersion 36EDIABASW.EXE 42EDIC 39, 58ENDE 17, 18

Ferndiagnose 46

Hardwareinterface 39

IDENTIFIKATION 17, 18IFH 58IfhnTrace 37IfhTrace 37IfhVersion 37IgnitionHandling 37INITIALISIERUNG 17, 18Interface 37Interfacehandler 15

Job 16, 59

Konfiguration 35Konfigurationsdatei 35, 36Konfigurationseinstellung 35, 36, 39Konfigurationselement 35, 36, 39

Laufzeitsystem 59libapi.a 42, 43

NetworkProtocol 37

Parallelbetrieb 48PE.EXE 51Port 39

RemoteHost 39RetryComm 37Revisionsnummer 53

Schnittstellentreiber 39Schutzmechanismus 45Serverbetrieb 49SG 59SGBD 15, 59Simulation 37SimulationPath 37


60

Steuergerät 59Steuergerätebeschreibungsdateien 15,40Steuergerätegruppe 59Steuergerätevariante 59SystemResults 37

TaskPriority 38TimeoutConnect 39TimeoutFunction 39TimeoutReceive 39TimeResponsePending 39Time-Sharing-Verfahren 13TracePath 38TraceSize 38TRACEX32.EXE 41

UbattHandling 38UINSTALL 43, 45

Zeichensatzumsetzung 40, 41

ediabakas

Documents

application development

best development kit

ediabas benutzerhandbuch34

acopyright bmw

created by softing aguser

elektronischen steuergerten

runtime system