USR IOT USR-TCP232-ED2 User manual

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 1 / 82 [email protected]
USR-TCP232-ED2 User Manual
File Version: V1.1.2

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 2 / 82 [email protected]
Contents
1. Get Start.............................................................................................................................................................................4
1.1. Hardware Testing Environment...............................................................................................................................4
1.1.1. Hardware Preparing.....................................................................................................................................5
1.1.2. Hardware Connection..................................................................................................................................5
1.2. Net Testing Environment.........................................................................................................................................6
1.3. Default Parameters Testing..................................................................................................................................... 6
1.4. Data Transport Testing............................................................................................................................................ 7
2. Overview............................................................................................................................................................................ 8
2.1. Brief Introduction....................................................................................................................................................8
2.2. Features.................................................................................................................................................................. 8
2.3. Basic Parameters.....................................................................................................................................................9
3. Hardware Parameters...................................................................................................................................................... 10
3.1. Pin Definition........................................................................................................................................................ 10
3.2. Dimension.............................................................................................................................................................11
4. Product Function..............................................................................................................................................................12
4.1. Net basic function.................................................................................................................................................12
4.1.1. IP address/subnet masks/gateway............................................................................................................ 12
4.1.2. DNS Address.............................................................................................................................................. 15
4.1.3. Hardware Restore the Factory Function....................................................................................................15
4.1.4. Web Server................................................................................................................................................ 16
4.1.5. Net Firmware Upgrade.............................................................................................................................. 17
4.2. Socket....................................................................................................................................................................17
4.2.1. TCP Client mode........................................................................................................................................ 17
4.2.2. TCP Server Mode....................................................................................................................................... 21
4.2.3. UDP Client mode........................................................................................................................................23
4.2.4. UDP Server mode...................................................................................................................................... 26
4.2.5. HTTPD client.............................................................................................................................................. 28
4.2.6. Websocket................................................................................................................................................. 30
4.2.7. USR-VCOM.................................................................................................................................................32
4.3. Serial Function...................................................................................................................................................... 33
4.3.1. Serial port Basic Parameters......................................................................................................................33
4.3.2. Flow Control...............................................................................................................................................34
4.3.3. Serial Port Mapping................................................................................................................................... 35
4.3.4. Similar RFC2217.........................................................................................................................................36
4.4. Special Function....................................................................................................................................................38
4.4.1. Heartbeat Package Function......................................................................................................................38
4.4.2. Modbus Gateway.......................................................................................................................................39
4.4.3. Registration Package..................................................................................................................................40
4.4.4. USR-cloud.................................................................................................................................................. 42
4.4.5. Net Printing................................................................................................................................................44

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 3 / 82 [email protected]
4.4.6. Customize Webpage.................................................................................................................................. 45
4.4.7. Customize MAC..........................................................................................................................................46
4.4.8. Restart Timeout......................................................................................................................................... 47
4.4.9. Clear Buffer Data........................................................................................................................................47
4.4.10. Short Connection.....................................................................................................................................48
5. Parameters Setting...........................................................................................................................................................48
5.1. Net Protocol Setting Parameters.......................................................................................................................... 49
5.1.1. Setup Software Setting Parameters...........................................................................................................49
5.1.2. Setting Protocol Setting Parameters..........................................................................................................53
5.2. Webpage Setting Parameters............................................................................................................................... 57
5.3. AT Command.........................................................................................................................................................61
5.3.1. Net AT Command.......................................................................................................................................62
5.3.2. Serial AT Command....................................................................................................................................62
5.3.3. Error AT Command.................................................................................................................................... 63
5.3.4. AT Command..............................................................................................................................................63
5.3.5. AT Command Details..................................................................................................................................65
6. Contact us........................................................................................................................................................................ 81
7. Disclaimer........................................................................................................................................................................ 81
8. Modified History.............................................................................................................................................................. 82

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 4 / 82 [email protected]
1. Get Start
USR-TCP232-ED2 is a module that can realize data transmission between the Network and TTL serial port, which is
equipped with ARM cortex-M4 processor. No need to care of the details, the module realize the protocol
converse.parameters can be set in the software and webpage, configure one time and save forever.
This character aimed at get start and the user are advised to operation one time according to the instr to
understand USR-TCP232-ED2 completely.
Questions occur in the testing, you can refer to our application case and answers:
https://www.usriot.com/support/faq/ethernet-series/
Also you can submit the problem into the support: http://h.usriot.com/
Product link: https://www.usriot.com/products/triple-ttl-uart-to-ethernet-module.html
Related software:
M4 setting software: https://www.usriot.com/support/downloads/usr-m4-setup-software-v234102.html
(also, it can be used in the industrial serial to Ethernet Converter:USR-N668,USR-N510, USR-N520, USR-N540,
USR-TCP232-410S, USR-TCP232-419 and industrial ethernet modules: USR-K7, USR-TCP232-E2.)
Testing software: https://www.usriot.com/support/downloads/usr-tcp-test-testing-software.html
Diagram 1-1 Download Page
1.1. Hardware Testing Environment

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 5 / 82 [email protected]
1.1.1. Hardware Preparing
USR-TCP232-ED2*1
USR-Kx-EVK*1
Cable*1
PC *1
Power adapter (DC5V 1A)*1
Serial port cable *1
Diagram 1.1.1-1 hardware prepare tools
1.Testing purpose:
Have a complete understand for USR-TCP232-ED2
Testing the function.
2.Data direction
Diagram 1.1.1-2 Data Direction
1.1.2. Hardware Connection
To test the communication converse from serial port to net, connect the USR-TCP232-ED2 with evaluation board,
and connected with the PC using serial cable, then connect the net port of USR-TCP232-ED2 and PC. Power on the it.
The diagram is as fellow:

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 6 / 82 [email protected]
Diagram 1.1.2-1 Hardware Connection
Note: the power adapter and cable are from USR.
1.2. Net Testing Environment
To prevent from searching nothing, not ping and not opening the webpage, you should testing the below contents
before using.
1) Shut down firewall and antivirus software.
2) Shut down net card none-related and reserve only one local connection.
3) For the direct connection between PC and server, please provide a static IP in the same LAN with the IP of
USR-TCP232-ED2, e.g.192.168.0.201
Diagram 1.2-1 Local Connection of the PC
1.3. Default Parameters Testing

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 7 / 82 [email protected]
Form 1.3-1 Default parameters
1.4. Data Transport Testing
After the above steps, the USR-TCP232-ED2 can realize the bi-direction between the serial port and ethernet,
operation steps are as fellows:
1) Open the “USR-TCP232-Test.exe” connecting the hardware as Diagram 1.1.2-1 .
2) Net setting change into TCP Client, enter the 192.168.0.7 into IP address, server port is 23. then click to build
TCP connection. serial baud rate:115200, Serial port parameters: none/8/1 then open the serial port.
From now, we can have the data transmit testing from the serial port to network.
Direction from serial port to network:
PC serial port → USR-TCP232-ED2 serial port → USR-TCP232-ED2 network → PC network data
Direction from network to serial port:
PC network data → network →USR-TCP232-ED2 serial port → PC serial port
As the below:
Item
Content
Username
admin
Password
admin
IP address of ED2
192.168.0.7
Subnet masks of ED2
255.255.255.0
Default gateway of ED2
192.168.0.1
Default mode of the port1 of ED2
TCP Server
Default local port of the port1
ED2
23
Serial port baud rate
115200
Serial port parameters
None/8/1

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 8 / 82 [email protected]
Diagram 1.4-1 Default Parameters Testing
2. Overview
2.1. Brief Introduction
Multifucntion serial to Ethernet module USR-TCP232-ED2, which supports three TTL serial ports, can realize data
transmission between the network and TTL serial port. This module is equipped with ARM cortex- M4 processor, which
has the advantages of low power consumption, fast speed and high stability.
Equipped with the net transform, serial communication baud rate can reach at 1024Kbps, USR-TCP232-ED2
supports several work mode such as:TCP Server, TCP Client, UDP, Httpd Client and WEB to Serial(Websocket), can be
figured in the webpage or the upset software. The internal integration of TCP/IP protocol stack, user can use it to
complete the embedded device networking function easily,saving the development process of human, material and
development cycle, so that products can be faster into the market, enhance competitiveness.
Passed the strict testing, USR-TCP232-ED2 has successful case in Banks, highways, large corporate networks, busy
webcam networks and complex network environments such as fiber-optic to Ethernet.
2.2. Features
Equipped with ARM cortex-M4, industrial width of temperature,TCP/IP protocol stack, more stable and reliable.
Equipped with network transformer, supports 1.5KV electromagnetic isolation

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 9 / 82 [email protected]
Supports TCP server, TCP client, UDP server, UDP client and HTTPD client work mode
Build-in webpage where can set the parameters, also can customize webpage. The port of the webpage can be
defined
Supports two TTL serial ports, can work in same time independently
Supports RTS/CTS hardware flow control and Xon/Xoff software flow control
Supports USR-VCOM
Baud rate:600bps~1Mbps; and five parity way:none, odd, even, mark, space
Supports modbus gateway
Supports Reload button, hardware restore to factory setting
RJ45 have Link/Data indicator, in the net port, there is Isolating transformer,1.5KB ESD
The unique MAC in the world(begin with D8-B0-4C), and the user can self-defined
Supports net upgrade firmware,DDNS, DHCP
Supports static IP and DHCP, query the device in LAN with UDP
Supports keepalive, check dead connection and abnormal and reconnection
Supports password and username, more safety
Supports two websockets to realize the bi-direction transparent transmission between serial port and webpage.
2.3. Basic Parameters
Parameter
Value
Hardware parameters
Input Voltage
VCC: 3.0～3.6V( 3.3V is best)
VDD: 5.0~7.0V(5.0V is best)
Working Current
[email protected] / 120mA5.0V
Encapsulation way
Pin
Serial port
600~1M(bps)
Software parameters
Network protocol
IP, IPV4, TCP, UDP, DHCP, DNS, HTTP, ARP,
ICMP, Web socket
Access way to IP
Static IP, DHCP
DDNS
Support
User parameters
Software setting, webpage setting, AT
command
Single transparent transmission
TCP Server/TCP client/UDP Server/UDP Client
Modbus
Supports modbus gateway
Webpage to serial port
Websocket
Similar RFC2217
Support
Httpd client
support
Self-defined webpage
support

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 10 / 82 [email protected]
TCP server connection
Maximum 8
Net buffer
Send:16Kbyte; receive:16Kbyte
Serial port buffer
Send:2K byte;receive: 2kbyte
Average transport delay
<10ms
Set software
USR-VCOM, USR-Cloud, parameters setting
software
others
Certification
CE,FCC, ROHS
Protection
1.5KV electromagnetic isolation
Size
44.5x31.8x15.4 mm(L*W*H)
Operating Temp.
-40～+85°C
Storage temp
-40～+105°C
operating humidity
5%～95% RH
Storage humidity
5%～95% RH
Accessory
None
Package
Electrostatic bubble
3. Hardware Parameters
3.1. Pin Definition
NO.
Name
Instr
I/O
Voltage range
1
ETH_TX+
Ethernet TX+
O
3.0-3.6V
2
ETH_TX-
Ethernet TX-
O
3.0-3.6V
3
ETH_RX+
Ethernet RX+
I
3.0-3.6V
4
ETH_RX-
Ethernet RX-
I
3.0-3.6V
5
LED_DATA
Net data light
O
3.0-3.6V
6
TXD0
Serial 0 send
O
3.0-3.6V
7
RXD0
Serial 0 received
I
3.0-3.6V
8
485_en(RTS0)
RS485 receive and send control
I
9
Reload
Hardware restore to factory setting. Put down the reload before
power on, after 5s, put up and can restore the factory setting
I
3.0-3.6V
10
RST
RST pin is the pin for module to restore, please connect to the IO port
of the MCU. Restore the module when there is abnormal occurring.
Restore the module when this pin receive 200ms low level power.
Powering on and restoring the module, is normal operate for module
O
3.0-3.6V

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 11 / 82 [email protected]
11
GND
Ground
P
3.0-3.6V
12
GND
Ground
P
3.0-3.6V
13
+5V
5.0V power
P
5.0-7.0V
14
+5V
5.0V power
P
5.0-7.0V
15
LED_LINK
Net link light(net port physical connection light)
I
3.0-3.6V
16
+3.3V
3.3V power
P
3.0-3.6V
17
RXD1
Serial 1 received
I
3.0-3.6V
18
TXD1
Serial 1 sent
O
3.0-3.6V
19
RXD2
Serial 2 received
I
3.0-3.6V
20
TXD2
Serial 2 sent
O
3.0-3.6V
21
CTS0
Serial 0 clear sent
3.0-3.6V
22
RTS1
Default is 485 receive and send switching
I
3.0-3.6V
23
CTS1
Serial 1 clear sent
3.0-3.6V
Form 3.1-1 Pin Definition
Note: P power pin
I input pin
O output
I/O bi-direction data transmission pin
3.2. Dimension
Diagram 3.2-1 Dimension
Note: detailed PCB file please down load from office net: http://www.usr.cn/Download/52.html

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 12 / 82 [email protected]
4. Product Function
This character instruct all the function of the USR-TCP232-ED2, below is the details.
Diagram 4-1 USR-TCP232-ED2 Function
4.1. Net basic function
4.1.1. IP address/subnet masks/gateway
1. IP address is the identity representation of the module in the LAN, which is unique in the LAN, so please be sure
there is no another device same as it in the LAN.
Static IP
Handle to setting. Note fill the IP, subnet masks and gateway.
Static IP adopted to the environment that required to statistics the IP and the device and makes them correspond
one to one.
Advantage: accessing the device that can not distribute IP address can be searched via UDP broadcast.
Disadvantage: different net segment in the different LAN can not communicate normally.

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 13 / 82 [email protected]
DHCP
Get IP address , gateway address, DNS server and other information from the gateway server to easy the step for
setting IP address, DHCP adopted to the environment that have no special requirement to IP.
Advantage: accessing the device equipment with the DHCP server such as router can communicate directly.
Reduce the hassle of setting IP address and subnet masks.
Disadvantage: accessing the device with no DHCP server such as computer directly, USR-TCP232-ED2 can not work.
2. Subnet masks is a 32 address, used to determine the host number and the network number by shielding some
IP address, indicates the number of subnet and determine the flag within the subnet. Using combine with the IP
address. The subnet masks needed to set, usually we use the subnet masks: 255.255.255.0. The number of IP addresses
in the subnet is 2 to the eighth power minus 2, that is, 256-2=254, and the general host addresses are all 0 or 1 (binary)
has its special role.
3. Gateway is the net port of the LAN. If you connect the router to access the internet, the gateway is the router IP
address, setting wrong and can not access into the net. No device such as router and no setting, keep the default.
4. Related AT command.
Name
Instr
AT+WANN
Setting and query the access way,IP, subnet masks and gateway
parameters for USR-TCP232-ED2
Form 4.1.1-1 Related AT Command
5.Setup software

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 14 / 82 [email protected]
Diagram4.1.1-1 Setup Software

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 15 / 82 [email protected]
4.1.2. DNS Address
Diagram 4.1.2-1 DNS Server
DNS address of the USR-TCP232-ED2 can be set. When USR-TCP232-ED2 need DNS, it will quest for the address
that you set.(3010 and above version support self-define DNS address.)
The default DNS server address is the gateway. In DHCP, default DNS address is acquired automatically.
DNS address can be set, which means that if the domain name server are imperfect, user also can realize the
domain name analyze referred to AT command.
Name
Instr
AT+DNS
Setting and query the DNS address server.
form 4.1.2-1 DNS AT Command
4.1.3. Hardware Restore the Factory Function
Module supports hardware restore factory function.
Powered off and put down the reload. Then power on and keep the reload down for 5s. After put up, restore to
factory setting successfully.
Steps:
Put down the reload →power on →reload keep for 5s→ put up

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 16 / 82 [email protected]
Diagram 4.1.3-1 Restore to Factory Setting Step
When there are wronged parameters or forget the password, you can use hardware restore.
Name
Instr
AT+RELD
Restore to factory setting
Form 4.1.3-1 Hardware Restore Factory AT Command
4.1.4. Web Server
The build-in webpage of the USR-TCP232-ED2 same as the common webpage. User can check the related status of
the module via webpage. Default port of the web server:80(can be modify, after modify, you can access the webpage
via other port.
Check the running status of the USR-TCP232-ED2
1) Running time: determine the running time and whether restart.
2) TX count(eth): determine how many data USR-TCP232-ED2 send to internet.
3) RX count(eth): determine how many data send to module from net
4) Conn status(eth)A: connection status of the A to determine which status that USR-TCP232-ED2 stay.
Connection status: IDLE, LISTEN, CONNECTING, CONNECTED, ERROR
IDLE: initial status, no connection and no listening. e.g. waiting connection of the short connection or original
status.
LISTEN: under TCP server mode, listening and wait being connected.
CONNECTING: under TCP client, USR-TCP232-ED2 building the connection to TCP server
CONNECTED: have built
CONNECTED(n):under TCP server, the number of the client connected.
ERROR: USR-TCP232-ED2 stayed in abnormal disconnection.
5) Conn status (ETH)B:connection status of socket B
Diagram4.1.4-1 Running Status

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 17 / 82 [email protected]
4.1.5. Net Firmware Upgrade
Net upgrade firmware is stable and easy. New function can be enjoyed in the last firmware to meet the high
requirement. Ask for new firmware from supply or from the USR support: http://h.usriot.com, details please refer to
5.1.1 firmware upgrade.
4.2. Socket
There are five work modes for USR-TCP232-ED2:TCP server, TCP client, UDP server, UDP client and HTTPD client.
Setting from the setup software or the webpage.
Diagram 4.2-1 Work Mode
Name
Instr
AT+SOCKA1
Setting the protocol/ remote IP/remote port of ED2 SOCKA
AT+SOCKB1
Setting the protocol/ remote IP/ remote port of ED2 SOCKB
Form 4.2-1 Work Mode AT Command
4.2.1. TCP Client mode
Diagram 4.2.1-1 TCP Client Mode
1. TCP client provides client connection for TCP net server. Build connection automatically and connect to server

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 18 / 82 [email protected]
to realize the data transmit between serial port and server port. According to related rule of TCP, TCP client has
difference between connecting and disconnecting, to confirm the data transport reliable. Usually used in the data
interaction between device and server, which is the commonest communication way.
2. Under TCP client mode, USR-TCP232-ED2 supports recognize the abnormal connection automatically. About
15s internal to send Keep Alive to keep active after build. If there is abnormal disconnection, USR-TCP232-ED2 will find
it and reconnection.USR-TCP232-ED2 connects the server as a TCP, remote port is 0, connecting with random port
every time.
3. connecting the remote IP automatically, but do not receive any other connecting quest.
4. Supporting the similar RFC2217, USR-cloud and modbus TCP. In LAN, if the USR-TCP232-ED2 is static IP, please
be sure that set the IP of USR-TCP232-ED2 in the same LAN and set gateway correctly, or USR-TCP232-ED2 is can not
communication.
5. Note: keep alive, similar RFC2217, USR-cloud and modbus TCP are instructed in the bellow.
6. TCP client communication case:
①USR-TCP232-ED2 work in TCP client mode, remote IP:172.16.11.8, remote port:8234, click to save then search
the USR-TCP232-ED2 again and check the parameters.
Also you can set in the webpage, remote IP and port are as above, then save and restart.
Diagram 4.2.1-2 TCP Client Setup Software Setting

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 19 / 82 [email protected]
Diagram 4.2.1-3 TCP Client Webpage Setting
②connecting the TCP server, the IP of my computer:172.16.11.8, local host port:8234(can be modify), testing
software show the connection information:172.16.11.68:24( if the local port of USR-TCP232-ED2 is 0, here will
distribute a port randomly for USR-TCP232-ED2, e.g.172.16.11.68:49155).
③setting the correct serial port parameters, click the serial port and the sent, receive the bi-direction data
transmission.

USR-TCP232-ED2 User Manual www.usriot.com
Jinan USR IOT Technology Limited 20 / 82 [email protected]
Diagram 1.4-1 TCP Connection Testing