之前的帖子介绍如何为NUCLEO-H5E5ZJ适配裸机lwip协议栈。
https://shequ.stmicroelectronics.cn/thread-872013-1-1.html
本文介绍NUCELO-H5E5ZJ运行FreeRTOS+Lwip
1、CubeMX配置
使用CubeMX创建NUCELO-H5E5ZJ开发板的工程,参考之前的帖子设置开发板的外部晶振、调整MCU运行的主频为250MHz,使能ETH外设和设置ETH初始化函数的调用选项。CubeMX中添加和设置X-Cube-FreeRTOS

使能X-Cube-FreeRTOS组件,修改Heap使用的内存大小,并使能USE_STATS_FORMATTING_FUNCTIONS选项,避免编译时的报错。

增大默认的StartDefault任务的栈大小,避免函数调用调用层数过多时导致的栈空间溢出导致的栈溢出。

使能ETH外设的中断

保存并生成代码
2、集成和修改LWIP代码
参考之前的帖子将LWIP的代码库以链接文件夹的方式添加到工程中
复制"stm32h5-classic-coremw-apps\Projects\NUCLEO-H563ZI\Applications\LwIP\LwIP_HTTP_Server_Socket_RTOS\LWIP"文件夹中的应用代码到工程中。
添加应用代码的路径到源码路径,相应的头文件路径也添加到工程管理中


开发板的以太网芯片的型号为lan8742,驱动代码在stm32h5-classic-coremw-apps\Drivers\BSP\Components\lan8742文件夹中可以找到,复制其中的lan8742.c和lan8742.h到工程中。
2.1 LWIP\Target\ethernetif.c 代码修改
由于CubeMX生成会自动生成Ethernet相关的数据结构体,造成重定义问题,修改文件中的变成的声明。
extern ETH_DMADescTypeDef DMARxDscrTab[ETH_RX_DESC_CNT]; /* Ethernet Rx DMA Descriptors */
extern ETH_DMADescTypeDef DMATxDscrTab[ETH_TX_DESC_CNT]; /* Ethernet Tx DMA Descriptors */
/* Global Ethernet handle */
extern ETH_HandleTypeDef heth;
extern ETH_TxPacketConfigTypeDef TxConfig;
删除low_level_output代码中的TxConfig参数配置代码。
/* Set Tx packet config common parameters */
memset(&TxConfig, 0 , sizeof(ETH_TxPacketConfig));
TxConfig.Attributes = ETH_TX_PACKETS_FEATURES_CSUM | ETH_TX_PACKETS_FEATURES_CRCPAD;
TxConfig.ChecksumCtrl = ETH_CHECKSUM_IPHDR_PAYLOAD_INSERT_PHDR_CALC;
TxConfig.CRCPadCtrl = ETH_CRC_PAD_INSERT;
low_level_init函数初始化ETH外设部分的代码调用CubeMX生成的ETH初始化函数MX_ETH_Init,并修改netif中的MAC地址赋值代码。
/*******************************************************************************
LL Driver Interface ( LwIP stack --> ETH)
*******************************************************************************/
/**
* @brief In this function, the hardware should be initialized.
* Called from ethernetif_init().
*
* @param netif the already initialized lwip network interface structure
* for this ethernetif
*/
static void low_level_init(struct netif *netif)
{
uint32_t duplex, speed = 0U;
int32_t PHYLinkState = 0U;
ETH_MACConfigTypeDef MACConf = {0};
/* configure ethernet peripheral (GPIOs, clocks, MAC, DMA) */
MX_ETH_Init();
/* set MAC hardware address length */
netif->hwaddr_len = ETH_HWADDR_LEN;
netif->hwaddr[0] = heth.Init.MACAddr[0];
netif->hwaddr[1] = heth.Init.MACAddr[1];
netif->hwaddr[2] = heth.Init.MACAddr[2];
netif->hwaddr[3] = heth.Init.MACAddr[3];
netif->hwaddr[4] = heth.Init.MACAddr[4];
netif->hwaddr[5] = heth.Init.MACAddr[5];
/* maximum transfer unit */
netif->mtu = ETH_MAX_PAYLOAD;
/* device capabilities */
/* don't set NETIF_FLAG_ETHARP if this device is not an ethernet one */
netif->flags |= NETIF_FLAG_BROADCAST | NETIF_FLAG_ETHARP;
/* Initialize the RX POOL */
LWIP_MEMPOOL_INIT(RX_POOL);
/* create a binary semaphore used for informing ethernetif of frame reception */
RxPktSemaphore = xSemaphoreCreateBinary();
/* create a binary semaphore used for informing ethernetif of frame transmission */
TxPktSemaphore = xSemaphoreCreateBinary();
/* create the task that handles the ETH_MAC */
EthIfHandle = osThreadNew(ethernetif_input, netif, &EthIf_attributes);
/* Set PHY IO functions */
LAN8742_RegisterBusIO(&LAN8742, &LAN8742_IOCtx);
/* Initialize the LAN8742 ETH PHY */
if(LAN8742_Init(&LAN8742) != LAN8742_STATUS_OK)
{
netif_set_link_down(netif);
netif_set_down(netif);
return;
}
PHYLinkState = LAN8742_GetLinkState(&LAN8742);
/* Get link state */
if(PHYLinkState <= LAN8742_STATUS_LINK_DOWN)
{
netif_set_link_down(netif);
netif_set_down(netif);
}
else
{
switch (PHYLinkState)
{
case LAN8742_STATUS_100MBITS_FULLDUPLEX:
duplex = ETH_FULLDUPLEX_MODE;
speed = ETH_SPEED_100M;
break;
case LAN8742_STATUS_100MBITS_HALFDUPLEX:
duplex = ETH_HALFDUPLEX_MODE;
speed = ETH_SPEED_100M;
break;
case LAN8742_STATUS_10MBITS_FULLDUPLEX:
duplex = ETH_FULLDUPLEX_MODE;
speed = ETH_SPEED_10M;
break;
case LAN8742_STATUS_10MBITS_HALFDUPLEX:
duplex = ETH_HALFDUPLEX_MODE;
speed = ETH_SPEED_10M;
break;
default:
duplex = ETH_FULLDUPLEX_MODE;
speed = ETH_SPEED_100M;
break;
}
/* Get MAC Config MAC */
HAL_ETH_GetMACConfig(&heth, &MACConf);
MACConf.DuplexMode = duplex;
MACConf.Speed = speed;
HAL_ETH_SetMACConfig(&heth, &MACConf);
HAL_ETH_Start_IT(&heth);
netif_set_up(netif);
netif_set_link_up(netif);
}
}
由于CubeMX自动生成的代码重定义,删除void HAL_ETH_MspInit(ETH_HandleTypeDef *heth)函数的定义。替换EthHandle变量名为heth;
复制的官方的LwIP_HTTP_Server_Socket_RTOS示例使用LWIP中的自带的http代码,修改LwIP_src文件夹的过滤设置,添加需要的源文件到工程中。

