Kalibracja obecności

Na tej stronie znajdziesz instrukcje konfiguracji i kalibracji dotyczące wymagań związanych z kalibracją wykrywania obecności na urządzeniach z Androidem 14 lub nowszym.

Aby urządzenia inteligentne użytkowników dobrze ze sobą współpracowały, wszystkie urządzenia w ekosystemie Androida muszą być w stanie określić względną odległość między sobą. Android 14 wprowadza wymagania dotyczące kalibracji obecności, które określają akceptowalną wydajność dostępnych technologii radiowych używanych do określania bliskości, takich jak Ultra Wideband (UWB), Wi-Fi i Bluetooth Low Energy (BLE).

Urządzenie referencyjne

Aby skalibrować urządzenie pod kątem wymagań dotyczących obecności, użyj jednego z tych urządzeń referencyjnych do wszystkich kalibracji.

  • (zalecane) telefon Pixel,
  • Jeśli nie używasz telefonu Pixel, użyj urządzenia tej samej marki i tego samego modelu co testowane urządzenie.

Formaty

Kalibracja obecności jest ważna w przypadku urządzeń z Androidem o wszystkich formatach. W przypadku formatów innych niż telefony komórkowe, aby określić odpowiednią konfigurację kalibracji urządzenia, zastanów się, jak użytkownik trzymający telefon komórkowy (urządzenie referencyjne) byłby ustawiony podczas interakcji z testowanym urządzeniem. Na przykład podczas kalibracji telewizora umieść telewizor i telefon komórkowy w odpowiedniej odległości od siebie i skieruj urządzenie mobilne w stronę środka ekranu telewizora.

Testy dokładności pomiaru odległości

W przypadku urządzeń z Androidem 17 lub nowszym moduł CtsMultiDeviceGenericRangingAccuracyTests zawiera przypadki testowe, które weryfikują wymagania dotyczące kalibracji wykrywania obecności opisane na tej stronie. Ten moduł to automatyczny test CTS Verifier (CTS-V) na wiele urządzeń po stronie hosta, który jest uruchamiany z maszyny hosta połączonej z testowanym urządzeniem i urządzeniem referencyjnym. Moduł zastępuje ręczne testy obecności w CTS-V. W przypadku urządzeń z Androidem 16 i starszym używaj testów obecności w wersjach CTS i CTS-V dla tej wersji Androida.

Aby przeprowadzić testy dokładności pomiaru odległości:

  1. Skonfiguruj maszynę hosta oraz CTS-V na testowanym urządzeniu i urządzeniu referencyjnym. Szczegółowe informacje znajdziesz w artykule Konfigurowanie testów na wielu urządzeniach po stronie hosta.

  2. Umieść testowane urządzenie i urządzenie referencyjne w odległości 1 metra od siebie, jak opisano w sekcji Konfigurowanie testów dokładności pomiaru odległości i w konfiguracji kalibracji dla każdej technologii na tej stronie.

  3. Podłącz oba urządzenia do komputera hosta za pomocą kabli USB.

  4. W katalogu, w którym został rozpakowany pakiet CTS-V, uruchom konsolę hosta CTS-V:

    ./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed
  5. W konsoli hosta CTS-V uruchom testy dokładności pomiaru odległości:

    run cts-v-host -m CtsMultiDeviceGenericRangingAccuracyTests
    

    Wyniki testu pojawią się w aplikacji CTS-V na testowanym urządzeniu w sekcji Testy po stronie hosta > Testy UWB > CtsMultiDeviceGenericRangingAccuracyTests.

Każdy element testowania w module zbiera pomiary przy użyciu jednej technologii, oblicza na ich podstawie dane dotyczące dokładności i rejestruje je. Element testowania jest zaliczony, jeśli udało się zebrać pomiary, nawet jeśli dane nie spełniają wartości docelowych. Aby sprawdzić zgodność, porównaj zarejestrowane wskaźniki logów z wartościami docelowymi opisanymi w kolejnych sekcjach. Jeśli testowane urządzenie lub urządzenie referencyjne nie obsługuje danej technologii, element testowania dla tej technologii jest pomijany.

Wymagania dotyczące UWB

Wymagania dotyczące UWB znajdziesz w sekcji 7.4.9 dokumentu CDD.

