Калибровка присутствия

На этой странице представлены инструкции по настройке и калибровке функции определения присутствия для устройств под управлением Android 14 и выше.

Для обеспечения эффективной совместной работы смарт-устройств пользователей крайне важно, чтобы все устройства в экосистеме Android могли определять относительную близость между собой. В Android 14 введены требования к калибровке присутствия, которые определяют допустимые параметры работы доступных радиотехнологий, используемых для определения близости, таких как сверхширокополосная связь (UWB), Wi-Fi и Bluetooth Low Energy (BLE).

Эталонное устройство

Для калибровки вашего устройства в соответствии с требованиями к наличию сигнала используйте для всех калибровок одно из следующих эталонных устройств.

  • (Рекомендуется) Телефон Pixel
  • Если вы используете не телефон Pixel, используйте устройство той же марки и модели, что и тестируемое устройство.

форм-факторы

Калибровка по признаку присутствия важна для устройств Android всех форм-факторов. Для форм-факторов, отличных от мобильных телефонов, чтобы определить подходящую настройку калибровки для устройства, следует учитывать положение пользователя, держащего мобильный телефон (эталонное устройство), при взаимодействии с тестируемым устройством (DUT). Например, при калибровке телевизора расположите телевизор и мобильный телефон на соответствующем расстоянии друг от друга и сориентируйте мобильное устройство так, чтобы оно было обращено к передней центральной части экрана телевизора.

Требования UWB

Требования к UWB см. в разделе 7.4.9 CDD .

Настройка калибровки UWB

Для калибровки устройства в соответствии с требованиями UWB используйте следующие настройки.

Общие требования к настройке

  • Для работы требуются два устройства с аппаратным обеспечением UWB: одно в качестве тестируемого устройства (DUT), а другое — в качестве эталонного устройства.

  • Для установки устройств потребуются два штатива.

  • Испытуемое устройство и эталонное устройство должны быть размещены на расстоянии 1 метра друг от друга в условиях прямой видимости в не отражающей камере. Оба устройства должны быть расположены вертикально, экранами друг от друга.

Пример установки для калибровки UWB показан на рисунке 1 и в видео 1.

Эталонная конфигурация для калибровки BLE

Рисунок 1. Эталонная схема для калибровки UWB.

Видео 1. Эталонная установка для калибровки UWB.

Проверьте соответствие требованиям CDD 7.4.9 [C-1-6] и [C-1-7]

Для проверки соответствия требованиям CDD 7.4.9 [C-1-6] и [C-1-7] запустите многоустройственный тестовый пример CTS для измерения расстояния RangingMeasurementTest#test_distance_measurement_accuracy . Это ручной тест CTS.

run cts -m CtsUwbMultiDeviceTestCase_RangingMeasurementTests -t RangingMeasurementTest#test_distance_measurement_accuracy

Если к хост-машине CTS подключено более двух устройств, укажите идентификатор тестируемого устройства (DUT ID) и идентификатор эталонного устройства (refrection device ID) в команде run cts .

run cts -m CtsUwbMultiDeviceTestCase_RangingMeasurementTests -t RangingMeasurementTest#test_distance_measurement_accuracy --shard-count 2
-s DUT_ID -s REFERENCE_DEVICE_ID

В тестовом сценарии CTS для нескольких устройств запускается сеанс измерения расстояния по UWB-сети между тестируемым устройством и эталонным устройством, и выполняется 1000 измерений с использованием тестируемого устройства. Затем тест автоматически обрабатывает измерения и определяет, прошло ли устройство проверку или нет, выполняя следующие действия:

  1. Отсортируйте измерения в порядке возрастания.

  2. Размах вычисляется следующим образом: размах = 975-е измерение - 25-е измерение.

  3. Сообщите о дальности действия в многоустройственном тесте CTS. Для прохождения теста дальность действия должна быть менее 30 см.

  4. Укажите медианное значение (500-е) в многоустройственном тесте CTS. Для прохождения теста значение должно находиться в диапазоне от 0,75 м до 1,25 м включительно.

Требования к сети Wi-Fi Neighbor Awareness

