你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

【STM32H5 评测】6、网页监控开发板——FreeRTOS+Lwip

[复制链接]
EPTmachine 发布时间:2026-11-17 19:06

之前的帖子介绍如何为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_add.png

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

Change_HEAP_Size.png

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

increase_startdefault_task_stack_size.png

使能ETH外设的中断

Enable_ETH_NVIC_prio.png

保存并生成代码

2、集成和修改LWIP代码

参考之前的帖子将LWIP的代码库以链接文件夹的方式添加到工程中

复制"stm32h5-classic-coremw-apps\Projects\NUCLEO-H563ZI\Applications\LwIP\LwIP_HTTP_Server_Socket_RTOS\LWIP"文件夹中的应用代码到工程中。

添加应用代码的路径到源码路径,相应的头文件路径也添加到工程管理中

Add_lwip_app_folder.png

Add_lwip_app_include_header.png

开发板的以太网芯片的型号为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文件夹的过滤设置,添加需要的源文件到工程中。

lwipsrc_filter.png

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添加到源码管理中时出现变量重定义的问题,在源码管理中将其过滤,避免出现重定义。

filter_fsdata_custom.png

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

add_lwip_apps_headers.png

2.2 LWIP\App\app_ethernet.c

由于开发板的配置不同,修改相应的LED枚举常量

changeLED_BLUE.png

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, &ethernetif_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地址

Serial_info.png

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

Web_server.png

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

lwip_stack_consum.png

将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任务消失。

delete_defaultTask.png

赞 收藏 评论0 发布时间:2026-11-17 19:06

举报

0个回答

所属标签

相似技术帖

官网相关资源

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版