Спецификация аксессуаров для сети Портала поиска

v1.3

Спецификация аксессуаров для сети Портала поиска (FHN) определяет подход со сквозным шифрованием для отслеживания устройств Bluetooth с низким энергопотреблением (BLE), передающих сигналы. В этой статье описывается, как FHN расширяет спецификацию Быстрого подключения. Поставщикам следует включить это расширение, если у них есть устройства, совместимые с FHN, и они хотят включить для них отслеживание местоположения.

Спецификация GATT

В сервис быстрого подключения необходимо добавить дополнительную характеристику GATT со следующей семантикой:

Характеристика сервиса быстрого подключения Зашифровано Разрешения UUID
Действия с маячками Нет Чтение, запись и уведомления FE2C1238-8366-4814-8EB0-01DE32100BEA

Таблица 1. Характеристики сервиса "Быстрое подключение" для FHN.

Аутентификация

Операции, необходимые для этого расширения, выполняются как операции записи, защищенные механизмом "запрос-ответ". Перед выполнением любой операции Искатель должен выполнить операцию чтения из характеристики в таблице 1, которая приводит к созданию буфера в следующем формате:

Октет Тип данных Описание Значение
0 uint8 Номер основной версии протокола 0x01
1–8 массив байтов Одноразовый случайный одноразовый номер varies

Каждая операция чтения должна приводить к созданию нового одноразового кода, который будет действителен только для одной операции. Одноразовый код должен быть аннулирован, даже если операция не удалась.

Затем Искатель вычисляет одноразовый ключ аутентификации, который будет использоваться в последующем запросе на запись. Ключ аутентификации рассчитывается, как описано в таблицах 2–5. В зависимости от запрашиваемой операции Искатель подтверждает знание одного или нескольких из следующих ключей:

Операции

Формат данных, записываемых в характеристику, приведен в таблицах 2–5. Каждая из этих операций подробно описана ниже.

Октет Тип данных Описание Значение
0 uint8 Идентификатор данных
  • 0x00: чтение параметров маяка
  • 0x01: чтение состояния инициализации
  • 0x02: задать временный ключ идентификации
  • 0x03: удалить временный ключ идентификации
1 uint8 Размер сообщения varies
2–9 массив байтов Одноразовый ключ аутентификации Первые 8 байт HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data)
10 - var массив байтов Дополнительные данные
  • 0x00: n/a
  • 0x01: нет
  • 0x02: 32 байта, которые представляют собой временный ключ идентификации, зашифрованный с помощью AES-ECB-128 и ключа аккаунта. Если у поставщика уже есть набор временных ключей идентификации, также отправьте первые 8 байтов SHA256(current ephemeral identity key || the last nonce read from the characteristic).
  • 0x03: первые 8 байт SHA256(ephemeral identity key || the last nonce read from the characteristic)

Таблица 2. Запрос на инициализацию маячка.

Октет Тип данных Описание Значение
0 uint8 Идентификатор данных 0x04: чтение временного ключа идентификации с согласия пользователя
1 uint8 Размер сообщения 0x08
2–9 массив байтов Одноразовый ключ аутентификации Первые 8 байт HMAC-SHA256(recovery key, protocol major version number || the last nonce read from the characteristic || data ID || data length)

Таблица 3. Запрос на восстановление ключа инициализации маяка.

Октет Тип данных Описание Значение
0 uint8 Идентификатор данных
  • 0x05: кольцо
  • 0x06: чтение состояния звонка
1 uint8 Размер сообщения varies
2–9 массив байтов Одноразовый ключ аутентификации Первые 8 байт HMAC-SHA256(ring key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data)
10 - var массив байтов Дополнительные данные
  • 0x05: 4 байта, указывающие на состояние звонка, его продолжительность и громкость.
  • 0x06: не применимо

Таблица 4. Запрос на звонок.

Октет Тип данных Описание Значение
0 uint8 Идентификатор данных
  • 0x07: активировать режим защиты от слежения
  • 0x08: отключить режим защиты от нежелательного отслеживания
1 uint8 Размер сообщения varies
2–9 массив байтов Одноразовый ключ аутентификации Первые 8 байт HMAC-SHA256(unwanted tracking protection key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data)
10 - var массив байтов Дополнительные данные
  • 0x07: 1 байт флагов управления (необязательно)
  • 0x08: первые 8 байт SHA256(ephemeral identity key || the last nonce read from the characteristic)

Таблица 5. Запросы на защиту от нежелательного отслеживания.

При успешной записи активируются уведомления, перечисленные в таблице 6.

Уведомления с идентификатором данных, отличным от 0x05: Ring state change, должны отправляться до завершения транзакции записи, которая активирует уведомление, то есть до отправки PDU ответа на запрос записи.

Октет Тип данных Описание Значение
0 uint8 Идентификатор данных
  • 0x00: чтение параметров маяка
  • 0x01: чтение состояния инициализации
  • 0x02: задать временный ключ идентификации
  • 0x03: удалить временный ключ идентификации
  • 0x04: чтение временного ключа идентификации с согласия пользователя
  • 0x05: изменение состояния звонка
  • 0x06: чтение состояния звонка
  • 0x07: активировать режим защиты от слежения
  • 0x08: отключить режим защиты от нежелательного отслеживания
1 uint8 Размер сообщения varies
2–9 массив байтов Аутентификация Подробные сведения по операциям
10 - var массив байтов Дополнительные данные
  • 0x00: 8 байт, указывающих на мощность передачи, значение часов, метод шифрования и возможности звонка, AES-ECB-128, зашифрованные с помощью ключа аккаунта (с нулевым заполнением).
  • 0x01: 1 байт, указывающий на состояние инициализации, за которым следует текущий временный идентификатор (20 или 32 байта), если применимо.
  • 0x04: 32 байта, которые представляют собой временный ключ идентификации, зашифрованный с помощью AES-ECB-128 с ключом аккаунта.
  • 0x05: 4 байта, указывающие на новое состояние и триггер для изменения.
  • 0x06: 3 байта, указывающие на активно звонящие компоненты и количество децисекунд, оставшихся до звонка.
  • Другие идентификаторы данных используют пустые дополнительные данные.

Таблица 6. Ответ сервиса маяков.

В таблице 7 перечислены возможные коды ошибок GATT, возвращаемые операциями.

Код Описание Примечания
0x80 требуется аутентификация Возвращается в ответ на запрос записи, если аутентификация не удалась (в том числе если использовался старый одноразовый код).
0x81 Недопустимое значение. Возвращается, если указано недопустимое значение или полученные данные имеют непредвиденное количество байтов.
0x82 Нет согласия пользователя Возвращается в ответ на запрос записи с идентификатором данных 0x04: чтение временного идентификационного ключа с согласия пользователя, когда устройство не находится в режиме подключения.

Таблица 7. Коды ошибок GATT.

Считывание параметра маячка

