Sie sind auf Seite 1von 5

Seite 1 von 5

ESI[tronic]
COM-Schnittstellenbeschreibung
zur bernahme eines SIS/CAS Fehlercodeprotokolls aus ESI[tronic]

Stand: 18.02.04
Version 1.0

Kontakt:
Email: ESItronic@msw-stuttgart.de
Web: www.esitronic.com
Fax:
+49 (0) 180 5812310
Dokument:
ESI_EC_COM.PDF (aus Quelldatei ESI_EC_COM.DOC erstellt)

Copyright Robert Bosch GmbH, Automotive Aftermarket, Product Marketing Diagnostics & Test Equipment

Seite 2 von 5

Inhaltsverzeichnis
1. Zielsetzung ............................................................................................................................. 3
2. Schnittstelle ............................................................................................................................ 3
2.1. Beschreibung .................................................................................................................... 3
2.1.1. Setzen des Applikationsnames in ESI[tronic] .................................................................. 3
2.1.2. Senden des SIS/CAS Fehlercodeprotokolls ..................................................................... 3
3. Anhang................................................................................................................................... 5
3.1. TypeLib ............................................................................................................................ 5

Copyright Robert Bosch GmbH, Automotive Aftermarket, Product Marketing Diagnostics & Test Equipment

Seite 3 von 5

1. Zielsetzung
Beschreibung/Bereitstellung einer Kommunikationsschnittstelle zwischen ESI[tronic] und einer externen Anwendung.

2. Schnittstelle
Die zu realisierenden Funktionen basieren auf der von Microsoft entwickelten COM-Technologie und
sind im folgenden detailliert beschrieben. ESI[tronic] wird dabei ausschlielich als COMServer eingesetzt.

2.1. Beschreibung
2.1.1. Setzen des Applikationsnames in ESI[tronic]
Aufruf in Client Anwendung durch:
Funktionsname:
Typ:
Kurzbeschreibung:
Aufruf:
Detail:

Register
Methode
Identifiziert Client-Applikation in ESI[tronic]
ext. Anwendung ESI[tronic]
HRESULT Register(
[in] BSTR ApplicationName);

(Inhalt von Applikationsname wird in


ESI[tronic] Button benommen)

2.1.2. Senden des SIS/CAS Fehlercodeprotokolls


Aufruf in ESI[tronic] durch:
Men: Einstellungen ->
Benutzerdefiniert ->
Tabellenreiter: Arbeitsprotokoll SIS/CAS ->
Button: Protokoll an ext. Anwendung senden
Richtung:
ESI[tronic] ext. Anwendung
Voraussetzungen:
- es muss eine COM-Verbindung bestehen, andernfalls wird der Sendebutton ausgeblendet.
- Es muss ein Fehlercodeprotokoll vorhanden sein, andernfalls ist der Sendebutton
zwar sichtbar, jedoch deaktiviert.

Copyright Robert Bosch GmbH, Automotive Aftermarket, Product Marketing Diagnostics & Test Equipment

Seite 4 von 5

Senden des SIS/CAS Fehlercodeprotokolls:


Ablaufphasen:

1. Initialisierung
2. Datenbernahme
3. Abschluss

Phase Initialisierung:
Funktionsname:
Typ:
Kurzbeschreibung:
Aufruf:
Detail:

Ident_RB
Event
bergabe der Fahrzeugdaten
ESI[tronic] ext. Anwendung
HRESULT Ident_RB (
[in] BSTR Brand,
[in] long Number,
[in] BSTR Year);

Funktionsname:
Typ:
Kurzbeschreibung:
Aufruf:
Detail:

(Marke)
(Nummer)
(Baujahr(e))

BeginTransferEC
Event
Anzahl der Fehlercodes werden bergeben
ESI[tronic] ext. Anwendung
HRESULT BeginTransferEC (
[in] short NumOfCodes);,

(Anzahl Datenstze)

Phase Datenbernahme:
Funktionsname:
Typ:
Kurzbeschreibung:
Aufruf:
Detail:

ECItem
Event
Datensatz des Fehlercodeprotokolls wird an ext. Anwendung gesendet
ESI[tronic] ext. Anwendung
HRESULT ECItem(
[in] BSTR ErrorCode);

Phase Abschluss:

Funktionsname:
Typ:
Kurzbeschreibung:
Aufruf:
Detail:

(Zeile Fehlercodeprotokoll)

EndTransferEC
Event
Abschluss der Datenbernahme
ESI[tronic] ext. Anwendung
HRESULT EndData();

Copyright Robert Bosch GmbH, Automotive Aftermarket, Product Marketing Diagnostics & Test Equipment

Seite 5 von 5

3. Anhang
3.1. TypeLib
// Generated .IDL file (by the OLE/COM Object Viewer)
//
// typelib filename: Esi2.tlb
[
uuid(AF21D48D-7AED-4A7C-9D03-773FC64B2361),
version(1.0),
helpstring("Esi2 1.0 Typbibliothek")
]
library Esi2Lib
{
// TLib :
// TLib : OLE Automation : {00020430-0000-0000-C000-000000000046}
importlib("stdole2.tlb");
// Forward declare all types defined in this typelib
interface ICASSIS;
dispinterface _IESImaticEvents;
interface IESImaticCP;
interface IAWConnectionMsgSink;
interface IESImatic;
interface IPWEventProxy;
dispinterface _IRepDocEvents;
interface IRepDoc;
dispinterface _IErrorCodeEvents;
interface IErrorCode;
. . .
[
uuid(E6683D90-853E-4E08-A058-C4C2E3CB80C1),
helpstring("_IErrorCode-Ereignisschnittstelle")
]
dispinterface _IErrorCodeEvents {
properties:
methods:
[id(0x00000001)]
void Ident_RB(
[in] BSTR Brand,
[in] long Number,
[in] BSTR Year);
[id(0x00000002)]
void BeginTransferEC([in] short NumOfCodes);
[id(0x00000003)]
void ECItem([in] BSTR ErrorCode);
[id(0x00000004)]
void EndTransferEC();
};
[
uuid(FD2DFFBE-3C0D-458A-AFD3-4E8EBD12459F),
helpstring("ErrorCode Class")
]
coclass ErrorCode {
[default] interface IErrorCode;
[default, source] dispinterface _IErrorCodeEvents;
};
[
odl,
uuid(4085EDF9-CC9C-41B6-AB69-BCD83A1D7A02),
helpstring("IErrorCode-Schnittstelle"),
dual,
oleautomation
]
interface IErrorCode : IDispatch {
[id(0x00000001)]
HRESULT Register([in] BSTR ApplicationName);
};
};

Copyright Robert Bosch GmbH, Automotive Aftermarket, Product Marketing Diagnostics & Test Equipment