查看“RS232 ETH PRO”的源代码

{{Product
|images=[[File:RS232 ETH PRO_示意图.png|400px]]
|categories=
{{Category|RS232}}
{{Category|ETH}}
|brand=丢石头
|features=
* RS232 ETH PRO
|interfaces=
{{Category|RS232接口}}
{{Category|ETH接口}}
|related=
* [[USB ETH]]
* [[TTL ETH]]
* [[TTL ETH PLUS]]
* [[RS232 ETH PLUS]]
* [[RS485 ETH PLUS]]
* [[RS232 ETH PRO]]
* [[RS485 ETH PRO]]
}}
== 产品介绍 ==
* RS232 ETH PRO是实现RS232串口和以太网口之间数据双向透明转发的设备，其网络通讯方式为以太网。串口速率从 110~460.8kbps 可配置。也可以进行简单的 加密、边缘计算等功能。具有集成度高、性价比高、开发简单、稳定性强、低功耗等特点。板载信号隔离与电源隔离，较宽的工作电压输入，方便工业场合使用；同时板载RS232 收发指示灯，方便客户调试过程中查看问题。 

== 产品特点 ==
* 工作电压：5-32V
* 采用原装芯片YOXO1007.内部自带以太网介质传输层（MAC）和物理层(PHY)。
* 可实现RS232串口数据和RJ45网口数据的双向透明传输。通讯稳定可靠，支持全双工、高速率、长时间数据转发，不丢包。支持用户在串口和网口同时不间断发送大批量数据，在发送时无需停顿，且不丢失数据。
* 支持 MDI/MDIX 线路自动转换,即交叉直连网线任意连接，自动切换。
* 支持DHCP自动获取IP地址，支持 DNS 域名访问，支持无数据重启功能。
* 串口波特率支持：300bps ～ 460800bps。
* 支持TCP服务端、TCP客户端，UDP模式，UDP组播。
** 作为TCP客户端的时候同时支持TCP服务器端功能。
** 作为TCP服务器支持10个TCP客户端连接。
** 作为TCP客户端支持7个目的IP.
* 支持虚拟串口，配备 Windows 虚拟串口&设备管理工具 ZLVircom。
** 使用虚拟串口时，支持 On-the-fy 技术的串口参数自适应。
** 虚拟串口驱动支持 WIN10 和 64 位操作系统。
** 虚拟串口驱动稳定可靠，可全双工连续不断发送不丢1字节。
** 虚拟串口模式下，支持断网重连功能。
* 配备 Windows 工具 ZLVircom，一键式搜索局域网设备，手动可添加 Internet 上的设备。
* 支持 Modbus TCP 转 RTU 的 Modbus 网关功能。
* 支持支持 Modbus RTU/DLT645 转 JSON。
* 支持 MQTT 连接、支持各类公有云数据传输等特性。
* 支持自定义心跳包和注册包功能:可以方便和云端进行通信和设备识别。
* 板载数字隔离器，具有出色的性能特征和可靠性，可进行信号隔离，使传输的信号更加稳定。                                 
* 板载DC/DC电源隔离，可提供稳定的隔离电压以及输出短路保护，隔离端无须额外供电。
* 板载四种指示灯：
** 电源指示灯（红色）：只要电源连接正常，指示长灯亮。
** 运行指示灯（黄色）：芯片工作正常后，指示灯闪烁。
** TX发送指示灯（绿色）：RJ45网口接收数据时闪烁。
** RX接收指示灯（蓝色）：RS232接口接收数据时闪烁。
* 宽温度范围:支持-40~85℃
* 配套软件齐全。配备 Windows 设备管理工具 ZLVircom，一键式搜索联5.1网模块，修改参数。配备 UDP/TCP 调试工具。配备串口调试工具。
* 提供上位机开发例子程序包括:VC、VB、Delphi、C++Builder、Java、C#例程。也可提供一个 DLL库，可通过网口直接和联网模块通信。

== 产品测试 == 
=== 硬件准备 ===
* 网线 一根
* 电脑 一台
* USB转RS232模块或RS232串口线 一个
* RS232 ETH PRO 一个 
* 5-32V范围内电源模块 一个

