Интерфейс контроллера NFC (NCI) используется для взаимодействия с контроллером NFC (NFCC). На этой странице описываются спецификации фирменных команд Android NCI.
Определения НЦИ
Фирменные команды NCI Android используют фирменный идентификатор группы (GID) 0xF и кодовое пространство идентификатора кода операции Android (OID) 0xC .
Общий формат пакета
Формат пакета Android NCI соответствует спецификации NCI для пакетов управления с использованием фирменных Group_ID 0xF и Opcode_ID 0x0C . Для каждого фирменного сообщения Android первый байт полезной нагрузки пакета должен быть установлен на код операции Android ( 0x0C ). Пакеты управления Android используют Message_Type и PBF для идентификации команд, ответов и уведомлений аналогично стандартным командам.
Формат пакета Android показан в следующей таблице:
| 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
Message_Type | PBF | Group_ID = 0xF (PROPRIETARY) | |||||
| зарезервировано для будущего использования (RFU) | Opcode_ID = 0x0C (ANDROID) | ||||||
Payload_Length | |||||||
Android_Opcode_ID | |||||||
Android_Payload | |||||||
Назначенные идентификаторы опкодов Android перечислены в следующей таблице. Спецификация для каждого пакета приведена в следующих разделах.
| Android-идентификатор OID | Тип сообщения | Имя сообщения |
|---|---|---|
| 0x00 | NCI_MT_CMD | NCI_ANDROID_GET_CAPS_CMD |
| NCI_MT_RSP | NCI_ANDROID_GET_CAPS_RSP | |
| 0x01 | NCI_MT_CMD | NCI_ANDROID_POWER_SAVING_CMD |
| NCI_MT_RSP | NCI_ANDROID_POWER_SAVING_RSP | |
| 0x02 | NCI_MT_CMD | NCI_ANDROID_PASSIVE_OBSERVE_MODE_CMD |
| NCI_MT_RSP | NCI_ANDROID_PASSIVE_OBSERVE_MODE_RSP | |
| 0x03 | NCI_MT_NTF | NCI_ANDROID_POLLING_FRAME_NTF |
| 0x04 | NCI_MT_CMD | NCI_ANDROID_QUERY_PASSIVE_OBSERVER_STATUS_CMD |
| NCI_MT_RSP | NCI_ANDROID_QUERY_PASSIVE_OBSERVER_STATUS_RSP |
Получить команду возможностей
Хост использует NCI_ANDROID_GET_CAPS_CMD для запроса списка фирменных функций Android, поддерживаемых NFCC. Команда NCI_ANDROID_GET_CAPS_CMD не принимает никаких параметров.
NFCC должен ответить ответом NCI_ANDROID_GET_CAPS_RSP со статусом STATUS_OK и списком поддерживаемых возможностей и функций.
Если NFCC не поддерживает NCI_ANDROID_GET_CAPS_CMD , хост должен предположить, что каждая из возможностей принимает указанное значение по умолчанию. Если указанная возможность не возвращается NFCC в ответе, хост должен предположить, что возможность имеет указанное значение по умолчанию.
NCI_ANDROID_GET_CAPS_CMD
| Поля полезной нагрузки | Размер | Значение/описание | |||||
|---|---|---|---|---|---|---|---|
| Н/Д | 0 октетов | ||||||
NCI_ANDROID_GET_CAPS_RSP
| Поля полезной нагрузки | Размер | Значение/описание | |||||
|---|---|---|---|---|---|---|---|
| Статус | 1 октет | См. коды статуса в таблице 140 Спецификации NCI . | |||||
Android_Version | 2 октета | Определяет версию требований Android, реализованную NFCC. | |||||
| 0x0000 | Андроид 15 | ||||||
| Количество возможностей | 1 октет | Количество (n) поддерживаемых возможностей | |||||
| Возможности[0..n] | (m + 2) * n октетов | Поддерживаемые возможности | |||||
| Тип | 1 октет | Идентификатор возможности | |||||
| Лен | 1 октет | Длина (м) значения | |||||
| Ценить | m октетов | Ценность возможности | |||||
Собственные возможности Android
| Имя возможности | ИДЕНТИФИКАТОР | Размер | Значение/описание | |||||
|---|---|---|---|---|---|---|---|---|
| Режим наблюдения | 0x00 | 1 октет | Поддержка режима наблюдения. 0x00 (по умолчанию) — эта функция не поддерживается. 0x01 — поддерживает функцию деактивации RF с хоста (требуется для Android 15 и выше). Все остальные значения являются RFU. | |||||
| Уведомление о фрейме опроса | 0x01 | 1 октет | Поддержка уведомлений о кадрах опроса. 0x01, если поддерживается, 0x00 (по умолчанию), если не поддерживается. Все остальные значения — RFU. | |||||
| Режим энергосбережения | 0x02 | 1 октет | Поддержка режима энергосбережения. 0x01, если поддерживается, 0x00 (по умолчанию), если не поддерживается. Все остальные значения — RFU. | |||||
| Фильтр цикла опроса Autotransact | 0x03 | 1 октет | Поддержка фильтров цикла опроса в прошивке для обхода режима наблюдения для определенных шаблонов, когда режим наблюдения включен глобально. 0x00 (по умолчанию) — не поддерживает эту функцию. 0x01 — Поддерживает фильтры цикла опроса Все остальные значения являются RFU. | |||||
| 0x04..0xFF | 0 октетов | Зарезервировано для будущего использования | ||||||
Команда энергосбережения
Для перевода NFCC в режим энергосбережения хост может использовать команду NCI_ANDROID_POWER_SAVING_CMD . NFCC должен ответить командой NCI_ANDROID_POWER_SAVING_RSP с кодом состояния, указывающим на успех или неудачу.
В режиме энергосбережения хост не должен отправлять никаких команд в NFCC, а NFCC не должен отправлять никаких уведомлений или ответов хосту. NFCC или встроенный элемент безопасности (eSE) может автоматически принимать входящие платежные запросы в соответствии с конфигурацией маршрутизации, установленной перед включением режима энергосбережения.
Чтобы вернуться в режим полной мощности, хост может сбросить настройки или повторно инициализировать NFCC.
NCI_ANDROID_POWER_SAVING_CMD
| Поля полезной нагрузки | Размер | Значение/описание | |
|---|---|---|---|
| Режим энергосбережения | 1 октет | 0x00 | Отключить режим энергосбережения |
| 0x01 | Включить режим энергосбережения |
NCI_ANDROID_POWER_SAVING_RSP
| Поля полезной нагрузки | Размер | Значение/описание | |||||
|---|---|---|---|---|---|---|---|
| Статус | 1 октет | См. коды состояния в таблице 140 спецификации NCI . | |||||
Установить команду режима наблюдения
Чтобы активировать или деактивировать режим наблюдения, хост может использовать команду NCI_ANDROID_PASSIVE_OBSERVE_MODE_CMD . NFCC должен ответить NCI_ANDROID_PASSIVE_OBSERVE_MODE_RSP с кодом состояния, указывающим на успех или неудачу.
Если режим наблюдения отключен, NFCC должен реализовать стандартный режим прослушивания в соответствии с Технической спецификацией активности .
Когда режим наблюдения активен, NFCC не должен отвечать ни на какие запросы опроса во время цикла опроса в режиме прослушивания, пока это явно не разрешено хостом. NFCC должен отправить уведомление RF_FIELD_INFO_NTF (как определено в разделе 5.3 спецификации NCI ) при обнаружении активации поля. Если режим обнаружения опроса активен, NFCC должен реализовать активность режима опроса в соответствии с Технической спецификацией активности . NFCC может кэшировать информацию опроса, чтобы немедленно приступить к активации устройства, как только режим наблюдения будет деактивирован.
NFCC должен отключать режим наблюдения, если хост выключается по какой-либо причине (например, разрядка батареи или инициированное пользователем выключение), чтобы транзакции SE могли продолжаться.
NCI_ANDROID_PASSIVE_OBSERVE_MODE_CMD
| Поля полезной нагрузки | Размер | Значение/описание | |
|---|---|---|---|
| режим наблюдения | 1 октет | 0x00 | Отключить режим наблюдения (по умолчанию) |
| 0x01 | Включить режим наблюдения |
NCI_ANDROID_PASSIVE_OBSERVE_MODE_RSP
| Поля полезной нагрузки | Размер | Значение/описание | |||||
|---|---|---|---|---|---|---|---|
| Статус | 1 октет | См. коды статуса в таблице 140 Спецификации NCI . | |||||
Уведомление о цикле опроса
NFCC должен отправлять хосту уведомление NCI_ANDROID_POLLING_FRAME_NTF после каждого кадра цикла опроса. Когда генерируются оба уведомления RF_FIELD_INFO_NTF и NCI_ANDROID_POLLING_FRAME_NTF , NFCC должен отправлять NCI_ANDROID_POLLING_FRAME_NTF после RF_FIELD_INFO_NTF .
Уведомление NCI_ANDROID_POLLING_FRAME_NTF не зависит от того, активен ли режим наблюдения или нет. Когда режим наблюдения активен, NFCC всегда должен отправлять уведомление NCI_ANDROID_POLLING_FRAME_NTF перед продолжением транзакции.
NCI_ANDROID_POLLING_FRAME_NTF
| Поля полезной нагрузки | Размер | Значение/описание | |||||
|---|---|---|---|---|---|---|---|
| Данные опроса[0..n] | (m +3) * n октетов | Список запросов на опрос, полученных с момента последнего уведомления. Каждый результат дает тип (технологию) полученных запросов и идентифицируемые данные из запроса в зависимости от технологии. | |||||
| Тип | 1 октет | См. типы рам . | |||||
| Флаги | 1 октет | См. байт флага . | |||||
| Длина | 1 октет | Длина (м) отчета с данными опроса, включая поля метки времени и усиления. | |||||
| Временная метка | 4 октета | Временная метка, измеряемая в миллисекундах с момента получения запросов на опрос, big endian. | |||||
| Прирост | 1 октет | Сила запроса на опрос. 0xFF указывает, что значение недоступно. | |||||
| Данные | м - 5 октетов | Возвращает идентифицируемые данные, присутствующие в запросе на опрос. | |||||
Типы рам
| Опросная рамка | Тип | Размер | Значение/Описание | |
|---|---|---|---|---|
| Удалённое поле | 0x00 | 1 октет | 0x00 | Поле выключено |
| 0x01 | Поле на | |||
| 0x02..0xFF | РФС | |||
| NFC-А | 0x01 | n октетов | Значение должно включать команду ISO 14443-3 (например, REQ или WUP) | |
| NFC-B | 0x02 | n октетов | Значение должно включать байт AIF и команду ISO 14443-3 (например, REQ или WUP) | |
| NFC-F | 0x03 | n октетов | Значение должно включать команду ISO 14443-3 (например, REQ или WUP) | |
| NFC-V | 0x04 | n октетов | Значение должно включать команду ISO 14443-3 (например, REQ или WUP) | |
| Неизвестный | 0x07 | n октетов | Необработанные данные кадра | |
Определение байта флага
| Флаги | ||||||||
|---|---|---|---|---|---|---|---|---|
| б0 | б1 | б2 | б3 | б4 | б5 | б6 | б7 | |
| 0 | Короткая рамка | РФС | РФС | РФС | РФС | РФС | РФС | РФС |
| 1 | Длинная рама | |||||||
Запрос команды состояния режима наблюдения
Чтобы получить текущий статус пассивного режима заказа, хост может использовать команду NCI_ANDROID_QUERY_PASSIVE_OBSERVER_STATUS_CMD . NFCC должен ответить NCI_ANDROID_QUERY_PASSIVE_OBSERVER_STATUS_RSP с кодом статуса, указывающим на успех или неудачу.
NCI_ANDROID_QUERY_PASSIVE_OBSERVER_STATUS_CMD
| Поля полезной нагрузки | Размер | Значение/описание | |||||
|---|---|---|---|---|---|---|---|
| Н/Д | 0 октетов | ||||||
NCI_ANDROID_QUERY_PASSIVE_OBSERVER_STATUS_RSP
| Поля полезной нагрузки | Размер | Значение/описание | |
|---|---|---|---|
| Статус | 1 октет | См. коды состояния в таблице 140 спецификации NCI . | |
| режим наблюдения | 1 октет | 0x00 | Режим наблюдения отключен |
| 0x01 | Режим наблюдения включен | ||