Interfejs UWB HAL

Ultraszerokopasmowa (UWB) warstwa AOSP korzysta z interfejsu UCI zdefiniowanego przez FiRa jako interfejs HAL. Interfejs HAL używa nieprzezroczystego kanału (IUwbChip::sendUciMessage() i IUwbClientCallback::onUciMessage()) do wysyłania i odbierania poleceń, odpowiedzi i powiadomień interfejsu poleceń UWB (UCI). Wszyscy dostawcy technologii UWB na Androida muszą obsługiwać wszystkie wiadomości zdefiniowane w specyfikacji FiRa. Platforma UWB jest zgodna wstecz i działa z dowolną wersją interfejsu użytkownika UCI implementowaną przez dostawcę UWB na urządzeniu. Framework AOSP UWB jest modułem, więc może też selektywnie dodawać obsługę zatwierdzonych żądań zmiany (CR) z projektów specyfikacji UCI przeznaczonych do głównych wersji standardów FiRa. Wszelkie wdrożone wersje robocze CR mogą ulec zmianie.

Definicja interfejsu

Interfejs HAL UWB jest definiowany za pomocą stabilnego AIDL. Główny interfejs korzysta z pakietu android.hardware.uwb.

Poniżej przedstawiono 2 główne interfejsy w pakiecie android.hardware.uwb.

IUwbChip.aidl

package android.hardware.uwb;

interface IUwbChip {

 String getName();

 void open(in android.hardware.uwb.IUwbClientCallback clientCallback);

 void close();

 void coreInit();

 void sessionInit(int sessionId);

 int getSupportedAndroidUciVersion();

 int sendUciMessage(in byte[] data);

}

IUwbClientCallback.aidl

package android.hardware.uwb;

interface IUwbClientCallback {

 oneway void onUciMessage(in byte[] data);

 oneway void onHalEvent(in android.hardware.uwb.UwbEvent event, in android.hardware.uwb.UwbStatus status);

}

Schemat wywołania HAL z ramki UWB

Na ilustracjach poniżej przedstawiono przepływ wywołań z ramy UWB na potrzeby inicjowania i wyłączania modułu UWB oraz uruchamiania i zatrzymywania sesji UWB.

Rysunek 1. Przebieg wywołania inicjowania stosu UWB (przełącznik UWB włączony)

Rysunek 2. Przebieg rozmowy dotyczącego deinicjalizacji modułu UWB (wyłączenie przełącznika UWB)

Rysunek 3. Proces rozpoczynanie/zatrzymywanie sesji UWB

Konfiguracja kodu kraju UWB

Jak widać na rysunku 1, framework UWB konfiguruje kod kraju UWB podczas inicjalizacji stosu UWB za pomocą polecenia UCI w przestrzeni dostawcy ANDROID_SET_COUNTRY_CODE (GID=0xC, OID=0x1). Framework UWB próbuje określić kod kraju UWB, korzystając z tych źródeł (w kolejności priorytetów). Ramy UWB przestają działać po pierwszym źródle, w którym określony jest kod kraju.

1. Zastąpić kod kraju: kod kraju wymuszony za pomocą polecenia adb shell (testy lokalne lub zautomatyzowane).
2. Telephony country code: kod kraju pobrany z komórki. Jeśli masz kilka kart SIM, które zwracają różne kody, wybrany kod kraju jest niedeterministyczny.
3. Kod kraju Wi-Fi: kod kraju pobrany przez Wi-Fi (80211.ad).
4. Ostatni znany kod kraju: ostatni znany kod kraju pobrany z komórki. Jeśli masz kilka kart SIM, które zwracają różne kody, wybrany kod kraju jest niedeterministyczny.
5. Kod kraju lokalizacji: kod kraju pobrany z usługodawcy lokalizacji LocationManager.
6. Domyślny kod kraju OEM: kod kraju ustawiony przez producenta urządzenia.

Jeśli platforma UWB nie może określić kodu kraju UWB, wywołuje polecenie UCI ANDROID_SET_COUNTRY_CODE o wartości DEFAULT_COUNTRY_CODE ("00") i powiadamia aplikacje UWB, że stan stosu UWB to DISABLED. Gdy usługa UWB wykryje prawidłowy kod kraju, skonfiguruje nowy kod kraju za pomocą polecenia ANDROID_SET_COUNTRY_CODE i powiadomi aplikacje UWB, że pakiet usług UWB jest READY.

Jeśli nie można używać UWB z powodu lokalnych przepisów obowiązujących w danym kraju, kontroler UWB zwraca kod stanu STATUS_CODE_ANDROID_REGULATION_UWB_OFF. Następnie framework UWB powiadamia aplikacje UWB, że stan stosu UWB to DISABLED.

