Debug Console: различия между версиями
(не показаны 44 промежуточные версии 4 участников) | |||
Строка 1: | Строка 1: | ||
{{DISPLAYTITLE:Отладочный порт | |||
<languages/> | |||
<translate> | |||
<!--T:109--> | |||
{{DISPLAYTITLE:Отладочный порт}} | |||
<!--T:100--> | |||
== Описание == | == Описание == | ||
У контроллеров Wiren Board есть отладочный порт. | У контроллеров Wiren Board есть отладочный порт, через который можно получить доступ к консоли контроллера. Через него можно взаимодействовать с загрузчиком, следить за загрузкой операционной системы. | ||
<gallery mode="packed" caption="" heights="150px" | |||
Отладочный порт — это инструмент доступа к контроллеру, когда вы не можете подключиться к нему через [[Веб-интерфейс Wiren Board | веб-интерфейс]] или по [[SSH | SSH]]. Мы не рекомендуем его для постоянного использования. | |||
== Контроллеры Wiren Board 5.8, 5.9, 6.x и 7.x == <!--T:104--> | |||
<gallery mode="packed" caption="Расположение разъёма Debug Console на контроллерах Wiren Board" heights="150px"> | |||
Image: WirenBoard7DebugConsole.png | Wiren Board 7.x | Image: WirenBoard7DebugConsole.png | Wiren Board 7.x | ||
Image: WirenBoard6DebugConsole.png | Wiren Board 6.x | Image: WirenBoard6DebugConsole.png | Wiren Board 6.x | ||
Строка 8: | Строка 19: | ||
</gallery> | </gallery> | ||
[[Файл:SerialUART_Win.png|250px|thumb|right|Номер порта в Windows]] | |||
[[Файл:USBA-MICROUSBB.png|250px|thumb|right|Кабель USB (A) - Micro-USB (B)]] | |||
[[Файл:USBA-USBC.png|250px|thumb|right|Кабель USB (A) - USB-C]] | |||
Разъём отладочного порта подписан на корпусе контроллера как '''Debug Console'''. | |||
<!--T:115--> | |||
В зависимости от версии контроллера, для подключения используйте стандартный кабель от смартфонов: | |||
* '''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 — к контроллеру. | |||
<!--T:116--> | |||
Кабели от зарядных устройств подходят, но бывают исключения. Лучше выбирать такие, на которых указано, что они предназначены для передачи данных. Если кабель выбран правильно, Windows сообщит звуком об обнаружении устройства. | |||
=== Драйвера адаптеров и названия виртуальных COM-портов === <!--T:117--> | |||
<!--T:118--> | |||
Внутри контроллера установлен переходник USB-UART. | |||
<!--T:119--> | |||
*'''Linux''': адаптер обычно определяется автоматически, при подключении адаптера в выводе команды <code>dmesg</code> должна появиться строка: | |||
*:<syntaxhighlight lang="bash"> | |||
usb 1-1: ch341-uart converter now attached to ttyUSB0 | |||
</syntaxhighlight> | |||
*: или, для версий контроллера 6.4 и младше: | |||
*:<syntaxhighlight lang="bash"> | |||
cdc_acm:3-6:1.0: ttyACM0: USB ACM device | |||
</syntaxhighlight> | |||
*: Номер порта ttyUSBx или ttyACMx может меняться, в зависимости от уже подключенных устройств. Смотрите список файлов в папке <code>/dev/</code>. Консольный порт контроллеров для версий 6.4 и младше определяется автоматически как устройство <code>/dev/ttyACM0</code>. | |||
*: Смотрите также раздел [[#Особенности подключения к WB6.4 и новее из Linux|Особенности подключения к WB6.4 и новее из Linux]]. | |||
<!--T:120--> | |||
*'''Windows''': может потребоваться установка драйвера (см. таблицу [[#os-compatible|Поддержка в операционных системах]]). В Диспетчере устройств в разделе '''Ports(COM&LPT)''' появится виртуальный COM-порт контроллера. | |||
<!--T:121--> | |||
*'''macOS''': начиная с High Sierra отладочная консоль контроллеров определяется из коробки. Предыдущие версии операционной системы, возможно, потребуют установки драйверов. При подключении создается устройство <code>/dev/tty.usbserial-1410</code> или <code>/dev/tty.usbmodem00001</code> (для контроллеров версии 6.4 и младше). | |||
<!--T:122--> | |||
*'''Android''': поздние версии Android при подключении через OTG поддерживают отладочную консоль контроллеров без дополнительных драйверов. Тестировалось с приложением [https://play.google.com/store/apps/details?id=jp.sugnakys.usbserialconsole&hl=en_US USB Serial Console]. | |||
<div id="os-compatible"></div> | |||
{| class="wikitable" | |||
|+ Поддержка в операционных системах | |||
! Версия <br /> контроллера !! Linux !! Windows XP, 7, 8 !! Windows 10 !! MacOS X <br />(High Sierra) !! Android 9 + <br /> USB Serial Console | |||
|- | |||
| 6.4 – 6.9, 7.x || Модуль ядра cdc_acm (все новые дистрибутивы — из коробки), | |||
смотрите [[# Особенности подключения к WB6.4 и новее из Linux | дополнительную информацию по настройке порта]] | |||
| Нужны inf файлы: [[Медиа:HT42B534_inf.zip]] || Из коробки || Из коробки | |||
|rowspan="2" style="text-align:center;"| Из коробки | |||
|- | |||
| 6.0 - 6.3 <br /> 5.8 - 5.9, | |||
| Модуль ядра ch341 (все новые дистрибутивы — из коробки) | |||
|colspan="2" style="text-align:center;"| Нужен драйвер [http://www.wch.cn/downloads/CH341SER_ZIP.html CH341SER] || [http://www.wch.cn/download/ch341ser_mac_zip.html CH341SER_MAC] | |||
|- | |||
|} | |||
=== Особенности подключения к WB6.4 и новее из Linux === <!--T:123--> | |||
На некоторых Linux-системах процесс ''ModemManager'' автоматически открывает устройство <code>/dev/ttyACM0</code>. | |||
Чтобы ModemManager не мешал работе с портом, его надо отключить для этого устройства с помощью правил '''udev''': | |||
# Создайте файл исключений '''udev''': | |||
#:<syntaxhighlight lang="bash"> sudo nano /etc/udev/rules.d/99-wb-debug-usb.rules </syntaxhighlight> | |||
# Добавьте в него строчку: | |||
#:<syntaxhighlight lang="bash"> ATTRS{idVendor}=="04d9" ATTRS{idProduct}=="b534", ENV{ID_MM_DEVICE_IGNORE}="1" </syntaxhighlight> | |||
# После сохранения файла перезагрузите правило '''udev''': | |||
#:<syntaxhighlight lang="bash"> sudo udevadm control --reload-rules </syntaxhighlight> | |||
# В свежих операционных системах может понадобиться отредактировать файл <code>/lib/systemd/system/ModemManager.service</code>. Смотрите подробнее по ссылкам: [https://bugs.launchpad.net/ubuntu/+source/modemmanager/+bug/1827328 ModemManager does not honor blacklisted ttys] и [https://nick.zoic.org/art/failed-to-set-dtr-rts-systemd-modemmanager/ SystemD ModemManager: failed to set dtr/rts]. | |||
=== Параметры подключения и программы === | |||
Для подключения к Debug-консоли контроллера используйте параметры из таблицы ниже и одну из программ, перечисленных в статье [[Serial Port | Работа с последовательным портом]]. | |||
{| border="1" class="wikitable" | {| border="1" class="wikitable" | ||
|+ Параметры | |+ Параметры подключения к Debug-консоли контроллера Wiren Board | ||
! Параметр|| Значение || Описание | ! Параметр|| Значение || Описание | ||
|- | |- | ||
| Serial Port|| | |||
* Windows — COMx | |||
* Linux — /dev/ttyACM0 или до версии WB6.4 — /dev/ttyUSB0 | |||
|| Подробнее смотрите выше в этой статье | |||
|- | |- | ||
| Baud rate || 115200 || Скорость, бит/с | | Baud rate || 115200 || Скорость, бит/с | ||
Строка 52: | Строка 113: | ||
|} | |} | ||
=== | <gallery mode="traditional" widths ="260px" heights="200px"> | ||
Image: Putty serial settings.png | Настройка параметров для подключения к Debug-консоли контроллера в программе [[PuTTY]] | |||
[[ | Image: Putty serial open.png | Открытие сессии в программе [[PuTTY]] | ||
< | Image: Putty serial logged in.png | Приветственное сообщение контроллера при подключении к его Debug-консоли | ||
</gallery> | |||
== Физическая реализация в контроллерах == <!--T:111--> | |||
{| class="wikitable" | |||
! Версия контроллера !! Тип разъема !! Название разъема !! Интерфейс !! Чип USB/UART | |||
== | |||
< | |||
{| | |||
! | |||
! | |||
|- | |- | ||
| 6.4 | | 6.4 и младше | ||
| rowspan="2" | Micro-USB | |||
| rowspan="2" | Debug Console || USB/UART || HT42B534 | |||
|- | |- | ||
| | | 6.0 - 6.3, 5.8 - 5.9 || USB/UART || CH340 | ||
|- | |- | ||
| 5.6.1 || 3-pin UART (Gnd, Rx, | | 5.6.1 | ||
| rowspan="2" | 3-pin UART (Gnd, Rx, Tx) || UART | |||
|rowspan="3" | UART (3,3 В) | |||
|rowspan="3" | — | |||
|- | |- | ||
| | | 5.3, 4 || Debug UART | ||
|- | |- | ||
| 2.8 | | 3.5, 2.8 || 3-pin UART (Gnd, Tx, Rx) || UEXT1 (выводы 2,3,4) и 3-pin разъем без названия | ||
|- | |- | ||
|} | |} | ||
Программно во всех случаях это последовательный порт. | Программно во всех случаях это последовательный порт. | ||
== Контроллеры Wiren Board ≤5.6 == | |||
[[WB5.6_Debug_Console| Подключение к отладочному порту в Wiren Board 5.6 и старее]] | |||
</translate> |
Версия 07:32, 23 февраля 2022
Описание
У контроллеров Wiren Board есть отладочный порт, через который можно получить доступ к консоли контроллера. Через него можно взаимодействовать с загрузчиком, следить за загрузкой операционной системы.
Отладочный порт — это инструмент доступа к контроллеру, когда вы не можете подключиться к нему через веб-интерфейс или по SSH. Мы не рекомендуем его для постоянного использования.
Контроллеры Wiren Board 5.8, 5.9, 6.x и 7.x
Разъём отладочного порта подписан на корпусе контроллера как 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 |
---|---|---|---|---|---|
6.4 – 6.9, 7.x | Модуль ядра 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:
- Создайте файл исключений udev:
sudo nano /etc/udev/rules.d/99-wb-debug-usb.rules
- Добавьте в него строчку:
ATTRS{idVendor}=="04d9" ATTRS{idProduct}=="b534", ENV{ID_MM_DEVICE_IGNORE}="1"
- После сохранения файла перезагрузите правило udev:
sudo udevadm control --reload-rules
- В свежих операционных системах может понадобиться отредактировать файл
/lib/systemd/system/ModemManager.service
. Смотрите подробнее по ссылкам: ModemManager does not honor blacklisted ttys и SystemD ModemManager: failed to set dtr/rts.
Параметры подключения и программы
Для подключения к Debug-консоли контроллера используйте параметры из таблицы ниже и одну из программ, перечисленных в статье Работа с последовательным портом.
Параметр | Значение | Описание |
---|---|---|
Serial Port |
|
Подробнее смотрите выше в этой статье |
Baud rate | 115200 | Скорость, бит/с |
Data bits | 8 | Количество битов данных |
Parity | None | Бит чётности |
Stop bits | 1 | Количество стоповых битов |
Hardware flow control | None | Аппаратный контроль потока |
Software flow control | None | Программный контроль потока |
Настройка параметров для подключения к Debug-консоли контроллера в программе PuTTY
Открытие сессии в программе PuTTY
Физическая реализация в контроллерах
Версия контроллера | Тип разъема | Название разъема | Интерфейс | Чип 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 разъем без названия |
Программно во всех случаях это последовательный порт.