Искатель может запросить у Поставщика параметры маячка, выполнив операцию записи в характеристику, состоящую из запроса из таблицы 2 с идентификатором данных 0x00. Поставщик проверяет, совпадает ли предоставленный одноразовый ключ аутентификации с каким-либо из ключей аккаунта, хранящихся на устройстве.

Если проверка не пройдена, поставщик возвращает ошибку аутентификации.

В случае успеха поставщик отправляет уведомление с ответом из таблицы 6 с идентификатором данных 0x00. Поставщик создает сегмент данных следующим образом:

Октет Тип данных Описание Значение
0 uint8 Калиброванная мощность Калиброванная мощность, полученная на расстоянии 0 м (значение в диапазоне [-100, 20]). Представлено в виде целого числа со знаком и разрешением 1 дБм.
1–4 uint32 Значение часов Текущее значение времени в секундах (от старшего к младшему).
5 uint8 Выбор кривой Эллиптическая кривая, используемая для шифрования:
  • 0x00 (по умолчанию): SECP160R1
  • 0x01: SECP256R1 (требуется расширенное объявление)
6 uint8 Компоненты Количество компонентов, способных звонить:
  • 0x00 – устройство не может звонить.
  • 0x01: указывает, что звонить может только один компонент.
  • 0x02: указывает, что два компонента (левый и правый наушники) могут звонить независимо друг от друга.
  • 0x03: указывает, что три компонента (левый и правый наушники, а также чехол) могут звонить независимо друг от друга.
7 uint8 Возможности звонков Доступны следующие варианты:
  • 0x00: выбор громкости звонка недоступен.
  • 0x01: доступен выбор громкости звонка. Если этот параметр задан, Поставщик должен принимать и обрабатывать три уровня громкости, как указано в разделе Работа звонка.
8-15 массив байтов Поля Нулевое заполнение для шифрования по алгоритму AES.

Данные должны быть зашифрованы по алгоритму AES-ECB-128 с помощью ключа аккаунта, используемого для аутентификации запроса.

Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data after encryption || 0x01).

Чтение статуса инициализации маячка

Искатель может запросить у Поставщика статус инициализации маяка, выполнив операцию записи в характеристику, состоящую из запроса из таблицы 2 с идентификатором данных 0x01. Поставщик проверяет, совпадает ли предоставленный одноразовый ключ аутентификации с каким-либо из ключей аккаунта, хранящихся на устройстве.

Если проверка не пройдена, поставщик возвращает ошибку аутентификации.

В случае успеха Поставщик отправляет уведомление с ответом из таблицы 6 с идентификатором данных 0x01. Поставщик создает сегмент данных следующим образом:

Октет Тип данных Описание Значение
0 uint8 Состояние инициализации Битовая маска со следующими значениями:
  • Бит 1 (0x01): устанавливается, если для устройства задан временный ключ идентификации.
  • Бит 2 (0x02): устанавливается, если предоставленный одноразовый ключ аутентификации совпадает с ключом аккаунта владельца.
1–20 или 32 массив байтов Текущий временный идентификатор 20 или 32 байта (в зависимости от используемого метода шифрования), указывающие на текущий временный идентификатор, который передает маячок, если он задан для устройства.

Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data || 0x01).

Как задать временный ключ идентификации

Чтобы инициализировать неинициализированное устройство-поставщик в качестве маячка сети "Найти устройство" или изменить временный ключ идентификации уже инициализированного устройства-поставщика, устройство-искатель выполняет операцию записи в характеристику, состоящую из запроса из таблицы 2 с идентификатором данных 0x02. Поставщик подтверждает, что:

  • Предоставленный одноразовый ключ аутентификации совпадает с ключом аккаунта-владельца.
  • Если был предоставлен хеш временного ключа идентификации, то хешированный временный ключ идентификации совпадает с текущим временным ключом идентификации.
  • Если хеш временного ключа идентификации не был предоставлен, убедитесь, что поставщик не был подготовлен как маячок FHN.

Если проверка не пройдена, поставщик возвращает ошибку аутентификации.

В случае успеха временный ключ идентификации восстанавливается путем расшифровки AES-ECB-128 с использованием соответствующего ключа аккаунта. Ключ должен храниться на устройстве, и с этого момента Поставщик должен начать передавать кадры FHN. Новый временный ключ идентификации начинает действовать сразу после завершения подключения BLE. Поставщик отправляет уведомление с ответом из таблицы 6 с идентификатором данных 0x02.

Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || 0x01).

Очистить временный ключ идентификации

Чтобы отменить инициализацию маячка Поставщика, Искатель выполняет операцию записи в характеристику, состоящую из запроса из таблицы 2 с идентификатором данных 0x03. Поставщик подтверждает, что:

  • Предоставленный одноразовый ключ аутентификации совпадает с ключом аккаунта-владельца.
  • Хешированный временный ключ идентификации совпадает с текущим временным ключом идентификации.

Если Поставщик не инициализирован как маячок FHN или проверка не удалась, возвращается ошибка аутентификации.

В случае успеха Поставщик удаляет ключ и прекращает трансляцию фреймов FHN. Поставщик отправляет уведомление с ответом из таблицы 6 с идентификатором данных 0x03. Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || 0x01).

Чтение временного ключа идентификации с согласия пользователя

Этот вариант доступен только для восстановления утерянного ключа, поскольку ключ хранится только локально на устройстве Искателя. Поэтому эта возможность доступна, только когда устройство находится в режиме подключения или в течение ограниченного времени после нажатия физической кнопки на устройстве (что означает согласие пользователя).

Искатель должен хранить запасной ключ на сервере, чтобы иметь возможность восстановить ключ в виде открытого текста, но не хранит сам EIK.

Чтобы прочитать EIK, Искатель выполняет операцию записи в характеристику, состоящую из запроса из таблицы 3 с идентификатором данных 0x04. Поставщик подтверждает, что:

  • Хешированный запасной ключ совпадает с ожидаемым.
  • Устройство находится в режиме восстановления EIK.

Если проверка не пройдена, поставщик возвращает ошибку аутентификации.

Если устройство не находится в режиме подключения, поставщик возвращает ошибку No User Consent (Нет согласия пользователя).

В случае успеха поставщик отправляет уведомление с ответом из таблицы 6 с идентификатором данных 0x04.

Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(recovery key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data || 0x01).

Операция с кольцом

Искатель может попросить Поставщика воспроизвести звук, выполнив операцию записи в характеристику, состоящую из запроса из таблицы 4 с идентификатором данных 0x05. Поставщик создает сегмент данных следующим образом:

Октет Тип данных Описание Значение
0 uint8 Операция с кольцом Битовая маска со следующими значениями:
  • Бит 1 (0x01): звонок справа
  • Бит 2 (0x02): звонок слева
  • Бит 3 (0x04): звонок на чехол
  • 0xFF: звонить на все компоненты.
  • 0x00: остановить звонок
