Интерфейс HAL для СШП

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

Рисунок 1. Схема вызовов для инициализации стека СШП (переключатель СШП включен)

Рисунок 2. Схема вызовов для деинициализации стека СШП (переключатель СШП выключен)

Рисунок 3. Запуск и остановка сеанса СШП

Настройка кода страны для СШП

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

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

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

Если в стране действуют местные нормативные требования, из-за которых нельзя использовать сверхширокополосную связь, контроллер UWB возвращает код статуса STATUS_CODE_ANDROID_REGULATION_UWB_OFF. Затем фреймворк СШП уведомляет приложения, использующие эту технологию, что стек СШП находится в состоянии DISABLED.

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

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

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

Версии интерфейса

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

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

В модуле СШП версии 330810000 поддерживаются следующие проекты запросов на изменение для FiRa 2.0:

• CR 287
• Поддержка SUS API и спецификации UCI для интерфейса CCC Digital Key Требования

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

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

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

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

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

Список идентификаторов GID и OID для Android

В таблице ниже перечислены идентификаторы GID и OID для Android. Идентификаторы 0xE и 0xF зарезервированы для использования производителями устройств 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)

В таблице ниже перечислены параметры сообщений о возможностях СШП.

Коды статуса

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

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

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