=== 测试环境 ===
为了防止用户在应用中出现搜索不到、ping 不通、还有打不开网页等问题。在硬件连接好 之后，使用之前，先对电脑进行如下内容的检查。
* 关闭电脑的防火墙和杀毒软件（一般在控制面板里）以及如果下载了安全卫士等软件需要一并关闭。
* 检查硬件连接是否无误，如网口连接是否牢固、网线能否正常使用等。
* 检查电脑的IP地址的与模块的IP地址是否在同一个网段。

=== 默认配置 ===
*[[File:ETH PRO_默认配置.png|800px]]

=== 硬件连接 ===
==== 与电脑直连 ====
*将RS232 ETH PRO模块的RJ45接口通过网线与计算机的网口相连。
*将RS232 ETH PRO模块的RS232接口通过USB转RS232模块或RS232串口线与计算机相连（2脚接TX，3脚接RX，5脚接GND）。
*将电源模块接入RS232 ETH PRO模块的电源接口，进行供电，供电电压5-32V。
*此时能看见PWR红灯常亮，RUN黄灯闪烁。
*[[File:ETH PRO_硬件连接232——1.png|600px]]

==== 接入路由器或交换机 ====
*将RS232 ETH PRO模块的RJ45网口和电脑的网口通过网线接入同一路由器网口或交换机网口中。
*将RS232 ETH PRO模块的RS232接口通过USB转RS232模块或RS232串口线与计算机相连（2脚接TX，3脚接RX，5脚接GND）
*将电源模块接入RS232 ETH PRO模块的电源接口，进行供电，供电电压5-32V。
*此时能看见PWR红灯常亮，RUN黄灯闪烁。
**[[File:ETH PRO_硬件连接232——2.png|600px]]

=== 修改模块配置 ===
*下载[[:File:ZLVirCom6.93 虚拟串口和设备管理工具.zip|ZLVircom]]，解压后打开ZLVirCom6.93.exe
**[[File:ETH PRO_模块配置1.png|600px]]
*点击 设备管理 ，在设备管理内选择 自动搜索，左侧的框内则会出现设备信息。
**[[File:ETH PRO_模块配置2.png|600px]][[File:ETH PRO_模块配置3.png|600px]]
* 双击设备信息，则会弹出设备详细参数。此处需要修改模块IP地址为192.168.0.200（也可更换为其他IP，需要注意的是设置的IP未被分配且IP需与电脑IP属于同一频段），模块网关为192.168.0.1，点击修改设置
**[[File:ETH PRO_模块配置4.png|600px]]
* 等待模块修改成功后，再次点击自动搜索，观察模块IP是否修改正确。
**[[File:ETH PRO_模块配置5.png|600px]]

=== 修改电脑IP地址 ===
*控制面板（文件资源管理器）->网络和 Internet->网络和共享中心->连接双击网卡->属性->Internet 协议版本 4(TCP/IPY4)->属性->使用下方的IP地址，配置好电脑的IP地址、子网掩码和默认网关后点击确认。
**IP地址：设置为和模块同频段的IP。这里设置为192.168.0.5（也可更换为其他IP，需要注意的是设置的IP未被分配且IP需与模块IP属于同一频段）
**子网掩码：使用默认的即可。
**默认网关：根据IP地址设置对应的网关。此处设置为192.168.0.1
**[[File:ETH_产品测试1.png|600px]]
**[[File:ETH PRO_电脑IP1.png|900px]]

*设置完成后，可通过控制面板（文件资源管理器->网络和 Internet->网络和共享中心->连接双击网卡->详细信息，查看电脑IP是否设置成功。
**[[File:ETH_产品测试1.png|800px]]
**[[File:ETH PRO_电脑IP2.png|800px]]

