NT4H NTAG® 424 DNA Tag Read/Write Software

Примеры исходного кода программного обеспечения, описанные на этой странице, относятся к технологическим решениям NFC NTAG® DNA. Его основной целью является запись и чтение тегов ДНК NTAG® 413 и NTAG® 424 ДНК, то есть NXP NTAG® Type 4 Tag.

Эти теги полностью соответствуют:

• ISO/IEC 14443, все части с 1 по 4, выбор файлов ISO/IEC 7816-4 и обработка APDU, а также пассивная мишень, совместимая с ISO/IEC18092
• 7-байтовыйUID (согласно ISO/IEC 14443 – 3)
• NFC Forum Tag 4 Тип техническая конфигурация и структура данных NDEF

Тем не менее, основной причиной выбора ДНК-меток NTAG® 424 среди всех типов семейства NTAG является его расширенная поддержка безопасности. ДНК-метки NTAG® 424 предлагают расширенные методы безопасности, такие как:

• Стандартная криптография AES-128 для аутентификации / безопасного обмена сообщениями илиоперация AES в оболочке LRP для еще более сильной устойчивости к атакам
• 3-проходная взаимная аутентификация для доступа к защищенному файлу данных
• Безопасное уникальное сообщение NFC (SUN)
• Инкрементный счетчик нажатий NFC
• Обычная, CMAC и зашифрованная связь (конфигурируемая)
• Сигнатура оригинальности NXPна основе ECC
• Встроенная сборка URL-адресов элементов с гибкими зеркалами ASCII.

Соответственно, наш пример программного обеспечения включает в себя функции для всех протоколов безопасности ДНК NTAG® 424 и реализации опций.

Документация по API

Загрузка программного обеспечения

Обзор программного обеспечения

Функции программного обеспечения:

• Получение и изменение параметров файлов
• Получить UID
• Установить случайный идентификатор
• Изменение ключа AES
• Линейное чтение/запись (ASCII & HEX)
• Трехуровневыйрежимаутентификации
• SDM (безопасное динамическое сообщение) чтение/запись
• Получить счетчик считывания SDM
• Сохранение ключа AES в считывателе
• Блокировка/разблокировка считывателя
• Дополнительные параметры считывателя (укажите COM-порт Reader, IP-адрес, SN и т. д.)

Доступные языки программирования:

• C (консоль)
• C# (графический интерфейс)

Поддерживаемые операционные системы, платформы и среды:

• Кроссплатформенность

Поддерживаемые теги, наклейки, карты:

• NXP NTAG® 21x (210, 213, 215, 216, Tag Tamper)
• NXP NTAG® 4xx ДНК (413, 424)

Рекомендуемое оборудование:

• мкФРНано
• μFR Нано Онлайн
• мкФР Классик
• мкФР Классик КС
• μFR Аванс
• мкФР XL

1. Программное обеспечение NT4H — Консоль C — Считыватель открыт

Скачать:ufr-examples-c-nt4h

NT4H предназначен для работы с новыми тегами серии NXP NTAG®. Эта серия включает в себя ДНК NTAG® 413 и ДНК NTAG ®424. ДНК NTAG® 424 полностью совместима с NFC Forum Type 4 Tag IC. Он поддерживает криптографическую операцию AES-128 и новое сообщение Secure Unique NFC (SUN). NXP не рекомендует использовать ДНК-метки NTAG® 413 для новых проектов, поскольку доступная ДНК NTAG® 424 предлагает лучшие функции безопасности.

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

• Вариант1 — Порт считывателя открывается с использованием опций по умолчанию (автоматическое определение) (обычно используется для одного USB-считывателя, подключенного к хосту)
• Вариант 2 – Порт reader открывается с использованием настраиваемых вручную параметров: reader_type, port_name, port_interface и аргумент.

2. Программное обеспечение NT4H — Консоль C — Главное меню

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

2.1 Программное обеспечение NT4H — Консоль C — Получение настроек файла

Первая функция, Get File Settings, отображает выбранные параметры файлов. В зависимости от используемого тега введите 1 -2 для NTAG413 и 1-3 для NTAG 424.

NTAG413 имеет два стандартных файла данных:

• ФайлNo 1 относится к файлу контейнера возможностей (32 байта),
• ФайлNo 2 относится к файлу NDEF (128 байт).

