На этой странице приведены инструкции по настройке и калибровке датчиков присутствия для устройств с Android 14 и более поздними версиями.
Чтобы умные устройства пользователей работали слаженно, важно, чтобы все устройства в экосистеме Android могли определять относительную близость друг к другу. В Android 14 появились требования к калибровке присутствия, которые определяют допустимую производительность доступных технологий радиосвязи, используемых для определения близости, таких как сверхширокополосная связь (UWB), Wi-Fi и Bluetooth с низким энергопотреблением (BLE).
Базовое устройство
Чтобы откалибровать устройство в соответствии с требованиями к присутствию, используйте одно из следующих эталонных устройств для всех калибровок.
- Телефон Pixel (рекомендуется).
- Если вы не используете телефон Pixel, используйте устройство той же марки и модели, что и тестируемое устройство.
Типа устройства
Калибровка присутствия важна для устройств Android всех форм-факторов. Чтобы определить подходящую настройку калибровки для устройств других типов, представьте, как будет располагаться пользователь, держащий мобильный телефон (эталонное устройство), при взаимодействии с тестируемым устройством. Например, при калибровке телевизора поместите телевизор и мобильный телефон на соответствующем расстоянии друг от друга и сориентируйте мобильное устройство так, чтобы оно было обращено к передней центральной части экрана телевизора.
Тесты точности определения расстояния
Для устройств с Android 17 и более поздних версий модуль CtsMultiDeviceGenericRangingAccuracyTests включает тестовые сценарии, которые проверяют требования к калибровке присутствия на этой странице. Этот модуль представляет собой автоматизированный тест CTS Verifier (CTS-V) для нескольких устройств на стороне хоста, который запускается с хост-машины, подключенной к тестируемому и эталонному устройствам. Модуль заменяет ручные тесты присутствия в CTS-V. Для устройств с Android 16 и более ранними версиями используйте тесты присутствия в выпусках CTS и CTS-V для этой версии Android.
Чтобы запустить тесты точности определения расстояния, выполните следующие действия:
Настройте хост-компьютер, а также CTS-V на тестируемом и эталонном устройствах. Подробнее о том, как настроить тесты для нескольких устройств на стороне хоста…
Разместите тестируемое и эталонное устройства на расстоянии 1 метра друг от друга, как описано в разделе Подготовка к тестированию точности определения расстояния и в инструкциях по калибровке для каждой технологии на этой странице.
Подключите оба устройства к хост-машине с помощью USB-кабелей.
Запустите консоль хоста CTS-V из каталога, в который вы распаковали пакет CTS-V:
./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefedВ консоли хоста CTS-V запустите тесты точности определения расстояния:
run cts-v-host -m CtsMultiDeviceGenericRangingAccuracyTestsРезультаты тестирования появятся в приложении CTS-V на тестируемом устройстве в разделе Host-side Tests (Тесты на стороне хоста) > UWB Tests (Тесты СШП) > CtsMultiDeviceGenericRangingAccuracyTests.
Каждый тестовый сценарий в модуле собирает измерения с помощью одной технологии, вычисляет показатели точности на основе измерений и регистрирует показатели. Отчет о тестировании считается пройденным, если измерения выполнены успешно, даже если показатели не соответствуют целевым значениям. Чтобы проверить соответствие требованиям, сравните зарегистрированные показатели с целевыми значениями, описанными в следующих разделах. Если тестируемое или эталонное устройство не поддерживает технологию, тестовый сценарий для нее пропускается.
Требования к СШП
Требования к СШП приведены в разделе 7.4.9 документа CDD.
Настройка калибровки СШП
Чтобы откалибровать устройство в соответствии с требованиями к СШП, выполните следующие действия.
Общие требования к настройке
Требуются два устройства с аппаратной поддержкой СШП: одно в качестве тестируемого, а другое – в качестве эталонного.
Вам понадобятся два штатива для устройств.
Тестируемое и эталонное устройства должны находиться на расстоянии 1 м друг от друга в зоне прямой видимости в безэховой камере. Оба устройства должны быть расположены в портретной ориентации, а их экраны должны быть направлены в противоположные стороны.
Пример настройки калибровки СШП показан на рисунке 1 и в видео 1.
Рисунок 1. Эталонная установка для калибровки СШП.
Видео 1. Эталонная установка для калибровки СШП.
Проверьте соответствие требованиям CDD 7.4.9 [C-1-6] и [C-1-7].
Чтобы проверить соответствие требованиям CDD 7.4.9 [C-1-6] и [C-1-7], запустите тесты точности определения расстояния и проверьте показатели, зарегистрированные тестовым сценарием test_uwb_ranging.
Тест запускает сеанс измерения расстояния между тестируемым и эталонным устройствами и выполняет 1000 измерений на каждом из них. Для измерений с каждого устройства отчет о тестировании делает следующее:
Диапазон рассчитывается по формуле: диапазон = 97,5-й процентиль - 2,5-й процентиль. Чтобы соответствовать требованиям, диапазон должен быть меньше или равен 30 см.
Вычисляет медианное значение. Чтобы соответствовать требованиям, медиана должна быть в диапазоне от 0,75 до 1,25 м включительно.
Требования к Wi-Fi Neighbor Awareness Networking
Раздел CDD 2.2.1. Hardware содержит требования к совместимости с Wi-Fi Neighbor Awareness Networking (NAN).
Проверьте соответствие требованиям CDD 2.2.1 [7.4.2.5/H-1-1]
Чтобы проверить соответствие требованиям CDD 2.2.1 [7.4.2.5/H-1-1], запустите тесты точности определения расстояния и проверьте показатели, зарегистрированные тестовым сценарием test_wifi_rtt_ranging.
Тест запускает сеанс определения расстояния по Wi-Fi NAN между тестируемым и эталонным устройствами и выполняет 100 измерений Wi-Fi RTT. Затем вычисляется процент измерений, которые находятся в пределах ±2 м от фактического расстояния в 1 м. Чтобы соответствовать требованиям для полосы пропускания 80 МГц, не менее 68 % измерений должны быть в пределах ±2 м.
Требования к BLE RSSI
CDD, раздел 7.4.3. Bluetooth содержит требования к соответствию BLE RSSI.
Настройка калибровки
Чтобы откалибровать устройство в соответствии с требованиями к BLE RSSI, выполните следующие действия.
Общие требования к настройке
Для получения оптимальных результатов используйте безэховую камеру, чтобы минимизировать помехи при измерениях.
Если у вас нет безэховой камеры, установите два штатива: один для эталонного устройства, а другой – для тестируемого.Они должны находиться на высоте 1,5 метра от пола и на таком же расстоянии от потолка.
Подготовьте эталонное и тестируемое устройства:
- Убедитесь, что оба устройства достаточно заряжены для выполнения тестов.
- Отключите оба устройства от сети питания.
- Снимите чехлы, отсоедините провода и другие аксессуары, которые могут влиять на радиочастотные характеристики.
Закрепите каждое устройство на штативе с помощью держателя.
- В штативах и держателях должно быть как можно меньше металлических деталей.
- Небольшая металлическая пружина в держателе устройства не помешает.
Уберите металлические предметы, которые находятся между устройствами.
Рисунок 2. Эталонная настройка для калибровки BLE.
Проверьте соответствие требованиям CDD 7.4.3 [C-10-1]
Чтобы проверить соответствие требованиям CDD 7.4.3 [C-10-1], запустите тесты точности определения расстояния, разместив устройства в соответствии с настройками калибровки BLE, и проверьте показатели, зарегистрированные тестовым сценарием test_ble_rssi_ranging.
В тестовом сценарии эталонное устройство настраивается на передачу рекламных пакетов с интервалом ADVERTISE_TX_POWER_HIGH, а тестируемое устройство выполняет 1000 сканирований. Затем вычисляется диапазон средних 95 % измерений RSSI. Чтобы соответствовать требованиям, диапазон должен быть меньше или равен 18 дБ.
Проверьте соответствие требованиям CDD 7.4.3 [C-10-2]
Чтобы проверить соответствие требованиям CDD 7.4.3 [C-10-2], поставщик чипа может измерить неравномерность АЧХ канала и определить различия между ядрами и каналами.
Ниже приведены советы по выявлению проблем с некалиброванными ядрами и некалиброванными каналами, которые являются двумя возможными причинами большого разброса RSSI.
Некалиброванные ядра
Если у антенны Bluetooth на устройстве несколько ядер, они могут быть откалиброваны по-разному. Выполните измерения (не менее 1 минуты) и проверьте данные сканирования. Если вы видите картину, похожую на показанную на рисунке 3, с регулярными пиками (обозначенными кружками) из-за сканирования на нескольких ядрах, скорее всего, существует проблема с некалиброванными ядрами и требуется дальнейшее исследование.
Рисунок 3. Пример данных сканирования для устройства с неоткалиброванными ядрами.
Некалиброванные каналы
Передача данных по классическому BLE происходит по трем каналам. Каждый канал может иметь связанные с ним различия. Каналы меняются через фиксированные интервалы времени. Выполните измерения (не менее 1 минуты) и проверьте данные сканирования. Если вы видите закономерность, похожую на показанную на рисунке 4, скорее всего, существует проблема с неправильной калибровкой на разных каналах, и требуется дальнейшее исследование.
Рисунок 4. Пример данных сканирования для устройства с некалиброванными каналами.
Проверьте соответствие требованиям CDD 7.4.3 [C-10-3] и [C-10-4].
Даже если радиочип BLE идеально откалиброван, RSSI, который наблюдает конкретное устройство, зависит от качества антенны и ее размещения на этом конкретном продукте (модели устройства). Это создает проблему для совместимости между устройствами.
Рассмотрим пример с разблокировкой автомобиля. Например, разработчик приложения может захотеть, чтобы автомобиль открывался, когда устройство находится в пределах одного метра от него. Разработчик выбирает пороговое значение -60 дБм на основе наблюдений за своим телефоном. Однако из-за различий в качестве и расположении антенны это значение может не подойти для другого устройства Android, даже если в обоих устройствах используется один и тот же чип.
Чтобы обеспечить совместимость всех устройств в экосистеме, необходимо измерить смещение Rx для каждого устройства и скорректировать RSSI, сообщаемый на устройстве, чтобы RSSI BLE соответствовал стандарту 1 м при ADVERTISE_TX_POWER_HIGH.
Даже если радиочипы BLE идеально откалиброваны, идеальный приемник считывает разные RSSI в зависимости от качества антенны и ее размещения на рекламном устройстве. Требование к Rx гарантирует, что все устройства смогут передавать данные с одинаковой мощностью при прочих равных условиях.
Чтобы проверить соответствие требованиям к Rx и Tx:
Разместите тестируемое устройство на расстоянии 1 м от эталонного устройства, следуя инструкциям по калибровке BLE. Рекомендуем расположить устройства параллельно друг другу, чтобы их экраны были направлены в одну сторону.
Запустите тесты точности определения расстояния и проверьте показатели, зарегистрированные тестовым сценарием
test_ble_rx_tx_offset_precision.Тест запускает тесты Rx и Tx одновременно и собирает 1000 сканирований для каждого теста:
- Rx. Тестируемое устройство выполняет сканирование, а эталонное устройство передает данные на частоте
ADVERTISE_TX_POWER_HIGH. - Tx. Эталонное устройство сканирует, пока тестируемое устройство передает данные на частоте
ADVERTISE_TX_POWER_HIGH.
Чтобы соответствовать требованиям, медианное значение RSSI для тестов Rx и Tx должно быть в диапазоне от -65 до -45 дБм.
- Rx. Тестируемое устройство выполняет сканирование, а эталонное устройство передает данные на частоте
Откалибруйте устройства, чтобы компенсировать смещение Rx и мощность Tx и обеспечить средний RSSI -55 дБм.
Rx. Скорректируйте RSSI, задав для системного свойства
bluetooth.hardware.radio.le_rx_path_loss_comp_dbзначение (в дБ), которое компенсирует смещение Rx, чтобы обеспечить медианное значение RSSI BLE, равное -55 дБм на расстоянии 1 м. Стек Bluetooth корректирует RSSI, прибавляя к нему значениеbluetooth.hardware.radio.le_rx_path_loss_comp_db.Подробную информацию можно найти в статье
le_scanning_manager.cc.Tx. Настройте мощность Tx, задав для системного свойства
bluetooth.hardware.radio.le_tx_path_loss_comp_dbзначение (в дБ), которое компенсирует мощность Tx, чтобы обеспечить средний уровень BLE RSSI -55 дБм на расстоянии 1 м. Стек Bluetooth корректирует мощность передачи, добавляя к ней значениеbluetooth.hardware.radio.le_tx_path_loss_comp_db.Подробную информацию можно найти в статье
le_advertising_manager.cc.
Требования к BLE Channel Sounding
CDD, раздел 7.4.3. Bluetooth включает требования к точности BLE Channel Sounding (CS). Требование [C-11-2] указывает, что устройства, заявляющие о поддержке FEATURE_BLUETOOTH_LE_CHANNEL_SOUNDING, должны точно сообщать диапазон в пределах ±0,5 м в 90-м процентиле, рассчитанном с помощью функции кумулятивного распределения (CDF), на расстоянии 1 м.
Проверьте соответствие требованиям CDD 7.4.3 [C-11-2]
Чтобы проверить соответствие требованиям CDD 7.4.3 [C-11-2], запустите тесты точности определения расстояния, разместив устройства в соответствии с настройками калибровки BLE, и проверьте показатели, зарегистрированные тестовым сценарием test_channel_sounding_ranging. И тестируемое, и эталонное устройство должны поддерживать BLE CS.
Тест связывает тестируемое и эталонное устройства по BLE, запускает между ними сеанс измерения расстояния BLE CS и выполняет 100 измерений. Затем вычисляется процент измерений, которые находятся в пределах ±0,5 м от фактического расстояния в 1 м. Чтобы соответствовать требованиям, не менее 90 % измерений должны быть в пределах ±0,5 м.