=== TCP/IP通信测试 ===
*打开[[:File:串口调试助手.zip|串口调试助手]]或[[:File:Comdebug串口调试工具.zip|Comdebug串口调试工具]]，选择对应的端口（可通过设备管理器查看）,设置好串口波特率（模块默认为9600）、停止位（默认为1）、数据位（默认为8）和校验位（默认为None）,打开串口。
**[[File:ETH PRO_TCP测试1.png|600px]]
**[[File:ETH PRO_TCP测试2.png|900px]]或[[File:ETH PRO_TCP测试3.png|600px]]
*打开[[:File:网络调试助手.rar|网络调试助手]]，配置好网络参数，点击打开，建立连接。
**协议类型：根据模块的工作模式进行配置。'''此处模块默认工作模式为TCP Server，故协议类型设置为TCP CLIENT。'''
**本地主机地址：根据上面配置电脑IP地址进行设置。'''此处电脑IP为192.168.0.5。'''
**远程主机地址/目的IP：根据配置模块时的IP地址进行设置。'''此处模块IP为192.168.0.200。'''
**目的端口：根据模块的实际端口号进行设置。'''此处模块端口号为默认端口号4196。'''
**[[File:ETH PRO_TCP测试4.png|600px]]或[[File:ETH PRO_TCP测试5.png|600px]]
*分别使用网络调试助手和串口调试助手发送数据，查看另一端是否正确接收数据。
**[[File:ETH PRO_TCP测试6.png|800px]]
**[[File:ETH PRO_TCP测试7.png|800px]]

=== 虚拟串口测试 ===
*上述TCP/IP通信测试主要是通过TCP 和串口服务器直接通信的。为了能够让用户已有开发好的串口软件也能和串口服务器通讯，需要在用户程序和串口服务器之间增加一个虚拟串口。即ZLVircom 和用户程序在一台计算机上运行，ZLVircom 虚拟一个 COM 口，让这个 COM 口对应这个串口服务器。当用户程序打开 COM 通讯时可以通过 ZLVircom→串口服务器→发到用户串口设备。具体操作如下：
*点击 ZLVirCom5.63 虚拟串口和设备管理工具 文件下的virtual-serial-port-control-64bit3.6.2.msi 进行安装。
**[[File:ETH PRO_虚拟串口测试1.png|800px]]
*安装完成后再次打开ZLVircom6.93.exe软件，点击 ZLVircom 主界面的“串口管理”,然后点击“添加”，选择添加 COM口，注意这里选择的COM口是计算机原来不存在的 COM 口。此处选择COM2
**[[File:ETH PRO_虚拟串口测试2.png|600px]]
*然后进入设备管理，并双击需要和COM2绑定的设备。在左上角的“虚拟串口”列表中选择 COM5。然后点击“修改设置”。
**[[File:ETH PRO_虚拟串口测试3.png|600px]]
**如果出现“参数内容没有修改，所以修改参数命令没有执行，”的警告，点击确认即可
**[[File:ETH PRO_虚拟串口测试4.png|600px]]
*等待修改完成后，返回 ZLVircom的主界面。可以看到 COM2 已经和ip地址为 192.168. 0.200 的设备联通了。此时可以使用 COM2 代替网络调试助手进行通信。
**[[File:ETH PRO_虚拟串口测试5.png|600px]]
*分别打开两个串口助手来模拟用户的串口程序，其中一个打开网口连通的虚拟串口COM2，另一个打开模块RS232端连接的出USB转485模块连接到PC端后显示的串口，这里是COM12。此时 COM2 发送数据链路如下:COM2-ZLVircom>串口服务器网口→串口服务器串口→COM12。反之，COM12 到 COM2 也能传输数据:COM12>串口服务器串口→串口服务器网口→ZLVircom→COM2。如果将 COM12换为用户串口设备，则COM2 可以实现和用户设备的通讯。
**[[File:ETH PRO_虚拟串口测试6.png|800px]]

===  Modbus TCP测试 ===
*默认情况下，串口和网口数据是透明传输的。如果需要实现 Modbus TCP 转Modbus RTU，则需要在ZLVircom设备设置对话框中将转化协议选择为“Modbus TCP←>RTU”。此时设备端口自动变为 502，此时用户的 Modbus TCP 工具连接上串口服务器的 IP 的 502 端口，发送的 Modbus TCP 指令将会转化为 RTU 指令从串口输出。
**比如串口服务器网口收到 00 00 00 00 00 00 06 01 03 00 00 00 0a 的Modbus TCP 指令，则串口输出 01 03 00 00 00 0ac5 cd 的指令。
**注意:串口可能会发送多条 0103 00 00 00 0a c5 cd 指令,这是因为默认的 Modbus 采用存储型方式，会自动轮训查询指令。
**[[File:ETH PRO_Modbus测试1.png|600px]]
*如果用户的 Modbus TCP 软件是作为从站(Slave)，则需要在选择转化协议基础上，再将工作模式改为客户端，目的IP改为 Modbus TCP 软件所在计算机IP, 目的端口为 502。
**[[File:ETH PRO_Modbus测试2.png|600px]]

