# Global Caché Control Tower

The Global Caché Control Tower plugin allows you to import IR codesets into a local database for use with Global Caché device plugins. You can import codesets from Global Cache's online database, the iLearn software tool, or from a codeset email.

The plugin is compatible with Q-SYS Designer version 7.0 and above.

## Configuration Overview

1. Drag the Global Caché Control Tower plugin into your schematic.
2. Press F5 to save your design to the Core and run it, or press F6 to emulate your design.
3. In your schematic, double-click the plugin to open the component's control panel.
4. Import device IR codes in one of three ways. See Controls for more information.

   #### Online Database

   Browse the entire Global Caché device catalog and select a device IR codeset to import into the local database.

   1. Click the Online Database tab.
   2. Click Connect to Database.
   3. Select a Brand Name, Device Type, and Model / Codeset.
   4. Optionally, browse the list of included functions for the selected model or codeset.
   5. Click Get Codeset. The codeset is saved to the local database.
   6. Click the Local Database tab.
   7. Select a Brand, Device Type, and Model / Codeset that you previously saved in the local database.
   8. From the Codeset JSON field, copy all text and paste into the plugin for your Global Caché device.

   #### Codeset Import

   Import IR codes from the Global Caché iLearn software tool. See the iLearn page on the Global Caché website for more information.

   1. Click the Import tab.
   2. Within the Codeset Import section, select a format, depending on how the IR codes are formatted.
   3. Paste the contents of the codeset file into the text field, and then press Enter.
   4. Click Parse Codeset Data.
   5. In the Codeset Name field, type a name that represents the device to control with this codeset, and then press Enter.
   6. In the Manufacturer field, type the name of the device manufacturer, and then press Enter.
   7. Select a Device Type from the drop-down menu.
   8. In the Codes Found drop-down menu, optionally view the list of codes parsed from the codeset text. You do not need to select an individual code.
   9. Click Add Codeset to Local IR Database.
   10. Click the Local Database tab.
   11. Select a Brand, Device Type, and Model / Codeset that you previously saved in the local database.
   12. From the Codeset JSON field, copy all text and paste into the plugin for your Global Caché device.

   Note: If you aren’t copying directly from the iLearn-generated codeset file, you can still import properly formatted commands – for example, from Global Caché’s iConvert application. However, you must include a command name in front of the command in the form [<command name>]. For example, if your command is sendir,1:1,3814,37878,1,1,32,32,32,32,64,32,32,32,32,32,32,32,32,32,32,32,32,64,32,32,64,32,32,3262, you must import it in the plugin with a name like this: [POWER TOGGLE] sendir,1:1,3814,37878,1,1,32,32,32,32,64,32,32,32,32,32,32,32,32,32,32,32,32,64,32,32,64,32,32,3262.

   Note: The codeset file generated by iLearn can contain commands in multiple formats. If you copy and paste the entire contents into the plugin and attempt to parse the codeset data, it will only find codes in the format specified in the plugin.

   #### Codeset Email

   Import IR codes from a Global Caché codeset email. See the Global Caché Control Tower product page to register to receive IR codeset emails for your devices.

   1. Click the Import tab.
   2. Within the IRCodes Email Import section, paste the entire subject line of a codeset email from Global Caché into the Subject field, and then press Enter.
   3. Review the Brand, Code Name, and Code Number that was parsed from the subject line. Click Less or More to adjust this information.
   4. Select a Device Type.
   5. Paste the entire contents of the codeset email body into the IRCodes Email Body field.
   6. Click Import Email to Local IR Database.
   7. Click the Local Database tab.
   8. Select a Brand, Device Type, and Model / Codeset that you previously saved in the local database.
   9. From the Codeset JSON field, copy all text and paste into the plugin for your Global Caché device.

## Properties

There are no configurable properties for this plugin.

## Controls

### Online Database

The Online Database allows you to browse the entire Global Cache device catalog and select a device IR codeset to import into the local database. You must have an internet connection to browse codesets in the online database.

#### Connectivity

Click Connect to Database to attempt a connection to the Global Cache IR database. You are ready to select a device when the Logged In LED glows green and IRDB Status indicates "OK - Brands Retrieved".

Note: The online database connection times out after one minute of inactivity.

#### Brand Name

Select the brand name of your device. Use Filter Brand Names to narrow the list.

#### Device Type

Select the type of device – TV, Projector, etc.

#### Model / Codeset