1–2 uint16 Время ожидания Время ожидания в децисекундах. Значение не должно быть равно нулю и не должно превышать 10 минут.
Поставщик использует это значение, чтобы определить, как долго должен звучать сигнал, прежде чем он будет отключен. Если какой-либо компонент устройства уже звонит, время ожидания переопределяет уже действующее.

Если для параметра ring operation задано значение 0x00, время ожидания игнорируется.
3 uint8 Громкость
  • 0x00: по умолчанию
  • 0x01: низкий;
  • 0x02: средний;
  • 0x03: высокий
Точное значение этих величин зависит от реализации.

Получив запрос, Поставщик проверяет следующее:

  • Предоставленный одноразовый ключ аутентификации совпадает с ключом кольца.
  • Запрошенное состояние соответствует компонентам, которые могут звонить.

Если Поставщик не инициализирован как маячок FHN или проверка не удалась, возвращается ошибка аутентификации. Однако если у поставщика включена защита от слежения от нежелательного отслеживания, а в запросе на ее активацию был установлен флаг пропуска аутентификации звонка, поставщик должен пропустить эту проверку. Данные аутентификации по-прежнему должны предоставляться Искателем, но им может быть присвоено произвольное значение.

Когда звонок начинается или заканчивается, отправляется уведомление, как указано в таблице 6, с идентификатором данных 0x05. Содержание уведомления:

Октет Тип данных Описание Значение
0 uint8 Состояние вызова
  • 0x00: начато
  • 0x01: не удалось запустить или остановить (все запрошенные компоненты находятся вне диапазона)
  • 0x02: остановлено (истекло время ожидания)
  • 0x03: остановлено (нажатие кнопки)
  • 0x04: остановлено (запрос GATT)
1 uint8 Компоненты звонка Битовая маска компонентов, которые активно звонят, как определено в запросе.
2–3 uint16 Время ожидания Оставшееся время звонка в децисекундах. Если устройство перестало звонить, должно быть возвращено значение 0x0000.

Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(ring key, protocol major version number || the nonce used to initiate the ringing command || data ID || data length || additional data || 0x01).

Если устройство уже находится в запрошенном состоянии звонка, когда получен запрос на звонок или его прекращение, поставщик должен отправить уведомление с состоянием звонка или 0x00: Started или 0x04: Stopped (запрос GATT) соответственно. Этот запрос переопределяет параметры существующего состояния, чтобы можно было продлить продолжительность звонка.

Если у Поставщика есть физическая кнопка (или включено сенсорное управление), нажатие на нее должно отключать звонок.

Как узнать, звонит ли маячок

Чтобы получить состояние звонка маячка, Искатель выполняет операцию записи в характеристику, состоящую из запроса из таблицы 4 с идентификатором данных 0x06. Поставщик проверяет, совпадает ли предоставленный одноразовый ключ аутентификации с ключом кольца.

Если поставщик не инициализирован как маячок FHN или проверка не пройдена, поставщик возвращает ошибку аутентификации.

В случае успеха поставщик отправляет уведомление с ответом из таблицы 6 с идентификатором данных 0x06. Поставщик создает сегмент данных следующим образом:

Октет Тип данных Описание Значение
0 uint8 Компоненты звонка Компоненты, которые активно звонят, как определено в запросе на звонок.
1–2 uint16 Время ожидания Оставшееся время звонка в децисекундах. Если устройство не звонит, должно возвращаться значение 0x0000.

Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256 (ring key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data || 0x01).

Режим защиты от слежения

Режим защиты от нежелательного отслеживания позволяет любому клиенту идентифицировать устройства, используемые для злоупотреблений, без связи с сервером. По умолчанию Поставщик должен менять все идентификаторы, как описано в разделе Смена идентификаторов. Сервис "Портал поиска" может передавать запрос на активацию режима защиты от нежелательного слежения через сеть Портала поиска. В результате поставщик временно использует фиксированный MAC-адрес, что позволяет клиентам обнаруживать устройство и предупреждать пользователя о возможном нежелательном отслеживании.

Чтобы включить или отключить режим защиты от нежелательного отслеживания, Искатель выполняет операцию записи в характеристику, состоящую из запроса из таблицы 5 с идентификатором данных 0x07 или 0x08 соответственно.

При включении режима защиты от слежения

Поставщик создает сегмент данных следующим образом:

Октет Тип данных Описание Значение
0 uint8 Флаги управления
  • 0x01: пропустить аутентификацию звонка. Если правило настроено, запросы на звонок не проходят аутентификацию в режиме защиты от слежения.
Если флаг не установлен (байт состоит из одних нулей), можно полностью опустить раздел данных и отправить пустой раздел.
Параметры действуют, только пока не отключен режим защиты от слежения.

Поставщик проверяет, совпадает ли предоставленный одноразовый ключ аутентификации с ключом защиты от слежения. Если поставщик не инициализирован как маячок FHN или проверка не пройдена, возвращается ошибка аутентификации.

Когда активирован режим защиты от слежения, маячок должен снизить частоту ротации частного MAC-адреса до одного раза в 24 часа. Рекламируемый временный идентификатор должен продолжать меняться, как обычно. Тип фрейма должен быть задан как 0x41. Состояние также отражено в разделе Хешированные флаги.

При отключении режима защиты от слежения

Поставщик подтверждает, что:

  • Предоставленный одноразовый ключ аутентификации совпадает с ключом защиты от нежелательного отслеживания.
  • Хешированный временный ключ идентификации совпадает с текущим временным ключом идентификации.

Если поставщик не инициализирован как маячок FHN или проверка не пройдена, поставщик возвращает ошибку аутентификации.

Когда режим защиты от нежелательного отслеживания отключен, маячок должен снова начать менять MAC-адрес с обычной частотой, синхронизированной с изменением эфемерного идентификатора. Тип фрейма должен быть установлен обратно на 0x40. Статус также отражен в разделе hashed flags.

В случае успеха Поставщик отправляет ответ из таблицы 6 с идентификатором данных 0x07 или 0x08.

Сегмент аутентификации определяется как первые 8 байт HMAC-SHA256(unwanted tracking protection key, protocol major version number || the last nonce read from the characteristic || data ID || data length || 0x01).

Точный поиск

В этом разделе подробно описаны процессы и дополнительные операции, необходимые для точного поиска. Здесь действуют те же правила для характеристики GATT и аутентификации, что и в разделе спецификации GATT. Точный поиск – необязательная функция.

Тип точного поиска зависит от технологий определения расстояния, которые поддерживаются на устройствах, участвующих в поиске. Поддерживаемые технологии определения расстояния можно найти в спецификации Определение расстояния: последовательность и полезная нагрузка внеполосных сообщений. В следующих разделах рассказывается, как работает точный поиск в зависимости от используемой технологии определения расстояния.

Процесс точного поиска

В этом разделе рассматривается обмен сообщениями FHNA для точного поиска. На рисунке 1 показан поток сообщений, а в абзацах ниже подробно описано каждое сообщение.

