# Devices

In Kalipso, each Project has to be associated with a Terminal. Kalipso already has a list of predefined Terminals that can be used on your Projects. It’s possible that you may have to add a Terminal of your own.

![](https://3821468174-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTlA1suFa5N48x_83N%2F-MBJ1M8bGWLHV0SIB9rd%2F-MBJ23HT3y-09iIVIhqE%2FDevices.PNG?alt=media\&token=d134b000-e0af-46ad-9e57-dcfe1ac0fb1c)

* **Group** - A Terminal can be associated with a customized group. For instance, you can define manufactures as groups. Kalipso offers a set of start terminals, such as "Casio", "Honeywell", among other recognized brands. These are system groups. Choosing a specific group the information in the table below in the window changes showing the specific data for that group.

A Group can be used to organize Terminals. A Group is an abstract identity. You can use it to group Terminals by manufacturer or anything else.

{% hint style="info" %}
System groups are non-editable .
{% endhint %}

In addition to the suggested groups, it is possible to create a new group. For this purpose, a new group can be added by clicking on the icon on the right.

In the same window you can find four buttons: add, edit, duplicate and delete. These buttons allow the management of the terminals in the logic of the objective of each button.

Only after creating a new group is it possible to edit or delete it.

### New group

When you click to add or edit a group, the following window appears.

![](https://3821468174-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTlA1suFa5N48x_83N%2F-MBK6e2WZvaUo3guVUXk%2F-MBKFFS2c2pWFIVUpW2K%2FDevices_Groups.PNG?alt=media\&token=4565d5d1-741a-4b02-9adb-d197315062b1)

On the right side are three buttons that allow you to edit an existing group, add a new group or delete a group (except if the group is one of the pre-installed ones available in Kalipso).

In the same window is a table with the following basic data:

* **Name** - Name of the group.
* **Type** - It is usually just terminals.
* **Description** - Brief description of the terminal group.

To add or edit a group a new window appears:

![](https://3821468174-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTlA1suFa5N48x_83N%2F-MBKFlHiVYnhiWDWwbLk%2F-MBKFwJ0Hz1t_LsB8MQn%2FDevices_Groups_New.PNG?alt=media\&token=505f69ae-13e5-43db-8451-1ab5087d920e)

The options are:

* **Name** - Name of the group. The group name cannot contain spaces.
* **Description** - Brief description of the terminal group.
* **Image** - If you want, you can add an Image to your group, to better identify it.

### Add or Edit a device

![](https://3821468174-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTlA1suFa5N48x_83N%2F-MBKJluGEprShojmarkm%2F-MBKK4yD83pq7NgWh3zN%2FDevices_New.PNG?alt=media\&token=8dbc2aaf-25b0-4798-b26d-d3047df56250)

#### Tab - General

*Identification*

* **Name** - Name of the device.
* **Group** - Area where you can associate with a pre-existing group or create a new one.
* **Description** - Terminal description.

*Details*

* **Ratio** - You can define the ratio in pixels or auto
* **Operating System** - Write the Terminal’s Operating System. It’s informative, no interference with your Project.

*Screen*

* **Width** - Width of the screen (to check Terminal definitions or use “Get Screen Dimensions” Action).
* **Height** - Total height of the screen (to check Terminal definitions or use “Get Screen Dimensions” Action).

*Bar's Height*

* **Title Bar** - Windows title bar height
* **System Bar** - System bar height

*Scroll Bar*

* **Thickness** - Although this value is filled by default, you can use “[Get Screen Dimensions](https://doc.sysdevmobile.com/kalipso5/developing/form/actions/actions-description/group-others/get-screen-dimensions)” Action to know this value.

#### Tab - Keys

Each Terminal has a different set of Keys. These Keys can be used as [Events](https://doc.sysdevmobile.com/kalipso5/developing/form/controls/events). This way, you can define a Key to trigger [Actions](https://doc.sysdevmobile.com/kalipso5/developing/form/option-window/actions). Using the “Keys.exe” application on your PDA, you can know what code is associated with each Key. To define a Key, insert its Name and Code. Also, you can load the Operative System’s default Keys.

![](https://3821468174-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTlA1suFa5N48x_83N%2F-MBK_yHDJbpZGQAGUISS%2F-MBKaCdxb-W8J7w1h4d4%2FDevices_New_Keys.PNG?alt=media\&token=4244a77d-6c50-4128-852b-e484d3f71059)

#### Tab - Image

If you want, you can add an Image to your Terminal, to better identify it.

![](https://3821468174-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTlA1suFa5N48x_83N%2F-MBKaevhj288oT5uhKm7%2F-MBKauSmhPgv97wmYK0C%2FDevices_New_Image.PNG?alt=media\&token=3fa6281a-46ba-49ff-94d5-db6f4f6663ae)