CPKSoft Engineering

XCVMMEM.tlk Driver Reference

Circutor CVM-M Memory Peripheral Protocol Driver

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

Driver Overview

XCVMMEM driver allows you to connect with CIRCUTOR Memory

Peripherals CVM-M (Codes 7 70 221 - 7 70 222 - 7 70 223).

The CVM-M is a memory peripheral with the ability of storing

data provided by any of the measuring instruments of the CVM

family.

 

This driver has been elaborated according to the Circutor

Instruction Manual M981 172/95-001 and further information

supplied by Circutor S.A.

Supported Equipment Type

Power Meters

Supported Devices List

CIRCUTOR CVM-M Memory Peripherals

Supported Commands List

Read number of bytes in internal files

Read single file contents

Read consecutive file(s) contents

Read Last N Bytes Stored in Memory

Turn on/off scan of slave device

Read device's transmission buffer size

Write record period and memory filename

Write record period, control period and memory filename

Write voltage and h/l percentages

Read voltage and h/l percentages

Write trigger by variable code and thresholds

Read trigger variable code and thresholds

Write trigger by date and time

Read trigger date and time

Write communication parameters

Read communication parameters

Read list of value-codes to be recorded

Select value-codes to be recorded

Clear memory

Reset device

Read Binary Inputs

Read A/D Channels

Read number of bytes in internal files

COMMAND DESCRIPTION:

Reads the number of bytes available in the internal memory

files xx.CVM, xx.CVT, xx.CVX, xx.CVE, xx.CVP, xx.CVH and

xx.CVI.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Input

HMITalk1.DriverNumPoints = 1-7

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 0

HMITalk1.DriverP7 = Skip first STD sequence

0 or Null = No

1 = Yes

HMITalk1.DriverP8 = Skip second STD sequence

0 or Null = No

1 = Yes

HMITalk1.DriverP9 = Skip final CND sequence

0 or Null = No

1 = Yes

 

RETURNS:

- HMITalk1.PointValue(0) = Number of bytes in xx.CVM

- HMITalk1.PointValue(1) = Number of bytes in xx.CVT

- HMITalk1.PointValue(2) = Number of bytes in xx.CVX

- HMITalk1.PointValue(3) = Number of bytes in xx.CVE

- HMITalk1.PointValue(4) = Number of bytes in xx.CVP

- HMITalk1.PointValue(5) = Number of bytes in xx.CVH

- HMITalk1.PointValue(6) = Number of bytes in xx.CVI

 

NOTE: A value of -1 in any of the PointValue properties indicates

that the corresponding file was not available in the device's

memory.

Read single file contents

COMMAND DESCRIPTION:

Reads the contents of one single file available in the

device. The files are not automatically cleared from the

device's memory after being read. If the file exists in

the destination path, it will be overwritten with the new

data.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Input

HMITalk1.DriverNumPoints = 1

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 3

HMITalk1.DriverP2 = Number of retries with each block

transfer before abandoning the communication.

If left blank or 0, up to 10 retries will be allowed.

HMITalk1.DriverP3 = Size of each file-block being transferred.

The block size migth be limited by the device's

transmission buffer size. If left blank, blocks

are read in groups of 32 bytes. Range is 32 to 512.

HMITalk1.DriverP4 = Indicates the file extension to be read.

Can be one of this only:

- 0 for CVM

- 1 for CVT

- 2 for CVX

- 3 for CVE

- 4 for CVP

- 5 for CVH

- 6 for CVI

HMITalk1.DriverP5 = Total number of bytes to be read from file.

If left blank or 0, the returned file size is used.

HMITalk1.DriverP6 = Destination path where the collected

file must be stored. The path must exist before

executing this command. The final backslash must

NOT be included. It will be automatically appended.

HMITalk1.DriverP7 = Skip first STD sequence

0 or Null = No

1 = Yes

HMITalk1.DriverP8 = Skip second STD sequence

0 or Null = No

1 = Yes

HMITalk1.DriverP9 = Skip final CND sequence

0 or Null = No

1 = Yes

 

RETURNS:

- HMITalk1.PointValue(0) = Number of bytes read from the file.

 

NOTE: A value of -1 in the number of bytes indicates that the

selected file was not available in the device's memory.

Read consecutive file(s) contents

COMMAND DESCRIPTION:

Reads the contents of the files available in the internal

memory. The files that can be read are: xx.CVM, xx.CVT,

xx.CVX, xx.CVE, xx.CVP, xx.CVH and xx.CVI, in this order.

Files are not automatically cleared from the device's

memory after being read. Existing files in the destination

path will be overwritten with the new data.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Input

