อินเทอร์เฟซ HAL ของ UWB

สแต็กแถบความถี่กว้างยิ่งยวด (UWB) ของ AOSP ใช้อินเทอร์เฟซ UCI ที่กำหนดโดย FiRa เป็นพื้นผิว HAL อินเทอร์เฟซ HAL ใช้ไปป์แบบทึบ (IUwbChip::sendUciMessage() และ IUwbClientCallback::onUciMessage()) เพื่อส่ง และรับคำสั่ง การตอบกลับ และการแจ้งเตือนของอินเทอร์เฟซคำสั่ง UWB (UCI) ผู้ให้บริการ UWB ของ Android ทุกรายต้องรองรับข้อความทั้งหมดที่กำหนดไว้ในข้อกำหนดของ FiRa เฟรมเวิร์ก UWB เข้ากันได้แบบย้อนหลังและทำงานร่วมกับ UCI เวอร์ชันใดก็ได้ที่ผู้ให้บริการ UWB นำไปใช้ในอุปกรณ์ เนื่องจากเฟรมเวิร์ก AOSP UWB เป็นโมดูล จึงสามารถเพิ่มการรองรับคำขอเปลี่ยนแปลง (CR) ที่ได้รับอนุมัติจาก ข้อกำหนด UCI ฉบับร่างที่กำหนดเป้าหมายสำหรับการเปิดตัวมาตรฐาน FiRa ที่สำคัญได้ด้วย CR ฉบับร่างดังกล่าวที่นำมาใช้แล้วอาจมีการเปลี่ยนแปลง

คำจำกัดความของอินเทอร์เฟซ

อินเทอร์เฟซ UWB HAL จะกำหนดโดยใช้ AIDL ที่เสถียร อินเทอร์เฟซหลักใช้แพ็กเกจ android.hardware.uwb

ต่อไปนี้คืออินเทอร์เฟซหลัก 2 รายการในandroid.hardware.uwb แพ็กเกจ

IUwbChip.aidl

package android.hardware.uwb;

interface IUwbChip {

 String getName();

 void open(in android.hardware.uwb.IUwbClientCallback clientCallback);

 void close();

 void coreInit();

 void sessionInit(int sessionId);

 int getSupportedAndroidUciVersion();

 int sendUciMessage(in byte[] data);

}

IUwbClientCallback.aidl

package android.hardware.uwb;

interface IUwbClientCallback {

 oneway void onUciMessage(in byte[] data);

 oneway void onHalEvent(in android.hardware.uwb.UwbEvent event, in android.hardware.uwb.UwbStatus status);

}

ลำดับการเรียก HAL จากเฟรมเวิร์ก UWB

รูปภาพต่อไปนี้แสดงโฟลว์การเรียกจากเฟรมเวิร์ก UWB สำหรับการเริ่มต้นสแต็ก UWB, การยกเลิกการเริ่มต้นสแต็ก UWB รวมถึงกระบวนการเริ่มและหยุดเซสชัน UWB

รูปที่ 1 ลำดับการเรียกใช้การเริ่มต้นสแต็ก UWB (เปิด UWB)

รูปที่ 2 ลำดับการเรียกใช้การยกเลิกการเริ่มต้นสแต็ก UWB (ปิดการเปิด/ปิด UWB)

รูปที่ 3 โฟลว์การเริ่ม/หยุดเซสชัน UWB

การกำหนดค่ารหัสประเทศ UWB

ดังที่แสดงในรูปที่ 1 เฟรมเวิร์ก UWB จะกำหนดค่ารหัสประเทศ UWB ในระหว่างการเริ่มต้นสแต็ก UWB โดยใช้คำสั่ง UCI ในพื้นที่ของผู้ให้บริการ ANDROID_SET_COUNTRY_CODE (GID=0xC, OID=0x1) เฟรมเวิร์ก UWB จะพยายาม กำหนดรหัสประเทศ UWB โดยใช้แหล่งที่มาต่อไปนี้ (เรียงตามลำดับความสำคัญ ) เฟรมเวิร์ก UWB จะหยุดที่แหล่งที่มาแรกที่มีการกำหนดรหัสประเทศ

