隨著嵌入式系統(tǒng)功能的多樣化及網(wǎng)絡(luò)在各個(gè)領(lǐng)域中的廣泛應(yīng)用，具有網(wǎng)絡(luò)功能的嵌入式終端擁有更高的使用價(jià)值和更強(qiáng)的通用性。μC/OS-Ⅲ是一個(gè)可裁剪、可固化、可剝奪型的實(shí)時(shí)內(nèi)核，管理任務(wù)的數(shù)目不受限制[1]。作為μC/OS系列的最新版本，μC/OS-Ⅲ提供了實(shí)時(shí)內(nèi)核所能提供的所有服務(wù)，可保證網(wǎng)絡(luò)功能和其他諸多任務(wù)并發(fā)有序地執(zhí)行。但μC/OS-Ⅲ僅僅是一個(gè)實(shí)時(shí)操作系統(tǒng)的內(nèi)核，要實(shí)現(xiàn)網(wǎng)絡(luò)功能還需移植一款符合嵌入式系統(tǒng)要求的以太網(wǎng)協(xié)議棧。LwIP是由瑞典計(jì)算機(jī)科學(xué)研究院開(kāi)發(fā)的輕量型TCP/IP協(xié)議棧，其特點(diǎn)是保持了以太網(wǎng)的基本功能，通過(guò)優(yōu)化減少了對(duì)片內(nèi)存儲(chǔ)資源的占用[2]。一般情況下，具有十幾KB SRAM和幾十KB Flash存儲(chǔ)能力的微控制器即可運(yùn)行LwIP協(xié)議棧[3]。該特點(diǎn)使其廣泛使用于數(shù)據(jù)采集、工業(yè)控制等多個(gè)應(yīng)用領(lǐng)域中。本文論述了使用LM3S9B95微控制器的嵌入式平臺(tái)實(shí)現(xiàn)LwIP 1.4.0版本在μC/OS-Ⅲ上的移植。LM3S9B95是TI公司推出的基于ARM Cortex-M3內(nèi)核的微控制器，其內(nèi)部具有以太網(wǎng)控制器模塊[4]。

1 LwIP的移植過(guò)程
    LwIP的移植主要涉及兩個(gè)方面：操作系統(tǒng)模擬層和硬件驅(qū)動(dòng)層。LwIP在設(shè)計(jì)時(shí)已考慮到在不同操作系統(tǒng)中的可移植性，其內(nèi)部使用的函數(shù)和數(shù)據(jù)結(jié)構(gòu)均為抽象定義[5]。開(kāi)發(fā)者可根據(jù)不同的操作系統(tǒng)要求來(lái)具體實(shí)現(xiàn)相關(guān)的函數(shù)和數(shù)據(jù)結(jié)構(gòu)。同時(shí)，硬件相關(guān)的驅(qū)動(dòng)同樣預(yù)留了接口，開(kāi)發(fā)者可針對(duì)實(shí)際使用情況編寫網(wǎng)絡(luò)控制芯片驅(qū)動(dòng)函數(shù)。另外，對(duì)不同的編譯環(huán)境，開(kāi)發(fā)者還需要編寫部分頭文件定義相關(guān)數(shù)據(jù)結(jié)構(gòu)和宏。LwIP在μC/OS-Ⅲ嵌入式系統(tǒng)中的結(jié)構(gòu)如圖1所示，其中的箭頭框?yàn)橐浦补ぷ餍枰獙?shí)現(xiàn)的模塊。

