อินเทอร์เฟซ 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 ฉบับร่างดังกล่าวที่นำมาใช้แล้วอาจมีการเปลี่ยนแปลง

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

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

android.hardware.uwb แพ็กเกจมีอินเทอร์เฟซหลัก 2 อย่างดังนี้

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 ผู้ให้บริการตำแหน่งที่ผสานรวม
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) และตัวระบุรหัสการดำเนินการ (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)