1. ลบล้างรหัสประเทศ: รหัสประเทศที่บังคับผ่านคำสั่ง adb shell (การทดสอบในเครื่องหรืออัตโนมัติ)
2. รหัสประเทศของโทรศัพท์: รหัสประเทศที่ดึงข้อมูลผ่านเครือข่ายมือถือ หากมีซิมหลายซิมที่แสดงรหัสแตกต่างกัน รหัสประเทศที่เลือกจะไม่มีการกำหนด
3. รหัสประเทศ Wi-Fi: รหัสประเทศที่ดึงข้อมูลผ่าน Wi-Fi (80211.ad)
4. รหัสประเทศของโทรศัพท์ที่ทราบล่าสุด: รหัสประเทศที่ทราบล่าสุดซึ่งดึงข้อมูล ผ่านเครือข่ายมือถือ หากมีซิมหลายซิมที่แสดงรหัสแตกต่างกัน รหัสประเทศที่เลือกจะไม่มีการกำหนด
5. รหัสประเทศของสถานที่ตั้ง: รหัสประเทศที่ดึงมาจากLocationManager ผู้ให้บริการ Fused Location
6. รหัสประเทศเริ่มต้นของ OEM: รหัสประเทศที่ผู้ผลิตอุปกรณ์ตั้งค่าไว้

หากเฟรมเวิร์ก UWB ไม่สามารถกำหนดรหัสประเทศ UWB ได้ เฟรมเวิร์กจะเรียกใช้ ANDROID_SET_COUNTRY_CODE คำสั่ง UCI ที่มีค่าเป็น DEFAULT_COUNTRY_CODE ("00") และแจ้งให้แอป UWB ทราบว่า สถานะสแต็ก UWB คือ DISABLED ต่อมาเมื่อเฟรมเวิร์ก UWB สามารถ กำหนดรหัสประเทศที่ถูกต้อง ได้ เฟรมเวิร์กจะกำหนดค่ารหัสประเทศใหม่โดยใช้คำสั่ง ANDROID_SET_COUNTRY_CODE และแจ้งให้แอป UWB ทราบว่าสแต็ก UWB READY

หากใช้ UWB ไม่ได้เนื่องจากกฎระเบียบท้องถิ่นในประเทศหนึ่งๆ ตัวควบคุม UWB จะแสดงรหัสสถานะ STATUS_CODE_ANDROID_REGULATION_UWB_OFF จากนั้นเฟรมเวิร์ก UWB จะ แจ้งให้แอป UWB ทราบว่าสถานะสแต็ก UWB คือ DISABLED

เมื่อผู้ใช้เดินทางไปยังประเทศอื่น เฟรมเวิร์ก UWB จะกำหนดค่ารหัสประเทศใหม่โดยใช้ANDROID_SET_COUNTRY_CODEคำสั่ง UCI ทั้งนี้ขึ้นอยู่กับ รหัสสถานะที่ตัวควบคุม UWB ส่งคืน (อิงตามกฎระเบียบ UWB ใน ประเทศใหม่) ซึ่งอาจส่งผลให้สถานะสแต็ก UWB เปลี่ยนแปลง

รูปแบบคำสั่งที่กำหนดโดยข้อกำหนด FIRA UCI

ดูรูปแบบของแพ็กเก็ตควบคุม UCI ได้ที่ส่วน 4.4.2 ของ ข้อกำหนด UCI

การกำหนดเวอร์ชันของอินเทอร์เฟซ

ข้อกำหนด UCI ช่วยให้ผู้ให้บริการ UWB แสดงเวอร์ชันของสแต็ก UCI ที่อุปกรณ์ใช้ได้โดยใช้คำสั่ง UCI_GET_DEVICE_INFO_RSP และ UCI_GET_CAPS_INFO_RSP เฟรมเวิร์กใช้คำสั่งเหล่านี้เพื่อดึงข้อมูลเวอร์ชัน UCI ของอุปกรณ์และเปลี่ยนลักษณะการทำงานตามนั้น

รายการคำขอการเปลี่ยนแปลงฉบับร่างที่โมดูล UWB รองรับ

โมดูล UWB เวอร์ชัน #330810000 รองรับ CR ฉบับร่างต่อไปนี้สำหรับ FiRa 2.0

