IBHNet:Accessing PLC variables

From IBHsoftec Wiki English
Revision as of 12:18, 25 June 2012 by Jonas (Talk | contribs)

Jump to: navigation, search

Accessing PLC variables

The IBHNet network driver ships with an object, which allows access to variables of the PLC. This COM-Server can be used in any programming language, such as VisualBasic, Delphi a.s.o..

Its interface name is IIIBHnet. In VisualBasic for instance, it is presented as IBHNet 1.0 Type Library from the menu "Project – References". The RFC1006 protocol should be always used to read and write variables, if possible. Only obsolete devices may require other protocols. To access variables from the PLC the methods and properties listed below are available:

 

Functions of the Interface IIIBHnet S5 S7
300/400 		SoftSPS
and
S7-CX 		S7
200
Search first configured station
HRESULT FirstStation(BSTR* pVal)
pVal: First Station found
Return Value: Successful operation returns S_OK, if no station exists, S_FALSE is returned. 		X X X X
Search further configured stations
HRESULT NextStation(BSTR* pVal)
pVal: Station name
Return Value: Successful operation returns S_OK
If no further station exists, S_FALSE is returned. 		X X X X

Set up PLC connection
HRESULT Connect([in, string] BSTR Station,[in] long MPIAdr)
Station: Station Name
MPIAdr: MPI Addrerss
Return Value: Successful operation returns S_OK, E_FAIL or the sequence number if failed.
The function Connect_DP of the interface IIIBHNet3 should be preferd to set up a connection, because it returns always an exception in programming languages like VisualBasic or C#, if failed.

X X X X
PLC Disconnect
HRESULT Disconnect()
Parameters: None
Return Value: Always S_OK. 		X X X X
Reads a single value from the PLC
HRESULT ReadVal(long typ, long nr, long DBNr, long size, long *val)
typ : 'E' = Input = 69d, 'A' Output = 65d, 'M' Flags = 77d, 'D' Datablock = 68d
nr: Start offset for Input/Output/Flags, for D the start offset within the DB
DBNr: Datablock number for typ = 'D' (68d), for Input/Output/Flags 0
size: 0..7 = The bit number within the byte read, 8 = Byte, 16 = Word, 32 = Doubleword
val: The value read from the PLC
Return Value: Successful operation returns S_OK, E_FAIL on Errors, E_ABORT if the PLC denies access or E_INVALIDARG if the desination Area in the PLC does not exist or is too small. 		X X X X
Reads an array of values from the PLC
HRESULT ReadVals(long typ, long nr, long DBNr, long size, SAFEARRAY(unsigned char) vals)
typ: 'E' = Input = 69d, 'A' Output = 65d, 'M' Flags = 77d, 'D' Datablock = 68d
nr: Start offset for Input/Output/Flags, for D the start offset within the DB
DBNr: Datablock number for typ = 'D' (68d), for Input/Output/Flags 0
size: Number of Bytes to read
vals: The array with the values read from the PLC
Return Value: Successful operation returns S_OK, E_FAIL on Errors, E_ABORT if the PLC denies access or E_INVALIDARG if the desination Area in the PLC does not exist or is too small.

