將lwIP TCP/IP堆棧整合至嵌入式應(yīng)用的界面

輕量化TCP/IP（lwIP）堆棧是TCP/IP協(xié)議的精簡實作，專門設(shè)計用來縮減RAM內(nèi)存的使用量，這使其非常適合用在嵌入式系統(tǒng)。它提供三種獨特的應(yīng)用程序編程接口（API）:
? 未封裝的低階API
? 負責(zé)網(wǎng)絡(luò)通訊的高階 API
? BSD 風(fēng)格的socket套接字 API

本文專注探討使用未封裝API接口的范例。運用未封裝API建置callback回調(diào)函數(shù)的應(yīng)用程序會由核心事件觸發(fā)。
盡管未封裝API較socket套接字API更為復(fù)雜，但由于其處理負荷（overhead）較低，因此能提供高出許多的吞吐量。
接著將探討幾個建構(gòu)在lwIP TCP/IP堆棧之上的范例，其中采用Analog Devices的MAX32570微控制器。開始的部分是一個ping展示，主要從PC向裝置發(fā)送ping探測訊號。后續(xù)的部分介紹TCP Echo服務(wù)器范例，這個初步的服務(wù)器展示對于測試TCP連結(jié)相當(dāng)實用。

ADI的MaximSDK軟件開發(fā)工具包收錄許多必要的軟件與工具，讓用戶針對ADI的MSX32xxx微控制器開發(fā)韌體。套件中有一個lwIP堆棧函式庫檔案「MaximSDKLibrarieslwIP」。圖一顯示MaximSDK文件夾結(jié)構(gòu)中的lwIP函式庫檔案。
 

圖一 : ADI的MaximSDK lwIP 函式庫檔案

lwIP文件夾包含多個子目錄:
? API 文件夾（網(wǎng)絡(luò)通訊與 socket 套接字API）
? 核心文件夾（lwIP 核心檔案，包含 “tcp.c”、“ip.c” 等）
? Netif 文件夾（網(wǎng)絡(luò)接口檔案）
? Include 文件夾（所有l(wèi)wIP include 引入檔案）
? Maxim文件夾（為ADI微控制器設(shè)計的客制化mac 驅(qū)動程序）

lwIP架構(gòu)依循TCP/IP模型結(jié)構(gòu)。TCP/IP通訊協(xié)議是多個分層組成的協(xié)定。TCP/IP通常被看成是一個四層結(jié)構(gòu)的系統(tǒng)，如圖二所示。


 
圖二 : TCP/IP 通訊協(xié)議分層

lwIP 項目檔中一定有一個名為「lwipopts.h」的組態(tài)檔案，以及一個名為「opt.h」的組態(tài)檔案?！竜pt.h」檔案中記錄所有默認(rèn)的堆棧組態(tài)以及其模塊組態(tài)，而「lwipopts.h」則讓用戶能自行設(shè)定堆棧與其模塊的所有組態(tài)。須注意這個檔案并未包含所有可能的lwIP選項。因此，如果在“l(fā)wipopts.h”組態(tài)檔案中沒有定義某項組態(tài)，系統(tǒng)就會采用「opt.h」中定義的預(yù)設(shè)組態(tài)。
類似的情況，lwIP函式庫有一個和程序相關(guān)的表頭文件名為 「lwipcfg.h」。包括控制器的IP地址、網(wǎng)關(guān)地址、網(wǎng)絡(luò)屏蔽地址、以及MAC地址都應(yīng)定義在「lwipcfg.h」檔案。
要在lwIP以及底層的硬件驅(qū)動程序之間建立鏈接，需要用到一個特定平臺專屬的配接層。舉例來說，在為微控制器建置lwIP堆棧時，需要量身設(shè)計的驅(qū)動程序來橋接lwIP堆棧與微控制器的以太網(wǎng)絡(luò)MAC驅(qū)動程序。這個客制化驅(qū)動程序應(yīng)涵蓋以下功能:
? 初始化功能: 此項功能負責(zé)初始化微控制器專屬的MAC驅(qū)動程序
? 傳送功能: 將從TCP堆棧收到的數(shù)據(jù)傳送給以太網(wǎng)絡(luò)MAC驅(qū)動程序，以便進行后續(xù)的傳輸
? 接收功能: 將從以太網(wǎng)絡(luò)MAC驅(qū)動程序收到的封包轉(zhuǎn)送到TCP堆棧

對于ADI微控制器，預(yù)存的客制化驅(qū)動程序已放在「MaximSDKLibrarieslwIPMaximmxc_eth.c」路徑下的MaximSDK。這個驅(qū)動程序可作為包裝器，能包裝微控制器本身的Ethernet MAC （EMAC）外圍函式庫，該函式庫位于「C:MaximSDK LibrariesPeriphDriversSourceEMAC」路徑下的外圍驅(qū)動程序中。