== 软件安装 ==
* ZLVircom 可用于设备 IP 等参数的配置，以及创建虚拟串口。如果无需虚拟串口功能，则可以下载免安装版本。2ZLVircom 版共有四版：
** ZLVircom（含虚拟串口）]]
** ZLVircom（不含虚拟串口）
** ZLVircom（安卓版）
** ZLVircom（英文版）
**安装时按照默认提示安装即可。安装完毕后会在每次计算机启动时启动zlvircom，用于开机创建虚拟串口。
*串口调试助手是计算机上和COM口通信的一个工具。是实现发送、接收这些串口设备数据的软件。一般也能够支持十六进制发送和接收。我们共提供了三款串口调试助手，使用时选择任意一款即可
**ComDebug(V1.26)：
**XCOM
**sscom
*TCP/IP调试助手是用于在TCP/UDP的应用层上进行通信连接、数据传输的Windows工具。所谓应用层上就是说，TCP调试工具是不涉及TCP/IP协议层实现的问题，而只是利用TCP/IP进行数据传输。从另外一个角度讲，它是将BSD socket的接口的每个函数都让用户可以通过界面进行独立的调用。比如用于TCP连接的connect，变为“连接”按钮；比如发送数据的send函数变为“发送”按钮。我们共提供了两款网络调试助手，使用时选择任意一款即可
** SocketDlgTest(V3.49)
** 网络调试助手

== 参数配置 ==
=== 软件配置 ===
==== ZLVircom主界面 ====
*可在此界面创建虚拟串口
*[[File:ETH PRO_软件配置1.png|600px]]

==== 设备列表 ====
*从设备列表中看到当前所有在线的设备。选中需要查看或修改参数的设备，双击或点击“编辑设备”可进行对参数的配置。
*[[File:ETH PRO_软件配置2.png|600px]]

