С3: USB-консоль
Сервисная консоль контроллера С3 через USB: вывод программы, управление Lua, консольный редактор, сетевые настройки, пароль и модули расширения.
USB-консоль нужна при разработке и обслуживании: в ней видны сообщения программы и системы, отсюда можно остановить программу, выполнить строку Lua, отредактировать файл и вернуть доступ к контроллеру, если сеть настроена неверно. Консоль работает независимо от Ethernet и веб-интерфейса.
Подключение
- Подайте на С3 рабочее питание и подключите его к компьютеру кабелем Micro-USB.
- Контроллер определится как виртуальный COM-порт UnitX C3 USB CDC:
COMxв Windows,/dev/ttyACM0в Linux,/dev/cu.usbmodem…в macOS. В Windows 10 и 11 драйвер не нужен; для старых версий есть инструкция по CDC-драйверу. - Откройте порт в терминале. Скорость можно указать любую, например 115200. Нужны кодировка UTF-8 и поддержка ANSI-последовательностей; для консольного редактора отключите программное управление потоком (XON/XOFF).
- Нажмите Enter — появится приглашение
shell:~$.
Подойдут PuTTY, Tera Term, picocom, minicom, screen и
pyserial-miniterm. Например, в Linux:
picocom -b 115200 /dev/ttyACM0
Клавиша Tab дополняет команды и показывает подкоманды, help выводит список
команд.
Вывод программы
Всё, что программа печатает через print(), и системные сообщения выводятся в
консоль. Ошибки программы видны здесь с номером строки:
[00:00:15.262,000] <inf> odkit_lua_runtime: Lua generation 2 started from /lfs/main.lua
Модуль выходов в слоте 2
IO7 = 1, канал 1: true
[00:00:40.293,000] <err> odkit_lua_runtime: Lua runtime error, restart in 1 s: /lfs/main.lua:4: attempt to index a nil value (local 't')
Число в квадратных скобках — время с момента включения.
Управление программой
| Команда | Действие |
|---|---|
lua status | состояние программы, число задач, перезапусков и текст последней ошибки |
lua stop | остановить программу и освободить клеммы IO и порты; реле и выходы модулей расширения остаются в прежнем состоянии |
lua start | запустить /lfs/main.lua |
lua reload | проверить и перезапустить /lfs/main.lua после правки в консольном редакторе |
lua eval "код" | выполнить строку Lua в работающей программе и показать результат |
lua run /lfs/файл.lua | выполнить файл, например тест или разовую настройку |
shell:~$ lua status
state=2 (running) generation=1 tasks=1 restarts=0 last_error=0
shell:~$ lua stop
shell:~$ lua status
state=0 (stopped) generation=1 tasks=0 restarts=0 last_error=0
Состояния программы:
| Состояние | Значение |
|---|---|
running | программа работает |
stopped | программа остановлена командой или не запускалась |
backoff | после ошибки программа ждёт перезапуска: 1, 2, 4, 8 или 16 секунд |
recovery | пять ошибок за минуту: программа остановлена до lua start или сохранения исправленной версии |
shell:~$ lua status
state=5 (recovery) generation=7 tasks=0 restarts=5 last_error=-14
last_message=/lfs/main.lua:4: attempt to index a nil value (local 't')
Команда lua eval
lua eval выполняет код в той же среде, что и программа: доступны её
глобальные переменные, модули и устройства. Команда показывает первое
возвращённое значение:
shell:~$ lua eval "return require('zephyr.sys').memory().current"
16617
shell:~$ lua eval "return require('odkit.unit').open(2):set(1, true)"
true
Ограничения:
- вся строка команды — до 255 байт, символ кириллицы занимает 2 байта;
длинный код сохраните в файл и запустите через
lua run; - код выполняется сразу и не должен работать долго: бесконечный цикл
прерывается ошибкой
command instruction limit exceeded; - для действий с паузами запустите задачу: команда вернёт её номер, а задача продолжит работу в программе.
lua eval "return require('zephyr.task').spawn(function() ... end)"
Вставляйте в консоль короткие команды. При быстрой вставке длинного текста консоль может потерять символы — файлы и программы загружайте через веб-интерфейс.
Консольный редактор
Команда edit открывает текстовый файл во встроенной памяти прямо в
терминале:
edit /lfs/main.lua
edit /lfs/notes.txt 120 40
Необязательные числа — ширина и высота окна, если терминал сам их не сообщает.
| Клавиши | Действие |
|---|---|
| Стрелки, Page Up, Page Down | перемещение по тексту |
| Home или Ctrl+A, End или Ctrl+E | начало и конец строки |
| Ctrl+S | сохранить файл |
| Ctrl+Q или Ctrl+X | выйти; второе нажатие выходит без сохранения |
| Ctrl+L | перерисовать экран после изменения размера окна |
Редактор поддерживает кириллицу и вставку текста, размер файла — до 16 КБ. Он
только сохраняет файл и не проверяет синтаксис: после правки main.lua выйдите
из редактора и выполните lua reload. При синтаксической ошибке команда
покажет её, а в памяти продолжит работать прежняя версия программы. Исправьте
файл сразу: с ошибкой в main.lua программа не запустится после следующего
включения.
shell:~$ lua reload
Lua reload failed: -22 /lfs/main.lua:1: 'end' expected near <eof>
Сеть, время и пароль
| Команда | Действие |
|---|---|
net_config | показать сохранённые настройки сети и времени |
net_config dhcp | получать адрес по DHCP |
net_config static 192.168.1.50 255.255.255.0 192.168.1.1 | статический адрес, маска и шлюз |
net_config ntp 162.159.200.1 | NTP-сервер по IPv4-адресу; net_config ntp off — без синхронизации |
net_config tz +3 | часовой пояс, например +3, -3:30 или 0 |
http_auth status | включён ли пароль веб-интерфейса |
http_auth set пароль | задать пароль пользователя admin |
http_auth off | снять пароль |
kernel reboot cold | перезапустить контроллер |
Настройки сети и времени применяются после перезапуска:
shell:~$ net_config
Address: DHCP
NTP: off
Time zone: UTC+00:00
shell:~$ net_config static 192.168.1.50 255.255.255.0 192.168.1.1
shell:~$ kernel reboot cold
Модули расширения
| Команда | Действие |
|---|---|
unit_slots | модули, определённые при включении |
unit_slots 2 display | назначить слоту 2 дисплей после перезапуска |
unit_slots 0 display | снять ручное назначение дисплея |
unit_flash 1 /lfs/файл.ufw | обновить программу модуля в слоте 1 из файла обновления |
shell:~$ unit_slots
1: display ID=255 version=255.255.255.255 configured=display error=0
2: unit ID=1 version=2.0.0.1 configured=auto error=0
Файл обновления модуля предоставляет поддержка UnitX. Загрузите его в
раздел «Файлы» веб-интерфейса и выполните unit_flash. Контроллер проверит файл
целиком до начала записи, а после обновления дождётся ответа модуля.
Не выключайте питание во время обновления.