How to save and load more Layouts than the 10 available from the Kaleido-RCP?
Here are four different ways of using more than the ten Layouts accessible through the RCP:
Using KEdit
It is possible to load a Layout on your Kaleido-K2 from your KEdit by applying a Layout online from the KEdit:
- From the KEdit open the Layout you want to load onto the Kaleido-K2.
- From the "File" menu select the "Apply Layout Online" option or press "Alt-A". The "Apply Layout Online" dialog should appear.
- Select the Kaleido-K2 on which you want to load the Layout from the list of the available Kaleido-K2s.
- Select the data that needs to be exported to the Kaleido-K2 in order to be able to use the Layout.
- Select the "Load" button.
- The Layout should appear on the Kaleido-K2.
Using an Action attached to a Component
You can create an Action containing one Action Element that loads a Layout and then assign this Action to be executed when clicking or double clicking on a Component. Following are the steps to create the Action and assign it to a Component.
To create the Action:
- Select "Action Browser" from the "View" menu or press F9. The Action Browser should appear.
- In the Action Browser press on the "New" button located in the left corner of the dialog. The Action Configuration dialog should appear.
- Enter the name to assign to the Action in the text field.
- In the Action List section click in the "Type" column of the first row. A drop down will appear allowing you to choose the type of Action Element to create.
- Select "Load Layout", the "Load Layout Configuration" dialog should appear.
- Select the name of the Layout to load when the Action Element is executed. The drop-down contains the names of the Layouts saved in the "C:\iControl\Startup\KALEIDO LAYOUTS" folder.
- Click on the "OK" button of the "Load Layout Configuration" dialog.
- Click on the "Save" button of the "Action Configuration" dialog.
Your Action is now created.
To configure the Component to execute the Action on the click or double-click Trigger:
- Select the Component by clicking on it.
- Display the "Configuration Panel" by pressing F5 or by selecting "Configuration Panel" from the "View" menu.
- Select the "Action" tab
- Beside "Action on Single Click" or beside "Action on Double Click" select the name of the Action to execute (in this case, the name of the Action you just created).
- Click on the "Apply" button.
This Layout needs to be exported to the Kaleido-K2 where it will be executed. To do so:
- Select "Apply Layout Online" from the "File" menu or press Alt-A.
- Select the destination Kaleido-K2 from the list.
- Select the data that needs to be exported to the Kaleido-K2: you have to choose the "Actions" option in order to export the Action created and associated with the Component.
- Press the "Load" button.
Now the Layout containing the association is the current Layout on the specified Kaleido-K2. If you want to test the association you just made, assign the Layout to a preset key of the Kaleido RCP by pressing and holding for at least 6 seconds one of the 10 function keys located at the top of the Kaleido RCP device, then click or double-click on your configured Component on the Kaleido. The new Layout should be loaded.
Using a GPI Input
You can create an Action containing one Action Element that loads a Layout and then choose this Action to be executed when a GPI Input goes on or off. Following are the steps to create the Action and a GPI Input Assignment.
Since only Actions residing on the Kaleido-K2 where the GPI Input will be created can be used the following steps will create an Action directly on the Kaleido-K2. This means that you will not need to export the Action from the KEdit to the Kaleido-K2.
To create the Action on the Kaleido-K2:
- Open KEdit.
- Select "Online" from the "Open" item of the "File" menu.
- Select the Kaleido-K2 where you want to create the Action. The Layout displayed on the selected Kaleido-K2 must now appear in your KEdit.
- Select "Action Browser" from the "View" menu or press F9. The Action Browser should appear.
- In the Action Browser press on the "New" button located to the left corner of the dialog. The Action Configuration dialog should appear.
- Enter the name to assign to the Action in the text field.
- In the Action List section click in the "Type" column of the first row. A drop down will appear allowing you to choose the type of Action Element to create.
- Select "Load Layout", the "Load Layout Configuration" dialog should appear.
- Select the name of the Layout to load when the Action Element is executed. The drop-down contains the names of the Layouts saved in the "C:\iControl\Startup\KALEIDO LAYOUTS" folder.
- Click on the "OK" button of the "Load Layout Configuration" dialog.
- Click on the "Save" button of the "Action Configuration" dialog.
The Action is now created.
The next step is to assign this Action to a state (on or off) of a GPI Input. Take note that the creation of GPI Input assignment is only available when you are connected (or on-line) to a Kaleido-K2. To create a GPI Input assignment:
- Select "GPI Input Configuration" from the "View" menu or press F12.
- Press on the "New" button located at the bottom of the dialog. The GPI In On/Off state actions will appear.
- Enter the number of the GPI Input to which you want to attach the Action.
- Beside the state on which the Action must be executed select the name of the Action.
- Press on the "OK" button.
The assignment is now made and next time the GPI Input goes to the specified state the assigned Action will be executed.
Using the Gateway
It is possible to operate the Kaleido-K2 using its Internal Gateway. The Gateway is a very flexible and powerful tool that is usually used through a program but the Gateway can also be used via telnet. The following explanations will guide you through the use of the Gateway via the HyperTerminal software.
First you must verify if the Internal Gateway service is running on your Kaleido-K2.
The internal gateway is configured through the Kaleido Properties File, and is turned on or off by editing that file. Here is how to do it:
- From your Kaleido-K2's desktop, double click on the icon "My Computer".
- Navigate to "C:\iControl\Startup\" and open the file "Kaleido.properties" using the Notepad (right click on the "Kaleido.properties" file and select "Notepad" from the "Open With" menu).
- Search the file for either of the following lines:
activateInternalGateway=TRUEactivateInternalGateway=FALSE- If activateInternalGateway is TRUE, the internal gateway is ON by default at startup. Disable the internal gateway at startup by replacing TRUE with FALSE in this line.
- If activateInternalGateway is FALSE, the internal gateway is OFF by default at startup. Enable the internal gateway at startup by replacing FALSE with TRUE in this line.
- Save your changes using the Save item in the File menu.
- Close the Notepad editor.
- Restart the Kaleido.
The internal gateway supports all Kaleido/Gateway commands when connected via port 13000, and supports only the <listnodes\> command when connected via port 10001.
Your Gateway service is now up and running.
Open the HyperTerminal software on your computer, and from the "Program" menu choose "Accessories", "Communications" and "HyperTerminal". A dialog will appear, asking you to enter a name for the connection and to select an icon.
You can now see the typed characters appearing in the console.
Commands can be sent to the Gateway while a session is opened. There is no maximum number of commands that can be sent in a session. A session must be opened and closed using two specific commands. While sending a command the syntax must be exact. If you make a mistake in the syntax, the command will not be understood. Here is a simplified example of a session:
Open a session
send command
send command
...
send commandClose the session.
To open a session, enter the following command:
<openID>IP_ADDRESS_0_4_0_0</openID>
Where:
If the Gateway receives the command, recognizes it as a command that can be handled it will send you the following response:
<ack/>
If the command cannot be recognized the following message will appear:
<nack/>
If you received this message, please consult the Gateway documentation included on the Kaleido-K2 CD to troubleshoot the installation and communication.
You are now ready to send commands. There is a command to use to load a Layout. Here is the syntax of the command to send to load a Layout:
<setKCurrentLayout>set LayoutName.kg2</setKCurrentLayout>
Where:
If you received a <ack/> the specified Layout should now be the displayed Layout on your Kaleido-K2.
There is a command that can be used to get the list of available Layouts from the Kaleido-K2 system. Here is the syntax of the command:
<getKLayoutList/>
The answer to this command takes the form:
<kLayoutList>Layout1.kg2 Layout2.kg2 Layout3.kg2...</kLayoutList>
where the names of all available Layouts are listed one after the other.
You can execute as many commands as you want. When you want to stop sending commands you have to close the session. The following command is used to close a session:
<closeID>IP_ADDRESS_0_4_0_0</closeID>
Where:
Your session is now closed. Note that this command closes the current connection to the client via port 13000, so this connection must be re-established before another session can be opened. If you are using Hyperterminal, it will automatically re-establish the previous connection if you begin typing new commands, but other clients may require you to manually reconnect.
To end the communication, select the "Disconnect" icon from the toolbar.
Using the LOAD button on the RCP
Push the LOAD button to open a dialog listing layouts currently saved on the Kaleido [Note: This dialog lists the names of Layouts located in the "c:\iControl\Startup\KALEIDO_LAYOUTS" folder - layouts saved at other locations are not available through this dialog].
![]()
The top layout will be highlighted.
Americas
Technical Support
Telephone (9:00-17:00 EST)
+1-800-224-7882
Fax: +1-514-335-1614
|
Asia
Technical Support
Telephone (9:00-17:00 JST)
+81-3-5730-2987
Fax: +81-3-5730-2973
|
Europe,Middle East, Africa, UK
Technical Support
Telephone(9:00-18:00 GMT)
+44 (0) 1491 820222
24 Hour Reply +44 (0) 8700 660295 Fax: +44 (0) 1491 820002 |
France
Technical Support
+33 1 55 86 87 88
Fax: +33 1 55 86 00 29 |