zynq Lwip学习笔记-tcp_pcb 函数

前言

最近在学习zynq中的lwip协议族，找不到很好的记笔记的地方，所以就用csdn记录一下自己的学习过程。现在对lwip不熟悉，只是把官方的lwip echo server例程跑了一下，能跑通就一点点的照着学了，笔记都是根据自己的理解写的，而且部分内容可能也只针对lwip echo server例程有效，笔记可以供有缘人参考，但不敢保证全对，有不对的地方也期待有高人指点一二。
————————————————

版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

原文链接：https://blog.csdn.net/weixin_40356705/article/details/136824649

一、概述

• 原型

struct tcp_pcb *tcp_new_ip_type(u8_t type)

• 参数
  u8_t type ：是IP地址的类型，其定义在lwip_ip_addr_type中。如果你想同时监听IPv4和IPv6（双栈）的连接，你应该传入IPADDR_TYPE_ANY作为参数，并在绑定时使用IP_ANY_TYPE。
• 作用
  用于创建新的TCP协议控制块（PCB，Protocol Control Block）的函数，名为tcp_new_ip_type。在TCP/IP协议栈中，PCB是一个非常重要的数据结构，用于存储和管理TCP连接的状态信息。

二、函数体

struct tcp_pcb *
tcp_new_ip_type(u8_t type)
{
  // 声明一个指向tcp_pcb结构的指针变量pcb
  struct tcp_pcb *pcb;
  
  // 调用tcp_alloc函数，以正常优先级TCP_PRIO_NORMAL分配一个新的TCP PCB
  pcb = tcp_alloc(TCP_PRIO_NORMAL);

#if LWIP_IPV4 && LWIP_IPV6
  // 如果系统同时支持IPv4和IPv6
  if (pcb != NULL) {
    // 如果分配成功，设置PCB的本地IP地址类型为传入的type
    IP_SET_TYPE_VAL(pcb->local_ip, type);
    // 同时设置PCB的远程IP地址类型也为传入的type
    IP_SET_TYPE_VAL(pcb->remote_ip, type);
  }
#else
  // 如果不支持IPv4和IPv6中的任何一个，则忽略传入的type参数
  LWIP_UNUSED_ARG(type);
#endif /* LWIP_IPV4 && LWIP_IPV6 */
  
  // 返回新创建的PCB，如果创建失败则返回NULL
  return pcb;
}

三、调用关系

被start_application调用，调用tcp_alloc函数创建新的pcb变量