Последовательность сообщений при точном поиске Рис. 1. Типичный обмен сообщениями при точном поиске

Устройство-инициатор – это устройство, на котором установлено приложение "Портал поиска" и на котором была запущена функция точного поиска. Инициатор – это устройство, которое пытается найти другое устройство.

Устройство-ответчик – это устройство, которое пытается найти устройство-инициатор.

Инициатор отправляет ответчику запрос на определение расстояния, в котором перечисляет технологии, которые он хочет использовать. Устройство-ответчик отправит ответное уведомление Ranging Capability Response, содержащее информацию о том, какие технологии определения расстояния поддерживаются и каковы их возможности. Ответчик предоставит только ту информацию, которую запросил инициатор. Список возможностей будет отсортирован по приоритету технологии определения расстояния, которую предпочитает устройство-ответчик. Первой в списке будет указана технология с наивысшим приоритетом.

Затем устройство-инициатор отправит сообщение о конфигурации дальнометрии, в котором определит конфигурацию для каждой технологии дальнометрии, которую оно хочет использовать. Получив это сообщение, устройство-ответчик должно начать измерение расстояния с помощью подходящих технологий, используя предоставленные конфигурации. Устройство-ответчик отправит уведомление с ответом о конфигурации дальнометрии, в котором будет указано, успешно ли запущена каждая отдельная технология дальнометрии. Для успешного сеанса дальнометрии некоторые технологии требуют запуска на обоих устройствах, а другие – только на инициаторе. Однако в последнем случае ответчик должен отправить ответ об успешном выполнении. Подробную информацию о поведении конкретных технологий определения расстояния можно найти в следующих разделах.

Когда устройство-инициатор будет готово остановить сеанс точного поиска, оно отправит устройству-ответчику сообщение об остановке дальнометрии, в котором будет указано, какие технологии дальнометрии должны прекратить работу. Устройство-ответчик отправит уведомление Stop Ranging Response, которое означает, что измерение расстояния с помощью запрошенных технологий успешно остановлено.

Если канал связи FHNA BLE GATT отключится во время сеанса точного поиска, но некоторые технологии определения расстояния продолжат работать, на отвечающем устройстве будет запущен механизм тайм-аута, чтобы оно не определяло расстояние бесконечно. Подробности зависят от конкретного случая.

Обратите внимание, что порядок операций на отвечающем устройстве может меняться. Например, устройство-ответчик должно быть способно обрабатывать несколько запросов на определение расстояния подряд или даже прямую операцию настройки определения расстояния без предшествующего запроса.

Операции точного поиска

В таблице 8 показаны операции FHNA, определенные в этом документе и необходимые для точного поиска. В каждом подразделе описывается сообщение FHNA для каждой из операций, а содержимое поля Дополнительные данные относится к спецификации Определение расстояния: последовательность внеполосных сообщений и полезная нагрузка.

Операция Идентификатор данных Описание
Запрос на определение расстояния 0x0A Операция запроса возможностей, которая будет отправлена устройством-инициатором устройству-ответчику. В данных этой операции будут перечислены все технологии определения расстояния, о которых инициатор хочет узнать от устройства-ответчика.
Ответ о возможностях дальнометрии 0x0A Это ответ на запрос возможностей определения расстояния. Она содержит информацию о возможностях каждой поддерживаемой технологии определения расстояния, запрошенной инициатором.
Конфигурация определения расстояния 0x0B Операция Ranging Configuration содержит конфигурации для технологий определения расстояния, которые устройство-инициатор хочет использовать для определения расстояния до устройства-ответчика.
Ответ на запрос конфигурации измерения расстояния 0x0B Это ответ на операцию настройки дальномера. Он содержит данные о том, удалось ли устройству-ответчику начать измерение расстояния с помощью запрошенных технологий на основе предоставленной конфигурации.
RFU 0x0C Операция с этим идентификатором данных не используется и зарезервирована для использования в будущем.
Остановить измерение расстояния 0x0D Операция Stop Ranging, отправленная устройством-инициатором, содержит информацию о том, какие технологии определения расстояния устройство-ответчик должно прекратить использовать.
Остановить ответ на определение расстояния 0x0D Это ответ на операцию "Остановить определение расстояния". Содержит данные о том, была ли остановка определенной технологии измерения расстояния успешной.

Таблица 8. Операции точного поиска.

Операция запроса возможностей определения расстояния

В таблице 9 описано сообщение Ranging Capability Request.

Октет Тип данных Описание Значение
0 uint8 Идентификатор данных 0x0A – запрос на определение расстояния.
1 uint8 Размер сообщения изменяется
2 массив байтов Одноразовый ключ аутентификации Первые 8 байт HMAC-SHA256(Account Key, номер основной версии протокола || the last nonce read from the characteristic || Data ID || Data length || Additional Data).
10 массив байтов Дополнительные данные Сообщение Ranging Capability Request, как определено в спецификации Ranging: Out-of-band message sequence and payload (заголовок и полезная нагрузка).

Таблица 9. Запрос на определение расстояния.

Операция ответа на запрос о возможностях измерения расстояния

В таблице 10 описано сообщение Ranging Capability Response.

Октет Тип данных Описание Значение
0 uint8 Идентификатор данных 0x0A: ответ о возможности дальнометрии
1 uint8 Размер сообщения изменяется
2 массив байтов Одноразовый ключ аутентификации Первые 8 байт HMAC-SHA256(Account Key, номер основной версии протокола || the last nonce read from the characteristic || Data ID || Data length || Additional Data || 0x01).
10 массив байтов Дополнительные данные Сообщение Ranging Capability Response, как определено в спецификации Ranging: Out-of-band message sequence and payload (заголовок и полезная нагрузка).

Таблица 10. Ответ о возможностях определения расстояния.

Операция настройки дальномера

В таблице 11 описано сообщение о конфигурации измерения расстояния.

Октет Тип данных Описание Значение
0 uint8 Идентификатор данных 0x0B – задать конфигурацию определения расстояния
1 uint8 Размер сообщения изменяется
2 массив байтов Одноразовый ключ аутентификации Первые 8 байт HMAC-SHA256(Account Key, номер основной версии протокола || the last nonce read from the characteristic || Data ID || Data length || Additional Data).
10 массив байтов Дополнительные данные Сообщение Ranging Configuration, как определено в спецификации Ranging: Out-of-band message sequence and payload (заголовок и полезная нагрузка).

Таблица 11. Конфигурация определения расстояния.

Операция Ranging Configuration Response

В таблице 12 описано сообщение Ranging Configuration Response.

Октет Тип данных Описание Значение
0 uint8 Идентификатор данных 0x0B – ответ на запрос о настройке дальнометрии
1 uint8 Размер сообщения изменяется
2 массив байтов Одноразовый ключ аутентификации Первые 8 байт HMAC-SHA256(Account Key, номер основной версии протокола || the last nonce read from the characteristic || Data ID || Data length || Additional Data || 0x01).
10 массив байтов Дополнительные данные Сообщение Ranging Configuration Response, как определено в спецификации Ranging: Out-of-band message sequence and payload (заголовок и полезная нагрузка).