LwIP\src\apps\http\fs.c文件中以下引用实际上将fsdata_custom.c的内容添加到工程中
#include HTTPD_FSDATA_FILE
"httpd_opts.h"
#define HTTPD_FSDATA_FILE "fsdata_custom.c"
这样的设置会导致fsdata_custom.c添加到源码管理中时出现变量重定义的问题,在源码管理中将其过滤,避免出现重定义。

同时添加相应的头文件路径到工程中

2.2 LWIP\App\app_ethernet.c
由于开发板的配置不同,修改相应的LED枚举常量

2.3 main.h和app_freertos.c 代码修改
main.h中添加网络连接相关的宏定义。
/*Static IP ADDRESS: IP_ADDR0.IP_ADDR1.IP_ADDR2.IP_ADDR3 */
#define IP_ADDR0 ((uint8_t) 192U)
#define IP_ADDR1 ((uint8_t) 168U)
#define IP_ADDR2 ((uint8_t) 0U)
#define IP_ADDR3 ((uint8_t) 10U)
/*NETMASK*/
#define NETMASK_ADDR0 ((uint8_t) 255U)
#define NETMASK_ADDR1 ((uint8_t) 255U)
#define NETMASK_ADDR2 ((uint8_t) 255U)
#define NETMASK_ADDR3 ((uint8_t) 0U)
/*Gateway Address*/
#define GW_ADDR0 ((uint8_t) 192U)
#define GW_ADDR1 ((uint8_t) 168U)
#define GW_ADDR2 ((uint8_t) 0U)
#define GW_ADDR3 ((uint8_t) 1U)
app_freertos.c 中添加需要使用到的头文件
/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */
#include "ethernetif.h"
#include "lwip/netif.h"
#include "lwip/tcpip.h"
#include "httpserver_socket.h"
#include "app_ethernet.h"
/* USER CODE END Includes */
添加以太网接口变量以及相应的任务变量
/* Private variables ---------------------------------------------------------*/
/* USER CODE BEGIN Variables */
struct netif gnetif; /* network interface structure */
/* Definitions for Init Thread */
osThreadId_t EthLinkHandle;
const osThreadAttr_t EthLinkThread_attributes = {
.name = "Eth Link",
.priority = (osPriority_t) osPriorityNormal,
.stack_size = configMINIMAL_STACK_SIZE * 8
};
/* Definitions for Init Thread */
osThreadId_t DHCPThreadHandle;
const osThreadAttr_t DHCPThread_attributes = {
.name = "DHCP Thread",
.priority = (osPriority_t) osPriorityBelowNormal,
.stack_size = configMINIMAL_STACK_SIZE * 8
};
/* USER CODE END Variables */
声明和实现网络接口初始化函数
/* Private function prototypes -----------------------------------------------*/
/* USER CODE BEGIN FunctionPrototypes */
static void Netif_Config(void);
/* USER CODE END FunctionPrototypes */
/* Private application code --------------------------------------------------*/
/* USER CODE BEGIN Application */
/**
* @brief Initializes the lwIP stack
* @param None
* @retval None
*/
static void Netif_Config(void)
{
ip_addr_t ipaddr;
ip_addr_t netmask;
ip_addr_t gw;
#if LWIP_DHCP
ip_addr_set_zero_ip4(&ipaddr);
ip_addr_set_zero_ip4(&netmask);
ip_addr_set_zero_ip4(&gw);
#else
IP_ADDR4(&ipaddr,IP_ADDR0,IP_ADDR1,IP_ADDR2,IP_ADDR3);
IP_ADDR4(&netmask,NETMASK_ADDR0,NETMASK_ADDR1,NETMASK_ADDR2,NETMASK_ADDR3);
IP_ADDR4(&gw,GW_ADDR0,GW_ADDR1,GW_ADDR2,GW_ADDR3);
#endif /* LWIP_DHCP */
/* add the network interface */
netif_add(&gnetif, &ipaddr, &netmask, &gw, NULL, ðernetif_init, &tcpip_input);
/* Registers the default network interface. */
netif_set_default(&gnetif);
ethernet_link_status_updated(&gnetif);
#if LWIP_NETIF_LINK_CALLBACK
netif_set_link_callback(&gnetif, ethernet_link_status_updated);
EthLinkHandle = osThreadNew(ethernet_link_thread, &gnetif, &EthLinkThread_attributes);
#endif
#if LWIP_DHCP
/* Start DHCPClient */
DHCPThreadHandle = osThreadNew(DHCP_Thread_Entry, &gnetif, &DHCPThread_attributes);
#endif
}
/* USER CODE END Application */
StartDefaultTaskz中调用tcpip_init()初始化tcpio协议栈,Netif_Config初始化网口和lwip协议栈,http_server_socket_init初始化网页服务器。
/* USER CODE BEGIN Header_StartDefaultTask */
/**
* @brief Function implementing the defaultTask thread.
* @param argument: Not used
* @retval None
*/
/* USER CODE END Header_StartDefaultTask */
void StartDefaultTask(void *argument)
{
/* USER CODE BEGIN defaultTask */
/* Create tcp_ip stack thread */
tcpip_init(NULL, NULL);
/* Initialize the LwIP stack */
Netif_Config();
/* Initialize webserver demo */
http_server_socket_init();
/* Infinite loop */
for(;;)
{
osDelay(1);
}
/* USER CODE END defaultTask */
}
编译并烧录到开发板运行,串口显示开发板通过DHCP获取的IP地址

浏览器中输出开发板的IP,可以获得如下的网页信息

在另一个网页中可以查看到StartDefaultTask的栈使用量为720字节。

将StartDefaultTask改写为如下函数,在初始化完毕后,删除当前的任务,可以节省其占用的任务栈
void StartDefaultTask(void *argument)
{
/* USER CODE BEGIN defaultTask */
/* Create tcp_ip stack thread */
tcpip_init(NULL, NULL);
/* Initialize the LwIP stack */
Netif_Config();
/* Initialize webserver demo */
http_server_socket_init();
/* Delete the Init Thread */
osThreadTerminate(defaultTaskHandle);
/* USER CODE END defaultTask */
}
重新烧录开发板,网页获取的任务列表中defaultTask任务消失。
