Программирование устройств UnitX на Lua

Это общее руководство по программированию устройств UnitX на Lua. Оно охватывает общие инженерные правила для всех моделей, но не объединяет разные среды исполнения в одну:

• в ODNFC и LuaTerm используется Lua 5.3 в составе Lua RTOS и FreeRTOS;
• контроллер С3 использует другую реализацию Lua — не переносите в него модули, примеры и средства разработки Lua RTOS.

Руководство также не относится к uLua: это другие среды с собственными ограничениями и API.

Сначала откройте инструкцию конкретного устройства, затем используйте это руководство и справочник Lua:

• ODNFC с прошивкой Lua — подключение, веб-интерфейс и аппаратные возможности;
• LuaTerm Mini, включая опцию Pro — подключение, настройка, сценарии и первые примеры;
• ODLAN-RS485 — подключение считывателей, встроенный редактор и сетевые сценарии;
• модульный контроллер С3 — отдельная реализация Lua, редактор и сервисная консоль;
• раздел «Программирование ODNFC» ниже — работа со считывателем, индикацией и сетью.

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

Если вы будете разрабатывать с помощью ИИ, скопируйте промпт для Lua.

Ключевые правила разработки

Lua-программа при выполнении вашей задачи делит процессор, оперативную память и периферию с сетью, веб-интерфейсом и системными задачами прошивки. Поэтому код, который нормально запускается на компьютере, ещё не готов к работе в контроллере. Принципы ниже общие, а конкретные имена thread, cpu, Settings и usercode.lua применимы только к тем моделям, где их подтверждает руководство устройства.

Учитывайте модель и среду исполнения

• Зафиксируйте модель, исполнение и версию прошивки. Не переносите API из NodeMCU, настольной Lua или другой прошивки только из-за совпадения имени модуля. Проверяйте каждую функцию и константу по инструкции устройства и справочнику этой версии.
• Уточните точку входа и структуру проекта. В ODNFC и LuaTerm пользовательская точка входа — usercode.lua. Небольшую программу можно оставить в одном файле, а крупную — разделить на модули и подключить через require. В этих прошивках нет менеджера пакетов: загрузите все дополнительные файлы вместе с проектом.
• Не дублируйте системную инициализацию. Сеть, веб-интерфейс и часть периферии запускает прошивка. В ODNFC и LuaTerm не перенастраивайте их из usercode.lua, если вы не делаете это осознанно.
• Не полагайтесь на поведение настольной или другой встроенной Lua. Состав стандартных библиотек, числовые типы, встроенные модули и обработка ошибок зависят от реализации и сборки. Например, широкие идентификаторы безопаснее хранить строкой или бинарными данными, если они не помещаются в Lua integer.

Не занимайте планировщик надолго

• Исключите активное ожидание. Каждый бесконечный или долгий цикл должен регулярно отдавать управление планировщику. В Lua RTOS используйте thread.sleep, thread.sleepms или документированный блокирующий ввод-вывод. Интервал выбирайте по задаче.
• Делайте обработчики событий короткими. В обработчике прочитайте и сохраните событие, а долгую сетевую операцию или вычисление выполните отдельно. Иначе один медленный обработчик задержит чтение следующего события и системные задачи.
• Не создавайте поток для каждого события. Запускайте только необходимые долгоживущие потоки. В Lua RTOS проверяйте их состояние и запас стека через thread.list(). По возможности закрепите периферийный интерфейс за одним потоком; если ресурс общий и среда поддерживает мьютексы, защищайте совместный доступ.
• Делите тяжёлую работу на части. Большой разбор данных, перебор таблицы или запись файла выполняйте порциями и между ними возвращайте управление планировщику.

Контролируйте память и флеш-память