• CR 287
• การรองรับ SUS API และข้อกำหนด UCI สำหรับอินเทอร์เฟซกุญแจดิจิทัลของ CCC ข้อกำหนด

อินเทอร์เฟซ UCI ของ Android (ส่วนของผู้ให้บริการ FiRa)

ข้อกำหนด UCI จะกำหนดชุดตัวระบุกลุ่ม (GID) และตัวระบุ Opcode (OID) สำหรับข้อความทั้งหมดที่กำหนดไว้ในข้อกำหนด ข้อกำหนด ยังสงวนชุด GID ที่สงวนไว้สำหรับการใช้งานของผู้ให้บริการโดยเฉพาะด้วย สแต็ก UWB ของ AOSP ใช้ GID และ OID ของผู้ให้บริการบางรายการสำหรับคำสั่งเฉพาะของ Android ที่ไม่ได้กำหนดไว้ในข้อกำหนด ดูรายละเอียดได้ที่ส่วนที่ 8.4 ของข้อกำหนด UCI

ข้อความของผู้ให้บริการเหล่านี้ที่ Android ใช้จะกำหนดไว้ในแพ็กเกจ HAL ของ android.hardware.uwb.fira_android

การกำหนดเวอร์ชันอินเทอร์เฟซของผู้ให้บริการ

ผู้ให้บริการ UWB ต้องแสดงเวอร์ชันของแพ็กเกจ android.hardware.uwb.fira_android HAL ที่อุปกรณ์รองรับผ่าน IUwbChip.getSupportedAndroidUciVersion() เฟรมเวิร์กใช้ข้อมูลการกำหนดเวอร์ชันนี้เพื่อจัดการความเข้ากันได้แบบย้อนหลัง

รายการ GID และ OID ของ Android

ตารางต่อไปนี้แสดง GID และ OID สำหรับ Android GID 0xE และ 0xF สงวนไว้สำหรับให้ OEM ของ Android ใช้

ส่วนขยายของผู้ให้บริการไปยังข้อความที่กำหนดไว้ในข้อกำหนด UCI

ส่วนนี้จะอธิบายรายละเอียดของส่วนขยายของผู้ให้บริการสำหรับข้อความที่กำหนดโดยข้อกำหนด UCI

SESSION_SET_APP_CONFIG_[CMD|RSP] และ SESSION_GET_APP_CONFIG_[CMD|RSP]

ค่าความยาวประเภท (TLV) ต่อไปนี้กำหนดโดยสแต็ก AOSP ใน ส่วนที่สงวนไว้ของผู้ให้บริการของ TLV ใน APP_CONFIG

• GID: 0001b (กลุ่มการกำหนดค่าเซสชัน UWB)
• OID: 000011b (SESSION_SET_APP_CONFIG_CMD)
• OID: 000100b (SESSION_GET_APP_CONFIG_CMD)

ตารางต่อไปนี้แสดงพารามิเตอร์สำหรับข้อความการกำหนดค่าเซสชัน UWB

CORE_GET_CAPS_INFO_RSP

ต่อไปนี้คือ TLV ที่กำหนดโดยสแต็ก AOSP ในส่วนที่ผู้ให้บริการสงวนไว้ของ TLV ใน CAPS_INFO

• GID: 0000b (กลุ่มหลักของ UWB)
• OID: 000011b (CORE_GET_CAPS_INFO_RSP)

ตารางต่อไปนี้แสดงพารามิเตอร์สำหรับข้อความความสามารถของ UWB

รหัสสถานะ

รหัสสถานะในพื้นที่ของผู้ให้บริการมีดังนี้ โดยจะแสดงในการตอบกลับ UCI (เช่น SESSION_START_RSP) โดยระบบย่อย UWB (UWBS)

รหัสเหตุผลการเปลี่ยนสถานะใน SESSION_STATUS_NTF

รหัสเหตุผลการเปลี่ยนแปลงสถานะที่กำหนดไว้ในพื้นที่ของผู้ให้บริการสำหรับ ฟิลด์สถานะที่ UWBS ส่งคืนใน SESSION_STATUS_NTF มีดังนี้ การแจ้งเตือนนี้ ส่งโดย UWBS เมื่อสถานะของเซสชันการวัดระยะมีการเปลี่ยนแปลง (เช่น จากACTIVEเป็นIDLE)