СШП HAL-интерфейс

Стек сверхширокополосной связи (UWB) AOSP использует интерфейс UCI, определенный FiRa, в качестве поверхности HAL. Интерфейс HAL использует непрозрачный канал ( IUwbChip::sendUciMessage() и IUwbClientCallback::onUciMessage() ) для отправки и получения команд, ответов и уведомлений командного интерфейса UWB (UCI). Все поставщики Android UWB должны поддерживать все сообщения, определенные спецификацией FiRa. Платформа UWB обратно совместима и работает с любой версией UCI, реализованной на устройстве поставщиком UWB. Поскольку структура AOSP UWB представляет собой модуль , она также может выборочно добавлять поддержку утвержденных запросов на изменения (CR) из проектов спецификаций UCI, предназначенных для основных выпусков стандартов FiRa. Любые реализованные проекты CR могут быть изменены.

Определение интерфейса

Интерфейс UWB HAL определяется с использованием стабильного AIDL . Основной интерфейс использует пакет android.hardware.uwb .

Ниже приведены два основных интерфейса пакета 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);

}

Поток вызовов HAL из платформы UWB

Следующие изображения иллюстрируют поток вызовов из платформы UWB для инициализации стека UWB, деинициализации стека UWB, а также процессов запуска и остановки сеанса UWB.

Рисунок 1. Последовательность вызовов инициализации стека UWB (включение UWB)

Рис. 2. Поток вызова деинициализации стека UWB (выключение UWB)

Рисунок 3. Порядок запуска/остановки сеанса UWB

Конфигурация кода страны UWB

Как показано на рисунке 1, платформа UWB настраивает код страны UWB во время инициализации стека UWB с помощью команды UCI в пространстве поставщика ANDROID_SET_COUNTRY_CODE (GID= 0xC , OID= 0x1 ). Структура UWB пытается определить код страны UWB, используя следующие источники (перечисленные в порядке приоритета). Структура UWB останавливается на первом источнике, где определяется код страны.

1. Переопределить код страны: код страны, принудительно введенный с помощью команды оболочки adb (локальное или автоматическое тестирование).
2. Телефонный код страны: код страны, полученный через сотовую связь. Если имеется несколько SIM-карт, которые возвращают разные коды, выбранный код страны является недетерминированным.
3. Код страны Wi-Fi: код страны, полученный через Wi-Fi (80211.ad).
4. Последний известный телефонный код страны: последний известный код страны, полученный через сотовую связь. Если имеется несколько SIM-карт, которые возвращают разные коды, выбранный код страны является недетерминированным.
5. Код страны местоположения: код страны, полученный от объединенного поставщика местоположений LocationManager .
6. Код страны OEM по умолчанию: код страны, установленный производителем устройства.

Если платформа UWB не может определить код страны UWB, она вызывает команду UCI ANDROID_SET_COUNTRY_CODE со значением DEFAULT_COUNTRY_CODE ("00") и уведомляет приложения UWB о том, что состояние стека UWB DISABLED . Позже, когда платформа UWB сможет определить действительный код страны, она настраивает новый код страны с помощью команды ANDROID_SET_COUNTRY_CODE и уведомляет приложения UWB о том, что стек UWB READY .

Если UWB невозможно использовать из-за местных правил страны, контроллер UWB возвращает код состояния STATUS_CODE_ANDROID_REGULATION_UWB_OFF . Затем платформа UWB уведомляет приложения UWB о том, что состояние стека UWB DISABLED .

Когда пользователь путешествует в другую страну, платформа UWB настраивает новый код страны с помощью команды ANDROID_SET_COUNTRY_CODE UCI. В зависимости от кода состояния, возвращаемого контроллером СШП (в соответствии с правилами СШП в новой стране), это может привести к изменению состояния стека СШП.

Формат команды, определенный спецификацией FIRA UCI

О формате пакетов управления UCI см. раздел 4.4.2 спецификации UCI .

Управление версиями интерфейса

Спецификация UCI позволяет поставщикам UWB предоставлять версию стека UCI, реализованную устройством, с помощью команд UCI_GET_DEVICE_INFO_RSP и UCI_GET_CAPS_INFO_RSP . Платформа использует эти команды для получения UCI-версии устройства и соответствующего изменения его поведения.

Список проектов CR, поддерживаемых модулем СШП

Следующие проекты CR для FiRa 2.0 поддерживаются модулем UWB версии № 330810000:

• КР 287
• Поддержка SUS API и UCI Spec для требований к интерфейсу цифровых ключей CCC

Интерфейс Android UCI (часть поставщика FiRa)

Спецификация UCI определяет набор идентификаторов группы (GID) и идентификаторов кода операции (OID) для всех сообщений, определенных спецификацией. В спецификации также резервируется набор GID, предназначенный исключительно для использования поставщиками. Стек AOSP UWB использует некоторые из этих идентификаторов GID и OID поставщиков для команд, специфичных для Android, которые не определены в спецификации. Подробности см. в разделе 8.4 спецификации UCI .

Эти сообщения поставщиков, используемые Android, определены в пакете HAL android.hardware.uwb.fira_android .

Управление версиями интерфейса поставщика

Поставщики UWB должны предоставить версию пакета HAL android.hardware.uwb.fira_android , поддерживаемую на устройстве, через IUwbChip.getSupportedAndroidUciVersion() . Платформа использует эту информацию о версиях для обеспечения обратной совместимости.

Список GID и OID Android

В следующей таблице перечислены GID и OID для Android. GID 0xE и 0xF зарезервированы для использования OEM-производителями Android.

Расширения поставщиков для сообщений, определенных спецификацией UCI

В этом разделе описываются подробные сведения о расширениях поставщиков для сообщений, определенных спецификацией UCI.

SESSION_SET_APP_CONFIG_[CMD|RSP] и SESSION_GET_APP_CONFIG_[CMD|RSP]

Ниже приведены значения длины типа (TLV), определенные стеком AOSP в зарезервированной поставщиком части TLV в APP_CONFIG :

• GID: 0001b (группа конфигурации сеанса UWB)
• OID: 000011b ( SESSION_SET_APP_CONFIG_CMD )
• OID: 000100b ( SESSION_GET_APP_CONFIG_CMD )

В следующей таблице перечислены параметры сообщений конфигурации сеанса UWB.

CORE_GET_CAPS_INFO_RSP

Ниже приведены TLV, определенные стеком AOSP в зарезервированной поставщиком части TLV в CAPS_INFO :

• GID: 0000b (основная группа СШП)
• OID: 000011b ( CORE_GET_CAPS_INFO_RSP )

В следующей таблице перечислены параметры сообщений о возможностях UWB.

Коды состояния

Ниже приведены коды состояния в пространстве поставщика. Они возвращаются в ответах UCI (например, SESSION_START_RSP ) подсистемой UWB (UWBS).

Код причины изменения состояния в SESSION_STATUS_NTF

Ниже приведены коды причин изменения состояния, определенные в пространстве поставщика для поля состояния, возвращаемого UWBS в SESSION_STATUS_NTF . Это уведомление отправляется UWBS при изменении состояния сеанса ранжирования (например, с ACTIVE на IDLE ).