Konfiguracja kalibracji UWB

Aby skalibrować urządzenie pod kątem wymagań UWB, wykonaj te czynności.

Ogólne wymagania dotyczące konfiguracji

  • Wymagane są 2 urządzenia ze sprzętem UWB – jedno jako testowane urządzenie, a drugie jako urządzenie referencyjne.

  • Wymagane są 2 statywy do urządzeń.

  • Testowane urządzenie i urządzenie referencyjne muszą być umieszczone w odległości 1 metra od siebie w środowisku z widocznością w komorze bezodbiciowej. Oba urządzenia muszą być ustawione w orientacji pionowej, a ich ekrany muszą być skierowane w przeciwnych kierunkach.

Przykładową konfigurację kalibracji UWB pokazano na rysunku 1 i filmie 1.

Konfiguracja referencyjna do kalibracji BLE

Rysunek 1. Konfiguracja referencyjna do kalibracji UWB.

Film 1. Konfiguracja referencyjna do kalibracji UWB.

Sprawdź zgodność z dokumentem CDD 7.4.9 [C-1-6] i [C-1-7]

Aby sprawdzić zgodność z CDD 7.4.9 [C-1-6] i [C-1-7], przeprowadź testy dokładności pomiaru odległości i sprawdź dane zarejestrowane przez element testowania test_uwb_ranging.

Element testowania inicjuje sesję pomiaru odległości UWB między testowanym urządzeniem a urządzeniem referencyjnym i wykonuje 1000 pomiarów na każdym urządzeniu. W przypadku pomiarów z każdego urządzenia element testowania wykonuje te czynności:

  1. Oblicza zakres w ten sposób: zakres = pomiar 97,5 centyla – pomiar 2,5 centyla. Aby spełnić wymagania, zakres musi wynosić maksymalnie 30 cm.

  2. Oblicza medianę pomiarów. Aby spełnić wymagania, mediana musi wynosić od 0,75 m do 1,25 m włącznie.

Wymagania dotyczące funkcji Neighbor Awareness Networking w Wi-Fi

Sekcja 2.2.1 dokumentu CDD. Hardware obejmuje wymagania dotyczące zgodności z Wi-Fi Neighbor Awareness Networking (NAN).

Sprawdzanie zgodności z dokumentem CDD 2.2.1 [7.4.2.5/H-1-1]

Aby sprawdzić zgodność z CDD 2.2.1 [7.4.2.5/H-1-1], przeprowadź testy dokładności pomiaru odległości i sprawdź dane zarejestrowane przez element testowania test_wifi_rtt_ranging.

Element testowania rozpoczyna sesję pomiaru odległości Wi-Fi NAN między testowanym urządzeniem a urządzeniem referencyjnym i wykonuje 100 pomiarów Wi-Fi RTT. Następnie element testowania oblicza odsetek pomiarów, które mieszczą się w zakresie ±2 m od rzeczywistej odległości wynoszącej 1 m. Aby spełnić wymagania dotyczące pasma 80 MHz, co najmniej 68% pomiarów musi mieścić się w zakresie ±2 m.

Wymagania dotyczące BLE RSSI

Sekcja 7.4.3 dokumentu CDD. Bluetooth obejmuje wymagania dotyczące zgodności z BLE RSSI.

Konfiguracja kalibracji

Aby skalibrować urządzenie pod kątem wymagań dotyczących BLE RSSI, wykonaj te czynności.

Ogólne wymagania dotyczące konfiguracji

  • Aby uzyskać optymalne wyniki, użyj komory bezechowej, aby zminimalizować zakłócenia pomiarów.

    Jeśli nie używasz komory bezechowej, ustaw 1 statyw z urządzeniem referencyjnym i 1 statyw z testowanym urządzeniem na wysokości 1,5 metra nad ziemią, zachowując podobną odległość od sufitu.

  • Przygotuj urządzenie referencyjne i testowane urządzenie:

    • Upewnij się, że oba urządzenia są wystarczająco naładowane, aby można było przeprowadzić testy.
    • Podczas testowania odłącz oba urządzenia od zasilania.
    • Zdejmij wszystkie etui, odłącz kable i inne akcesoria, które mogą wpływać na działanie częstotliwości radiowych.
  • Przymocuj każde urządzenie do statywu za pomocą uchwytu.

    • Statywy i uchwyty na urządzenia powinny zawierać jak najmniej metalu.
    • Mała metalowa sprężyna w uchwytach urządzenia jest dopuszczalna.
  • Usuń wszystkie metalowe przedmioty znajdujące się między urządzeniami.

