【 NXP UWB 】教你看懂 UCI Package Format

一.  介紹
什麼是 UCI package format 呢？ UCI 全名為 Ultra-Wideband Command Interface，是制定 UWB 與外部裝置溝通訊息的方式，透過 UCI 資訊可以輕易的變更 UWB 設定和提取 UWB 現有的狀態，這篇內容讓我來教你如何看懂 UCI package format，學會後就可以讓自己更快速去操作 ＵWB 控制哦～ 

二.  NXP UWB UCI Framework 框架與說明

UCI 核心框架定義了訊息交流的基本功能，包含了設備主機（Host）和 UWB 設備（UWBD），而 UWBD 和 Host 之間的訊息交換包含了控制命令訊息、響應訊息和通知訊息。


資料來源：Fira

三.  NXP UWB UCI控制流程框架與說明

圖示說明了 UCI 控制訊息管理和配置 UWBS 設備。 控制訊息由命令、響應和通知組成，僅允許命令從 AP 到 UWB 的方向發送，而響應和通知僅是允許朝其他方向發送。 

資料來源：Fira

四.  NXP UWB UCI Package Format基本組成與說明

1. UCI Package Format－Header 組成：



解釋與說明：

• MT－Message Type : 第 １ 個 Byte 由 3 個高位元（b7－b5）組合而成的訊息類別
• GID－Group Identifier：第 1 個 Byte 由 4 個低位元（b3－b0）組合而成的群組類別
• PBF－Packet Boundary Flag : 第 1 個 Byte 的 b4 為標示 Playload length(L) 後的總資訊是否超過 256Byte 長度資料
• RFU－Reserved for Future Use
• OID－Opcode Identifier：第 2 個 Byte 由 6 個低位元（b5－b0）組合而成Opcode的控制訊息類別
• Playload Length(L)：第 4 個 Byte 為後面資料數的長度，如果超過 256 Byte，需設定PBF內容為1    　　

2. MT（Message Type）定義：

• Command message：為控制指令
• Response message：為控制指令代有Response 訊息指令
• Notification message：為訊息提示　　

3. GID（Group Identifier）與 OID（Opcode Identifier）定議：



資料來源：NXP

五.  NXP UWB UCI Package Format 範例與說明





   

  

  現在，我們用一個範例來解析一下 UCI 的資訊內容：
  當我們看到一組 UCI 內容為 0x40,0x00,0x00,0x01,0x00 資料

• 第 1 個 Byte 的 0x40 的 4 為 MT 資訊，查表為 010b－控制指令代有 Response 訊息指令，如藍色框表示。
• 第 1 個 Byte 的 0x40 的 0 為 GID 資訊，查表為 0000b－GID 屬於 UCI Core Group 類別，如黃色框表示。
• 第 2 個 Byte 的 0x00 的 0 為 OID 資訊，查表為 000000b－OID 屬於 UCI Opcode 類別，如綠色框表示，查表控制項目說明為 DEVICE_RESET_CMD 又有帶DEVICE_RESET_RSP 的響應提示訊息。    
• 第 3 個 Byte 的 0x00 為 RFU，可忽略不看。　　
• 第 4 個 Byte 的 0x01 為 Payload load，指後面所要帶的資料長度有1個Byte，如粉色表示。
• 第 5 個 Byte 的 0x00 查表 DEVICE_RESET_CMD Table 為裝置重置，而設定值為 0x00，並且設定值的資料長度為 1 個 Byte 比對 Payload load 內容是一致的。

好的，以上說明如何看懂 UCI Package Format 規則，對於 UWB 就可以更輕易控制與截取所要的資料內容囉～

六.  UWB 參考文件
1. FiRa Consortium - UCI Generic Specification_v1.1.0.pdf