Таблица 12. Ответ на запрос конфигурации дальномера.

Остановить операцию определения расстояния

В таблице 13 описано сообщение Stop Ranging.

Октет Тип данных Описание Значение
0 uint8 Идентификатор данных 0x0D – остановка измерения расстояния.
1 uint8 Размер сообщения изменяется
2 массив байтов Одноразовый ключ аутентификации Первые 8 байт HMAC-SHA256(ключ аккаунта, номер основной версии протокола || последний одноразовый код, считанный из характеристики || идентификатор данных || длина данных).
10 массив байтов Дополнительные данные Сообщение Stop Ranging, как определено в спецификации Ranging: Out-of-band message sequence and payload (заголовок и полезная нагрузка).

Таблица 13. Остановка измерения расстояния.

Остановить операцию ответа на запрос диапазона

В таблице 14 описано сообщение Stop Ranging Response.

Октет Тип данных Описание Значение
0 uint8 Идентификатор данных 0x0D – ответ на остановку измерения расстояния.
1 uint8 Размер сообщения изменяется
2 массив байтов Одноразовый ключ аутентификации Первые 8 байт HMAC-SHA256(Account Key, номер основной версии протокола || the last nonce read from the characteristic || Data ID || Data length || Additional Data || 0x01).
10 массив байтов Дополнительные данные Сообщение Stop Ranging Response, как определено в спецификации Ranging: Out-of-band message sequence and payload (заголовок и полезная нагрузка).

Таблица 14. Ответ на запрос об остановке измерения расстояния.

Защита от нежелательного отслеживания с помощью точного поиска

Когда активирован режим защиты от слежения от нежелательного отслеживания, как описано в разделе "Защита от слежения от нежелательного отслеживания", тот же процесс, который применяется для пропуска проверок аутентификации для сообщений о звонках, также применяется для всех сообщений точного поиска, определенных в этом документе для устройств, которые поддерживают эту функцию.

Особенности технологии определения расстояния для точного поиска

В этом разделе содержатся сведения, относящиеся к технологии определения расстояния.

Особенности сверхширокополосной связи (СШП)

Сведения о СШП.

Уровень точности поиска

При точном поиске с использованием СШП вы увидите расстояние до устройства и направление к нему. Интервал измерения расстояния должен быть не менее 240 мс, а для оптимальной работы – 96 мс.

Идентификаторы конфигурации

Данные конфигурации, передаваемые по внешнему каналу для СШП, не содержат полного набора доступных настраиваемых параметров, необходимых для запуска сеанса измерения расстояния. Некоторые параметры неявно выбираются по идентификатору конфигурации.

Каждый идентификатор конфигурации – это набор предопределенных параметров конфигурации СШП, которые описаны в общедоступной документации. Для точного поиска устройство-ответчик должно поддерживать идентификатор конфигурации 6 и, при необходимости, идентификатор конфигурации 3.

Инициатор и ответчик СШП

В случае с точным поиском устройство, указанное в этом документе как инициатор, будет ответчиком СШП, а устройство, указанное как ответчик, – инициатором СШП. Это связано с тем, что инициатор СШП потребляет меньше энергии, чем ответчик, а ответчик в большинстве случаев является периферийным устройством с ограниченным зарядом батареи.

Это означает, что в сообщении Ranging Capability Response устройство-ответчик должно указать, что оно поддерживает роль инициатора СШП.

  • Должен поддерживаться канал 9.
  • Для оптимального ведения рекомендуется интервал измерения расстояния 96 мс, в противном случае должна поддерживаться задержка 240 мс.
  • Для экономии заряда батареи рекомендуется использовать интервал в 1 мс, но также поддерживается интервал в 2 мс.
  • Чип СШП должен соответствовать стандарту FIRA v1.2 + P-STS.
  • BPRF является обязательным, а HPRF – рекомендуемым, но необязательным. Поддерживаемый или выбранный режим определяется поддерживаемым или выбранным индексом преамбулы.
  • Тип безопасности сеанса: P-STS.
  • Необходимо включить скачкообразную перестройку частоты.
Особенности BLE Channel Sounding (CS)

Сведения о BLE CS.

Уровень точности поиска

При точном поиске с использованием технологии CS будет определяться только расстояние, а направление – нет.

Требуется связь между устройствами

Сеансы точного поиска с использованием Channel Sounding не будут работать, если устройства не связаны. Между инициатором и ответчиком должна быть установлена связь. Эта спецификация не предусматривает способа создания связи между устройствами. Разработчик должен сам установить связь между устройствами.

Требования для отдельных стран

Для определения расстояния в Портале поиска оба устройства должны поддерживать следующую конфигурацию CS:

Параметр Требования
T_FCS <= 80 мкс
T_IP1/T_IP2 <= 40 мкс
T_PM <= 10 мкс
T_SW <= 2 мкс
Num_Config_Supported >= 2
Max_Antenna_Paths_Supported >= 2
FAE = 0 Поддерживается
CS_SYNC_Antenna_Selection (если антенн больше одной) Идентификатор антенны + 0xFD + 0xFE
Max_TX_Power >= 8 дБм
ADV_TX_Power Такая же, как мощность передачи для LE ACL
Data_Length_Extension (DLE – 251 байт) Поддерживается
PCT_Tone_Quality Поддерживается
Phase_Coherence_across_Subevents Поддерживается
RX_Power_Level_Consistency_across_Subevents (PCT Magnitude) Поддерживается

Таблица 15. Обязательные настройки для CS.

Требуются следующие элементы управления мощностью передачи:

  • Устройство должно поддерживать функцию управления мощностью передачи BT 5.2 на канале LE ACL.
  • Мощность передачи должна оставаться неизменной в рамках одной процедуры CS, даже если есть несколько дополнительных событий.
  • При переходе от одной процедуры CS к другой мощность передачи должна соответствовать базовой мощности передачи LE ACL.

Все аппаратное обеспечение должно пройти калибровку, чтобы исключить систематическое смещение или ошибку из-за радиочастотных схем или маршрутизации.

Требуется действие со стороны отвечающего (CS)

В отличие от СШП, где оба устройства должны явно вызывать API для начала и окончания измерения расстояния, при использовании CS только инициатор должен запустить измерение расстояния, вызвав стек Bluetooth. Остальная часть инициализации на стороне ответчика происходит внутриполосно с помощью Bluetooth. Это означает, что при получении сообщения о настройке дальнометрии или об остановке дальнометрии для CS отвечающей стороне не нужно ничего делать, если BT включен, кроме как ответить уведомлением о настройке дальнометрии. Устройство-ответчик может использовать эти сообщения как триггер для обновления интерфейса, если у него есть экран. В противном случае сообщения могут использоваться для визуальной обратной связи о состоянии устройства, например для мигания светодиодов.

