1、3.1、NotifyNotify組件將硬件中斷抽象成多組邏輯事件，是一種簡單快捷的發送低于32bit信息的通信方式。Notify組件提供了以下接口：1. 初始化并配置Notify組件；Notify_attach();2. 注冊/注銷事件；Notify_registerEvent()/Notify_unregisterEvent()/Notify_registerEventSingle()/Notify_unregisterEventSingle()3. 發送帶參數的事件給某處理器；Notify_sendEvent()4. 通過回調函數接收事件；Notify_FnNotifyCbck()5. 使

2、能/禁用事件；Notify_diableEvent()/Notify_enableEvent()6. 其他邏輯接口；Notify_eventAvailable()/Notify_intLineRegistered()/Notify_numIntLines()/Notify_restore()注：1. 同一個中斷號可以注冊多個事件，同一個事件可以有多個回調函數或者多個宿主（可以是處理器、線程或者任務），事件被觸發后所有宿主都會被喚醒；2. 一個事件可以接收多個宿主發送來的通知（notification），事件所攜帶的參數最大支持32bit；3. 事件是有優先級的，EventId越小優先級越高，事

3、件0的優先級最高，隨著EventId增大優先級依次遞減；當多個事件被觸發，優先級最高的會最先響應；4. Notify模塊使用硬件中斷，因此不能被頻繁調度。Notify組件常用于傳遞附帶消息少于32bit的場景，如信令傳遞、buffer指針傳遞等。在信令傳遞時使用高優先級的事件，如事件0；而在傳遞buffer指針是可以使用低優先級的事件，如事件30等。在Notify_sentEvent() API中帶有參數waitClear，該參數為可選參數，如果waitClear為TRUE，這就意味著多宿主事件無法及時響應，必須等待前一宿主事件結束后才能響應下一宿主；如果waitClear為FALSE，最好不

4、要為事件附帶參數，否則多宿主事件可能會由于消息被覆蓋而出現丟消息的現象。該API最好不要在中斷服務程序(ISR)中調用(特別是waitClear = TRUE時)，否則會導致中斷調度出現異常(表現之一：高優先級的中斷響應會延遲)；此外該API不能再使用GateMP模塊鎖保護的程序段中調用，否則可能會導致操作系統死鎖。由于其他模塊使用了Notify機制，因此在SysLink中預留了部分事件號，這部分事件號用戶需要慎重選用（如果你沒有使用其他組建的話，可以考慮占用這部分事件號）,在注冊事件前可以使用Notify_eventAvailable()來檢查該事件是否可用，即該中斷號上的該事件號是否被注冊

5、。ModuleEvent IdsFrameQBufMgr0FrameQ1MessageQ(TransportShm)2RingIO3NameServerRemoteNotify43.2、MessageQMessageQ，顧名思義，基于隊列的消息傳遞。MessageQ有以下特點： 實現了處理期間變長消息的傳遞； 消息的傳遞都是通過操作消息隊列來實現的； 每個消息隊列可以有多個寫者，但只能有一個讀者；每個任務(task)可以對多個消息隊列進行讀寫； 一個宿主在準備接收消息時，必須先創建消息隊列，而在發送消息前，需要打開預定的接收消息隊列；MessageQ組件常用在滿足以下條件的場景中：1. 在消息

6、傳遞中有多個寫者，但僅有一個讀者；2. 所需要傳遞的消息超過32bit，且長度可變；讀寫者的緩沖區大小相同；3. 處理期間需要頻繁傳遞消息，在這種情況下，消息被依次放入隊列，能保證不會丟消息；4. 消息隊列為空時，調用MessageQ_get()獲取消息時會被阻塞，直到消息隊列被寫入消息；5. 支持處理器間移動消息隊列，在這種情況下，調用MessageQ_open()來定位隊列位置，而消息傳遞部分代碼不需要改動；MessageQ組件提供了以下幾個API：1. 消息隊列初始化：MessageQ_Params_init()2. 消息隊列創建/銷毀：MessageQ_create()/Message

