XIGEVAPO.tlk Driver Reference
IG Instrumentos Evaporimeter Driver
This driver requires that you have TAS-HMITalk 8.04 installed.
XIGEVAPO driver reads stored memory from IG Instrumentos
Automatic Evaporimeter Data Loggers.
This driver implements a modified version of the Modbus RTU
protocol to download the Evaporimeter memory.
IMPORTANT NOTE:
When connecting via modem, the following HMITalk properties
must be set:
- CommHoldRTSWhileTransmitting = True
- CommHoldRTSWhileReceiving = True
A minimum of 5000ms in the CommTimeout property is also recomended.
Evaporimeters
IG INSTRUMENTOS Evaporimeters
COMMAND DESCRIPTION:
Reads Evaporimeter memory contents.
PROPERTY SETTINGS REQUIRED:
HMITalk1.DriverDataType = Analog Input
HMITalk1.DriverNumPoints = 15
HMITalk1.DriverP0 = Evaporimeter address (1-255)
HMITalk1.DriverP1 = 0
HMITalk1.DriverP2 = 0 for direct connection.
1 for RS-485 connection.
2 for radio connection.
3 for modem connection.
HMITalk1.DriverP3 = Number of retries for each request (usually 10) (0-100).
HMITalk1.DriverP4 = Number of records in each request (usually 4) (1-48).
HMITalk1.DriverP5 = Dialing timeout in seconds when using modem connection (P2=3).
HMITalk1.DriverP6 = Dial string when using modem connection (P2=3).
HMITalk1.DriverP7 = Initial pointer address (256-65531). If empty,
the initial pointer address is read from a file
whose name is formed by combining P9, the device
address and the .pos extension. This file is
automatically mantained by the driver.
HMITalk1.DriverP8 = Update data logger date (0=No, 1=Yes)
HMITalk1.DriverP9 = Local filename (with path) where memory contents are downloaded.
The actual filename is formed by combining P9, the
device address and the .txt extension.
If starts with '@', p9 is assumed only as the path
and memory.tmp and memory.pos are used.
RETURNS:
- HMITalk1.PointValue(0) = YEAR IN EVAPORIMETER CLOCK (0-3)
- HMITalk1.PointValue(1) = MONTH IN EVAPORIMETER CLOCK (1-12)
- HMITalk1.PointValue(2) = DAY IN EVAPORIMETER CLOCK (1-31)
- HMITalk1.PointValue(3) = HOUR IN EVAPORIMETER CLOCK (0-23)
- HMITalk1.PointValue(4) = MINUTES IN EVAPORIMETER CLOCK (0-59)
- HMITalk1.PointValue(5) = SECONDS IN EVAPORIMETER CLOCK (0-59)
- HMITalk1.PointValue(6) = NUMBER OF RECORDS READ (1-13055)
- HMITalk1.PointValue(7) = MEMORYSTART (tipically 256)
- HMITalk1.PointValue(8) = MEMORYEND (tipically 65535)
- HMITalk1.PointValue(9) = NEXT MEMORYPOINTER (256 to 65535)
- HMITalk1.PointValue(10) = RECORDLENGTH (32 for this evaporimeter)
- HMITalk1.PointValue(11) = DEVICE ADDRESS
- HMITalk1.PointValue(12) = TOTAL DOWNLOAD TIME (SEC)
- HMITalk1.PointValue(13) = ERROR IN HEADER FLAG (0 or 1)
- HMITalk1.PointValue(14) = DOWNLOAD INTERRUPTED FLAG (0 or 1)
- HMITalk1.PointValue(15) = DATA LOGGER TYPE
RECORD FORMAT:
1) RECORD INDEX (1-13055)
2) YEAR (0-3)
3) MONTH (1-12)
4) DAY (1-31)
5) HOURS (0-23)
6) MINUTES (0-59)
7) EXTERNAL INPUT
8) SPARE-TANK ALARM LEVEL
9) RESERVED 1 (1 BIT)
10) RESERVED 2 (1 BIT)
11) EVAPORIMETER COUNTER (0-4095)
12) EVAPORATION PULSES (0-65535)
13) TANK-A TEMPERATURE (0-4095)
14) TANK-B TEMPERATURE (0-4095)
15) TANK-C TEMPERATURE (0-4095)
16) AMBIENT TEMPERATURE (0-4095)
17) GROUND TEMPERATURE (0-4095)
18) WIND DIRECTION (0-4095)
19) PULSES (0-16777216)
20) RADIATION (0-4095)
21) AMBIENT HUMIDITY (0-4095)
22) ATMOSPHERIC PRESSURE (0-4095)
23) BATTERY LEVEL (0-4095)
24) GROUND HUMIDITY (0-4095)
25) RESERVED 0 (0-4095)
26) RESERVED 1 (0-4095)
27) RESERVED 2 (0-4095)
28) RESERVED 3 (0-255)
[1005] DRIVER (Internal): Invalid driver stage
[1206] DRIVER (System): Error opening file specified in P9
[1300] PROTOCOL (Timeout): No answer
[1307] PROTOCOL (Timeout): No answer when dialing
[1421] PROTOCOL (Format): Negative acknowledge received from device
[2001] CONFIG (DataType): Analog outputs are not supported by this driver
[2002] CONFIG (DataType): Digital inputs are not supported by this driver
[2003] CONFIG (DataType): Digital outputs are not supported by this driver
[2116] CONFIG (NumValues): Invalid number of values (must be 16)
[2123] CONFIG (NumValues): Invalid number of values (must be 37)
[2125] CONFIG (NumValues): Invalid number of values (must be 4)
[3022] CONFIG (P0): Invalid device address (1-255)
[3509] CONFIG (P1): Invalid command (0 only)
[4024] CONFIG (P2): Invalid block size (1-7)
[4048] CONFIG (P2): Invalid connection mode (0 to 3 only)
[4549] CONFIG (P3): Invalid number of retries (0-100)
[5021] CONFIG (P4): Invalid number of records (1-48)
[5504] CONFIG (P5): Invalid dialing timeout (5-180)
[6005] CONFIG (P6): Dial string is empty
[6503] CONFIG (P7): Hang-up string is empty
[7004] CONFIG (P8): RTU modem string is empty
[7005] CONFIG (P8): RTU modem string too long (max=63 chars)
[7503] CONFIG (P9): Local filename undefined
[8013] CONFIG (Remote): Acknowledge
[8034] CONFIG (Remote): Busy (rejected message)
[8138] CONFIG (Remote): Failure in associated device
[8168] CONFIG (Remote): Illegal data address
[8170] CONFIG (Remote): Illegal data value
[8172] CONFIG (Remote): Illegal function
[8347] CONFIG (Remote): Unknown error
This driver requires that you have TAS-HMITalk 8.04 installed.
Driver Source Code Last Update: 04/29/2007 17:42:41
Driver Reference Last Update: 10/30/2008 17:39:57
© 1990-2008, CPKSoft Engineering. All rights reserved.