> For the complete documentation index, see [llms.txt](https://doc.sysdevmobile.com/kalipso/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.sysdevmobile.com/kalipso/6.0/documentation/environment/file/devices.md).

# 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.

<figure><img src="https://1102213384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6Wz3tBjSWbCweZ8NltT%2Fuploads%2FxSJFm9B5kenUwM5Vhwgt%2Fimage.png?alt=media&amp;token=d38de9eb-2b4f-4ae2-893c-51651a2dc133" alt=""><figcaption></figcaption></figure>

* **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 "Unitech", "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.

<figure><img src="https://1102213384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6Wz3tBjSWbCweZ8NltT%2Fuploads%2FlnqMDaw59LJ0LXoG1dWz%2Fimage.png?alt=media&amp;token=42c3be4c-5965-4638-acab-0086cb6338ef" alt=""><figcaption></figcaption></figure>

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:

<figure><img src="https://1102213384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6Wz3tBjSWbCweZ8NltT%2Fuploads%2Fm2iDuAa8POnsbRgHsGak%2Fimage.png?alt=media&amp;token=f61db9fa-2b42-4aa4-9e9e-307fc858f341" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1102213384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6Wz3tBjSWbCweZ8NltT%2Fuploads%2FHeTkAbjskXeOJPWhgDPe%2Fimage.png?alt=media&amp;token=9fe43dcf-9b40-400a-885d-19f0cce02dc1" alt=""><figcaption></figcaption></figure>

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*

* **Category** - Other, Smartphone, Tablet, PC
* **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](/kalipso/6.0/documentation/actions/group-others/get-screen-dimensions.md)” Action to know this value.

#### Tab - Keys

Each Terminal has a different set of Keys. These Keys can be used as [Events](/kalipso/6.0/documentation/controls/events.md). This way, you can define a Key to trigger [Actions](/kalipso/6.0/documentation/form/actions.md). 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.

<figure><img src="https://1102213384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6Wz3tBjSWbCweZ8NltT%2Fuploads%2Ftwlwmahd5F1qWjTqVtcR%2Fimage.png?alt=media&amp;token=6dc7d3a8-46f7-4a43-aaf0-23b3d4131915" alt=""><figcaption></figcaption></figure>

#### Tab - Image

<figure><img src="https://1102213384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM6Wz3tBjSWbCweZ8NltT%2Fuploads%2FylbBcQRukOhd0siszp28%2Fimage.png?alt=media&amp;token=61940b4e-b5da-45e6-9cd6-851073aad9e1" alt=""><figcaption></figcaption></figure>

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