Gdy użytkownik podróżuje do innego kraju, platforma UWB konfiguruje nowy kod kraju za pomocą polecenia UCI ANDROID_SET_COUNTRY_CODE. W zależności od kodu stanu zwróconego przez kontroler UWB (na podstawie przepisów dotyczących UWB w nowym kraju) może to spowodować zmianę stanu modułu UWB.

Format polecenia określony w specyfikacji FIRA UCI

Format pakietów sterujących UCI znajdziesz w sekcji 4.4.2 specyfikacji UCI.

Obsługa wersji interfejsu

Specyfikacja UCI umożliwia dostawcom technologii UWB udostępnianie wersji pakietu UCI zaimplementowanego przez urządzenie za pomocą poleceń UCI_GET_DEVICE_INFO_RSP i UCI_GET_CAPS_INFO_RSP. Framework używa tych poleceń do pobierania wersji urządzenia w ramach interfejsu UCI i odpowiedniego dostosowywania jego działania.

Lista projektów CR obsługiwanych przez moduł UWB

Te wersje robocze raportów zgodności FiRa 2.0 są obsługiwane przez moduł UWB w wersji 330810000:

• CR 287
• Obsługa specyfikacji SUS API i UCI w przypadku interfejsu kluczyka cyfrowego CCC

Interfejs UCI Androida (część dotycząca dostawcy FiRa)

Specyfikacja UCI definiuje zestaw identyfikatorów grup (GID) i identyfikatorów kodu operacji (OID) dla wszystkich wiadomości zdefiniowanych w specyfikacji. Specyfikacja rezerwuje też zestaw identyfikatorów GID do użytku wyłącznie przez dostawców. Stosunek AOSP UWB używa niektórych z tych identyfikatorów GID i OID dostawcy do poleceń specyficznych dla Androida, które nie są zdefiniowane w specyfikacji. Szczegółowe informacje znajdziesz w sekcji 8.4 specyfikacji UCI.

Te komunikaty dostawcy używane przez Androida są zdefiniowane w pakiecie android.hardware.uwb.fira_androidHAL.

Wersje interfejsu dostawcy

Dostawcy technologii UWB muszą udostępnić wersję pakietu android.hardware.uwb.fira_android HAL obsługiwanego na urządzeniu za pomocą IUwbChip.getSupportedAndroidUciVersion(). Framework używa tych informacji o wersji do obsługi zgodności wstecznej.

Lista identyfikatorów GID i OID na Androida

W tabeli poniżej znajdziesz identyfikatory GID i OID na Androida. Identyfikatory GID 0xE i 0xF są zarezerwowane dla producentów urządzeń na Androida.

Rozszerzenia dostawców do wiadomości zdefiniowanych w specyfikacji UCI

W tej sekcji opisano szczegóły rozszerzeń dostawców do wiadomości zdefiniowanych w specyfikacji UCI.

SESSION_SET_APP_CONFIG_[CMD|RSP] i SESSION_GET_APP_CONFIG_[CMD|RSP]

Poniżej znajdują się wartości długości typu (TLV) zdefiniowane przez pakiet AOSP w części TLV zarezerwowanej przez dostawcę w pliku APP_CONFIG:

• GID: 0001b (grupa konfiguracji sesji UWB)
• OID: 000011b (SESSION_SET_APP_CONFIG_CMD)
• OID: 000100b (SESSION_GET_APP_CONFIG_CMD)

W tabeli poniżej znajdziesz parametry wiadomości konfiguracyjnych sesji UWB.

CORE_GET_CAPS_INFO_RSP

Oto listy TLV zdefiniowane przez pakiet AOSP w części TLV przeznaczonej dla dostawcy w pliku CAPS_INFO:

• GID: 0000b (grupa podstawowa UWB)
• OID: 000011b (CORE_GET_CAPS_INFO_RSP)

Tabela poniżej zawiera parametry wiadomości o możliwościach UWB.

Kody stanu

Poniżej znajdują się kody stanu w obszarze dostawcy. Są one zwracane w odpowiedziach UCI (np. SESSION_START_RSP) przez podsystem UWB (UWBS).

Kod powodu zmiany stanu w SESSION_STATUS_NTF

Poniżej znajdują się kody przyczyny zmiany stanu zdefiniowane w przestrzeni dostawcy dla pola stanu zwracanego przez UWBS w SESSION_STATUS_NTF. To powiadomienie jest wysyłane przez UWBS, gdy stan sesji pomiaru zasięgu ulegnie zmianie (np. z ACTIVE na IDLE).