STM32H563 HAL库 LWIP裸机移植

一、STM32H563 与 LWIP 简介

STM32H563 是 STMicroelectronics 推出的一款高性能 32 位微控制器，具有丰富的外设和强大的处理能力，适用于各种复杂的嵌入式系统应用。LWIP（Lightweight IP）是一个小型开源的 TCP/IP 协议栈，旨在为嵌入式系统提供轻量级的网络功能，它能够在资源有限的系统中实现网络通信，如实现以太网通信、HTTP 服务器、UDP 和 TCP 连接等功能。

二、LWIP 裸机移植的准备工作

1. 获取 LWIP 源代码：

   • 首先，从 LWIP 的官方网站下载最新的 LWIP 源代码。你可以选择合适的版本，通常需要根据 STM32H563 的资源和项目需求来选择。
   • 将 LWIP 源代码添加到你的 STM32 工程目录中，一般可以将其放在一个单独的文件夹中，例如 LWIP。

2. 配置 LWIP：

   • LWIP 提供了一个 lwipopts.h 文件，用于配置协议栈的各种参数，如内存池大小、TCP 窗口大小、是否支持 IPv6 等。根据 STM32H563 的可用资源和应用需求，对这些参数进行调整。
   • 例如，如果 STM32H563 内存有限，可以适当减小内存池的大小，但要确保不会导致内存不足而影响网络性能。

3. STM32H563 硬件配置：

   • 确保 STM32H563 的以太网外设已正确配置。使用 HAL 库的以太网相关函数，配置以太网的 PHY 和 MAC 层。
   • 配置相应的 GPIO 引脚，将以太网的 RMII 或 MII 接口引脚配置为正确的复用功能。

三、LWIP 移植步骤

1. 添加必要的文件：

   • 将 LWIP 的核心文件（如 core 文件夹下的源文件）添加到工程中，包括 ipv4、ipv6、tcp、udp 等模块的源文件。
   • 同时，添加 netif 文件夹下的文件，用于网络接口的实现。
   • 对于 STM32H563，还需要添加 arch 文件夹下的文件，该文件夹包含了与 STM32 架构相关的适配文件。

2. 修改 sys_arch.c 文件：

   • 在 sys_arch.c 文件中，需要实现与操作系统相关的函数。对于裸机移植，需要实现一些简单的任务管理函数，如 sys_mbox_new、sys_mbox_free 等，这些函数在 LWIP 中用于消息传递和任务同步。
   • 可以使用简单的邮箱或队列机制，使用全局变量和标志位来实现这些功能，而不是依赖于操作系统的任务调度。

3. 实现网络接口函数：

   • 在 ethernetif.c 文件中，实现 low_level_init、low_level_output、low_level_input 等函数。
   • low_level_init 函数用于初始化以太网硬件，包括 MAC 地址的设置、PHY 的初始化和复位。
   • low_level_output 函数负责将数据从 LWIP 协议栈发送到以太网硬件，将数据封装成以太网帧并通过以太网外设发送出去。
   • low_level_input 函数从以太网外设接收数据，并将其传递给 LWIP 协议栈。

四、代码示例

#include "stm32h563xx_hal.h"
#include "lwip/opt.h"
#include "lwip/init.h"
#include "lwip/netif.h"
#include "lwip/etharp.h"
#include "lwip/timeouts.h"
#include "ethernetif.h"

// 以太网句柄
ETH_HandleTypeDef heth;

// 网络接口
struct netif gnetif;

// 系统时钟配置
void SystemClock_Config(void);
// GPIO 初始化
static void MX_GPIO_Init(void);
// ETH 初始化
static void MX_ETH_Init(void);


// 主函数
int main(void)
{
   
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_ETH_Init();

    // 初始化 LWIP
    lwip_init();

    // 添加网络接口
    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(&gnetif, &ipaddr, &netmask