当前位置：首页 > news >正文

从零到一：基于STM32F1与SPL库的lwIP-2.1.2裸机移植实战（ENC28J60驱动适配）

news 2026/5/11 14:25:30

1. 项目背景与准备工作

最近在调试一块基于STM32F103的工控板，发现原有的lwIP协议栈版本太旧导致网络功能不稳定。趁着假期决定将协议栈升级到最新的lwIP-2.1.2版本。选择裸机移植是因为后续计划在uC/OS-II上运行，先搞定基础环境再考虑操作系统适配会更稳妥。

硬件准备清单：

STM32F103ZET6开发板（256K Flash）
ENC28J60以太网模块（SPI接口）
J-Link调试器
杜邦线若干

软件资源准备：

lwIP-2.1.2官方源码包
contrib-2.1.0扩展包
STM32标准外设库V3.5
Keil MDK开发环境

注意：建议从lwIP官网下载源码，避免使用第三方修改版本。我最初用了某论坛的"优化版"，结果发现ARP功能被阉割，导致DHCP无法正常工作。

2. 工程框架搭建

2.1 源码目录结构规划

在STM32标准库模板工程基础上，新建lwip目录并组织文件结构：

lwip ├── arch │ ├── cc.h # 编译器适配文件 │ └── sys_arch.c # 系统抽象层 ├── core # lwIP核心协议栈 │ ├── ipv4 │ └── ... ├── include # 头文件 ├── netif │ ├── ethernetif.c # 网卡驱动适配层 │ └── my_nic.c # 自封装驱动接口 └── port ├── lwipopts.h # 协议栈配置 └── ...

关键操作：

从contrib包中复制ethernetif.c到netif目录
从Win32示例中提取cc.h和sys_arch.c
将lwip-2.1.2/src下的核心代码完整拷贝到core目录

2.2 基础工程配置

在Keil中设置关键编译选项：

// 预定义宏 #define STM32F10X_HD // 根据芯片选择 #define USE_STDPERIPH_DRIVER #define LWIP_RAW 1

调整内存模型配置：

IRAM1起始地址：0x20000000
大小：0x10000（64KB）
勾选"Use MicroLIB"以节省空间

3. 底层驱动适配

3.1 ENC28J60驱动实现

基于SPI1接口编写驱动，需要注意几个关键点：

SPI初始化配置：

void SPI1_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; SPI_InitTypeDef SPI_InitStructure; // 时钟使能 RCC_APB2PeriphClockCmd(RCC_APB2Periph_SPI1, ENABLE); // 配置SCK/MOSI为复用推挽输出 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_5 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_10MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); // 配置MISO为上拉输入 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; GPIO_Init(GPIOA, &GPIO_InitStructure); // SPI参数配置 SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode = SPI_Mode_Master; SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL = SPI_CPOL_Low; SPI_InitStructure.SPI_CPHA = SPI_CPHA_1Edge; SPI_InitStructure.SPI_NSS = SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_4; SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB; SPI_Init(SPI1, &SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }

数据收发优化技巧：

使用DMA传输提升SPI效率
实现双缓冲机制避免数据丢失
添加硬件CRC校验确保数据完整性

3.2 中断处理设计

ENC28J60的中断引脚连接PA1（EXTI1），配置步骤：

// 中断初始化 void EXTI1_Config(void) { EXTI_InitTypeDef EXTI_InitStructure; NVIC_InitTypeDef NVIC_InitStructure; // 配置PA1为上拉输入 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_1; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; GPIO_Init(GPIOA, &GPIO_InitStructure); // EXTI映射到PA1 GPIO_EXTILineConfig(GPIO_PortSourceGPIOA, GPIO_PinSource1); // 配置EXTI1 EXTI_InitStructure.EXTI_Line = EXTI_Line1; EXTI_InitStructure.EXTI_Mode = EXTI_Mode_Interrupt; EXTI_InitStructure.EXTI_Trigger = EXTI_Trigger_Falling; EXTI_InitStructure.EXTI_LineCmd = ENABLE; EXTI_Init(&EXTI_InitStructure); // 配置NVIC NVIC_InitStructure.NVIC_IRQChannel = EXTI1_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 0x00; NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0x00; NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&NVIC_InitStructure); }

中断服务函数要点：

