1. 硬件连接与基础配置
STM32F103ZE与ENC28J60的硬件连接是项目成功的第一步。我遇到过不少开发者在这个环节栽跟头，最常见的问题就是SPI引脚接错或者中断引脚配置不当。这里分享几个实测有效的连接方案：
核心引脚连接表：
| ENC28J60引脚 | STM32F103ZE引脚 | 功能说明 |
|---|---|---|
| SPI1_NSS | PA4 | 片选信号 |
| SPI1_SCK | PA5 | 时钟信号 |
| SPI1_MISO | PA6 | 主入从出 |
| SPI1_MOSI | PA7 | 主出从入 |
| INT | PA1 | 中断输入 |
| RST | PB9 | 复位信号 |
硬件调试技巧：
- LED指示灯验证：即使不写程序，插上网线后绿色LED_LINK灯应该常亮，传输数据时黄色LED_ACT灯会闪烁。如果灯不亮，先检查电路
- 晶振选择：必须使用25MHz无源晶振（我曾在实验室误用有源晶振导致通信失败）
- SPI速率：实测发现超过10MHz会导致数据丢包，建议初始配置为2.25MHz（72MHz主频32分频）
常见问题排查：
- 如果SPI通信失败，先用逻辑分析仪抓取波形，确认片选信号和时钟信号正常
- 中断引脚建议配置为下拉输入模式，避免悬空导致误触发
- 复位电路要保证上电时有足够长的低电平时间（至少10ms）
2. HAL库工程搭建实战
搭建HAL库工程时最容易踩的坑就是文件遗漏和配置错误。根据我的项目经验，推荐以下步骤：
关键文件清单：
- 从ST官网下载STM32CubeF1 1.8.0和Patch_CubeF1 1.8.4
- 必须包含的HAL驱动文件：
- stm32f1xx_hal_spi.c
- stm32f1xx_hal_gpio.c
- stm32f1xx_hal_rcc.c
- CMSIS核心文件：
- startup_stm32f103xe.s
- system_stm32f1xx.c
工程配置要点：
// 在Keil的Options → C/C++选项卡中添加这些宏定义 #define STM32F103xE #define USE_HAL_DRIVER #define USE_FULL_ASSERT // 重要提示：不要勾选Use MicroLIB串口调试技巧：
// 在common.c中添加重定向代码 int fputc(int ch, FILE *f) { HAL_UART_Transmit(&huart1, (uint8_t*)&ch, 1, HAL_MAX_DELAY); return ch; } // 初始化时调用 void usart_init(uint32_t baudrate) { huart1.Instance = USART1; huart1.Init.BaudRate = baudrate; huart1.Init.WordLength = UART_WORDLENGTH_8B; huart1.Init.StopBits = UART_STOPBITS_1; huart1.Init.Parity = UART_PARITY_NONE; HAL_UART_Init(&huart1); }时钟配置经验：我建议先尝试用HSE（外部晶振），如果失败再自动切换到HSI（内部RC振荡器）。实测发现外部晶振更稳定，但开发阶段用内部时钟更方便调试。
3. ENC28J60驱动开发详解
驱动开发是项目中最具挑战的部分，我花了整整两周时间才调通所有功能。以下是关键实现：
寄存器操作核心函数：
void ENC28J60_WriteRegister(uint8_t addr, uint16_t value) { uint8_t cmd = ENC28J60_WRITE_CTRL_REG | (addr & 0x1F); CS_0(); HAL_SPI_Transmit(&hspi1, &cmd, 1, HAL_MAX_DELAY); HAL_SPI_Transmit(&hspi1, (uint8_t*)&value, 1, HAL_MAX_DELAY); CS_1(); } uint16_t ENC28J60_ReadRegister(uint8_t addr) { uint8_t cmd = ENC28J60_READ_CTRL_REG | (addr & 0x1F); uint8_t value; CS_0(); HAL_SPI_Transmit(&hspi1, &cmd, 1, HAL_MAX_DELAY); HAL_SPI_Receive(&hspi1, &value, 1, HAL_MAX_DELAY); CS_1(); return value; }缓冲区管理策略：ENC28J60的8KB缓冲区需要合理划分：
- 接收缓冲区：0x0000-0x1A0D（6.6KB）
- 发送缓冲区：0x1A0E-0x1FFF（1.4KB）
初始化流程优化：
- 硬件复位后等待CLKRDY标志置位
- 配置接收过滤器（建议启用CRC校验和广播接收）
- 设置MAC参数（全双工模式，MTU=1500）
- 配置PHY（LED行为、双工模式）
数据收发示例：
// 发送数据包 int ENC28J60_SendPacket(uint8_t *data, uint16_t len) { if(ENC28J60_BeginTransmission(len) != 0) return -1; ENC28J60_WriteMemory(data, len); ENC28J60_EndTransmission(); return 0; } // 接收数据包 uint16_t ENC28J60_ReceivePacket(uint8_t *buf) { uint16_t len = ENC28J60_BeginReception(); if(len > 0) ENC28J60_ReadMemory(buf, len); ENC28J60_EndReception(); return len; }4. LWIP协议栈移植技巧
LWIP移植是无操作系统环境下的难点，我总结了一套可靠的方法：
文件结构规划：
lwip-2.1.3/ ├── src/ │ ├── core/ # 核心协议栈 │ ├── netif/ # 网络接口 │ └── apps/ # 应用层 └── include/ # 头文件关键配置修改：
// lwipopts.h 必须配置的参数 #define NO_SYS 1 // 无操作系统 #define LWIP_NETCONN 0 #define LWIP_SOCKET 0 #define MEM_SIZE (10*1024) // 根据SRAM大小调整 #define PBUF_POOL_SIZE 16 #define PBUF_POOL_BUFSIZE 512网络接口绑定：
// 在ethernetif.c中实现low_level_output static err_t low_level_output(struct netif *netif, struct pbuf *p) { pbuf_copy_partial(p, tx_buffer, p->tot_len, 0); return ENC28J60_SendPacket(tx_buffer, p->tot_len) == 0 ? ERR_OK : ERR_MEM; } // 主函数初始化 void netif_init(void) { struct netif netif; ip4_addr_t ipaddr, netmask, gw; IP4_ADDR(&ipaddr, 192, 168, 1, 100); IP4_ADDR(&netmask, 255, 255, 255, 0); IP4_ADDR(&gw, 192, 168, 1, 1); netif_add(&netif, &ipaddr, &netmask, &gw, NULL, ethernetif_init, netif_input); netif_set_default(&netif); }DHCP客户端实现：
// 在主循环中处理DHCP void dhcp_process(void) { static uint32_t dhcp_tick = 0; if(HAL_GetTick() - dhcp_tick > 500) { dhcp_tick = HAL_GetTick(); dhcp_fine_tmr(); if(dhcp_supplied_address(&netif)) { printf("IP: %s\n", ip4addr_ntoa(&netif.ip_addr)); } } }5. 网络功能测试与优化
完成移植后需要进行全面测试，我通常按照以下步骤进行：
基础测试项目：
- Ping测试：
ping 192.168.1.100 - 吞吐量测试：使用iperf测量带宽
- 压力测试：持续ping大包（1472字节）
性能优化技巧：
- 增加PBUF_POOL_SIZE改善多连接性能
- 调整MEM_SIZE防止内存耗尽
- 启用LWIP_STATS查看协议栈状态
常见问题解决方案：
- ping不通：检查ARP缓存
arp -a，确认MAC地址正确 - 随机断连：增加看门狗定时器复位检测
- 吞吐量低：优化SPI时钟和DMA配置
Web服务器示例：
// 初始化HTTP服务 httpd_init(); // 添加自定义页面 const char *html = "<html><body>Hello LWIP!</body></html>"; err_t http_send(struct tcp_pcb *pcb, const char *data) { tcp_write(pcb, data, strlen(data), TCP_WRITE_FLAG_COPY); tcp_close(pcb); return ERR_OK; }通过以上步骤，开发者可以构建稳定的嵌入式网络应用。在实际项目中，建议先用开发板验证所有功能，再迁移到自定义硬件。遇到问题时，善用串口打印和逻辑分析仪是快速定位问题的关键。