Ping 范例
「ping」指令是一個簡單的工具，用來進行網(wǎng)絡(luò)除錯。其能執(zhí)行因特網(wǎng)控制訊息協(xié)議（ICMP）的echo 響應(yīng)請求，向指定的IP地址傳送一個訊號然后等候回復(fù)。當(dāng)目的地收到這個請求，就會回復(fù)一個echo封包。本章節(jié)解釋如何從Windows PC向微控制器執(zhí)行基本的ping測試以檢查其連結(jié)狀態(tài)，同時還會闡述如何使用微控制器的ping模塊來和PC進行通訊。

以下詳列Windows環(huán)境中ping工具的工作流程:
? 向微控制器傳送4個數(shù)據(jù)封包，然后等待響應(yīng)
? 微控制器將這些數(shù)據(jù)封包傳回PC作為響應(yīng)，亦即回響答復(fù)請求。
? 執(zhí)行ping測試
? 使用以太網(wǎng)絡(luò)線將微控制器EVKIT套件連到PC
? 開啟命令行提示窗口，然后輸入「ping <微控制器的IP地址>」然后按下enter鍵
命令行提示窗口中顯示響應(yīng)，如圖三所示，意謂著在PC與微控制器之間已建立正常運行的連結(jié)


 
圖三 : 命令行提示窗口顯示的 Ping輸出內(nèi)容

從微控制器測試Ping
「lwIP_Ping」檔案是ADI旗下MAX32570微控制器的ping范例，收錄于MaximSDK開發(fā)工具包。該檔案存放在「C:MaximSDKExamples MAX32570lwIP_Ping」，目錄中并提供以下指南:
? 微控制器的IP地址是使用「lwipcfg.h」檔案來設(shè)定。微控制器與PC的IP地址應(yīng)在同一個網(wǎng)段。在微控制器的「lwipcfg.h」檔案中，PC的IP地址應(yīng)設(shè)定成網(wǎng)關(guān)地址。
? 使用以太網(wǎng)絡(luò)線連接PC與MAX32570 EVKIT套件
? 執(zhí)行ping范例碼
? 在eclipse程序中開啟序列終端機 （Window-> Show view -> Terminal）。如圖四所示，如果ping成功，終端機畫面應(yīng)顯示ping的結(jié)果


 
圖四 : 序列終端機顯示的Ping 輸出內(nèi)容

命令行提示窗口僅顯示ping統(tǒng)計數(shù)據(jù)。要檢視實際傳送的數(shù)據(jù)，需要用到一個名為Wireshark的程序。Wireshark能擷取網(wǎng)絡(luò)聯(lián)機所傳送的數(shù)據(jù)。開啟Wireshark后，再選擇以太網(wǎng)絡(luò)選項。另外還能顯示像是來源與目的地MAC地址、來源與目的地IP地址、通訊協(xié)議、以及額外傳送數(shù)據(jù)等細部數(shù)據(jù)。Wireshark顯示的信息如圖五所示。
正如范例所示，傳送的數(shù)據(jù)為 0x00, 0x01… 一直到0x1F。但如果用戶想要修改傳送數(shù)據(jù)的內(nèi)容那該怎么做?


 
圖五 : Wireshark程序中顯示的ping數(shù)據(jù)封包

修改微控制器Ping指令所發(fā)送的數(shù)據(jù)
透過ping指令發(fā)出的數(shù)據(jù)是在「ping. c」檔案中設(shè)定的?！窹ing.c」檔案是ping的傳送程序模塊。要傳送的數(shù)據(jù)大小是以「PING_DATA_SIZE」參數(shù)設(shè)定在“ping.c”檔案中。例如要傳送的數(shù)據(jù)大小為32 字節(jié)。
準(zhǔn)備要傳送的數(shù)據(jù)的定義亦寫在「ping.c」檔案。額外的數(shù)據(jù)緩沖區(qū)會寫入相同的數(shù)據(jù)，如「0x00, 0x01, 0x02…to 0x1F.」。
依據(jù)應(yīng)用程序的需求，如果用戶想要修改數(shù)據(jù)，可以在「ping .c」檔案中修改數(shù)據(jù)緩沖區(qū)。舉例來說，將所有32字節(jié)的數(shù)據(jù)變更成「0x01, 0x01…0x01」。在Wireshark中顯示修改后的「ping .c」檔案。此處使用新的參數(shù)來更新數(shù)據(jù)。

