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:

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:

Your Action is now created.

To configure the Component to execute the Action on the click or double-click Trigger:

This Layout needs to be exported to the Kaleido-K2 where it will be executed. To do so:

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:

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:

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:

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.

A second dialog, "Connect To", will appear. In the "Connect using" dropdown field choose "TCP/IP (Winsock)". Two new fields will appear; in the "Host address" field enter the IP address of your Kaleido-K2 and in the "Port number" field enter "13000". This indicates that you want to connect to your Kaleido-K2 via the port 13000. Click on the "OK" button.

To be able to see the typed characters:

    • Select "Properties" from the "File" menu, the "Properties" dialog box appears.
    • Go to the "Settings" tab, click on the "ASCII Setup..." button located at the bottom of the dialog
    • Select "Echo typed characters locally".

Click on the "OK" button and click again on the "OK" button from the "Properties" dialog.

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 command

Close 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
techsupp@miranda.com
Asia

Technical Support
Telephone (9:00-17:00 JST)

+81-3-5730-2987
Fax: +81-3-5730-2973
asiatech@miranda.com
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
eurotech@miranda.com
France


Technical Support

+33 1 55 86 87 88
Fax: +33 1 55 86 00 29
eurotech@miranda.com