void EXTI1_IRQHandler(void) { if(EXTI_GetITStatus(EXTI_Line1) != RESET) { EXTI_ClearITPendingBit(EXTI_Line1); uint8_t eir = ENC28J60_Read(EIR); // 处理接收中断 if(eir & EIR_PKTIF) { do { process_mac(); // 处理接收数据 } while(ENC28J60_Read(EPKTCNT) > 0); // 清空缓冲区 } // 处理其他中断类型... } }

4. lwIP协议栈移植关键点

4.1 内存管理配置

在lwipopts.h中调整内存参数：

/* 内存池大小设置 */ #define MEM_SIZE (10*1024) // 根据芯片RAM调整 #define MEMP_NUM_PBUF 16 #define PBUF_POOL_SIZE 24 #define PBUF_POOL_BUFSIZE 512 /* TCP相关缓冲区 */ #define TCP_WND (4*1024) #define TCP_MSS 1460 #define TCP_SND_BUF (2*TCP_MSS) /* ARP表大小 */ #define ARP_TABLE_SIZE 10

实测发现：当MEM_SIZE小于6KB时，HTTP服务会出现内存分配失败。建议在资源允许的情况下尽量调大。

4.2 网卡接口适配

修改ethernetif.c中的三个核心函数：

初始化函数：

static void low_level_init(struct netif *netif) { // 设置MAC地址 netif->hwaddr_len = ETHARP_HWADDR_LEN; memcpy(netif->hwaddr, MY_MAC_ADDR, ETHARP_HWADDR_LEN); // 设备能力标志 netif->flags = NETIF_FLAG_BROADCAST | NETIF_FLAG_ETHARP; // 初始化物理网卡 enc28j60_init(MY_MAC_ADDR); }

数据发送函数：

static err_t low_level_output(struct netif *netif, struct pbuf *p) { struct pbuf *q; uint8_t *buffer = (uint8_t *)memp_malloc(MEMP_PBUF); if(!buffer) return ERR_MEM; uint16_t offset = 0; for(q = p; q != NULL; q = q->next) { memcpy(buffer + offset, q->payload, q->len); offset += q->len; } enc28j60_packet_send(offset, buffer); memp_free(MEMP_PBUF, buffer); return ERR_OK; }

数据接收优化方案：

static struct pbuf *low_level_input(struct netif *netif) { uint16_t len = enc28j60_packet_receive(); if(len == 0) return NULL; struct pbuf *p = pbuf_alloc(PBUF_RAW, len, PBUF_RAM); if(!p) return NULL; enc28j60_read_memory((uint8_t *)p->payload, len); return p; }

5. 调试与优化技巧

5.1 日志系统搭建

利用ITM机制实现调试输出：

// 在cc.h中重定义调试宏 #define LWIP_PLATFORM_DIAG(x) do { \ printf x; \ printf("\n"); \ } while(0) #define LWIP_DEBUGF(debug, message) LWIP_PLATFORM_DIAG(message)

启用关键模块日志：

#define LWIP_DEBUG 1 #define NETIF_DEBUG LWIP_DBG_ON #define ETHARP_DEBUG LWIP_DBG_ON #define IP_DEBUG LWIP_DBG_ON

5.2 常见问题解决

问题1：Ping不通

检查PHY链路状态灯
确认ARP响应正常
验证MAC地址配置

问题2：内存泄漏

使用mem.c中的统计功能
定期检查memp_stats()输出

问题3：性能瓶颈

启用LWIP_STATS统计
优化sys_check_timeouts()调用频率

6. 测试验证

完成移植后，通过以下步骤验证：

基础网络测试

# PC端执行 ping 192.168.1.66 -t

协议栈压力测试

// 在main循环中添加 static void test_tcp_echo(void) { struct netconn *conn = netconn_new(NETCONN_TCP); netconn_bind(conn, IP_ADDR_ANY, 7); netconn_listen(conn); while(1) { struct netconn *newconn; err_t err = netconn_accept(conn, &newconn); if(err == ERR_OK) { struct netbuf *buf; while((err = netconn_recv(newconn, &buf)) == ERR_OK) { netconn_write(newconn, buf->p->payload, buf->p->len, NETCONN_COPY); netbuf_delete(buf); } netconn_close(newconn); netconn_delete(newconn); } } }