> For the complete documentation index, see [llms.txt](https://docs.eseye.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eseye.com/hera604/configure/hosted-applications/serial-to-ip.md).
# Serial to IP
Open **Integration > Serial to IP** to forward data between either physical serial port and an IP connection.
The page contains independent columns for **serial1** and **serial2**. Configure only the port used by the installation. The screenshot maps **serial1** to `/dev/eser1` and **serial2** to `/dev/eser0`; use the mapping displayed by the router rather than assuming the device numbers follow the port names.
**Forwarding settings**
| Field | Value shown | Description |
| ------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Forwarding | `Enabled` or `Disabled` | Enables or disables Serial-to-IP forwarding for the selected serial port. |
| Characters to indicate forwarding | Blank; example `a,b,c` | Characters that cause the buffered serial data to be forwarded. Enter multiple trigger characters as a comma-separated list. |
| String length to trigger forwarding | `0` | Number of buffered characters that triggers forwarding. A value of `0` means that this trigger is not set. |
| String to trigger forwarding | Blank | Character sequence that causes the buffered data to be forwarded. |
| Max waiting time (milliseconds) before forwarding | `0` | Maximum time data may remain buffered before it is forwarded. Enter a value suitable for the connected device's message timing. |
The forwarding triggers control when buffered serial data is sent to the IP connection. Use the trigger method required by the connected equipment; do not enter arbitrary delimiter characters or message lengths.
**Serial connection**
| Field | serial1 shown | serial2 shown | Description |
| -------- | ------------- | ------------- | ------------------------------------------------------------------------------ |
| Device | `/dev/eser1` | `/dev/eser0` | Router device assigned to the physical serial port. Use the displayed mapping. |
| Baud | `9600` | `9600` | Serial transmission speed in bits per second. |
| Databits | `8` | `8` | Number of data bits in each serial character. |
| Stopbits | `1` | `1` | Number of stop bits used to mark the end of a serial character. |
| Parity | `None` | `None` | Serial error-checking mode. |
The **Baud**, **Databits**, **Stopbits**, and **Parity** values must exactly match the connected equipment. A common notation for the values shown is **9600 8N1**.
**IP connection**
| Field | Value shown | Description |
| ------------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| IP port for inbound data | Blank | Local IP port on which the router receives data to send to the serial device. |
| IP address for outbound data | Blank | Destination IP address to which serial data is sent. |
| IP port for outbound data | Blank | Destination port to which serial data is sent. |
| IP protocol | `TCP` | Transport protocol used by the IP connection. Select the protocol required by the receiving service. |
| Maximum TCP connection attempts | `5` | Maximum number of attempts to establish the TCP connection. Applies when **IP protocol** is set to TCP. |
| Maximum TCP idle time (milliseconds) | `0` | Maximum permitted TCP idle time. Confirm the required meaning of `0` for the deployed software before relying on it as an unlimited timeout. |
| Keep TCP alive | `Yes` | Enables TCP keepalive so that inactive or failed connections can be detected. |
**Configure Serial to IP**
1. Identify whether the equipment is connected to **serial1** or **serial2**.
2. Keep **Forwarding** disabled while entering the settings.
3. Set **Baud**, **Databits**, **Stopbits**, and **Parity** to match the equipment.
4. Enter the inbound port if an IP client will send data to the serial device.
5. Enter the outbound IP address and port if serial data will be sent to a remote IP service.
6. Select the required **IP protocol**.
7. If TCP is used, set the connection-attempt, idle-time, and keepalive values required by the deployment.
8. Configure the forwarding trigger used by the equipment's message format.
9. Set **Forwarding** to **Enabled** for the configured port.
10. Select **Save**.
11. Send a known test message in both required directions and confirm that it arrives unchanged.
> **Network access:** The destination must be reachable through the router, and any required firewall rule must already exist. Do not expose an inbound serial service to an untrusted network.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.eseye.com/hera604/configure/hosted-applications/serial-to-ip.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