• Контроллируйте потребление памяти. Смотрите свободную кучу через cpu.memfree() на устройствах с Lua RTOS или через диагностический API своей среды до запуска задачи, под рабочей нагрузкой и после повторяющихся операций.
• Сокращайте число временных объектов. Не собирайте большой ответ или файл целиком, если данные можно обработать порциями. В частом цикле переиспользуйте таблицы и буферы, избегайте цепочек конкатенации строк и не храните историю без ограничения размера. Не создавайте большого количества локальных переменных.
• Учитывайте сборщик мусора. Частые выделения памяти увеличивают работу GC и могут добавить паузы. Если среда поддерживает collectgarbage(), вызывайте его вручную только после измерений и в месте, где пауза допустима, а не в каждом цикле.
• Не записывайте флеш-память при каждом опросе. Сохраняйте настройку только при изменении, а события и телеметрию буферизуйте или объединяйте. Ограничивайте размер и число файлов журнала.

Проектируйте восстановление после ошибок

• Проверяйте результат функций. Одни API возвращают nil, err или false, err, другие при ошибке создают исключение, а при успехе могут ничего не вернуть. Не считайте любое пустое значение ошибкой; используйте описание конкретной функции и pcall для ожидаемых исключений.
• Ограничивайте ожидание и повторные попытки. Для сети и периферии задавайте тайм-ауты, обрабатывайте обрыв соединения и увеличивайте паузу между повторными подключениями. Цикл мгновенных повторов одновременно загружает процессор и скрывает исходную ошибку.
• Освобождайте ресурсы на всех ветках. Закрывайте файлы и соединения после успеха и ошибки. Не оставляйте заблокированный мьютекс, если защищённая операция завершилась исключением.
• Проверяйте внешние данные. До обращения к GPIO, файлу или протоколу ограничьте длину входной строки, проверьте формат, диапазоны и допустимые команды. Не исполняйте полученный по сети текст через load.
• Оставьте путь к восстановлению. Перед экспериментом сохраните рабочие файлы на компьютере и проверьте доступ по последовательной консоли.

Сторожевой таймер должен контролировать основную логику

Сторожевой таймер (watchdog) перезагружает устройство, если пользовательская программа перестала подтверждать, что работает по ожидаемому сценарию. Это запасной способ восстановления на случай, если программа завершилась из-за необработанной ошибки, зависла или попала в состояние, которое программист не предусмотрел. В текущей конфигурации Lua RTOS для ODNFC тайм-аут составляет 30 секунд. Если за это время программа не сбросит включённый таймер, устройство перезагрузится.

Вызов cpu.watchdog.reset() означает: «Основная логика завершила очередной исправный цикл». Поставьте этот вызов в одну осмысленную контрольную точку основного или наиболее ответственного цикла и выполняйте только после того, как критические операции завершились, а программа вернулась в ожидаемое состояние. Для считывателя штатным результатом может быть и обработанная карта, и завершённый опрос без карты. Не сбрасывайте watchdog безусловно в отдельном потоке или таймере: такой код продолжит работать, даже если основная логика зависла, и устройство не сможет восстановиться.

• Во время разработки выключите watchdog в окне «Настройки» (sys_wdt = off) и перезагрузите устройство. Таймер мешает делать намеренные паузы, проверять незавершённый код и разбирать ошибки: через 30 секунд устройство перезагрузится и может скрыть исходную причину сбоя.
• Перед установкой на объект включите watchdog (sys_wdt = on), перезагрузите устройство и проверьте восстановление. Для проверки временно не сбрасывайте таймер дольше 30 секунд и убедитесь, что устройство перезагрузилось. После проверки удалите тестовую задержку.

Отделяйте конфигурацию от программы

• Не зашивайте изменяемые адреса и режимы в логику. Храните их в настройках устройства или отдельном конфигурационном файле. Исходники и резервные копии не должны содержать пароли, токены и закрытые ключи.
• Не выводите секреты и персональные данные в журнал. Для диагностики записывайте состояние операции, код ошибки и безопасный идентификатор. У повторяющегося сообщения ограничьте частоту, иначе журнал вытеснит полезную историю.
• Закройте отладочный доступ перед установкой “набело”. Отключите неиспользуемые WebSocket REPL, Telnet, HTTP, SSH и другие службы. Оставшиеся интерфейсы защитите паролями и не публикуйте напрямую в интернете.