1.1 操作系統(tǒng)模擬層的編寫
1.1.1 編寫頭文件cc.h
    cc.h文件中包含處理器相關(guān)的變量類型、數(shù)據(jù)結(jié)構(gòu)及字節(jié)對(duì)齊的相關(guān)宏。
    LwIP中使用的基本變量類型均以位數(shù)進(jìn)行命名，為抽象的變量定義，開(kāi)發(fā)者需要根據(jù)所用處理器具體定義。基本變量的定義有兩種方法：一種是將變量直接定義為C語(yǔ)言的基本類型，如unsigned char、int等；另一種是將變量定義為操作系統(tǒng)內(nèi)對(duì)應(yīng)的抽象變量。當(dāng)使用操作系統(tǒng)時(shí)，應(yīng)采用第二種方法。該方法的優(yōu)點(diǎn)是變量對(duì)于處理器是“透明”的，應(yīng)用程序更換硬件平臺(tái)時(shí)無(wú)需修改操作系統(tǒng)模擬層內(nèi)的定義。μC/OS-Ⅲ中對(duì)基本變量的定義在cpu.h文件中，均以CPU為命名前綴。對(duì)于這些變量在μC/OS-Ⅲ中具體如何定義本文不做討論。LwIP要求定義8 bit、16 bit、32 bit和內(nèi)存指針型變量：
    typedef    CPU_INT08U        u8_t;
    typedef    CPU_INT08S        s8_t;
    typedef    CPU_INT16U        u16_t;
    typedef    CPU_INT16S        s16_t;
    typedef    CPU_INT32U        u32_t;
    typedef    CPU_INT32S        s32_t;
    typedef    CPU_INT32U        mem_ptr_t;
    由于ARM處理器的編譯環(huán)境默認(rèn)對(duì)變量存儲(chǔ)采取4 B對(duì)齊方式，而以太網(wǎng)數(shù)據(jù)包等結(jié)構(gòu)體要求處理器按照變量的實(shí)際大小存儲(chǔ)和訪問(wèn)，因此，需要定義相關(guān)的結(jié)構(gòu)封裝宏，使得結(jié)構(gòu)體內(nèi)的成員變量不以4 B對(duì)齊的方式進(jìn)行存儲(chǔ)。移植工作采用了IAR開(kāi)發(fā)環(huán)境，需根據(jù)該環(huán)境定義如下相關(guān)的宏：
    #if defined (__IAR_SYSTEMS_ICC__)
    #define  PACK_STRUCT_BEGIN
    #define  PACK_STRUCT_STRUCT
    #define  PACK_STRUCT_END
    #define  PACK_STRUCT_FIELD(x) x
    #define  PACK_STRUCT_USE_INCLUDES
1.1.2 編寫頭文件sys_arch.h
    sys_arch.h文件要求定義操作系統(tǒng)相關(guān)的數(shù)據(jù)結(jié)構(gòu)和宏。
    LwIP多線程功能需要信號(hào)量和郵箱等結(jié)構(gòu)體，用于多個(gè)任務(wù)的同步和消息的傳遞。μC/OS-Ⅲ中的信號(hào)量OS_SEM和消息隊(duì)列OS_Q可實(shí)現(xiàn)相應(yīng)的功能。LwIP 1.4.0版本中使用了互斥信號(hào)量管理共享的資源，而有些嵌入式操作系統(tǒng)中不包含互斥信號(hào)量的變量類型。為了適應(yīng)不同的操作系統(tǒng)，LwIP定義了宏LWIP_COMPAT_MUTEX。LWIP_COMPAT_MUTEX的值定義為1，則LwIP使用二值信號(hào)量代替互斥信號(hào)量以及相關(guān)的功能函數(shù)。雖然μC/OS-Ⅲ包含了互斥信號(hào)量OS_MUTEX，但LwIP中兩種數(shù)據(jù)結(jié)構(gòu)可相互替換，選擇使用二值信號(hào)量可以減少一定的移植工作。
    #define  LWIP_COMPAT_MUTEX        1
    typedef  OS_SEM                    sys_sem_t;
    typedef  OS_Q                         sys_mbox_t;
    LwIP中包含有必須完整執(zhí)行而不可被打斷的代碼，因此需要使用臨界段代碼保護(hù)的功能。μC/OS-Ⅲ中提供了關(guān)閉中斷和鎖定調(diào)度器兩種臨界段代碼保護(hù)方法。LwIP中的臨界段代碼保護(hù)宏可直接定義為μC/OS-Ⅲ關(guān)閉中斷的對(duì)應(yīng)臨界段代碼保護(hù)宏。
   #define  SYS_ARCH_DECL_PROTECT() CPU_SR_ALLOC()
   #define  SYS_ARCH_PROTECT()  OS_CRITICAL_ENTER()
   #define  SYS_ARCH_UNPROTECT() OS_CRITICAL_EXIT()