RTT в сети Wi-Fi NAN

Сведения о Wi-Fi NAN RTT.

Уровень точности поиска

При использовании Wi-Fi NAN RTT в качестве технологии определения расстояния в сеансах точного поиска будут выполняться только измерения расстояния. Направление в настоящее время не указывается.

BLE RSSI

Сведения о BLE RSSI.

Уровень точности поиска

Сеансы точного поиска, в которых используется только BLE RSSI, не смогут получить информацию о расстоянии или направлении, поскольку BLE RSSI не является точной технологией определения расстояния. Вместо этого пользователь увидит подсказку, указывающую, что устройство находится близко или далеко.

Рекламируемые фреймы

После инициализации поставщик должен передавать фреймы FHN не реже одного раза в две секунды. Если передаются фреймы быстрого подключения, поставщик должен чередовать фреймы FHN с обычными объявлениями быстрого подключения. Например, каждые две секунды Поставщик должен передавать семь объявлений быстрого подключения и одно объявление FHN.

Мощность передачи Bluetooth для объявлений FHN должна быть не менее 0 дБм.

Фрейм FHN содержит открытый ключ, который используется для шифрования отчетов о местоположении любым поддерживающим клиентом, который вносит вклад в краудсорсинговую сеть. Доступны два типа ключей эллиптической кривой: 160-битный ключ, который подходит для устаревших фреймов BLE 4, и 256-битный ключ, для которого требуется BLE 5 с расширенными возможностями рекламы. Используемая кривая определяется реализацией поставщика.

Структура фрейма FHN выглядит следующим образом:

Октет Значение Описание
0 0x02 Длина
1 0x01 Значение типа данных Flags
2 0x06 Данные о флагах
3 0x18 или 0x19 Длина
4 0x16 Значение типа данных сервиса
5 0xAA 16-битный UUID сервиса
6 0xFE …
7 0x40 или 0x41 Тип фрейма FHN с индикацией режима защиты от слежения от нежелательного отслеживания
8..27 20-байтовый временный идентификатор;
28 Хешированные пометки

Таблица 16. Фрейм FHN, поддерживающий 160-битную кривую.

В таблице 17 показаны смещения байтов и значения для 256-битной кривой.

Октет Значение Описание
0 0x02 Длина
1 0x01 Значение типа данных Flags
2 0x06 Данные о флагах
3 0x24 или 0x25 Длина
4 0x16 Значение типа данных сервиса
5 0xAA 16-битный UUID сервиса
6 0xFE …
7 0x40 или 0x41 Тип фрейма FHN с индикацией режима защиты от слежения от нежелательного отслеживания
8..39 32-байтовый временный идентификатор;
40 Хешированные пометки

Таблица 17. Фрейм FHN, поддерживающий 256-битную кривую.

Вычисление временного идентификатора (EID)

Случайное число генерируется с помощью шифрования AES-ECB-256 следующей структуры данных с временным ключом идентификации:

Октет Поле Описание
0–10 Поля Значение = 0xFF
11 K Показатель степени периода ротации
12–15 TS[0]...TS[3] Счетчик времени маяка в 32-битном формате big-endian. Младшие биты K очищаются.
16–26 Поля Значение = 0x00
27 K Показатель степени периода ротации
28–31 TS[0]...TS[3] Счетчик времени маяка в 32-битном формате big-endian. Младшие биты K очищаются.

Таблица 18. Создание псевдослучайного числа.

Результатом этого вычисления является 256-битное число, обозначаемое как r'.

Для остальных вычислений используются SECP160R1 или SECP256R1. Определения кривых приведены в документе SEC 2: Recommended Elliptic Curve Domain Parameters, в котором определены параметры Fp, n и G, упомянутые ниже.

r' проецируется на конечное поле Fp путем вычисления r = r' mod n. Наконец, вычислите R = r * G – точку на кривой, представляющую используемый открытый ключ. Маяк передает Rx, то есть координату x точки R, в качестве временного идентификатора.

Хешированные флаги

Поле хешированных флагов рассчитывается следующим образом (биты указываются от наиболее значимого к наименее значимому):

  • Биты 0–4: зарезервированы (установлены на нули).
  • Биты 5–6 указывают на уровень заряда батареи устройства:
    • 00: индикация уровня заряда батареи не поддерживается
    • 01: нормальный уровень заряда батареи;
    • 10: низкий уровень заряда батареи;
    • 11 – критически низкий уровень заряда батареи (скоро потребуется замена батареи);
  • Бит 7 равен 1, если маячок находится в режиме защиты от слежения, и 0 в противном случае.

Чтобы получить окончательное значение этого байта, он подвергается операции XOR с наименее значимым байтом SHA256(r).

Обратите внимание, что r должно соответствовать размеру кривой. Если представление короче 160 или 256 бит, добавьте нули в качестве старших битов. Если представление длиннее 160 или 256 бит, усеките старшие биты.

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

Шифрование с помощью EID

Чтобы зашифровать сообщение m, наблюдатель (прочитав Rx с маяка) должен сделать следующее:

  1. Выберите случайное число s в Fp, как описано в разделе Вычисление EID.
  2. Вычисли S = s * G.
  3. Вычислите R = (Rx, Ry), подставив значения в уравнение кривой и выбрав произвольное значение Ry из возможных результатов.
  4. Вычислите 256-битный ключ AES k = HKDF-SHA256((s * R)x), где (s * R)x – координата x результата умножения кривой. Соль не указана.
  5. Пусть URx и LRx – верхние и нижние 80 бит Rx соответственно в формате big-endian. Аналогичным образом определите USx и LSx для S.
  6. Вычисли nonce = LRx || LSx.
  7. Вычисли (m’, tag) = AES-EAX-256-ENC(k, nonce, m).
  8. Отправьте (URx, Sx, m’, tag) владельцу, возможно, через ненадежный удаленный сервис.

Расшифровка значений, зашифрованных с помощью EID

Клиент владельца, у которого есть EIK и экспонента периода ротации, расшифровывает сообщение следующим образом:

  1. URxПолучить значение счетчика времени маяка, на котором основано значение URx. Для этого клиент владельца может вычислить значения Rx для значений счетчика времени маяка за недавнее прошлое и ближайшее будущее.
  2. Используя значение счетчика времени маячка, на котором основан URx, вычислите ожидаемое значение r, как описано в разделе Вычисление EID.
  3. Вычислите R = r * G и убедитесь, что оно совпадает со значением URx, предоставленным наблюдателем.
  4. Вычислите S = (Sx, Sy), подставив значения в уравнение кривой и выбрав произвольное значение Sy из возможных результатов.
  5. Вычислите k = HKDF-SHA256((r * S)x), где (r * S)x – координата x результата умножения кривой.
  6. Вычисли nonce = LRx || LSx.
  7. Вычисли m = AES-EAX-256-DEC(k, nonce, m’, tag).

