【ESP32系列】WT32-ETH01开发板上手指南

WT32-ETH01 是深圳市启明云端有限公司推出的基于 ESP32 系列的嵌入式串口转以太网模块，模块内部集成了优化过的 TCP/ IP 协议栈，便于用户轻松的完成嵌入式设备的联网功能，大大减少了开发时间成本。并且，模块兼容半焊盘和连接器通孔设计，板宽是通用宽度，可以直接把模块焊接在板卡上，也可焊接连接器，也可用于面包板上，方便用户使用于不同的场景。

ESP32系列IC是集成了2.4GHz Wi-Fi和蓝牙双模的SOC ，具有超高的射频性能、稳定性、通用性和可靠性，以及超低的功耗。

特性

表-1. 产品规格

硬件规格

1

系统框图

图-1 系统框图

2

实物图

图-2 产品实物图

3

引脚描述

表-1 调试烧录接口

表-2 模块 IO 描述

注 1 ：模块默认使能高电平。

注 2 ：3V3 电源供电和 5V 电源供电，二者只能选择其一！！！

注 3 ：IO39 、IO35 和 IO36 仅支持输入。

4

电源特性

01

供电电压

模块的供电电压可选用 5V 或 3V3 ，二者只能选择其一。

02

供电模式

用户可根据需求自由选择：

1) 通孔（焊接排针）：

采用杜邦线连接的方式供电；

采用面包板连接的方式供电；

2) 半焊盘（直接焊接在板卡）：用户板卡供电。

使用说明

1

上电说明

若采用杜邦线的方式：找到 3V3 或 5V 电源输入口，连接对应的电压，指示灯（LED1）亮起，表示上电成功。

2

指示灯说明

LED1：电源指示灯，上电正常，灯亮；

LED3：串口指示灯，RXD2(IO5)有数据流时，灯亮；

LED4：串口指示灯，TXD2(IO17)有数据流时，灯亮；

1

使用方式说明

三种使用方式，用户可根据需求， 自行选择：

通孔（焊接排针）：使用杜邦线连接；

通孔（焊接排针）：放在面包板上使用；

半焊盘：用户可直接将模块焊接在自己的板卡上。

4

网口工作指示灯说明

表-3 网口工作指示灯描述

接口说明

产品功能

1

默认参数

2

基本功能

01

设置 IP/子网掩码/网关

IP 地址是模块在局域网中的身份表示，在局域网中具有唯一性，因此不能与同局域网的其他设备重复。模块的 IP 地址有静态 IP 和 DHCP/动态 IP 两种获取方式。

a. 静态 IP

静态 IP 是需要用户手动设置，设置的过程中注意同时写入 IP 、子网掩码和网关，静态 IP 适合于需要对 IP 和设备进行统计并且要一一对应的场景。设置时注意IP 地址、子网掩码、网关的对应关系。使用静态IP 需要对每个模块进行设置，并且确保 IP 地址在该局域网内和其他网络设备不重复。

b. DHCP/动态 IP

DHCP/动态 IP 主要作用是从网关主机动态的获得 IP 地址、Gateway 地址、DNS 服务器地址等信息，从而免去设置 IP 地址的繁琐步骤。适用于对 IP 没有什么要求，也不强求要 IP 跟模块一一对应的场景。

注：模块在直连电脑时不能设置为 DHCP ，一般电脑不具备 IP 地址分配的能力，如果模块设置为 DHCP 直连电脑，会导致模块一直处于等待分配 IP 地址的状态，进而导致模块不能进行正常的透传工作。模块默认是静态 IP：192.168.0.7。

子网掩码主要用来确定 IP 地址的网络号和主机号，表明子网的数量，判断模块是否在子网内的标志。子网掩码必须要设置，我们常用的 C 类子网掩码：255.255.255.0 ，网络号为前 24 位，主机号为后 8 位，子网个数为 255 个，模块 IP 在 255 个范围内，则认为模块IP 在此子网中。

网关是指模块当前 IP 地址所在网络的网络号。如果连接外网时接入路由器这类设备，则网关即为路由器IP 地址，如果设置错误则不能正确接入外网，如果不接路由器这类设备，则不需要设置，默认即可。

02

恢复出厂设置