ReadVals returns the data in a SAFEARRAY from type Byte. DotNetReadVals returns the data in a VARIANT variable, that contains a SAFEARRAY of type Byte. In the .Net languages the vals parameter is an object. If the destination area in the PLC does nor exist or is too small, the PLC reports this to the driver and the function will return E_INVALIDARG. The connection to the PLC stays established. For this type of error there is no need do disconnect from the PLC. 		X X X X
Writes a single value from the PLC
HRESULT WriteVal(long typ, long nr, long DBNr, long size, long val)
typ: 'E' = Input = 69d, 'A' Output = 65d, 'M' Flags = 77d, 'D' Datablock = 68d
nr: Start offset for Input/Output/Flags, for D the start offset within the DB
DBNr: Datablock number for typ = 'D' (68d), for Input/Output/Flags 0
size: 0..7 = The bit number within the byte read, 8 = Byte, 16 = Word, 32 = Doubleword
val: The value to be written to the PLC
Return Value: Successful operation returns S_OK, E_FAIL on Errors, E_ABORT if the PLC denies access or E_INVALIDARG if the desination Area in the PLC does not exist or is too small. 		X X X X
Writes an array of values to the PLC
HRESULT WriteVals(long typ, long nr, long DBNr, long size,SAFEARRAY(unsigned char) vals)
typ: 'E' = Input = 69d, 'A' Output = 65d, 'M' Flags = 77d, 'D' Datablock = 68d
nr: Start offset for Input/Output/Flags, for D the start offset within the DB
DBNr: Datablock number for typ = 'D' (68d), for Input/Output/Flags 0
size: Number of Bytes to read
vals: The array with the values to write to the PLC
Return Value: Successful operation returns S_OK, E_FAIL on Errors, E_ABORT if the PLC denies access or E_INVALIDARG if the desination Area in the PLC does not exist or is too small.

WriteVals passes the data in a SAFEARRAY from type Byte. DotNetWriteVals passes the data in a VARIANT variable, that contains a SAFEARRAY of type Byte. In the .Net languages the vals parameter is an object. If the destination area in the PLC does nor exist or is too small, the PLC reports this to the driver and the function will return E_INVALIDARG. The connection to the PLC stays established. For this type of error there is no need do disconnect from the PLC. 		X X X X
Writes the .bin file of the SoftPLC, containing the PLC Program.
HRESULT PLC_Store()
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Reads the .bin file of the SoftPLC, containing the PLC Program.
HRESULT PLC_Restore()
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Properties of the interface IIIBHnet S5 S7
300/400 		SoftSPS
and
S7-CX 		S7
200
Reads the operational state of the PLC.
HRESULT PLC_Run([out, retval] BOOL *pVal)
pVal: TRUE = Run, FALSE = Stop
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		X X X X
Reads the revision of the SoftPLC.
HRESULT PLC_Version([out, retval] long *pVal)
pVal: reports the revision.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Reads the number of cyles of the SoftPLC.
HRESULT PLC_Cycles([out, retval] long *pVal)
pVal: reports the current count.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Switches the PLC to Stop mode.
HRESULT PLC_Stop([in] BOOL newVal)
The parameter newVal is reserved and must be always FALSE.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		X X X -
Warm Restart of the PLC.
HRESULT PLC_Run_OB100([in] BOOL newVal)
The parameter newVal is reserved and must be always TRUE.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		X X X -
Hot Restart of the PLC.
HRESULT PLC_Run_OB101([in] BOOL newVal)
The parameter newVal is reserved and must be always TRUE.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		X X X -
Terminates the SoftPLC.
HRESULT PLC_Terminate([in] BOOL newVal)
The parameter newVal is reserved and must be always FALSE.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Reads the serial number of the SoftPLC.
HRESULT PLC_SerialNr([out, retval] BSTR *pVal)
pVal: returns the serial number.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Reads the user name of the SoftPLC.
HRESULT PLC_Name([out, retval] BSTR *pVal)
pVal: returns the user name.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Reads the company name of the SoftPLC.
HRESULT PLC_Firma([out, retval] BSTR *pVal)
pVal returns the company name.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Reads the order number of the PLC.
HRESULT PLC_Mlfb([out, retval] BSTR *pVal)
pVal: returns the company name.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		X X X -
Reads the current scan cycle time of the SoftPLC.
HRESULT PLC_CycleAct([out, retval] long *pVal)
pVal returns the cycle time.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Reads the minimum scan cycle time of the SoftPLC.
HRESULT PLC_CycleMin([out, retval] long *pVal)
pVal: returns the minimum cycle time.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Reads the maximum scan cycle time of the SoftPLC.
HRESULT PLC_CycleMax([out, retval] long *pVal)
pVal returns the maximum cycle time.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Reads the maximum jitter of the SoftPLC.
HRESULT PLC_JitterMax([out, retval] long *pVal)
pVal: returns the maximum jitter.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Reads the current jitter of the SoftPLC.
HRESULT PLC_JitterAct([out, retval] long *pVal))
pVal: returns the current jitter.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Starts the SoftPLC.
HRESULT PLC_Load([in] long newVal)
newVal: 0 = As Process, 1 = As Service, 2 = As AutoStart Service, 3 = As DemandStart Service.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Path to the configuration file PLC43.ini of the SoftPLC.
HRESULT PLC_InitPath([out, retval] BSTR *pVal)
pVal: returns the path.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Reads the SoftPLCs memory size.
HRESULT PLC_MemTotal([out, retval] long *pVal)
pVal: returns the memory size.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Reads the SoftPLCs free memory size.
HRESULT PLC_MemFree([out, retval] long *pVal)
pVal: returns the free memory size.
Return Value: Successful operation returns S_OK, E_FAIL on Errors. E_NOTIMPL will be returned, if the connected PLC does not support the function. 		- - X -
Get configured station by index.
HRESULT Station(long Nr, [out, retval] BSTR* pVal)
Nr: Station index
pVal: If the station is not found, an empty name name is returned. Return Value: Successful operation returns S_OK, if the station does not exist, S_FALSE is returned. 		- X X -
Eigenschaften für den Variablenzugriff

