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 校準的設備驗證您的解決方案。範圍校準應在以下條件下進行測試:
- 大型開放實驗室,或沒有大量金屬物體的走廊,可能導致多路徑異常高發生。
- 至少延伸 25m 的視線 (LOS) 軌道/路徑。
- 從軌道一端到另一端的標記增量為 0.5 米。
- 在軌道一端固定 RTT 接入點的位置,安裝在距離地板 20 厘米處,以及用於 Android 手機(或其他正在測試的 Android 移動設備)的可移動支架,可沿軌道移動,並與0.5m 標記,也在地板上方 20cm 處。注意:這種重複性任務可以由小型機器人執行,但人類操作員也可以。
- 應在每個標記處記錄 50 個測距結果,以及與接入點的距離。應為每個標記位置計算統計數據,例如範圍均值和方差。
根據第 5 步的結果,可以針對估計範圍(y 軸)和估計的最佳擬合回歸線繪製基本事實(x 軸)圖表。理想的設備校準將產生一條梯度為 1.0 的線,在 y 軸上偏移 0.0m。如果這些值的偏差在相應帶寬的 KPI 範圍內,則它們是可以接受的。如果結果超出 KPI,則應重新校准設備功能以使結果符合 KPI 規範。