Konfiguracja referencyjna do kalibracji BLE

Rysunek 2. Konfiguracja referencyjna do kalibracji BLE.

Sprawdź zgodność z dokumentem CDD 7.4.3 [C-10-1]

Aby sprawdzić zgodność z CDD 7.4.3 [C-10-1], przeprowadź testy dokładności określania odległości z urządzeniami umieszczonymi zgodnie z konfiguracją kalibracji BLE i sprawdź dane zarejestrowane przez element testowania test_ble_rssi_ranging.

Element testowania ustawia urządzenie referencyjne na rozgłaszanie z częstotliwością ADVERTISE_TX_POWER_HIGH i zbiera 1000 skanów na testowanym urządzeniu. Element testowania oblicza następnie zakres środkowych 95% pomiarów RSSI. Aby spełnić wymagania, zakres musi być mniejszy lub równy 18 dB.

Sprawdzanie zgodności z dokumentem CDD 7.4.3 [C-10-2]

Aby sprawdzić zgodność z CDD 7.4.3 [C-10-2]: Dostawca układu scalonego może zmierzyć płaskość kanału i zidentyfikować różnice między rdzeniami i kanałami.

Poniżej znajdziesz wskazówki, jak zidentyfikować problemy z nieskalibrowanymi rdzeniami i nieskalibrowanymi kanałami, które są 2 możliwymi przyczynami dużego rozrzutu RSSI.

Nieskalibrowane rdzenie

Jeśli antena Bluetooth na urządzeniu ma kilka rdzeni, mogą one mieć różne kalibracje. Wykonaj kilka pomiarów (przez co najmniej 1 minutę) i sprawdź dane skanowania. Jeśli widzisz wzorzec podobny do tego na rysunku 3, który ma regularne wartości szczytowe (oznaczone kółkami) z powodu skanowania na wielu rdzeniach, prawdopodobnie występuje problem z nieskalibrowanymi rdzeniami i wymagana jest dalsza analiza.

Przykładowe dane skanowania urządzenia z nieskalibrowanymi rdzeniami

Rysunek 3. Przykład danych skanowania urządzenia z nieskalibrowanymi rdzeniami.

Nieskalibrowane kanały

Transmisje w klasycznym BLE odbywają się na 3 kanałach. Każdy kanał może mieć inne cechy. Kanały są zmieniane w stałych odstępach czasu. Wykonaj kilka pomiarów (przez co najmniej 1 minutę) i sprawdź dane skanowania. Jeśli widzisz wzorzec podobny do tego na rysunku 4, prawdopodobnie występuje problem z błędną kalibracją na różnych kanałach i wymagana jest dalsza analiza.

Przykład danych skanowania dla urządzenia z nieskalibrowanymi kanałami

Rysunek 4. Przykład danych skanowania urządzenia z nieskalibrowanymi kanałami.

Sprawdź zgodność z wymaganiami [C-10-3] i [C-10-4] dokumentu CDD 7.4.3

Nawet jeśli układ radiowy BLE jest idealnie skalibrowany, wartość RSSI, którą obserwuje konkretne urządzenie, zależy od jakości anteny i jej umiejscowienia w danym produkcie (modelu urządzenia). Powoduje to problemy z interoperacyjnością między urządzeniami.

Rozważmy na przykład przypadek użycia polegający na odblokowaniu samochodu. Deweloper aplikacji może chcieć odblokować samochód, gdy urządzenie znajduje się w odległości 1 metra od niego. Deweloper wybiera próg -60 dBm na podstawie obserwacji na telefonie, który posiada, ale ze względu na różnice w jakości i umiejscowieniu anteny może to nie działać dobrze na innym urządzeniu z Androidem, nawet jeśli oba urządzenia używają tego samego układu scalonego.

Aby zapewnić interoperacyjność wszystkich urządzeń w ekosystemie, musisz zmierzyć przesunięcie Rx każdego urządzenia i dostosować RSSI raportowane na urządzeniu, aby upewnić się, że RSSI BLE spełnia standard 1 m przy ADVERTISE_TX_POWER_HIGH.

