Debug Console: различия между версиями

Отметить эту версию для перевода
м
(Отметить эту версию для перевода)
Строка 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.


12 063

правки