1.1.3 編寫源文件sys_arch.c
    sys_arch.c文件要求實(shí)現(xiàn)操作系統(tǒng)模擬層的接口函數(shù)，主要包括對(duì)信號(hào)量和郵箱等數(shù)據(jù)結(jié)構(gòu)的操作以及LwIP線程的操作。
    LwIP的信號(hào)量用于進(jìn)程間的通信，相關(guān)操作主要包括以下幾個(gè)函數(shù)：
    sys_sem_new()            //新建信號(hào)量
    sys_sem_free()            //釋放信號(hào)量
    sys_sem_signal()        //發(fā)送信號(hào)量
    sys_arch_sem_wait()        //阻塞進(jìn)程，等待指定信號(hào)量
    sys_sem_valid()        //檢查信號(hào)量可用性
    sys_sem_set_invalid()    //設(shè)置信號(hào)量不可用
    LwIP的郵箱用于緩存和傳遞數(shù)據(jù)報(bào)文，相關(guān)操作主要包括以下幾個(gè)函數(shù)：
    sys_mbox_new()        //新建郵箱
    sys_mbox_free()        //刪除郵箱
    sys_mbox_post()        //阻塞進(jìn)程，投遞消息至郵箱
    sys_mbox_trypost()        //投遞消息至郵箱，僅一次操作
    sys_arch_mbox_fetch()    //阻塞進(jìn)程，從郵箱中提取消息
    sys_arch_mbox_tryfetch()    //從郵箱中提取消息，僅一次操作
    sys_mbox_valid()        //檢查郵箱可用性
    sys_mbox_set_invalid()    //設(shè)置郵箱不可用
    LwIP使用了μC/OS-Ⅲ中的信號(hào)量OS_SEM和消息隊(duì)列OS_Q結(jié)構(gòu)，以上函數(shù)的實(shí)現(xiàn)調(diào)用了μC/OS-Ⅲ的操作函數(shù)，包括OS?Create()、OS?Del()、OS?Post()和OS?Pend()。在實(shí)現(xiàn)sys_?_new()和sys_?_free()函數(shù)時(shí)，需加入臨界段代碼保護(hù)以確保OS?Create()和OS?Del()在執(zhí)行時(shí)不被打斷，可避免出現(xiàn)系統(tǒng)資源管理錯(cuò)誤。
   err_t  sys_?_new(……)
   {
    OS_ERR err;
    CPU_SR_ALLOC();            //臨界代碼保護(hù)開(kāi)始
    CPU_CRITICAL_ENTER();
    OS?Create(……,&err);
    CPU_CRITICAL_EXIT();        //臨界代碼保護(hù)結(jié)束
    return err;
   }
   void  sys_?_free(……)
   {
    OS_ERR err;
    CPU_SR_ALLOC();            //臨界代碼保護(hù)開(kāi)始
    CPU_CRITICAL_ENTER();
    OS?Del(……, &err );
    CPU_CRITICAL_EXIT();        //臨界代碼保護(hù)結(jié)束
   }
    LwIP 1.4.0版本新添加了sys_?_valid()和sys_?_set_
