Перейти к содержанию

С3: USB-консоль

Сервисная консоль контроллера С3 через USB: вывод программы, управление Lua, консольный редактор, сетевые настройки, пароль и модули расширения.

USB-консоль нужна при разработке и обслуживании: в ней видны сообщения программы и системы, отсюда можно остановить программу, выполнить строку Lua, отредактировать файл и вернуть доступ к контроллеру, если сеть настроена неверно. Консоль работает независимо от Ethernet и веб-интерфейса.

Подключение

  1. Подайте на С3 рабочее питание и подключите его к компьютеру кабелем Micro-USB.
  2. Контроллер определится как виртуальный COM-порт UnitX C3 USB CDC: COMx в Windows, /dev/ttyACM0 в Linux, /dev/cu.usbmodem… в macOS. В Windows 10 и 11 драйвер не нужен; для старых версий есть инструкция по CDC-драйверу.
  3. Откройте порт в терминале. Скорость можно указать любую, например 115200. Нужны кодировка UTF-8 и поддержка ANSI-последовательностей; для консольного редактора отключите программное управление потоком (XON/XOFF).
  4. Нажмите 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.1NTP-сервер по 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. Контроллер проверит файл целиком до начала записи, а после обновления дождётся ответа модуля. Не выключайте питание во время обновления.