Driver variables

The driver kit implements a number of driver variables for information, configuration, statistics and error messages.

The definitions of the variables defined in the driver kit are available in the import file DRVVAR.DBF (on the CD in the directory: CD_drive:/Predefined/Variables).

Information

Name	Type	Offset	Description
MainVersion	WORD	0	Main version number of the driver.
SubVersion	WORD	1	Sub version number of the driver.
BuildVersion	WORD	29	Build version number of the driver.
ZenOnMajor	WORD	49	zenon main version number
ZenOnMinor	WORD	50	zenon sub version number
ZenOnSp	WORD	51	zenon service pack number
ZenOnBuild	WORD	52	zenon build number
LineStateIdle	Bit	24.0	TRUE, if the modem connection is idle
LineStateOffering	Bit	24.1	TRUE, if a call is received
LineStateAccepted	Bit	24.2	The call is accepted
LineStateDialtone	Bit	24.3	Dialtone recognized
LineStateDialing	Bit	24.4	Dialing active
LineStateRingBack	Bit	24.5	While establishing the connection
LineStateBusy	Bit	24.6	Target station is busy
LineStateSpecialInfo	Bit	24.7	Special status information received
LineStateConnected	Bit	24.8	Connection established
LineStateProceeding	Bit	24.9	Dialing completed
LineStateOnHold	Bit	24.10	Connection in hold
LineStateConferenced	Bit	24.11	Connection in conference mode
LineStateOnHoldPendConf	Bit	24.12	Connection in hold for conference
LineStateOnHoldPendTransfer	Bit	24.13	Connection in hold for transfer
LineStateDisconnected	Bit	24.14	Connection stopped
LineStateUnknow	Bit	24.15	Connection status unknown
ModemStatus	DWORD	24	Current modem status
TreiberStop	Bit	28	Driver stopped
PokeFinish	Bit	55	TRUE, if all current pokes were executed

Configuration

Name	Type	Offset	Description
ReconnectInRead	Bit	27	If TRUE, the modem is automatically reconnected for reading
ApplyCom	Bit	36	Apply changes in the settings of the serial interface. Writing this variable immediately calls the method SrvDrvVarApplyCom.
ApplyModem	Bit	37	Apply changes in the settings of the modem. Writing this variable immediately calls the method SrvDrvVarApplyModem.
PhoneNumberSet	String	38	Telephone number, that should be used
ModemHwAdrSet	Longint	39	Hardware address for the telephone number
GlobalUpdate	DWORD	3	Update time in ms
BGlobalUpdaten	Bit	4	TRUE, if update time is global
TreiberSimul	Bit	5	TRUE, if driver in sin simulation mode
TreiberProzab	Bit	6	TRUE, if the variables updatelist should be kept in the memory
ModemActive	Bit	7	TRUE, if the modem is active for the driver
Device	String	8	Name of the serial interface or name of the modem
ComPort	WORD	9	Number of the serial interface.
Baudrate	DWORD	10	Baudrate of the serial interface
Parity	Byte	11	Parity of the serial interface
ByteSize	Byte	14	Number of bits per character of the serial interface
StopBit	Byte	13	Number of stoppbits of the serial interface
Autoconnect	Bit	16	TRUE, if the modem connection should be established automatically for reading/writing
PhoneNumber	String	17	Current telephone number
ModemHwAdr	Longint	21	Hardware address of current telephone number
RxIdleTime	WORD	18	Modem is disconnected, if no data transfer occurs for this time (in ms)
WriteTimeout	DWORD	19	Maximum writing time for modem connection
RingCountSet	DWORD	20	Number of ringing tones before a call is accepted
ReCallIdleTime	DWORD	53	Waiting time between calls
ConnectTimeout	DWORD	54	Time for establishing connection

Statistics

Error messages

Name	Type	Offset	Description
ErrorTimeDW	DWORD	2	Time (in seconds since 1.1.1970), when the last error occured
ErrorTimeS	String	2	Time (in seconds since 1.1.1970), when the last error occured
RdErrPrimObj	DWORD	42	Number of the PrimObject, when the last reading error occured
RdErrStationsName	String	43	Name of the station, when the last reading error occured
RdErrBlockCount	DWORD	44	Number of blocks to read, when the last reading error occured
RdErrHwAdresse	DWORD	45	Hardware address, when the last reading error occured
RdErrBausteinNr	DWORD	46	Block number, when the last reading error occured
RdErrMerkerNr	DWORD	47	Marker number, when the last reading error occured
RdErrSize	DWORD	48	Block size, when the last reading error occured
DrvError	Byte	25	Error message as number
DrvErrorMsg	String	30	Error message as text
ErrorFile	String	15	Name of error log file