NTAG424 имеет три стандартных файла данных:

• ФайлNo 1 относится к файлу контейнера возможностей (32 байта),
• ФайлNo 2 относится к файлу NDEF (256 байт),
• ФайлNo 3 относится к проприетарному файлу (128 байт),
• Количество возвращаемых параметров является переменным.

Если текущий файл является стандартным файлом данных с безопасным обменом сообщениями AES, применяется следующее:

• Тип файла
• Режим связи
• Права доступа к файлам.

Пример размера файла:

• Номер файла = 3 (проприетарный файл NTAG424)
• Состояние режима связи зашифровано (0x03)
• Безопасный динамический обмен сообщениями отключен
• Ключевое число для чтения — 2, ключевое число для записи — 3,
• Ключевое число для чтения/записи — 3,
• Ключевой номер для изменения настроек файла равен 0,
• Размер файла составляет 128 байт.

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

Примере:

• Номер файла 2 (файл NDEF),
• Включен безопасный динамический обмен сообщениями,
• доступ к чтению и письму бесплатный (0x0E клавиш),
• Размер файла 256 байт,
• Зеркальное отображение UID включено,
• Счетчик считывания SDM включен,
• Ограничение счетчика чтения SDM отключено,
• активирована часть файла зашифрованных данных,
• Ключевой номер для SDM Meta Read равен 2 (UID, счетчик чтения SDM, данные PICC, MAC),
• Часть зашифрованных данных в ключе файла имеет номер 2.
• Счетчик считывания SDM может считывать без аутентификации,
• Смещение данных PICC (зашифрованный UID и счетчик чтения SDM) составляет 49,
• входное смещение MAC составляет 86,
• Часть зашифрованных данных смещения файла равна 86,
• часть зашифрованных данных длины файла равна 32,
• Смещение MAC составляет 124.

2.2 Программное обеспечение NT4H – консоль C – Настройка параметров файла

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

Стандартный файл данных:

• ФайлNo 3 (Проприетарный файл),
• текущий режим связи зашифрован,
• Значение параметра Изменить ключ равно 0.

Новые настройки:

• Режим простой связи,
• Чтение ключа 2,
• Клавиша записи 3,
• Клавиша чтения/записи 3,
• Изменить ключ 0,
• Режим проверки подлинности предоставленного ключа.

Безопасный файл динамических сообщений:

• Номер файла 2,
• Режим связи Простой,
• Ключ чтения равен 14,
• Клавиша записи 14,
• Клавиша чтения/записи 14,
• Значение change Key равно 0,
• Зеркальное отображение UID включено,
• Счетчик считывания SDM включен,
• Счетчик считывания SDM отключен,
• активирована часть файла зашифрованных данных,
• Ключ мета-чтения SDM равен 2,
• Чтение файла SDM составляет 2,
• Ключ счетчика считывания SDM равен 2,
• Зашифрованное смещение данных PICC 49,
• Смещение входных данных MAC 86,
• смещение зашифрованной части данных 86,
• MAC Вылет 124.

2.3 Программное обеспечение NT4H – консоль C – Получить UID (только NTAG 424)

Если вы используете теги NTAG® 424 с включенным режимом безопасности аутентификации, пункт меню 3. отобразит тег UID.

Функция возвращает 7-байтовый идентификатор UID карты. Это полезно, если активированы параметры Random ID. Требуется действительная аутентификация с любым ключом карты.

2.4 Программное обеспечение NT4H – консоль C – Установка случайного UID (только NTAG®424)

NTAG® 424 DNA обеспечивает дополнительную безопасность тегов с помощью случайной настройки UID (пункт меню 4).
Функция Set Random UID заменяет 7-байтовый уникальный UID на 4-байтовый случайный UID. Следовательно, тег возвращает 4-байтовый случайный UID при каждом чтении. Теперь тег возвращает 4-байтовый случайный идентификатор вместо 7-байтового уникального идентификатора.
Для этой функции требуется проверка подлинности с помощью главного ключа (число 0).

Предупреждение: эта операция необратима!

2.5 Программное обеспечение NT4H – консоль C – Изменение клавиши AES

Пункт меню 5 позволяет изменить клавишу AES.
Для этой функции требуется проверка подлинности с помощью главного ключа (число 0).
Введите новый ключ AES, введя 16 шестнадцатеричных байт.
Если изменяемый ключ не является главным ключом, предыдущее значение ключа является обязательным.