Проверяйте программу по слоям

1. Отладьте на компьютере чистые функции, которые не зависят от железа и модулей прошивки. Версия настольного интерпретатора должна совпадать с версией языка на устройстве; для С3 уточните её отдельно.
2. На устройстве сначала проверьте запуск, журнал, модель и свободную память.
3. Подключайте по одному входу, датчику или сетевому действию. Выходы и силовую нагрузку проверяйте отдельно, начиная с безопасного состояния.
4. Проверьте длительную работу, повторные подключения, перезагрузку, потерю сети и питания, заполнение файлов и срабатывание watchdog.
5. Перед установкой сохраните исходники, версию прошивки и рабочие настройки. После записи перезагрузите устройство и убедитесь по журналу, что запустилась новая версия программы.

Средства разработки

Доступные способы подключения зависят от устройства и реализации Lua. Для небольшой программы обычно достаточно встроенного редактора. Проект из нескольких файлов удобнее вести на компьютере и загружать поддерживаемым устройством способом. Очень сильно облегчит разработку/поддержку отладочный USB-донгл.

Встроенный редактор

В ODNFC откройте окно «Редактор», нажмите «Прочитать», внесите изменения и нажмите «Записать». Затем перезагрузите устройство. В LuaTerm названия действий и порядок запуска описаны в руководстве устройства. У С3 есть собственный редактор в веб-интерфейсе; используйте инструкцию С3, а не инструкции для usercode.lua ниже.

Онлайн-среда Lua RTOS (веб-IDE)

На странице lua.unitx.pro находится веб-среда разработки для совместимых устройств на Lua RTOS. Её можно открыть в браузере или установить на компьютер. К С3 эта инструкция не относится.

• По WebSocket. Если этот транспорт поддерживается, включите в устройстве HTTPS и WebSocket REPL. Возможно, потребуется один раз вручную подтвердить в браузере самоподписанный сертификат. После подключения можно ходить по файловой системе, редактировать файлы и пользоваться терминалом.
• По последовательному порту. Нужен сервисный разъём и подходящий USB–UART-адаптер. Браузер запросит доступ к порту. Этот режим не зависит от сетевого соединения.

Расширение Lua RTOS для VS Code

Расширение для совместимых устройств на Lua RTOS позволяет разрабатывать в привычной IDE. К С3 эта инструкция не относится. Установка: Extensions → … → Install from VSIX. Для подключения по WebSocket включите в устройстве WebSocket REPL. Расширение может подключаться без HTTPS; используйте такой режим только в доверенной локальной сети и не публикуйте порт в интернет. Нажмите шестерёнку в плагине, выберите тип подключения и задайте сетевой адрес, затем нажмите Connect. Конкретные транспорты зависят от модели и прошивки.

Программирование ODNFC

Следующие настройки и примеры относятся к ODNFC с Lua-прошивкой. Примеры чтения карт требуют встроенного модуля mfrc522; они не подходят для UHF-модели и других устройств без этого модуля. Для LuaTerm и С3 используйте отдельные руководства: у них другой набор периферии, настроек и готовых сценариев.

Настройки пользовательской программы

Параметры из окна «Настройки» доступны в usercode.lua через глобальный объект Settings. Метод Settings.get() читает значение по имени:

local destination = Settings.get("net_dest")
local wdt_on = Settings.get("sys_wdt") == "on"

iprint("destination:", destination)

Здесь net_dest — получатель из сетевых настроек, а sys_wdt — состояние сторожевого таймера. Сеть запускает системный код, поэтому вручную вызывать net.wf.setup() в usercode.lua не нужно. Функция iprint() выводит сообщения в окно «Информация» веб-интерфейса.

Быстрый старт: от запуска до чтения карты

Начинайте с одного действия и добавляйте следующее только после проверки предыдущего. Каждый фрагмент ниже — самостоятельный usercode.lua.