Раздел 2.2.1. CDD. Аппаратное обеспечение включает требования к соответствию стандарту 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]:

  1. Установите (если ранее не устанавливалось) и откройте приложение CTS Verifier (CTS-V) как на тестируемом устройстве, так и на эталонном устройстве. Тест CTS-V для этого требования находится в разделе Presence Test > NAN Accuracy Test .

  2. Разместите тестируемое устройство на расстоянии 10 см от эталонного устройства, так чтобы между ними ничего не было.

  3. На экране тестирования эталонного устройства убедитесь, что установлен флажок « Является эталонным устройством» , затем нажмите «Начать публикацию» .

  4. Выберите расстояние тестирования 10 см в настройках CTS-V на тестируемом устройстве и нажмите «Начать тест» . Затем CTS Verifier выполнит 100 измерений расстояния, вычислит и запишет результаты измерений в журналы CTS-V. После завершения теста проверьте, находится ли вычисленное расстояние в пределах ожидаемого диапазона, в приложении CTS Verifier на тестируемом устройстве.

  5. Повторите шаги с 1 по 4 для остальных тестовых расстояний: 1 м, 3 м и 5 м. Тест считается пройденным, если значения для всех тестовых расстояний находятся в пределах ожидаемого диапазона. В противном случае на экране CTS-V отображаются тестовые расстояния, для которых тест не пройден.

Требования BLE RSSI

Раздел 7.4.3 CDD. Bluetooth включает требования к соответствию стандарту BLE RSSI.

Настройка калибровки

Используйте следующие настройки для калибровки вашего устройства в соответствии с требованиями BLE RSSI.

Общие требования к настройке

  • Для достижения оптимальных результатов используйте безэховую камеру, чтобы минимизировать помехи при измерениях.

    Если не используется безэховая камера, установите один штатив с эталонным устройством и один штатив с тестируемым устройством на высоте 1,5 метра от пола, с аналогичным зазором от потолка.

  • Подготовьте эталонное устройство и тестируемое устройство:

    • Убедитесь, что оба устройства достаточно заряжены для завершения тестов.
    • Во время тестирования отключите оба устройства от сети.
    • Удалите все корпуса, прикрепленные провода и другие устройства, которые могут повлиять на работу радиочастотного (РЧ) диапазона.

  • Прикрепите каждое устройство к штативу с помощью держателя для устройства.

    • Штативы и держатели для устройств должны содержать как можно меньше металлических деталей.
    • Небольшая металлическая пружинка в держателях устройств вполне допустима.

  • Удалите все металлические предметы, находящиеся между двумя устройствами.

Эталонная конфигурация для калибровки BLE

Рисунок 2. Эталонная схема для калибровки BLE.

Проверьте соответствие требованиям CDD 7.4.3 [C-10-1]

Для проверки соответствия требованиям CDD 7.4.3 [C-10-1]:

  1. Установите (если ранее не устанавливалось) и откройте приложение CTS Verifier (CTS-V) как на тестируемом устройстве, так и на эталонном устройстве. Тест CTS-V для этого требования находится в разделе Presence Test > BLE RSSI Precision Test .

  2. Разместите тестируемое устройство на расстоянии 1 м от эталонного устройства, следуя инструкциям по калибровке BLE.

  3. Нажмите «Начать рекламу» на эталонном устройстве, затем следуйте инструкциям на экране тестируемого устройства, чтобы ввести идентификатор устройства, специфичный для эталонного устройства, который отображается на эталонном устройстве после начала рекламы. Нажмите «Начать тест» на тестируемом устройстве.

  4. После завершения сбора данных (1000 сканирований, выполненных на тестируемом устройстве) тест автоматически считается пройденным или не пройденным в зависимости от вычисленного диапазона. Для прохождения теста диапазон должен быть меньше или равен 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, наблюдаемый конкретным устройством, зависит от качества антенны и ее расположения на данном изделии (модели устройства). Это создает проблему совместимости между устройствами.

Например, рассмотрим сценарий разблокировки автомобиля. Разработчик приложения может захотеть разблокировать автомобиль, когда устройство находится в пределах 1 метра от машины. Разработчик выбирает пороговое значение -60 дБм на основе своих наблюдений с имеющимся у него телефоном, но из-за различий в качестве и расположении антенн это может плохо работать с другим устройством Android, даже если оба устройства используют один и тот же чип.

