USB-считыватели ODRFID-M/N/E: инструкция

ODRFID-M/N/E — настольные USB-считыватели для работы с UID и памятью карт. Они могут выдавать номер как клавиатура HID или работать с программой через виртуальный COM-порт CDC.

• ODRFID-M
• ODRFID-N
• ODRFID-E

Выбор исполнения

Модели -M и -N читают и записывают MIFARE Classic 1K/4K/Mini, MIFARE Plus, Ultralight и NTAG 213/215/216. Модели -M и -E читают EM4100 и HID ProxCard II и программируют T5557/T5567/T5577 в режиме EM4100.

Поддерживаемые карты

Поддержка зависит не только от семейства карты, но и от её режима безопасности. Для MIFARE Plus SL2, Ultralight C и DESFire доступно только чтение UID; это не равнозначно чтению защищённой памяти карты.

ODRFID-E и ODRFID-M читают EM4100 и совместимые метки с Manchester- или BiPhase-кодированием. Они также программируют T5557/T5567/T5577 в режиме эмуляции EM4100, включая защиту от перезаписи паролем. Чтение HID ProxCard II поддерживается начиная с прошивки 3.6.

Для MIFARE Classic можно читать и записывать зашифрованные блоки с заданными ключами. Карты с перезаписываемой областью UID поддерживают запись 4-байтового UID; используйте эту возможность только для принадлежащих вам карт и систем.

NDEF

ODRFID-M и ODRFID-N можно использовать для чтения и записи ссылок, текста и других NDEF-сообщений в память поддерживаемых карт MIFARE, Ultralight и NTAG. Формат NDEF, отличие от UID, совместимость меток и выбор между настольным считывателем и ODNFC разобраны в отдельном руководстве: NDEF: данные на NFC-метках.

CDC и HID

Для полноценной работы через CDC HID-клавиатуру можно отключить в настройках. В Windows 8/10/11, Linux и macOS драйвер обычно не нужен. Для Windows 7 есть инструкция по CDC-драйверу.

HID: ввод UID как с клавиатуры

В режиме HID считыватель вводит результат в активное поле программы. Поставьте курсор в ячейку Excel, поле 1С, CRM или браузерной формы и поднесите карту. Формат результата задаётся строкой форматирования; по умолчанию выводится UID. Раскладка в операционной системе влияет на ввод обычного текста, добавленного в форматную строку.

CDC: терминал, программа или скрипт

В режиме CDC устройство видно как виртуальный последовательный порт. Это режим для интеграции, ручной проверки команд и работы с ODRFIDKit. Запрос ATI возвращает сведения о считывателе и серийный номер, а при включённом автоматическом сканировании UID появляется в порту сразу после поднесения карты.

Пример настройки строки Hello, и UID в нижнем регистре HEX:

AT+F=\H\ello, hU*
AT+P

После поднесения карты результат выглядит так:

Hello, dcb43d07

Полный синтаксис, чтение выбранных блоков и преобразование порядка байтов описаны в справочнике строки форматирования.

Для разработки собственного ПО см. отдельное руководство по интеграции ODRFID-M/N/E через AT-команды: форматы ответов, режимы SCAN0–3, ручной опрос и пример на Python.

Программы

ODRFIDKit Web

ODRFIDKit Web — браузерная версия без отдельного установщика. Она подключается к ODRFID через Web Serial и позволяет:

• читать и записывать блоки MIFARE Classic, задавать Key A/Key B и разбирать права sector trailer;
• читать страницы Ultralight/NTAG и работать с NDEF на совместимых Type 2 метках;
• безопасно просматривать доступную память T5577 и записывать EM-Marine UID в совместимые T55xx;
• настраивать режим сканирования, ключи, CDC/HID и строку форматирования.

В отдельной пошаговой инструкции ODRFIDKit Web показаны интерфейс, чтение и запись на 13,56 МГц и 125 кГц, Key A/Key B, access bits и реальные экраны MIFARE Classic 1K и T5577.

Веб-версия удобна для быстрой проверки или настройки с нового компьютера. Доступ к последовательному порту должен быть разрешён браузером; если Web Serial недоступен, используйте настольную программу.

Настольная ODRFIDKit

ODRFIDKit — основная программа для постоянного рабочего места. Она работает в Windows, Linux и macOS, читает и записывает память поддерживаемых карт, показывает секторы, блоки и страницы, настраивает ключи и биты доступа MIFARE, работает с NTAG и EM-Marine.

В настольной версии также доступны сохранение и разбор дампов .mfc, программный эмулятор карты, TCP- и UDP-серверы для передачи событий и обновление прошивки считывателя. Скачать ODRFIDKit.

Копируйте данные только между принадлежащими вам картами и в системах, где у вас есть разрешение на такие операции. Инструкция по копированию карт отдельно разбирает перенос UID, блоков и страниц.

В ODRFIDKit можно прочитать карту, выбрать сектор MIFARE, указать Key A/Key B и записать изменённые данные. Для служебного блока сектора MIFARE Classic (sector trailer) программа отдельно показывает Key A, Key B и биты доступа. Изменяйте их только после проверки прав чтения и записи: неверная комбинация может закрыть доступ к сектору.

ODRFIDConfig

ODRFIDConfig задаёт режим USB, строку форматирования, индикацию и перевод в загрузчик.

Ниже показан весь маршрут настройки; эти экраны полезны и для проверки, на каком шаге программа перестала видеть устройство.

Почему напечатанный номер не совпадает с UID

На карте может быть напечатан прямой или развёрнутый UID, десятичное число, пара Facility Code и Card Number либо независимый номер эмитента. Отдельное руководство «UID и номер карты: форматы, Wiegand и преобразование» показывает варианты, формулы для таблиц и автоматическую настройку ODRFID и ODNFC.

Обновление прошивки

1. Скачайте прошивку именно для своей модели -E, -M или -N из раздела прошивок.
2. Переведите устройство в загрузчик через ODRFIDConfig или ODRFIDKit.
3. Скопируйте файл на появившийся съёмный носитель.
4. Выполните безопасное извлечение и дождитесь перезагрузки.

Файл должен соответствовать исполнению -E, -M или -N. При обновлении с версии ниже 3.6 на 3.6 или новее проверьте период опроса: начиная с 3.6 он задаёт паузу между окончанием одного опроса и началом следующего.

Если устройство не определяется

• проверьте, что USB-кабель передаёт данные, а не только питание;
• для CDC в Windows 7 установите драйвер по инструкции;
• в Linux проверьте права на /dev/ttyACM*;
• если CDC-порт занят или не отвечает, закройте ODRFIDKit, терминал и другие программы, которые могли открыть тот же порт;
• если нужен CDC без клавиатурного ввода, отключите HID в ODRFIDConfig.

Файлы и справочники

• PDF с общей информацией по ODRFID-M/N/E
• PDF протоколов ODRFID
• Интеграция через AT-команды
• Форматы UID, напечатанные номера и Wiegand
• ODRFIDKit
• ODRFIDConfig
• прошивки ODRFID
• техническая поддержка

История прошивки ODRFID-M/N/E

Эта история относится к настольным USB-считывателям ODRFID-M, ODRFID-N и ODRFID-E. Она не относится к ODRFID-RS485.