Zoltan Hudak
TCP/IP to Serial Converter (remote serial port). For more details see [https://developer.mbed.org/users/hudakz/code/Serial_over_Ethernet/wiki/Homepage]
Dependencies: UIPEthernet mbed mbed-STM32F103C8T6
TCP/IP to Serial Converter
- Enables communication with TTL serial device over Ethernet LAN connection.
- You can considerably extend an existing serial connection without modifying the legacy serial communication software.
How it Works
Serial data sent by an application running on your PC to your PC's virtual serial port (see below how to create one) is automatically transmitted through Ethernet LAN connection to a "TCP/IP to Serial Converter". The converter then sends the data received over Ethernet to the connected TTL serial device through serial connection. In turn, the response from the serial device is sent back to your PC by the "TCP/IP to Serial Converter" over Ethernet connection and the application can read through the virtual serial port without knowing that it actually arrived over Ethernet .
How to build one
To create a "TCP/IP to Serial Converter" an inexpensive ENC28J60 Ethernet module is connected to the mbed board and set-up as TCP/IP server. The server is listening for data coming from clients for example at IP Address 192.168.1.181, Port Number 10001 (adapt to your needs). Binary data received from a client over the Ethernet is transmitted to the connected TTL serial device and in turn, data received from the serial device is sent back to the TCP/IP client via Ethernet.
- Compile the program and save the binary to your mbed board.
- Connect an ENC28J60 Ethernet module to the mbed board according to the pin assignment defined in main.cpp.
- Connect the ENC28J60 module to your Ethernet network.
- Connect a serial device to the mbed's serial port. Please notice that in case your serial device is using a regular RS-232 connection an additional "Serial TTL to regular RS-232 converter" is needed!
How to test and use the Converter
- Create a virtual serial port on your PC as follows:
See Using HW VSP powered by HW group and download their HW VSP3 Virtual Serial Port for free. - Install and run the HW VSP. Proceed to the Virtual Serial Port tab and create a new virtual serial port (for example COM200). Assign it the same IP address and port number as you specified in main.cpp (IP address 192.168.1.181 and port number 10001).
- You can now close the HW VSP application and verify, through the Windows Device Manager, that a new COM200 port is available on the system. From now on, all serial data sent by any application running on your PC to your PC's serial port COM200 will be redirected trough the Ethernet LAN to the "TCP/IP to Serial Converter". Then mbed's serial port will act on behalf of COM200 and transmit the data to the connected serial device. In turn, the response from the serial device will be sent back trough the Ethernet LAN to your PC and the application can read through the (virtual) serial port COM200.
- Simple test:. Connect the serial Tx pin on the mbed board to the Rx pin. On your PC, run your favorite terminal application (HyperTerminal, TeraTerm, PuTTY etc.) and open serial port COM200. Set the same bit rate as you did in main.cpp. Then type in some message and send it to serial port COM200. In turn, you should receive the same data echoed by the "TCP/IP to Serial Converter".
main.cpp@0:5f21653e7308, 2015-04-10 (annotated)
- Committer:
- hudakz
- Date:
- Fri Apr 10 21:46:06 2015 +0000
- Revision:
- 0:5f21653e7308
- Child:
- 1:d39ee3c772e8
Initial version
Who changed what in which revision?
| User | Revision | Line number | New contents of line |
|---|---|---|---|
| hudakz | 0:5f21653e7308 | 1 | /* |
| hudakz | 0:5f21653e7308 | 2 | * TCP/IP to Serial Converter. |
| hudakz | 0:5f21653e7308 | 3 | * |
| hudakz | 0:5f21653e7308 | 4 | * Created: 2015-04-10 |
| hudakz | 0:5f21653e7308 | 5 | * Author: Zoltan Hudak |
| hudakz | 0:5f21653e7308 | 6 | * |
| hudakz | 0:5f21653e7308 | 7 | * ENC28J60 modul is connected to the mbed board to create a TCP/IP server. |
| hudakz | 0:5f21653e7308 | 8 | * The server is listening for clients at port 1001 (you can select another one if you like). |
| hudakz | 0:5f21653e7308 | 9 | * Binary data received from a client is transmitted to a serial device and |
| hudakz | 0:5f21653e7308 | 10 | * data received from the serial device is in turn sent back to the TCP/IP client. |
| hudakz | 0:5f21653e7308 | 11 | * |
| hudakz | 0:5f21653e7308 | 12 | */ |
| hudakz | 0:5f21653e7308 | 13 | |
| hudakz | 0:5f21653e7308 | 14 | #include "mbed.h" |
| hudakz | 0:5f21653e7308 | 15 | #include "UIPEthernet.h" |
| hudakz | 0:5f21653e7308 | 16 | |
| hudakz | 0:5f21653e7308 | 17 | const int BAUD = 115200; // serial bit rate (change to match the speed of the connected serial device) |
| hudakz | 0:5f21653e7308 | 18 | uint8_t rxBuf[1024]; // serial rx buffer (reduce the size if you don't need it) |
| hudakz | 0:5f21653e7308 | 19 | uint8_t txBuf[1024]; // serial tx buffer (reduce the size if you don't need it) |
| hudakz | 0:5f21653e7308 | 20 | volatile int rxCounter = 0; // serial rx counter |
| hudakz | 0:5f21653e7308 | 21 | |
| hudakz | 0:5f21653e7308 | 22 | // UIPEthernet is the name of a global instance of UIPEthernetClass. |
| hudakz | 0:5f21653e7308 | 23 | // Do not change the name! It is used within the UIPEthernet library. |
| hudakz | 0:5f21653e7308 | 24 | #if defined(TARGET_LPC1768) |
| hudakz | 0:5f21653e7308 | 25 | Serial serial(p9, p10); // serial port |
| hudakz | 0:5f21653e7308 | 26 | UIPEthernetClass UIPEthernet(p11, p12, p13, p8); // mosi, miso, sck, cs |
| hudakz | 0:5f21653e7308 | 27 | #elif defined(TARGET_NUCLEO_F103RB) |
| hudakz | 0:5f21653e7308 | 28 | Serial serial(PA_2, PA_3); // serial port |
| hudakz | 0:5f21653e7308 | 29 | UIPEthernetClass UIPEthernet(PB_5, PB_4, PB_3, PB_6); // mosi, miso, sck, cs |
| hudakz | 0:5f21653e7308 | 30 | |
| hudakz | 0:5f21653e7308 | 31 | // If your board/plaform is not present yet then uncomment |
| hudakz | 0:5f21653e7308 | 32 | // the following three lines and replace TARGET_YOUR_BOARD and other pins as appropriate. |
| hudakz | 0:5f21653e7308 | 33 | |
| hudakz | 0:5f21653e7308 | 34 | //#elif defined(TARGET_YOUR_BOARD) |
| hudakz | 0:5f21653e7308 | 35 | //Serial serial(SERIAL_TX, SERIAL_RX); // serial port |
| hudakz | 0:5f21653e7308 | 36 | //UIPEthernetClass UIPEthernet(SPI_MOSI, SPI_MISO, SPI_SCK, SPI_CS); // mosi, miso, sck, cs |
| hudakz | 0:5f21653e7308 | 37 | #endif |
| hudakz | 0:5f21653e7308 | 38 | |
| hudakz | 0:5f21653e7308 | 39 | // MAC number must be unique within the connected network. Modify as appropriate. |
| hudakz | 0:5f21653e7308 | 40 | const uint8_t MY_MAC[6] = { 0x00, 0x01, 0x02, 0x03, 0x04, 0x06 }; |
| hudakz | 0:5f21653e7308 | 41 | |
| hudakz | 0:5f21653e7308 | 42 | // IP address must be also unique and compatible with your network. Change as appropriate. |
| hudakz | 0:5f21653e7308 | 43 | const IPAddress MY_IP(192, 168, 1, 181); |
| hudakz | 0:5f21653e7308 | 44 | |
| hudakz | 0:5f21653e7308 | 45 | // TCP/IP port (select a port) |
| hudakz | 0:5f21653e7308 | 46 | const uint16_t MY_PORT = 10001; |
| hudakz | 0:5f21653e7308 | 47 | |
| hudakz | 0:5f21653e7308 | 48 | EthernetServer myServer = EthernetServer(MY_PORT); // create server |
| hudakz | 0:5f21653e7308 | 49 | |
| hudakz | 0:5f21653e7308 | 50 | /** |
| hudakz | 0:5f21653e7308 | 51 | * @brief Reads data from serial port |
| hudakz | 0:5f21653e7308 | 52 | * @note Called on arrival of new serial data |
| hudakz | 0:5f21653e7308 | 53 | * @param |
| hudakz | 0:5f21653e7308 | 54 | * @retval |
| hudakz | 0:5f21653e7308 | 55 | */ |
| hudakz | 0:5f21653e7308 | 56 | void onSerial(void) { |
| hudakz | 0:5f21653e7308 | 57 | rxBuf[rxCounter++] = serial.getc(); // read serial data |
| hudakz | 0:5f21653e7308 | 58 | } |
| hudakz | 0:5f21653e7308 | 59 | |
| hudakz | 0:5f21653e7308 | 60 | /** |
| hudakz | 0:5f21653e7308 | 61 | * @brief Main |
| hudakz | 0:5f21653e7308 | 62 | * @note |
| hudakz | 0:5f21653e7308 | 63 | * @param |
| hudakz | 0:5f21653e7308 | 64 | * @retval |
| hudakz | 0:5f21653e7308 | 65 | */ |
| hudakz | 0:5f21653e7308 | 66 | int main(void) { |
| hudakz | 0:5f21653e7308 | 67 | UIPEthernet.begin(MY_MAC, MY_IP); |
| hudakz | 0:5f21653e7308 | 68 | myServer.begin(); |
| hudakz | 0:5f21653e7308 | 69 | serial.baud(BAUD); |
| hudakz | 0:5f21653e7308 | 70 | serial.attach(&onSerial); |
| hudakz | 0:5f21653e7308 | 71 | |
| hudakz | 0:5f21653e7308 | 72 | while(1) { |
| hudakz | 0:5f21653e7308 | 73 | EthernetClient client = myServer.available(); |
| hudakz | 0:5f21653e7308 | 74 | if(client) { // check for connected client |
| hudakz | 0:5f21653e7308 | 75 | size_t size = client.available(); |
| hudakz | 0:5f21653e7308 | 76 | if(size > 0) { |
| hudakz | 0:5f21653e7308 | 77 | rxCounter = 0; // clear rx counter |
| hudakz | 0:5f21653e7308 | 78 | size = client.read(txBuf, size); // read data received from the TCP/IP client |
| hudakz | 0:5f21653e7308 | 79 | for(int txCounter = 0; txCounter < size; txCounter++) |
| hudakz | 0:5f21653e7308 | 80 | serial.putc(txBuf[txCounter]); // send through serial |
| hudakz | 0:5f21653e7308 | 81 | wait_ms(50); // tune (increase) this if you are loosing some data |
| hudakz | 0:5f21653e7308 | 82 | client.write(rxBuf, rxCounter); // send back to client |
| hudakz | 0:5f21653e7308 | 83 | } |
| hudakz | 0:5f21653e7308 | 84 | } |
| hudakz | 0:5f21653e7308 | 85 | } |
| hudakz | 0:5f21653e7308 | 86 | } |