Clone this wiki locally
This article explains how to use a GlobalCaché device to send IR codes with OpenRemote 2.0
GlobalCaché produces IP2IR boxes that integrate nicely with OpenRemote to control your IR devices.
Integration is currently handled with the generic TCP/IP protocol implementation in OR. This allows usage of the standard GC API to send IR codes.
Configuration of System
Getting the GC command to send
As document in the GC API documents, the command used to send an IR code is
The format to use for the IR code is proprietary to GC. There are however easy ways to create the command with the correct format.
Learning an IR code
If you have an iTach device or a GC-IRL learner, you can directly learn the IR code from the remote control and have it generate the command in the correct format.
Use the iLearn tool provided by GC to perform this. You can find this tool on the GC download page. GC provides Windows version of the software. If you are using Mac OS X, you can check Martijn Rijnbeek's page.
After launching the tool, select the learner you will be using and connect to it.
Point your remote control at the learner and press the button for which you want the learn the code. Keep it press for a short while and let it go, the learned code will appear in the "Edit View". You might need to experiment a bit with the duration you're holding down the button.
Enter the name of the button and click "Save Data". The code will now be processed (duplicate received IR data is removed) and saved. It appears in the "Results" list below.
When you are finished learning all the IR codes you need, you're ready copying the commands to the OR Designer. First make sure the "Module" and "Connector" parameters in the "Capture Options" are correctly set based how you'll use your GC for output in OR. For instance, if you are using a GC-100-12 device for output and connecting your flasher on the first IR port, you would set "Module" to 4 and "Connector" to 1. Now, select the code you want to use in the list and copy the content of the text box in "Edit View".
Converting a Pronto CCF code
If you already have the IR code in Pronto CCF format, you can convert it to the appropriate command format using the iConvert tool, also available both on the GC download page and on Martijn Rijnbeek's page.
After launching the tool, make sure to select the "Hex to Global Caché" option. Just paste the code in CCF format in the "Conversion" text box and click the "Convert" button.
The GC IR command is now available in the "Output - Global Caché Command" text box. Note however that it has place holders for the module, connector and repeat count. We'll take care of that in the modeler when we'll use this command, so just copy the text as is.
Integrating the GC command in the Designer
In the Designer, create a new Device for the gear you want to control through IR. For instance, would you be controlling the TV in your living room, you could create a device such as
Proceed to adding the commands by clicking "Next >" and select "Add command".
Select TCP/IP as the protocol, enter a name for your command and fill-in the required attributes. IP Address is the address or name of your GC device, Port is the TCP socket used for control on the GC, the default is 4998. For the command, paste the GC command you generated using iLearn or iConvert as instructed above. If you used iConvert, you will need to replace the and place holders with appropriate values for your installation. Also replace the placeholder with 1.
Click "Submit and continue" if you need to enter additional IR codes or "Submit" if you're done. Click "Finish" and you're now ready to use the created commands on your UI design.
Specific Designer Remarks - UI Designer
If you would like a quick remote controller interface for television or audio system, there is a template available that does that both for mobile phones and tablets. You can find the template on the OpenRemote Online Designer at the UI Designer tab. Press 'New' and choose "New screen from template". There you will find public templates with keywords such as remote and television or audio to find the layout you need. After downloading the template you can of course modify it to your own needs.
Users of OpenRemote Designer can easily import IR codes from a Pronto XCF file and generate commands to send them via an IRTrans using the Import IR Commands from file feature.