Debug Console: различия между версиями
Kilpio (обсуждение | вклад) |
|||
(не показаны 263 промежуточные версии 11 участников) | |||
Строка 1: | Строка 1: | ||
<languages/> | |||
<!--T:100--> | |||
Контроллеры Wiren Board имеют отладочный порт, подключившись к которому можно получить прямой доступ к консоли контроллера. Через него можно также взаимодействовать с загрузчиком и следить за загрузкой операционной системы (последовательная консоль, serial console). | |||
<!--T:105--> | |||
Физически в разных версиях контроллера отладочный порт реализован по разному: | |||
* для версий '''WB 5.8 и позднее, включая WB6''' он выглядит как Micro-USB разъём (подпись ''Debug Console'' или ''Debug USB''); | |||
* для версий '''WB 5.6 и ранее''' он выглядит как трёхштыревой разъём (подпись ''Debug UART''). | |||
Программно во всех случаях это последовательный порт. | |||
Подключение | Подробнее про подключение к отладочному порту читайте ниже. | ||
<!--T:3--> | |||
== Подключение к отладочному порту в Wiren Board 5.8 и позднее == <!--T:104--> | |||
[[Файл:USBA-MICROUSBB.png|250px|thumb|right|Кабель USB — Micro-USB]] | |||
Для подключения вам понадобится стандартный кабель USB — Micro-USB - такой же, как для подключения сотовых телефонов (более точное название кабеля USB (A) — Micro-USB (B)). Разъем USB (А) подключается к компьютеру, Micro-USB (B) — к контроллеру. | |||
[[Файл:Debugusb58.png|250px|thumb|right|Разъем ''Debug USB'']] | |||
На корпусе напротив разъема отладочного порта находится надпись ''Debug Console''. Внутри контроллера установлен переходник USB-UART (в частности, в новых моделях контролера используется адаптер USB-Serial CH340/CH341). | |||
В Linux адаптер обычно определяется автоматически, при подключении в выводе команды <code>dmesg</code> должна появится строка <code>usb 1-1: ch341-uart converter now attached to ttyUSB0</code>. Номер порта ttyUSB может варьироваться в зависимости от подключенных уже устройств. В Windows номер появившегося виртуального COM-порта можно найти в Диспетчере устройств (Device Manager). | |||
В Windows необходимо установить соответствующий драйвер [http://www.winchiphead.com/download/CH341/CH341SER.ZIP на сайте производителя] или в другом месте. | |||
Настройки соединения те же: '''115200 8N1''' (115200 кбит/с, 8 бит, нет бита чётности, один стоп-бит). | |||
<!--T:108--> | |||
[[Файл:SerialUART_Win.png|250px|thumb|right|Номер порта в Windows]] | |||
== | == Подключение к отладочному порту в Wiren Board 5.6 и ранее == <!--T:4--> | ||
'''Внимание!''' | |||
[[Файл:Duart.jpg|thumb|right|Адаптер USB-UART]] | |||
! | |||
| | |||
|- | |||
* Подключайте Debug UART только через переходники USB-UART с напряжением 3.3 В. | |||
* UART не является синонимом RS-232 (где напряжение на линии может быть 5 В, 12 В и т.д.). Подключение Debug UART к порту RS-232 (или переходнику USB-RS-232) напрямую '''приведет к необратимому повреждению устройства'''. | |||
#Подключите адаптер USB-UART к компьютеру, соедините контакты адаптера с контактами (штырьками) отладочного порта на контроллере по схеме: | |||
#*GND к GND, | |||
#*TX к RX, | |||
#*RX к TX. | |||
#:На некоторых переходниках маркировка перепутана — попробуйте соединить TX с TX и RX с RX. Если ваш компьютер работает под Windows, вам придётся установить драйвер конкретного адаптера. Если вы работает под Linux, то адаптер скорее всего будет сразу поддерживаться ядром, но, возможно, придётся скомпилировать соответствующий модуль. | |||
#Запустите программу для работы с последовательным портом и выберите следующие настройки соединения: '''115200 8N1''' (115200 кбит/с, 8 бит, нет бита чётности, один стоп-бит). При входе в систему используйте следующие логин и пароль: ''root'' - ''wirenboard'' (они заданы по умолчанию). В Windows номер порта можно найти в диспетчере Устройств. | |||
== Если вы работает с последовательным портом впервые == <!--T:7--> | |||
=== Установка программы для работы с последовательным портом === | |||
<!--T:8--> | |||
[ | Для работы с последовательным портом установите на вашем компьютере подходящую утилиту - например, PuTTY: | ||
* версия для Windows - [http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe скачать с официального сайта] | |||
* версия для Linux Debian или Ubuntu - выполните команду ''apt-get install putty'' | |||
Подойдут также [http://elinux.org/RPi_Serial_Connection другие программы]. | |||
=== Подключение === <!--T:9--> | |||
<!--T:10--> | |||
[[Файл: | #Запустите приложение от имени администратора: | ||
#* в Windows - щёлкните по значку PuTTY правой кнопкой и выберите ''Run This Program As An Administrator'' | |||
#* в Linux - <code>gksu putty</code> | |||
#В меню слева выберите последний пункт - ''Serial''. В появившиеся поля справа введите настройки порта: | |||
#*название последовательного порта | |||
#**для Windows - это ''COM4'' ('''цифра может меняться''', точную можно узнать через ''Диспетчер устройств'', найдя в нём переходник USB-UART) | |||
#**для Linux - это ''/dev/ttyUSB0'' ('''цифра может меняться''', смотрите список файлов в папке ''/dev/'') | |||
#*скорость - ''115200'' | |||
#*количество битов в посылке - ''8'' | |||
#*количество стоп-битов - ''1'' | |||
#*чётность - ''нет'' | |||
#*контроль потока - ''нет'' | |||
#:[[Файл:Putty serial settings.png|500px]] | |||
#В меню слева выберите первый пункт - ''Session''. Справа переключите тип подключения на Serial - в поля должны попасть настройки порта. Затем нажмите ''Open''. | |||
#:[[Файл:Putty serial open.png|500px]] | |||
#Чтобы проверить, правильно ли вы всё сделали, кнопкой выключите и включите контроллер - на экране должны появиться сообщения о загрузке. После завершения загрузки появится запрос логина - введите ''root'' и нажмите ''Enter'', и пароля - введите ''wirenboard'' (вводимые символы не будут отображаться) и нажмите ''Enter''. | |||
#Появится приветственное сообщение - вы в консоли контроллера. | |||
#:[[Файл:Putty serial logged in.png|500px]] | |||
== Как найти штырьки разъёма отладочного порта на старых версиях контроллера == | |||
=== Wiren Board 5 === | |||
<gallery mode="packed" heights=200 widths=200> | |||
Image:Wb53 uart.jpg|Wiren Board 5.3 | |||
Image:Wb56 uart.jpg|Wiren Board 5.6 | |||
</gallery> | |||
=== Wiren Board 4 === | |||
Выведен на боковую панель рядом с разъёмами для microSD и microSIM карт. | |||
===Wiren Board Smart Home 3.5=== | |||
[[Файл:WB3.5.png|thumb|400px|Wiren Board Smart Home rev 3.5]] | |||
Debug UART выведен на разъём UEXT1, а также отдельно на гребёнку (рядом с аудиовыходом, см. схему) | |||
Для Debug UART используются ножки 2,3,4 (см. рисунок). | |||
=== | ===Wiren Board 2.8=== | ||
[[Image:UEXTPINS.jpg|thumb|UEXT pinout for [[Insulation-displacement connector|IDC]] connector<br/>(looking into connector on host board)]] | |||
</ | |||
Выведен на разъём UEXT1 (чёрный разъём с десятью штырьками на длинной стороне платы). | |||
Версия 15:38, 31 мая 2018
Контроллеры Wiren Board имеют отладочный порт, подключившись к которому можно получить прямой доступ к консоли контроллера. Через него можно также взаимодействовать с загрузчиком и следить за загрузкой операционной системы (последовательная консоль, serial console).
Физически в разных версиях контроллера отладочный порт реализован по разному:
- для версий WB 5.8 и позднее, включая WB6 он выглядит как Micro-USB разъём (подпись Debug Console или Debug USB);
- для версий WB 5.6 и ранее он выглядит как трёхштыревой разъём (подпись Debug UART).
Программно во всех случаях это последовательный порт.
Подробнее про подключение к отладочному порту читайте ниже.
Подключение к отладочному порту в Wiren Board 5.8 и позднее
Для подключения вам понадобится стандартный кабель USB — Micro-USB - такой же, как для подключения сотовых телефонов (более точное название кабеля USB (A) — Micro-USB (B)). Разъем USB (А) подключается к компьютеру, Micro-USB (B) — к контроллеру.
На корпусе напротив разъема отладочного порта находится надпись Debug Console. Внутри контроллера установлен переходник USB-UART (в частности, в новых моделях контролера используется адаптер USB-Serial CH340/CH341).
В Linux адаптер обычно определяется автоматически, при подключении в выводе команды dmesg
должна появится строка usb 1-1: ch341-uart converter now attached to ttyUSB0
. Номер порта ttyUSB может варьироваться в зависимости от подключенных уже устройств. В Windows номер появившегося виртуального COM-порта можно найти в Диспетчере устройств (Device Manager).
В Windows необходимо установить соответствующий драйвер на сайте производителя или в другом месте. Настройки соединения те же: 115200 8N1 (115200 кбит/с, 8 бит, нет бита чётности, один стоп-бит).
Подключение к отладочному порту в Wiren Board 5.6 и ранее
Внимание!
- Подключайте Debug UART только через переходники USB-UART с напряжением 3.3 В.
- UART не является синонимом RS-232 (где напряжение на линии может быть 5 В, 12 В и т.д.). Подключение Debug UART к порту RS-232 (или переходнику USB-RS-232) напрямую приведет к необратимому повреждению устройства.
- Подключите адаптер USB-UART к компьютеру, соедините контакты адаптера с контактами (штырьками) отладочного порта на контроллере по схеме:
- GND к GND,
- TX к RX,
- RX к TX.
- На некоторых переходниках маркировка перепутана — попробуйте соединить TX с TX и RX с RX. Если ваш компьютер работает под Windows, вам придётся установить драйвер конкретного адаптера. Если вы работает под Linux, то адаптер скорее всего будет сразу поддерживаться ядром, но, возможно, придётся скомпилировать соответствующий модуль.
- Запустите программу для работы с последовательным портом и выберите следующие настройки соединения: 115200 8N1 (115200 кбит/с, 8 бит, нет бита чётности, один стоп-бит). При входе в систему используйте следующие логин и пароль: root - wirenboard (они заданы по умолчанию). В Windows номер порта можно найти в диспетчере Устройств.
Если вы работает с последовательным портом впервые
Установка программы для работы с последовательным портом
Для работы с последовательным портом установите на вашем компьютере подходящую утилиту - например, PuTTY:
- версия для Windows - скачать с официального сайта
- версия для Linux Debian или Ubuntu - выполните команду apt-get install putty
Подойдут также другие программы.
Подключение
- Запустите приложение от имени администратора:
- в Windows - щёлкните по значку PuTTY правой кнопкой и выберите Run This Program As An Administrator
- в Linux -
gksu putty
- В меню слева выберите последний пункт - Serial. В появившиеся поля справа введите настройки порта:
- название последовательного порта
- для Windows - это COM4 (цифра может меняться, точную можно узнать через Диспетчер устройств, найдя в нём переходник USB-UART)
- для Linux - это /dev/ttyUSB0 (цифра может меняться, смотрите список файлов в папке /dev/)
- скорость - 115200
- количество битов в посылке - 8
- количество стоп-битов - 1
- чётность - нет
- контроль потока - нет
- название последовательного порта
- В меню слева выберите первый пункт - Session. Справа переключите тип подключения на Serial - в поля должны попасть настройки порта. Затем нажмите Open.
- Чтобы проверить, правильно ли вы всё сделали, кнопкой выключите и включите контроллер - на экране должны появиться сообщения о загрузке. После завершения загрузки появится запрос логина - введите root и нажмите Enter, и пароля - введите wirenboard (вводимые символы не будут отображаться) и нажмите Enter.
- Появится приветственное сообщение - вы в консоли контроллера.
Как найти штырьки разъёма отладочного порта на старых версиях контроллера
Wiren Board 5
Wiren Board 4
Выведен на боковую панель рядом с разъёмами для microSD и microSIM карт.
Wiren Board Smart Home 3.5
Debug UART выведен на разъём UEXT1, а также отдельно на гребёнку (рядом с аудиовыходом, см. схему)
Для Debug UART используются ножки 2,3,4 (см. рисунок).
Wiren Board 2.8
Выведен на разъём UEXT1 (чёрный разъём с десятью штырьками на длинной стороне платы).