<?xml:namespace prefix = st1 ns = "urn:schemas-microsoft-com:office:smarttags" /> 2009-5-11 LWIP 之API_MSG 结构及其实现<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

 

       从上面一篇的 socket 实现来看，如果要评起到最关键作用的一个结构体，那么 struct api_msg 当之无愧。先看下它的定义：

/** This struct contains a function to execute in another thread context and

    a struct api_msg_msg that serves as an argument for this function.

    This is passed to tcpip_apimsg to execute functions in tcpip_thread context. */

struct api_msg

{

   /** function to execute in tcpip_thread context */

  void (* function)(struct api_msg_msg *msg);

  /** arguments for this function */

  struct api_msg_msg msg;

};

功能说的很清楚。但是具体怎么个操作法还是不知道，没关系，接着看它的调用。

 

       举一个例子，刚好是上一篇中调用，但是没有看具体实现的

err_t netconn_getaddr(struct netconn *conn, struct ip_addr *addr, u16_t *port, u8_t local)

{

  struct api_msg msg;

 

  msg.function = do_getaddr;

  msg.msg.conn = conn;

  msg.msg.msg.ad.ipaddr = addr;

  msg.msg.msg.ad.port = port;

  msg.msg.msg.ad.local = local;

  TCPIP_APIMSG(&msg);

 

  return conn->err;

}

说明一下， api_msg 结构几乎都是在 netconn_xxx 函数中被调用，方式千篇一律，除了 msg.funcion 的赋值不一样外。上面的调用很简单，对该结构体变量赋值，接着就是调用 TCPIP_APIMSG ，这个函数上面讲过，可过去看下。既然如此，就不得不说 mbox 及其相关函数了。

static sys_mbox_t mbox = SYS_MBOX_NULL; 【 tcp.c 】

再看 sys_mbox_t 的定义，在【 src\include\lwip\sys.h 】中

/* For a totally minimal and standalone system, we provide null

   definitions of the sys_ functions. */

typedef u8_t sys_sem_t;

typedef u8_t sys_mbox_t;

typedef u8_t sys_prot_t;

可以看到这里只是简单的定义成了 u8 类型，注意上面的红色字体的说明，很明显这个是可移植的一部分，需要根据不同的平台，不同的操作系统具体定义。可以借鉴 焦海波 大侠的关于 ucos 上对 lwip 的移植笔记来看。

       我们可以看到在 api_msg 结构的处理过程中，所有的信息都是包含在 api_msg_msg 结构体中的， api_msg 只是将其和 function 简单的组合了。下面看下这个牛结构的定义：

/** This struct includes everything that is necessary to execute a function

    for a netconn in another thread context (mainly used to process netconns

    in the tcpip_thread context to be thread safe). */

struct api_msg_msg

{

  /** The netconn which to process - always needed: it includes the semaphore

      which is used to block the application thread until the function finished. */

  struct netconn *conn;

  /** Depending on the executed function, one of these union members is used */

  union

{

    /** used for do_send */

    struct netbuf *b;

    /** used for do_newconn */

    struct {

      u8_t proto;

    } n;

    /** used for do_bind and do_connect */

    struct {

      struct ip_addr *ipaddr;

      u16_t port;

    } bc;

    /** used for do_getaddr */

    struct {

      struct ip_addr *ipaddr;

      u16_t *port;

      u8_t local;

    } ad;

    /** used for do_write */

    struct {

      const void *dataptr;

      int len;

      u8_t apiflags;

    } w;

    /** used ofr do_recv */

    struct {

      u16_t len;

    } r;

#if LWIP_IGMP

    /** used for do_join_leave_group */

    struct {

      struct ip_addr *multiaddr;

      struct ip_addr *interface;

      enum netconn_igmp join_or_leave;

    } jl;

#endif /* LWIP_IGMP */

#if TCP_LISTEN_BACKLOG

    struct {

      u8_t backlog;

    } lb;

#endif /* TCP_LISTEN_BACKLOG */

  } msg;

};

一个很合理的设计，至少笔者是这么认为的。关键在于msg union的设计。