Es ist zu beachten, das jede der nachfolgend gelisteten Funktionen ein kompletten Lese- bzw. Schreibzugriff zur Steuerung durchführt. Man sollte daher versuchen, die zu lesenden bzw. zu schreibenden Bereiche in der SPS zusammenzufassen, damit diese als kompletter Block gelesen bzw. geschrieben werden können. Lesen bzw. Schreiben kompletter Blöcke über ReadVals / WriteVals dauert nur unwesentlich länger, als das Lesen bzw. Schreiben einer einzelnen Variablen.

S5 S7
300/400 		SoftSPS
und
S7-CX 		S7
200
Liest ein Merkerdoppelwort
HRESULT MD(long nr, [out, retval] long *pVal)
nr: Nummer des Merkerdoppelworts
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist.

Schreibt ein Merkerdoppelwort
HRESULT MD(long nr, [in] long newVal)
nr: Nummer des Merkerdoppelworts
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist. 		X X X X
Liest ein Merkerwort
HRESULT MW(long nr, [out, retval] long *pVal)
nr: Nummer des Merkerworts
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist.

Schreibt ein Merkerwort
HRESULT MW(long nr, [in] long newVal)
nr: Nummer des MerkerWorts
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist. 		X X X X
Liest ein Merkerbyte
HRESULT MB(long nr, [out, retval] long *pVal)
nr: Nummer des Merkerbytes
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist.

Schreibt ein Merkerbyte
HRESULT MB(long nr, [in] long newVal)
nr: Nummer des Merkerbytes
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist. 		X X X X
Liest ein Merkerbit
HRESULT M(long nr,long bit, [out, retval] BOOL *pVal)
nr: Adresse des Merkerbytes
bit: Bitnummer im Merkerbyte
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist.

Schreibt ein Merkerbit
HRESULT M(long nr,long bit, [in] BOOL newVal)
nr: Adresse des Merkerbytes
bit: Bitnummer im Merkerbyte
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist. 		X X X X
Liest ein Eingangsdoppelwort
HRESULT ED(long nr, [out, retval] long *pVal)
nr: Nummer des Eingangsdoppelworts
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist.

Schreibt ein Eingangsdoppelwort
HRESULT ED(long nr, [in] long newVal)
nr: Nummer des Eingangsdoppelworts
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist. 		X X X X
Liest ein Eingangswort
HRESULT EW(long nr, [out, retval] long *pVal)
nr: Nummer des Eingangsworts
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist.

Schreibt ein Eingangsdoppelwort
HRESULT EW(long nr, [in] long newVal)
nr: Nummer des Eingangsworts
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist. 		X X X X
Liest ein Eingangsbyte
HRESULT EB(long nr, [out, retval] long *pVal)
nr: Nummer des Eingangsbytes
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist.