7、Q_delete()，create創建消息隊列，并分配相應存儲空間3. 消息隊列打開/關閉：MessageQ_open()/MessageQ_close()，open時會返回遠程處理器上的QueID的地址。4. 為消息隊列分配堆內存：MessageQ_alloc()/MessageQ_free()5. 為消息隊列注冊/注銷堆內存：MessageQ_registerHeap()/MessageQ_unregisterHeap()6. 向消息隊列中放入/獲取消息：MessageQ_put()/MessageQ_get()7. 其他邏輯API： 獲取消息隊列ID：MessageQ_getQueueI

8、d() 獲取消息隊列中消息數：MessageQ_count() 在消息隊列中嵌入消息：MessageQ_setReplyQueue() 為消息隊列解阻塞：MessageQ_unblock() 為調試消息隊列加入Trace：MessageQ_setMsgTrace()3.3、ListMPListMP實現了多宿主雙向循環鏈表，即該雙向循環鏈表為多個處理器共同擁有，可以由多個處理器共同維護，共同使用。ListMP的實現區別于一般的雙向循環鏈表，因此它不僅具有雙向循環鏈表的特性外，還增添了其他的特性，比如以下幾點： 實現了簡單的多宿主協議，支持多個讀寫者（multi-reader、multi-writ

9、ee）； 使用Gate作為內部保護機制，防止多個宿主處理器同時訪問該鏈表；ListMP的實現并未加入通知機制，如果需要的話，可以在外部封裝是引入Notify機制來實現；使用ListMP機制來管理的buffers都需要從共享內存區分配，包括從堆內存分配的buffers以及動態分配的內存。ListMP組件常用于滿足一下條件的場景中：1. 需要被多個宿主訪問并且需要頻繁傳遞消息或者數據；2. 可用于無規則的消息傳遞，基于鏈表實現，因此讀者可以遍歷所有對象，并選出需要的對象進行處理；如果硬件支持快速隊列，則無法完成隊列遍歷操作(WHY)；3. 可以自定義消息優先級，同樣是基于鏈表實現，讀者可以隨意的選

10、擇在鏈表頭部還是鏈表的尾部來插入消息或者實現鏈表對象的位置調整，進而實現消息的優先級選擇；如果硬件支持快速隊列，則無法完成隊列遍歷操作(WHY)；4. 無內置通知機制，可以靈活的外部通知機制來實現。譬如根據實際情況，選用Notify來實現，亦或是使用選用MessageQ則可以使用最少的中斷資源實現性能優良的通知機制，缺點是需要額外的代碼實現通知機制。ListMP組件提供了以下API接口：1. ListMP參數初始化：ListMP_Params_init()2. ListMP創建/銷毀：ListMP_create()/ListMP_delete()3. ListMP打開/關閉：ListMP_op

11、en()/ListMP_close()4. ListMP相關鏈表操作： 判斷鏈表空：ListMP_empty() 獲取保護鎖：ListMP_getGate() 獲取鏈表頭/表尾：ListMP_getHead()/ListMP_getTail() 鏈表插入操作：ListMP_insert() 獲取鏈表上游元素/下游元素：ListMP_next()/ListMP_prev() 插入元素到鏈表頭/尾：ListMP_putHead()/ListMP_putTail() 刪除元素：ListMP_remove()3.4、GateMPGateMP是針對于多處理器共享資源的一種保護機制，就如其名字一樣，把共享

12、資源比作房子，那么GateMP就是這個房子的門。GateMP組件實現了開關門的機制，用于保護共享資源一次只被一個處理器讀寫。根據SOC硬件資源配置的不同，GateMP的實現有所不同。對于硬件支持Hardware Spinlock的可以基于H/W spinlock來實現GateHwSpinlock；而對于沒有該硬件資源的系統中，則使用軟件方法(Peterson算法)來實現GatePeterson。GateMP組件框架如下：GateMP組件對用戶提供了以下API接口：1. GateMP初始化：GateMP_Params_init()；2. GateMP創建/刪除：GateMP_create()/G

