Upload
rata-katy
View
214
Download
0
Embed Size (px)
Citation preview
7/25/2019 ESI_EC_COM_DE
1/5
Seite 1 von 5
Copyright Robert Bosch GmbH, Automotive Aftermarket, Product Marketing Diagnostics & Test Equipment
ESI[tronic]
COM-Schnittstellenbeschreibungzur bernahme eines SIS/CAS Fehlercodeprotokolls aus ESI[tronic]
Stand: 18.02.04
Version 1.0
Kontakt:Email: [email protected]: www.esitronic.comFax: +49 (0) 180 5812310
Dokument:ESI_EC_COM.PDF (aus Quelldatei ESI_EC_COM.DOC erstellt)
7/25/2019 ESI_EC_COM_DE
2/5
Seite 2 von 5
Copyright Robert Bosch GmbH, Automotive Aftermarket, Product Marketing Diagnostics & Test Equipment
Inhaltsverzeichnis
1. Zielsetzung ............................................................................................................................. 32. Schnittstelle ............................................................................................................................ 3
2.1. Beschreibung .................................................................................................................... 32.1.1. Setzen des Applikationsnames in ESI[tronic]..................................................................3
2.1.2. Senden des SIS/CAS Fehlercodeprotokolls ..................................................................... 33. Anhang...................................................................................................................................5
3.1. TypeLib ............................................................................................................................ 5
7/25/2019 ESI_EC_COM_DE
3/5
Seite 3 von 5
Copyright Robert Bosch GmbH, Automotive Aftermarket, Product Marketing Diagnostics & Test Equipment
1.Zielsetzung
Beschreibung/Bereitstellung einer Kommunikationsschnittstelle zwischen ESI[tronic] und einer exter-nen Anwendung.
2.Schnittstelle
Die zu realisierenden Funktionen basieren auf der von Microsoft entwickelten COM-Technologie undsind im folgenden detailliert beschrieben. ESI[tronic] wird dabei ausschlielich als COMServer einge-setzt.
2.1.Beschreibung
2.1.1.
Setzen des Applikationsnames in ESI[tronic]
Aufruf in Client Anwendung durch:
Funktionsname: RegisterTyp: MethodeKurzbeschreibung: Identifiziert Client-Applikation in ESI[tronic]Aufruf: ext. AnwendungESI[tronic]Detail:
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. AnwendungVoraussetzungen:
- es muss eine COM-Verbindung bestehen, andernfalls wird der Sendebutton aus-geblendet.
- Es muss ein Fehlercodeprotokoll vorhanden sein, andernfalls ist der Sendebuttonzwar sichtbar, jedoch deaktiviert.
7/25/2019 ESI_EC_COM_DE
4/5
Seite 4 von 5
Copyright Robert Bosch GmbH, Automotive Aftermarket, Product Marketing Diagnostics & Test Equipment
Senden des SIS/CAS Fehlercodeprotokolls:
Ablaufphasen:1. Initialisierung2. Datenbernahme3. Abschluss
Phase Initialisierung:
Funktionsname: Ident_RBTyp: EventKurzbeschreibung: bergabe der FahrzeugdatenAufruf: ESI[tronic] ext. AnwendungDetail:
HRESULT Ident_RB (
[in] BSTR Brand, (Marke)
[in] long Number, (Nummer)
[in] BSTR Year); (Baujahr(e))
Funktionsname: BeginTransferECTyp: EventKurzbeschreibung: Anzahl der Fehlercodes werden bergebenAufruf: ESI[tronic] ext. AnwendungDetail:
HRESULT BeginTransferEC (
[in] short NumOfCodes);, (Anzahl Datenstze)
Phase Datenbernahme:Funktionsname: ECItemTyp: EventKurzbeschreibung: Datensatz des Fehlercodeprotokolls wird an ext. Anwendung gesendet
Aufruf: ESI[tronic] ext. AnwendungDetail:
HRESULT ECItem(
[in] BSTR ErrorCode); (Zeile Fehlercodeprotokoll)
Phase Abschluss:Funktionsname: EndTransferECTyp: EventKurzbeschreibung: Abschluss der DatenbernahmeAufruf: ESI[tronic] ext. AnwendungDetail:
HRESULT EndData();
7/25/2019 ESI_EC_COM_DE
5/5
Seite 5 von 5
Copyright Robert Bosch GmbH, Automotive Aftermarket, Product Marketing Diagnostics & Test Equipment
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);
};
};