ODNFC-RS485 Modbus на MicroPython — руководство

ODNFC-RS485 с прошивкой MicroPython — считыватель-контроллер с интерфейсом RS485 и протоколом Modbus RTU. Он передаёт данные карты в ПЛК или СКУД, а пользовательская программа на MicroPython обрабатывает вход, выход и индикацию.

Основные характеристики

• Интерфейс подключения: RS485, Modbus RTU.
• Поддерживаемые карты: MIFARE Classic 1K/4K/Mini, MIFARE Plus S/X (SL0/SL1/SL3), MIFARE Ultralight, Ultralight Nano, Ultralight EV1 80/164, NTAG 213/215/216, S50/S70 — полная поддержка; MIFARE Plus X (SL2), Ultralight C, DESFire — только чтение UID.
• EMV-совместимые банковские карты: чтение PAN как идентификатора, без платёжных операций. Идентификатор мобильного кошелька может меняться; до внедрения проверьте конкретный телефон и сценарий.
• Передача UID и/или заранее заданного блока данных.
• Настраиваемый формат выдаваемых данных.
• Светодиодная и звуковая индикация взаимодействия с картой.
• Один дискретный вход.
• Управляемый дискретный выход.

Настройки порта по умолчанию: 115200 8N1.

Конфигуратор ODRFIDConfigM

Для настройки устройства и формата выводимых данных используется кроссплатформенная программа-конфигуратор.

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

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

Карта данных и AT-команды

Устройство предоставляет готовую область данных последней карты и отдельный обмен AT-командами через регистры Modbus.

Некоторые программы обозначают регистры хранения как 40001, 40002 и далее, хотя в запросе Modbus передаётся относительный адрес с нуля. В этой инструкции указаны относительные адреса: 0 соответствует 40001.

Готовые данные карты. Последняя поднесённая карта отображается в регистрах, начиная с адреса 130.

AT-команды через Modbus. Команда и ответ передаются через буферы в регистрах. Порядок чтения ответа:

1. Прочитать входной регистр (Input Register) 0 и проверить, есть ли ответ.
2. Если данные есть, прочитать их из регистров хранения (Holding Registers), начиная с 0.
3. После чтения очистить входной буфер записью любого значения в регистр 126 (0x7E). Если не стирать, данные будут копиться в буфере, пока не наберётся 252 байта; дальше лишние данные отбрасываются.

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

1. Переведите устройство в режим обновления: запишите 1 в регистр хранения (Holding Register) 128 — либо 40129, если программа использует такую нумерацию, — или отправьте AT-команду AT+X.

2. Убедитесь, что устройство в режиме обновления (индикатор плавно мигает красным).

3. Подключитесь к Wi-Fi-сети устройства OD-eRFID-DFU.

4. Откройте в браузере адрес 10.10.0.1.

   Если страница не открывается с телефона, временно отключите мобильные данные: операционная система может пытаться отправить запрос не в локальную Wi-Fi-сеть устройства.

5. Нажмите поле Click to select a firmware image file… («Выбрать файл прошивки») или кнопку Select («Выбрать»).

6. Выберите файл прошивки *.efw.

7. Нажмите Upload («Загрузить») и дождитесь надписи Uploaded. Устройство подаст двойной звуковой сигнал.

8. Нажмите Launch («Запустить») в левой колонке. Устройство перезагрузится, а соединение с его Wi-Fi-сетью разорвётся.

Исполнения

Исполнения различаются корпусом, индикацией и диапазоном питания:

• ODNFC-RS485 — RGB-светодиод, возможность подключения адресной RGB-ленты, питание 7–24 В.
• ODNFC-RS485-C — классические зелёный-красный светодиоды, питание 5–12 В.

Дополнительные материалы

• Кнопка, замок, реле, второй считыватель и адресная RGB-лента
• Скачать ODRFIDConfigM.
• PDF с картой регистров и протоколом AT/Modbus. Перед интеграцией сверьте указанную в PDF ревизию с версией прошивки устройства.
• Строка форматирования — выбор UID или области памяти и преобразование результата.
• Программирование ODNFC на MicroPython.
• Карточка ODNFC-RS485 на MicroPython.
• Если карта регистров конкретной прошивки отличается от PDF, уточните ревизию в технической поддержке.

История обновлений ODNFC на Lua

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

net.en.setup(
  net.packip(Settings.get("net_ip")),
  net.packip(Settings.get("net_mask")),
  net.packip(Settings.get("net_gw")),
  net.packip(Settings.get("net_dns"))
)
net.en.start()