CPKSoft Engineering

XIGPL100.tlk Driver Reference

IG Instrumentos DataLogger 1 Channel Pluviometer Driver

This driver requires that you have TAS-HMITalk 8.04 installed.

Driver Overview

XIGPL100 driver reads stored memory from IG Instrumentos

PLU100 1 Channel Pluviometers.

 

This driver implements a modified version of the Modbus RTU

protocol to download the pluviometer 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.

Supported Equipment Type

Pluviometers

Supported Devices List

IG INSTRUMENTOS PLU100 Pluviometers

Supported Commands List

Download Pluviometer Memory

Download Pluviometer Memory

COMMAND DESCRIPTION:

Reads pluviometer memory contents.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Input

HMITalk1.DriverNumPoints = 15

HMITalk1.DriverP0 = Pluviometer 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 PLUVIOMETER CLOCK (0-3)

- HMITalk1.PointValue(1) = MONTH IN PLUVIOMETER CLOCK (1-12)

- HMITalk1.PointValue(2) = DAY IN PLUVIOMETER CLOCK (1-31)

- HMITalk1.PointValue(3) = HOUR IN PLUVIOMETER CLOCK (0-23)

- HMITalk1.PointValue(4) = MINUTES IN PLUVIOMETER CLOCK (0-59)

- HMITalk1.PointValue(5) = SECONDS IN PLUVIOMETER 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 (5 for this pluviometer)

- 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) LOW BATTERY

8) TEST

9) RESERVED 1

10) RESERVED 2

11) PLUVIOMETER COUNTER (0-4095)

Returned Errors List

[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

About the XIGPL100.tlk driver

This driver requires that you have TAS-HMITalk 8.04 installed.

Driver Source Code Last Update: 06/27/2006 15:55:12

Driver Reference Last Update: 10/30/2008 17:40:00

© 1990-2008, CPKSoft Engineering. All rights reserved.

http://www.cpksoft.com - support@cpksoft.com

http://www.cpksoft.com.ar - soporte@cpksoft.com.ar>