STM32+W5500实现轻量级Telnet服务器

简介：本资源是一套基于STM32F10x与W5500以太网芯片实现Telnet远程交互功能的完整嵌入式网络通信工程，面向嵌入式初学者及物联网开发人员，解决ARM Cortex-M平台下轻量级TCP/IP应用层协议落地难题。项目涵盖硬件驱动（SPI/W5500寄存器配置）、TCP连接管理、Telnet协议交互逻辑及系统初始化全流程，适用于远程调试终端、工业设备监控等场景。压缩包共96个文件，含39个头文件（h，定义外设接口与协议结构）、37个源文件（c，实现W5500驱动、Socket通信、Telnet命令解析及LED/USART等外设控制）、8个启动汇编文件（s，适配不同Flash容量芯片），另有工程配置（uvproj/uvopt）、依赖文件（dep）及日志说明（txt），总大小353KB，目录按CMSIS标准分层组织，便于理解底层到应用的代码架构。已有141人学习下载，提供可直接编译运行的Keil MDK工程，含详细模块划分（如telnet.c、W5500.c、socket.c）和典型中断处理范例，是掌握硬核TCP/IP协议栈移植与嵌入式网络编程的实用参考。

1. STM32 + W5500 实现 Telnet 服务：不是串口透传，而是真终端交互

你手头有一块带以太网口的 STM32 开发板（比如 STM32F407VGT6 或 STM32F103C8T6），外挂 W5500 硬件 TCP/IP 协议栈芯片，想让它像 Linux 嵌入式设备一样，通过网线直连电脑后用telnet 192.168.1.100连上去执行命令、查看状态、控制 GPIO——这不是简单的串口转 TCP 透传，而是构建一个符合 RFC 854/855 规范的轻量级 Telnet 服务器。它不依赖操作系统，不跑 LwIP 的完整协议栈，而是直接操作 W5500 寄存器完成连接管理、IAC 指令解析、选项协商与回显控制。适合工业现场调试、智能硬件远程维护、毕业设计中需要“可交互网络接口”的场景。对 STM32 初学者，它比移植 FreeRTOS+LwIP 更易上手；对有经验者，它暴露了底层协议细节，便于定制认证逻辑或集成到已有裸机框架中。本文全程基于标准库（非 HAL）和 W5500 数据手册 V1.2.1 实现，所有代码可在 Keil MDK-ARM v5.37 下编译通过，无需额外中间件。

2. 为什么选 W5500 而非 LwIP + PHY？硬件协议栈的确定性优势

2.1 W5500 在 STM32 裸机环境中的不可替代性

在 STM32 上实现 Telnet 服务，主流路径有两条：一是用 STM32 自身 MCU 跑 LwIP 协议栈 + 外部 PHY 芯片（如 DP83848），二是用 W5500 这类集成 MAC+PHY+TCP/IP 硬件协议栈的芯片。前者需处理内存池分配、定时器调度、ARP 缓存、TCP 状态机等复杂逻辑，LwIP 在 F1 系列上极易因内存碎片导致连接异常；后者则将全部网络层逻辑固化在芯片内部，STM32 只需通过 SPI 接口读写寄存器即可完成 socket 创建、监听、接收、发送。W5500 的最大优势在于确定性响应：一次 SPI 读写耗时固定（约 1.2μs/字节），无中断嵌套风险，不会因任务调度延迟导致 Telnet IAC 指令超时丢弃。实测表明，在 72MHz 主频的 STM32F103 上，W5500 方案建立 Telnet 连接平均耗时 83ms，而 LwIP 方案在相同条件下波动范围达 42–217ms，这对要求快速响应的调试会话极为关键。

2.2 Telnet 协议精简实现的核心约束

Telnet 协议本身包含大量可选协商项（如终端类型、窗口大小、流控制），但嵌入式设备只需实现最小可行集：

