一(yī)、概述      FAST架構的UA編程非常簡單，有其固定的套路，核心部分(fēn)兩塊，一(yī)是在main函數中(zhōng)把環境初始化好，注冊UA的回調函數和配置硬件默認規則；二是在回調函數中(zhōng)專心處理分(fēn)組數據，實現完整業務功能。
     二層交換的分(fēn)組接收由系統回調送入處理函數，後續交換相關的所有邏輯均在該函數裏完成實現。 二、編譯并驗證示例代碼      1）UA示例代碼      百度網盤下(xià)載地址：https://pan.baidu.com/s/13zmKXeMnpUMsCiL5GAI7Vg
     提取碼：ehd7
     目錄：FAST開(kāi)源社區/教學案例/連載公開(kāi)課/二層交換機原型設計與實現      2）代碼文件說明      二層交換代碼目錄爲：/home/hnxs/l2switch/，其下(xià)共包括兩個文件，其中(zhōng)一(yī)個爲main_ul2switch.c主要包括UA的平台性處理代碼和空的callback函數。另一(yī)個是C的編譯文件Makefile文件，主要說明如何編譯生(shēng)成二層交換可執行命令。       3）編譯文件說明

default:
   gcc -o ul2switch main_ul2switch.c -lua -lreg -lpthread
clean:
   rm -rf ul2switch

     二層交換機編譯需要使用到FAST的libreg、libua和系統的libpthread三個庫的支持。      4）編譯, 在/home/hnxs/l2switch/目錄下(xià)輸入以下(xià)命令：

root@HNXS:/home/hnxs/l2switch# make

系統輸出如下(xià)：

gcc -o ul2switch main_ul2switch.c -lua -lreg -lpthread

當前目錄會多産生(shēng)一(yī)個ul2switch文件

root@HNXS:/home/hnxs/l2switch# ls
main_ul2switch.c Makefile ul2switch

     5）執行驗證，在/home/hnxs/l2switch/目錄下(xià)輸入以下(xià)命令：

root@HNXS:/home/hnxs/l2switch# ./ul2switch
fastU->REG Version:20180827,OpenBox HW Version:2020210329
fastU->Register UA to FAST Kernel! Wait Reply......
fastU->UA->pid:3069,mid:129,Register OK!
fastU->libua version:20180827
fastU->fast_ua_recv......

顯示上述結果說明系統平台代碼執行正常。 三、梳理代碼流程      1）C程序的主函數main

/*UA模塊初始化*/
ua_init(mid);
/*配置硬件默認規則，将硬件所有報文送到模塊ID爲mid的進程處理*/
fast_reg_wr(FAST_ACTION_REG_ADDR|FAST_DEFAULT_RULE_ADDR,ACTION_SET_MID<<28|mid);
/*啓動線程接收分(fēn)派給UA進程的報文*/
fast_ua_recv();
/*主進程進入暫停狀态,數據處理主要在回調函數*/
pause();

     2）創建UA，注冊callback

void ua_init(u8 mid)
{
int ret = 0;
/*向系統注冊，自己進程處理報文模塊ID爲mid的所有報文*/
if((ret=fast_ua_init(mid,callback)))//UA模塊實例化(輸入參數1:接收模塊ID号,輸入參數2:接收報文的回調處理函數)
{
perror("fast_ua_init!\n");
exit (ret);//如果初始化失敗,則需要打印失敗信息,并将程序結束退出!
}
}

     3）callback處理函數

int callback(struct fast_packet *pkt,int pkt_len)
{
return 0;
}

四、驗證數據IO功能      1）打印接收分(fēn)組metadata信息      FAST分(fēn)組的數據格式請參考第一(yī)篇文章《二層交換機原型設計與實現（一(yī)）》描述。在callback函數一(yī)開(kāi)始，打印FAST分(fēn)組的metadata信息和以太網協議的源和目的MAC地址信息。

xprintf("inport:%d,dstmid:%d,len:%d,dmac:%02X:%02X:%02X:%02X:%02X:%02X,smac:%02X:%02X:%02X:%02X:%02X:%02X\n",
pkt->um.inport,pkt->um.dstmid,pkt_len,pkt->data[0],pkt->data[1],pkt->data[2],pkt->data[3],pkt->data[4],pkt->data[5],pkt->data[6],pkt->data[7],pkt->data[8],pkt->data[9],pkt->data[10],pkt->data[11]);

     2）調用發送函數發送分(fēn)組      調用FAST的分(fēn)組發送函數，将接收到的一(yī)個分(fēn)組從指定端口發出，要特别注意metadata字段的設置。

void pkt_send_normal(struct fast_packet *pkt,int pkt_len)
{
xprintf("pkt_send_normal->%p,outport:%d,len:%d\n",pkt,pkt->um.outport,pkt_len);
pkt->um.pktsrc = 1;/*報文來源爲CPU輸入，站在硬件角度*/
pkt->um.pktdst = 0;/*報文目的爲硬件輸出*/
pkt->um.dstmid = 5;/*直接從硬件GOE模塊輸出，不走解析、查表等模塊*/
fast_ua_send(pkt,pkt_len);/*調用FAST API函數發送*/
}

     該函數調用之前，必須将pkt->um.outport字段賦值，指定分(fēn)組的輸出端口号。 五、總結與下(xià)一(yī)步      1）核心函數callback      callback函數是整個UA的核心功能函數，是用戶業務實現的開(kāi)始位置。雖然我(wǒ)(wǒ)們今天隻在該函數中(zhōng)做了兩件事情，一(yī)是打印接收到的分(fēn)組基本信息，二是将該分(fēn)組發送到指定端口。但是，我(wǒ)(wǒ)們今天已經在該平台上實現了一(yī)個最簡單的分(fēn)組轉發功能的原型系統了。      2）注釋和備份的重要性      重新性不多說，隻是在此特别的特别的強調一(yī)下(xià)。      3）實現簡單交換邏輯功能      在如此簡單的一(yī)個平台上，能快速實現硬件端口的分(fēn)組接收和指定端口的分(fēn)組發送，是不是網絡功能的一(yī)大(dà)部分(fēn)問題均已經解決？我(wǒ)(wǒ)們隻需要關注我(wǒ)(wǒ)們具體(tǐ)業務的邏輯處理了，你到底是要實現交換還是路由？是普通二層交換還是SDN交換？是普通三層路由還是lisp路由或是segment路由，是不是一(yī)切均有可能？
     不要高興得太早，這隻是萬裏長征的第一(yī)步，起點和終點的距離(lí)必須由自己的腳步來測量，一(yī)步也不能少。所以我(wǒ)(wǒ)們還是從簡單的二層交換機開(kāi)始，下(xià)一(yī)篇文章正式進入分(fēn)組交換的設計。 六、結語       歡迎您和學生(shēng)們加入FAST開(kāi)源項目群溝通與探讨，一(yī)起體(tǐ)驗不一(yī)樣的系統設計過程。請先加微信号15116127200後邀請入群。