# Serial Open

Opens a serial port.

Action available for the following operating systems:

![](/files/-MGNsZjeYMKt8-HvBB5n)

### Parameters

* **Serial Port** *\<unquoted string> -* The name of the port that user wants to open. Typically its a Com Port, and user could choose from pre-defined Com Ports from Com0 to Com13. It's also possible defined a port dynamically by choosing option *dynamic* for this parameter. In Win32 (Desktop/Mobile/CE) if this value is negative it will refer to a LPT port. In Android it **DeviceString** is not specified it will try to find a port on the system with a number matching this specified number, but in you should always use **DeviceString** parameter in Android.
* **Baud Rate** *\<numeric> -* The baud rate for the serial port that user wants to open. There are several pre-defined values for this parameter. For more information, see the notes.
* **Data Bits** *\<unquoted string> -* The number of data bits transmitted throw the serial port. The possible values for this parameter are: *7 bits*, *8 bits* or *dynamic*.
* **Stop Bits** *\<unquoted string> -* The number of stop bits in the serial port. The possible values for this parameter are: *1 bit*, *2 bits* or *dynamic*.
* **Parity** *\<unquoted string> -* The parity of bits in the serial port. The possible values for this parameter are: *None*, *Even*, *Odd* or *dynamic*.
* **Timeout** *\<numeric> -* The timeout in milliseconds defined for this serial port.
* **Tries** *\<numeric> -* The number of tries defined for this serial port.
* **Device String** *\<string> -* The name of the device string specifying the serial port to open. Leave empty for system default in Windows. For example "BT1:" in Windows or "/dev/ttyS1" in Android.

{% hint style="info" %}
The pre-defined values for the **Baud Rate** are: 110, 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 56000, 57600, 115200 and 128000.
{% endhint %}

{% hint style="info" %}
If **Device String** value is specified, the actual number in **Serial Port** is ignored to open the port, but you must specify the same **Serial Port** in subsequent **Serial ...** actions called to use the same port opened in this action.
{% endhint %}

{% hint style="info" %}
In Win10 for Bluetooth devices you can use **Device String** to specify the name of the Bluetooth device you want to connect to, specifying the COM port number for Bluetooth virtual COM port will not work.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.sysdevmobile.com/kalipso5/developing/form/actions/actions-description/group-communications/serial-open.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.