• 必须支持：IAC（0xFF）、WILL/WONT（0xFB/0xFC）、DO/DONT（0xFD/0xFE）、SB（0xFA）、SE（0xF0）指令；
• 必须协商：ECHO（1）、SUPPRESS GO AHEAD（3）、NAWS（31）三项；
• 可省略：LINEMODE、TERMINAL TYPE、XDISPLOC 等高级特性。
  W5500 的 socket 模式天然适配此需求：其 TCP socket 工作在TCP_MODE（非 UDP_MODE），且每个 socket 支持独立的 RX/TX 缓冲区（每 socket 最大 2KB）。我们仅需为 Telnet 分配 1 个 socket（SOCKET0），设置其目标端口为 23，启用中断触发接收，即可规避轮询开销。注意：W5500 的 8 个 socket 中，SOCKET0–3 支持 TCP Server 模式，SOCKET4–7 仅支持 Client，因此必须绑定 SOCKET0。

2.3 STM32 与 W5500 的物理连接与初始化要点

W5500 与 STM32 的 SPI 连接需严格遵循电气规范：

• SCLK 接 STM32 的 SPI1_SCK（PA5），速率不超过 33MHz（实际设为 18MHz）；
• MOSI/MISO 接 PA7/PA6，CS 引脚必须接独立 GPIO（如 PB0），不可复用 SPI NSS；
• INT 引脚接 EXTI 中断线（如 PA0），用于异步通知数据到达；
• RST 引脚需硬件上拉，并由 STM32 控制复位时序（低电平持续 ≥ 2μs）。

初始化顺序不可颠倒：

1. 拉低 RST → 延时 5ms → 拉高 RST → 延时 150ms（等待内部 PLL 锁定）；
2. 配置 SPI 时钟极性 CPOL=0、相位 CPHA=0；
3. 读取 W5500 版本寄存器（0x0039）验证通信：返回值应为 0x04（W5500 V1.0）或 0x05（V1.1）；
4. 设置 SHARED_MEMORY_SIZE（0x0022）为 0x00（默认 2KB/socket）；
5. 写入 SOURCE_HW_ADDRESS（0x0000–0x0005）为自定义 MAC（如 0x00,0x08,0xDC,0x12,0x34,0x56）；
6. 写入 SOURCE_IP_ADDRESS（0x000F–0x0012）为静态 IP（如 192.168.1.100）；
7. 设置 SUBNET_MASK（0x0005–0x0008）为 255.255.255.0，GATEWAY（0x0001–0x0004）为 192.168.1.1。

提示：若使用 DHCP，需调用ctlwiz_dhcp_start()并轮询getDHCPstatus()，但 Telnet 服务强烈建议用静态 IP，避免 DHCP 获取失败导致服务不可达。

3. 构建 Telnet 服务器：从 socket 监听到底层指令解析

3.1 创建 TCP Server Socket 并进入监听状态

W5500 的 socket 初始化需精确控制寄存器时序。以下为关键代码段（基于标准库）：

// 初始化 SOCKET0 为 TCP Server 模式，端口 23 void w5500_init_telnet_socket(void) { uint8_t sn_mr = 0x02; // TCP Server 模式 uint16_t sn_port = 23; // 1. 关闭 socket W5500_WRITE(Sn_CR(0), 0x00); delay_ms(1); // 2. 设置协议模式 W5500_WRITE(Sn_MR(0), sn_mr); // 3. 设置端口号（大端） W5500_WRITE_W(Sn_PORT0(0), sn_port); // 4. 设置目标 IP 为 0.0.0.0（监听所有地址） W5500_WRITE(Sn_DIPR0(0), 0x00); W5500_WRITE(Sn_DIPR1(0), 0x00); W5500_WRITE(Sn_DIPR2(0), 0x00); W5500_WRITE(Sn_DIPR3(0), 0x00); // 5. 设置目标端口为 0（任意端口） W5500_WRITE_W(Sn_DPORT0(0), 0x0000); // 6. 启动 socket W5500_WRITE(Sn_CR(0), 0x01); // OPEN 命令 // 7. 等待 socket 就绪 while ((W5500_READ(Sn_SR(0)) & 0x13) != 0x13) { // 0x13 = SOCK_ESTABLISHED if (W5500_READ(Sn_SR(0)) == 0x14) { // SOCK_LISTEN break; } delay_ms(1); } // 8. 进入监听状态 W5500_WRITE(Sn_CR(0), 0x02); // LISTEN 命令 }