Select the exact model or codeset of the device.

#### Browse Included Functions

Click to see a list of all functions included in the selected device codeset. You do not need to select an individual code, as all codes are included when getting a codeset.

#### Get Codeset

Click to retrieve the codeset for the specified device. When complete, IRDB Status indicates "OK - Codeset Saved to Local Database".

#### Notes

Notes for the selected codeset are shown here, if applicable.

### Import > Codeset Import

Import IR codes from the Global Caché iLearn software tool. See the iLearn page on the Global Caché website for more information.

#### Codeset Format

Select the format for the codeset you are importing. This setting determines how the codeset is parsed.

#### Paste Code / Codeset Text

Paste the entire contents of the codeset from the iLearn software tool here, and then press Enter.

#### Parse Codeset Data

Click to process the codeset. If you have selected the correct format, and the data is valid, the Carrier Frequency and Codes Found boxes become populated.

#### Codeset Name

Type a name that represents the device to control with this codeset, and then press Enter.

#### Manufacturer

Type the name of the device manufacturer, and then press Enter.

#### Device Type

Select the type of device – TV, Projector, etc.

#### Carrier Frequency

Displays the calculated IR carrier frequency of the IR codeset being imported, rounded to the nearest 1 kHz.

#### Codes Found

Click to view a list of parsed codes in the codeset. You do not need to select an individual code, as all codes are included when adding the codeset to the local IR database.

#### Add Codeset to Local IR Database

Click to import the codeset information into the Local Database.

### Import > IRCodes Email Import

Import IR codes from a Global Caché codeset email. See the Global Caché Control Tower product page to register to receive IR codeset emails for your devices.

#### Subject

Paste the entire subject line of a codeset email from Global Caché here.

#### Brand / Name

Click Less and More to adjust the detected Brand, Code Name, and Code Number from the email subject.

#### Device Type

Select the type of device – TV, Projector, etc.

#### Brand | Code Name | Code Number

Displays the device information detected from the email subject.

#### IRCodes Email Body

Paste the entire contents of the codeset email body into this field.

#### Import Email to Local IR Database

Click to import the codeset information into the Local Database.

### Local Database

The Local Database contains saved IR codesets from the Online Database and Import tabs.

Note: Each copy of the Control Tower plugin in a design uses its own Local Database, which is saved with the design. A new instance of the Control Tower plugin shows a blank Local Database.

#### Brand

Select the brand of the device for which you imported a codeset. To filter the list, enter a value in the Filter Brand Names field and press Enter.

#### Device Type

Select the type of device – TV, Projector, etc.

#### Model / Codeset

Select the exact model or codeset of the device.

#### Browse Included Functions

Click to see a list of all functions included in the selected device codeset. You do not need to select an individual code, as all codes in the codeset are included in the codeset JSON.

#### Codeset JSON

Once you have selected a brand, device, and model/codeset, this field contains the pre-formatted JSON to copy and paste into the plugin for your Global Caché device.

#### Delete Codeset

Click to delete the selected codeset from the local database.

## Control Pins

Pin Name | Value | String | Position | Pins Available
--- | --- | --- | --- | ---
Email
Body | (text) | Input / Output
Import IR Codeset | (trigger) | Input / Output
Subject | (text) | Input / Output
iLearn Import
Add Codeset | (trigger) | Input / Output
Device Type | (text) | Input / Output
Format | Global Caché Compressed/Uncompressed HEX Flex JSON (HTTP) | Input / Output
Frequency | (text) | Input / Output
Manufacturer | (text) | Input / Output
Name | (text) | Input / Output
Parse | (trigger) | Input / Output
Paste | (text) | Input / Output
IRDB
Brand | (text) | Output
Connect | 0 1 | false true | – | Input / Output
Device Type | (text) | Output
Filter | (text) | Output
Functions | (text) | Output
Get | (trigger) | Input / Output
Logged In | (indicator) | Output
Model | (text) | Output
Notes | (text) | Output
Status | (indicator) | Output
Local
Brand | (text) | Output
Codeset JSON | (text) | Output
Delete | (trigger) | Input / Output
Delete No | (trigger) | Input / Output
Delete Yes | (trigger) | Input / Output
Device Type | (text) | Output
Filter | (text) | Output
Functions | (text) | Output
Model | (text) | Output

Software and Firmware | Resources | QSC Self Help Portal | Support

Copyright © 2022 QSC, LLC. Click here for trademark and other legal notices.