Отладочный порт

Версия от 14:27, 19 августа 2020; Fizikdaos (обсуждение | вклад)



Контроллеры Wiren Board имеют отладочный порт, через который можно получить прямой доступ к консоли контроллера. Через него можно взаимодействовать с загрузчиком и следить за загрузкой операционной системы (последовательная консоль, serial console). Другие способы подключения к контроллеру: через веб-интерфейс, по SSH.

Подключение к отладочному порту контроллеров Wiren Board 6, Wiren Board 5.8 и Wiren Board 5.9

 
Разъем Debug Console Wiren Board 5.8 и 5.9
 
Разъем Debug Console Wiren Board 6
 
Кабель USB — Micro-USB
 
Номер порта в Windows

На корпусе напротив разъема порта отладочной консоли находится надпись Debug Console.

Подключается стандартным кабелем USB (A) — Micro-USB (B) - такой же, как для сотовых телефонов. Разъемом USB (А) - к компьютеру, Micro-USB (B) — к контроллеру.

Кабели от зарядных устройств подходят, но бывают исключения. Лучше выбирать такие, на которых указано, что они предназначены для передачи данных. Если кабель выбран правильно, Windows сообщит звуком об обнаружении устройства.

Драйвера адаптеров и названия виртуальных COM-портов

Внутри контроллера установлен переходник USB-UART.

  • Linux: адаптер обычно определяется автоматически, при подключении в выводе команды dmesg должна появиться строка usb 1-1: ch341-uart converter now attached to ttyUSB0 или (для версий контроллера 6.4 и старше) cdc_acm:3-6:1.0: ttyACM0: USB ACM device. Номер порта ttyUSBx или ttyACMx может меняться, в зависимости от уже подключенных устройств. Смотрите список файлов в папке /dev/ . Консольный порт контроллеров новых версий 6.4 и старше определяется автоматически как устройство /dev/ttyACM0. Смотрите также раздел Настройка работы отладочного порта в Linux для WB6.4 и выше.
  • macOS: Начиная с High Sierra отладочная консоль контроллеров определяется из коробки. Предыдущие версии операционной системы, возможно, потребуют установки драйверов. При подключении создается устройство /dev/tty.usbserial-1410 или /dev/tty.usbmodem00001 (для контроллеров версии 6.4 и старше).
  • Android: Поздние версии Android при подключении через OTG поддерживают отладочную консоль контроллеров без дополнительных драйверов. Тестировалось с приложением USB Serial Console.

Поддержка в операционных системах:

Версия контроллера Linux Windows XP, 7, 8 Windows 10 MacOS X (High Sierra) Android 9 + USB Serial Console
6.4 и старше Модуль ядра cdc_acm (все новые дистрибутивы — из коробки),

смотрите дополнительную информацию по настройке порта

Необходим драйвер HT42B534 Из коробки Из коробки Из коробки
5.8 - 5.9, 6.0 - 6.3 Модуль ядра ch341 (все новые дистрибутивы — из коробки) Необходим драйвер CH341SER [CH341SER_MAC.ZIP]

Настройка работы отладочного порта в Linux для WB6.4 и выше

Суть проблемы: на некоторых системах процесс ModemManager автоматически открывает устройство /dev/ttyACM0. Чтобы ModemManager не мешал работе с портом, его надо отключить для этого устройства с помощью правил udev.

  • Создать файл исключений udev:
 sudo nano /etc/udev/rules.d/99-wb-debug-usb.rules
  • в который записать cтрочку:
 ATTRS{idVendor}=="04d9" ATTRS{idProduct}=="b534", ENV{ID_MM_DEVICE_IGNORE}="1"
  • После сохранения файла перезагрузить правило udev:
 sudo udevadm control --reload-rules

Переходите к настройке работы с последовательным портом.

Отладочный порт в старых версиях

Подключение к отладочному порту в Wiren Board 5.6 и младше

Настройка работы с последовательным портом

Установка программы для работы с последовательным портом

Для работы с последовательным портом установите на вашем компьютере подходящую утилиту - например, PuTTY:

  • версия для Windows - скачать с официального сайта
  • версия для Linux Debian или Ubuntu - выполните команду apt-get install putty
  • версия для macOS и инструкция по установке: PuTTY for Mac OS X, возможно использование терминального клиента cu, например
cu -s 115200 -l /dev/usbmodem00001

.

Подойдут также другие программы.

Настройки соединения: 115200 8N1 (115200 кбит/с, 8 бит, нет бита чётности, один стоп-бит), root/wirenboard.

Подключение

  1. Запустите приложение от имени администратора:
    • в Windows - щёлкните по значку PuTTY правой кнопкой и выберите Run This Program As An Administrator
    • в Linux - gksu putty

  2. В меню слева выберите последний пункт - Serial. В появившиеся поля справа введите настройки порта:
    • название последовательного порта
      • для Windows - это COM4 (цифра может меняться, см.выше)
      • для Linux - это /dev/ttyUSB0 либо /dev/ttyACM0 (для WB6.4 и выше). Цифра может меняться, см.выше.
    • скорость - 115200
    • количество битов в посылке - 8
    • количество стоп-битов - 1
    • чётность - нет
    • контроль потока - нет

     

  3. В меню слева выберите первый пункт - Session. Справа переключите тип подключения на Serial - должны автоматически заполниться настройки порта. Затем нажмите Open.

     

  4. Чтобы проверить, правильно ли вы всё сделали:
    • для Wiren Board 5.8 и старше: нажмите Enter. Будет предложена авторизация.
    • для Wiren Board 5.6 и младше, до версии 2.8 включительно: кнопкой выключите и включите контроллер - на экране должны появиться сообщения о загрузке.
      • запрос логина - введите root и нажмите Enter,
      • запрос пароля - введите wirenboard (вводимые символы не будут отображаться) и нажмите Enter.

  2. Появится приветственное сообщение - вы в консоли контроллера. Для перехода в визуальный файловый менеджер введите mc.

     

Физическая реализация отладочной консоли в контроллерах Wiren Board

Версия коннтроллера Тип разъема Название разъема Интерфейс Чип USB/UART
6.4 и старше Micro-USB Debug Console USB/UART HT42B534
6.0 - 6.3, 5.8 - 5.9 USB/UART CH340
5.6.1 3-pin UART (Gnd, Rx, Tx) UART UART (3,3 В) —
5.3, 4 Debug UART
3.5, 2.8 3-pin UART (Gnd, Tx, Rx) UEXT1 (выводы 2,3,4) и 3-pin разъем без названия

Программно во всех случаях это последовательный порт.

Источник — https://wirenboard.com/wiki/index.php?title=Debug_Console&oldid=41743