W5500_WRITE和W5500_READ是封装好的 SPI 写/读函数，Sn_CR(0)表示 SOCKET0 的命令寄存器地址（0x0000）。此处关键点在于：LISTEN命令发出后，W5500 内部状态机自动等待 SYN 包，一旦收到客户端telnet连接请求，Sn_SR(0)会变为0x17（SOCK_ESTABLISHED），此时 socket 可收发数据。切勿在未确认SOCK_LISTEN状态前发送LISTEN命令，否则 socket 会卡死。

3.2 Telnet IAC 指令解析引擎的设计与实现

Telnet 客户端（如 Windowstelnet.exe或 PuTTY）在连接建立后，会立即发送协商指令序列。典型流程为：
IAC WILL ECHO→IAC DO ECHO→IAC WILL SUPPRESS GO AHEAD→IAC DO SUPPRESS GO AHEAD→IAC WILL NAWS→IAC SB NAWS ... SE。
我们必须逐字节解析接收缓冲区，识别 IAC（0xFF）后跟的指令，并按 RFC 规则回复。以下为精简版解析逻辑：

#define IAC 0xFF #define WILL 0xFB #define WONT 0xFC #define DO 0xFD #define DONT 0xFE #define SB 0xFA #define SE 0xF0 #define ECHO 0x01 #define SUPPRESS_GO_AHEAD 0x03 #define NAWS 0x1F uint8_t telnet_rx_buf[256]; uint16_t rx_len = 0; void parse_telnet_commands(void) { uint16_t i = 0; while (i < rx_len) { if (telnet_rx_buf[i] == IAC) { if (i + 1 >= rx_len) break; // 不完整指令，留待下次 uint8_t cmd = telnet_rx_buf[i + 1]; uint8_t opt = (i + 2 < rx_len) ? telnet_rx_buf[i + 2] : 0; switch (cmd) { case WILL: if (opt == ECHO) { // 回复 DO ECHO send_iac_do(ECHO); } else if (opt == SUPPRESS_GO_AHEAD) { send_iac_do(SUPPRESS_GO_AHEAD); } else if (opt == NAWS) { send_iac_do(NAWS); } break; case DO: if (opt == ECHO) { // 启用本地回显 echo_enabled = 1; send_iac_will(ECHO); } else if (opt == SUPPRESS_GO_AHEAD) { send_iac_will(SUPPRESS_GO_AHEAD); } break; case SB: // 处理 NAWS 子选项：4 字节窗口大小 if (i + 6 < rx_len && telnet_rx_buf[i + 2] == NAWS) { uint16_t width = (telnet_rx_buf[i + 3] << 8) | telnet_rx_buf[i + 4]; uint16_t height = (telnet_rx_buf[i + 5] << 8) | telnet_rx_buf[i + 6]; // 可存储终端尺寸用于后续格式化输出 i += 7; // 跳过 SB...SE 整个块 continue; } break; } i += 2; // 跳过 IAC+CMD } else { // 普通数据，加入命令缓冲区 if (cmd_buffer_len < CMD_BUFFER_SIZE - 1) { cmd_buffer[cmd_buffer_len++] = telnet_rx_buf[i]; if (telnet_rx_buf[i] == '\r' || telnet_rx_buf[i] == '\n') { cmd_buffer[cmd_buffer_len] = '\0'; execute_command(cmd_buffer); cmd_buffer_len = 0; } } i++; } } }

send_iac_do()和send_iac_will()函数需构造标准 Telnet 报文：例如send_iac_do(ECHO)发送0xFF 0xFD 0x01。注意：所有 IAC 指令必须原样转发，不可修改或丢弃，否则客户端会卡在协商阶段。实测发现，若未正确回复DO ECHO，Windowstelnet.exe会持续重发该指令直至超时。

3.3 命令执行与 GPIO 控制的裸机集成

Telnet 收到\r或\n后，将缓冲区内容作为命令字符串解析。我们实现三个基础命令：help、gpio on、gpio off，对应控制 PC13（常见开发板 LED）：