13、ateMP_delete()；3. GateMP打開/關閉：GateMP_open()/GateMP_close()；4. 進入/離開GateMP保護：GateMP_enter()/GateMP_leave()；5. 獲取當前GateMP的保護類型：GateMP_getLocalProtect()/GateMP_getRemoteProtect()；注：如果某個處理器在想使用被某個GateMP保護的共享資源，那么該處理器會被阻塞，直到該資源被釋放（即GateMP_leave()）。3.5、HeapMPHeapMP主要包括HeapBufMP和HeapMemMP，用于共享內存區的堆內存配置和管理。

14、HeapMP具備以下幾個特征： 支持多宿主，即無論是運行HLOS的主處理器還是運行SYS/BIOS的從處理器都可以配置和管理堆內存； 可以將共享內存區配置成緩沖池（buffer pools）； 可以從共享內存區分配和釋放緩沖區；3.5.1、HeapBufMPHeapBufMP為用戶提供了固定大小的緩沖池管理接口；HeapBufMP組件為用戶提供的API接口如下：1. HeapBufMP創建/刪除：HeapBufMP_create()；HeapBufMP_delete()；2. HeapBufMP打開/關閉：HeapBufMP_open()；HeapBufMP_close()；3. HeapBu

15、fMP參數初始化：HeapBufMP_Params_init()；4. HeapBufMP分配/釋放內存：HeapBufMP_alloc()；HeapBufMP_free()；5. HeapBufMP獲取所有狀態：HeapBufMP_getExtendedStats()；HeapBufMP_getStats()；3.5.2、HeapMultiBufMP在SysLink包中并沒有找到相關API，但SysLink UserGuide中有提到.HepMultiBufMP為用戶提供了可配置大小的緩沖池管理接口。3.5.3、HeapMemMPHeapMemMp為用戶提供了基于堆的可變大小的內存管理機制。

16、HeapMemMp組件為用戶提供的接口如下：1. HeapMemMP參數初始化：HeapMemMP_Params_init()；2. HeapMemMP創建/刪除：HeapMemMP_create()/HeapMemMP_delete()；3. HeapMemMP打開/關閉：HeapMemMP_open()/HeapMemMP_close()；4. HeapMemMP分配/釋放內存：HeapMemMP_alloc()/HeapMemMP_free()；5. HeapMemMP獲取內存狀態：HeapMemMP_getExtendedStats()/HeamMemMP_getStats()；6.

17、HeapMemMP恢復內存初始狀態：HeapMemMP_restore()；3.6、FrameQFrameQ是專門為傳遞視頻幀而設計出來的組件。FrameQ的基本數據結構是可用于queue/dequeue數據的數據隊列，封裝了視頻幀緩存指針、幀數據類型、幀寬、幀高、時間戳等信息。對于FrameQ模塊具有以下特征： 支持多個讀者，但寫者唯一； 可以分配和釋放Frames； 可以對指向同一塊內存區多次分配和初始化成新的幀buffer； FrameQ允許有多個隊列，在多通道的運用中，視頻幀會根據通道號被分配到相應的幀隊列中；FrameQ中用于buffer管理的模塊稱為FrameQBufMgr，該模塊

18、用于提供buffer管理接口和通知機制。FrameQ提供以下API接口：1. FrameQ組件初始化/銷毀：FrameQ_setup()/FrameQ_destroy()；2. 創建/刪除FrameQ實例：FrameQ_create()/FrameQ_delete()；3. 打開/關閉FrameQ實例：FrameQ_open()/FrameQ_close()；FrameQ_openByAddr()；4. 為FrameQ實例分配/釋放內存：FrameQ_alloc()/FrameQ_free()；FrameQ_allocv/FrameQ_freev()；5. 插入/釋放FrameQ中幀：Fram

