Arduino Serial to TCP Bridge Client

Arduino client for the Serial To TCP Bridge Protocol gateway service.

Open a TCP connection to a server from the Arduino using just serial. No Ethernet/WiFi shields necessary.
Quickly communicate with other servers and make network apps using minimal hardware.
See this for more information on the protocol and for the Protocol Gateway you will need to run on the host the Arduino is connected to serially.

Requires:

• Serial 0 (Main serial through USB)
• Timer 1

Dependencies

• NeoHWSerial - Install manually
• CRC32 - Can be installed from the Arduino Library Manager

After installing the dependencies and this library, make sure you have all 3 present inside your libraries sub-directory of your sketchbook directory.

How to

• Get the Protocol Gateway and build it.
• Change the gateway's config to listen on the COM port connected to your Arduino and start it.
• Your Arduino app can then use the ArduinoSerialToTCPBridgeClient API which is similar to the EthernetClient API to make tcp connections to servers as long as they are reachable from the host and the gateway is running.

MQTT Client Example

1. Install PubSubClient - Manually, or from the Arduino Library Manager.
2. Get a MQTT Broker running on your host, listening at least on localhost. I used HiveMQ.
3. Open and upload the example from the Arduino Examples menu.
4. Run the Protocol Gateway on the same host, with the right COM port configuration.
5. When the Arduino is connected to the MQTT broker, it will publish a message and subscribe to the led topic.
6. You can use another MQTT client like MQTT.fx to publish characters 0 and 1 to the topic led to toggle the led on and off on the Arduino board.

Details

• Limit of 250 bytes you can write a time for now. Will return 0 if length is exceeded.
• 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 running on the Arduino, and forwards traffic bi-directionally.
• ArduinoSerialToTCPBridgeClient is derived from the standard Arduino Client class. This means existing code written for Ethernet/Wi-Fi shields should work with this.
• NeoHWSerial is an alternative for Serial, used to gain access to the AVR UART interrupts.
• You cannot use the same serial port in your app that is being used by the protocol, e.g. You cannot use Serial (Serial0) when the library uses NeoSerial, etc.