Wi-Fi RTT (IEEE 802.11mc, IEEE 802.11az)

ฟีเจอร์เวลาไปกลับ (RTT) ของ Wi-Fi ใน Android 9 ช่วยให้อุปกรณ์ที่รองรับสามารถวัดระยะทางไปยัง อุปกรณ์อื่นๆ ที่รองรับ ไม่ว่าจะเป็นจุดเข้าใช้งาน (AP) หรืออุปกรณ์ที่ใช้ Wi-Fi Aware (หากอุปกรณ์รองรับ Wi-Fi Aware) ฟีเจอร์นี้สร้างขึ้นบนโปรโตคอล IEEE 802.11mc และ IEEE 802.11az (พร้อมใช้งานตั้งแต่ Android 15) ซึ่งช่วยให้แอปใช้ความแม่นยำของตำแหน่งและการรับรู้ที่ได้รับการปรับปรุงได้

ตัวอย่างและแหล่งที่มา

หากต้องการใช้ฟีเจอร์นี้ ให้ติดตั้งอินเทอร์เฟซ HAL ของผู้ให้บริการ ใน Android 14 ขึ้นไป อินเทอร์เฟซ Vendor HAL จะกำหนดโดยใช้ AIDL ใน Android 13 และต่ำกว่า อินเทอร์เฟซ Vendor HAL จะกำหนดโดยใช้ HIDL ใน Android 8.0 HIDL ได้เข้ามาแทนที่โครงสร้าง Hardware Abstraction Layer (HAL) ก่อนหน้าซึ่งใช้เพื่อปรับปรุงการติดตั้งใช้งานโดย การระบุประเภทและการเรียกเมธอดที่รวบรวมไว้ในอินเทอร์เฟซและแพ็กเกจ

ทำตามอินเทอร์เฟซ Wi-Fi เพื่อใช้ฟีเจอร์ RTT ของ Wi-Fi โดยขึ้นอยู่กับว่ามีการติดตั้งใช้งานอินเทอร์เฟซใด ดังนี้

  • AIDL: hardware/interfaces/wifi/aidl
  • HIDL: hardware/interfaces/wifi/1.0 ขึ้นไป

คุณดู HAL ของ Wi-Fi รุ่นเดิมเพื่อดูว่า HAL สัมพันธ์กับอินเทอร์เฟซ AIDL และ HIDL อย่างไรได้ที่ hardware/libhardware_legacy/+/android16-qpr2-release/include/hardware_legacy/rtt.h

การใช้งาน

หากต้องการใช้ Wi-Fi RTT คุณต้องให้การสนับสนุนทั้งเฟรมเวิร์กและ HAL/เฟิร์มแวร์

  • Framework:

    • โค้ด AOSP
    • เปิดใช้ RTT ของ Wi-Fi: ต้องใช้ฟีเจอร์ Flag
  • รองรับ HAL ของ Wi-Fi RTT (IEEE 802.11mc หรือ IEEE 802.11az) (ซึ่งหมายถึง การรองรับเฟิร์มแวร์)

หากต้องการใช้ฟีเจอร์นี้ ให้ใช้ AIDL หรืออินเทอร์เฟซ HIDL ของ Wi-Fi และ เปิดใช้ค่าสถานะฟีเจอร์

  • ใน device.mk ที่อยู่ใน device/<oem>/<device> ให้แก้ไขตัวแปรสภาพแวดล้อม PRODUCT_COPY_FILES เพื่อรวมการรองรับฟีเจอร์ Wi-Fi RTT

    PRODUCT_COPY_FILES += frameworks/native/data/etc/android.hardware.wifi.rtt.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/android.hardware.wifi.rtt.xml
    

มิเช่นนั้น ทุกอย่างที่จำเป็นสำหรับฟีเจอร์นี้จะรวมอยู่ใน AOSP

การสุ่ม MAC

เพื่อเพิ่มความเป็นส่วนตัว ที่อยู่ MAC ที่ใช้ในธุรกรรม Wi-Fi RTT ต้องเป็นแบบ สุ่ม กล่าวคือ ต้องไม่ตรงกับที่อยู่ MAC ในตัวของอินเทอร์เฟซ Wi-Fi อย่างไรก็ตาม ในกรณีที่อุปกรณ์เชื่อมโยงกับ AP อุปกรณ์ อาจใช้ที่อยู่ MAC ที่เชื่อมโยงด้วยสำหรับการทำธุรกรรม RTT กับ AP นั้นหรือกับ AP อื่นๆ

การตรวจสอบความถูกต้อง

การทดสอบชุดเครื่องมือทดสอบความเข้ากันได้ (CTS) ของ Android มีไว้สำหรับฟีเจอร์นี้ CTS จะตรวจหา เมื่อเปิดใช้ฟีเจอร์และรวมการทดสอบที่เกี่ยวข้องโดยอัตโนมัติ คุณยังทดสอบฟีเจอร์นี้ได้โดยใช้ Vendor Test Suite (VTS)

การทดสอบหน่วย

การทดสอบแพ็กเกจ RTT ของ Wi-Fi จะดำเนินการโดยใช้

การทดสอบบริการ:

atest com.android.server.wifi.rtt

การทดสอบของผู้จัดการ

atest android.net.wifi.rtt

CTS

การทดสอบชุดเครื่องมือทดสอบความเข้ากันได้ (CTS) ของ Android มีไว้สำหรับฟีเจอร์นี้ CTS จะตรวจหาเมื่อมีการเปิดใช้ฟีเจอร์และรวมการทดสอบที่เกี่ยวข้องโดยอัตโนมัติ จุดเข้าใช้งานที่รองรับ Wi-Fi RTT (IEEE 802.11mc) ต้องอยู่ภายในช่วงของ อุปกรณ์ภายใต้การทดสอบ

