a set of tools for creating interfaces to control Global Cache equipment
the documentation is updated 18.6.2018
webinars and video-lessons >>
The iRidium driver for Global Cache network adapters enables sending of IR and RS232 commands received from control panels via TCP/IP. The product line also has dry contact modules and sensors.
With the help of Global Cache you can control any equipment with IR sensors or control СОМ-ports: DVD/BluRay players, commutators, matrix, preamplifiers, etc.
Equipment configuration and settings required for iRidium to control Global Cache equipment.
Global Cache equipment includes modules with Ethernet, Wi-Fi, Ethernet + PoE. The general connection scheme:
The line of supported equipment:
GC-100-06, GC-100-12, GC-100-18, GC-100-18R
iTach WiFi to IR / iTach TCP/IP to IR
iTach WiFi to SL / iTach TCP/IP to SL
iTach WiFi to СС / iTach IP to СС
With the help of the converter web-interface set up:
See video-lessons on setting up the Global Cache hardware part
Add the Global Cache driver in PROJECT DEVICE PANEL from DEVICE BASE
To connect via the Internet indicate the IP-address (domain name) of your Internet router in the Host string. Set up Port Forwarding on your router for remote control of equipment.
You can learn the public IP-address of your router with the help of Internet services, for example .
You need the possibility to change connection properties when you disconnect from the Wi-Fi network of the automation object and start using 3G or another Wi-Fi network. To maintain control of the object you need to switch from the local to public IP-address of the Internet router.
The switch is not automatic. You have to select the connection mode. For remote acces you have to make ports for controlling the automation system public. In order to do that you have o set up the Port Forwarding service on your Internet router. VPN can provide protected connection.
1 Download the template (*.js) (right-click button: "Save object as ..."), add the template in the script editor with the button (+) Add Script from file
2 Set up script properties as it is shown in the example:
Copy the driver name from Projeсt Device Panel - the list of properties has to be copied from the example.
3 Select the button which will be responsible for the switch of Internal and External properties. Open Macros Editor for the Press event (Object Properties > Programming), select the Script Call command and add it by double-clicking on it. Select the name of the function which will be activated by the button:
Now each pressing on the button will apply the corresponding connection properties.
Depending on the Global Cache module type you have access to different sets of outputs:
The output for sending IR commands with the help of IR emitters and IR blasters.
Setting up IR outputs:
Setting up IR commands:
Setting up feedback:
The Sensor Notify output is available if you select "Mode: Sensor Notify" in the settings of the IR output of the Global Cache module. GC sensors can be connected to it.
Setting up the output: select IR output ang change the Mode parameter:
Setting up feedback about the sensor state:
The output for sending commands to the equipment COM-port (RS232)
Setting up RS232 outputs:
Setting up RS232 commands:
Setting up feedback from RS232:
Dry conatacts (relays), which enable lock/unlock of equipment control contacts.
Setting up the output:
Setting up commands:
Setting up feedback about the relay state:
Rules for formatting IR commands and data for sending them via RS232. Relay control.
Global Cache has to send IR commands converted in the format presenting them as a sequence of pulses and pauses of the IR signal. The database of IR commands built-in iRidium Studio stores the converted commands so it is easy to use.
You can convert IR commands you cannot find in the database from the НЕХ (CCF) to Global Cache format with the help of iConvert.
IR commands can be "learned" by reading them from an IR remote control directly in iRidium Studio or with the help of iLearn. The commands received in such way will be automatically converted in the required format.
Where to find IR commands:
The online database of Global Cache IR commands does not operate without connection to the Internet. The commands are saved in the special Global Cache format. They will not work with other TCP/IP-to-IR converters.
Click '"Update"' to upload the list of commands. Drag the folder with commands on the Global Cache IR output in your project. The command do not require any additional setting.
GC-IRL IR Learner is a device reading IR commands for Global Cache. It can be connected to the СОМ-port of your PC or the СОМ-port of Global Cache GC-100-06(12,18,18R). Via iTach IP2SL(WF2SL) learning with the help of GC-IRL is not supported
Global Cache iTach IP2IR and WF2IR have built-in readers of IR commands. The emitter of the IR remote control had to be directed to the port of module reload. The reader converts commands in the Global Cache format and sends them to PC.
If the command name in the window doesn’t change when you click the button on the IR remote control – the learning failed! To find the reason of the problem, use the program iLearn from Global Cache. It will show errors at connection. Check the connection with the converter.
Documentation for AV equipment cotains IR commands for the equipment in the HEX (CCF) format. They have to be converted into the Global Cache format and added to your custom database of IR commands.
Commands can be converted with the help of iConvert. It provides conversion of IR commands to the Global Cache format from HEX (CCF). Example:
Example of transferring IR commands for the Panasonic TV in the Global Cache database of IR commands:
Documentation Panasonic Plasma TV Remote control (IR). The initial IR command in HEX (CCF):
0000 0071 0000 0032 0080 003F 0010 0010 0010 0030 0010 0010 0010 0010 0010 0010 0010 0010 0010
0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0030 0010 0010 0010 0010
0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0030 0010 0010 0010
0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0010 0030 0010 0030
0010 0030 0010 0030 0010 0030 0010 0010 0010 0010 0010 0010 0010 0030 0010 0030 0010 0030 0010
0030 0010 0030 0010 0010 0010 0030 0010 0A98
It is converted with the help of iConvert:
We have the command in the Global Cache format but it is not ready for use. You have to remove the IR command header which is automatically added by iRidium Studio:
Save the blue part of the IR command in the database of IR commands (as at work with GC-IRL)
Add the IR device from the database in your project and indicate in the Frequency field of its settings the frequency we colpied from iConvert.
In the general "DEVICE BASE" you can create the list of devices and commands for fast adding in any new iRidium project. You can create IR devices only in your custom databse as the standard one is not available for editing.
Create a user database:
Add the IR device in it (it is not a physical device but a folder with a set of IR commands)
In the Commands & Feedbacks tab create a list of empty IR commands, select their names:
The learned IR command will be written in the database with the semi-bold font. Close the database editor after saving all changes.
Add the ready IR device in your project: select your database in the DEVICE BASE list and drag the IR device on the Global Cache IR output
Set up Frequency (Hz) - the frequency of command sending from the IR output: for the IR output or for a selected device.
The Serial output of Global Cache devices enables command sending via RS232. These commands cannot be learned. They have to be added in iRidium from the equipment documentation. RS232 commands can be stored in one of the following formats:
iRidium has to determine the format of the command you added. That is why the command has to be formatted in accordance with the iRidium syntax.
Formatting ASCII strings in Serial output:
Formatting the carriage return <CR> and sting end <LF>:
Formatting HEX symbols on the Serial output:
Formatting decimal numbers on the Serial output:
In the general "DEVICE BASE" you can create the list of devices and commands for fast adding in any new iRidium project. You can create RS232 devices only in your custom databse as the standard one is not available for editing.
Add the RS232 device in it (it is not a physical device but a folder with a set of commands)
In the Commands & Feedbacks tab create a list of commands:
Open Command Properties with double-clicking and add a command in the Command field:
Add a ready set of RS232 commands in your project: select your database in DEVICE BASE, drag the RS232 device on the Global Cache Serial output.
Dry contacts (relays), enable lock/unlock of equipment control contacts.
Relay command are preset in the Global Cache driver. To lock and unlock relays, send 1 or 0 to the module output. Commands can be sent with the help of Button or Trigger Button:
It is a graphic item with 1 or 2 states. Buttons depending on settings can be fixed or not. Each pressing on Button initiates sending of the same set of commands assigned to it.
1 Create a variable were a number or string has to be written. Set it up as it is shown in the instructions.
2 Create a button and set it up as follows (see all settings):
3 Drag the variable on the button and indicate the following in the dialog window:
You can use several events together. For example, send [ 100 ] on pressing and [ 0 ] on releasing.
4 Now the variable is connected to the button. You can see all relations in OBJECT PROPERTIES > Programming
OBJECT PROPERTIES > Programming
Trigger switch with the help of the "Trigger Button" item allows to send 2 values indicated in Trigger Value 1 and Trigger Value 2 alternately. When there is feedback the trigger automatically takes the respective value and sends the value opposite to the current one on pressing. The trigger cannot be set up for working with 3 and more values.
Trigger Value 1
Trigger Value 2
1 Create a variable which has to be switched between 2 values. Set it up as it is shown in the instructions.
2 Create a button and set it up as follows (see all item settings):
3 Drag the variable on the trigger, in the dialog window indicate:
For Trigger button you can use only one event at a time
4 Now the variable is connected to the trigger. You can see all relations in OBJECT PROPERTIES > Programming
Displaying relay states:
Graphic items can display values of variabls by changing their state or text:
1 Set up the graphic item so it would display the received values:
Select in the General settings:
Feedback: Channel (if 0 = false) or
Feedback: Invert Channel (if 0 = true).
2 Assign the equipment channel (Feedback) to the graphic item:
Drag the feedback channel or the variable on the item, select In Text in the dialog window
For correct work the item needs 2 states. The first one corresponds to the zero value, the second - to any value different from zero.
The $V template added in the item text will enable output of received values in the item text.
1 Drag the equipment channel (Feedback) to the graphic item:
The item can have any number of states and settings. The value will be output in the text field of all item states.
Add $V in the item text. Drag the feedback channel or the variable on the item, select In Value in the dialog window. It will enable output of the received whole number and ass any text to it.
There are templates for outputting fractions and etc.:
A command (template) of incoming data processing and displaying is entered into the text field of a graphic Item and can be combined with other text or symbols (comments, units of measurement)
Sending of IR commands is possible only with the help of "Button" or via the script.
1 To send a command once, assign it to the Press or Release event:
2 To create a macro command, assign several commands to Press or Release:
You can add a delay between the commands - Delay() to regulate the speed of command sending
3 To send a command in a cycle when holding the button, select Press and Hold:
Hold settings are located in Object Properties > General:
4 To send a command in a cycle when holding the button using the Global Cache tools: indicate Repeat; 50 (or another big number), assign it to Press, assign the Stop IR command to Release.
When clicking on the button the GC IR emitter will start to execute the command the indicated number of times and will stop the command sending when you release the button. The operation is similar to the Hold command but required constant repeat of command sending to GC
var device = IR.GetDevice("Global Cache");
var CommandString = 'sendir,1:1,1,36127,1,1,96,31,17,16,16,16,16,32,16,32,49,32,16,16,16,16,16,16,16,16,16,16,16,16,16,16,16,16,16,16,16,16,32,17,16,16,16,16,16,32,16,16,16,16,16,16,16,16,32,32,16,16,16,16,16,16,16,16,32,17,16,16,16,16,16,32,16,4624';
var CommandName = "COMMAND";
IR.AddListener(IR.EVENT_ONLINE , device, function()
device.Set(CommandName, ""); // .Set command by name
device.Send([CommandString,0x0D]); // .Send command as string
Formatting of IR commands for the Send method is discribed in detail in iTach API.
You can send RS232 commands with the help of "Button" or via the script.
When sending data via the script, you can form a command with running values. For example, when controlling with Level: add the current position of the level slider in the command body and send it to equipment.
3 To send a command in a cycle when holding the button, select Press and Hold :
var device = IR.GetDevice("Global Cache");
var CommandString = "PON";
var CommandName = "COMMAND 1";
IR.AddListener(IR.EVENT_ONLINE , device, function()
device.Set(CommandName, ""); // .Set command by name
device.Send([CommandString, '\r\n'], 1); // .Send command as string
// device.Send([<data>], <transport_id>)
// <data> - command string
// <transport_id> 0 - port 4998, 1 - port 4999, 2 - port 5000
Relays take values 0 - unlocked and 1 - locked. Commands can be sent with the help of
For commands to Relay it is required to indicate the relay state:
IR.GetDevice("Global Cache").Set("Relay 1", 1)
// close Relay 1
IR.GetDevice("Global Cache").Set("Relay 1", 0)
// open Relay 1
Sensor Notify, Relay
Sensors and relays send in iRidium values 1 - locked, 0 - unlocked. The values can be output in the text of visually display on items.
The feedback processing from GC COM-ports:
IR.AddListener(IR.EVENT_RECEIVE_TEXT, IR.GetDevice("Global Cache"), function(text, id)
if (id == 1)
IR.Log("COM1 data: "+ text);
else if (id == 2)
IR.Log("COM2 data: "+ text);
// id - is a transport id of GC device, 1 - COM port 1, 2 - COM port 2
Ready drivers with feedback from AV equipment can be found on the web site, in the JS Modules section
Emulator - an application launched in iRidium Studio to test the project work.
Emulator work modes see in iRidium Studio > Tools > Options > Emulator:
Upload and launch of the iRdidium project on the control panel is performed with the help of the iRidium Transfer application, installed on your PC. You can also upload the project on the panel from the editor via Transfer.
Use i3 pro for iOS, Android, Windows, Mac in Test Mode by downloading projects via iRidium Transfer (the possibility is available for integrators):
iRidium for Windows
iRidium for iOS
iRidium for Android
iRidium for Mac
iRidium Transfer settings
Commercial use of iRidium is possible only at download of visualization projects with the help of the iRidium Cloud service on the iRidium Mobile web site (see the instructions).
iRidium Cloud can be set up only by a registered integrator. After the setting up he can invite end-users to control the automation object.