HMITalk1.DriverNumPoints = 1-7

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 1

HMITalk1.DriverP2 = Number of retries with each block

transfer before abandoning the communication.

If left blank, up to 10 retries will be allowed.

HMITalk1.DriverP3 = Size of each file-block being transferred.

The block size migth be limited by the device's

transmission buffer size. If left blank, blocks

are read in groups of 32 bytes. Range is 32 to 512.

HMITalk1.DriverP6 = Destination path where the collected

files must be stored. The path must exist before

executing this command. The final backslash must

NOT be included. It will be automatically appended.

HMITalk1.DriverP7 = Skip first STD sequence

0 or Null = No

1 = Yes

HMITalk1.DriverP8 = Skip second STD sequence

0 or Null = No

1 = Yes

HMITalk1.DriverP9 = Skip final CND sequence

0 or Null = No

1 = Yes

 

RETURNS:

- HMITalk1.PointValue(0) = Number of bytes read from xx.CVM

- HMITalk1.PointValue(1) = Number of bytes read from xx.CVT

- HMITalk1.PointValue(2) = Number of bytes read from xx.CVX

- HMITalk1.PointValue(3) = Number of bytes read from xx.CVE

- HMITalk1.PointValue(4) = Number of bytes read from xx.CVP

- HMITalk1.PointValue(5) = Number of bytes read from xx.CVH

- HMITalk1.PointValue(6) = Number of bytes read from xx.CVI

 

NOTE: A value of -1 in any of the PointValue properties indicates

that the corresponding file was not available in the device's

memory.

Read Last N Bytes Stored in Memory

COMMAND DESCRIPTION:

Returns the last N bytes stored into the device's memory

for a particular file extension. This information can be

used to verify if there is any new activity registered

in memory.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Input

HMITalk1.DriverNumPoints = 32-256

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 4

HMITalk1.DriverP2 = Number of retries with each block

transfer before abandoning the communication.

If left blank or 0, up to 10 retries will be allowed.

HMITalk1.DriverP4 = Indicates the file extension to be read.

Can be one of this only:

- 0 for CVM

- 1 for CVT

- 2 for CVX

- 3 for CVE

- 4 for CVP

- 5 for CVH

- 6 for CVI

HMITalk1.DriverP7 = Skip first STD sequence

0 or Null = No

1 = Yes

HMITalk1.DriverP8 = Skip second STD sequence

0 or Null = No

1 = Yes

HMITalk1.DriverP9 = Skip final CND sequence

0 or Null = No

1 = Yes

 

RETURNS:

- HMITalk1.PointValue(0) = First byte read (0-255)

- HMITalk1.PointValue(1) = Second byte read (0-255)

.

.

.

- HMITalk1.PointValue(NumPoints-1) =Last byte read (0-255)

 

NOTE: If the number of bytes in memory is less than the requested

number of bytes, the remaining bytes are returned with a value

of -1.

Turn on/off scan of slave device

COMMAND DESCRIPTION:

Turns to On or Off the periodic scan of a CVM-M slave device,

when there is one connected with the same link used to

download the internal files. This command can be executed to

turn off the scan of the slave device before proceeding to

read the files and then re-enable the scan to on after the

files where read.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Digital Output

HMITalk1.DriverNumPoints = 1

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 3

 

WHERE:

- HMITalk1.PointValue(0) = New scan status (0 or 1)

Read device's transmission buffer size

COMMAND DESCRIPTION:

Reads the size in bytes of the device's transmission buffer.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Input

HMITalk1.DriverNumPoints = 1

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 2

Write record period and memory filename

COMMAND DESCRIPTION:

Writes the new record period in seconds and the new filename

to store the memory data.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Digital Output

HMITalk1.DriverNumPoints = 1

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 0

HMITalk1.DriverP2 = The new recording period, in seconds

HMITalk1.DriverP6 = The new filename in uppercase chars

without extension, padded to 8 characters.

Write record period, control period and memory filename

COMMAND DESCRIPTION:

Writes the new record period, the new control period

(both in seconds) and the new filename to store the

memory data.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Digital Output

HMITalk1.DriverNumPoints = 1

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 5

HMITalk1.DriverP2 = The new recording period, in seconds

HMITalk1.DriverP3 = The new control period, in seconds

HMITalk1.DriverP6 = The new filename in uppercase chars

without extension, padded to 8 characters.

Write voltage and h/l percentages

COMMAND DESCRIPTION:

Writes the new voltage and high/low percentages.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Digital Output

HMITalk1.DriverNumPoints = 1

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 6

HMITalk1.DriverP2 = The new voltage

HMITalk1.DriverP3 = The new high percentage

HMITalk1.DriverP4 = The new low percentage