Для обеспечения совместимости всех устройств в экосистеме необходимо измерить смещение Rx для каждого устройства и скорректировать отображаемый на устройстве уровень RSSI, чтобы гарантировать соответствие уровня RSSI BLE стандарту 1 м при ADVERTISE_TX_POWER_HIGH .

Даже при идеальной калибровке BLE-чипов идеальный приемник показывает разное значение RSSI в зависимости от качества антенны и ее расположения на передающем устройстве. Требование к Rx гарантирует, что все устройства смогут передавать сигнал с одинаковой мощностью при прочих равных условиях.

Для устройств под управлением Android 14 и выше, чтобы проверить соответствие требованиям к приему и передаче данных:

  1. Установите (если ранее не устанавливалось) и откройте приложение CTS Verifier (CTS-V) как на тестируемом устройстве, так и на эталонном устройстве. Тест CTS-V для этого требования находится в разделе Presence Test > BLE Rx/Tx Offset Precision Test .

  2. Разместите тестируемое устройство на расстоянии 1 м от эталонного устройства, следуя инструкциям по калибровке BLE. Рекомендуется ориентировать устройства параллельно друг другу, так чтобы экраны были обращены в одном направлении.

  3. Нажмите кнопку «Начать рекламу» на эталонном устройстве, затем следуйте инструкциям на экране тестируемого устройства, чтобы ввести идентификатор устройства, специфичный для эталонного устройства, который отобразится на эталонном устройстве после начала рекламы.

  4. Нажмите кнопку «Запустить тест» на тестируемом устройстве. В этом тесте, для проверки требований к приему сигнала, эталонное устройство выполняет сканирование в фоновом режиме одновременно с запуском рекламной кампании.

    После завершения сбора данных (1000 сканирований, собранных на обоих устройствах) тест считается пройденным, если вычисленное медианное значение (500-е измерение) для обоих тестов Rx и Tx находится в диапазоне от -65 дБм до -45 дБм. Тест считается не пройденным, если вычисленное медианное значение для теста Rx или Tx не находится в допустимом диапазоне.

  5. Откалибруйте устройства для компенсации смещения приемника и мощности передатчика, чтобы обеспечить медианное значение RSSI -55 дБм.

    • Прием: Отрегулируйте RSSI, установив системное свойство bluetooth.hardware.radio.le_rx_path_loss_comp_db на значение (дБ), которое компенсирует смещение приема, чтобы обеспечить медианное значение BLE RSSI -55 дБм на расстоянии 1 м. Стек Bluetooth корректирует RSSI до значения RSSI плюс значение bluetooth.hardware.radio.le_rx_path_loss_comp_db .

      Подробности см. на сайте le_scanning_manager.cc .

    • Tx: Отрегулируйте мощность передачи, установив системное свойство bluetooth.hardware.radio.le_tx_path_loss_comp_db на значение (дБ), которое компенсирует мощность передачи для обеспечения среднего уровня BLE RSSI -55 дБм на расстоянии 1 м. Стек Bluetooth регулирует мощность передачи как мощность передачи плюс значение bluetooth.hardware.radio.le_tx_path_loss_comp_db .

      Подробности см. на сайте le_advertising_manager.cc .

,

На этой странице представлены инструкции по настройке и калибровке функции определения присутствия для устройств под управлением Android 14 и выше.

Для обеспечения эффективной совместной работы смарт-устройств пользователей крайне важно, чтобы все устройства в экосистеме Android могли определять относительную близость между собой. В Android 14 введены требования к калибровке присутствия, которые определяют допустимые параметры работы доступных радиотехнологий, используемых для определения близости, таких как сверхширокополосная связь (UWB), Wi-Fi и Bluetooth Low Energy (BLE).

Эталонное устройство

Для калибровки вашего устройства в соответствии с требованиями к наличию сигнала используйте для всех калибровок одно из следующих эталонных устройств.

  • (Рекомендуется) Телефон Pixel
  • Если вы используете не телефон Pixel, используйте устройство той же марки и модели, что и тестируемое устройство.

форм-факторы

Калибровка по признаку присутствия важна для устройств Android всех форм-факторов. Для форм-факторов, отличных от мобильных телефонов, чтобы определить подходящую настройку калибровки для устройства, следует учитывать положение пользователя, держащего мобильный телефон (эталонное устройство), при взаимодействии с тестируемым устройством (DUT). Например, при калибровке телевизора расположите телевизор и мобильный телефон на соответствующем расстоянии друг от друга и сориентируйте мобильное устройство так, чтобы оно было обращено к передней центральной части экрана телевизора.

