---
title: "Devices"
canonical: "https://docs.cuesystem.com/space/SSG/292192551/Devices"
format: markdown
---
## Overview
The section on devices (drivers) explains how to control connected devices. Every device is described in the General section and contains commands.
The Simple Setup uses two types of devices:
- User-devices defined by the user. These devices can be created using Simple Setup and exported to the file, imported from files or the CUE cloud library, and then modified or used directly.
- Embedded - devices embedded in Simple Setup application environment. These devices can not be modified by the user.
The basic view of the device section looks as follows.
## New / Edit user device
To create a new user device press the button. The following pop-up window is displayed.
### General section
In the **General** section, you can fill/select
- Connection - this means the type of control port used for device control. It can be IP, Serial (RS232 or RS485), or IR (infrared).
- Version - this indicates the device driver version. Version 1.00 is used as the default for new devices.
### Device section
In the **Device** section, you can fill device identification parts
- Manufacturer - the name of the device manufacturer. It is mandatory.
- Model - the name of the model which can be controlled by the given driver. It is mandatory. In case the driver can control more models, fill all models in the “Compatible models” text box.
- Type - the controlled device type, e.g. Video conference, Display, Player, Light, Air condition, etc. It is mandatory.
- Firmware version - the controlled device firmware version for which the driver was created.
- Compatible models - a list of devices compatible with a given driver.
- Tested with - specification of the device with which the driver was tested.
- Comment - any comment can be added here, for example, cable description, some warning, driver limitations, etc.
The next section changes according to the chosen Connection. All information requested here is typically described in the controlled device manual.
For **IP** you can fill/select
- IP protocol - a type of IP communication. It can be a TCP client or a UDP client.
- Default IP port - defines the IP port used for communication between the controller and the controlled device.
- IP connection mode - it can be
- Keep connected - if no IP connection to the controlled device is established, the IP connection is established now, the controller sends a command, and stays connected to the controlled device.
- Disconnect after command - the controller establishes an IP connection to the controlled device, sends a command, and then cancels the connection.
For **Serial** you can fill
- Mode - it depends on the controlled device port type, selection is RS232 or RS485. The RS232 mode can be used on the SERIAL port as well as on the UNIVERSAL port, the RS485 mode can be used on the SERIAL port only.
- Baud rate - the speed of data transfer in bits per second. The minimum baud rate is 1 200 bd, maximum is 115 200 bd.
- Parity - the type of parity. It can be None, Odd or Even.
- Data bits - the number of data bits. It can be 7 or 8.
- Stop bits - number of stop bits. It can be 1, 1.5, or 2.
- Flow control - can be None or Xon / Xoff.
For **IR** there are no other settings.
Click **Save** to store the changes.
### Command section
This section includes a list of commands.
Using the **New** button a new command is created. Every command can be edited using the **Edit** button, duplicated using the button, or deleted using the **Delete** button.
### Create new / Edit / Duplicate IP or serial command
For all these functions the same pop-up window is used.
**The name** indicates the mandatory command name. It must be unique within the device driver. If a command is duplicated, all command parameters are copied from the original command and the name is modified by adding a number to the end of the command name. If the name ends with a digit, the digit is modified to keep the command name unique.
**Command string** includes all characters to be sent within the command. Printable ASCII characters can be added directly, non-printable characters can be added using character \ and ASCII code (e.g. \01) or using the **Add special character** button. Buttons to add the most frequently used non-printable ASCII characters are available and they eliminate the necessity to find ASCII codes for non-printable characters.
Every command can be tested using the **Test** button. For serial commands, the channel to test can be Serial 1 or Universal 1 to 4. The rest of the window contains a command string format description.
### Infra-red commands
The controller is equipped with an IR capture sensor to capture IR codes. If you want to capture codes, see the picture and instructions in the “Edit command” pop-up window.
Steps to capture the IR code are as follows:
1. Fill in or edit the command name.
2. Set max. IR code length.
3. Prepare the IR remoter by following the instructions.
4. Press the **Capture** button.
5. Press the appropriate IR remoter button.
6. If the IR code is captured, the indicator goes from red to green color.
Steps for IR code testing are as follows:
1. Install the IR Adapter to the controlled device IR receiver.
2. Connect the IR adapter to one of the Universal ports.
3. Select the channel where the IR Adapter is connected (Universal 1 to 4).
4. Press the **Test** button to test the IR code.
If everything is ok, press **Save** to save changes.
## Import from file
To import a device press the **Import** button. You can import the device from the *.cssd file.
### Import from cloud library
CUE offers a device driver library available on the cloud.
> ℹ️ To use this function, the controller must be connected to the Internet.
Then you can use the **Import from cloud** button to open the driver list. This list is dynamically created and contains all devices stored in the library.
By pushing the column header, the list can be sorted by Connection, Manufacturer, Model, Type or Version of the device driver. Look for the devices that you need in the project, select the devices using the check box (multi-selection is allowed) and press Import. Importing state is indicated in the column State.
All selected devices will be imported to section user devices and can be used as any other device. In addition it is possible to modify imported driver commands, add new commands, delete commands, etc.
## Exporting a device
Use the **Download** button on the right to export a device from the controller and save it as ***.cssd** file. The file will be stored in your downloads folder. Device filename, e.g. **NEC_Monitor_Generic_serial_1_00.cssd** consists of
- Manufacturer
- Device type
- Model
- Connection type
- Extension cssd (Cue Simple Setup Device).
## Exporting selected devices
Select more devices and use the **Expor**t button to export all selected devices from the controller.
Devices will be saved as ***.zip** file in your downloads folder.
Device filename, e.g. **Devices-2019_07_12-11_58.zi**p consists of
- Devices
- Date and time of export.
## Deleting a device
Use the **Delete** button to delete one device. A device can not be deleted if it is connected to a channel. In this case the following warning is displayed.
It is necessary to disconnect the device from the channel, then device can be deleted.
## Deleting more devices at once
Select more devices and use the bottom **Delete **button to delete more devices from the controller.
Devices can not be deleted if they are connected to channels. In this case the following warning is displayed.
It is necessary to disconnect all the devices that you want to delete before devices can be deleted.
###