Nawet gdy układy radiowe BLE są idealnie skalibrowane, idealny odbiornik odczytuje różne wartości RSSI w zależności od jakości anteny i jej umiejscowienia na urządzeniu rozgłaszającym. Wymaganie dotyczące Rx zapewnia, że wszystkie urządzenia mogą rozgłaszać z taką samą siłą, przy zachowaniu wszystkich innych warunków.

Aby sprawdzić zgodność z wymaganiami dotyczącymi Rx i Tx:

  1. Umieść testowane urządzenie w odległości 1 m od urządzenia referencyjnego zgodnie z konfiguracją kalibracji BLE. Zalecamy ustawienie urządzeń równolegle do siebie, z ekranami skierowanymi w tę samą stronę.

  2. Uruchom testy dokładności pomiaru odległości i sprawdź dane zarejestrowane przez element testowania test_ble_rx_tx_offset_precision.

    Element testowania uruchamia jednocześnie testy Rx i Tx oraz zbiera po 1000 skanów dla każdego testu:

    • Rx: testowane urządzenie skanuje, gdy urządzenie referencyjne rozgłasza z częstotliwością ADVERTISE_TX_POWER_HIGH.
    • Tx: urządzenie referencyjne skanuje, gdy DUT rozgłasza przy ADVERTISE_TX_POWER_HIGH.

    Aby spełnić wymagania, mediana RSSI w testach Rx i Tx musi mieścić się w zakresie od -65 dBm do -45 dBm.

  3. Skalibruj urządzenia, aby skompensować przesunięcie Rx i moc Tx, aby zapewnić średnią wartość RSSI na poziomie -55 dBm.

    • Rx: dostosuj RSSI, ustawiając właściwość systemową bluetooth.hardware.radio.le_rx_path_loss_comp_db na wartość (dB), która kompensuje przesunięcie Rx, aby zapewnić medianę BLE RSSI na poziomie -55 dBm przy 1 m. Stos Bluetooth dostosowuje RSSI do wartości RSSI powiększonej o wartość bluetooth.hardware.radio.le_rx_path_loss_comp_db.

      Więcej informacji: le_scanning_manager.cc.

    • Tx: dostosuj moc Tx, ustawiając właściwość systemową bluetooth.hardware.radio.le_tx_path_loss_comp_db na wartość (dB), która kompensuje moc Tx, aby zapewnić medianę BLE RSSI na poziomie -55 dBm przy 1 m. Stos Bluetooth dostosowuje moc Tx, aby była równa mocy Tx plus wartość bluetooth.hardware.radio.le_tx_path_loss_comp_db.

      Więcej informacji: le_advertising_manager.cc.

Wymagania dotyczące sondowania kanału BLE

Sekcja 7.4.3 dokumentu CDD. Bluetooth obejmuje wymagania dotyczące dokładności BLE Channel Sounding (CS). Wymaganie [C-11-2] określa, że urządzenia, które deklarują FEATURE_BLUETOOTH_LE_CHANNEL_SOUNDING, muszą podawać zakres z dokładnością do ±0,5 m w 90 percentylu, obliczoną za pomocą dystrybuanty (CDF) w odległości 1 m.

Sprawdź zgodność z dokumentem CDD 7.4.3 [C-11-2]

Aby sprawdzić zgodność z CDD 7.4.3 [C-11-2], przeprowadź testy dokładności określania odległości na urządzeniach umieszczonych zgodnie z konfiguracją kalibracji BLE i sprawdź dane zarejestrowane przez element testowania test_channel_sounding_ranging. Zarówno testowane urządzenie, jak i urządzenie referencyjne muszą obsługiwać BLE CS.

Element testowania wiąże testowane urządzenie i urządzenie referencyjne przez BLE, rozpoczyna sesję pomiaru odległości BLE CS między nimi i wykonuje 100 pomiarów odległości. Następnie element testowania oblicza odsetek pomiarów, które mieszczą się w zakresie ±0,5 m od rzeczywistej odległości wynoszącej 1 m. Aby spełnić wymagania, co najmniej 90% pomiarów musi mieścić się w zakresie ±0,5 m.