==== 设备参数设置 ====
*[[File:ETH PRO_软件配置3.png|600px]]
*在这个界面中，用户可以设定设备的参数，然后点击“修改设置”，则参数被设置到设备的 flash 中，掉电不丢失。同时设备会自动重启。
*参数详细含义如下:
**虚拟串口：可设置为不使用和创建的虚拟串口。
***可以将当前设备与某个已创建的虚拟串口绑定，需先在主界面的“串口管理”添加 COM 口。
**设备型号：只显示核心模块的型号。
**设备名称：可任意设置。
***主要用作给设备起一个易读的名字，最长为9个字节，支持中文名字。
**设备ID：出厂唯一ID，不可修改。
**固件版本：核心模块的固件版本，
**该设备支持的功能：
***网页下载：支持通过网页来控制串口输出指令，'''本产品不支持'''。
***域名系统：目的 IP 可以为域名(比如开头的 www 服务器地址)。
***REAL COM 协议：一种非透传的串口服务器协议,适合于多串口服务器通过 Internet进行虚拟串口的绑定。因为协议内部含有设备 MAC地址所以有助于上位机识别设备。一般情况下可以不使用。
***Modbus TCP 转 RTU'：可以实现 Modbus TCP 转 RTU。同时也支持多主机功能。
***串口修改参数：支持串口类 AT 指令进行设备参数的配置和读取。
***自动获取 IP：支持 DHCP 客户端协议
***存储扩展 EX 功能：后续扩展，'''暂不支持'''
***多 TCP 连接：作为 TCP 服务器的时候文持多个 TCP 连接。
**IP模式：可设置为静态和DHCP
***用户可以选择静态或 DHCP(动态获取 IP)
**IP地址：串口服务器的IP地址
**端口：可设置为0~65535
***串口服务器处于 TCP Server 或 UDP 模式时的监听端口。
***串口服务器作为客户端时，最好指定端口为0端口，有利于提高连接速度。当使用0端口时系统将随机分配一个本地端口。此时和非零端口的区别是：本地端口为0时，模块重启时和PC机重新建立一个新的 TCP 连接，老的 TCP 连接可能不会被关闭，和设备可能存在多个假连接，这样TCP 重新建立连接的时间较快。一般上位机希望在模块重启时关闭老的连接;指定非零端口会关闭老连接。
***串口服务器处于TCP 客户端模式同时作为TCP 服务器在端口监听进来的连接时。此时，TCP客户端连接到服务器所使用的本地端口号是“端口+1”
**工作模式：可设置为TCP 服务器模式、TCP客户端模式、UDP 模式、UDP 组播
***设置为 TCP 服务器时，串口服务器等待计算机连接
***设置为TCP客户端时，串口服务器主动向目的 IP 指定的网络服务器发起连接。
**子网掩码：必须与本地局域网的子网掩码相同，例如：255.255.255.0。
**网关：必须与本地局域网网关相同，比如：192.168.1.1。
**目的IP或域名：在 TCP 客户端或 UDP 模式下，数据将发往目的IP 或域名指示的计算机。
**目的端口：在 TCP 客户端或 UDP 模式下，数据将发往目的IP 的目的端口。
**波特率：串口波特率，可设置300 ~ 912600bps
**数据位：可设置5、6、7、8
**校验位：可设置无、偶校验、奇校验、标记、空格
**停止位：可设置1、2
**流控：仅对RS232有效。可设置：无流控、硬流控CTS/RTS、硬流控DSR/DTR、软流控XON/XOFF
**DNS 服务器IP：当目的IP 以域名描述时，需要填写这个 DNS 服务器 IP。在 IP 模式为 DHCP 时，不用指定 DNS服务器，它将会自动从 DHCP 服务器获取。**
**目的模式：可设置为静态、
***TCP 客户端模式下，使用静态目的模式后，设备连接服务器连续5次失败后会自动重启设备。
**转化协议：可设置无、Modbus TCP协议、Real_COM协议
***无：表示串口到网络的数据转发是透明的。
***Modbus TCP协议： 将会把 Modbus TCP 协议直接转化为Modbus RTU 协议，方便与 Modbus TCP 协议配合: 
***RealCOM协议：是为了兼容老版本 REAL COM协议而设计的，是虚拟串口方式的一种协议，但是使用虚拟串口时，并不一定需要选择 RealCom协议。--
**保活定时时间：心跳间隔。设置范围0~255。
***设置为1~255：如果设备处于 TCP 客户端模式，则会自动每隔“保活定时时间”发送 TCP 心跳。这可以保证链路的TCP 有效性。设置为 0时，将无 TCP 心跳。
***设置为0~254：当转化协议选择为REALCOM 协议时，每隔“保活定时时间”设备将会发送一个长度为1内容为0的数据，实现Realcom 协议中的心跳机制。设置为 255 时将无realcom 心跳。
***设置为0~254 ：如果设备工作于 TCP 客户端，设备将每隔“保活定时时间”将发送设备参数到目的计算机。设置为255 时将无参数发送功能，可以实现远程设备管理。
**断线重连时间：设置范围0~255。
***处于 TCP 客户端模式时，当未连接成功时，每隔“断线重连时间”向计算机重新发起 TCP 连接。可以为 0~254秒，如果设置255，则表示永远不进行重连。注意第一次 TCP 连接(比如硬件上电、通过 zlvircom 软件重启设备、无数据灯是)一般会马上进行，只有第一次连接失败后才会等待“断线重连时间”后重新尝试，所以“断线重连时间”不会影响网络和服务器正常情况下的连接建立时间。
**网页访问端口：设置范围1~65535，默认为80。
**所在组播地址：UDP 组播时用到
**启用注册包：当 TCP 连接建立时，向计算机发送该注册包。启用注册包之后必须选择realcom 协议。支持TCP 服务器和 TCP 客户端方式。
**数据包长度：设置范围1~1400。
***串口分帧规则之一。串口服务器串口在收到该长度数据后，将已接收数据作为一帧发送到网络上.-
**数据包间隔：设置范围0~255。
***串口分帧规则之二。当串口服务器串口接收的数据出现停顿，且停顿时间大于该时间时，将已接收的数据作为一帧发送到网络上。