invalid()，這兩個(gè)函數(shù)的實(shí)現(xiàn)無(wú)需調(diào)用操作系統(tǒng)內(nèi)部的函數(shù)，可由開(kāi)發(fā)者根據(jù)實(shí)際需求實(shí)現(xiàn)。另外，二值信號(hào)量替換了互斥信號(hào)量，相關(guān)的操作函數(shù)也無(wú)需在此文件內(nèi)實(shí)現(xiàn)。在LwIP內(nèi)核中的sys.h文件給出了詳細(xì)的宏定義：
    #if    LWIP_COMPAT_MUTEX
    #define  sys_mutex_t            sys_sem_t
    #define  sys_mutex_new(mutex)    sys_sem_new(mutex, 1)
    #define  sys_mutex_lock(mutex)    sys_sem_wait(mutex)
    #define  sys_mutex_unlock(mutex)    sys_sem_signal(mutex)
    #define  sys_mutex_free(mutex)    sys_sem_free(mutex)
    #define  sys_mutex_valid(mutex)    sys_sem_valid(mutex)
    #define  sys_mutex_set_invalid(mutex)    \
             sys_sem_set_invalid(mutex)
    LwIP建立新進(jìn)程的接口函數(shù)sys_thread_new()要求成功建立一個(gè)任務(wù)并返回任務(wù)優(yōu)先級(jí)。μC/OS-Ⅲ中加入了時(shí)間片輪轉(zhuǎn)調(diào)度功能，使得同一優(yōu)先級(jí)可建立多個(gè)任務(wù)，避免了優(yōu)先級(jí)重復(fù)導(dǎo)致任務(wù)建立失敗的情況。相比于使用μC/OS-Ⅱ或其他不支持同級(jí)任務(wù)的操作系統(tǒng)，sys_thread_new()的實(shí)現(xiàn)僅調(diào)用OSTaskCreate()即可，省略了一些查找可用優(yōu)先級(jí)的容錯(cuò)操作。
    操作系統(tǒng)模擬層的初始化函數(shù)sys_init()由開(kāi)發(fā)者根據(jù)實(shí)際情況進(jìn)行編寫，沒(méi)有固定的規(guī)范要求。該函數(shù)可不執(zhí)行任何操作，但必須在文件內(nèi)實(shí)現(xiàn)。
1.2 硬件驅(qū)動(dòng)層的編寫

    LwIP內(nèi)核文件中給出了驅(qū)動(dòng)文件的參考模板e(cuò)thernetif.c，開(kāi)發(fā)者可根據(jù)其模板的架構(gòu)結(jié)合實(shí)際使用的網(wǎng)絡(luò)控制芯片來(lái)編寫驅(qū)動(dòng)。
    以low_level為前綴的函數(shù)均為網(wǎng)絡(luò)控制芯片相關(guān)的接口函數(shù)，主要包含初始化、接收、發(fā)送等操作。LM3S9B95的以太網(wǎng)控制器模塊包含了MAC層和物理層，有別于傳統(tǒng)的MCU+PHY芯片的結(jié)構(gòu)。因此，實(shí)現(xiàn)驅(qū)動(dòng)函數(shù)時(shí)可直接對(duì)相應(yīng)的寄存器進(jìn)行操作，無(wú)需再次封裝PHY芯片的操作函數(shù)。
    以ethernetif為前綴的函數(shù)要求開(kāi)發(fā)者實(shí)現(xiàn)底層硬件與上層協(xié)議間的接口函數(shù)，包括底層設(shè)備描述結(jié)構(gòu)體的相關(guān)操作、LwIP主線程和以太網(wǎng)中斷服務(wù)函數(shù)等。
