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

From Wiren Board
This is the approved revision of this page, as well as being the most recent.
Other languages:


Описание

У контроллеров Wiren Board есть отладочный порт, через который можно получить доступ к консоли контроллера. Через него можно взаимодействовать с загрузчиком, следить за загрузкой операционной системы.

Отладочный порт — это инструмент доступа к контроллеру, когда вы не можете подключиться к нему через веб-интерфейс или по SSH. Мы не рекомендуем его для постоянного использования.

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

Контроллеры Wiren Board 5.8, 5.9, 6.x и 7.x

Номер порта в Windows
Кабель USB (A) - Micro-USB (B)
Кабель USB (A) - USB-C

Разъём отладочного порта подписан на корпусе контроллера как Debug Console.

В зависимости от версии контроллера, для подключения используйте стандартный кабель от смартфонов:

  • Wiren Board 5.8, 5.9 и 6 — USB (A) - Micro-USB (B).
  • Wiren Board 7 — USB (A) - USB-C.

Разъём USB (A) подключается к компьютеру, а Micro-USB (B) или USB-C — к контроллеру.

Кабели от зарядных устройств подходят, но бывают исключения. Лучше выбирать такие, на которых указано, что они предназначены для передачи данных. Если кабель выбран правильно, 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.
    Смотрите также раздел Особенности подключения к WB6.4 и новее из Linux.
  • Windows: может потребоваться установка драйвера (см. таблицу Поддержка в операционных системах). В Диспетчере устройств в разделе Ports(COM&LPT) появится виртуальный COM-порт контроллера.
  • 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
7.x
6.4 – 6.9
Модуль ядра cdc_acm (все новые дистрибутивы — из коробки), Нужны inf файлы: Медиа:HT42B534_inf.zip Из коробки Из коробки Из коробки
6.0 - 6.3
5.8 - 5.9,
Модуль ядра ch341 (все новые дистрибутивы — из коробки) Нужен драйвер CH341SER CH341SER_MAC

Особенности подключения к WB6.4 и новее из Linux

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

  1. Создайте файл исключений udev:
     sudo nano /etc/udev/rules.d/99-wb-debug-usb.rules
    
  2. Добавьте в него строчку:
     ATTRS{idVendor}=="04d9" ATTRS{idProduct}=="b534", ENV{ID_MM_DEVICE_IGNORE}="1"
    
  3. После сохранения файла перезагрузите правило udev:
     sudo udevadm control --reload-rules
    
  4. В свежих операционных системах может понадобиться отредактировать файл /lib/systemd/system/ModemManager.service. Смотрите подробнее по ссылкам: ModemManager does not honor blacklisted ttys и SystemD ModemManager: failed to set dtr/rts.

Параметры подключения

Параметры подключения к Debug-консоли контроллера Wiren Board
Параметр Значение Описание
Serial Port
  • Windows — COMx
  • Linux — /dev/ttyACM0 или до версии WB6.4 — /dev/ttyUSB0
Подробнее смотрите выше в этой статье
Baud rate 115200 Скорость, бит/с
Data bits 8 Количество битов данных
Parity None Бит чётности
Stop bits 1 Количество стоповых битов
Hardware flow control None Аппаратный контроль потока
Software flow control None Программный контроль потока

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

Версия контроллера Тип разъема Название разъема Интерфейс Чип USB/UART
7.x USB-C Debug Console USB/UART HT42B534
6.4–6.9 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 разъем без названия

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

Контроллеры Wiren Board ≤5.6

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