zynq Lwip学习笔记-low_level_input函数

前言

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

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

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

一、概述

• 原型

static struct pbuf * low_level_input(struct netif *netif)

• 参数
  struct netif *netif：代表待处理的端口
• 作用
  该函数low_level_input()主要用于从网络接口的接收队列中获取数据包，并将其转化为一个pbuf结构体指针，以便于在lwIP协议栈中进一步处理。如果接收队列中没有数据，函数会返回NULL。在取出一个数据包后，会返回该数据包的pbuf指针。

二、函数体

/*
 * low_level_input():
 *
 * 这个函数应该分配一个pbuf，并将从网络接口接收到的数据包字节传输到pbuf中。
 */
static struct pbuf * low_level_input(struct netif *netif)
{
    /* 从网络接口的状态中获取xemac结构体指针 */
    struct xemac_s *xemac = (struct xemac_s *)(netif->state);
    
    /* 从xemac结构体状态中获取xemacpsif结构体指针 */
    xemacpsif_s *xemacpsif = (xemacpsif_s *)(xemac->state);
    
    /* 定义pbuf指针p，用于存储从接收队列取出的数据包 */
    struct pbuf *p;

    /* 检查接收队列中是否有数据需要处理 */
    /* see if there is data to process */
    if (pq_qlength(xemacpsif->recv_q) == 0)
        /* 如果没有数据，则返回NULL */
        return NULL;

    /* 从接收队列中取出一个数据包，并赋值给pbuf指针p */
    /* return one packet from receive q */
    p = (struct pbuf *)pq_dequeue(xemacpsif->recv_q);
    
    /* 返回取出的pbuf指针 */
    return p;
}

三、调用关系

被xemacpsif_input调用，调用了pq_qlength和pq_dequeue以检查队列和抽取数据