Schreibt ein Eingangsbyte
HRESULT EB(long nr, [in] long newVal)
nr: Nummer des Eingangsbytes
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist. 		X X X X
Liest ein Eingangsbit
HRESULT E(long nr,long bit, [out, retval] BOOL *pVal)
nr: Adresse des Eingangsbytes
bit: Bitnummer im Eingangsbyte
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist.

Schreibt ein Eingangsbit
HRESULT E(long nr,long bit, [in] BOOL newVal)
nr: Adresse des Eingangsbytes
bit: Bitnummer im Eingangsbyte
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist. 		X X X X
Liest ein Ausgangsdoppelwort
HRESULT AD(long nr, [out, retval] long *pVal)
nr: Nummer des Ausgangsdoppelworts
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist.

Schreibt ein Ausgangsdoppelwort
HRESULT AD(long nr, [in] long newVal)
nr: Nummer des Ausgangsdoppelworts
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist. 		X X X X
Liest ein Ausgangswort
HRESULT AW(long nr, [out, retval] long *pVal)
nr: Nummer des Ausgangsworts
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist.

Schreibt ein Ausgangswort
HRESULT AW(long nr, [in] long newVal)
nr: Nummer des AusgangsWorts
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist. 		X X X X
Liest ein Ausgangsbyte
HRESULT AB(long nr, [out, retval] long *pVal)
nr: Nummer des Ausgangsbytes
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist.

Schreibt ein Ausgangsbyte
HRESULT AB(long nr, [in] long newVal)
nr: Nummer des Ausgangsbytes
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist. 		X X X X
Liest ein Ausgangsbit
HRESULT A(long nr,long bit, [out, retval] BOOL *pVal)
nr: Adresse des Ausgangsbytes
bit: Bitnummer im Ausgangsbytes
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist.

Schreibt ein Ausgangsbit
HRESULT A(long nr,long bit, [in] BOOL newVal)
nr: Adresse des Ausgangsbytes
bit: Bitnummer im Ausgangsbyte
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich zu klein ist. 		X X X X
Liest ein Datendoppelwort
HRESULT DD(long DBNr,long nr, [out, retval] long *pVal)
DBNr: Nummer des Datenbausteins
nr: Byte-Offset im Datenbaustein
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich nicht existiert oder zu klein ist.

Schreibt ein Datendoppelwort
HRESULT DD(long DBNr,long nr, [in] long newVal)
DBNr: Nummer des Datenbausteins
nr: Byte-Offset im Datenbaustein
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich nicht existiert oder zu klein ist. 		X X X X
Liest ein Datenwort
HRESULT DW(long DBNr,long nr, [out, retval] long *pVal)
DBNr: Nummer des Datenbausteins
nr: Byte-Offset im Datenbaustein
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich nicht existiert oder zu klein ist.

Schreibt ein Datenwort
HRESULT DW(long DBNr,long nr, [in] long newVal)
DBNr: Nummer des Datenbausteins
nr: Byte-Offset im Datenbaustein
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich nicht existiert oder zu klein ist. 		X X X X
Liest ein Datenbyte
HRESULT DB(long DBNr,long nr, [out, retval] long *pVal)
DBNr: Nummer des Datenbausteins
nr: Byte-Offset im Datenbaustein
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich nicht existiert oder zu klein ist.

Schreibt ein Datenbyte
HRESULT DB(long DBNr,long nr, [in] long newVal)
DBNr: Nummer des Datenbausteins
nr: Byte-Offset im Datenbaustein
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich nicht existiert oder zu klein ist. 		X X X X
Liest ein Datenbit
HRESULT D(long DBNr,long nr,long bit, [out, retval] BOOL *pVal)
DBNr: Nummer des Datenbausteins
nr: Byte-Offset im Datenbaustein
bit: Bitnummer im Datenbyte
pVal: Gelesener Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich nicht existiert oder zu klein ist.

