An error tolerant serial UART to TCP connection, raw data bridge.
TCP Connections over Serial.
Useful to connect microcontrollers on development boards like the Arduino Uno to servers, just through the Serial port over USB, without requiring any Ethernet/Wi-Fi hardware.
Meant to bridge the gap between TCP connections to servers and simple serial devices using UART/RS-232/Serial-over-USB, etc.
Host side gateway service written in Go that listens on Serial ports for clients.
Clients implementing the protocol client have a TCP-like API that they can use to make connections to real servers, without networking hardware.
The goal of the project is to have the means to connect the simplest and cheapest devices to the internet, albeit indirectly.
Included in this repo is an implementation of the Protocol Gateway and Client, written in Go. They work on Windows, Linux, Raspberry Pi OS.
The following clients are also available:
Client | Platform | Language |
---|---|---|
ArduinoSerialToTCPBridgeClient | Arduino | C++ |
STM32SerialToTCPBridgeClient | STM32 | C |
- Check the releases page for the latest built binaries.
- Get and configure
config.json
. The serial port in Linux for the Arduino Uno is something like/dev/ttyACM0
.
- Install Go for your system.
- Clone this repository.
- Edit your local
config.json
and set it according to your Serial port configuration. - Debug
example.go
in your IDE, or rungo run example.go
orgo build
for a binary.
- The protocol provides the app an in order, duplicates free and error checked byte stream by adding a CRC32 and simple retry mechanism. See this for background.
- The Protocol Gateway opens a real TCP connection to a set destination on behalf of the Protocol Client.
- The Protocol Client connects to the Protocol Gateway over a serial-like connection, which can possibly corrupt data.
- The client specifies the destination IPv4 address and port.
- The gateway forwards traffic bi-directionally, as long as tcp connection is open and serial line is good.
- Open a terminal, then run
go get -u github.com/RoanBrand/goBuffers
. - In the terminal, change directory to the
protocol
folder inside the repository. - Run
go test -v
in the terminal.
- Add ping option to periodically test serial line and drop upstream connection if timeout.
- Multiple connections per client to servers.
- Capability to scan system and listen on all found COM ports for clients.
- Turn into OS service.