Требования UWB

Требования к UWB см. в разделе 7.4.9 CDD .

Настройка калибровки UWB

Для калибровки устройства в соответствии с требованиями UWB используйте следующие настройки.

Общие требования к настройке

  • Для работы требуются два устройства с аппаратным обеспечением UWB: одно в качестве тестируемого устройства (DUT), а другое — в качестве эталонного устройства.

  • Для установки устройств потребуются два штатива.

  • Испытуемое устройство и эталонное устройство должны быть размещены на расстоянии 1 метра друг от друга в условиях прямой видимости в не отражающей камере. Оба устройства должны быть расположены вертикально, экранами друг от друга.

Пример установки для калибровки UWB показан на рисунке 1 и в видео 1.

Эталонная конфигурация для калибровки BLE

Рисунок 1. Эталонная схема для калибровки UWB.

Видео 1. Эталонная установка для калибровки UWB.

Проверьте соответствие требованиям CDD 7.4.9 [C-1-6] и [C-1-7]

Для проверки соответствия требованиям CDD 7.4.9 [C-1-6] и [C-1-7] запустите многоустройственный тестовый пример CTS для измерения расстояния RangingMeasurementTest#test_distance_measurement_accuracy . Это ручной тест CTS.

run cts -m CtsUwbMultiDeviceTestCase_RangingMeasurementTests -t RangingMeasurementTest#test_distance_measurement_accuracy

Если к хост-машине CTS подключено более двух устройств, укажите идентификатор тестируемого устройства (DUT ID) и идентификатор эталонного устройства (refrection device ID) в команде run cts .

run cts -m CtsUwbMultiDeviceTestCase_RangingMeasurementTests -t RangingMeasurementTest#test_distance_measurement_accuracy --shard-count 2
-s DUT_ID -s REFERENCE_DEVICE_ID

В тестовом сценарии CTS для нескольких устройств запускается сеанс измерения расстояния по UWB-сети между тестируемым устройством и эталонным устройством, и выполняется 1000 измерений с использованием тестируемого устройства. Затем тест автоматически обрабатывает измерения и определяет, прошло ли устройство проверку или нет, выполняя следующие действия:

  1. Отсортируйте измерения в порядке возрастания.

  2. Размах вычисляется следующим образом: размах = 975-е измерение - 25-е измерение.

  3. Сообщите о дальности действия в многоустройственном тесте CTS. Для прохождения теста дальность действия должна быть менее 30 см.

  4. Укажите медианное значение (500-е) в многоустройственном тесте CTS. Для прохождения теста значение должно находиться в диапазоне от 0,75 м до 1,25 м включительно.

Требования к сети Wi-Fi Neighbor Awareness

Раздел 2.2.1. CDD. Аппаратное обеспечение включает требования к соответствию стандарту 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]:

  1. Установите (если ранее не устанавливалось) и откройте приложение CTS Verifier (CTS-V) как на тестируемом устройстве, так и на эталонном устройстве. Тест CTS-V для этого требования находится в разделе Presence Test > NAN Accuracy Test .

  2. Разместите тестируемое устройство на расстоянии 10 см от эталонного устройства, так чтобы между ними ничего не было.

  3. На экране тестирования эталонного устройства убедитесь, что установлен флажок « Является эталонным устройством» , затем нажмите «Начать публикацию» .

  4. Выберите расстояние тестирования 10 см в настройках CTS-V на тестируемом устройстве и нажмите «Начать тест» . Затем CTS Verifier выполнит 100 измерений расстояния, вычислит и запишет результаты измерений в журналы CTS-V. После завершения теста проверьте, находится ли вычисленное расстояние в пределах ожидаемого диапазона, в приложении CTS Verifier на тестируемом устройстве.

  5. Повторите шаги с 1 по 4 для остальных тестовых расстояний: 1 м, 3 м и 5 м. Тест считается пройденным, если значения для всех тестовых расстояний находятся в пределах ожидаемого диапазона. В противном случае на экране CTS-V отображаются тестовые расстояния, для которых тест не пройден.