Schreibt ein Datenbit
HRESULT D(long DBNr,long nr,long bit, [in] BOOL newVal)
DBNr: Nummer des Datenbausteins
nr: Byte-Offset im Datenbaustein
bit: Bitnummer im Datenbyte
newVal: Zu schreibender Wert
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich nicht existiert oder zu klein ist. 		X X X X
Systemfunktionen der Schnittstelle IIIBHnet2 S5 S7
300/400 		SoftSPS
und
S7-CX 		S7
200
Neustart (Reboot) des IBH Link
HRESULT ResetDevice(BSTR device)
device: Stationsname
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler. E_NOTIMPL wird zurückgegeben, wenn die angeschlossene Baugruppe die Funktion nicht untertützt. 		- X X X
Liest die Position des Schlüsselschalters der SPS aus
HRESULT Key_Position([out, retval] long *pVal)
pVal: gibt die Schalterstellung zurück
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler. E_NOTIMPL wird zurückgegeben, wenn die angeschlossene SPS die Funktion nicht untertützt. 		- X X -
Ermittelt die am Bus erreichbaren Teilnehmer
HRESULT LifeList(BSTR device, VARIANT * lifelist)
lifelist: enthält die Liste der Teilnehmer, 0x30 = Aktiv, 0x20 = Aktiv Ready, 0x10 = Nicht vorhanden, 0x00 = Passiv
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler. E_NOTIMPL wird zurückgegeben, wenn die angeschlossene SPS die Funktion nicht untertützt. 		- X X X
Liest Systemzustandslisten aus der SPS aus
HRESULT SZ_List(long SZL_ID, long INDEX, VARIANT * SZ_List)
Siehe hierzu die Siemens Dokumentation zur SFC51. Installationsverzeichnis: C:\Program Files\Siemens\Dokumentation\Deutsch\STEP 7 - System- und Standardfunktionen für S7-300 und S7-400 Kapitel: Systemzustandsliste SZL.
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler. E_NOTIMPL wird zurückgegeben, wenn die angeschlossene SPS die Funktion nicht untertützt. 		- X X -
Beendet den Treiber IBH_NetPcom.exe
HRESULT TerminateDriver()
Rückgabewert: Immer S_OK

Bei den Protokollen RFC1006, API oder 1200 nicht relevant. 		- X X X
Erweiterte Funktionen und .NET der Schnittstelle IIIBHnet3 S5 S7
300/400 		SoftSPS
und
S7-CX 		S7
200
Verbindung zur SPS aufbauen
HRESULT Connect_DP(BSTR Station, long DPAdr, long Rack, long Slot)
Station: Stationsname
DPAdr: MPI® bzw. Profibusadresse
Rack: Baugruppenträger Nummer (normalerweise 0)
Slot: Steckplatz. Bei MPI meistens 0, bei Profibus der Steckplatz der CPU im Rack.
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler.

Die Funktion Connect_DP aus dem Interface IIIBHNet3 sollte zum Verbindungsaufbau vorgezogen werden da diese bei Misserfolg in Programmiersprachen wie VisualBasic oder C# immer eine Exeption auslöst. 		- X - -
Geroutete Verbindung zur SPS in abgesetzte MPI/Profibus-Netzwerke aufbauen, sofern die CPU dies unterstützt
HRESULT Subnet_Connect_DP(BSTR Station, long MPIStart, long MPIZiel, long RackZiel, long SlotZiel, long Subnet_HH, long Subnet_LL)
Station: Stationsname
MPIStart: MPI® bzw. Profibusadresse, auf die der IBH Link aufgesteckt ist.
MPIZiel: MPI® bzw. Profibusadresse, auf die im Subnetz geroutet werden soll.
RackZiel: Baugruppenträger Nummer der Baugrupp im Zielsubnetz (normalerweise 0)
SlotZiel: Steckplatz der CPU im Zielsubnetz (normalerweise 2).
Subnet_HH: Subnet ID HighWort, aus Projekt.
Subnet_LL: Subnet ID LowWort, aus Projekt.
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler.