Read voltage and h/l percentages

COMMAND DESCRIPTION:

Reads the current voltage and high/low percentages.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Input

HMITalk1.DriverNumPoints = 1-3

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 6

 

RETURNS:

- HMITalk1.PointValue(0) = Current voltage

- HMITalk1.PointValue(1) = Current high percentage

- HMITalk1.PointValue(2) = Current low percentage

Write trigger by variable code and thresholds

COMMAND DESCRIPTION:

Sets the trigger variable code, max and min thresholds.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Digital Output

HMITalk1.DriverNumPoints = 1

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 7

HMITalk1.DriverP2 = Variable code (0-11)

HMITalk1.DriverP3 = Max trigger value

HMITalk1.DriverP4 = Min trigger value

Read trigger variable code and thresholds

COMMAND DESCRIPTION:

Reads the trigger variable code, max and min thresholds.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Input

HMITalk1.DriverNumPoints = 1-3

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 7

 

RETURNS:

- HMITalk1.PointValue(0) = Current variable code

- HMITalk1.PointValue(1) = Current max trigger value

- HMITalk1.PointValue(2) = Current min trigger value

Write trigger by date and time

COMMAND DESCRIPTION:

Sets the trigger date and time.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Output

HMITalk1.DriverNumPoints = 12

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 8

 

WHERE:

- HMITalk1.PointValue(0) = Day for ON (1-31)

- HMITalk1.PointValue(1) = Month for ON (1-12)

- HMITalk1.PointValue(2) = Year for ON (0-99)

- HMITalk1.PointValue(3) = Hour for ON (0-23)

- HMITalk1.PointValue(4) = Minutes for ON (0-59)

- HMITalk1.PointValue(5) = Seconds for ON (0-59)

- HMITalk1.PointValue(6) = Day for OFF (1-31)

- HMITalk1.PointValue(7) = Month for OFF (1-12)

- HMITalk1.PointValue(8) = Year for OFF (0-99)

- HMITalk1.PointValue(9) = Hour for OFF (0-23)

- HMITalk1.PointValue(10) = Minutes for OFF (0-59)

- HMITalk1.PointValue(11) = Seconds for OFF (0-59)

Read trigger date and time

COMMAND DESCRIPTION:

Reads the trigger date and time.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Input

HMITalk1.DriverNumPoints = 1-12

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 8

 

RETURNS:

- HMITalk1.PointValue(0) = Day for ON (1-31)

- HMITalk1.PointValue(1) = Month for ON (1-12)

- HMITalk1.PointValue(2) = Year for ON (0-99)

- HMITalk1.PointValue(3) = Hour for ON (0-23)

- HMITalk1.PointValue(4) = Minutes for ON (0-59)

- HMITalk1.PointValue(5) = Seconds for ON (0-59)

- HMITalk1.PointValue(6) = Day for OFF (1-31)

- HMITalk1.PointValue(7) = Month for OFF (1-12)

- HMITalk1.PointValue(8) = Year for OFF (0-99)

- HMITalk1.PointValue(9) = Hour for OFF (0-23)

- HMITalk1.PointValue(10) = Minutes for OFF (0-59)

- HMITalk1.PointValue(11) = Seconds for OFF (0-59)

Write communication parameters

COMMAND DESCRIPTION:

Sets communication parameters and device unit number.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Output

HMITalk1.DriverNumPoints = 6

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 9

 

WHERE:

- HMITalk1.PointValue(0) = New Device unit number

- HMITalk1.PointValue(1) = New Parity

- HMITalk1.PointValue(2) = New Data bits

- HMITalk1.PointValue(3) = New Stop bits

- HMITalk1.PointValue(4) = New COM1 Baud rate

- HMITalk1.PointValue(5) = New COM2 Baud rate

Read communication parameters

COMMAND DESCRIPTION:

Reads communication parameters and device unit number.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Input

HMITalk1.DriverNumPoints = 1-6

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 9

 

RETURNS:

- HMITalk1.PointValue(0) = Current Device unit number

- HMITalk1.PointValue(1) = Current Parity

- HMITalk1.PointValue(2) = Current Data bits

- HMITalk1.PointValue(3) = Current Stop bits

- HMITalk1.PointValue(4) = Current COM1 Baud rate

- HMITalk1.PointValue(5) = Current COM2 Baud rate

Read list of value-codes to be recorded

COMMAND DESCRIPTION:

Reads a list of the active value-codes that are being recorded

in the memory file.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Input

HMITalk1.DriverNumPoints = 2-169

HMITalk1.DriverP0 = Unit Address (1-255).

HMITalk1.DriverP1 = 14

