Wi-Fi RTT (IEEE 802.11mc)

Android 9 中的Wi-Fi 往返時間 (RTT)功能使支持設備能夠測量與其他支持設備的距離:無論它們是接入點 (AP) 還是 Wi-Fi 感知對等設備(如果Wi-Fi 感知在設備)。此功能基於 IEEE 802.11mc 協議,使應用程序能夠使用增強的位置準確性和感知能力。

示例和來源

要使用此功能,請實現 Android 開源項目 (AOSP) 中提供的 Wi-Fi 硬件接口設計語言 (HIDL)。在 Android 8.0 中,HIDL 取代了以前的硬件抽象層 (HAL) 結構,該結構通過指定收集到接口和包中的類型和方法調用來簡化實現。

按照 Wi-Fi HIDL 使用 Wi-Fi RTT 功能: hardware/interfaces/wifi/1.0 /wifi/1.0 或更高版本。

您可以參考舊版 Wi-Fi HAL 以了解它與新 HIDL 接口的關係: hardware/libhardware_legacy/+/master/include/hardware_legacy/rtt.h

執行

要實現 Wi-Fi RTT,您必須同時提供框架和 HAL/固件支持:

  • 框架:

    • AOSP 代碼
    • 啟用 Wi-Fi RTT:需要功能標誌
  • Wi-Fi RTT (IEEE 802.11mc) HAL 支持(這意味著固件支持)

要實現此功能,請實現 Wi-Fi HIDL 並啟用功能標誌:

  • 在位於device/<oem>/<device>device.mk中,修改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 隨機化

為了增強隱私,Wi-Fi RTT 交易過程中使用的 MAC 地址必須是隨機的,即它不能與 Wi-Fi 接口的本地 MAC 地址匹配。但是,作為一個例外,當設備與 AP 關聯時,它可以使用與其關聯的 MAC 地址與該 AP 或其他 AP 進行任何 RTT 事務。

驗證

此功能存在 Android 兼容性測試套件 (CTS) 測試。 CTS 檢測何時啟用該功能並自動包含相關測試。此功能還可以使用供應商測試套件 (VTS)acts/sl4a進行測試,這是一個執行廣泛集成測試的測試套件。

單元測試

Wi-Fi RTT 包測試使用以下命令執行:

服務測試:

atest com.android.server.wifi.rtt

經理測試:

atest android.net.wifi.rtt

集成 (ACTS) 測試

/tools/test/connectivity/acts_tests/tests/google/wifi/rtt/README.md中描述的acts/sl4a 測試套件提供了功能、性能和壓力測試。

中旅

此功能存在 Android 兼容性測試套件 (CTS) 測試。 CTS 檢測何時啟用該功能並自動包含相關測試。支持 Wi-Fi RTT (IEEE 802.11mc) 的接入點必須在被測設備的範圍內。

可以使用以下方式觸發 CTS 測試:

atest WifiRttTest

校準

為了使 Wi-Fi RTT 表現良好,802.11mc 協議中返回的範圍在關鍵性能指標 (KPI) 內非常準確。對於 90% CDF 誤差,在列出的帶寬下,建議的範圍估計 KPI 預計具有以下容差:

  • 80MHz:2米
  • 40MHz:4米
  • 20MHz:8米

為確保該功能的實現正常工作,校準測試是必要的。

這可以通過將地面實況範圍與 RTT 估計範圍在越來越遠的距離上進行比較來實現。對於基本一致性,您應該針對已知經過 RTT 校準的設備驗證您的解決方案。範圍校準應在以下條件下進行測試:

  1. 大型開放實驗室,或沒有大量金屬物體的走廊,可能導致多路徑異常高發生。
  2. 至少延伸 25m 的視線 (LOS) 軌道/路徑。
  3. 從軌道一端到另一端的標記增量為 0.5 米。
  4. 在軌道一端固定 RTT 接入點的位置,安裝在距離地板 20 厘米處,以及用於 Android 手機(或其他正在測試的 Android 移動設備)的可移動支架,可沿軌道移動,並與0.5m 標記,也在地板上方 20cm 處。注意:這種重複性任務可以由小型機器人執行,但人類操作員也可以。
  5. 應在每個標記處記錄 50 個測距結果,以及與接入點的距離。應為每個標記位置計算統計數據,例如範圍均值和方差。

根據第 5 步的結果,可以針對估計範圍(y 軸)和估計的最佳擬合回歸線繪製基本事實(x 軸)圖表。理想的設備校準將產生一條梯度為 1.0 的線,在 y 軸上偏移 0.0m。如果這些值的偏差在相應帶寬的 KPI 範圍內,則它們是可以接受的。如果結果超出 KPI,則應重新校准設備功能以使結果符合 KPI 規範。