Die Funktion Connect_DP aus dem Interface IIIBHNet3 sollte zum Verbindungsaufbau vorgezogen werden da diese bei Misserfolg in Programmiersprachen wie VisualBasic oder C# immer eine Exeption auslöst. 		- X - -
Geroutete Verbindung zur SPS in abgesetzte TCP/IP-Netzwerke aufbauen, sofern die CPU dies unterstützt
HRESULT Subnet_Connect_IP(BSTR Station, long MPIStart, BSTR IPZiel, long RackZiel, long SlotZiel, long Subnet_HH, long Subnet_LL)
Station: Stationsname
MPIStart: MPI® bzw. Profibusadresse, auf die der IBH Link aufgesteckt ist.
IPZiel: TCP/IP Adresse, auf die im Subnetz geroutet werden soll.
RackZiel: Baugruppenträger Nummer der Baugrupp im Zielsubnetz (normalerweise 0)
SlotZiel: Steckplatz der CPU im Zielsubnetz (normalerweise 2).
Subnet_HH: Subnet ID HighWort, aus Projekt.
Subnet_LL: Subnet ID LowWort, aus Projekt.
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler.

Die Funktion Connect_DP aus dem Interface IIIBHNet3 sollte zum Verbindungsaufbau vorgezogen werden da diese bei Misserfolg in Programmiersprachen wie VisualBasic oder C# immer eine Exeption auslöst. 		- X - -
Geroutete Verbindung zur SPS in abgesetzte H1-Netzwerke aufbauen, sofern die CPU dies unterstützt
HRESULT SubnetConnectH1(BSTR Station, long MPIStart, BSTR H1Ziel, long RackZiel, long SlotZiel, long Subnet_HH, long Subnet_LL)
Station: Stationsname
MPIStart: MPI® bzw. Profibusadresse, auf die der IBH Link aufgesteckt ist.
H1Ziel: H1 Adresse, auf die im Subnetz geroutet werden soll.
RackZiel: Baugruppenträger Nummer der Baugrupp im Zielsubnetz (normalerweise 0)
SlotZiel: Steckplatz der CPU im Zielsubnetz (normalerweise 2).
Subnet_HH: Subnet ID HighWort, aus Projekt.
Subnet_LL: Subnet ID LowWort, aus Projekt.
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler.

Die Funktion Connect_DP aus dem Interface IIIBHNet3 sollte zum Verbindungsaufbau vorgezogen werden da diese bei Misserfolg in Programmiersprachen wie VisualBasic oder C# immer eine Exeption auslöst. 		- X - -
Liest die Rohdaten eines Datenbausteins, wie dieser auf der SPS abliegt, aus.
HRESULT ReadDB(long DBNr, VARIANT*DB, long * Len)
DBNr: Datenbausteinnummer
DB: VARIANT Variable, die wiederum ein SAFEARRAY vom Datentyp Byte enthält mit dem Bausteininhalt.
Len: Länge der Bausteines
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_INVALIDARG wenn der Datenbaustein nicht existiert.

Um diese Funktion verwenden zu können sind detaillierte Kenntnisse des S7-Bausteinaufbaus erforderlich. Aus rechtlichen Gründen können diese von IBHsoftec nicht veröffentlicht werden. 		X X X -
Schreibt die Rohdaten eines Datenbausteins, wie dieser auf der SPS abliegt.
HRESULT WriteDB(long DBNr, VARIANT DB, long Len)
DBNr: Datenbausteinnummer
DB: VARIANT Variable, die wiederum ein SAFEARRAY vom Datentyp Byte enthält mit dem Bausteininhalt.
Len: Länge der Bausteines
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_INVALIDARG wenn der Datenbaustein nicht existiert