Ротация идентификаторов

Для передачи фреймов FHN необходимо использовать разрешаемый (RPA) или неразрешаемый (NRPA) BLE-адрес. RPA требуется для устройств LE Audio (LEA) и рекомендуется для других устройств, за исключением тегов локатора, которые не используют связывание.

Объявление быстрого подключения, объявление сети "Найти устройство" и соответствующие адреса BLE должны меняться одновременно. В среднем ротация должна происходить каждые 1024 секунды. Точный момент, когда маячок начинает передавать новый идентификатор, должен выбираться случайным образом в пределах этого окна.

Рекомендуемый подход к рандомизации времени ротации заключается в том, чтобы установить его на следующее ожидаемое время ротации (если рандомизация не применялась) плюс положительный рандомизированный временной коэффициент в диапазоне от 1 до 204 секунд.

Когда устройство находится в режиме защиты от слежения от нежелательного отслеживания, BLE-адрес объявления FHN должен быть фиксированным, а RPA для необнаруживаемого объявления FP (например, Быстрого подключения) должен постоянно меняться. Для разных протоколов можно использовать разные адреса.

Восстановление после отключения питания

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

Поставщики должны стремиться минимизировать расхождения, поскольку время на их устранение ограничено. Необходимо реализовать хотя бы один дополнительный метод синхронизации часов (объявление [необнаруживаемых фреймов Быстрого подключения](

locator-tag) или потока сообщений.

Рекомендации по реализации быстрого подключения

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

Рекомендации по использованию брелоков-трекеров

  • Если поставщик был подключен, но FHN не был инициализирован в течение 5 минут (или если беспроводное обновление было применено, когда устройство подключено, но FHN не инициализирован), поставщик должен вернуться к заводской конфигурации и очистить сохраненные ключи аккаунта.
  • После подключения поставщик не должен менять MAC-адрес, пока не будет настроена сеть FHN или не пройдет пять минут.
  • Если временный ключ идентификации удален с устройства, на нем должен быть выполнен сброс настроек, а также удалены сохраненные ключи аккаунта.
  • Поставщик должен отклонять обычные попытки подключения по Bluetooth и принимать только запросы на быстрое подключение.
  • Поставщик должен предусмотреть механизм, позволяющий пользователям временно отключать рекламу без сброса настроек устройства (например, нажатием комбинации кнопок).
  • После отключения питания устройство должно передавать фреймы быстрого подключения, невидимые для других устройств, до следующего вызова параметров чтения маячка. Это позволяет Искателю обнаружить устройство и синхронизировать часы, даже если произошел значительный сдвиг часов.
  • При рекламе невидимых фреймов быстрого подключения индикаторы пользовательского интерфейса должны быть отключены.
  • Видимые фреймы быстрого подключения не должны рекламироваться, пока поставщик настроен для FHN.
  • Поставщик не должен раскрывать идентифицирующую информацию (например, имена или идентификаторы) без аутентификации.

Рекомендации для устройств Bluetooth Classic

В этом разделе описываются особенности классических устройств Bluetooth, поддерживающих FHN.

Инициализация FHN для уже подключенных устройств

Поставщик не всегда инициализируется для FHN при подключении к Искателю, но через некоторое время после этого. В этом случае у Поставщика может не быть актуального MAC-адреса BLE, необходимого для установки подключения GATT. Поставщик должен поддерживать хотя бы один из следующих способов получения Искателем его BLE-адреса, когда он уже подключен:

  • Поставщик может периодически передавать данные аккаунта для быстрого подключения, которые позволяют Искателю найти его BLE-адрес с помощью BLE-сканирования.
    Этот подход подходит для поставщиков, которые не реализуют поток сообщений.
  • Поставщик может передавать эти данные через поток сообщений быстрого подключения по классическому Bluetooth.
    Этот подход подходит для поставщиков, которые не объявляют фреймы быстрого подключения при подключении к искателю через Bluetooth.

Поддержка обоих подходов повышает вероятность того, что пользователь сможет подготовить устройство к работе с сетью "Найти устройство".

Поток сообщений быстрого подключения

Поставщик может реализовать поток сообщений быстрого подключения и использовать его, чтобы уведомлять Искателя об информации об устройстве. Реализация потока сообщений позволяет использовать определенные функции, описанные в этом разделе.

Поставщик должен отправлять сообщения с информацией об устройстве один раз при каждом установлении потока сообщений.

Версия встроенного ПО (код информации об устройстве 0x09) и возможность отслеживания

Когда обновление встроенного ПО добавляет поддержку FHN на Поставщике, подключенный Искатель может уведомить об этом пользователя и предложить инициализировать Поставщика. В противном случае пользователю придется вручную перейти к списку устройств Bluetooth, чтобы начать настройку FHN.

Для этого Поставщик должен использовать свойство версии встроенного ПО (код 0x09), чтобы передать строковое значение, представляющее версию встроенного ПО. Кроме того, Поставщик должен поддерживать протокол, который позволяет Искателю узнавать об изменениях в возможностях, связанных с обновлением встроенного ПО.

Октет Тип данных Описание Значение
0 uint8 Событие с информацией об устройстве 0x03
1 uint8 Версия встроенного ПО 0x09
2–3 uint16 Размер дополнительных данных varies
var массив байтов Строка с версией varies

Таблица 19. Событие "Информация об устройстве": обновлена версия встроенного ПО.

Если поставщик включил поддержку отслеживания FHN, то, получив запрос на обновление возможностей (0x0601), он должен ответить, как показано в таблице 20.

Октет Тип данных Описание Значение
0 uint8 Событие синхронизации возможностей устройства 0x06
1 uint8 Отслеживание в сети "Найти устройство" 0x03
2–3 uint16 Размер дополнительных данных 0x0007
4 uint8 Статус инициализации FHN 0x00, если не инициализировано; 0x01, если инициализировано любым аккаунтом
5–10 массив байтов Текущий MAC-адрес BLE устройства. varies

Таблица 20. Событие синхронизации возможностей устройства: добавлена возможность отслеживания.

Текущий временный идентификатор (код информации об устройстве 0x0B)

Поставщик может использовать текущий временный идентификатор (код 0x0B), чтобы сообщить текущий EID и значение часов, когда Поставщик инициализируется для FHN, чтобы синхронизировать Искатель в случае дрейфа часов (например, из-за разряженной батареи). В противном случае Искатель инициирует более дорогое и менее надежное подключение.

Октет Тип данных Описание Значение
0 uint8 Событие с информацией об устройстве 0x03
1 uint8 Текущий временный идентификатор 0x0B
2–3 uint16 Размер дополнительных данных 0x0018 или 0x0024
4—7 массив байтов Значение часов Пример: 0x13F9EA80.
8–19 или 31 массив байтов Текущий EID Пример: 0x1122334455667788990011223344556677889900

Таблица 21. Событие "Информация об устройстве": синхронизация часов

Сбросить настройки

Если устройство поддерживает сброс настроек, то после его выполнения Поставщик должен прекратить передачу маячков и удалить временный ключ идентификации и все сохраненные ключи аккаунтов, включая ключ аккаунта владельца.

После сброса настроек (вручную или программно) Поставщик не должен сразу начинать объявлять о Быстром подключении, чтобы процесс подключения не запускался сразу после того, как пользователь удалит устройство.

Защита от нежелательного отслеживания

Сертифицированные устройства FHN также должны соответствовать требованиям, указанным в версии реализации кросс-платформенной спецификации для обнаружения нежелательных трекеров геолокации (DULT).

Рекомендации по обеспечению соответствия сети "Найти устройство" спецификации DULT:

  • Любое устройство, совместимое с сетью поиска устройств, должно быть зарегистрировано в Nearby Device Console, а функция Find Hub должна быть активирована.
  • Устройство должно реализовывать сервис Accessory Non-Owner и характеристику, определенную в версии спецификации DULT, включая операции Accessory Information и Non-owner controls.
  • В течение периода обратной совместимости, как определено в спецификации DULT, в рекламном фрейме, как определено в этом документе, изменений нет.
  • Режим защиты от слежения от нежелательного отслеживания, описанный в этом документе, соответствует состоянию "separated" (отделено) в спецификации DULT.
  • Рекомендации по реализации кодов операций Accessory Information:
    • Get_Product_Data должна возвращать идентификатор модели, предоставленный консолью, дополненный нулями до 8 байт. Например, идентификатор модели 0xFFFFFF возвращается как 0x0000000000FFFFFF.
    • Значения Get_Manufacturer_Name и Get_Model_Name должны совпадать с указанными в консоли.
    • Get_Accessory_Category может возвращать общее значение "Трекер местоположения", если другие категории не подходят для типа устройства.
    • Get_Accessory_Capabilities должен указывать на поддержку звонка, а также на поиск идентификатора BLE.
    • Get_Network_ID должен возвращать идентификатор Google (0x02).
  • Рекомендации по реализации кода операции Get_Identifier:
    • Операция должна возвращать действительный ответ только в течение пяти минут после того, как пользователь активировал режим идентификации, нажав определенную комбинацию кнопок. Визуальный или звуковой сигнал должен указывать пользователю, что поставщик вошел в этот режим. Инструкции по активации этого режима для конкретной модели должны быть предоставлены Google в качестве требования для сертификации и не менее чем за 10 дней до любого обновления или изменения инструкций.
    • Ответ состоит из первых 10 байтов текущего временного идентификатора и первых 8 байтов HMAC-SHA256(recovery key, the truncated current ephemeral identifier).
  • Рекомендации по реализации идентификатора через NFC:
    • В качестве URL укажите find-my.googleapis.com/lookup.
    • В качестве параметра e используйте тот же ответ, что и для Get_Identifier, в шестнадцатеричной кодировке.
    • В качестве параметра pid используйте тот же ответ, что и для Get_Product_Data, в шестнадцатеричной кодировке.
  • Устройство должно быть оснащено динамиком и поддерживать функцию звонка. Согласно спецификации DULT, динамик должен издавать звук с пиковой громкостью не менее 60 фон, как определено в ISO 532-1:2017.
  • Рекомендации по реализации кода операции Sound_Start:
    • Команда должна запустить звонок на всех доступных компонентах.
    • Используйте максимально поддерживаемую громкость.
    • Рекомендуемая продолжительность звонка – 12 секунд.
  • В тегах локатора должен быть предусмотрен механизм, позволяющий пользователям временно останавливать рекламу без сброса настроек устройства (например, нажатие комбинации кнопок).
    • Инструкции по отключению должны быть опубликованы в интернете. Ссылку на них необходимо предоставить Google для сертификации и не позднее чем за 10 дней до любого обновления или изменения инструкций.
    • URL должен поддерживать локализацию. В зависимости от клиента язык будет указан либо в параметре запроса ("hl=en"), либо в HTTP-заголовке accept-language.

Рекомендации по использованию переключаемых протоколов

  • Одновременно можно использовать только один протокол. Убедитесь, что на устройстве одновременно может работать не более одной сети. Это требование необходимо для того, чтобы конфиденциальные пользовательские данные не смешивались при использовании разных протоколов.
  • Рекомендуется добавить в устройство функцию жесткой перезагрузки, которая позволит пользователю заново настроить устройство в другой сети.
  • Процесс обновления устройства для работы в сети должен быть удобным для пользователя и одинаковым для всех сетей. Пользователь должен иметь возможность выбрать сеть, не отдавая предпочтения одной из них. Этот процесс должен быть одобрен командой Google.

Обновления встроенного ПО

Процесс и распространение беспроводных обновлений должны управляться партнером с помощью собственного рабочего процесса мобильного или веб-приложения.

Функция быстрого подключения поддерживает отправку пользователю уведомлений о доступных беспроводных обновлениях. Чтобы использовать этот механизм:

Чтобы предотвратить отслеживание, доступ к характеристике Версия встроенного ПО должен быть ограничен. Искатель сначала считывает состояние инициализации и предоставляет ключ аутентификации, как определено в этой спецификации, и только после этого считывает версию встроенного ПО. Это будет сделано через то же подключение. Если попытка прочитать версию встроенного ПО была предпринята, но поставщик не связан или аутентифицированная операция не была успешно завершена через то же подключение, поставщик должен вернуть ошибку аутентификации.

Совместимость

Для работы сети Портала поиска требуется включить сервисы геолокации и Bluetooth. Необходимо подключение к интернету и сотовой сети. Доступно в некоторых странах на устройствах с Android 9 и более поздних версий для пользователей, достигших необходимого возраста.

Журнал изменений

Версия FHN Дата Комментарий
v1 Первый выпуск спецификации FHN для раннего доступа.
Версия 1.1 Feb 2023
  • Добавлено текстовое обозначение режима защиты от нежелательного отслеживания.
  • Добавлена возможность пропускать аутентификацию запросов на звонок в режиме защиты от нежелательного слежения.
Версия 1.2 Апрель 2023 г.
  • Обновлено определение ключа аттестации владельца.
  • Добавлена рекомендация по восстановлению после потери питания в тегах локатора.
  • Добавлено пояснение о рандомизации MAC-адресов.
  • Добавлено пояснение о ротации MAC-адресов в режиме защиты от нежелательного отслеживания.
  • Добавлена рекомендация о том, как деактивировать тег локатора.
v1.3 Декабрь 2023 г.
  • Добавлено пояснение об идентифицирующей информации, которая раскрывается тегами локатора.
  • Добавлено требование реализовать спецификацию по предотвращению нежелательного отслеживания.
  • Добавлены рекомендации для устройств с переключаемыми протоколами.