वाई-फाई आरटीटी (IEEE 802.11mc)

एंड्रॉइड 9 में वाई-फाई राउंड ट्रिप टाइम (आरटीटी) सुविधा सहायक उपकरणों को अन्य सहायक उपकरणों से दूरी मापने में सक्षम बनाती है: चाहे वे एक्सेस प्वाइंट (एपी) हों या वाई-फाई अवेयर पीयर्स (यदि वाई-फाई अवेयर समर्थित है) उपकरण)। IEEE 802.11mc प्रोटोकॉल पर निर्मित यह सुविधा ऐप्स को उन्नत स्थान सटीकता और जागरूकता का उपयोग करने में सक्षम बनाती है।

उदाहरण और स्रोत

इस सुविधा का उपयोग करने के लिए, विक्रेता HAL इंटरफ़ेस लागू करें। Android 14 और उच्चतर में, विक्रेता HAL इंटरफ़ेस को AIDL का उपयोग करके परिभाषित किया गया है। Android 13 और उससे पहले के संस्करण में, विक्रेता HAL इंटरफ़ेस को HIDL का उपयोग करके परिभाषित किया गया है। एंड्रॉइड 8.0 में, एचआईडीएल ने पिछले हार्डवेयर एब्स्ट्रैक्शन लेयर (एचएएल) संरचना को बदल दिया, जिसका उपयोग इंटरफेस और पैकेज में एकत्र किए गए प्रकारों और विधि कॉलों को निर्दिष्ट करके कार्यान्वयन को सुव्यवस्थित करने के लिए किया जाता था।

वाई-फ़ाई आरटीटी सुविधा का उपयोग करने के लिए वाई-फ़ाई इंटरफ़ेस का पालन करें। कौन सा इंटरफ़ेस लागू किया गया है उसके आधार पर, यह है:

  • एआईडीएल: hardware/interfaces/wifi/aidl
  • HIDL: hardware/interfaces/wifi/1.0 या बाद का संस्करण।

यह देखने के लिए कि यह एआईडीएल और एचआईडीएल इंटरफेस के साथ कैसे संबंधित है, आप पुराने वाई-फाई एचएएल का संदर्भ ले सकते हैं: हार्डवेयर/libhardware_legacy/+/main/include/hardware_legacy/rtt.h।

कार्यान्वयन

वाई-फाई आरटीटी लागू करने के लिए, आपको फ्रेमवर्क और एचएएल/फर्मवेयर समर्थन दोनों प्रदान करना होगा:

  • रूपरेखा:

    • एओएसपी कोड
    • वाई-फ़ाई आरटीटी सक्षम करें: एक फ़ीचर फ़्लैग की आवश्यकता है
  • वाई-फ़ाई आरटीटी (IEEE 802.11mc) HAL समर्थन (जिसका तात्पर्य फ़र्मवेयर समर्थन से है)

इस सुविधा को लागू करने के लिए, वाई-फ़ाई एआईडीएल या एचआईडीएल इंटरफ़ेस लागू करें, और फ़ीचर फ़्लैग सक्षम करें:

  • device/<oem>/<device> में स्थित device.mk में, वाई-फाई आरटीटी सुविधा के लिए समर्थन शामिल करने के लिए PRODUCT_COPY_FILES पर्यावरण चर को संशोधित करें:

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

अन्यथा, इस सुविधा के लिए आवश्यक सभी चीजें AOSP में शामिल हैं।

मैक रैंडमाइजेशन

गोपनीयता बढ़ाने के लिए, वाई-फाई आरटीटी लेनदेन के दौरान उपयोग किए जाने वाले मैक पते को यादृच्छिक किया जाना चाहिए, यानी, यह वाई-फाई इंटरफ़ेस के मूल मैक पते से मेल नहीं खाना चाहिए। हालाँकि, एक अपवाद के रूप में, जब कोई डिवाइस किसी एपी के साथ जुड़ा होता है, तो वह उस एपी या अन्य एपी के साथ किसी भी आरटीटी लेनदेन के लिए उस मैक पते का उपयोग कर सकता है जिसके साथ वह जुड़ा हुआ है।

मान्यकरण

इस सुविधा के लिए एंड्रॉइड संगतता परीक्षण सूट (सीटीएस) परीक्षण मौजूद हैं। सुविधा सक्षम होने पर सीटीएस पता लगाता है और स्वचालित रूप से संबंधित परीक्षण शामिल करता है। इस सुविधा का परीक्षण वेंडर टेस्ट सूट (वीटीएस) और act/sl4a का उपयोग करके भी किया जा सकता है, एक परीक्षण सूट जो व्यापक एकीकरण परीक्षण करता है।

इकाई परीक्षण

वाई-फाई आरटीटी पैकेज परीक्षण का उपयोग करके निष्पादित किया जाता है:

सेवा परीक्षण:

atest com.android.server.wifi.rtt

