Global Cache iTach/GC-100 Interface

(c) 2010-2014 My Device.

www.mydevice.com.au

This driver provides 2-way feedback and control for the Global Cache GC-100 and iTach family of products.

I would like to personally thank the staff at Global Cache for all their help during the development of this driver.

Note:

Please report any bugs found to bugs@mydevice.com.au. Include driver version number and steps to reproduce the issue where possible.

Driver Configuration Settings:

TCP Settings:

TCP Address - This is the IP address of the GC unit.

TCP Port - This is the interface port on the GC unit, normally 4998.

System Settings:

Auto connect/disconnect serial - Check this box to have the driver automatically disconnect after sending a serial message. This will free the port on the GC unit for other devices to connect. If you are sending a lot of messages, this will slow things down.

Licensing:

Unlock code - Enter your purchased unlock code here. Leave blank for trial mode. In trial mode the driver will run for 60 minutes and then stop functioning. You can reboot the XP processor to restart the trial period.

Functions:

System:

Get Devices

This function determines the type of modules installed in your device. Up to 8 modules are possible in a single unit. The results are stored in Device -> Module 0-7 Type system variables.

Possible values are: Unknown, Ethernet, Serial, 3 Relay, 3 IR.

Get Version

This function determines the version of a module in your device. The string is stored in the System Version variable.

Module Address : 0 - 7

Blink Power LED

This function flashes the power LED on the GC-100. Useful for locating a single device amongst many.

State: On/Off.

Get Network Settings

This function retrieves the current network settings and updates the following system variables:

Config Locked: TRUE/FALSE.

Static IP: TRUE/FALSE.

IP Address: xxx.xxx.xxx.xxx

Subnet: xxx.xxx.xxx.xxx

Gateway: xxx.xxx.xxx.xxx

Set Network Settings

This function sets the network settings. If DHCP is selected, the remaining parameters are ignored.

IP Settings: DHCP/Static.

IP Address: xxx.xxx.xxx.xxx

Subnet: xxx.xxx.xxx.xxx

Gateway: xxx.xxx.xxx.xxx

Infrared:

Set IR Mode

This function sets the output mode of the specified IR module.

Module Address: 0 - 7.

IR Port: 1 - 3.

Mode: IR, Sensor, Sensor Notify, IR No Carrier.

Send Compressed IR

This function sends an IR command that has been compressed using our own special compression algorithm. To generate a compatible string, copy the RTI HEX formatted IR command into our irConvert.exe tool.

A compressed IR string is sometimes necessary as there is a 128 character limition on the length of any RTI driver string. By compressing longer IR commands we can get around this limitation most of the time.

An example compression converts this:

0000 006C 0000 0032 007E 0040 0010 0010 0010 0010 0010 0030 0010 0010 0010 0030 0010 0010 0010 0010 0010 0010 0010 0030 0010 0030 0010 0010 0010 0010 0010 0010 0010 0030 0010 0030 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0030 0010 0030 0010 0010 0010 0010 0010 0010 0010 0010 0010 0030 0010 0010 0010 0030 0010 0030 0010 0010 0010 0010 0010 0010 0010 0010 0010 0030 0010 0010 0010 0030 0010 0010 0010 0030 0010 0010 0010 0030 0010 0010 0010 0010 0010 0708

To this:

38000,126,64,16,16B16,48BCBBBCCBBBCCBBBBBBBBBBCCBBBBCBCCBBBBCBCBCBCBB16,1800

Taking 519 characters and compressing it to 76.

Module Address: 0 - 7.

IR Port: 1 - 3.

IR Command: <Paste the string generated by irConvert.exe here>

Repeat Count: 0 - 31.

Set GC IR

This function sends an IR command which is in the Global Cache format. Strings in this format can be created by the Global Cache tool iConvert.exe.

This function accepts strings in 2 formats. The first is directly from the iConvert.exe tool and looks like this:

sendir,<mod-addr>:<conn-addr>,1,38000,<repeatcount>,1,341,172,21,21,21,65,21,65,21,65,21,21,21,65,21,65,21,65,21,65,21,65,21,65,21,21,21,21,21,21,21,21,21,65,21,65,21,65,21,21,21,21,21,21,21,21,21,21,21,21,21,65,21,65,21,21,21,65,21,21,21,65,21,65,21,21,21,1424,341,86,21,3650

You can paste it directly as is, our driver will strip out the <mod-addr> etc.

Or you can paste it sans the "sendir,<mod-addr>:<conn-addr>,1," section. ie.

38000,<repeatcount>,1,341,172,21,21,21,65,21,65,21,65,21,21,21,65,21,65,21,65,21,65,21,65,21,65,21,21,21,21,21,21,21,21,21,65,21,65,21,65,21,21,21,21,21,21,21,21,21,21,21,21,21,65,21,65,21,21,21,65,21,21,21,65,21,65,21,21,21,1424,341,86,21,3650

Module Address: 0 - 7.

IR Port: 1 - 3.

IR Command: <Paste the string generated by GC's iConvert.exe here>

Repeat Count: 0 - 31.

Stop IR

This function cancels a currently executing IR command.

Module Address: 0 - 7.

IR Port: 1 - 3.

Serial:

Get Serial

This function determines the current settings for the selected serial port. The settings are stored in the System Variables: Serial -> Baud, Flow Control, Parity.

Module Address: 0 - 7.

Set Serial

This function configures the settings for the selected serial port.

Module Address: 0 - 7.

Baudrate: 115200, 57600, 38400, 19200, 9600, 4800, 2400, 1200.

Flow Control: Hardware, None.

Parity: No, Odd, Even.

Connection

This function connects/disconnected to the specified serial port. If you have enabled the auto connect option, this function is handled for you.

Port: 1 - 2.

State: Connect, Disconnect.

Stop Char: None, CR, LF, CRLF.

Send String

This function sends a string to the remote serial port.

Port: 1 - 2.

String: <data to be sent, max 128 chars>

Stop Char: None, CR, LF, CRLF.

Relay:

Set State

This function sets the state of the specified relay.

Module Address: 0 - 7.

Relay: 1 - 3.

State: Open, Close.

Discrete I/O:

Get State

This function gets the state of the specified input and places the result in the system variable <Module>:<Input>. For example, requesting module 4, input 1 will result in the status being updated in the Discrete I/O variable "Input 4:1".

Module Address: 0 - 7.

Input: 1 - 3.