Brainboxes provides a .NET API which allows easy integration of Brainboxes Ethernet to Serial modules into your Windows software applications, (or general .NET application which can also be run under Linux using Mono).

The Brainboxes.IO .NET API does not use the serial port API, instead it communicates with the Ethernet to Serial Devices using raw TCP. One benefit of this is that Brainboxes Windows COM port drivers don't need be to installed on any machine. On the Brainboxes Ethernet to serial device, a configuration step is required to allow raw TCP communication.

The Brainboxes Ethernet to Serial device then takes care of handshaking and com port settings with the serial connected device. Alternatively in Windows the Ethernet to Serial can be installed using Brainboxes Virtual Com ports, and the standard windows serial API can be used.


Configure Brainboxes Ethernet to Serial for Raw TCP

  1. Navigate to the homepage of your brainboxes ethernet to serial device in a web browser
  2. Click on the serial port bottom on the left hand side navigation
  3. Set the appropriate settings for you serial port connection and then check the "always use these settings checkbox"
  4. Change the Protocol Type to "Raw TCP"
  5. Click Save
  6. You can test this set up by connecting to the IP address and port using a terminal such as Putty

C# Code Sample

Brainboxes.IO C# API in visual studio for Ethernet to serial


The following code works in C# targeted at .net version 2.0 and above

using System;
using System.Diagnostics;

namespace Brainboxes.IO.Samples.ES.ConsoleApplication
    class Program

        static void Main(string[] args)
            ESDevice es = new ES246("");
                Console.WriteLine("Connecting to " + es);
                //connect method opens all serial ports of the device, an es-246 only has 1 port
                //alternatively just open the port you need

                es.Ports[0].Label = "Serial Weighing scale"; //you can give each port a label, useful for debugging

                Console.WriteLine("Sending Commands");

                //es-246 only has one port, note the ports are indexed from 0
                //the default protocol automatically appends carriage return to the end of a message and encodes data into ASCII
                es.Ports[0].Send("HELLO ... ");
                es.Ports[0].Send("HELLO AGAIN...");

                //you can use a different protocol to suit the device you are communicating with like this:
                es.Ports[0].Protocol = new DefaultSerialProtocol()
                    TerminatingCharacters = "\r\n", //you can set multiple char line endings with the default protocol
                    Encoding = System.Text.Encoding.Unicode, //you can also change the character encoding
                //alternatively create a class which implements ISerialProtocol

                // 1 minutes in milliseconds
                int msToRx = 1 * 60 * 1000;

                Console.WriteLine("Waiting " + (msToRx / 1000) + " seconds for data to be received");
                Stopwatch sw = Stopwatch.StartNew();

                while (sw.ElapsedMilliseconds < msToRx)
                        //write any received data out to the console
                        //note this is a blocking function, if you have many connections, or a UI
                        //you will need to do this in another thread
                        //the default protocol waits for the terminating character (by default a /r CARRIAGE RETURN) to determine the end of a message
                        //the default protocol removes the terminating character before returning the message as a string
                        string recievedData = es.Ports[0].Receive();
                        Console.WriteLine("Received DATA : " + recievedData);
                    catch (TimeoutException)
                        //if the receive function times out it throws an exception
                        //but it doesn't matter as we are just waiting for data in this example
                        Console.WriteLine("No data received within timeout");

            catch (Exception e)
                Console.WriteLine("An error occurred");
                Console.WriteLine("Press enter to exit...");