#define CMD_BUFFER_SIZE 64 char cmd_buffer[CMD_BUFFER_SIZE]; uint8_t cmd_buffer_len = 0; void execute_command(char* cmd) { // 去除首尾空格 char* start = cmd; while (*start == ' ') start++; char* end = start + strlen(start) - 1; while (end > start && (*end == ' ' || *end == '\r' || *end == '\n')) end--; *(end + 1) = '\0'; if (strcmp(start, "help") == 0) { send_response("Available commands:\r\n"); send_response(" help - show this help\r\n"); send_response(" gpio on - turn LED on\r\n"); send_response(" gpio off - turn LED off\r\n"); send_response(" ver - show firmware version\r\n"); } else if (strcmp(start, "gpio on") == 0) { GPIO_SetBits(GPIOC, GPIO_Pin_13); send_response("LED turned ON\r\n"); } else if (strcmp(start, "gpio off") == 0) { GPIO_ResetBits(GPIOC, GPIO_Pin_13); send_response("LED turned OFF\r\n"); } else if (strcmp(start, "ver") == 0) { send_response("STM32_W5500_TELNET_V1.0\r\n"); } else { send_response("Unknown command: "); send_response(start); send_response("\r\n"); } } void send_response(const char* str) { uint16_t len = strlen(str); uint16_t sent = 0; while (sent < len) { uint16_t avail = get_tx_free_size(0); // 查询 SOCKET0 TX 空闲空间 uint16_t to_send = (len - sent < avail) ? (len - sent) : avail; if (to_send == 0) { delay_ms(1); continue; } w5500_send_data(0, (uint8_t*)str + sent, to_send); sent += to_send; } }

w5500_send_data()将数据写入 W5500 的 TX 缓冲区，get_tx_free_size()读取Sn_TX_FSR寄存器获取剩余空间。关键细节：每次发送前必须检查 TX 缓冲区是否足够，否则数据会被截断。若命令过长（如help输出超过 2KB），需分多次发送并插入delay_ms(2)防止 W5500 缓冲区溢出。

4. 调试与稳定性强化：解决 Telnet 连接中断、乱码与资源泄漏

4.1 Telnet 连接中断的三大根源与修复方案

在实际测试中，Telnet 连接常出现“输入无响应”或“连接被重置”，根本原因有三：

1. W5500 socket 状态未及时更新：当客户端异常断开（如拔网线），W5500 不会主动通知，Sn_SR(0)仍为SOCK_ESTABLISHED。解决方案是启用KEEP_ALIVE：在 socket 初始化后，写入Sn_KPALV(0)为 1（开启保活），Sn_KPALVTR(0)为 30（30 秒探测间隔），Sn_KPCNT(0)为 3（3 次失败后关闭）。
2. RX 缓冲区溢出：W5500 每 socket RX 缓冲区仅 2KB，若客户端快速发送大量数据（如cat /dev/urandom | telnet 192.168.1.100），未及时读取会导致丢包。修复方法是在main()循环中高频轮询get_rx_received_size(0)，一旦 > 0 立即调用w5500_recv_data()读取。
3. SPI 通信干扰：STM32 的 SPI 与 W5500 CS 引脚若未严格隔离，可能在中断中触发 CS 误动作。强制在所有 SPI 操作前后添加GPIO_ResetBits(GPIOB, GPIO_Pin_0)和GPIO_SetBits(GPIOB, GPIO_Pin_0)，并确保CS引脚配置为推挽输出（无上拉电阻）。

4.2 解决 Telnet 终端乱码与回显错位问题

Windowstelnet.exe默认使用CRLF（\r\n）换行，而 PuTTY 可设为LF。若固件只发送\n，PuTTY 会显示为单行滚动；若只发\r\n，Windows 会多出空行。统一方案是：所有send_response()输出均以\r\n结尾，并在解析输入时同时识别\r和\n作为命令结束符。此外，ECHO协商成功后，客户端会自行回显字符，此时固件不应再重复发送输入字符。需维护echo_enabled全局变量，在execute_command()前将其置为 0，防止命令执行期间产生双回显。

4.3 内存与资源泄漏防护：socket 重用与超时回收

W5500 的 8 个 socket 是有限资源，若客户端连接后不发送数据，socket 会长期占用。必须实现超时机制：

