+7 991 730 16 74
Click to order
Total:
ODNFC-LAN RFID для разработчиков
Краткое руководство по программированию
RFID считывателя-контроллера
RFID считывателя-контроллера
Ключевые правила разработки
Работа с Embedded устройством вносит свои особенности в разработку
- 1Время исполнения и web-интерфейсУ устройства всего один не очень мощный процессор. Если вы загрузите его на 100%, то ему не хватит времени, чтобы быстро выдать вашему браузеру web-интерфейс (и браузер разорвёт соединение до загрузки страницы). Поэтому, всегда оставляйте достаточное время для исполнения других потоков когда. Для этого у вас в основном цикле должна быть строка типа
await uasyncio.sleep_ms(100) - 2Ограниченные ресурсыПо-сравнению с ПК, у устройства очень мало памяти и вычислительной мощности. Это необходимо помнить при разработке: старайтесь не использовать большие структуры в коде и не проводить долгих вычислений.
- 3Garbage collectorТ.к. в качестве инструмента программирования используется MicroPython, то в системе работает и gc. Его работа может оказаться визуально заметной (т.е. вызвать небольшой "фриз").
Поэтому, во-первых, старайтесь не нагружать gc - не создавайте много временных объектов в коде.
Во-вторых, вы можете вызывать gc самостоятельно в тех местах, где клиент этого не заметит. - 4Порядок разработкиРазрабатывать сложные алгоритмы под Embedded устройство бывает не всегда удобно. Поэтому используем следующую схему:
1. Предварительно код, не зависящий от железа, разрабаывается и проверяется на "обычном" Python для пк.
2. Прогоняется на сборке MicroPython-сборке под ПК.
3. Аппаратно зависимые элементы проверяются в консоли устройства (чёрное окно внизу на странице окна редактора устройства). Для того, чтобы использовать это окно, нужно нажать ctrl-c и MicroPython выйдет в shell. Чтобы устройство не перегрузилось по watchdog'у, его надо предварительно выключить в настройках (или коде). - 5Применение нового кодаЧтобы новый код устройства вступил в силу, нужно нажать на кнопку "дискета" в верхнем правом углу редактора кода устройства и убедиться, что вышло уведомление "успешно".
После этого нужно перезагрузить устройство.
Браузер не всегда "подцепляет" перезагрузившееся устройство, так что, возможно придется обновить страницу.
Как из кода получить доступ к настройкам
web-интерфейса
web-интерфейса
Для удобства работы с устройством самые используемые настройки выведены в Web-интерфейс.
Как и какие настройки считыватель будет использовать зависит от пользовательского кода.
Из кода настройки доступны как settings - объект класса Settings из модуля config
from config import settings
Доступ осуществляется в виде settings.get('параметр'), где параметры:
Системные:
'sys-version' - версия сборки, строка. только для чтения
'sys-i-ntp' - использовать ntp. число: 1- да, 0-нет.
'sys-ntp-pool' - адрес сервера ntp, строка в формате url.
'sys-ntp-off' - смещение часов относительно utc. строка в формате '00:00',
'sys-lang' - язык интерфейса. строка: 'auto' / 'ru' / 'en'.
'sys-i-web-port' - порт web интерфейса, число.
'sys-set-pwd' - пароль доступа к окну настроек, строка.
'sys-i-set-auth' - использовать пароль для доступа к настройкам. число: 1- да, 0-нет.
'sys-web-pwd' - пароль доступа к web-интерфейсу, строка. (пользователь admin).
'sys-i-web-auth' - использовать пароль для доступа к web-интерфейсу. число: 1- да, 0-нет.
'sys-i-wdt' - включить сторожевой таймер. число: 1- да, 0-нет.
'sys-i-editor' - показывать редактор кода. число: 1- да, 0-нет.
'sys-i-dash' - показывать информационную панель. число: 1- да, 0-нет.
'sys-i-info' - время в секундах между отправками сообщений в web. число.
'sys-i-leds' - количество светодиодов в ленте подсветки. число.
Сеть:
'net-i-dhcp': тип получения ip-адреса. число: 1 - DHCP-клиент/ 0 - cтатический адрес.
'net-ip': адрес устройства (при net-i-dhcp'=0), строка в формате ip-адреса.
'net-mask': маска сети (при net-i-dhcp'=0), строка в формате ip-адреса.
'net-gw': шлюз (при net-i-dhcp'=0), строка в формате ip-адреса.
'net-dns': сервер DNS (при net-i-dhcp'=0), строка в формате ip-адреса.
RFID:
'rfid-format' - строка форматирования
'rfid-protocol': протокол передачи данных о метке. строка 'TCP' / 'UDP'..
'rfid-dest': сетевой адрес получателя, строка в формате ip-адреса.
'rfid-i-dport': сетевой порт получателя, число.
'rfid-keytype': тип ключа шифрования метки RFID. строка: 'A'/'B'/'UL'/'PL'
'rfid-key': значение ключа, строка в hex.
Как и какие настройки считыватель будет использовать зависит от пользовательского кода.
Из кода настройки доступны как settings - объект класса Settings из модуля config
from config import settings
Доступ осуществляется в виде settings.get('параметр'), где параметры:
Системные:
'sys-version' - версия сборки, строка. только для чтения
'sys-i-ntp' - использовать ntp. число: 1- да, 0-нет.
'sys-ntp-pool' - адрес сервера ntp, строка в формате url.
'sys-ntp-off' - смещение часов относительно utc. строка в формате '00:00',
'sys-lang' - язык интерфейса. строка: 'auto' / 'ru' / 'en'.
'sys-i-web-port' - порт web интерфейса, число.
'sys-set-pwd' - пароль доступа к окну настроек, строка.
'sys-i-set-auth' - использовать пароль для доступа к настройкам. число: 1- да, 0-нет.
'sys-web-pwd' - пароль доступа к web-интерфейсу, строка. (пользователь admin).
'sys-i-web-auth' - использовать пароль для доступа к web-интерфейсу. число: 1- да, 0-нет.
'sys-i-wdt' - включить сторожевой таймер. число: 1- да, 0-нет.
'sys-i-editor' - показывать редактор кода. число: 1- да, 0-нет.
'sys-i-dash' - показывать информационную панель. число: 1- да, 0-нет.
'sys-i-info' - время в секундах между отправками сообщений в web. число.
'sys-i-leds' - количество светодиодов в ленте подсветки. число.
Сеть:
'net-i-dhcp': тип получения ip-адреса. число: 1 - DHCP-клиент/ 0 - cтатический адрес.
'net-ip': адрес устройства (при net-i-dhcp'=0), строка в формате ip-адреса.
'net-mask': маска сети (при net-i-dhcp'=0), строка в формате ip-адреса.
'net-gw': шлюз (при net-i-dhcp'=0), строка в формате ip-адреса.
'net-dns': сервер DNS (при net-i-dhcp'=0), строка в формате ip-адреса.
RFID:
'rfid-format' - строка форматирования
'rfid-protocol': протокол передачи данных о метке. строка 'TCP' / 'UDP'..
'rfid-dest': сетевой адрес получателя, строка в формате ip-адреса.
'rfid-i-dport': сетевой порт получателя, число.
'rfid-keytype': тип ключа шифрования метки RFID. строка: 'A'/'B'/'UL'/'PL'
'rfid-key': значение ключа, строка в hex.