LuaTerm Mini: инструкция и сценарии применения

Веб-интерфейс нужен для штатной настройки, просмотра состояния и редактирования пользовательской программы. Если браузер блокирует незащищённый WebSocket или смешанный HTTP/HTTPS-контент, откройте интерфейс устройства по HTTP в доверенной локальной сети либо подключитесь через USB-консоль. Не ослабляйте глобальные настройки безопасности браузера.

Основной экран

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

Настройки

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

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

Редактор кода

Редактор изменяет usercode.lua, который стартует автоматически. Для небольших проектов этого достаточно. Если проект разрастается, используйте USB-консоль и файловую систему устройства.

Система и обновление

Экран «Система» показывает сведения об устройстве и используется для локального обновления прошивки. После перезагрузки подождите несколько секунд и обновите страницу браузера, чтобы она заново установила соединение с контроллером.

Сторожевой таймер для терминала

Базовая программа повторяет логику USB WatchDog: LuaTerm ждёт признак, что контролируемый объект жив, и при пропаже сигнала нажимает Reset или Power.

Сигналом может быть:

• строка ~U\n по USB;
• успешный ping или HTTP-запрос по Wi-Fi;
• дискретный вход, например от лампы HDD или внешнего контроллера.

Если включено несколько условий, ответ считается успешным, когда выполнены все включённые проверки.

UNITX / телеметрия

Сценарий для сбора температуры и влажности, записи отчётов и отправки данных на сервер. Его удобно использовать как основу для MQTT, TCP/UDP, Telegram-бота или локального HTTP API.

GPIO Extender

LuaTerm можно использовать как сетевой или USB GPIO-контроллер: читать 3 входа, управлять 3 выходами, опрашивать датчики и отдавать состояние по HTTP или USB.

Как менять программу

1. Откройте веб-интерфейс и перейдите в редактор.
2. Измените usercode.lua.
3. Сохраните файл и перезапустите программу или устройство.
4. Смотрите сообщения на основном экране, в логах или USB-консоли.

Для экспериментов с файловой системой и отладкой используйте терминал по USB: PuTTY, picocom, minicom, screen или pyserial-miniterm.

Что есть в Lua-среде

• GPIO, таймеры, UART и работа с датчиками;
• сетевые сокеты TCP/UDP;
• HTTP/MQTT-сценарии через библиотеки;
• файловая система и локальные логи;
• дополнительные Lua-файлы, загружаемые вместе с проектом;
• Telnet и SSH в Pro-версии.

Менеджер пакетов repo в прошивку LuaTerm Mini не входит. Загрузите проверенную библиотеку в файловую систему устройства и подключите через require.

Первые примеры

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

1. Проверить запуск и посмотреть ресурсы

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

print("usercode.lua started")
print("device:", board, subtype, brand)

while true do
    print("uptime_ms:", os.uptime(2), "free_memory:", cpu.memfree())
    thread.sleep(10)
end

Сначала убедитесь, что сообщение появляется в консоли, а uptime_ms растёт. Этот пример не обращается к выводам и безопасен для проверки редактора и автозапуска.

2. Проверять доступность узла по сети

Замените TARGET на адрес роутера, терминала или сервера в своей сети.

local TARGET = "192.168.1.1"

while true do
    local status_ok, connected = pcall(net.connected)
    if not status_ok then
        print("network status error:", connected)
    elseif connected then
        local request_ok, response_ms = pcall(net.mping, TARGET)
        if request_ok and response_ms > 0 then
            print("host online:", TARGET, response_ms, "ms")
        elseif request_ok then
            print("host did not answer:", TARGET)
        else
            print("ping error:", response_ms)
        end
    else
        print("network is not ready")
    end
    thread.sleep(5)
end

Это минимальная основа сетевого сторожевого таймера: сначала добейтесь стабильной проверки и только затем добавляйте управление Reset или Power.

3. Отправлять состояние по UDP

Параметры хранятся в NVS через модуль settings. Глобальный объект Settings в этом примере не используется.

local make_settings = require("settings")

local cfg = make_settings("luaterm_heartbeat", {
    host = "192.168.1.10",
    port = 5555,
    interval = 10,
})
local options = cfg.load()

while true do
    local payload = string.format(
        "uptime_ms=%d free_memory=%d",
        os.uptime(2),
        cpu.memfree()
    )
    local sent, err = pcall(
        net.udp.sendto,
        options.host,
        options.port,
        payload
    )
    if sent then
        print("sent:", payload)
    else
        print("UDP error:", err)
    end
    thread.sleep(options.interval)
end

Значения по умолчанию записываются при первом запуске. Позже меняйте их через cfg.set("host", "192.168.1.20") и cfg.set("port", 5556) либо вызовите cfg.restore(), чтобы снова применить значения по умолчанию из программы.

Восстановление доступа

Если устройство стало недоступно из-за неверных настроек или ошибочного кода:

1. Выключите питание.
2. Замкните контакты HARD RESET на плате.
3. Подайте питание, удерживая контакты замкнутыми несколько секунд.
4. Устройство создаст Wi-Fi сеть вида OD-[серийный номер] без пароля.
5. Откройте 192.168.4.1 и исправьте настройки или код.

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

• Справочник CPU — плата, память и служебные данные.
• Потоки и паузы.
• Сеть — состояние интерфейсов, ping, HTTP, UDP и TCP.
• settings.lua — пользовательские параметры в NVS.
• GPIO — прямое управление пинами; перед использованием сверяйте их с назначением выводов конкретной платы.