iRidium for Crestron
iRidium for Crestron Fast Start (Sequence of Operation with iRidium for Crestron)
Review of iRidium Software Package for Crestron The iRidium Software Package for Crestron includes components for installation on your PC under Windows XP/7 and components for installation on iOS devices. The part of the package which is installed on your PC and necessary for operation with the Crestron equipment is the iRidium Transfer application which is meant for converting
and uploading GUIs on the Apple iOS or Windows control panels. The part of the software package for installation on iOS devices is iRidiumHD Client application which is in charge of launching and running GUIs on target a device. In order to enable the connection of iRidiumHD iOS Client to the Crestron controller (iRidiumHD Client is connected to the controller as an original Crestron panel) it is required to purchase a demo iRidium license. Licenses for iOS are stored in the Transfer application and are transferred to target iOS devices along with GUIs. Licenses for Windows are stored in the project folder. iRidium supports operation with the following devices:
Apple iOS devices (iPad, iPhone, iPod Touch) Windows XP & Windows 7 based devices
Recommendations and Requirements for Operation with the iRidium Software Package for Crestron
PC under Microsoft Windows XP / 7
iRidiumHD application installed on your iOS device from the Apple App Store Wi-Fi network for uploading and updating GUIs and also for Crestron connection Internet connection for acquiring and activation of iRidium license keys iRidium license file for enabling the connection to the Crestron controller
2
Contents Review of iRidium Software Package for Crestron
1
Recommendations and Requirements for Operation with the iRidium Software Package for Crestron
1
Installation of the iRidium Software Package Components
3
Description of the iRidium Transfer Interface and Design Adding
4
Addition of iOS Devices to the Transfer Panel List
7
Description of the Licensing Procedure for the Control Device
8
Receipt of UDID for Activation of the iRidium Base License for an iOS Device
8
Receipt of Serial Number of the Crestron controller for Activation of the iRidium Ultimate License
9
Licensing Procedure of an iOS Device (for any License Type)
10
Activation of the iRidium Base License Key
12
Activation of the iRidium Ultimate License Key
14
Uploading of the License File to iRidium Transfer
15
Setting of Connection to Crestron Controller
16
Setting of Connection to the controller for BASE license
16
Setting of Connection to the controller for ULTIMATE license
16
Setting of Connection to the Crestron Controller for iRidiumHD iOS Client
17
Creation of iRidium Windows-Client for
19
Receipt of HWID for iRidium Windows-Client Licensing
21
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
3
Installation of the iRidium Software Package Components In order to start your work, it is necessary to install two parts of the iRidium software package. The first part, an installation package for your personal computer under Windows XP / 7, can be downloaded from the iRidium web-site, in the Download section: http://iridiummobile.net/download
The iRidium software package for personal computer consists of several components, but you will only need iRidium Transfer to work with Crestron projects (*.vtz). It is software for converting and downloading designs to the control devices. The second part of the iRidium software package is the Client application for installation on the devices based on the Apple iOS operation system. The application is called iRidiumHD and can be downloaded from the official AppStore. (iTunes: http://itunes.apple.com/us/app/iridiumhd/id369102319?mt=8)
The iRidiumHD Client application is a software component of iRidium that is in charge of launching and using a graphic interface, forming and sending commands to the controlled equipment.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
4
Description of the iRidium Transfer Interface and Design Adding After the iRidium package for your personal computer and the iRidiumHD Client are installed, you can start work with the Crestron project. Start the iRidium Transfer application. On the main screen you can see several tabs: Panels, Designs and Licences. All these tabs are related to each other and correspond to different aspects of forming and uploading iRidium on the control device.
Let’s start work with the Transfer application by adding your own interface design created with the Vision Tools Pro-e editor into the list of Designs in the Transfer application. iRidium Transfer operates with GUIs in *.vtz format, you need to compile project files in *.vtp format before adding them to the Transfer application.
Compiling is made in the Vision Tools Pro-e editor. To start the compiling select the “Compile Project” function in the File menu of the editor or press the F12 button.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
5
The acquired compiled GUI file in *.vtz format can be uploaded in iRidium Transfer. Addition of a new design can be done by clicking on the “Add Design” button or by the Drag&Drop method, i.e. by dragging a design into the Transfer application window.
During this process a new window will be opened, allowing to setup basic settings such as:
name of the design necessity of enabling/disabling sounds for button push activation of the full screen mode on iOS devices (if it is required the status bar can be displayed on the iOS device) activation of the full screen mode on Windows devices displaying of the cursor on Windows devices (It should be deactivated in projects made for operation on sensor panels)
For iOS devices, turning off Full Screen mode means that together with the iRidium interface you will see standard status bar of the iOS device. Appearance of the status bar can be selected from the suggested list. During creation of a new project, if you are planning to include the status bar, make sure to account for width of the status bar:
20 pixels for iPod , iPhone 3, iPad 1, 2 40 pixels for iPod Touch 4 / iPhone 4.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
6
After pressing the “OK” button, the graphic interface will be converted and added to the list of designs in the iRidium Transfer application (The Device Configure and Passwords tabs are not activated right after the conversion. You will be able to edit them when opening the project again).
Now in order to upload a design to the control device based on Apple iOS operation system, it is necessary to establish connection between the iRidium Transfer application installed on your personal computer, and the “iRidiumHD” Client application installed on the iOS device.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
7
Addition of iOS Devices to the Transfer Panel List In order to establish the connection between Transfer and iRidiumHD, it is needed to add the control device with the installed iRidiumHD Client into the list of Panels in Transfer. Addition of the iOS based device into the list of Panels in Transfer is available through the Device Search option. For a successful Search, please make sure that your PC and iOS device are connected to the same Wi-Fi network and there is communication between them (it can be checked with ping request). Discovery of the device cannot be done over USB connection.
To start discovery of the devices, press the “Search” button in the Panels tab of the Transfer application, and open the iRidiumHD Client application on your iOS device. Please make sure you are opening the application, and not restoring it from the minimized state which is possible on the devices with multitasking support. Before starting the discovery, delete the iRidiumHD Client from the list of the launched applications. If Wi-Fi is active and the search port for panels in the Transfer application (10000) is not blocked or busy by another application, your iOS device will appear in the list of panels in Transfer:
Here you can see two fields highlighted red. The first field is for selection of the graphic interface that will be uploaded on the selected panel. It is possible to select a required design from the dropdown list containing all added designs in the Transfer application.
The second field is for the attaching the license file that will enable the graphic interface to connect to the controlled equipment. In case if a license file is absent, there will be no connection between iRidiumHD and equipment, you will not be able to either send control commands or receive the feedback. At this stage, you can generate your project for Windows but it won’t have connection to the equipment without the license. www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
8
Description of the Licensing Procedure for the Control Device In order to receive a license file, you are required to purchase iRidium Activation Key and go through the licensing process. The licensing process includes activation of the purchased key, and after it you will receive the license file for an iOS device that needs to be added into the Transfer application or the license file for a Windows device that needs to be added to the folder with the ready project. iRidium keys differ both by operation systems of the control devices they are bound to and by their type. There are two types of licenses: Base licenses enable the connection of the control device (iPad/iPhone/iPod Touch, Windows panels) to the controlled equipment. The Base license is bound to the particular panel (iOS or Windows). Ultimate licenses contain information on the licensed controller. The Ultimate license type is bound to the particular controller identified by ID. It enables the connection of any number of devices with control iRidium GUIs to the controller. Receipt of UDID for Activation of the iRidium Base License for an iOS Device For receiving UDID of the iOS panel from the list of Panels in Transfer, copy it from the Panels tab in the device parameter line:
Besides, UDID of the iOS device can be copied from the iTunes application. It can be helpful when a device is added manually or when you work via Internet:
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
9
Receipt of Serial Number of the Crestron controller for Activation of the iRidium Ultimate License To receive the identifier (serial number) of the Crestron controller which is required for activation of the iRidium Ultimate license on an iOS or Windows device, you can use the iRidium Util application which is a part of a standard iRidium installation package. You can download iRidium Util from our web site. Start iRidium Util under Administrator rights (through the right-click menu: “Run as Administrator”) 1. Go to the «Serials» tab to receive the serial number of the controller 2. Select the Crestron controller from the dropdown list 3. Indicate the properties of connection to the controller (the IP-address of the controller, connection port and Password if it is a secure connection) 4. Press the «Request» button and copy the appeared serial number from the «Serial» string:
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
10
Licensing Procedure of an iOS Device (for any License Type) Licensing procedure of an iOS device begins with purchasing iRidium Activation Key (Base or Ultimate) which will be necessary for generation of the license file. iRidium Activation Key can be purchased in two ways:
1. You can register at our web site, wait till your registration is approved and purchase Activation Key directly from the web site, in section BUY: http://iridiummobile.net/buy2
2. You can contact the official iRidium distributor in your country. A list of distributors is located in the Partners section at our web site: http://iridiummobile.net/partners
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
11
If you are an independent installer for automation systems, you can also receive demo activation keys for free, after filling in a separate registration form at our web site: http://iridiummobile.net/registration
After the purchase is made, you will receive an e-mail with Activation Key that will be used to activate the iRidium license, i.e. to generate a license file for a selected device:
Activation of your key is made at the following web site:
http://iridium.license-maker.com/ You will receive the login information to access the activation web site in the e-mail. Here you can also recov-
er your license file in case it was lost:
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
12
Activation of the iRidium Base License Key In order to activate a Base license you will be required to enter the following information in corresponding fields: your e-mail address where the license file will be sent to, Activation Key that you received in e-mail, and identification of the specific device (Device UDID) for which the license is generated:
After completing all required fields in the Activation window, you will be asked to fill out a user form. This short form needs to be filled out only once and will be used in the future for activation of new licenses from the same e-mail address:
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
13
The next step will be receiving of your License File. You can directly download it from the web site, right after activation:
or it can be saved from the e-mail that will be automatically sent to the specified e-mail address.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
14
Activation of the iRidium Ultimate License Key In order to activate the Ultimate license you will be required to enter the following information in corresponding fields: your e-mail address where the license file will be sent to, Activation Key that you received in e-mail, and identification of the Crestron controller (serial number) for which the license is generated:
After completing all required fields in the Activation window, you will be asked to fill out a user form. This short form needs to be filled out only once and will be used in the future for activation of new licenses from the same e-mail address. The next step will be receiving of your License File. The iRidium license is the file with the extension .irl which can be directly downloaded from the web site, right after activation or it can be saved from the e-mail that will be automatically sent to the specified e-mail address.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
15
Uploading of the License File to iRidium Transfer The iRidium license is the file with the extension .irl received after the key activation. After the license file has been downloaded it is necessary to add it into the list of licenses in the Transfer application (Do not forget that licenses for iOS devices are added in Transfer only. Licenses for Windows devices are stored separately). Addition of the license file is done by the “Add License” button or by dragging and dropping it into the Transfer application window:
After the file has been added to it can be attached to the iOS device in the Panels tab. Do not forget that in the Licenses tab you can add licenses for iOS devices only. Only the license file which was activated for a particular panel can be bound to the device in the Panels tab:
When the design and license are ready it is possible to move on to setting up the connection of control device to the Crestron controller and uploading a design from Transfer.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
16
Setting of Connection to Crestron Controller
!
Connection settings of iRidium Base and Ultimate license to Crestron are different. You have to consider the license type when setting connection to the controller. See the further instruction.
Setting of Connection to the controller for BASE license You can indicate settings of connection to the Crestron controller in Transfer, in the Device configure menu: Properties > Device Configure. For the design which uses Base license and is intended to be launched on Windows or iOS device it is necessary to set such connection properties as an IP-address of the controller, a connection port and the panel identifier. The properties of connection to the Crestron controller are the following:
IP-address of the Сrestron controller; Port (41794 by default); Panel identifier (Cresnet ID);
Setting of Connection to the controller for ULTIMATE license For the design which uses Ultimate license it is necessary to set an IP-address and a connection port, the panel identifier, a controller port for requesting the serial number of the controller (to check the license authenticity). Set properties of connection to the Crestron controller in the Device configure menu:
IP-address of the Сrestron controller; Port (41794 by default); Panel identifier (Cresnet ID); connection port to the controller for checking the license authenticity (separated by comma). If the secure connection is used, the password should be indicated in this filed (also separated by comma).
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
17
Setting of Connection to the Crestron Controller for iRidiumHD iOS Client Indication of parameters of the connection to the controller and updating of the design is done in the Settings window of the iRidiumHD Client application which can be accessed from the general Settings window of your iOS device:
In the iRidiumHD iOS Client settings it is required to indicate:
Type of connection to the Crestron controller – either through the local network or through the internet. Make one of the choices active (One of the switches should be active. Usually local network connection is used - Internal). Setting of the rest properties of the iRidiumHD Client is not necessary as they will be transferred to the iOS device along with the project (settings of connection to the controller are indicated after converting the project in Transfer, in the Device Configure menu: Properties > Device Configure).
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
18
Further the Update options on an iOS device are set: Turn on ability to process the Update and indicate the IP address of the computer where the Transfer application is running.
You can find the local IP address of the computer in the right lower corner of Transfer:
*GUI Update can be done either over local network or via Internet. When all the settings are completed – all that is required is to restart iRidiumHD Client on your iOS device in order to start Update. Please note that for devices that support multitasking, you need to fully close the software, as minimizing – maximizing of the software will not work. In order to do a full close of iRidiumHD Client, you need to fully delete it from the list of running applications, as it is shown in our instruction at Wiki
Opening of the configured application will start the update process from Transfer. After it’s completed your design should be fully functional and you can disable GUI update ability in Settings. www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
19
Creation of iRidium Windows-Client for Crestron Now let’s take a look at the process of creating a iRidium Windows based Client – an application file for launching under Windows XP/7. Here you need to use a particular algorithm for operation with the Crestron Windows based projects. For the design added into the Transfer application, and intended to be launched under Windows and for the design uploaded on the iOS device, the setting of the connection properties is not necessary as they are transferred along with the *.vtz project. If it is required you can customize the connection settings in the Device Configure menu:
In the device settings you need to indicate:
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
IP address of the Crestron controller, Port (by default - 41794) Panel identification (Cresnet ID)
v.1.1 (revision: 14.09.11)
20
Further you need to select the design prepared this way in the list of Designs in Transfer and click the Generate for Windows button in the Design tab:
You will receive a file folder with a Windows Client application and additional files:
Now in order to make the Client application to be fully functional it is necessary to add a license file for Windows into the same folder. Receiving of a license file is done exactly in the same way as for iOS devices described above, except for the process of receiving the unique identification for the panel.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
21
Receipt of HWID for iRidium Windows-Client Licensing For Windows devices a unique identifier which is required for license file receipt is HWID. It’s attached to the computer’s hard disk drive. You can find HWID of your computer where the Transfer application is installed through the “About ” menu:
Or if you open any iRidium demo project on the control device without a license you will be able to receive HWID of your device from a warning popup window:
After the license file has been received and added into the generated project folder the Client application can be launched. If you don’t have any warnings when you are launching the Windows based Client, it means your license was accepted and your project will run in a fully functional mode.
Additional information about operation with the iRidium software package can be found at our Wiki.: http://iridiummobile.net/wiki/
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
Review of iRidium Software Package for Crestron The iRidium Software Package for Crestron includes components for installation on your PC under Windows XP/7 and components for installation on iOS devices. The part of the package which is installed on your PC and necessary for operation with the Crestron equipment is the iRidium Transfer application which is meant for converting
and uploading GUIs on the Apple iOS or Windows control panels. The part of the software package for installation on iOS devices is iRidiumHD Client application which is in charge of launching and running GUIs on target a device. In order to enable the connection of iRidiumHD iOS Client to the Crestron controller (iRidiumHD Client is connected to the controller as an original Crestron panel) it is required to purchase a demo iRidium license. Licenses for iOS are stored in the Transfer application and are transferred to target iOS devices along with GUIs. Licenses for Windows are stored in the project folder. iRidium supports operation with the following devices:
Apple iOS devices (iPad, iPhone, iPod Touch) Windows XP & Windows 7 based devices
Recommendations and Requirements for Operation with the iRidium Software Package for Crestron
PC under Microsoft Windows XP / 7
iRidiumHD application installed on your iOS device from the Apple App Store Wi-Fi network for uploading and updating GUIs and also for Crestron connection Internet connection for acquiring and activation of iRidium license keys iRidium license file for enabling the connection to the Crestron controller
2
Contents Review of iRidium Software Package for Crestron
1
Recommendations and Requirements for Operation with the iRidium Software Package for Crestron
1
Installation of the iRidium Software Package Components
3
Description of the iRidium Transfer Interface and Design Adding
4
Addition of iOS Devices to the Transfer Panel List
7
Description of the Licensing Procedure for the Control Device
8
Receipt of UDID for Activation of the iRidium Base License for an iOS Device
8
Receipt of Serial Number of the Crestron controller for Activation of the iRidium Ultimate License
9
Licensing Procedure of an iOS Device (for any License Type)
10
Activation of the iRidium Base License Key
12
Activation of the iRidium Ultimate License Key
14
Uploading of the License File to iRidium Transfer
15
Setting of Connection to Crestron Controller
16
Setting of Connection to the controller for BASE license
16
Setting of Connection to the controller for ULTIMATE license
16
Setting of Connection to the Crestron Controller for iRidiumHD iOS Client
17
Creation of iRidium Windows-Client for
19
Receipt of HWID for iRidium Windows-Client Licensing
21
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
3
Installation of the iRidium Software Package Components In order to start your work, it is necessary to install two parts of the iRidium software package. The first part, an installation package for your personal computer under Windows XP / 7, can be downloaded from the iRidium web-site, in the Download section: http://iridiummobile.net/download
The iRidium software package for personal computer consists of several components, but you will only need iRidium Transfer to work with Crestron projects (*.vtz). It is software for converting and downloading designs to the control devices. The second part of the iRidium software package is the Client application for installation on the devices based on the Apple iOS operation system. The application is called iRidiumHD and can be downloaded from the official AppStore. (iTunes: http://itunes.apple.com/us/app/iridiumhd/id369102319?mt=8)
The iRidiumHD Client application is a software component of iRidium that is in charge of launching and using a graphic interface, forming and sending commands to the controlled equipment.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
4
Description of the iRidium Transfer Interface and Design Adding After the iRidium package for your personal computer and the iRidiumHD Client are installed, you can start work with the Crestron project. Start the iRidium Transfer application. On the main screen you can see several tabs: Panels, Designs and Licences. All these tabs are related to each other and correspond to different aspects of forming and uploading iRidium on the control device.
Let’s start work with the Transfer application by adding your own interface design created with the Vision Tools Pro-e editor into the list of Designs in the Transfer application. iRidium Transfer operates with GUIs in *.vtz format, you need to compile project files in *.vtp format before adding them to the Transfer application.
Compiling is made in the Vision Tools Pro-e editor. To start the compiling select the “Compile Project” function in the File menu of the editor or press the F12 button.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
5
The acquired compiled GUI file in *.vtz format can be uploaded in iRidium Transfer. Addition of a new design can be done by clicking on the “Add Design” button or by the Drag&Drop method, i.e. by dragging a design into the Transfer application window.
During this process a new window will be opened, allowing to setup basic settings such as:
name of the design necessity of enabling/disabling sounds for button push activation of the full screen mode on iOS devices (if it is required the status bar can be displayed on the iOS device) activation of the full screen mode on Windows devices displaying of the cursor on Windows devices (It should be deactivated in projects made for operation on sensor panels)
For iOS devices, turning off Full Screen mode means that together with the iRidium interface you will see standard status bar of the iOS device. Appearance of the status bar can be selected from the suggested list. During creation of a new project, if you are planning to include the status bar, make sure to account for width of the status bar:
20 pixels for iPod , iPhone 3, iPad 1, 2 40 pixels for iPod Touch 4 / iPhone 4.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
6
After pressing the “OK” button, the graphic interface will be converted and added to the list of designs in the iRidium Transfer application (The Device Configure and Passwords tabs are not activated right after the conversion. You will be able to edit them when opening the project again).
Now in order to upload a design to the control device based on Apple iOS operation system, it is necessary to establish connection between the iRidium Transfer application installed on your personal computer, and the “iRidiumHD” Client application installed on the iOS device.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
7
Addition of iOS Devices to the Transfer Panel List In order to establish the connection between Transfer and iRidiumHD, it is needed to add the control device with the installed iRidiumHD Client into the list of Panels in Transfer. Addition of the iOS based device into the list of Panels in Transfer is available through the Device Search option. For a successful Search, please make sure that your PC and iOS device are connected to the same Wi-Fi network and there is communication between them (it can be checked with ping request). Discovery of the device cannot be done over USB connection.
To start discovery of the devices, press the “Search” button in the Panels tab of the Transfer application, and open the iRidiumHD Client application on your iOS device. Please make sure you are opening the application, and not restoring it from the minimized state which is possible on the devices with multitasking support. Before starting the discovery, delete the iRidiumHD Client from the list of the launched applications. If Wi-Fi is active and the search port for panels in the Transfer application (10000) is not blocked or busy by another application, your iOS device will appear in the list of panels in Transfer:
Here you can see two fields highlighted red. The first field is for selection of the graphic interface that will be uploaded on the selected panel. It is possible to select a required design from the dropdown list containing all added designs in the Transfer application.
The second field is for the attaching the license file that will enable the graphic interface to connect to the controlled equipment. In case if a license file is absent, there will be no connection between iRidiumHD and equipment, you will not be able to either send control commands or receive the feedback. At this stage, you can generate your project for Windows but it won’t have connection to the equipment without the license. www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
8
Description of the Licensing Procedure for the Control Device In order to receive a license file, you are required to purchase iRidium Activation Key and go through the licensing process. The licensing process includes activation of the purchased key, and after it you will receive the license file for an iOS device that needs to be added into the Transfer application or the license file for a Windows device that needs to be added to the folder with the ready project. iRidium keys differ both by operation systems of the control devices they are bound to and by their type. There are two types of licenses: Base licenses enable the connection of the control device (iPad/iPhone/iPod Touch, Windows panels) to the controlled equipment. The Base license is bound to the particular panel (iOS or Windows). Ultimate licenses contain information on the licensed controller. The Ultimate license type is bound to the particular controller identified by ID. It enables the connection of any number of devices with control iRidium GUIs to the controller. Receipt of UDID for Activation of the iRidium Base License for an iOS Device For receiving UDID of the iOS panel from the list of Panels in Transfer, copy it from the Panels tab in the device parameter line:
Besides, UDID of the iOS device can be copied from the iTunes application. It can be helpful when a device is added manually or when you work via Internet:
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
9
Receipt of Serial Number of the Crestron controller for Activation of the iRidium Ultimate License To receive the identifier (serial number) of the Crestron controller which is required for activation of the iRidium Ultimate license on an iOS or Windows device, you can use the iRidium Util application which is a part of a standard iRidium installation package. You can download iRidium Util from our web site. Start iRidium Util under Administrator rights (through the right-click menu: “Run as Administrator”) 1. Go to the «Serials» tab to receive the serial number of the controller 2. Select the Crestron controller from the dropdown list 3. Indicate the properties of connection to the controller (the IP-address of the controller, connection port and Password if it is a secure connection) 4. Press the «Request» button and copy the appeared serial number from the «Serial» string:
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
10
Licensing Procedure of an iOS Device (for any License Type) Licensing procedure of an iOS device begins with purchasing iRidium Activation Key (Base or Ultimate) which will be necessary for generation of the license file. iRidium Activation Key can be purchased in two ways:
1. You can register at our web site, wait till your registration is approved and purchase Activation Key directly from the web site, in section BUY: http://iridiummobile.net/buy2
2. You can contact the official iRidium distributor in your country. A list of distributors is located in the Partners section at our web site: http://iridiummobile.net/partners
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
11
If you are an independent installer for automation systems, you can also receive demo activation keys for free, after filling in a separate registration form at our web site: http://iridiummobile.net/registration
After the purchase is made, you will receive an e-mail with Activation Key that will be used to activate the iRidium license, i.e. to generate a license file for a selected device:
Activation of your key is made at the following web site:
http://iridium.license-maker.com/ You will receive the login information to access the activation web site in the e-mail. Here you can also recov-
er your license file in case it was lost:
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
12
Activation of the iRidium Base License Key In order to activate a Base license you will be required to enter the following information in corresponding fields: your e-mail address where the license file will be sent to, Activation Key that you received in e-mail, and identification of the specific device (Device UDID) for which the license is generated:
After completing all required fields in the Activation window, you will be asked to fill out a user form. This short form needs to be filled out only once and will be used in the future for activation of new licenses from the same e-mail address:
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
13
The next step will be receiving of your License File. You can directly download it from the web site, right after activation:
or it can be saved from the e-mail that will be automatically sent to the specified e-mail address.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
14
Activation of the iRidium Ultimate License Key In order to activate the Ultimate license you will be required to enter the following information in corresponding fields: your e-mail address where the license file will be sent to, Activation Key that you received in e-mail, and identification of the Crestron controller (serial number) for which the license is generated:
After completing all required fields in the Activation window, you will be asked to fill out a user form. This short form needs to be filled out only once and will be used in the future for activation of new licenses from the same e-mail address. The next step will be receiving of your License File. The iRidium license is the file with the extension .irl which can be directly downloaded from the web site, right after activation or it can be saved from the e-mail that will be automatically sent to the specified e-mail address.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
15
Uploading of the License File to iRidium Transfer The iRidium license is the file with the extension .irl received after the key activation. After the license file has been downloaded it is necessary to add it into the list of licenses in the Transfer application (Do not forget that licenses for iOS devices are added in Transfer only. Licenses for Windows devices are stored separately). Addition of the license file is done by the “Add License” button or by dragging and dropping it into the Transfer application window:
After the file has been added to it can be attached to the iOS device in the Panels tab. Do not forget that in the Licenses tab you can add licenses for iOS devices only. Only the license file which was activated for a particular panel can be bound to the device in the Panels tab:
When the design and license are ready it is possible to move on to setting up the connection of control device to the Crestron controller and uploading a design from Transfer.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
16
Setting of Connection to Crestron Controller
!
Connection settings of iRidium Base and Ultimate license to Crestron are different. You have to consider the license type when setting connection to the controller. See the further instruction.
Setting of Connection to the controller for BASE license You can indicate settings of connection to the Crestron controller in Transfer, in the Device configure menu: Properties > Device Configure. For the design which uses Base license and is intended to be launched on Windows or iOS device it is necessary to set such connection properties as an IP-address of the controller, a connection port and the panel identifier. The properties of connection to the Crestron controller are the following:
IP-address of the Сrestron controller; Port (41794 by default); Panel identifier (Cresnet ID);
Setting of Connection to the controller for ULTIMATE license For the design which uses Ultimate license it is necessary to set an IP-address and a connection port, the panel identifier, a controller port for requesting the serial number of the controller (to check the license authenticity). Set properties of connection to the Crestron controller in the Device configure menu:
IP-address of the Сrestron controller; Port (41794 by default); Panel identifier (Cresnet ID); connection port to the controller for checking the license authenticity (separated by comma). If the secure connection is used, the password should be indicated in this filed (also separated by comma).
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
17
Setting of Connection to the Crestron Controller for iRidiumHD iOS Client Indication of parameters of the connection to the controller and updating of the design is done in the Settings window of the iRidiumHD Client application which can be accessed from the general Settings window of your iOS device:
In the iRidiumHD iOS Client settings it is required to indicate:
Type of connection to the Crestron controller – either through the local network or through the internet. Make one of the choices active (One of the switches should be active. Usually local network connection is used - Internal). Setting of the rest properties of the iRidiumHD Client is not necessary as they will be transferred to the iOS device along with the project (settings of connection to the controller are indicated after converting the project in Transfer, in the Device Configure menu: Properties > Device Configure).
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
18
Further the Update options on an iOS device are set: Turn on ability to process the Update and indicate the IP address of the computer where the Transfer application is running.
You can find the local IP address of the computer in the right lower corner of Transfer:
*GUI Update can be done either over local network or via Internet. When all the settings are completed – all that is required is to restart iRidiumHD Client on your iOS device in order to start Update. Please note that for devices that support multitasking, you need to fully close the software, as minimizing – maximizing of the software will not work. In order to do a full close of iRidiumHD Client, you need to fully delete it from the list of running applications, as it is shown in our instruction at Wiki
Opening of the configured application will start the update process from Transfer. After it’s completed your design should be fully functional and you can disable GUI update ability in Settings. www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
19
Creation of iRidium Windows-Client for Crestron Now let’s take a look at the process of creating a iRidium Windows based Client – an application file for launching under Windows XP/7. Here you need to use a particular algorithm for operation with the Crestron Windows based projects. For the design added into the Transfer application, and intended to be launched under Windows and for the design uploaded on the iOS device, the setting of the connection properties is not necessary as they are transferred along with the *.vtz project. If it is required you can customize the connection settings in the Device Configure menu:
In the device settings you need to indicate:
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
IP address of the Crestron controller, Port (by default - 41794) Panel identification (Cresnet ID)
v.1.1 (revision: 14.09.11)
20
Further you need to select the design prepared this way in the list of Designs in Transfer and click the Generate for Windows button in the Design tab:
You will receive a file folder with a Windows Client application and additional files:
Now in order to make the Client application to be fully functional it is necessary to add a license file for Windows into the same folder. Receiving of a license file is done exactly in the same way as for iOS devices described above, except for the process of receiving the unique identification for the panel.
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
21
Receipt of HWID for iRidium Windows-Client Licensing For Windows devices a unique identifier which is required for license file receipt is HWID. It’s attached to the computer’s hard disk drive. You can find HWID of your computer where the Transfer application is installed through the “About ” menu:
Or if you open any iRidium demo project on the control device without a license you will be able to receive HWID of your device from a warning popup window:
After the license file has been received and added into the generated project folder the Client application can be launched. If you don’t have any warnings when you are launching the Windows based Client, it means your license was accepted and your project will run in a fully functional mode.
Additional information about operation with the iRidium software package can be found at our Wiki.: http://iridiummobile.net/wiki/
www.iridiummobile.net
© iRidium Mobile Ltd. 2011
v.1.1 (revision: 14.09.11)