1. Убедиться, что программа запустилась

local board, subtype, brand = cpu.board()

iprint("usercode.lua started")
iprint("device:", board, subtype, brand)
iprint("free memory:", cpu.memfree())

После сохранения и перезапуска эти строки должны появиться в окне «Информация» веб-интерфейса.

2. Прочитать UID в окне «Информация»

local wdt_on = Settings.get("sys_wdt") == "on"

while true do
    local callback_ok, err = mfrc522.scan(0, function(uid)
        iprint("UID:", uid)
    end)
    if callback_ok == false then
        iprint("scan callback error:", err)
    elseif wdt_on then
        cpu.watchdog.reset()
    end
    thread.sleepms(50)
end

0 выбирает UID как шестнадцатеричную строку в верхнем регистре. Функция-обработчик вызывается только после чтения карты; отсутствие карты — нормальное состояние, а не ошибка.

3. Добавить свет и звук

local wdt_on = Settings.get("sys_wdt") == "on"

local leds = indication.Leds.new()
local snd = indication.Sound.new()

leds:start()
snd:start()

while true do
    local callback_ok, err = mfrc522.scan(0, function(uid)
        iprint("UID:", uid)
        leds:ok()
        snd:ok()
    end)
    if callback_ok == false then
        eprint("MFRC522: " .. tostring(err))
        leds:err()
        snd:err()
    elseif wdt_on then
        cpu.watchdog.reset()
    end
    thread.sleepms(50)
end

Конструкторы без явных пинов используют настройки конкретной платы, поэтому этот фрагмент подходит и для ODNFC-LAN, и для ODNFC-LAN-C.

Примеры сценариев

Все семь вариантов собраны в каталоге шаблонов программ ODNFC: там можно сравнить сценарии, посмотреть совместимость и скачать отдельный .lua-файл. Ниже подключены те же файлы, поэтому код в документации и скачиваемый шаблон не расходятся. Основной вариант — передача UID по UDP.

local get, sleepms = Settings.get, thread.sleepms

-- Сеть запускается системным кодом по Web-настройкам.
local host, _, _, port = net.parseUrl(get("net_dest"))
local wdt_on = get("sys_wdt") == "on"

local leds = indication.Leds.new()
local snd = indication.Sound.new()

leds:start()
snd:start()

local function on_uid(uid)
    net.udp.sendto(host, port, uid)
    iprint("UDP sent:", uid)
    leds:ok()
    snd:ok()
end

local function iteration()
    local ok, err = mfrc522.scan(0, on_uid)
    if ok == false then error(err, 0) end
end

while true do
    if wdt_on then cpu.watchdog.reset() end

    local ok, err = pcall(iteration)
    if not ok then
        local message = tostring(err)
        if message:find("interrupted!", 1, true) then
            error(err, 0)
        end
        eprint("Main loop: " .. message)
        leds:err()
        snd:err()
        sleepms(250)
    else
        sleepms(50)
    end
end

local get, sleepms = Settings.get, thread.sleepms

-- В net_dest укажите адрес и UDP-порт получателя, например:
-- 192.168.1.10:9000
local host, _, _, port = net.parseUrl(get("net_dest"))
local osc_address = "/odnfc/uid"
local wdt_on = get("sys_wdt") == "on"

local leds = indication.Leds.new()
local snd = indication.Sound.new()

leds:start()
snd:start()

local function on_uid(uid)
    local message = osc.make(osc_address, "s", uid)
    net.udp.sendto(host, port, message)

    iprint("OSC sent:", osc_address, uid)
    leds:ok()
    snd:ok()
end

local function iteration()
    local ok, err = mfrc522.scan(0, on_uid)
    if ok == false then error(err, 0) end
end

while true do
    if wdt_on then cpu.watchdog.reset() end

    local ok, err = pcall(iteration)
    if not ok then
        local message = tostring(err)
        if message:find("interrupted!", 1, true) then
            error(err, 0)
        end
        eprint("Main loop: " .. message)
        leds:err()
        snd:err()
        sleepms(250)
    else
        sleepms(50)
    end