Um diese Funktion verwenden zu können sind detaillierte Kenntnisse des S7-Bausteinaufbaus erforderlich. Aus rechtlichen Gründen können diese von IBHsoftec nicht veröffentlicht werden. 		X X X -
Blockweise Lesen von Werten aus der SPS
HRESULT DotNetReadVals(long typ, long nr, long DBNr, long size, VARIANT * vals)
DotNetReadVals(long typ, long nr, long DBNr, long size, VARIANT * vals)
typ: (E)ingang = 69d, (A)usgang = 65d, (M)erker = 77d, (D)atenbaustein = 68d
nr: Startadresse bei EAM, bei D die Startadresse im DB
DBNr: Datenbausteinnumer bei typ=D (68d), bei EAM 0
size: Anzahl der zu lesenden Bytes
vals: VARIANT Variable, die wiederum ein SAFEARRAY vom Datentyp BYTE enthält mit den daten aus der SPS.
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich nicht existiert oder zu klein ist.

In den .Net Sprachen ist der Übergabeparameter ein Objekt. Sollen Datenbereiche gelesen werden die größer sind als die auf der CPU tatsächlich vorhandenen Bereiche, so meldet die CPU dem Treiber dass der Datenbereich nicht existent ist. Die Funktion gibt in diesem Fall E_INVALIDARG zurück. Die Verbindung zur Steuerung bleibt dabei bestehen, es besteht kein Grund die Verbindung zur Steuerung zu trennen. 		X X X X
Blockweise Schreiben von Werten in die SPS
HRESULT DotNetWriteVals(long typ, long nr, long DBNr, long size, VARIANT vals)
DotNetWriteVals(long typ, long nr, long DBNr, long size, VARIANT vals)
typ: (E)ingang = 69d, (A)usgang = 65d, (M)erker = 77d, (D)atenbaustein = 68d
nr: Startadresse bei EAM, bei D die Startadresse im DB
DBNr: Datenbausteinnumer bei typ=D (68d), bei EAM 0
size: Anzahl der zu lesenden Bytes
vals: VARIANT Variable, die wiederum ein SAFEARRAY vom Datentyp BYTE mit den Daten enthält.
Rückgabewert: S_OK bei Erfolg, E_FAIL bei Fehler, E_ABORT wenn die SPS den Zugriff verweigert oder E_INVALIDARG wenn der Datenbereich nicht existiert oder zu klein ist.

DotNetReadVals übergibt Daten in einer VARIANT Variable, die wiederum ein SAFEARRAY vom Datentyp Byte enthält. In den .Net Sprachen ist der Übergabeparameter ein Objekt. Sollen Datenbereiche geschrieben werden die größer sind als die auf der CPU tatsächlich vorhandenen Bereiche, so meldet die CPU dem Treiber dass der Datenbereich nicht existent ist. Die Funktion gibt in diesem Fall E_INVALIDARG zurück. Die Verbindung zur Steuerung bleibt dabei bestehen, es besteht kein Grund die Verbindung zur Steuerung zu trennen. 		X X X X

 

 

 

 


In the installation folder of the IBHNet driver, samples for Visual Basic 6 can be found. The samples are commented. Samples for other programming languages will follow. Contact our product support to ask for more samples.

<tbody> </tbody>
 
Attention: If multiple threads need to access the same IBHNet object, the access functions to the IBHNet object need to be locked from each other. Suitable mechanisms are for instance Critical Sections, Semaphores or Mutexes. A simple locking with variables is not suitable to securely avoid race conditions.
 

Following error codes will be returned:

<tbody> </tbody>
Errorcode Description
1 netpcomv.CreateInstance failed
2 netpcomv.MPI_open failed
3 netpcomv.MPI_ConnRequest failed
4 connection request to SoftPlc failed
5 netpcomv.MPI_close failed

If accessing a variable fails, still an exception will be raised.

It is also possible to access the LOGO! RCE versions via RFC1006. In this case the MPI address 128 has to be used in the function Connect(), for Connect_DP() the slot 128 has to be used. MPI address and rack need to be 0. The possible variables are inputs, outputs, flags, the DB1 and the order number.


Retrieved from "https://wiki.ibhsoftec.com/en/index.php?title=IBHNet:Accessing_PLC_variables&oldid=367"