Требования BLE RSSI

Раздел 7.4.3 CDD. Bluetooth включает требования к соответствию стандарту BLE RSSI.

Настройка калибровки

Используйте следующие настройки для калибровки вашего устройства в соответствии с требованиями BLE RSSI.

Общие требования к настройке

  • Для достижения оптимальных результатов используйте безэховую камеру, чтобы минимизировать помехи при измерениях.

    Если не используется безэховая камера, установите один штатив с эталонным устройством и один штатив с тестируемым устройством на высоте 1,5 метра от пола, с аналогичным зазором от потолка.

  • Подготовьте эталонное устройство и тестируемое устройство:

    • Убедитесь, что оба устройства достаточно заряжены для завершения тестов.
    • Во время тестирования отключите оба устройства от сети.
    • Удалите все корпуса, прикрепленные провода и другие устройства, которые могут повлиять на работу радиочастотного (РЧ) диапазона.

  • Прикрепите каждое устройство к штативу с помощью держателя для устройства.

    • Штативы и держатели для устройств должны содержать как можно меньше металлических деталей.
    • Небольшая металлическая пружинка в держателях устройств вполне допустима.

  • Удалите все металлические предметы, находящиеся между двумя устройствами.

Эталонная конфигурация для калибровки BLE

Рисунок 2. Эталонная схема для калибровки BLE.

Проверьте соответствие требованиям CDD 7.4.3 [C-10-1]

Для проверки соответствия требованиям CDD 7.4.3 [C-10-1]:

  1. Установите (если ранее не устанавливалось) и откройте приложение CTS Verifier (CTS-V) как на тестируемом устройстве, так и на эталонном устройстве. Тест CTS-V для этого требования находится в разделе Presence Test > BLE RSSI Precision Test .

  2. Разместите тестируемое устройство на расстоянии 1 м от эталонного устройства, следуя инструкциям по калибровке BLE.

  3. Нажмите «Начать рекламу» на эталонном устройстве, затем следуйте инструкциям на экране тестируемого устройства, чтобы ввести идентификатор устройства, специфичный для эталонного устройства, который отображается на эталонном устройстве после начала рекламы. Нажмите «Начать тест» на тестируемом устройстве.

  4. После завершения сбора данных (1000 сканирований, выполненных на тестируемом устройстве) тест автоматически считается пройденным или не пройденным в зависимости от вычисленного диапазона. Для прохождения теста диапазон должен быть меньше или равен 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, наблюдаемый конкретным устройством, зависит от качества антенны и ее расположения на данном изделии (модели устройства). Это создает проблему совместимости между устройствами.

Например, рассмотрим сценарий разблокировки автомобиля. Разработчик приложения может захотеть разблокировать автомобиль, когда устройство находится в пределах 1 метра от машины. Разработчик выбирает пороговое значение -60 дБм на основе своих наблюдений с имеющимся у него телефоном, но из-за различий в качестве и расположении антенн это может плохо работать с другим устройством Android, даже если оба устройства используют один и тот же чип.

Для обеспечения совместимости всех устройств в экосистеме необходимо измерить смещение Rx для каждого устройства и скорректировать отображаемый на устройстве уровень RSSI, чтобы гарантировать соответствие уровня RSSI BLE стандарту 1 м при ADVERTISE_TX_POWER_HIGH .

Даже при идеальной калибровке BLE-чипов идеальный приемник показывает разное значение RSSI в зависимости от качества антенны и ее расположения на передающем устройстве. Требование к Rx гарантирует, что все устройства смогут передавать сигнал с одинаковой мощностью при прочих равных условиях.

