ESI_EC_COM_DE

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);

    };

    };