19、eQ_put()/FrameQ_get()；FrameQ_putv()/FrameQ_getv()；6. 復制給定的幀：FrameQ_dup()；7. 注冊/注銷FrameQ通知：FrameQ_registerNotifier()/FrameQ_unregisterNotifier()；8. 強制發送通知：FrameQ_sendNotify()9. 獲取FrameQ中有效幀數/已被釋放的幀數：FrameQ_getNumFrames()/FrameQ_getNumFreeFrames()； FrameQ_getvNumFrames()/FrameQ_getvNumFreeFrames()10.

20、FrameQ控制：FrameQ_control()11. 獲取FrameQ的頭指針：FrameQ_getExtendedHeaderPtr()；12. 獲取幀buffer/幀大小/幀數：FrameQ_getFrameBuffer()/FrameQ_getFrameBufSize()/FrameQ_getNumFrameBuffers()；13. 獲取空數據幀大小/位置：FrameQ_getFrameBufValidSize()/FrameQ_getFrameBufDataStartOffset()；14. 設置空數據幀大小/位置：FrameQ_setFrameBufValidSize()/Fr

21、ameQ_setFrameBufDataStartOffset()；15. 獲取FrameQ默認設置：FrameQ_getConfig()；3.7、RingIORingIO是基于數據流的環形緩沖buffer，而且針對于音視頻數據的特性做了優化。RingIO支持一下特性： 僅支持一個讀者和一個寫者； 讀寫相對獨立，可以在不同的進程或者處理器中同時進行讀寫操作；RingIO為用戶提供了以下接口：1. RingIO參數初始化：RingIO_Params_init()；2. 創建/刪除RingIO對象：RingIO_create()/RingIO_delete()；3. 打開/關閉RingIO對象：R

22、ingIO_open()/RingIO_close()；RingIO_openByAddr()；4. 獲取共享內存請求：RingIO_sharedMemReq()；5. 注冊/注銷RingIO通知：RingIO_registerNotifier()/RingIO_unregisterNotifier()；6. 強制發送RingIO通知：RingIO_sendNotify()；7. 獲取RingIO通知類型：RingIO_setNotifyType()；8. 設置/獲取水印標志/通知類型：RIngIO_setWaterMark()/RIngIO_getWaterMark()9. 獲取/釋放Rin

23、gIO數據：RingIO_acquire()/RingIO_release()；10. 設置/獲取RingIO屬性：RingIO_setvAttribute()/RingIO_getvAttribute()；11. 設置/獲取RingIO固定大小的屬性：RingIO_setAttribute()/RingIO_getAttribute()；12. 刷新RingIO的buffer：RingIO_flush()；13. 獲取有效/空buffer大?。篟ingIO_getValidSize()/RingIO_getEmptySize()；14. 獲取有效/空屬性大?。篟ingIO_getValidA

24、ttrSize()/RingIO_getEmptyAttrSize()；15. 獲取用戶需求buffer的大小/位置：RingIO_getAcquiredSize()/RingIO_getAcquiredOffset()；4、公共組件（基礎組件）Utility Modules包括SharedRegion(IPC中屬于類庫ti.sdo.ipc.SharedRegion)、List、Trace、MultiProc、NameServer等，這些模塊是上層組件實現的基礎。在IPC包中，該組件對應于類庫ti.sdo.utils.4.1、SharedRegion（非常重要，SysLink模塊最基礎的模塊）

25、4.1.1、SharedRegion總覽SharedRegion顧名思義，是共享內存區的意思。SharedRegion模塊負責管理共享內存區。在一個有共享內存的多核架構中，普遍會遇到共享內存映射虛擬地址轉換問題,如下圖所示：SharedRegion有兩種配置方式，即靜態配置方法(對于SYS/BIOS側可以通過cfg腳本配置，而對于HLOS則當從處理器被加載的時候會通過讀取SYS/BIOS共享內存區配置信息來獲取，請參考內核driver/dsp/syslink/notify_shmdriver/notify_shm_drv.c中實現)和動態配置方法(通過SharedRegion模塊提供的API SharedRegion_setEntry()來設置，但值得注意的是這個API只是把入口信息