Для устройств под управлением Android 14 и выше, чтобы проверить соответствие требованиям к приему и передаче данных:

  1. Установите (если ранее не устанавливалось) и откройте приложение CTS Verifier (CTS-V) как на тестируемом устройстве, так и на эталонном устройстве. Тест CTS-V для этого требования находится в разделе Presence Test > BLE Rx/Tx Offset Precision Test .

  2. Разместите тестируемое устройство на расстоянии 1 м от эталонного устройства, следуя инструкциям по калибровке BLE. Рекомендуется ориентировать устройства параллельно друг другу, так чтобы экраны были обращены в одном направлении.

  3. Нажмите кнопку «Начать рекламу» на эталонном устройстве, затем следуйте инструкциям на экране тестируемого устройства, чтобы ввести идентификатор устройства, специфичный для эталонного устройства, который отобразится на эталонном устройстве после начала рекламы.

  4. Нажмите кнопку «Запустить тест» на тестируемом устройстве. В этом тесте, для проверки требований к приему сигнала, эталонное устройство выполняет сканирование в фоновом режиме одновременно с запуском рекламной кампании.

    После завершения сбора данных (1000 сканирований, собранных на обоих устройствах) тест считается пройденным, если вычисленное медианное значение (500-е измерение) для обоих тестов Rx и Tx находится в диапазоне от -65 дБм до -45 дБм. Тест считается не пройденным, если вычисленное медианное значение для теста Rx или Tx не находится в допустимом диапазоне.

  5. Откалибруйте устройства для компенсации смещения приемника и мощности передатчика, чтобы обеспечить медианное значение RSSI -55 дБм.

    • Прием: Отрегулируйте RSSI, установив системное свойство bluetooth.hardware.radio.le_rx_path_loss_comp_db на значение (дБ), которое компенсирует смещение приема, чтобы обеспечить медианное значение BLE RSSI -55 дБм на расстоянии 1 м. Стек Bluetooth корректирует RSSI до значения RSSI плюс значение bluetooth.hardware.radio.le_rx_path_loss_comp_db .

      Подробности см. на сайте le_scanning_manager.cc .

    • Tx: Отрегулируйте мощность передачи, установив системное свойство bluetooth.hardware.radio.le_tx_path_loss_comp_db на значение (дБ), которое компенсирует мощность передачи для обеспечения среднего уровня BLE RSSI -55 дБм на расстоянии 1 м. Стек Bluetooth регулирует мощность передачи как мощность передачи плюс значение bluetooth.hardware.radio.le_tx_path_loss_comp_db .

      Подробности см. на сайте le_advertising_manager.cc .

,

На этой странице представлены инструкции по настройке и калибровке функции определения присутствия для устройств под управлением Android 14 и выше.

Для обеспечения эффективной совместной работы смарт-устройств пользователей крайне важно, чтобы все устройства в экосистеме Android могли определять относительную близость между собой. В Android 14 введены требования к калибровке присутствия, которые определяют допустимые параметры работы доступных радиотехнологий, используемых для определения близости, таких как сверхширокополосная связь (UWB), Wi-Fi и Bluetooth Low Energy (BLE).

Эталонное устройство

Для калибровки вашего устройства в соответствии с требованиями к наличию сигнала используйте для всех калибровок одно из следующих эталонных устройств.

  • (Рекомендуется) Телефон Pixel
  • Если вы используете не телефон Pixel, используйте устройство той же марки и модели, что и тестируемое устройство.

форм-факторы

Калибровка по признаку присутствия важна для устройств Android всех форм-факторов. Для форм-факторов, отличных от мобильных телефонов, чтобы определить подходящую настройку калибровки для устройства, следует учитывать положение пользователя, держащего мобильный телефон (эталонное устройство), при взаимодействии с тестируемым устройством (DUT). Например, при калибровке телевизора расположите телевизор и мобильный телефон на соответствующем расстоянии друг от друга и сориентируйте мобильное устройство так, чтобы оно было обращено к передней центральной части экрана телевизора.

Требования UWB

Требования к UWB см. в разделе 7.4.9 CDD .

Настройка калибровки UWB

Для калибровки устройства в соответствии с требованиями UWB используйте следующие настройки.

Общие требования к настройке

  • Для работы требуются два устройства с аппаратным обеспечением UWB: одно в качестве тестируемого устройства (DUT), а другое — в качестве эталонного устройства.

  • Для установки устройств потребуются два штатива.

  • Испытуемое устройство и эталонное устройство должны быть размещены на расстоянии 1 метра друг от друга в условиях прямой видимости в не отражающей камере. Оба устройства должны быть расположены вертикально, экранами друг от друга.

Пример установки для калибровки UWB показан на рисунке 1 и в видео 1.

Эталонная конфигурация для калибровки BLE

Рисунок 1. Эталонная схема для калибровки UWB.

Видео 1. Эталонная установка для калибровки UWB.

