最近在做基于 STM32F407VET6 的数据采集设备需要让设备接入局域网通过 TCP 协议把采集数据上报给上位机。最先想直接用 F407 自带的以太网 MAC 外接 PHY再移植 lwIP 协议栈但评估下来发现工作量实在不小后来换成了 CH395Q 这颗内置协议栈的以太网控制芯片通过串口通信完成以太网客户端功能。这篇文章就是这次实干的完整复盘从硬件接线、CH395Q 串口协议帧到 STM32F407VET6 端的初始化与 TCP 收发代码再到实测中遇到的问题和解决办法。如果你手上有 CH395Q 模块或者正在纠结到底用什么方案给 MCU 加网络功能这篇内容可以直接拿来参考。1. 项目拆解一颗协议栈芯片解决了什么1.1 F407 本身能做以太网为什么要外挂 CH395QSTM32F407VET6 内部有以太网 MAC 模块这个很多人知道。理论上你可以外部接一颗 PHY 芯片比如 LAN8720A配合 RMII 接口和移植好的 lwIP就能跑 TCP/IP 网络。但做过这个方案的人都知道这条路并没有想象中顺利MAC 和 PHY 之间的时钟、中断、DMA 描述符都要调试lwIP 的内存池配置也是一大堆头文件、宏定义一旦发生内存溢出定位问题非常痛苦。CH395Q 这类芯片把 MAC、PHY、IP、TCP/UDP 协议栈全部封装在内部MCU 只需要通过串口或 SPI 发送命令帧芯片就帮你完成 ARP、IP、TCP 三次握手、数据重传这些底层动作。换句话说网络协议栈从“你写的代码”变成了“你调用的接口”产品代码量大幅减少稳定性反而更容易保证。对于只需要 TCP 客户端、数据量又不大的场景比如传感器数据采集、工业设备状态上报、简易物联网网关外挂 CH395Q 是一个性价比很高的方案。如果项目里跑的是大流量视频或者对实时性要求极高的数据那 F407 自带 MAC lwIP 可能更合适这也取决于具体业务。1.2 三种接口模式为什么我偏选串口CH395Q 支持多种 MCU 接口常见的包括 UART 串口、SPI 和 8 位并行接口。这三种模式各有各的定位并口速度最快适合大批量、高速率传输SPI 速度次之也够用串口速度最慢但接线最简单。我这次选串口原因很直接设备的上报数据量不大一帧数据几十个字节115200 波特率完全够用。串口只需要一根 TX 一根 RX加一根共地线换来的是代码逻辑极其简单不用去处理 SPI 的 NSS 片选时序也不用担心并口的数据线冲突。对单片机工程师来说UART 是最常用的外设也更容易定位问题。当然选串口有一个需要提前想清楚的点CH395Q 的串口接口不是那种用文本 AT 指令的模块而是二进制命令帧。每个命令、每个应答都要按照协议格式组包调试时可以用串口助手直接看十六进制数据这个习惯要提前养成。1.3 整条数据链路长什么样为了让你在写代码前就在脑子里有一张链路图我先描述一遍整体数据流向。STM32F407VET6 的串口发送一个“连接服务器”的命令帧给 CH395QCH395Q 解析后完成 TCP 三次握手。建立连接后单片机把业务数据打包成 CH395Q 命令帧发送CH395Q 把数据封装成 IP/TCP 报文通过内置 PHY 从 RJ45 网口发出。服务器回复的数据到了 CH395Q 后它拆包并解析出有效数据再通过串口主动上报给单片机。所以单片机的任务可以简化为两件事发送命令、解析接收帧。网络协议栈内部的复杂性都被 CH395Q 挡住了。2. 硬件接线与板级调试要点2.1 完整接线表我使用的是 STM32F407VET6 最小系统板加一个带 RJ45 网口的 CH395Q 模块。串口选用 USART1引脚是 PA9 和 PA10这两个引脚在大多数 F407 板子上都引出来了比较方便。接线表如下F407VET6引脚CH395Q模块引脚说明3V3VCC模块供电GNDGND共地PA9 / USART1_TXRX单片机发送CH395Q接收PA10 / USART1_RXTXCH395Q发送单片机接收PC13RST控制芯片复位低有效PB10INT可选事件中断输入注意CH395Q 的 RX、TX 与单片机是交叉连接的不要接成同向。如果你用其他串口引脚需要确认是不是 AF7 复用功能保证串口配置正确。模块上的 SEL 引脚用来选择接口模式不同模块的默认状态可能不一样。有的模块直接引出了 SEL 跳线有的可能在 PCB 内部就固定好了。必须确认当前模块工作在 UART 串口模式否则后续发命令全都不响应。2.2 复位时序上电后别急着发命令CH395Q 是一个片上系统上电后内部固件需要时间启动。这里非常关键的一点是SEL 引脚的电平状态是在复位上升沿被锁存的。也就是说你不能在运行中随意切换接口模式必须在复位前把 SEL 设置好然后复位一下芯片它才会进入对应模式。我习惯把 CH395Q 的 RST 引脚接到单片机的一个普通 GPIO 上由代码控制复位时序。上电后先延时 50ms然后在复位引脚上输出一段时间低电平再拉高再等待 100ms 左右。复位成功后CH395Q 会主动通过串口上报一组初始化完成的事件帧这个是判断芯片是否正常启动的重要依据。如果你没有接 RST 引脚只是让芯片靠 RC 上电复位那么芯片启动时间可能比单片机晚导致你在刚上电时发送的命令无人响应。建议程序初始化时加一个重试机制命令发送失败后延时重发或者直接使用 GPIO 控制复位。2.3 电平匹配和电源稳定CH395Q 默认工作电压是 3.3V逻辑电平也是 3.3V和 STM32F407 的 IO 电平一致可以直接互连。如果你的单片机是 5V 系统或者模块上有 5V 供电选项需要注意 TX、RX 信号线不要直接接 5V 单片机的引脚最好加电平转换芯片否则长时间工作容易损伤 CH395Q。电源方面我踩过一个坑一开始把 CH395Q 模块和电机驱动共用一个电源电机会导致电压波动模块出现不定期的 Ping 不通。后来换成独立的 LDO 单独给模块供电问题就消失了。网络通信是高频率信号处理对电源纹波比较敏感供电质量会直接影响网络稳定性。3. CH395Q 串口命令帧与以太网客户端流程3.1 命令帧和应答帧的基本结构CH395Q 的串口通信是二进制帧格式不是文本协议。每一帧通常包含命令码、数据长度、参数数据和可能的校验字段具体定义以你手里芯片版本的官方数据手册和编程手册为准。不同版本的固件对命令码的定义基本一致但细节要以手册为准免得到时候照着别人代码写出来却不对。我在代码里用的结构体大概是这个意思typedef struct { uint8_t cmd; // 命令码 uint8_t len; // 参数长度 uint8_t data[16]; // 参数数据 } CH395_FRAME;MCU 下发一个设置命令比如设置 MAC 地址就是把命令码、长度和 MAC 数据组好通过串口发送给 CH395Q。CH395Q 执行完成后会返回一个应答帧帧里面包含原命令码和一个状态字节告诉 MCU 这个命令执行成功了还是失败了。这里要特别区分两种帧一种是“你发一条命令它回一条应答”这是同步的另一种是芯片主动上报的事件帧比如连接成功、数据到达、断开连接这是异步的。单片机在接收解析时必须同时处理这两种帧否则会漏掉关键事件。3.2 初始化网络参数的正确顺序CH395Q 上电后第一步不是直接去连接服务器而是先把基础网络参数设置好。我总结的初始化顺序是复位芯片等待初始化完成事件设置 MAC 地址设置本地 IP 地址设置子网掩码设置网关地址执行网络参数初始化命令等待网络就绪事件。MAC 地址不能全 0这是以太网协议的要求。建议用一张不冲突的 MAC 表或者用单片机 UID 生成一部分内容。IP 地址需要和你的上位机在同一网段掩码、网关也要对应路由器的配置否则数据发不出去。这里有个容易忽略的点修改了网络参数之后需要重新初始化网络芯片才会应用新配置。有些芯片只要设置寄存器地址就生效CH395Q 则需要在设置完成后执行网络初始化命令不要把顺序搞错。3.3 TCP 客户端连接流程的状态变化作为一个 TCP 客户端CH395Q 要经历的状态变化和我们平时用 socket 编程是相似的区别只是你需要通过串口命令来驱动。我习惯把整个流程分成几个阶段阶段操作说明1打开 Socket指定使用哪个 Socket 编号、协议类型2设置目标地址和端口设置服务器的 IP 和端口号3发起连接发送 TCP 连接命令4等待连接事件收到连接成功事件才算建立完成5数据收发查询缓冲区、发送或读取数据6断开连接主动断开或等待远端断开事件如果你用过 PC 上的 socket 编程可以把它想象成“用串口命令操作 socket 函数”open 对应打开 Socketconnect 对应发起连接send 对应发送数据recv 对应接收事件。连接超时是一个要认真配置的参数。CH395Q 在发起 TCP 连接后如果长时间没有得到回应会有一个超时机制。如果超时时间设置得太短在无线网络环境较差时可能频繁误判连接失败设置得太长则设备发现断线的时间变慢。我最终把超时配置调到了 5 秒左右在稳定性上比较满意。3.4 数据接收由事件驱动的设计思路CH395Q 收到网络数据后不会等 MCU 来查而是会主动通过串口发一个接收事件帧给单片机。事件帧里一般会带上 Socket 号和本包数据长度然后 MCU 可以再发一个读数据的命令把缓冲区里的数据取出来。这个机制要求 MCU 的串口接收不能丢数据。我建议用 DMA 串口空闲中断来接收 CH395Q 的数据这样每一帧都能完整被收进缓冲区。如果只用普通中断一个字节一个字节地收一旦在回调里处理太多逻辑高波特率下面很容易溢出。事件驱动的另一个好处是 MCU 不需要频繁轮询 Socket 状态CPU 占用率很低。代码结构上可以设计一个事件回调函数把不同事件分发到对应处理函数这样主循环只需要专注于业务逻辑。4. STM32F407VET6 端代码实现与解析4.1 串口初始化DMA 空闲中断接收先说结论串口接收必须用 DMA 空闲中断。CH395Q 的应答帧和数据帧长度不定空闲中断可以在接收完成后触发配合 DMA 缓冲区就能收到完整数据。如果只开普通接收中断一个字节一个字节进中断高频率下容易把系统搞垮。初始化代码大致如下void uart1_init(uint32_t baud) { GPIO_InitTypeDef gpio_init; USART_InitTypeDef usart_init; DMA_InitTypeDef dma_init; RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE); RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_DMA2, ENABLE); // PA9 TX, PA10 RX复用功能 AF7 gpio_init.GPIO_Pin GPIO_Pin_9 | GPIO_Pin_10; gpio_init.GPIO_Mode GPIO_Mode_AF; gpio_init.GPIO_Speed GPIO_Speed_50MHz; gpio_init.GPIO_OType GPIO_OType_PP; gpio_init.GPIO_PuPd GPIO_PuPd_UP; GPIO_Init(GPIOA, gpio_init); GPIO_PinAFConfig(GPIOA, GPIO_PinSource9, GPIO_AF_USART1); GPIO_PinAFConfig(GPIOA, GPIO_PinSource10, GPIO_AF_USART1); usart_init.USART_BaudRate baud; usart_init.USART_WordLength USART_WordLength_8b; usart_init.USART_StopBits USART_StopBits_1; usart_init.USART_Parity USART_Parity_No; usart_init.USART_Mode USART_Mode_RX | USART_Mode_TX; usart_init.USART_HardwareFlowControl USART_HardwareFlowControl_None; USART_Init(USART1, usart_init); // DMA2 Stream5 通道4 接收USART1_RX dma_init.DMA_Channel DMA_Channel_4; dma_init.DMA_PeripheralBaseAddr (uint32_t)(USART1-DR); dma_init.DMA_Memory0BaseAddr (uint32_t)ch395_rx_buf; dma_init.DMA_DIR DMA_DIR_PeripheralToMemory; dma_init.DMA_BufferSize CH395_RX_BUF_LEN; dma_init.DMA_PeripheralInc DMA_PeripheralInc_Disable; dma_init.DMA_MemoryInc DMA_MemoryInc_Enable; dma_init.DMA_PeripheralDataSize DMA_PeripheralDataSize_Byte; dma_init.DMA_MemoryDataSize DMA_MemoryDataSize_Byte; dma_init.DMA_Mode DMA_Mode_Circular; dma_init.DMA_Priority DMA_Priority_High; dma_init.DMA_FIFOMode DMA_FIFOMode_Disable; DMA_Init(DMA2_Stream5, dma_init); DMA_Cmd(DMA2_Stream5, ENABLE); USART_DMACmd(USART1, USART_DMAReq_RX, ENABLE); USART_ITConfig(USART1, USART_IT_IDLE, ENABLE); USART_Cmd(USART1, ENABLE); }这段代码里需要注意两点。第一DMA 的通道号必须和 USART1_RX 对应不同芯片型号请求映射不完全一样务必对照参考手册。第二使用循环模式 DMA可以始终把数据写入缓冲区空闲中断触发后从缓冲区尾部找数据不容易丢。4.2 空闲中断与帧解析串口空闲中断的用途是当串口在一段时间内没有收到新数据时触发一次中断。因为 CH395Q 的一帧数据是连续发送的帧与帧之间会有一个停顿所以每一帧接收完成后必然会产生一次空闲中断。在这个中断里可以计算 DMA 接收到了多少字节。void USART1_IRQHandler(void) { if (USART_GetITStatus(USART1, USART_IT_IDLE) ! RESET) { USART_ReceiveData(USART1); // 清除空闲中断标志 ch395_rx_len CH395_RX_BUF_LEN - DMA_GetCurrDataCounter(DMA2_Stream5); ch395_rx_ok 1; } }拿到一帧数据后下一步是解析。我的做法是把帧头、命令码、长度、数据和校验按协议拆分先判断是不是完整帧再判断是应答帧还是事件帧。解析完成后清空标志通知主循环处理。注意 DMA 是循环模式如果一帧跨过了缓冲区末尾要分两段拷贝出来。4.3 命令封装与应答等待有了串口收发基础我们还需要一个统一的命令发送接口。CH395Q 的命令帧组合逻辑、等待应答逻辑全部封装进这一个函数里代码整体会非常清爽。uint8_t ch395_transfer(uint8_t cmd, uint8_t *param, uint8_t len, uint8_t *rsp, uint8_t timeout_ms) { uint8_t frame[32]; uint8_t i, wait_cnt 0; frame[0] cmd; frame[1] len; for (i 0; i len; i) { frame[2 i] param[i]; } uart1_send(frame, len 2); while (ch395_rx_ok 0) { delay_ms(1); if (wait_cnt timeout_ms) { return 0; // 超时 } } memcpy(rsp, ch395_rx_buf, ch395_rx_len); ch395_rx_ok 0; return ch395_rx_len; }实际项目中我会加一个环形缓冲队列把应答帧和事件帧统一放进队列解析。上面的代码只是说明核心逻辑你可以在它的基础上扩展出带事件分类的版本。4.4 初始化网络与 Socket接下来是通过 CH395Q 命令初始化以太网客户端。命令码定义属于芯片底层我习惯单独放在 ch395_cmd.h 里这里用语义化名称代替方便你替换成实际头文件。void eth_client_init(void) { uint8_t buf[8]; ch395_reset(); // 设置MAC地址 buf[0] 0x02; buf[1] 0x00; buf[2] 0x00; buf[3] 0x12; buf[4] 0x34; buf[5] 0x56; ch395_transfer(CH395_CMD_SET_MAC, buf, 6, rsp, 100); // 设置IP地址比如192.168.1.100 buf[0] 192; buf[1] 168; buf[2] 1; buf[3] 100; ch395_transfer(CH395_CMD_SET_IP, buf, 4, rsp, 100); // 设置子网掩码 buf[0] 255; buf[1] 255; buf[2] 255; buf[3] 0; ch395_transfer(CH395_CMD_SET_MASK, buf, 4, rsp, 100); // 设置网关 buf[0] 192; buf[1] 168; buf[2] 1; buf[3] 1; ch395_transfer(CH395_CMD_SET_GATEWAY, buf, 4, rsp, 100); // 打开Socket 0TCP客户端模式 ch395_transfer(CH395_CMD_OPEN_SOCKET, ...); // 设置目标服务器地址和端口 buf[0] 192; buf[1] 168; buf[2] 1; buf[3] 200; buf[4] (SERVER_PORT 8) 0xFF; buf[5] SERVER_PORT 0xFF; ch395_transfer(CH395_CMD_SET_SERVER, buf, 6, rsp, 100); }所有设置完成之后发送连接命令。连接是否成功不能只看命令有没有应答而是要看有没有收到连接成功事件。很多初学者卡在这里命令发出去了应答也正常但上位机就是没收到连接。原因就是连接过程是异步的必须等事件。4.5 数据发送与接收调用建立连接后发送数据只需要查询发送缓冲区然后组帧发送。uint8_t eth_client_send_data(uint8_t *data, uint16_t len) { uint16_t free_len; // 查询发送缓冲区剩余空间 free_len ch395_get_tx_free_len(0); if (free_len len) { return 0; // 缓冲区不够 } ch395_write_tx_buf(0, data, len); ch395_transmit(0); return 1; }接收数据则是在事件帧解析中处理。收到数据接收事件后读取数据并进行业务处理。这个流程要注意缓冲区的生命周期CH395Q 内部有接收缓冲区读取命令会把数据从芯片内部拷贝到单片机缓冲区拷贝完成后芯片才会释放这部分内存。所以每次收到事件后要尽快读取。4.6 一个可以直接抄的 main 函数骨架int main(void) { uint8_t data[64]; uint16_t index 0; uint8_t connected 0; SystemInit(); delay_init(168); uart1_init(115200); eth_client_init(); connected ch395_start_connect(); // 建立TCP连接 while (1) { // 周期性处理业务 if (need_send_flag) { pack_data(data, index); eth_client_send_data(data, index); need_send_flag 0; } // 处理串口事件 eth_client_poll(); // 检查连接状态断开则重连 if (!connected) { connected ch395_reconnect(); } } }这个骨架已经可以直接放进 Keil 或 GCC 工程里跑起来。底层串口、DMA、命令帧组装这些函数按前面的思路补齐整个工程结构就是完整的。5. 实测踩坑这些问题最容易翻车5.1 模块不响应任何命令现象是 CH395Q 的串口完全没有任何应答单片机发什么它都像没听见。最常见的原因有三个SEL 引脚没有配置为 UART 模式复位时序不对芯片根本没跑起来波特率不匹配。排查方法模块上电后先不要发命令用示波器或者逻辑分析仪看 CH395Q 的 TX 引脚有没有输出。如果软件复位成功它会主动上报初始化事件。如果 TX 引脚完全没波形基本可以断定芯片没启动检查供电、复位和 SEL 配置。如果 TX 有波形但单片机收不到那就死磕波特率和接线。注意SEL 引脚状态在 CH395Q 复位时被锁存。不要试图运行中改模式改完必须复位芯片。5.2 能 Ping 通但 TCP 连接总是失败在局域网内测试时如果设备能正常被 Ping 通说明底层网络没问题问题出在 TCP 连接环节。先检查上位机或服务器的防火墙是否放开了对应端口。很多人忽略这一点在开发电脑上测试时防火墙把入站连接拦了CH395Q 连接请求发出去石沉大海。还要确认服务器的 IP 地址和端口设置到底对不对。CH395Q 设置的服务器地址是目标地址不要误填成自己本机的地址。端口号要注意大小端CH395Q 的端口参数一般是大端字节序也就是高字节在前。另外连接超时时间设置过短也会导致连接失败概率大增。在无线屏蔽严重的工业现场TCP 握手报文可能会丢失重传如果超时时间设成 1 秒基本上每三次就有一次失败。我这边最后设置的是 5 秒左右现场测试效果明显好转。5.3 数据乱码和粘包乱码大概率是波特率不一致或者电平不匹配。CH395Q 模块配置的串口波特率要和单片机配的完全一致注意模块出厂默认可能是某个特定波特率比如 115200 或 9600先确认模块的默认值再改单片机配置。如果你的模块支持波特率命令配置也要在初始化早期先设置好。粘包问题主要发生在两者之间单片机接收慢CH395Q 连续上报两帧事件导致缓冲区里有两帧数据叠在一起。解决方法是严格按帧头、长度字段来切帧解析完一帧再找下一帧。我建议用一个循环解析函数把所有有效帧都提取出来而不是解析一次就退出。5.4 DMA 缓冲区被覆盖这是 DMA 循环模式的一个经典问题。如果主循环处理事件的速度不够快DMA 会不断把新数据写入缓冲区可能会覆盖尚未处理完的旧数据。解决办法有两个方向一是加环形队列把 DMA 数据实时搬运到更大的内存队列二是增加 DMA 缓冲区长度提高容错空间。我建议直接写一个环形缓冲虽然代码多几十行但一劳永逸。串口空闲中断里只负责搬运数据真正的事件解析放在主循环里这样可以避免在中断上下文中做复杂逻辑。5.5 断线后不能自动重连实际产品中不会一直在稳定网络环境里运行断线重连是必备功能。我的做法是主循环中定时查询 Socket 的连接状态如果发现已经断开就调用重新连接函数。CH395Q 断开后需要先关闭 socket再重新打开、重新连接不能直接在原 socket 上重发连接命令这点要注意。重新连接时可以加一个退避延时第一次断线等 1 秒重连第二次等 2 秒最多不超过 30 秒避免设备频繁发送连接请求给服务器造成压力。6. 再分享两个小的经验第一调试阶段最好准备一个串口调试助手把 CH395Q 串口上所有的收发数据都打印到调试串口十六进制显示。这样可以直观看到单片机发出的命令帧和 CH395Q 返回的应答帧秒级定位大部分问题。我在代码里加了一个调试开关打开后会打印完整收发帧上线时关闭即可。第二CH395Q 的 INT 中断引脚值得利用起来。虽然串口事件帧已经包含了所有信息但加上 INT 引脚后单片机可以在芯片有事件时及时响应而不是靠主循环不断去查询串口队列。尤其是在多个 Socket 同时使用的场景下中断驱动的效率明显更高。我现在的做法是 INT 引脚接到单片机外部中断中断里设置一个事件标志主循环检测到标志后再去解析串口数据帧。这套方案最后在我项目里稳定跑了一个月期间遇到过几次路由器重启导致的断线重连逻辑都能自动恢复。整体来说STM32F407VET6 加 CH395Q 的串口以太网客户端方案非常适合对成本敏感、开发周期紧、数据量不大的嵌入式联网需求。如果你也在评估类似方案建议按这篇文章的思路先把硬件接线和初始化流程跑通再逐步完善业务逻辑。