end

local get, sleepms = Settings.get, thread.sleepms

-- В net_dest укажите полный URL, например:
-- http://192.168.1.10:5000/check
local host, path, ssl, port = net.parseUrl(get("net_dest"))
local wdt_on = get("sys_wdt") == "on"

-- Проверьте пин и активный уровень на своей ревизии устройства.
local lock_pin = pio.GPIO32
pio.pin.setdir(pio.OUTPUT, lock_pin)

local function lock() pio.pin.setval(1, lock_pin) end
local function unlock() pio.pin.setval(0, lock_pin) end

lock()

local leds = indication.Leds.new()
local snd = indication.Sound.new()

leds:start()
snd:start()

local function pulse_lock()
    unlock()
    local ok, err = pcall(sleepms, 500)
    lock()
    if not ok then error(err, 0) end
end

local separator = path:find("?", 1, true) and "&" or "?"

local function on_uid(uid)
    if wdt_on then cpu.watchdog.reset() end
    local code = net.http.get(
        host,
        path .. separator .. "uid=" .. uid,
        nil,
        nil,
        ssl,
        port,
        1000,
        3
    )

    if code == 200 then
        pulse_lock()
        leds:ok()
        snd:ok()
    else
        wprint("Access denied: " .. uid .. ", HTTP " .. tostring(code))
        leds:err()
        snd:err()
    end
end

local function iteration()
    local ok, err = mfrc522.scan(0, on_uid)
    if ok == false then error(err, 0) end
end

while true do
    if wdt_on then cpu.watchdog.reset() end

    local ok, err = pcall(iteration)
    if not ok then
        lock()
        local message = tostring(err)
        if message:find("interrupted!", 1, true) then
            error(err, 0)
        end
        eprint("Main loop: " .. message)
        leds:err()
        snd:err()
        sleepms(250)
    else
        sleepms(50)
    end
end

from bottle import route, run, request

@route('/<path:path>')
def show_params(path):
    params = request.query.decode()
    print(f"Path: {path}")
    print("Parameters:")
    for key, value in params.items():
        print(f"  {key}: {value}")
    return "Parameters received"

run(host='0.0.0.0', port=5000, debug=True)

local get, sleepms = Settings.get, thread.sleepms
local wdt_on = get("sys_wdt") == "on"

-- Проверьте пин и активный уровень на своей ревизии устройства.
local lock_pin = pio.GPIO32
pio.pin.setdir(pio.OUTPUT, lock_pin)

local function lock() pio.pin.setval(1, lock_pin) end
local function unlock() pio.pin.setval(0, lock_pin) end

lock()

local allowed = {
    ["04A1B2C3"] = true,
    ["11223344"] = true,
}

local leds = indication.Leds.new()
local snd = indication.Sound.new()

leds:start()
snd:start()

local function pulse_lock()
    unlock()
    local ok, err = pcall(sleepms, 500)
    lock()
    if not ok then error(err, 0) end
end

local function on_uid(uid)
    if allowed[uid] then
        pulse_lock()
        leds:ok()
        snd:ok()
    else
        wprint("Access denied: " .. uid)
        leds:err()
        snd:err()
    end
end

local function iteration()
    local ok, err = mfrc522.scan(0, on_uid)
    if ok == false then error(err, 0) end
end

while true do
    if wdt_on then cpu.watchdog.reset() end

    local ok, err = pcall(iteration)
    if not ok then
        lock()
        local message = tostring(err)
        if message:find("interrupted!", 1, true) then
            error(err, 0)
        end
        eprint("Main loop: " .. message)
        leds:err()
        snd:err()
        sleepms(250)
    else
        sleepms(50)
    end
end

local get, sleepms = Settings.get, thread.sleepms

