UA編程API是FAST平臺支持軟硬協同分組處理的基礎。基本編程API為UA提供了與硬件流水線交互的基本手段。擴展API是面向FAST流水線中特定硬件模塊而設計的API，主要通過對基本API再次封裝實現。擴展API的使用可以大大簡化UA編程的復雜性。本文以SDN交換規則管理為例，詳細介紹擴展API的優點，實現方法和工作流程。
一、擴展API簡介
FAST基本API為FAST流水線中硬件模塊設計者提供了與軟件通信的接口。模塊設計者還應根據模塊提供的功能，基于基本API為用戶提供擴展的API，以簡化UA編程的復雜性。
（1）擴展API的優點
擴展API可以簡化用戶UA編程的復雜性。例如，FAST的SDN交換流水線包含了GPP，GKE，GME，GAC和GOE等功能模塊。UA需要配置GME（通用匹配引擎）模塊的規則表和GAC（通用動作執行）模塊中的動作表以實現對特定報文的match-action操作。UA直接使用fast_ua_hw_rd()和fast_ua_hw_wr()函數對GME和GAC模塊中的表進行配置存在兩個不便。
一是每次操作必須提供操作地址等底層信息，而這一信息與硬件模塊實現相關。UA使用這些地址對低層配置與SDN交換機需要對轉發層進行抽象的原則相違背；二是由于fast_ua_hw_rd()和fast_ua_hw_wr()函數每次只能訪問32位數據，對一條SDN規則的FlowMod配置需要拆分成訪問不同模塊的多次操作，增加了編程的復雜性。
為簡化SDN規則管理，可在FAST編程庫中可定義一些專用的數據結構。例如描述SDN網絡中流的flow結構，對應FlowMod消息的fast_rule結構等。基于這些結構，可擴展UA編程API，為UA編程提供更高層次的抽象，簡化編程的復雜性。
（2）擴展API實現方法
擴展API的實現主要分為兩個步驟。一是為UA編程定義數據結構，屏蔽底層實現細節；二是根據UA編程需求，設計相應的API函數。以下仍以SDN交換為例說明。
由于SDN轉發面的管理主要是對規則進行增加，刪除等操作，因此FAST定義了Fast_rule數據結構，如下所示。因此UA在編程實現SDN的規則管理時，只需要實現對上述規則的操作即可，而不需要考慮規則的具體存儲地址。我們會在基于FAST的SDN交換實現相關文檔中詳細介紹Fast_rule數據結構。
基于Fast_rule數據結構，可以為SDN規則管理定義如下5個擴展的API。分別實現規則表的初始化、規則添加、規則刪除和規則打印等功能，如下表所示。
顯然，基于上述擴展API，可以方便的實現對SDN轉發規則的管理，簡化了UA設計的復雜度。
二、擴展API的實現
下圖以Fast_add_rule()為例，介紹了擴展API的實現流程。其中UA程序實現了交換機上的openflow通道功能，需要根據SDN控制器發來的Flowmod指令對FAST硬件流水線中的規則進行管理。
以增加規則為例，UA首先按照FlowMod消息中包含的規則和動作信息，構造fast_rule結構體，然后調用FAST編程庫中所提供的fast_rule_add()將fast_rule結構體攜帶的流表配置信息經FAST內核和FAST驅動，寫入硬件GME模塊和硬件GAC模塊所關聯的lookup表中。
圖1 擴展API的執行過程
每個FlowMod消息涉及到對FAST硬件流水線中GME和GAC兩個模塊對應的規則表和action表進行管理，而fast_rule_add()函數向用戶屏蔽了這一硬件實現細節。
