PLCHandler Programming Guide - Esco Drives & Automation

PLCHandler Programming GuideAppendix D: ActiveX-Control of the PLCHandler under WindowsThe PLCHandler also will be provided as ActiveX Control.Before first use the ActiveX-Control must be registered with the following command:regsvr32 plchandlerx.ocxThen the PLCHandlerX class can be used in a Visual-Basic, Delphi or C++ project.The following methods deviate from the methods in the PLCHandler:Connection establishment:Method: long ::ConnectByString(long lId, LPCTSTR pszConfigString, long lConfigLen,long StateChangedEvent, LPCTSTR pszLogFile);Parameter ulId specifies the index of the PLCHandler, if several instances are used.Parameter pszConfigString points to a string containing the content of the ini-file of theconfiguration. For information on the structure of this ini-file please see Fehler!Verweisquelle konnte nicht gefunden werden. lConfigLen specifies the length of theconfigurationstring.StateChangedEvent: Here optionally the handle of an event can be processed, via which theclient can be informed at each state change.pszLogFile is the name of a log file, where the PLCHandler optionally can record all importantactions.Method: long ::ConnectViaGateway(LPCTSTR pszGatewayIP, LPCTSTR pszPlcIP,LPCTSTR pszProtocol, LPCTSTR pszLogFile);This method can be used to establish a connection via TCPIP and the Gateway to a PLCunder Windows. For this purpose only the IP-address of the Gateway as well as the IPaddressof the PLC must be passed. Default setting is the Tcpip L2 Route Protocol („Tcp/Ip(Level 2 Route)“).Method: long ::ConnectViaArti(LPCTSTR pszPlcIP, LPCTSTR pszProtocol,LPCTSTR pszLogFile);Method:This method can be used to establish a connection via TCPIP and ARTI to a PLC. For thispurpose only the IP-address of the PLC must be passed. Default setting is Tcpip L2 RouteProtocol.long ::ConnectViaSimulation(LPCTSTR pszSdbFile, LPCTSTR pszLogFile);Via this method the connection to the simulation mode and to a SDB-file is established. Justthe name of the SDB-file must be specified. Thereby also a complete path can be defined.Browsing of variables:Method:Method:long ::GetNumberOfSymbols();Returns the number of available variables in the PLC.long ::GetSymbol(long lIndex, LPCTSTR pszSymbol, long lMaxLen);GetNumberOfSymbols() can be used to get the number of available variables.GetSymbol() can be used to get the name of the variable which is specified by the index.Synchronous Reading of variables:Method:long ::SyncReadVarFromPlc(LPCTSTR pszSymbol, long lAddressData, long lSize);lAddressData specifies the address, where the value of the variables is stored.pszSymbol specifies the name of one variable. 3S - Smart Software Solutions GmbHPLCHandler Programmming Guide.doc Page 15 of 17