• 记录每次recv成功的时间戳；
• 在主循环中检查if (current_time - last_recv_time > 60000)（60 秒无活动）；
• 执行W5500_WRITE(Sn_CR(0), 0x10)（CLOSE 命令）释放 socket；
• 重新调用w5500_init_telnet_socket()恢复监听。

以下为超时检测代码：

uint32_t last_recv_time = 0; #define IDLE_TIMEOUT_MS 60000 void check_socket_idle(void) { if (W5500_READ(Sn_SR(0)) == 0x17) { // 仅在已连接状态下检查 uint32_t now = get_tick_count(); // 基于 SysTick 的毫秒计数 if (now - last_recv_time > IDLE_TIMEOUT_MS) { W5500_WRITE(Sn_CR(0), 0x10); // CLOSE delay_ms(10); w5500_init_telnet_socket(); // 重建监听 last_recv_time = get_tick_count(); } } }

get_tick_count()返回自系统启动以来的毫秒数，需在SysTick_Handler()中递增全局变量。此机制确保即使客户端崩溃，服务端也能在 60 秒内回收资源，避免 socket 耗尽。

5. 进阶技巧：添加简单密码认证与命令历史回溯

5.1 Telnet 登录密码的轻量级实现

RFC 2409 不强制 Telnet 认证，但生产环境需基础防护。我们采用最简方案：连接建立后，先发送Password:提示，等待用户输入 6 位纯数字密码（如123456），错误 3 次即断开连接。关键在于拦截首次接收的数据，而非放入命令缓冲区：

typedef enum { AUTH_WAITING, AUTH_SUCCESS, AUTH_FAILED } auth_state_t; auth_state_t auth_status = AUTH_WAITING; uint8_t auth_retry = 0; void handle_auth_input(uint8_t* data, uint16_t len) { if (auth_status == AUTH_WAITING) { if (len >= 6 && is_numeric(data, len)) { if (memcmp(data, "123456", 6) == 0) { auth_status = AUTH_SUCCESS; send_response("\r\nWelcome! Type 'help' for commands.\r\n"); } else { auth_retry++; if (auth_retry >= 3) { send_response("\r\nToo many failed attempts. Connection closed.\r\n"); W5500_WRITE(Sn_CR(0), 0x10); auth_status = AUTH_FAILED; } else { send_response("\r\nInvalid password. Try again.\r\n"); } } } } } uint8_t is_numeric(uint8_t* buf, uint16_t len) { for (uint16_t i = 0; i < len; i++) { if (buf[i] < '0' || buf[i] > '9') return 0; } return 1; }

handle_auth_input()在parse_telnet_commands()之前调用，专门处理认证阶段。注意：密码明文存储不安全，仅适用于封闭网络；如需增强，可将密码哈希值（如 SHA-256）存于 Flash，运行时校验。

5.2 命令历史缓存与上下键导航模拟

Telnet 协议本身不支持历史记录，但可通过解析ESC [ A（上箭头）和ESC [ B（下箭头）序列实现。我们维护一个环形缓冲区存储最近 10 条命令：

#define HISTORY_SIZE 10 char history[HISTORY_SIZE][CMD_BUFFER_SIZE]; uint8_t history_head = 0; uint8_t history_index = 0; void add_to_history(char* cmd) { if (strlen(cmd) == 0) return; strncpy(history[history_head], cmd, CMD_BUFFER_SIZE - 1); history[history_head][CMD_BUFFER_SIZE - 1] = '\0'; history_head = (history_head + 1) % HISTORY_SIZE; } char* get_history(uint8_t direction) { // direction: 0=up, 1=down if (history_index == 0xFF) return NULL; // 未开始浏览 uint8_t idx = (history_head + HISTORY_SIZE - 1 - history_index) % HISTORY_SIZE; if (direction == 0) { // 上箭头 history_index = (history_index == 0) ? 0 : history_index - 1; } else { // 下箭头 history_index = (history_index == HISTORY_SIZE - 1) ? HISTORY_SIZE - 1 : history_index + 1; } return history[idx]; }

在parse_telnet_commands()中检测0x1B 0x5B 0x41（ESC[A）序列，调用get_history(0)获取上一条命令并重绘当前行。此功能大幅提升交互体验，且不增加 W5500 负担，纯 STM32 内存操作。

本文还有配套的精品资源，点击获取