प्रबंधक परीक्षण:

atest android.net.wifi.rtt

एकीकरण (एसीटीएस) परीक्षण

/tools/test/connectivity/acts_tests/tests/google/wifi/rtt/README.md में वर्णित act/sl4a परीक्षण सूट, कार्यात्मक, प्रदर्शन और तनाव परीक्षण प्रदान करता है।

सीटीएस

इस सुविधा के लिए एंड्रॉइड संगतता परीक्षण सूट (सीटीएस) परीक्षण मौजूद हैं। सुविधा सक्षम होने पर सीटीएस पता लगाता है और स्वचालित रूप से संबंधित परीक्षण शामिल करता है। एक एक्सेस प्वाइंट जो वाई-फाई आरटीटी (IEEE 802.11mc) को सपोर्ट करता है, वह डिवाइस-अंडर-टेस्ट की सीमा के भीतर होना चाहिए।

सीटीएस परीक्षण का उपयोग करके ट्रिगर किया जा सकता है:

atest WifiRttTest

कैलिब्रेशन

वाई-फाई आरटीटी के अच्छे प्रदर्शन के लिए, 802.11mc प्रोटोकॉल में लौटाई गई रेंज मुख्य प्रदर्शन संकेतक (KPI) के भीतर आदर्श रूप से सटीक हैं। 90% सीडीएफ त्रुटि के लिए, सूचीबद्ध बैंडविड्थ पर, रेंज अनुमान के लिए अनुशंसित KPI में निम्नलिखित सहनशीलता होने की उम्मीद है:

  • 80 मेगाहर्ट्ज: 2 मीटर
  • 40 मेगाहर्ट्ज: 4 मीटर
  • 20 मेगाहर्ट्ज: 8 मीटर

यह सुनिश्चित करने के लिए कि सुविधा का कार्यान्वयन सही ढंग से काम कर रहा है, अंशांकन परीक्षण आवश्यक है।

इसे बढ़ती दूरी पर आरटीटी अनुमानित सीमा के विरुद्ध जमीनी सच्चाई सीमा की तुलना करके प्राप्त किया जा सकता है। बुनियादी अनुरूपता के लिए, आपको अपने समाधान को आरटीटी कैलिब्रेटेड डिवाइस के विरुद्ध मान्य करना चाहिए। रेंज अंशांकन का परीक्षण निम्नलिखित शर्तों के तहत किया जाना चाहिए:

  1. एक बड़ी खुली प्रयोगशाला, या एक गलियारा जिसमें बहुत सारी धातु की वस्तुएं नहीं होती हैं जिसके परिणामस्वरूप बहु-पथ की असामान्य रूप से उच्च घटनाएं हो सकती हैं।
  2. कम से कम 25 मीटर तक फैला लाइन-ऑफ-साइट (एलओएस) ट्रैक/पथ।
  3. ट्रैक के एक छोर से दूसरे छोर तक 0.5 मीटर की वृद्धि के मार्कर।
  4. ट्रैक के एक छोर पर फर्श से 20 सेमी ऊपर एक आरटीटी सक्षम पहुंच बिंदु को सुरक्षित करने के लिए एक जगह, और एक एंड्रॉइड फोन (या परीक्षण के तहत अन्य एंड्रॉइड मोबाइल डिवाइस) के लिए एक चल माउंट जिसे ट्रैक के साथ ले जाया जा सकता है, और ट्रैक के साथ संरेखित किया जा सकता है। 0.5 मीटर मार्कर, वह भी फर्श से 20 सेमी ऊपर। नोट: यह दोहराव वाला कार्य एक छोटे रोबोट द्वारा किया जा सकता है, लेकिन एक मानव ऑपरेटर भी ठीक है।
  5. पहुंच बिंदु से दूरी के साथ, प्रत्येक मार्कर पर 50 रेंजिंग परिणाम दर्ज किए जाने चाहिए। प्रत्येक मार्कर स्थिति के लिए श्रेणी माध्य और विचरण जैसे आँकड़ों की गणना की जानी चाहिए।

चरण 5 में परिणामों से, अनुमानित सीमा (y-अक्ष) के विरुद्ध जमीनी सच्चाई (x-अक्ष) और अनुमानित सबसे उपयुक्त प्रतिगमन रेखा के लिए एक चार्ट तैयार किया जा सकता है। आदर्श उपकरण अंशांकन के परिणामस्वरूप ग्रेडिएंट 1.0 की एक पंक्ति बनेगी, जिसमें y-अक्ष पर 0.0 मीटर का ऑफसेट होगा। इन मानों से विचलन स्वीकार्य हैं यदि वे संबंधित बैंडविड्थ के लिए KPI के भीतर हैं। यदि परिणाम KPI के बाहर हैं, तो परिणामों को KPI विनिर्देश के भीतर लाने के लिए डिवाइस सुविधा को पुन: अंशांकित किया जाना चाहिए।