-- В net_dest укажите адрес и порт брокера, например:
-- broker.example.com:1883
local host, _, ssl, port = net.parseUrl(get("net_dest"))
local topic = "/odnfc/uid"
local client_id = "odnfc-" .. cpu.getmac(0, 1)
local wdt_on = get("sys_wdt") == "on"

local leds = indication.Leds.new()
local snd = indication.Sound.new()
local use_umqtt = umqtt ~= nil
local client

-- ODNFC-LAN использует uMQTT, ODNFC-LAN-C — модуль MQTT на ESP-MQTT.
if use_umqtt then
    client = umqtt.new(
        client_id,
        host,
        port,
        nil,
        nil,
        ssl == true,
        60
    )
elseif mqtt ~= nil then
    client = mqtt.client(client_id, host, port, ssl == true)
else
    error("MQTT module is not available in this firmware", 0)
end

local connected_once = false

leds:start()
snd:start()

local function connect()
    if client:connected() then return end

    if use_umqtt then
        if connected_once then
            local reconnected, reconnect_err = client:reconnect()
            if not reconnected then
                error("MQTT reconnect failed: " .. tostring(reconnect_err), 0)
            end
            return
        end

        local session, err = client:connect(true, 3000)
        if session == nil then
            error("MQTT connect failed: " .. tostring(err), 0)
        end
        connected_once = true
        return
    end

    -- mqtt.connect имеет собственный ограниченный таймаут 20 секунд, который
    -- длиннее 5-секундного task watchdog штатной прошивки ODNFC-LAN-C.
    if wdt_on then cpu.watchdog.remove() end
    local ok, err = pcall(client.connect, client, "", "", true)
    if wdt_on then cpu.watchdog.add() end
    if not ok then error(err, 0) end
end

local function on_uid(uid)
    if wdt_on then cpu.watchdog.reset() end
    connect()
    if wdt_on then cpu.watchdog.reset() end

    if use_umqtt then
        local sent, err = client:publish(topic, uid, false, 0)
        if not sent then
            error("MQTT publish failed: " .. tostring(err), 0)
        end
    else
        client:publish(topic, uid, mqtt.QOS0, false)
    end

    iprint("MQTT sent:", uid)
    leds:ok()
    snd:ok()
end

local function iteration()
    local ok, err = mfrc522.scan(0, on_uid)
    if ok == false then error(err, 0) end
end

while true do
    if wdt_on then cpu.watchdog.reset() end

    local ok, err = pcall(iteration)
    if not ok then
        local message = tostring(err)
        if message:find("interrupted!", 1, true) then
            error(err, 0)
        end
        eprint("Main loop: " .. message)
        leds:err()
        snd:err()
        sleepms(1000)
    else
        sleepms(50)
    end
end

# Подписаться на топик
mosquitto_sub -h broker.example.com -t "/odnfc/uid" -v

local get, sleepms = Settings.get, thread.sleepms
local wdt_on = get("sys_wdt") == "on"

local leds = indication.Leds.new()
local snd = indication.Sound.new()

leds:start()
snd:start()

-- Потокобезопасное хранилище последнего UID.
local mutex = thread.createmutex()
local last_uid = ""

local function set_uid(uid)
    mutex:lock()
    last_uid = uid
    mutex:unlock()
end

local function take_uid()
    mutex:lock()
    local uid = last_uid
    last_uid = ""
    mutex:unlock()
    return uid
end

-- Вызывается системным Web-обработчиком:
-- http://<ip-считывателя>/backend?action=get
function http_get()
    return take_uid()
end

local function on_uid(uid)
    set_uid(uid)
    leds:ok()
    snd:ok()
end

local function iteration()
    local ok, err = mfrc522.scan(0, on_uid)
    if ok == false then error(err, 0) end
end

while true do
    if wdt_on then cpu.watchdog.reset() end

    local ok, err = pcall(iteration)
    if not ok then
        local message = tostring(err)
        if message:find("interrupted!", 1, true) then
            error(err, 0)
        end
        eprint("Main loop: " .. message)
        leds:err()
        snd:err()
        sleepms(250)
    else
        sleepms(50)
    end