==== 更多高级选项 ====
*[[File:ETH PRO_软件配置4.png|600px]]
*WIFI参数：'''本产品不支持'''。
*支持的高级功能
**IO 端口控制：支持任意自定义指令来控制8个I0输出。'''本产品不支持'''。
**UDP 组播：UDP 组播
**多目的 IP：作为 TCP 客户端的时候支持同时连接7个目的 IP。
**代理服务器：支持代理服务器功能。'''本产品不支持'''。
**SNMP 功能：支持 SNMP 转 Modbus RTU 协议。只有尾缀为-SNMP 的才支持该功能。'''本产品不支持'''。
**P2P 功能：支持通过P2P 穿越技术实现对任意网络中的设备的访问的功能尾缀为N 的型号支持该功能。'''本产品不支持'''。
*Modbus多主机功能设置：详见[[:File:ZLSN3007S.pdf|ZLSN3007S模组]]内的'''章节9.4'''
*多目的IP和端口设置：串口服务器作为 TCP 客户端的时候可以同时连接7个目的 IP 地址,串口发送的数据会同时发送到7个目的IP。如果没有那么多服务器，则空缺其余的目的 IP。
**其中第一个IP地址在'''设备参数设置界面'''中的目的IP或域名和目的端口处；
**剩下的2-7个目的IP在此处设置。所有的 7 个目的 IP 设置完毕后可以自动进行连接，如果连接不上则会等待 “断线重连”时间后反复重连。
*功能选择和启用：
**修改参数需密码
**允许接收广播数据
**启用P2P功能
**TCP建立时发送设备IP
**Ping检测到断网则设备重启
**TCP建立时不清空串口
**TCP建立需要密码验证

== 协议说明 ==
*串口服务器的使用基本分为两种:带虚拟串口和非虚拟串口。
**带虚拟串口方式需要对接的用户软件是串口接口的(COM口)，即用户软件和用户设备都是串口。
**非虚拟串口的方式用户软件是直接 TCP/IP 通讯的但是用户设备仍然是串口的。
*转化协议分为透明传输、ModbusTCP转 RTU 和 Realcom 协议3种方式。其中：
**如果用户软件是固定协议的 Modbus TCP 协议而下位机是 Modbus RTU 时，需要选择 Modbus TCP 转 RTU 方式。
**Realcom协议目前只在多串口服务器作为 TCP 客户端连接某个服务器，且服务器上使用虚拟串口的时候用。
*具体网络配置模式及适用情况如下所示：
*[[File:ETH PRO_协议.png|1200px]]


== 软件 ==
* [[:File:网络调试助手.zip|网络调试助手]]
* [[:File:串口调试助手.zip|串口调试助手]]
* [[:File:Comdebug串口调试工具.zip|Comdebug串口调试工具]]
* [[:File:ZLVirCom6.93 虚拟串口和设备管理工具.zip|ZLVircom（含虚拟串口）]]
* [[:File:ZLVirCom6.93 不含虚拟串口.zip|ZLVircom（不含虚拟串口）]]
* [[:File:安卓版ZLVircom.zip|ZLVircom（安卓版）]]
* [[:File:ZLVirCom6.93 English version.zip|ZLVircom（英文版）]]

== 数据手册 ==
* [[:File:YOXO1007.pdf|YOXO1007芯片]]
* [[:File:ZLSN3007S.pdf|ZLSN3007S模组]]

== 参考资料 ==
* [[:File:固件升级方法.pdf|固件升级方法]]
* [[:File:串口修改参数和控制方法.pdf|串口修改参数和控制方法]]
* [[:File:网口搜索协议UDP管理端口协议.pdf|网口搜索协议UDP管理端口协议]]
* [https://www.zlmcu.com/document/tech_dll_demo.html 联网模块的设备管理函数库DLL的使用]
* [[:File:YOX01007资料开发包SDK.rar|YOX01007资料开发包SDK]]

<!--{{Join_us}}-->
</div>

== FAQ ==
<div class="tabbertab" title="FAQ">

</div>
<div class="tabbertab" title="售后"><br />{{Service11}}</div>
F