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

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

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

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

หากเฟรมเวิร์ก UWB ไม่สามารถระบุรหัสประเทศของ 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 รองรับ

คำตอบสำเร็จรูปฉบับร่างต่อไปนี้สำหรับ FiRa 2.0 ได้รับการสนับสนุนโดย โมดูล UWB เวอร์ชัน #330810000:

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

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

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