AT 指令恢复出厂设置：通过 AT+ RESTORE 恢复出厂。

硬件方式恢复出厂设置：CFG 脚接地，重启模块。

03

固件升级

模块升级固件的方式是 OTA 远程升级，通过升级固件，可以获取更多应用功能。

固件升级可通过有线网路或 wifi 两种方式连接网络。

操作 GPIO2 接地，重启模块，进入 OTA 升级模式。

升级完成，断开 GPIO2 对地的连接，重启模块，模块进入正常工作模式。

OTA 固件升级指示说明：正在下载固件，串口 TXD 指示灯快闪；下载完成正在升级，串 口 TXD 指示灯常亮；升级成功，串 口 TXD 和 RXD 指示灯常亮；升级失败串口 TXD 指示灯慢闪。

04

AT 指令功能设置

用户通过串口，输入 AT 指令，可以对模块进行功能设置。

详细请参考 esp32 有线模块 AT 指令集。

05

数据透传功能

模块有四个数据传输端口分别为：串 口、wifi 、以太网和蓝牙。

用户可以通过 AT 指令，对四个数据端口进行两两组合，进行数据透传。

通过 AT+PASSCHANNEL 指令设置/查询模块的透传通道。设置完成，需要重启模块才能生效。

3

socket 功能

模块的 Socket 工作模式共分为 TCP Client 、TCP Server 、UDP Client 、UDP Server 四种，可通过 AT 指令进行设置。

AT 指令操作请参考esp32 有线模块 AT 命令例程v1.2。

01

TCP Client

TCP Client 为 TCP 网络服务提供客户端连接。主动向服务器发起连接请求并建立连接，用于实现串口数据和服务器数据的交互。根据 TCP 协议的相关规定，TCP Client 是有连接和断开的区别，从而保证数据的可靠交换。通常用于设备与服务器之间的数据交互，是最常用的联网通信方式。

模块作为 TCP Client 连接 TCP Server 时，需要关注目标IP/域名和目标端口号等参数， 目标 IP 可以是本地同一局域的设备，也可以是不同局域网的 IP 地址或者跨公网的 IP ，如果连接跨公网的服务器，那么要求服务器具有公网 IP。

02

TCP Server

通常用于局域网内与 TCP 客户端的通信。适合于局域网内没有服务器并且有多台电脑或是手机向服务器请求数据的场景。同 TCP Client 一样有连接和断开的区别， 以保证数据的可靠交换。

03

UDP Client

UDP Client 一种无连接的传输协议，提供面向事务的简单不可靠信息传送服务，没有连接的建立和断开，只需要制定 IP 和端口即可将数据发向对方。通常用于对丢包率没有要求，数据包小且发送频率较快， 并且数据要传向指定的 IP 的数据传输场景。

04

UDP Server

UDP Server 是指在普通UDP 的基础上不验证来源IP 地址，每收到一个UDP 数据包后，都将目标 IP 改为数据来源 IP 和端口号，发送数据时，发给最近通讯的那个 IP 和端口号。

该模式通常用于多个网络设备都需要跟模块通信并且由于速度频率较快不想使用 TCP 的数据传输场景。

4

串口功能

01

AT 指令设置

用户通过串口，输入AT 指令，可以对模块进行功能设置。

02

透传串口数据

用户通过 AT 指令，使模块进入数据透传模式，模块通过已经设置的透传通道可以直接将串口数据传递到对应的数据传输端（wifi 、以太网和蓝牙）。

5

蓝牙功能

01

透传蓝牙数据

通过模块已有的蓝牙功能，模块可以获取蓝牙数据，通过已经设置的透传通道可以直接将蓝牙数据传递到对应的数据传输端（wifi 、以太网和串口）。

5

Wi-Fi功能

01

互联网接入

模块wifi 通过路由器接入互联网或局域网，用户通过 AT 指令配置 socket 功能，模块可以建立TCP/ UDP 连接，可以接入用户的指定服务器。

7

有线网口接入功能

通过有线网络可以获取稳定的网络连接，保证获取稳定的网络数据。

01

互联网接入

模块通过有线网络接入互联网或局域网，用户通过AT 指令配置 socket 功能，模块可以建立 TCP/ UDP连接，可以接入用户的指定服务器。