1.3 LwIP功能裁剪和定制
    LwIP為開(kāi)發(fā)者提供了一個(gè)功能定制的接口文件lwipopt.h，可根據(jù)系統(tǒng)實(shí)際需求定義宏的值、裁剪功能和配置參數(shù)。例如使用TCP和UDP功能，則需添加下列定義：
    #define    LWIP_TCP        1
    #define    LWIP_UDP        1
    內(nèi)核文件opt.h是lwipopt.h的設(shè)計(jì)模板，包含了所有LwIP功能配置的宏。opt.h文件對(duì)宏定義均采用了#ifndef預(yù)編譯判斷，當(dāng)開(kāi)發(fā)者在lwipopt.h中沒(méi)有對(duì)某個(gè)宏給出定義時(shí)，該文件會(huì)定義一個(gè)默認(rèn)值。
    雖然修改opt.h中的宏定義和在lwipopt.h中編寫宏定義均可實(shí)現(xiàn)剪裁和定制LwIP的功能，但由于修改內(nèi)核文件會(huì)破壞協(xié)議棧的封裝性，為今后的應(yīng)用程序移植和維護(hù)造成隱患，所以開(kāi)發(fā)者不應(yīng)直接修改opt.h內(nèi)的宏定義。
    開(kāi)發(fā)者在編寫lwipopt.h時(shí)，由于每個(gè)宏的默認(rèn)值并不能保證LwIP的正確運(yùn)行，所以應(yīng)對(duì)opt.h中給出的所有宏進(jìn)行定義。例如opt.h中對(duì)于TCP的一些宏定義如下：
    #ifndef    TCPIP_THREAD_STACKSIZE
    #define    TCPIP_THREAD_STACKSIZE        0
    #endif
    #ifndef    TCPIP_MBOX_SIZE
    #define    TCPIP_MBOX_SIZE                      0
    #endif
    LwIP默認(rèn)的TCPIP進(jìn)程堆棧空間為0，TCPIP使用的郵箱空間為0。若開(kāi)發(fā)者在lwipopt.h中不對(duì)這些宏進(jìn)行定義，當(dāng)tcpip_init()對(duì)LwIP進(jìn)行初始化時(shí)，就會(huì)出現(xiàn)錯(cuò)誤致使LwIP無(wú)法正確運(yùn)行。