คุณทริกเกอร์การทดสอบ CTS ได้โดยใช้สิ่งต่อไปนี้

atest WifiRttTest

การปรับเทียบ

เพื่อให้ Wi-Fi RTT ทำงานได้ดี ช่วงที่ส่งคืนในโปรโตคอล 802.11mc หรือ 802.11az ควรมีความแม่นยำภายในตัวชี้วัดประสิทธิภาพ (KPI) ตามที่อธิบายไว้ในส่วนนี้

สำหรับโปรโตคอล 11mc ที่แบนด์วิดท์ที่ระบุ (80 MHz, 40 MHz, 20 MHz) และขนาดการส่งข้อมูลแบบกลุ่มที่ 8 คาดว่า KPI สำหรับการประมาณช่วงจะ มีความแม่นยำต่อไปนี้ที่เปอร์เซ็นไทล์ที่ 90 ของข้อผิดพลาด

  • 80 MHz: 2 เมตร
  • 40 MHz: 4 เมตร
  • 20 MHz: 8 เมตร

สำหรับโปรโตคอล 11az การกำหนดค่า MIMO ของเสาอากาศและการทำซ้ำฟิลด์การฝึกแบบยาว (LTF) จะส่งผลต่อความแม่นยำ เมื่อใช้โทรศัพท์มือถือทั่วไป (ใช้เสาอากาศ 2 เสา) และจุดเข้าใช้งาน (เสาอากาศ 4 เสา) ระบบจะมีกำหนดค่า MIMO 2x4 สำหรับการกำหนดค่าดังกล่าวโดยใช้ปัจจัยการทำซ้ำ LTF เป็น 2 และที่แบนด์วิดท์ที่ระบุ (160 MHz, 80 MHz, 40 MHz, 20 MHz) คาดว่า KPI สำหรับการประมาณช่วงจะมีความแม่นยำต่อไปนี้ ที่เปอร์เซ็นไทล์ที่ 90 ของข้อผิดพลาด

  • 160 MHz: 0.5 เมตร
  • 80 MHz: 1 เมตร
  • 40 MHz: 2 เมตร
  • 20 MHz: 4 เมตร

คุณต้องทำการทดสอบการปรับเทียบ เพื่อให้แน่ใจว่าการใช้งานฟีเจอร์ทำงานได้อย่างถูกต้อง

ซึ่งทำได้โดยการเปรียบเทียบช่วงข้อมูลจากการสังเกตการณ์โดยตรงกับช่วง RTT โดยประมาณ ที่ระยะทางเพิ่มขึ้น สำหรับการทดสอบความสอดคล้องขั้นพื้นฐาน เราขอแนะนำให้คุณ ตรวจสอบโซลูชันกับอุปกรณ์ที่ทราบว่ามีการปรับเทียบ RTT เราขอแนะนำให้ ทดสอบการปรับเทียบช่วงภายใต้เงื่อนไขต่อไปนี้

  1. ห้องปฏิบัติการแบบเปิดขนาดใหญ่หรือทางเดินที่มีวัตถุโลหะไม่มาก ซึ่งอาจทำให้เกิดการเกิดมัลติพาธสูงผิดปกติ
  2. เส้นทางหรือเส้นทางแบบ Line-Of-Sight (LOS) อย่างน้อย 1 เส้นทางซึ่งมีความยาว 25 ม.
  3. เครื่องหมายที่เพิ่มขึ้นทีละ 0.5 เมตรจากปลายด้านหนึ่งของแทร็กไปยังอีกด้านหนึ่ง
  4. สถานที่สำหรับติดตั้งจุดเข้าถึงที่รองรับ RTT ที่ปลายด้านหนึ่งของแทร็ก โดยติดตั้งสูงจากพื้น 20 ซม. และแท่นยึดแบบเคลื่อนย้ายได้สำหรับโทรศัพท์ Android (หรืออุปกรณ์เคลื่อนที่ Android อื่นๆ ที่อยู่ระหว่างการทดสอบ) ซึ่งสามารถเคลื่อนย้ายไปตาม แทร็กและจัดแนวให้ตรงกับเครื่องหมาย 0.5 ม. โดยติดตั้งสูงจาก พื้น 20 ซม.

  5. เราขอแนะนําให้บันทึกผลการวัดระยะ 50 รายการที่เครื่องหมายแต่ละรายการ พร้อมกับ ระยะห่างจากจุดเข้าใช้งาน ควรคำนวณสถิติ เช่น ค่าเฉลี่ยของช่วงและความแปรปรวน สำหรับตำแหน่งเครื่องหมายแต่ละตำแหน่ง

จากผลลัพธ์ในขั้นตอนที่ 5 สามารถวาดแผนภูมิสำหรับความจริงพื้นฐาน (แกน x) เทียบกับช่วงที่ประมาณ (แกน y) และประมาณเส้นถดถอยที่เหมาะสมที่สุด การปรับเทียบอุปกรณ์ที่เหมาะสมจะทำให้เกิดเส้นที่มีการไล่ระดับสี 1.0 โดยมีออฟเซ็ต 0.0 ม. บนแกน y การเบี่ยงเบนจากค่าเหล่านี้เป็นสิ่งที่ยอมรับได้หากอยู่ภายใน KPI สำหรับแบนด์วิดท์ที่เกี่ยวข้อง หากผลลัพธ์อยู่นอก KPI เราขอแนะนำให้คุณปรับเทียบฟีเจอร์ของอุปกรณ์ใหม่เพื่อให้ผลลัพธ์เป็นไปตามข้อกำหนด KPI