СШП 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 настраивает новый код страны с помощью команды 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 ).