Пример изменения ключа AES:

• Ключ No4.
• значение главного ключа приложения 0x00000000000000000000000000000000
• 0x00000000000000000000000000000000 значения старого ключа 4
• 0x11111111111111111111111111111111 значения нового ключа 4.

2.6 Программное обеспечение NT4H — консоль C — линейное считывание

Функция линейного чтения включает в себя режим простого, зашифрованного и зашифрованного чтения. Кроме того, аутентификация чтения контента в режиме Предоставленный ключ и Режим внутреннего ключа позволяет получить доступ к содержимому, если тег защищен. В противном случае разблокированное содержимое тега может быть прочитано без ввода ключа (опция: Нет аутентификации). Консоль отобразит содержимое, читаемое в выбранном режиме проверки подлинности, как шестнадцатеричное и ASCI-нотацию.

2.6.1 Программное обеспечение NT4H – консоль C – линейное считывание

Функция линейного чтения включает в себя обычный, mac (код аутентификации сообщения) и зашифрованный режим чтения. Кроме того, проверка подлинности чтения контента в режиме «Предоставленный ключ» и «Внутренний ключ» позволяет получить доступ к содержимому, если тег защищен. В противном случае разблокированное содержимое тега доступно без ввода ключа (опция: Без аутентификации). Консоль отобразит содержимое, читаемое в выбранном режиме проверки подлинности, как шестнадцатеричное и ASCI-нотацию.

Функция считывает записанные данные файла. Обязательные параметры:

• Номер файла,
• Ключ доступа для чтения или чтения/записи,
• Режим связи,
• Режим аутентификации (если значение Read Key равно 14, выберите опцию Без аутентификации),
• Начальныйадрес(0 -максимальныйадрес),
• Длина данных.

2.7 Программное обеспечение NT4H – консоль C – Линейная запись

Как и в случае с функцией linear Read, функция Linear Write допускает три режима связи и шестнадцатеричный или ASCII-формат для записи контента. Кроме того, выбранный режим проверки подлинности применяется к записанному содержимому.

Функция записывает данные в файл. Обязательные параметры:

• Номер файла,
• Ключ доступа для чтения или чтения/записи,
• Режим связи,
• Режим аутентификации (если чтение ключа равно 14, выберите опцию Без аутентификации),
• Начальныйадрес(0 -максимальныйадрес),
• Введите данные в ASCII или шестнадцатеричном формате.

2.8 Программное обеспечение NT4H — консоль C — безопасное динамическое чтение сообщений

Функция безопасного динамического обмена сообщениями (SDM) на тегах ДНК NT4H включает функцию SUN. Он ссылается на текст (ASCII) в сообщении NDEF.
Чтобы применить функцию безопасного чтения динамических сообщений, включите файл Безопасное динамическое сообщение. Кроме того, установите для параметра Доступ на чтение значение free (Ключ 14 – Без аутентификации).

2.9 Программное обеспечение NT4H — консоль C — безопасная динамическая запись сообщений

Какивслучаесбезопаснымдинамическимчтениемсообщений, для функции безопасной динамической записи сообщений включите файл Безопасное динамическое сообщение. Кроме того, установите для параметра Доступ на чтение значение free (Ключ 14 – Без аутентификации).

2.10 Программное обеспечение NT4H – Консоль C – Получение счетчика считывания SDM

Счетчикбезопасногодинамическогочтениясообщенийсуществует только в том случае, если включена файловая SDM. Проверка подлинности требуется или не требуется в зависимости от параметра доступа к счетчику чтения SDM.

2.11 Программное обеспечение NT4H – Консоль C – Хранение ключа AES в считывателе

Устройство Reader может хранить 16 ключей AES со значениями индексов 0-15. Это означает, что индекс Key может иметь любое значение от 0 до 15.

В примере показано, как сохранить ключ со значением 0 x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

Ключ AES, хранящийся в считывателе, по умолчанию разблокирован.

Сохраненный ключ можно заблокировать любым 8-байтовым паролем.

Пример:
Пароль 12345678

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

Пример:
Пароль 12345678

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

ГЛАВНАЯ

АППАРАТНЫЕ ПРОДУКТЫ

ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ SDK