- struct tcp_pcb *tcp_listen(struct tcp_pcb *pcb)
指定一個PCB進入監(jiān)聽狀態(tài)。當一個遠端連接訪問時，函數(shù) tcp_accept()指定的回調函數(shù)將被調用。在調用這個函數(shù)之前一定要使用tcp_bind()函數(shù)綁定一個本地IP和端口號。
tcp_listen() 函數(shù)返回一個新的連接標識符，原始的pcb會被釋放，這是為了節(jié)省內存，使之更適合小內存系統(tǒng)。
如果監(jiān)聽連接的內存無效，tcp_listen()函數(shù)返回NULL，如果這樣的話，傳入的PCB參數(shù)將不會被釋放。
這個函數(shù)從原理上看也比較簡單,首先是做一些必要的檢查,判斷原始pcb是否已經處于連接狀態(tài),如果沒有則申請一塊tcp_pcb類型的內存,將原始的必要的pcb內容復制到新的pcb中,設置新的pcb狀態(tài)為LISTEN,釋放原始的pcb,并將新pcb連接放入已監(jiān)聽隊列。
- struct tcp_pcb *tcp_listen_with_backlog(struct tcp_pcb *pcb, u8_t backlog)
這個函數(shù)和tcp_listen()函數(shù)相同，只是限制了TCP監(jiān)聽隊列連接個數(shù)，這個個數(shù)由backlog參數(shù)指定。為了使用它，你必須在你的lwipopt.h中設置TCP_LISTEN_BACKLOG=1。
- void tcp_accepted(struct tcp_pcb *pcb)
通知lwIP一個傳入的連接已經被接受。通常這個函數(shù)在“accept()”函數(shù)的回調函數(shù)中被調用。這允許lwIP處理自身內部的任務。比如，允許更多傳入的連接進入監(jiān)聽隊列。
- void tcp_accept(struct tcp_pcb *pcb,
err_t (* accept)(void *arg, struct tcp_pcb *newpcb,
err_t err))
指定應在偵聽連接上的一個新的連接到達時調用的回調函數(shù)。
- err_t tcp_connect(struct tcp_pcb *pcb, struct ip_addr *ipaddr,
u16_t port, err_t (* connected)(void *arg,
struct tcp_pcb *tpcb,
err_t err));
設置打開連接的pcb連接到遠程主機并發(fā)送初始的SYN段。
函數(shù)tcp_connect() 會立即返回；它并不等待這個連接是否被正確設置。相反的，當連接正確建立后它將調用第四個參數(shù)（"connected"參數(shù)）指定的函數(shù)。如果這個連接不能正確的建立，可能是主機拒絕這個連接或者主機沒有響應，"connected"函數(shù)將被調用并設置一個相應的參數(shù)。
當入隊的SYN段內存不可用時，tcp_connect()函數(shù)能返回ERR_MEM，表示連接沒有正確建立。如果SYN成功入隊，tcp_connect()函數(shù)返回ERR_OK。
---TCP數(shù)據(jù)發(fā)送函數(shù)
lwIP會調用tcp_write()函數(shù)來發(fā)送隊列中的數(shù)據(jù)。當數(shù)據(jù)成功的發(fā)送到遠程主機，會調用一個指定的回調函數(shù)來通知應用程序。
- err_t tcp_write(struct tcp_pcb *pcb, void *dataptr, u16_t len,
u8_t copy)
參數(shù)"dataptr"指向數(shù)據(jù)隊列；參數(shù)"len"傳遞數(shù)據(jù)的長度；參數(shù)"copy"的值為0或者1，表明是否需要申請新的內存用于數(shù)據(jù)的拷貝。如果這個參數(shù)為0，則不需要申請新的內存，此時數(shù)據(jù)只能使用指針來引用。
如果數(shù)據(jù)長度超過當前發(fā)送緩存字節(jié)數(shù)或者要發(fā)送的段隊列長度超過lwipopts.h中定義的上限值，tcp_write()函數(shù)執(zhí)行失敗并返回ERR_MEN。可以使用tcp_sndbuf()函數(shù)來返回輸出隊列有效的字節(jié)數(shù)。
使用這個函數(shù)的正確方法是根據(jù)tcp_sndbuf() 函數(shù)返回的字節(jié)數(shù)來發(fā)送數(shù)據(jù)。如果函數(shù)返回ERR_MEM，應用程序應該等待直到當前隊列數(shù)據(jù)成功的被遠程主機收到然后嘗試重新發(fā)送一次。
- void tcp_sent(struct tcp_pcb *pcb,
err_t (* sent)(void *arg, struct tcp_pcb *tpcb,
u16_t len))
當遠程主機成功接收（也就是應答信號）到數(shù)據(jù)時，該函數(shù)指定的回調函數(shù)被調用。傳送給回調函數(shù)的"len"參數(shù)給出了上一次已經被確認的發(fā)送的最大字節(jié)數(shù)。
--TCP數(shù)據(jù)接收函數(shù)
TCP數(shù)據(jù)接收是基于回調函數(shù)的---當一個新的數(shù)據(jù)接收到時，應用程序指定的回調函數(shù)被調用。當應用程序接收到數(shù)據(jù)后，它必須調用tcp_recved()函數(shù)來指示接收數(shù)據(jù)的大小。
- void tcp_recv(struct tcp_pcb *pcb,
err_t (* recv)(void *arg, struct tcp_pcb *tpcb,
struct pbuf *p, err_t err))
當接收到數(shù)據(jù)時，本函數(shù)設置的回調函數(shù)將被調用。如果傳遞給回調函數(shù)一個NULL pbuf則說明遠程主機關閉了這個連接。如果函數(shù)正常運行并且回調函數(shù)返回ERR_OK，則必須釋放這個pbuf，如果其它情況，必須保存這個pbuf，這樣才能讓lwIP內核保存它以供應用程序檢查并恢復錯誤。
- void tcp_recved(struct tcp_pcb *pcb, u16_t len)
當應用程序接收到數(shù)據(jù)后必須調用這個函數(shù)。參數(shù)"len"表明接收到的數(shù)據(jù)的長度。
--- 應用程序輪詢函數(shù)
當一個連接空的時候(也就是說，既沒有數(shù)據(jù)接收也沒有數(shù)據(jù)發(fā)送)，lwIP會通過調用一個指定的回調函數(shù)來重復輪詢應用程序。這可以用作一個看門狗定時器，用來終止空閑時間太長的連接；或者用作等待內存有效的一種方法。舉例來說，如果調用tcp_write()函數(shù)時因為內存無效而失敗，應用程序可以使用輪詢功能在連接空閑的時候再次調用tcp_write()。
- void tcp_poll(struct tcp_pcb *pcb, u8_t interval,
err_t (* poll)(void *arg, struct tcp_pcb *tpcb))
指定輪詢間隔和應用程序輪詢時調用的回調函數(shù)。這個間隔是以TCP粗粒度定時器為單位的，即500毫秒一次。如果參數(shù)"interval"的值為10，則意味著每5秒輪詢一次應用程序。
---關閉和終止連接函數(shù)
- err_t tcp_close(struct tcp_pcb *pcb)
關閉連接。如果關閉的連接內存無效，函數(shù)返回ERR_MEM，如果是這樣的話，應用程序應該等待并通過使用acknowledgment回調函數(shù)或者輪詢功能重新關閉連接。如果連接關閉成功，函數(shù)返回WRR_OK。
TCP內核調用tcp_close()后，參數(shù)"pcb"指定的連接被解除。
- void tcp_abort(struct tcp_pcb *pcb)
通過向遠程主機發(fā)送一個RST（復位）段來終止連接。這個函數(shù)從不會失敗。
如果這個連接因為一個錯誤而被終止，則應用程序可以通過err回調函數(shù)靈活的處理這個事件。通常一個連接因錯誤而終止的原因是內存不足。這時使用tcp_err（）函數(shù)設置的回調函數(shù)被調用。
- void tcp_err(struct tcp_pcb *pcb, void (* err)(void *arg,
err_t err))
指定一個處理錯誤的回調函數(shù)，該回調函數(shù)不能得到本函數(shù)的"pcb"作為它的參數(shù)，因為這個pcb可能已經被解除。
--- 低層次TCP接口
在系統(tǒng)的較低層，TCP提供一個簡單的接口。在系統(tǒng)初始化的時候，任何其他TCP函數(shù)被調用之前必須先調用tcp_init()函數(shù)。當系統(tǒng)已經運行，兩個定時器函數(shù)tcp_fasttmr() 和tcp_slowtmr()必須定期被調用。tcp_fasttmr()函數(shù)必須每隔TCP_FAST_INTERVAL（定義在tcp.h中）個毫秒被調用一次，tcp_slowtmr() 函數(shù)必須每隔TCP_SLOW_INTERVAL個毫秒被調用一次。
--- UDP 接口
相比之下，UDP接口要比TCP接口類似，但UDP在低層次的復雜程度上明顯比TCP簡單。
- struct udp_pcb *udp_new(void)ige
創(chuàng)建一個用于UDP通訊的UDP pcb。這個pcb直到綁定本地地址或者連接到遠程地址后才被激活。
- void udp_remove(struct udp_pcb *pcb)
刪除一個指定的連接。
-err_t udp_bind(struct udp_pcb *pcb, struct ip_addr *ipaddr, u16_t port)
為pcb綁定一個本地地址。參數(shù)"ipaddr"為IP_ADDR_ANY時，指定可以監(jiān)聽任何本地IP地址。這個函數(shù)一般都會返回ERR_OK。
- err_t udp_connect(struct udp_pcb *pcb, struct ip_addr *ipaddr, u16_t port)
設置pcb連接到遠程主機。這個函數(shù)不產生任何流量，僅設置pcb的遠程地址。
- err_t udp_disconnect(struct udp_pcb *pcb)
刪除遠程端的pcb。這個函數(shù)不產生任何流量，近視刪除pcb的遠程地址。
- err_t udp_send(struct udp_pcb *pcb, struct pbuf *p)
發(fā)送pbuf結構指針p指向的數(shù)據(jù)。這個pbuf不會被釋放。
- void udp_recv(struct udp_pcb *pcb,
void (* recv)(void *arg, struct udp_pcb *upcb,
struct pbuf *p, struct
ip_addr *addr,
u16_t port),
void *recv_arg)
當接收到一個數(shù)據(jù)包后，該函數(shù)指定的回調函數(shù)將被調用。
---系統(tǒng)初始化
一個完整通用的lwIP初始化步驟是不可能實現(xiàn)的，因為它還取決于配置文件(lwipopts.h）的編寫以及初始化額外運行時的環(huán)境（例如硬件定時器）。
當你使用RAW API時，我們可以給你一些建議。
我們假設你使用一個單一的以太網netif和UDP、TCP傳輸層、IPv4和DHCP客戶端。
安以下順序調用這些函數(shù)：
- stats_init()
清楚運行時被收集的統(tǒng)計結構。
- sys_init()
沒有多大用處，因為我們在lwipopts.h中設置NO_SYS 1
Not of much use since we set the NO_SYS 1 option in lwipopts.h, to be called for easy
configuration changes.
- mem_init()
通過定義MEM_SIZE初始化動態(tài)存儲堆
- memp_init()
通過定義MEMP_NUM_x初始化內存池。
- pbuf_init()
通過定義PBUF_POOL_SIZE初始化pbuf內存池。
- etharp_init()
初始化ARP表和隊列。
注：在這個初始化之后你必須每隔 ARP_TMR_INTERVAL(5秒)個周期間隔調用etharp_tmr 函數(shù)。
- ip_init()
不常用，處理將要放生的改變時被調用。
- udp_init()
清除UDP PCB列表。
- tcp_init()
清除TCP PCB列表并清除一些內部定時器。
注：在這個初始化函數(shù)之后，你必須按預先確定的每個周期內調用tcp_fasttmr() 和 tcp_slowtmr()函數(shù)。
- netif_add(struct netif *netif, struct ip_addr *ipaddr,
struct ip_addr *netmask, struct ip_addr *gw,
void *state, err_t (* init)(struct netif *netif),
err_t (* input)(struct pbuf *p, struct netif *netif))
向netif_list列表中增加你的網絡接口。分配一個netif結構體并傳遞一個指向這個結構體的指針作為第一個參數(shù)。當使用DHCP時給定的ip_addr結構體會被清除，或者用其它數(shù)據(jù)填充它們。"state"指針可能為NULL。
函數(shù)指針"init"必須指向你的以太網netif接口初始化函數(shù)，下面舉例說用該函數(shù)的應用。
err_t netif_if_init(struct netif *netif)
{
u8_t i;
for(i = 0; i < ETHARP_HWADDR_LEN; i++) netif->hwaddr[i] = some_eth_addr[i];
init_my_eth_device();
return ERR_OK;
}
為使用以太網驅動器（For ethernet drivers），函數(shù)指針"input"必須指向"netif/etharp.h"中聲明的ethernet_input() 函數(shù)。其它驅動器（Other drivers）必須使用"lwip/ip.h"中聲明的ip_input()函數(shù)。
- netif_set_default(struct netif *netif)
注冊默認網絡接口
- netif_set_up(struct netif *netif)
當netif完全配置后，這個函數(shù)必須被調用。
- dhcp_start(struct netif *netif)
在第一次調用時為這個接口創(chuàng)建一個新的DHCP客戶端。
注：啟動這個客戶端后你必須按照預先設定的間隔周期性的調用dhcp_fine_tmr() 和dhcp_coarse_tmr()函數(shù)。
你可以通過結構體netif->dhcp查看真實的DHCP狀態(tài)。
--- 優(yōu)化提示
首先要做的是優(yōu)化src/core/inet.c中的lwip_standard_checksum()程序。你可以使用
#define LWIP_CHKSUM <your_checksum_routine>
來重寫這個標準函數(shù)。
inet.c中使用C語言編寫的例子，你也可以使用匯編語言編寫。
RFC1071是這個主題的很好的介紹。
如果你使用小端處理器，另一個有效的改善是用匯編語言或者內聯(lián)函數(shù)代替htons() 和 htonl()函數(shù)。
#define LWIP_PLATFORM_BYTESWAP 1
#define LWIP_PLATFORM_HTONS(x) <your_htons>
#define LWIP_PLATFORM_HTONL(x) <your_htonl>
如果你的網絡讀到的速度比最大線速還要大，檢查你的網絡接口。如果硬件不能提供良好的服務，會經常快速的發(fā)生緩沖區(qū)溢出現(xiàn)象。舉例來說，當使用cs8900處理器時，調用cs8900if_service(ethif)函數(shù)可能很頻繁出現(xiàn)上述現(xiàn)象。當使用的RTOS允許cs8900使用中斷喚醒一個服務于一個你的使用一個二進制信號量或事件標志的驅動程序的高優(yōu)先級任務。
當產品發(fā)布時，建議設置LWIP_STATS為0。
實際當中，太多的函數(shù)會造成難以維護，所以會適量精簡。
| 歡迎光臨 (http://www.zg4o1577.cn/bbs/) | Powered by Discuz! X3.1 |