end

local get, sleepms = Settings.get, thread.sleepms

-- Сеть запускается системным кодом по Web-настройкам.
local host, _, ssl, port = net.parseUrl(get("net_dest"))
local wdt_on = get("sys_wdt") == "on"

local leds = indication.Leds.new()
local snd = indication.Sound.new()

leds:start()
snd:start()

local function on_uid(uid)
    if wdt_on then cpu.watchdog.reset() end
    local sent = net.tcp.sendto(host, port, uid, 3, ssl == true)
    if not sent then error("TCP send failed", 0) end

    iprint("TCP sent:", uid)
    leds:ok()
    snd:ok()
end

local function iteration()
    local ok, err = mfrc522.scan(0, on_uid)
    if ok == false then error(err, 0) end
end

while true do
    if wdt_on then cpu.watchdog.reset() end

    local ok, err = pcall(iteration)
    if not ok then
        local message = tostring(err)
        if message:find("interrupted!", 1, true) then
            error(err, 0)
        end
        eprint("Main loop: " .. message)
        leds:err()
        snd:err()
        sleepms(250)
    else
        sleepms(50)
    end
end

Дополнительные рецепты

Отправка почты

Рассчитано на версию PRO — в остальных может не заработать (зависит от нагрузки и сертификатов почтового сервера).

-- имя и порт почтового сервера
net.curl.mailserver("smtp.адрес.сервера", 465)

options = {
    user = "логин",
    pass = "пароль",
    to = {"получатель1", "получатель2"},
    subj = "Тема",
    msg = "Тестовая посылка",
    secure = true,
    attach = {"picture.jpg"}
}

ret, msg = net.curl.sendmail(options)

Добавление UID с сервера по HTTP GET

-- host, path, content-type, headers, ssl_en
local code, chunks = net.http.get(
    "192.168.0.160",
    "/userlist.txt",
    "text/plain",
    nil,
    false
)

if code == 200 and chunks then
    local file = assert(io.open("userlist.txt", "a"))
    -- "a" — append для текстового списка;
    -- большой список экономнее хранить как uint32 UID в бинарном виде
    file:write(table.concat(chunks))
    file:close()
end

Отправка UDP и TCP

--- udp ---
net.udp.sendto("192.168.68.110", 5555, "hello")

--- tcp ---
net.tcp.sendto("192.168.68.110", 5555, "hello")

Добавление UID с сервера по UDP

Аналогично можно пополнять список через MQTT или HTTP.

local socket = net.udp.bind(5555)

while true do
    local from_ip, from_port, data = socket:readfrom(1024)
    if from_ip then
        iprint(from_ip, from_port, data)
        local file = assert(io.open("userlist.txt", "a"))
        file:write(data, "\n")
        file:close()
    end
    thread.sleepms(100)
end

TCP-сервер

Доступен с прошивки 1.5.0. Данные могут приходить дроблёными — буферизируйте их и собирайте в обработчике. Передаются «как есть», могут включать непечатаемые символы и 0 (для Lua-строк это нормально).

local SERVER_PORT = 8080

local function handle_client(client_ip, data)
    -- убираем перевод строки
    local clean_data = data:gsub("\r", ""):gsub("\n", "")
    iprint("client: " .. client_ip)
    iprint("вы ввели: " .. clean_data)
end

iprint("Запуск TCP сервера на порту", SERVER_PORT)
-- false оставляет вывод iprint в окне «Информация»
net.tcpserv.start(SERVER_PORT, handle_client, 60, false)

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

• Строка форматирования — как читать данные с карты, а не только UID.
• mfrc522.scan — форматы результата, функции-обработчики и режимы обслуживания считывателя.
• PIO — прямое управление входами и выходами.
• Сеть — HTTP, UDP, TCP и сетевые интерфейсы.
• Консоль — работа с файловой системой, редактором и дополнительными библиотеками.
• Пример: Modbus TCP.

История обновлений 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()