RS232/485 TO ETH 软件设计手册
RS232/485 TO ETH
软件设计手册
深圳市微雪电子有限公司
第 1 页 共 68 页
www.waveshare.net
RS232/485 TO ETH 软件设计手册
功能特点
采用了 M4 系列 32 位 ARM 处理器,主频高达 120MHz,运行速率快,稳定可靠
支持 10/100M 以太网接口,支持 Auto-MDI/MDIX(交叉直连网线任意连接,自动切换)
支持 RS232 和 RS485 接口,两路接口可同时独立工作,互不影响
支持设置通信波特率(600bps~230.4Kbps),支持 None、Odd、Even、Mark 和 Space 五种校验
板载多种功能指示灯,方便查看模块通信和运行状态
工作模式可选 TCP Server、TCP Client、UDP Server、UDP Client、HTTPD Client(支持 GET 和 POST)
支持 Modbus 网关功能,工业使用更方便
支持 Websocket 功能,可直接通过网页实现与 RS232、RS485 端口的双向透明传输
支持网页、AT 指令、串口协议和网络协议设置参数,提供设置协议,客户可集成到自己的软件中
支持自定义心跳包机制,确保连接真实可靠,也可用于主动抓取传感器数据
支持自定义注册包机制,建立连接后自动发送预定注册包作为标识,方便区分不同设备
支持自定义网页功能,方便用户自定义模块网页内容
支持类 RFC2217 协议,可实现与变串口参数(波特率、数据位等)的设备通讯
支持 KeepAlive 机制,可快速探查网络异常中断,并断开重连
支持超时重启(无数据重启)功能,确保长期稳定通信,可自定义重启时间
支持 DNS 域名解析功能,可自定义 DNS 服务器地址
支持 DHCP 功能,能够自动获取 IP,也可自定义静态 IP
支持通过网络升级固件功能,维护更方便
支持通过软件和硬件方式恢复出厂设置
出厂烧写特定的 MAC,可自定义 MAC 地址
提供软件:模块配置软件、TCP/UDP 测试工具、虚拟串口软件等
提供编程范例:上位机编程例子(socket),VB、C++、Delphi、Android、iOS 等
深圳市微雪电子有限公司
第 2 页 共 68 页
www.waveshare.net
RS232/485 TO ETH 软件设计手册
目录
2.3.
2.4.
2.5.
2.1.
2.2.
1.1.
1.2.
RS232/485 TO ETH.................................................................................................................................................... 1
软件设计手册...............................................................................................................................................................1
1. 产品概述...............................................................................................................................................................6
产品简介...............................................................................................................................................6
规格参数...............................................................................................................................................6
2. 产品功能...............................................................................................................................................................7
默认参数...............................................................................................................................................7
基础功能...............................................................................................................................................8
IP 地址/子网掩码/网关............................................................................................................... 8
2.2.1.
2.2.2.
DNS...............................................................................................................................................9
2.2.3. Web Server................................................................................................................................ 10
2.2.4. 恢复出厂设置............................................................................................................................ 10
2.2.5. 固件升级.....................................................................................................................................11
Socket 功能........................................................................................................................................ 12
TCP Client 模式特性................................................................................................................ 12
2.3.1.
TCP Server 模式特性............................................................................................................... 14
2.3.2.
UDP Client 模式特性................................................................................................................17
2.3.3.
UDP Server 模式特性...............................................................................................................19
2.3.4.
2.3.5.
Httpd Client...............................................................................................................................22
2.3.6. WebSocket................................................................................................................................. 24
2.3.7. 配套软件 VCOM(虚拟串口)....................................................................................................26
串口功能.............................................................................................................................................27
2.4.1. 流控介绍.....................................................................................................................................27
2.4.2. 串口成帧机制............................................................................................................................ 27
2.4.3. 类 RFC2217............................................................................................................................... 29
特色功能.............................................................................................................................................30
2.5.1. 心跳包功能................................................................................................................................ 30
2.5.2. Modbus 网关功能.................................................................................................................... 31
2.5.3. 注册包功能................................................................................................................................ 37
2.5.4. 透传云功能................................................................................................ 错误!未定义书签。
2.5.5. 网络打印.....................................................................................................................................39
2.5.6. 自定义网页功能........................................................................................................................ 41
2.5.7. 自定义 MAC..............................................................................................................................42
2.5.8. 超时重启.....................................................................................................................................43
2.5.9. 清除缓存数据............................................................................................................................ 43
2.5.10. 短连接.........................................................................................................................................44
3. 设置协议.............................................................................................................................................................45
网络设置协议.....................................................................................................................................45
3.1.1. 设置参数的流程........................................................................................................................ 45
3.1.2. 设置指令内容............................................................................................................................ 45
3.1.3. 返回指令内容............................................................................................................................ 48
AT 指令配置(3011 及以上版本支持 AT 指令)...............................................................................49
3.1.
3.2.
深圳市微雪电子有限公司
第 3 页 共 68 页
www.waveshare.net
RS232/485 TO ETH 软件设计手册
3.2.1. 网络 AT 指令概述..................................................................................................................... 49
3.2.2. 串口 AT 指令概述..................................................................................................................... 50
AT 指令集.................................................................................................................................. 51
3.2.3.
3.2.4.
AT 指令详解:.......................................................................................................................... 53
AT+E.................................................................................................................................. 53
1.
AT+Z.................................................................................................................................. 53
2.
3.
AT+VER.............................................................................................................................53
AT+ENTM.........................................................................................................................53
4.
AT+MAC........................................................................................................................... 54
5.
6.
AT+RELD..........................................................................................................................54
AT+WANN.........................................................................................................................54
7.
AT+DNS.............................................................................................................................54
8.
AT+WEBU.........................................................................................................................55
9.
10.
AT+WEBPORT.................................................................................................................55
AT+SEARCH.................................................................................................................... 55
11.
AT+PLANG.......................................................................................................................56
12.
13.
AT+UARTN.......................................................................................................................56
AT+UARTTLN................................................................................................................. 57
14.
AT+SOCKMN...................................................................................................................57
15.
16.
AT+SOCKLKMN.............................................................................................................58
AT+WEBSOCKPORT1................................................................................................... 58
17.
AT+REGENN....................................................................................................................58
18.
19.
AT+REGTCPN................................................................................................................. 59
AT+REGUSRN................................................................................................................. 59
20.
AT+REGCLOUDN...........................................................................................................59
21.
22.
AT+HTPTPN.....................................................................................................................60
AT+HTPURLN................................................................................................................. 60
23.
AT+HTPHEADN.............................................................................................................. 60
24.
AT+HTPCHDN.................................................................................................................61
25.
26.
AT+HEARTENN.............................................................................................................. 61
AT+HEARTTPN...............................................................................................................61
27.
AT+HEARTTMN............................................................................................................. 62
28.
29.
AT+HEARTDTN.............................................................................................................. 62
AT+PDTIME.....................................................................................................................63
30.
AT+MID.............................................................................................................................63
31.
32.
AT+USERMAC.................................................................................................................63
AT+RFCENN.................................................................................................................... 63
33.
AT +SOCKSLN.................................................................................................................64
34.
35.
AT+ SHORTON................................................................................................................64
AT+RSTIM........................................................................................................................64
36.
AT+UARTCLBUF............................................................................................................ 65
37.
38.
AT+SOCKTONN..............................................................................................................65
AT+MODTCPN................................................................................................................ 65
39.
40.
AT+MODPOLLN............................................................................................................. 66
深圳市微雪电子有限公司
第 4 页 共 68 页
www.waveshare.net
RS232/485 TO ETH 软件设计手册
41.
42.
43.
44.
45.
46.
47.
AT+MODTON...................................................................................................................66
AT+NETPRN.................................................................................................................... 67
AT+UDPONN....................................................................................................................67
AT+CFGTF....................................................................................................................... 67
AT+PINGN........................................................................................................................68
AT+HEARTUSERN......................................................................................................... 68
AT+REGUSERN...............................................................................................................68
深圳市微雪电子有限公司
第 5 页 共 68 页
www.waveshare.net
RS232/485 TO ETH 软件设计手册
1. 产品概述
1.1. 产品简介
RS232/485 TO ETH 是一款高端、经典的双串口服务器,是实现串口和以太网口之间数据双向透明转发的设
备,采用 Cortex-M4 方案,主频高达 120MHz,支持 RS232 和 RS485 同时工作。串口一侧实现串口数据的透明
传输,以太网口一侧则是 TCP/IP 数据包,内部包含精心优化过的 TCP/IP 协议栈,通过简单设置即可指定工作
细节。
RS232/485 TO ETH 方便工业场合使用,板载 RS232&RS485 收发指示灯,方便客户调试过程中查看问题。
本系列产品已经经过严格考验,在银行、公路、大型公司网络、有摄像头的繁忙网络以及通过光纤转以太
网等组建的复杂网络环境均有成功应用。
1.2. 规格参数
表 1
电气参数
分类
参数
数值
工作电压
工作电流
网口规格
硬件参数
DC 5.0~36.0 V
86.5mA@5.0V
RJ45、10/100Mbps、交叉直连自适应
串口波特率
600~230.4K(bps)
网络协议
IP、TCP、UDP、DHCP、DNS、HTTP、ARP、ICMP、Web socket
IP 获取方式
静态 IP、DHCP
域名解析
用户配置
支持
软件配置,网页配置,AT 指令配置
简单透传方式
TCP Server/TCP Client/UDP Server/UDP Client
Modbus
支持 Modbus 网关
网页转串口
支持 WebSocket 通信方式的网页转串口
软件参数
Httpd Client
类 RFC2217
自定义网页
网络缓存
串口缓存
支持
支持
支持
发送:16Kbyte;接收:16Kbyte;
发送:2Kbyte;接收:2Kbyte;
平均传输延时
局域网内<10ms
配套软件
可靠等级
尺寸
工作温度
存储温度
工作湿度
存储湿度
其他
虚拟串口软件、透传云测试软件、参数设置软件
1.5KV 电磁隔离
81.5x84.0x24.0 mm(L*W*H)
-40~85℃
-40~105℃
5%~95% RH(无凝露)
5%~95% RH(无凝露)
深圳市微雪电子有限公司
第 6 页 共 68 页
www.waveshare.net
RS232/485 TO ETH 软件设计手册
2. 产品功能
本章介绍一下 RS232/485 TO ETH 所具有的功能,下图是 RS232/485 TO ETH 的功能的整体框图,可以帮
助您对产品有一个总体的认识。
2.1. 默认参数
图 1 RS232/485 TO ETH 功能框图
表 2 设备默认参数
项目
用户名
密码
RS232/485 TO ETH 的 IP 地址
RS232/485 TO ETH 的子网掩码
RS232/485 TO ETH 的默认网关
RS232/485 TO ETH 端口 1 默认
的工作模式
RS232/485 TO ETH 端口 1 默认
的本地端口
串口波特率
串口参数
内容
Admin
Admin
192.168.0.7
255.255.255.0
192.168.0.1
TCP Server
23
115200
None/8/1
深圳市微雪电子有限公司
第 7 页 共 68 页
www.waveshare.net
RS232/485 TO ETH 软件设计手册
2.2. 基础功能
2.2.1. IP 地址/子网掩码/网关
1.
IP 地址是模块在局域网中的身份表示,在局域网中具有唯一性,因此不能与同局域网的其他设备重复。
RS232/485 TO ETH 的 IP 地址有静态 IP 和 DHCP 两种获取方式。
静态 IP
静态 IP 是需要用户手动设置,设置的过程中注意同时写入 IP、子网掩码和网关,静态 IP 适合于
需要对 IP 和设备进行统计并且要一一对应的场景。设置时注意 IP 地址、子网掩码、网关的对应关系。
使用静态 IP 需要对每个模块进行设置,并且确保 IP 地址在该局域网内和其他网络设备不重复。
DHCP
DHCP 主要作用是从网关主机动态的获得 IP 地址、Gateway 地址、DNS 服务器地址等信息,从而
免去设置 IP 地址的繁琐步骤。适用于对 IP 没有什么要求,也不强求要 IP 跟模块一一对应的场景。
注:RS232/485 TO ETH 在直连电脑时不能设置为 DHCP,一般电脑不具备 IP 地址分配的能力,如果 RS232/485
TO ETH 设置为 DHCP 直连电脑,会导致 RS232/485 TO ETH 一直处于等待分配 IP 地址的状态,进而导致
RS232/485 TO ETH 不能进行正常的透传工作。RS232/485 TO ETH 默认是静态 IP:192.168.0.7。
表 3
DHCP 静态 IP 优缺点对比
优点
缺点
IP 获取
方式
静态 IP
能够使 IP 和 RS232/485 TO ETH 一一对应,
无论什么环境都能快速搜索到模块
直接接入有 IP 分配能力的设备,如路由器,
就能获得正确的 IP,子网掩码和网关等网络
参数,进而实现网络通信,可以做到傻瓜式
DHCP
的即插即用。
需要根据接入网络的不同而调整 IP 地址,需要
设置正确的网关,对设置 IP 地址的人有一定的
技术要求。
如果 RS232/485 TO ETH 连接到没有 IP 分配功能
的网络内,比如和电脑直连,此时 RS232/485 TO
ETH 将无法进行正常工作。
2. 子网掩码是一个 32 位地址,用于屏蔽 IP 地址的一部分以区别网络标识和主机标识,并说明该 IP 地址是在
局域网上,还是在远程网上。子网掩码不能单独存在,它必须结合 IP 地址一起使用。我们常用的 C 类子
网掩码:255.255.255.0,子网内 IP 地址个数为 2 的 8 次方减 2,即 256-2=254 个,一般主机地址全为 0 或
者 1(二进制)有其特殊的作用。
3. 网关是指模块当前 IP 地址所在网络的网络号。如果连接外网时接入路由器这类设备,则网关即为路由器 IP
地址,如果设置错误则不能正确接入外网,如果不接路由器这类设备,则不需要设置,默认即可。
4. 参考 AT 指令集
指令名称 描述
表 4
静态 IP/DHCP AT 指令
AT+WANN 设置和查询 RS232/485 TO ETH 的 IP 获取方式,IP/子网掩码/网
5. 设置软件:
关参数
深圳市微雪电子有限公司
第 8 页 共 68 页
www.waveshare.net