12 063
правки
м |
(Отметить эту версию для перевода) |
||
Строка 2: | Строка 2: | ||
<languages/> | <languages/> | ||
<translate> | <translate> | ||
<!--T:109--> | |||
{{DISPLAYTITLE:Отладочный порт}} | {{DISPLAYTITLE:Отладочный порт}} | ||
Строка 7: | Строка 8: | ||
Контроллеры Wiren Board имеют отладочный порт, через который можно получить прямой доступ к консоли контроллера. Через него можно взаимодействовать с загрузчиком и следить за загрузкой операционной системы (последовательная консоль, serial console). Другие способы подключения к контроллеру: [[Веб-интерфейс Wiren Board | через веб-интерфейс]], [[SSH | по SSH]]. | Контроллеры Wiren Board имеют отладочный порт, через который можно получить прямой доступ к консоли контроллера. Через него можно взаимодействовать с загрузчиком и следить за загрузкой операционной системы (последовательная консоль, serial console). Другие способы подключения к контроллеру: [[Веб-интерфейс Wiren Board | через веб-интерфейс]], [[SSH | по SSH]]. | ||
<!--T:105--> | == Физическая реализация порта отладочной консоли == <!--T:105--> | ||
Физически в разных версиях контроллера отладочный порт реализован по разному: | Физически в разных версиях контроллера отладочный порт реализован по разному: | ||
* для версий '''WB 6 и позднее''' он выглядит как Micro-USB разъём (подпись ''Debug Console''); | * для версий '''WB 6 и позднее''' он выглядит как Micro-USB разъём (подпись ''Debug Console''); | ||
Строка 15: | Строка 15: | ||
Программно во всех случаях это последовательный порт. | Программно во всех случаях это последовательный порт. | ||
<!--T:110--> | |||
Варианты реализации отладочной консоли в разных версиях контроллеров перечислены ниже. | Варианты реализации отладочной консоли в разных версиях контроллеров перечислены ниже. | ||
=== Реализация отладочной консоли в контроллерах Wiren Board === | === Реализация отладочной консоли в контроллерах Wiren Board === <!--T:111--> | ||
{| class="wikitable" | {| class="wikitable" | ||
! Версия коннтроллера !! Тип разъема !! Название разъема !! Интерфейс !! Чип USB/UART | ! Версия коннтроллера !! Тип разъема !! Название разъема !! Интерфейс !! Чип USB/UART | ||
Строка 38: | Строка 39: | ||
|} | |} | ||
<!--T:3--> | == Поддержка в операционных системах == <!--T:3--> | ||
{| class="wikitable" | {| class="wikitable" | ||
! Версия контроллера !! Linux !! Windows XP, 7, 8 !! Windows 10 !! MacOS X (High Sierra) !! Android 9 + USB Serial Console | ! Версия контроллера !! Linux !! Windows XP, 7, 8 !! Windows 10 !! MacOS X (High Sierra) !! Android 9 + USB Serial Console | ||
Строка 54: | Строка 54: | ||
|} | |} | ||
<!--T:112--> | |||
Для контроллеров версии 5.6.1 и младше требуется переходник USB/UART. См. раздел [[#Подключение к отладочному порту в Wiren Board 5.6 и младше|Подключение к отладочному порту в Wiren Board 5.6 и младше]] | Для контроллеров версии 5.6.1 и младше требуется переходник USB/UART. См. раздел [[#Подключение к отладочному порту в Wiren Board 5.6 и младше|Подключение к отладочному порту в Wiren Board 5.6 и младше]] | ||
Строка 63: | Строка 64: | ||
=== Как найти порт отладочной консоли === | === Как найти порт отладочной консоли === | ||
<!--T:113--> | |||
На корпусе напротив разъема порта отладочной консоли находится надпись ''Debug Console''. | На корпусе напротив разъема порта отладочной консоли находится надпись ''Debug Console''. | ||
=== Подключение === | === Подключение === <!--T:114--> | ||
<!--T:115--> | |||
Для подключения понадобится стандартный кабель USB — Micro-USB - такой же, как для подключения сотовых телефонов. Более точное название кабеля USB (A) — Micro-USB (B). Разъем USB (А) подключается к компьютеру, Micro-USB (B) — к контроллеру. | Для подключения понадобится стандартный кабель USB — Micro-USB - такой же, как для подключения сотовых телефонов. Более точное название кабеля USB (A) — Micro-USB (B). Разъем USB (А) подключается к компьютеру, Micro-USB (B) — к контроллеру. | ||
<!--T:116--> | |||
Кабели от зарядных устройств подходят, но бывают исключения. Лучше выбирать такие, на которых указано, что они предназначены для передачи данных. | Кабели от зарядных устройств подходят, но бывают исключения. Лучше выбирать такие, на которых указано, что они предназначены для передачи данных. | ||
Если кабель выбран правильно, Windows сообщит звуком об обнаружении устройства. | Если кабель выбран правильно, Windows сообщит звуком об обнаружении устройства. | ||
=== Драйвера адаптеров и названия виртуальных COM-портов === | === Драйвера адаптеров и названия виртуальных COM-портов === <!--T:117--> | ||
<!--T:118--> | |||
Внутри контроллера установлен переходник USB-UART; подробнее — в таблице [[ #Реализация отладочной консоли в контроллерах Wiren Board |Реализация отладочной консоли в контроллерах Wiren Board]]. | Внутри контроллера установлен переходник USB-UART; подробнее — в таблице [[ #Реализация отладочной консоли в контроллерах Wiren Board |Реализация отладочной консоли в контроллерах Wiren Board]]. | ||
<!--T:119--> | |||
*Linux: адаптер обычно определяется автоматически, при подключении в выводе команды <code>dmesg</code> должна появится строка <code>usb 1-1: ch341-uart converter now attached to ttyUSB0</code> или (для версий контроллера 6.4 и старше) <code>cdc_acm:3-6:1.0: ttyACM0: USB ACM device</code>. Номер порта ttyUSBx или ttyACMx может меняться, в зависимости от уже подключенных устройств. Смотрите список файлов в папке /dev/ . Консольный порт контроллеров новых версий 6.4 и старше определяется автоматически как устройство ''/dev/ttyACM0''. Смотрите также раздел [[#Настройка работы отладочного порта в Linux для WB6.4 и выше|Настройка работы отладочного порта в Linux для WB6.4 и выше]]. | *Linux: адаптер обычно определяется автоматически, при подключении в выводе команды <code>dmesg</code> должна появится строка <code>usb 1-1: ch341-uart converter now attached to ttyUSB0</code> или (для версий контроллера 6.4 и старше) <code>cdc_acm:3-6:1.0: ttyACM0: USB ACM device</code>. Номер порта ttyUSBx или ttyACMx может меняться, в зависимости от уже подключенных устройств. Смотрите список файлов в папке /dev/ . Консольный порт контроллеров новых версий 6.4 и старше определяется автоматически как устройство ''/dev/ttyACM0''. Смотрите также раздел [[#Настройка работы отладочного порта в Linux для WB6.4 и выше|Настройка работы отладочного порта в Linux для WB6.4 и выше]]. | ||
<!--T:120--> | |||
*Windows: в зависимости от версии и типа контроллера возможно потребуется установка драйвера (см. таблицу [[#Поддержка в операционных системах|Поддержка в операционных системах]]). В Диспетчере устройств (Device Manager) в разделе Ports(COM&LPT) должен появиться виртуальный COM-порт контроллера. Если не очевидно, какой из портов используется контроллером, можно отсоединить кабель и включить снова. | *Windows: в зависимости от версии и типа контроллера возможно потребуется установка драйвера (см. таблицу [[#Поддержка в операционных системах|Поддержка в операционных системах]]). В Диспетчере устройств (Device Manager) в разделе Ports(COM&LPT) должен появиться виртуальный COM-порт контроллера. Если не очевидно, какой из портов используется контроллером, можно отсоединить кабель и включить снова. | ||
<!--T:121--> | |||
*macOS: Начиная с High Sierra отладочная консоль контроллеров определяется из коробки, предыдущие версии операционной системы, возможно, потребуют установки драйверов. При подключении создается устройство /dev/tty.usbserial-1410 или /dev/tty.usbmodem00001 (для контроллеров версии 6.4 и старше). | *macOS: Начиная с High Sierra отладочная консоль контроллеров определяется из коробки, предыдущие версии операционной системы, возможно, потребуют установки драйверов. При подключении создается устройство /dev/tty.usbserial-1410 или /dev/tty.usbmodem00001 (для контроллеров версии 6.4 и старше). | ||
<!--T:122--> | |||
*Android: Поздние версии Android при подключении через OTG поддерживают отладочную консоль контроллеров без дополнительных драйверов. Тестировалось с приложением [https://play.google.com/store/apps/details?id=jp.sugnakys.usbserialconsole&hl=en_US USB Serial Console]. | *Android: Поздние версии Android при подключении через OTG поддерживают отладочную консоль контроллеров без дополнительных драйверов. Тестировалось с приложением [https://play.google.com/store/apps/details?id=jp.sugnakys.usbserialconsole&hl=en_US USB Serial Console]. | ||
=== Настройка работы отладочного порта в Linux для WB6.4 и выше === | === Настройка работы отладочного порта в Linux для WB6.4 и выше === <!--T:123--> | ||
<!--T:124--> | |||
'''Суть проблемы:''' на некоторых системах процесс ModemManager автоматически открывает устройство ''/dev/ttyACM0''. | '''Суть проблемы:''' на некоторых системах процесс ModemManager автоматически открывает устройство ''/dev/ttyACM0''. | ||
Для этого необходимо отключить ModemManager для данного устройства с помощью правил ''udev''. | Для этого необходимо отключить ModemManager для данного устройства с помощью правил ''udev''. | ||
<!--T:125--> | |||
* Создаем файл исключений ''udev'' | * Создаем файл исключений ''udev'' | ||
<syntaxhighlight lang="bash"> sudo nano /etc/udev/rules.d/99-wb-debug-usb.rules </syntaxhighlight> | <syntaxhighlight lang="bash"> sudo nano /etc/udev/rules.d/99-wb-debug-usb.rules </syntaxhighlight> | ||
<!--T:126--> | |||
* в который записываем cтрочку | * в который записываем cтрочку | ||
<syntaxhighlight lang="bash"> ATTRS{idVendor}=="04d9" ATTRS{idProduct}=="b534", ENV{ID_MM_DEVICE_IGNORE}="1" </syntaxhighlight> | <syntaxhighlight lang="bash"> ATTRS{idVendor}=="04d9" ATTRS{idProduct}=="b534", ENV{ID_MM_DEVICE_IGNORE}="1" </syntaxhighlight> | ||
<!--T:127--> | |||
* После сохранения файла необходимо перезагрузить правила ''udev'': | * После сохранения файла необходимо перезагрузить правила ''udev'': | ||
<syntaxhighlight lang="bash"> sudo udevadm control --reload-rules </syntaxhighlight> | <syntaxhighlight lang="bash"> sudo udevadm control --reload-rules </syntaxhighlight> | ||
Строка 100: | Строка 113: | ||
<!--T:128--> | |||
Переходите к [[#Настройка работы с последовательным портом | настройке работы с последовательным портом]]. | Переходите к [[#Настройка работы с последовательным портом | настройке работы с последовательным портом]]. | ||
Строка 106: | Строка 120: | ||
=== Как найти штыревой разъем порта отладочной консоли === | === Как найти штыревой разъем порта отладочной консоли === | ||
<!--T:129--> | |||
<gallery mode="traditional" heights=200 widths=200 style="text-align:left"> | <gallery mode="traditional" heights=200 widths=200 style="text-align:left"> | ||
Image:Wb56 uart.jpg|В '''Wiren Board 5.6''' Debug UART выведен на гребенку между разъемами FW и IR. | Image:Wb56 uart.jpg|В '''Wiren Board 5.6''' Debug UART выведен на гребенку между разъемами FW и IR. | ||
Строка 115: | Строка 130: | ||
</gallery> | </gallery> | ||
=== Подключение === | === Подключение === <!--T:130--> | ||
<!--T:131--> | |||
Для подключения понадобится адаптер USB-UART. | Для подключения понадобится адаптер USB-UART. | ||
'''Внимание!''' | '''Внимание!''' | ||
[[Файл:Duart.jpg|thumb|right|Адаптер USB-UART и набор соединительных проводов]] | [[Файл:Duart.jpg|thumb|right|Адаптер USB-UART и набор соединительных проводов]] | ||
<!--T:132--> | |||
* Подключайте Debug UART только через переходники USB-UART с напряжением '''3,3 В'''. | * Подключайте Debug UART только через переходники USB-UART с напряжением '''3,3 В'''. | ||
* UART не является синонимом RS-232 (где напряжение на линии может быть 5 В, 12 В и т.д.). Подключение Debug UART к порту RS-232 (или переходнику USB-RS-232) напрямую '''приведет к необратимому повреждению устройства'''. | * UART не является синонимом RS-232 (где напряжение на линии может быть 5 В, 12 В и т.д.). Подключение Debug UART к порту RS-232 (или переходнику USB-RS-232) напрямую '''приведет к необратимому повреждению устройства'''. | ||
<!--T:133--> | |||
Подключите адаптер USB-UART к компьютеру, соедините контакты адаптера с контактами (штырьками) отладочного порта на контроллере по схеме: | Подключите адаптер USB-UART к компьютеру, соедините контакты адаптера с контактами (штырьками) отладочного порта на контроллере по схеме: | ||
*GND к GND, | *GND к GND, | ||
Строка 129: | Строка 147: | ||
*RX к TX. | *RX к TX. | ||
<!--T:134--> | |||
На некоторых переходниках маркировка перепутана — попробуйте соединить TX с TX и RX с RX. | На некоторых переходниках маркировка перепутана — попробуйте соединить TX с TX и RX с RX. | ||
=== Поддержка переходников USB/UART === | === Поддержка переходников USB/UART === <!--T:135--> | ||
<!--T:136--> | |||
Существует большое количество переходников USB/UART, в таблице приводится информация о поддержке в операционных системах переходников с наиболее распространенными чипами. Таблица будет уточняться по мере получения новых данных. | Существует большое количество переходников USB/UART, в таблице приводится информация о поддержке в операционных системах переходников с наиболее распространенными чипами. Таблица будет уточняться по мере получения новых данных. | ||
<!--T:137--> | |||
{| class="wikitable" | {| class="wikitable" | ||
! Переходник USB/UART (чип) !! Linux !! Windows XP, 7, 8 !! Windows 10 !! MacOS X (High Sierra) !! Android 9 + USB Serial Console | ! Переходник USB/UART (чип) !! Linux !! Windows XP, 7, 8 !! Windows 10 !! MacOS X (High Sierra) !! Android 9 + USB Serial Console | ||
Строка 152: | Строка 173: | ||
=== Драйвера адаптеров === | === Драйвера адаптеров === <!--T:138--> | ||
<!--T:139--> | |||
*Windows: установите драйвер конкретного адаптера, если он не поддерживается операционной системой. | *Windows: установите драйвер конкретного адаптера, если он не поддерживается операционной системой. | ||
*Linux: адаптер скорее всего будет сразу поддерживаться ядром, но, возможно, придётся скомпилировать соответствующий модуль. | *Linux: адаптер скорее всего будет сразу поддерживаться ядром, но, возможно, придётся скомпилировать соответствующий модуль. | ||
Строка 159: | Строка 181: | ||
*Android: установите драйвер конкретного адаптера, если он не поддерживается операционной системой. | *Android: установите драйвер конкретного адаптера, если он не поддерживается операционной системой. | ||
<!--T:140--> | |||
Переходите к [[#Настройка работы с последовательным портом | настройке работы с последовательным портом]]. | Переходите к [[#Настройка работы с последовательным портом | настройке работы с последовательным портом]]. | ||
Строка 173: | Строка 196: | ||
Подойдут также [http://elinux.org/RPi_Serial_Connection другие программы]. | Подойдут также [http://elinux.org/RPi_Serial_Connection другие программы]. | ||
<!--T:141--> | |||
Настройки соединения: '''115200 8N1''' (115200 кбит/с, 8 бит, нет бита чётности, один стоп-бит), root/wirenboard. | Настройки соединения: '''115200 8N1''' (115200 кбит/с, 8 бит, нет бита чётности, один стоп-бит), root/wirenboard. | ||
правки