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

Стек сверхширокополосных технологий AOSP (UWB) использует интерфейс UCI, определенный FiRa, в качестве поверхности HAL. Интерфейс HAL использует непрозрачный канал ( IUwbChip::sendUciMessage() и IUwbClientCallback::onUciMessage() ) для отправки и получения команд, ответов и уведомлений интерфейса команд UWB (UCI). Все поставщики UWB для Android должны поддерживать все сообщения, определенные спецификацией FiRa. Фреймворк UWB обратно совместим и работает с любой версией UCI, реализованной поставщиком UWB на устройстве. Поскольку фреймворк UWB AOSP является модулем , он также может выборочно добавлять поддержку утвержденных запросов на изменение (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 настраивает новый код страны с помощью команды UCI ANDROID_SET_COUNTRY_CODE . В зависимости от кода статуса, возвращаемого контроллером UWB (в соответствии с правилами UWB в новой стране), это может привести к изменению состояния стека UWB.

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

Формат управляющих пакетов UCI см. в разделе 4.4.2 спецификации UCI .

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

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

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

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

• КР 287
• Поддержка API SUS и спецификаций UCI для требований интерфейса цифрового ключа 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 (основная группа UWB)
• OID: 000011b ( CORE_GET_CAPS_INFO_RSP )

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

Коды статуса

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

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

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