====== Global Cache ====== The following is a basic guide to using Global Cache products with iViewer & guiDesigner. These instructions assume you already have a basic understanding of guiDesigner and iViewer. See our [[software:gui-designer:guidesigner-quick-start-guide|guiDesigner/iViewer Quick Start Guide]] if you are not familiar with our software yet. ===== Setting Up Your Global Cache Device ===== The first thing you will need to do is connect your Global Cache device to your network so iViewer can connect to it to send it commands. To do this you will need to follow your hardware's documentation. This can be found at the Global Cache website http://www.globalcache.com ===== Adding The System in guiDesigner ===== Next we need to add the Global Cache device as a system in guiDesigner. So add a new system and fill in the relevant properties as required.\\ {{:software:knowledge-base:brand-knowledge-base:guidesigner_global_cache_system_properties.png?nolink|}} - System Name - Enter an appropriate system name here - Protocol - This must be set to TCP Client - IP Address/Host Name - Set this as the IP address of your Global Cache hardware - Port - Communication with the hardware is accomplished by opening a TCP socket on Port 4998. All commands and data, with the exception of serial (RS232) data, are communicated through Port 4998. Port 4998 is used for such things as iTach status, IR data, relay operation, and reading digital input states. erial data is communicated via Ports 4999 and above. The serial connection in module 1 will communicate over Port 4999. Serial connections in the next lowest module will communicate over Port 5000, and so on (i.e. 1:4999, 2:5000, 3:5001, etc.). ((From Global Cache API Documents http://www.globalcache.com/files/docs/API-iTach.pdf)) - EOM (End Of Message) - Enter a hex carriage return here. This is for parsing feedback from the device, if this is not entered then it may cause problems with feedback processing. ===== Adding Commands ===== How you enter commands into guiDesigner varies depending on the format. We will list some basic information below, please refer to the [[http://www.globalcache.comGlobal Cache website]] for more information. ==== Infrared (IR) Commands ==== IR commands send to Global Cache hardware must be in a specific format as shown below ^sendir,,,,,,,,,,….,,\x0D^ (where N is less than 260 or a total of 520 numbers) where; **** is as defined in Global Cache documentation\\ **** is |0|1|2|…|65535| (1) \\ **** is |15000|15001|….|500000| (in hertz)\\ **** is |1|2|….|50| (2) (the IR command is sent times)\\ **** is |1|3|5|….|383| (3) (used if is greater than 1, see below)\\ **** is |1|2|…|65635| (4) (number of pulses)\\ **** is |1|2|…|65635| (4) (absence of pulse periods of the carrier frequency)\\ **\x0D** is a carriage return which must be appended to all commands sent to Global Cache units from iViewer. An example of an IR Command in Global Cache Format looks like this:\\ ^sendir,1:1,1,38109,1,1,171,171,21,64,21,64,21,64,21,21,21,21,21,21,21,21,21,21,21,64,21,64,21,64,21,21,21,21,21,21,21,21,21,21,21,21,21,64,21,64,21,21,21,21,21,21,21,21,21,21,21,64,21,21,21,21,21,64,21,64,21,64,21,64,21,64,21,3810\x0D ^ To learn your IR code in Global Cache format, you will need to use their [[http://www.globalcache.com/downloads/|iLearn software]] (if you have a Global Cache IR Learner). Or use their [[http://www.globalcache.com/downloads/|iConvert software]] to convert hex (CCF) to Global Cache IR format. ==== Serial Commands ==== All serial data is passed through without interpretation or conversion via an assigned, unique IP port. The Global Cache serial connector is assigned an IP Port starting at 4999. ==== Relay Commands ==== Relay commands send to Global Cache hardware must be in a specific format as shown below. Relay state is set as follows:\\ setstate,1:1,\x0D for the 1st relay output\\ setstate,1:2,\x0D for the 2nd relay output\\ setstate,1:3,\x0D for the 3rd relay output\\ where; **** is |0|1| (<0> is open, <1> is closed) ===== More Commands & Feedback ===== For more info and commands you should see the [[http://www.commandfusion.com|Global Cache Website.]] ===== Other Information ===== One of our users Barry Gordon has written up a helpful post on our Google Groups re using Global Cache products and iViewer together.[[https://groups.google.com/d/msg/commandfusion/d_nXt0sW2sw/-Aok8AH7ykAJ|. This post can be viewed here]] This topic has been discussed a number of times in the Google Groups.\\ [[https://groups.google.com/forum/?hl=en&fromgroups#!searchin/commandfusion/global$20cache|Click here to do a search on Global Cache in the CommandFusion Google Groups.]]