TCP Echo 服務(wù)器
ping范例中采用ICMP來判斷目標(biāo)系統(tǒng)的反應(yīng)狀況。其會使用默認(rèn)數(shù)據(jù)透過網(wǎng)絡(luò)向目標(biāo)接收端傳送一個echo請求。當(dāng)目標(biāo)地址收到這個請求時，它會回復(fù)一個echo應(yīng)答封包。
如果用戶希望從某個裝置向另一個裝置傳送客制化數(shù)據(jù)，可使用TCP協(xié)議進行數(shù)據(jù)傳輸。在標(biāo)準(zhǔn)TCP函式中的Echo服務(wù)主要用來檢查可及性以及判斷各種路由問題。在這項服務(wù)中，服務(wù)器與客戶端都是使用TCP來建立的。當(dāng)服務(wù)器從客戶端收到訊息，它會回復(fù)相同的訊息。
在MaximSDK，「lwIP TCP」原始碼檔案展示如何使用lwIP函式庫中的 TCP函數(shù)。在這個案例中，微控制器扮演TCP服務(wù)器，并會等候客戶端發(fā)送連接請求。接著服務(wù)器會返傳從客戶端送來的數(shù)據(jù)。在TCP Echo服務(wù)器范例中，應(yīng)使用「tcpecho_raw.c」原始碼檔案。依循以下步驟設(shè)定TCP Echo服務(wù)器。

要設(shè)定TCP Echo服務(wù)器:

? 建立一個 socket
? 將socket綁定到宣告的埠號
? 完成綁定后，其會開始監(jiān)聽傳來的連接請求
? 收到連接請求后，其會接受客戶端設(shè)備發(fā)送來的連接請求
? 服務(wù)器接收到客戶端傳來的數(shù)據(jù)
? 最后，其傳回相同的數(shù)據(jù)

圖六的腳本顯示了韌體的結(jié)構(gòu)，該結(jié)構(gòu)是主函數(shù)的一部分。config_emac會初始化EMAC，而MXC_ETH_Init 則會初始化 lwIP堆棧。


 
圖六 : 從腳本片斷觀察韌體的結(jié)構(gòu)

在EMAC與lwIP堆棧完成初始化后，TCP Echo 服務(wù)器會透過tcpecho_raw_init進行初始化。Echo服務(wù)器結(jié)構(gòu)如圖七所示。


 
圖七 : Echo 服務(wù)器初始化結(jié)構(gòu).

Echo服務(wù)器的初始化會建立新的socket。之后它會將指定的IP地址和端口號綁定到新的socket。完成綁定后，其會持續(xù)監(jiān)聽遠程客戶端發(fā)送的連接請求。
要測試TCP服務(wù)器范例，須使用 echotool.exe PC 客戶端工具。echotool.exe執(zhí)行檔應(yīng)存放在C槽，故我們應(yīng)從C槽開啟命令行提示窗口。在客戶端模式中，其會將數(shù)據(jù)傳送到服務(wù)器并檢查是否會回傳。確保一定要在客戶端模式中使用echo工具來測試服務(wù)器范例。

如何測試 TCP Server 范例
? 確保所有連結(jié)都正常運行
? 使用eclipse軟件將范例程序代碼組建成可執(zhí)行程序
? 在除錯模式中執(zhí)行腳本
? 在遠程PC開啟命令行提示窗口。
? 在命令行提示欄中輸入以下指令:
「C:>echotool IP_address /p tcp /r 7 /n 15 /t 2 /d LwIP TCP echo server Example」
IP_address 是實際的機板IP 地址。靜態(tài) IP 地址為192.168.100.200
/p tcp 是通訊協(xié)議 （TCP協(xié)定）
/r 是回應(yīng)服務(wù)器的實際遠程通信埠 （echo port）
/n 是echo請求的數(shù)量
/t 是連接時長限制的秒數(shù)
/d 是請求響應(yīng)的訊息 （像是 「LwIP TCP echo server Example」）


 
圖八 : TCP Echo 服務(wù)器輸出內(nèi)容

TCP協(xié)議和透過網(wǎng)絡(luò)傳送的數(shù)據(jù)，都可透過Wireshark軟件進行檢驗。透過網(wǎng)絡(luò)傳送的封包在會Wireshark中顯示，如圖九所示。透過命令行提示欄傳送的數(shù)據(jù)為「LwIP TCP echo server Example」。在Wireshark程序中也能看到相同的數(shù)據(jù)。


 
圖九 : Wireshark 程序中的TCP Echo 服務(wù)器輸出結(jié)果

總結(jié)
了解并有效率地運用lwIP堆棧的功能以及ICMP協(xié)議為基礎(chǔ)的ping工具和TCP協(xié)議，能為網(wǎng)絡(luò)診斷以及數(shù)據(jù)傳輸開創(chuàng)出眾多的可能性。ADI的MAX32570微控制器與MaximSDK 提供一個扎實的基礎(chǔ)來建置lwIP堆棧，并建構(gòu)可靠的通訊系統(tǒng)。藉由依循本文列舉的范例，即可排除各種網(wǎng)絡(luò)問題，進而創(chuàng)造無縫的鏈接以及確保數(shù)據(jù)完整性。

（本文作者Anju Puthenpurayil為ADI應(yīng)用工程師）