2 測(cè)試
    測(cè)試工作使用LM3S9B95嵌入式平臺(tái)作為TCP客戶端，一臺(tái)PC作為TCP主機(jī)端。測(cè)試程序中，嵌入式平臺(tái)的IP地址設(shè)為172.21.28.250，主機(jī)IP為172.21.28.253，端口為1020。測(cè)試程序中創(chuàng)建了兩個(gè)任務(wù)：一個(gè)是LwIP主線程，一個(gè)是測(cè)試任務(wù)。LwIP主線程處理以太網(wǎng)協(xié)議的數(shù)據(jù)包，測(cè)試任務(wù)負(fù)責(zé)接收主機(jī)端的數(shù)據(jù)并回傳至主機(jī)端。
    測(cè)試任務(wù)首先初始化底層硬件和協(xié)議棧，包括使能LM3S9B95以太網(wǎng)硬件模塊和中斷、調(diào)用協(xié)議棧內(nèi)核初始化函數(shù)tcpip_init()、初始化網(wǎng)絡(luò)接口的結(jié)構(gòu)體。
   void  My_LwIP_Init(void)
   {
    /* 調(diào)用StellarisWare庫(kù)函數(shù)進(jìn)行硬件初始化 */
    ……
    /* 調(diào)用內(nèi)核初始化函數(shù) */
    tcpip_init();
    /* 初始化netif，設(shè)置本機(jī)的IP、子網(wǎng)掩碼、網(wǎng)關(guān)，綁定netif的回調(diào)函數(shù) */
    netif_add(……);
    netif_set_default(……);
    netif_set_up(……);
   }
    第二步是初始化客戶端。首先創(chuàng)建一個(gè)網(wǎng)絡(luò)連接結(jié)構(gòu)體，再將其綁定至端口并連接到指定的服務(wù)器。
   void  TCP_Client_Init(void)
   {
    pstNetconn = netconn_new(NETCONN_TCP);    //新建連接
    netconn_bind(……);            //綁定端口
    netconn_connect(……);        //連接主機(jī)
   }
    任務(wù)的主循環(huán)中調(diào)用了LwIP具有進(jìn)程阻塞功能的函數(shù)netconn_recv()以接收來(lái)自主機(jī)的數(shù)據(jù)。若數(shù)據(jù)接收正確，則將數(shù)據(jù)發(fā)送回主機(jī)端的PC；若接收不正確，則刪除當(dāng)前的連接，重新連接到主機(jī)。
   while(1)
   {
    err = netconn_recv(……);    // 接收數(shù)據(jù)
    if(err == ERR_OK)        // 數(shù)據(jù)正確
    {
        netconn_write(……);    // 發(fā)送數(shù)據(jù)
        netbuf_delete(……);    // 刪除數(shù)據(jù)緩沖區(qū)
    }
    else
    {
        netconn_delete(……);    // 刪除當(dāng)前連接
        /* 重新連接 */
        ……
    }
   }
    PC主機(jī)端使用了銘心軟體工作室的網(wǎng)絡(luò)調(diào)試助手，通過(guò)該軟件向LM3S9B95客戶端發(fā)送測(cè)試數(shù)據(jù)，客戶端的回傳數(shù)據(jù)也在該軟件內(nèi)顯示。測(cè)試結(jié)果如圖2所示。

    LwIP是一款專為嵌入式系統(tǒng)設(shè)計(jì)的以太網(wǎng)協(xié)議棧，具有占用資源小、基本功能完備和便于移植等特點(diǎn)。其擁有很高的通用性，適用于多種嵌入式操作系統(tǒng)和硬件平臺(tái)[6]。在運(yùn)行實(shí)時(shí)操作系統(tǒng)的應(yīng)用環(huán)境中，移植工作要求開(kāi)發(fā)者實(shí)現(xiàn)操作系統(tǒng)模擬層和硬件驅(qū)動(dòng)層兩個(gè)部分。協(xié)議棧的主進(jìn)程可作為實(shí)時(shí)操作系統(tǒng)的一個(gè)任務(wù)，完整地執(zhí)行網(wǎng)絡(luò)通信功能。μC/OS-Ⅲ是μC/OS系列的最新產(chǎn)品，同樣是一款實(shí)時(shí)操作系統(tǒng)的內(nèi)核，并不具備網(wǎng)絡(luò)通信功能。LwIP移植到μC/OS-Ⅲ中，可使得運(yùn)行該實(shí)時(shí)內(nèi)核的嵌入式終端擁有網(wǎng)絡(luò)通信功能，符合當(dāng)今產(chǎn)品發(fā)展的趨勢(shì)，具有更廣泛的應(yīng)用領(lǐng)域和更高的市場(chǎng)價(jià)值。
參考文獻(xiàn)
[1] LABROSSE J J著.嵌入式實(shí)時(shí)操作系統(tǒng)μC/OS-Ⅲ[M]. 邵貝貝，譯.北京：北京航空航天大學(xué)出版社，2012.
[2] DUNKELS A.Design and implementation of the LwIP TCP/ IP Stack[Z].Sweden：Swedish Institute of Computer Science，2001：21-30.
[3] 熊海泉.μC/OS II下LwIP協(xié)議的移植實(shí)現(xiàn)[J].科技廣場(chǎng)，2005(2)：78-79.
[4] Texas Instruments.Stellaris?誖LM3S9B95 microcontroller data sheet[Z].2011.
[5] 程明，余中華，蘇艷蘋，等.μC/OS II下LwIP協(xié)議棧的移植和測(cè)試[J].微計(jì)算機(jī)信息，2008(23)：79-81.
[6] 余坤杰.LWIP網(wǎng)口通訊協(xié)議在LM3S8962網(wǎng)口上的移植實(shí)現(xiàn)[J].設(shè)計(jì)與分析，2011(27)：155-156.