HMITalk1.DriverP2 = Offset (0-999)

 

RETURNS:

- HMITalk1.PointValue(0) = First value-code

- HMITalk1.PointValue(1) = Second value-code

.

.

.

- HMITalk1.PointValue(NumPoints-2) = Last value-code

- HMITalk1.PointValue(NumPoints-1) = Current mode (0 or 1)

Select value-codes to be recorded

COMMAND DESCRIPTION:

Indicates what measurements must be recorded in the

memory file.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Output

HMITalk1.DriverNumPoints = 1-168

HMITalk1.DriverP0 = Unit Address (1-255).

HMITalk1.DriverP1 = 14

HMITalk1.DriverP2 = Offset (0-999)

HMITalk1.DriverP3 = Mode (0 or 1)

HMITalk1.DriverP6 = Filename (8 chars)

 

WHERE:

- HMITalk1.PointValue(0) = First value-code (0-999)

- HMITalk1.PointValue(1) = Second value-code (0-999)

.

.

.

- HMITalk1.PointValue(NumPoints-1) = Last value-code (0-999)

Clear memory

COMMAND DESCRIPTION:

Sends an order to clear the device's internal memory.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Digital Output

HMITalk1.DriverNumPoints = 1

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 1

Reset device

COMMAND DESCRIPTION:

Sends an order to reset the device.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Digital Output

HMITalk1.DriverNumPoints = 1

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 2

Read Binary Inputs

COMMAND DESCRIPTION:

Reads Binary Input status.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Digital Input

HMITalk1.DriverNumPoints = 1-6

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 37

HMITalk1.DriverP2 = Defines the first input to be read (1-6).

 

WHERE:

- HMITalk1.PointValue(0) = First Input status (0 or 1).

- HMITalk1.PointValue(1) = Second Input status (0 or 1).

.

.

- HMITalk1.PointValue(n) = Last Input status (0 or 1).

Read A/D Channels

COMMAND DESCRIPTION:

Reads A/D Channels current values.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.DriverDataType = Analog Input

HMITalk1.DriverNumPoints = 1-2

HMITalk1.DriverP0 = Unit Address (0-99).

HMITalk1.DriverP1 = 39

 

WHERE:

- HMITalk1.PointValue(0) = DC1 Channel.

- HMITalk1.PointValue(1) = DC2 Channel.

Returned Errors List

[1005] DRIVER (Internal): Invalid driver stage

[1201] DRIVER (System): Error closing %s

[1204] DRIVER (System): Error opening %s

[1208] DRIVER (System): Error seeking end of %s

[1210] DRIVER (System): Error writing to %s

[1300] PROTOCOL (Timeout): No answer

[1433] PROTOCOL (Format): Validation error in device response

[2114] CONFIG (NumValues): Invalid number of values (must be 12)

[2129] CONFIG (NumValues): Invalid number of values (must be 6)

[2147] CONFIG (NumValues): Only one value can be read or written

[2159] CONFIG (NumValues): Too many files requested (max=256)

[2160] CONFIG (NumValues): Too many files requested (max=7)

[2181] CONFIG (NumValues): Too many values (max=12)

[2190] CONFIG (NumValues): Too many values (max=168)

[2194] CONFIG (NumValues): Too many values (max=2)

[2206] CONFIG (NumValues): Too many values (max=3)

[2226] CONFIG (NumValues): Too many values (max=6)

[3018] CONFIG (P0): Invalid device address (0-99)

[3514] CONFIG (P1): Invalid command (0, 1, 2, 3, 4, 6 and 39 only)

[3519] CONFIG (P1): Invalid command (0-9 or 14 only)

[4064] CONFIG (P2): Invalid first register (0-999)

[4077] CONFIG (P2): Invalid offset (0-999)

[4082] CONFIG (P2): Invalid period (must be a positive number)

[4098] CONFIG (P2): Invalid slave number (0-99)

[4123] CONFIG (P2): Invalid variable code (0-11)

[4545] CONFIG (P3): Invalid mode (0-1)

[4554] CONFIG (P3): Invalid period (must be a positive number)

[5009] CONFIG (P4): Invalid file (0-6)

[5514] CONFIG (P5): Must be a positive number

[6006] CONFIG (P6): Filename must be 8-chars long

[6007] CONFIG (P6): Filename not defined

[6020] CONFIG (P6): Invalid filename length (must be 8 chars)

[8100] CONFIG (Remote): Device error

[8123] CONFIG (Remote): Error in response

About the XCVMMEM.tlk driver

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

Driver Source Code Last Update: 03/08/2004 14:07:44

Driver Reference Last Update: 10/30/2008 17:36:03

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

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

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