Проверьте соответствие требованиям CDD 7.4.9 [C-1-6] и [C-1-7]

Для проверки соответствия требованиям CDD 7.4.9 [C-1-6] и [C-1-7] запустите многоустройственный тестовый пример CTS для измерения расстояния RangingMeasurementTest#test_distance_measurement_accuracy . Это ручной тест CTS.

run cts -m CtsUwbMultiDeviceTestCase_RangingMeasurementTests -t RangingMeasurementTest#test_distance_measurement_accuracy

Если к хост-машине CTS подключено более двух устройств, укажите идентификатор тестируемого устройства (DUT ID) и идентификатор эталонного устройства (refrection device ID) в команде run cts .

run cts -m CtsUwbMultiDeviceTestCase_RangingMeasurementTests -t RangingMeasurementTest#test_distance_measurement_accuracy --shard-count 2
-s DUT_ID -s REFERENCE_DEVICE_ID

В тестовом сценарии CTS для нескольких устройств запускается сеанс измерения расстояния по UWB-сети между тестируемым устройством и эталонным устройством, и выполняется 1000 измерений с использованием тестируемого устройства. Затем тест автоматически обрабатывает измерения и определяет, прошло ли устройство проверку или нет, выполняя следующие действия:

  1. Отсортируйте измерения в порядке возрастания.

  2. Размах вычисляется следующим образом: размах = 975-е измерение - 25-е измерение.

  3. Сообщите о дальности действия в многоустройственном тесте CTS. Для прохождения теста дальность действия должна быть менее 30 см.

  4. Укажите медианное значение (500-е) в многоустройственном тесте CTS. Для прохождения теста значение должно находиться в диапазоне от 0,75 м до 1,25 м включительно.

Требования к сети Wi-Fi Neighbor Awareness

Раздел 2.2.1. CDD. Аппаратное обеспечение включает требования к соответствию стандарту 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]:

  1. Установите (если ранее не устанавливалось) и откройте приложение CTS Verifier (CTS-V) как на тестируемом устройстве, так и на эталонном устройстве. Тест CTS-V для этого требования находится в разделе Presence Test > NAN Accuracy Test .

  2. Разместите тестируемое устройство на расстоянии 10 см от эталонного устройства, так чтобы между ними ничего не было.

  3. На экране тестирования эталонного устройства убедитесь, что установлен флажок « Является эталонным устройством» , затем нажмите «Начать публикацию» .

  4. Выберите расстояние тестирования 10 см в настройках CTS-V на тестируемом устройстве и нажмите «Начать тест» . Затем CTS Verifier выполнит 100 измерений расстояния, вычислит и запишет результаты измерений в журналы CTS-V. После завершения теста проверьте, находится ли вычисленное расстояние в пределах ожидаемого диапазона, в приложении CTS Verifier на тестируемом устройстве.

  5. Повторите шаги с 1 по 4 для остальных тестовых расстояний: 1 м, 3 м и 5 м. Тест считается пройденным, если значения для всех тестовых расстояний находятся в пределах ожидаемого диапазона. В противном случае на экране CTS-V отображаются тестовые расстояния, для которых тест не пройден.

Требования BLE RSSI

Раздел 7.4.3 CDD. Bluetooth включает требования к соответствию стандарту BLE RSSI.

Настройка калибровки

Используйте следующие настройки для калибровки вашего устройства в соответствии с требованиями BLE RSSI.

Общие требования к настройке

  • Для достижения оптимальных результатов используйте безэховую камеру, чтобы минимизировать помехи при измерениях.

    Если не используется безэховая камера, установите один штатив с эталонным устройством и один штатив с тестируемым устройством на высоте 1,5 метра от пола, с аналогичным зазором от потолка.

  • Подготовьте эталонное устройство и тестируемое устройство:

    • Убедитесь, что оба устройства достаточно заряжены для завершения тестов.
    • Во время тестирования отключите оба устройства от сети.
    • Удалите все корпуса, прикрепленные провода и другие устройства, которые могут повлиять на работу радиочастотного (РЧ) диапазона.

  • Прикрепите каждое устройство к штативу с помощью держателя для устройства.

    • Штативы и держатели для устройств должны содержать как можно меньше металлических деталей.
    • Небольшая металлическая пружинка в держателях устройств вполне допустима.

  • Удалите все металлические предметы, находящиеся между двумя устройствами.

