📚 课程目录第3章 LwIP内存管理配置与定制

3. LwIP内存管理配置与定制

任务目标

在STM32平台上完成LwIP协议栈内存管理的配置与定制，理解LwIP内存管理三种机制（内存池、内存堆、C库malloc）的差异，并根据实际硬件资源选择并配置合适的方案，最终通过LwIP自带的mem统计接口验证配置生效。

环境与依赖

硬件：STM32F407（内置192KB RAM），或任意等效Cortex-M4开发板
软件：STM32CubeIDE 1.13+，LwIP 2.1.2（STM32CubeFW包内置）
关键文件：lwipopts.h（LwIP配置头文件）、mem.c、memp.c、pbuf.c

核心实现

LwIP内存管理通过lwipopts.h中的宏开关选择机制。本案例采用“内存池+内存堆”混合方案：PBUF、UDP PCB等固定结构使用内存池（MEMP），运行时动态分配使用内存堆（MEM）。该方案兼顾实时性与灵活性，是STM32上最常用的配置。

// lwipopts.h 关键配置片段
#ifndef __LWIPOPTS_H__
#define __LWIPOPTS_H__

/* 内存管理总开关 */
#define MEM_LIBC_MALLOC                 0       // 不使用C库malloc
#define MEMP_MEM_MALLOC                 0       // 内存池不使用堆分配
#define MEM_USE_POOLS                   0       // 不使用POOL堆方案

/* 内存堆配置 */
#define MEM_SIZE                        (10 * 1024)  // 堆大小10KB
#define MEM_ALIGNMENT                   4             // 4字节对齐

/* 内存池配置 */
#define MEMP_NUM_PBUF                   16      // PBUF池数量
#define MEMP_NUM_UDP_PCB                8       // UDP控制块池
#define MEMP_NUM_TCP_PCB                8       // TCP控制块池
#define MEMP_NUM_TCP_PCB_LISTEN         4       // TCP监听块池
#define MEMP_NUM_TCP_SEG                16      // TCP段池
#define MEMP_NUM_NETBUF                 8       // Netbuf池
#define MEMP_NUM_NETCONN                8       // Netconn池

/* 内存统计（验证用） */
#define MEM_STATS                       1       // 开启堆统计
#define MEMP_STATS                      1       // 开启池统计
#define LWIP_STATS                      1       // 总统计开关

#endif /* __LWIPOPTS_H__ */

验证代码

在应用层调用LwIP统计接口，打印内存使用情况。该代码应在网卡初始化并运行tcpip_thread后执行。

// mem_verify.c - 内存配置验证入口
#include "lwip/mem.h"
#include "lwip/memp.h"
#include "lwip/stats.h"

void memory_config_verify(void)
{
    struct mem_stats *mem_stat = &lwip_stats.mem;
    struct memp_stats *memp_stat = &lwip_stats.memp[MEMP_PBUF];

    printf("=== LwIP Memory Config ===\r\n");
    printf("MEM_SIZE: %d bytes\r\n", MEM_SIZE);
    printf("MEMP_NUM_PBUF: %d\r\n", MEMP_NUM_PBUF);

    /* 堆统计 */
    printf("Heap avail: %d, used: %d, err: %d\r\n",
           mem_stat->avail, mem_stat->used, mem_stat->err);

    /* PBUF池统计 */
    printf("PBUF pool avail: %d, used: %d, err: %d\r\n",
           memp_stat->avail, memp_stat->used, memp_stat->err);

    /* 实际分配测试 */
    void *test_buf = mem_malloc(256);
    if (test_buf != NULL) {
        printf("mem_malloc(256) OK, addr: 0x%08X\r\n",
               (unsigned int)test_buf);
        mem_free(test_buf);
        printf("mem_free OK\r\n");
    } else {
        printf("mem_malloc FAILED\r\n");
    }

    struct pbuf *p = pbuf_alloc(PBUF_TRANSPORT, 128, PBUF_RAM);
    if (p != NULL) {
        printf("pbuf_alloc(128) OK\r\n");
        pbuf_free(p);
        printf("pbuf_free OK\r\n");
    } else {
        printf("pbuf_alloc FAILED\r\n");
    }
}

运行与验证

在CubeMX中启用LwIP（RAW API或Netconn API均可），将上述lwipopts.h配置覆盖默认配置
编译烧录后，在网卡初始化完成、tcpip_init()调用之后执行memory_config_verify()
通过串口观察输出

通过判定标准：

串口打印的MEM_SIZE为10240，MEMP_NUM_PBUF为16，与配置一致
Heap avail接近10240（减去堆管理头开销），used为0或极小值
mem_malloc(256)返回非NULL地址，pbuf_alloc成功
若err字段持续为0，说明无分配失败，配置合理

常见问题

编译报错“MEMP_NUM_PBUF未定义”：确认lwipopts.h已被工程正确引用，且未在其它头文件中重复定义
内存不足导致PBUF分配失败：适当增大MEM_SIZE或减少MEMP_NUM_*数量，STM32F407建议总内存占用不超过RAM的60%
开启统计后性能下降：MEM_STATS和MEMP_STATS仅在调试阶段置1，量产时置0即可