Эталонная конфигурация для калибровки BLE

Рисунок 2. Эталонная схема для калибровки BLE.

Проверьте соответствие требованиям CDD 7.4.3 [C-10-1]

Для проверки соответствия требованиям CDD 7.4.3 [C-10-1]:

  1. Установите (если ранее не устанавливалось) и откройте приложение CTS Verifier (CTS-V) как на тестируемом устройстве, так и на эталонном устройстве. Тест CTS-V для этого требования находится в разделе Presence Test > BLE RSSI Precision Test .

  2. Разместите тестируемое устройство на расстоянии 1 м от эталонного устройства, следуя инструкциям по калибровке BLE.

  3. Нажмите «Начать рекламу» на эталонном устройстве, затем следуйте инструкциям на экране тестируемого устройства, чтобы ввести идентификатор устройства, специфичный для эталонного устройства, который отображается на эталонном устройстве после начала рекламы. Нажмите «Начать тест» на тестируемом устройстве.

  4. После завершения сбора данных (1000 сканирований, выполненных на тестируемом устройстве) тест автоматически считается пройденным или не пройденным в зависимости от вычисленного диапазона. Для прохождения теста диапазон должен быть меньше или равен 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, наблюдаемый конкретным устройством, зависит от качества антенны и ее расположения на данном изделии (модели устройства). Это создает проблему совместимости между устройствами.

Например, рассмотрим сценарий разблокировки автомобиля. Разработчик приложения может захотеть разблокировать автомобиль, когда устройство находится в пределах 1 метра от машины. Разработчик выбирает пороговое значение -60 дБм на основе своих наблюдений с имеющимся у него телефоном, но из-за различий в качестве и расположении антенн это может плохо работать с другим устройством Android, даже если оба устройства используют один и тот же чип.

For interoperability between all devices in the ecosystem, you must measure the Rx offset for each device and adjust the RSSI reported on the device to ensure that the BLE RSSI meets the standard of 1 m at ADVERTISE_TX_POWER_HIGH .

Even when the BLE radio chips are perfectly calibrated, the ideal receiver reads different RSSI depending on the antenna quality and antenna placement on the advertising device. The Rx requirement ensures that all devices are able to advertise with the same resulting strength, all else being equal.

For devices running Android 14 and higher, to verify compliance with the Rx and Tx requirement:

  1. Install (if not previously installed) and open the CTS Verifier app (CTS-V) on both the DUT and reference device. The CTS-V test for this requirement is under Presence Test > BLE Rx/Tx Offset Precision Test .

  2. Place the DUT at the test distance of 1 m away from the reference device, following the BLE calibration setup . We recommend devices be oriented such that they are parallel to each other with screens facing the same direction.

  3. Tap Start advertising on the reference device, then follow the instructions on the DUT's screen to input the device ID specific to the reference device, which is displayed on the reference device after advertising starts.

  4. Tap Start Test on the DUT. In this test, to verify the Rx requirement, the reference device performs scans in the background at the same time as when advertising is started.

    When data collection is complete (1,000 scans collected on both devices), the test passes if the computed median (500th measurement) for both Rx and Tx tests are between -65 dBm and -45 dBm. The test fails if the computed median for the Rx or Tx test isn't within the accepted range.

  5. Calibrate the devices to compensate the Rx offset and Tx power to ensure a median RSSI of -55 dBm.

    • Rx: Adjust the RSSI by setting the bluetooth.hardware.radio.le_rx_path_loss_comp_db system property to the value (dB) that compensates the Rx offset to ensure a median BLE RSSI of -55 dBm at 1 m. The Bluetooth stack adjusts the RSSI to be RSSI plus the value of bluetooth.hardware.radio.le_rx_path_loss_comp_db .

      For details, see le_scanning_manager.cc .

    • Tx: Adjust the Tx power by setting the bluetooth.hardware.radio.le_tx_path_loss_comp_db system property to the value (dB) that compensates the Tx power to ensure a median BLE RSSI of -55 dBm at 1 m. The Bluetooth stack adjusts the Tx power to be Tx power plus the value of bluetooth.hardware.radio.le_tx_path_loss_comp_db .

      For details, see le_advertising_manager.cc .