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

Материал из Wiren Board
(не показано 215 промежуточных версий 9 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE:Отладочный порт в контроллерах Wiren Board}}
{{DISPLAYTITLE:Отладочный порт}}
== Описание ==
<languages/>
У контроллеров Wiren Board есть отладочный порт. Он обозначен как «Debug console».
<gallery mode="packed" caption="" heights="150px" perrow=1>
Image: WirenBoard7DebugConsole.png | Wiren Board 7.x
Image: WirenBoard6DebugConsole.png | Wiren Board 6.x
Image: Debugusb58.png | Wiren Board 5.8 и 5.9
</gallery>


Подключившись к нему, как и в случае [[SSH | SSH]] подключения, вы превращаете свой компьютер в монитор и клавиатуру контроллера. И получаете доступ к его консоли (командной строке). А в отличие от SSH, вы сможете увидеть информацию, выводимую контроллером на экран при его начальной загрузке.


Нужен этот порт для аварийных ситуаций, когда подключения по сети недоступны. Например, если вы неверно сконфигурировали сеть, и контроллер не может к ней подключиться. Или, если возникла какая-то проблема, мешающая контроллеру нормально загрузиться. Для обычной работы использовать это подключение мы не рекомендуем, используйте [[Веб-интерфейс Wiren Board | веб-интерфейс]] или SSH.
<!--T:100-->
Контроллеры Wiren Board имеют отладочный порт, через который можно получить прямой доступ к консоли контроллера. Через него можно взаимодействовать с загрузчиком и следить за загрузкой операционной системы (последовательная консоль, serial console). Другие способы подключения к контроллеру: [[Веб-интерфейс Wiren Board | через веб-интерфейс]], [[SSH | по SSH]].


== Подключение ==
<!--T:105-->
{{YouTube
== Физическая реализация порта отладочной консоли ==
|link=https://youtu.be/VA_XHrY1RVA?t=135
Физически в разных версиях контроллера отладочный порт реализован по разному:
|text= Про командную строку, SSH и Debug Console}}
* для версий '''WB 6 и позднее''' он выглядит как Micro-USB разъём (подпись ''Debug Console'');
 
* для версий '''WB 5.8 и позднее''' он выглядит как Micro-USB разъём (подпись ''Debug Console'' или ''Debug USB'');
Если у вас контроллер Wiren Board 5.6 и старее, обратитесь к [[WB5.6_Debug_Console| статье ]].
* для версий '''WB 5.6 и ранее''' он выглядит как трёхштыревой разъём (подпись ''Debug UART'').
 
Программно во всех случаях это последовательный порт.
Подключение выполняется стандартными кабелями, их легко купить. В комплекте с вашим смартфоном может быть такой.
[[Файл:Debugusb58.png|250px|thumb|right|Разъем ''Debug USB'']]
 
Подробнее см. таблицу:
{{note|warn| Бывают кабели с такими же разъёмами, но предназначенные только для зарядки — они не подойдут. }}
{| class="wikitable"
 
! Версия коннтроллера !! Тип разъема !! Название разъема !! Интерфейс !! Чип USB/UART
Для подключения  '''Wiren Board 7''' к компьютеру нужен кабель '''USB Тип A – USB Тип C'''.
|-
 
| 6.4 и старше || microUSB || Debug Console || USB/UART || HT42B534-1
Для подключения более ранних контроллеров - '''USB тип A – Micro-USB Тип B'''.
|-
| 6.0 — 6.3  || microUSB || Debug Console || USB/UART  || CH340/CH341
|-
| 5.8 — 5.9 || microUSB || Debug Console || USB/UART || CH340/CH341
|-
| 5.6.1 || 3-pin UART (Gnd, Rx, Tx) || UART || UART (3,3 В) || —
|-
| 5.3  || 3-pin UART (Tx, Rx, GND) || Debug UART || UART (3,3 В) || —
|-
| 4 || 3-pin UART (Gnd, Rx, Tx) || Debug UART || UART (3,3 В) || —
|-
| 3.5 || 3-pin UART (Gnd, Tx, Rx) || UEXT1 (выводы 2,3,4) и 3-pin разъем без названия || UART (3,3 В) || —
|-
| 2.8 || 3-pin UART (Gnd, Tx, Rx) || UEXT1 (выводы 2,3,4) и 3-pin разъем без названия || UART (3,3 В) || —
|}


Самый простой способ проверить, подходит ли кабель для подключения к контроллеру — подключить к компьютеру через этот кабель мобильный телефон. Если компьютер обнаружил новое устройство — кабель можно использовать и для контролера.
<!--T:3-->


== Настройка порта, программное обеспечение ==
== Поддержка в oперационных системах ==  
Необходимо определить, к какому порту компьютера подключен Wiren Board, и настроить этот порт в соответствии с настройками Debug console.
{| class="wikitable"
{| border="1" class="wikitable"  
! Версия контроллера !! Linux  !! Windows XP, 7, 8 !! Windows 10 !! MacOS X (High Sierra)  !! Android 9 + USB Serial Console
|+ Параметры порта Debug console
! Параметр|| Значение || Описание
|-
|-
| 6.4 и старше
| Модуль ядра cdc_acm (все новые дистрибутивы — из коробки) || Необходим драйвер [http://www.holtek.com/documents/10179/116677/USBBridgeSetup_CA.zip HT42B534-1] или inf-файл (см. ниже)|| Из коробки || Из коробки || Из коробки
|-
|-
| Baud rate || 115200 || Скорость, бит/с
| 6.0 — 6.3
| Модуль ядра ch341 (все новые дистрибутивы — из коробки)|| Необходим драйвер [http://www.wch.cn/downloads/CH341SER_ZIP.html CH341SER] || Из коробки || [[http://www.wch.cn/download/ch341ser_mac_zip.html CH341SER_MAC.ZIP]] || Из коробки
|-
|-
| Data bits || 8 || Количество битов данных
| 5.8 — 5.9
| Модуль ядра ch341 (все новые дистрибутивы — из коробки)|| Необходим драйвер [http://www.wch.cn/downloads/CH341SER_ZIP.html CH341SER]|| Из коробки || [[http://www.wch.cn/download/ch341ser_mac_zip.html CH341SER_MAC.ZIP]] || Из коробки
|-
|-
| Parity || None ||  Бит чётности
|}
 
Для контроллеров версии 5.6.1 и младше требуется переходник USB/UART.
В новых моделях контроллеров используется чип Holtek HT42B534-1. Вы можете использовать драйверы производителя чипа, или установить [[File:Wb-debug-uart.inf.zip inf-файл]].
 
=== Поддержка переходников USB/UART ===
{| class="wikitable"
! Переходник USB/UART (чип) !! Linux  !! Windows XP, 7, 8 !! Windows 10 !! MacOS X (High Sierra) !! Android 9 + USB Serial Console
|-
|-
| Stop bits || 1 || Количество стоповых битов
| FTDI232
| Модуль ядра ftdi_sio || требуют драйверов на ОС из коробки || требуют драйверов на ОС из коробки || Нет информации || Из коробки
|-
|-
| Hardware flow control || None || Аппаратный контроль потока
| CP2102
| Модуль ядра cp210x || [https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers Silicon Labs CP210x VCP Driver] || [https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers Silicon Labs CP210x VCP Driver] || [https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers Silicon Labs CP210x VCP Driver] || Из коробки
|-
|-
| Software flow control || None || Программный контроль потока
| CH340/CH341
| Модуль ядра ch341 || Необходим драйвер [http://www.wch.cn/downloads/CH341SER_ZIP.html CH341SER] || Из коробки || [http://www.wch.cn/download/ch341ser_mac_zip.html CH341SER_MAC.ZIP] || Из коробки
|-
|-
| PL2303xx
| Модуль ядра pl2303 || необходим драйвер || возможно, необходим драйвер || нет информации  || нет информации
|}
|}


=== Windows ===
== Подключение к отладочному порту контроллеров Wiren Board 6, Wiren Board 5.8 и старше == <!--T:104-->
Если у вас на компьютере '''Windows 10''', а контроллер '''Wiren Board 6.4 или новее''', то система сама, после физического подключения, назначит виртуальный COM порт и установит необходимый драйвер. Увидеть номер этого порта можно в Диспетчере устройств Windows:
[[Файл:USBA-MICROUSBB.png|250px|thumb|right|Кабель USB — Micro-USB]]
[[Файл:Dispatcher.png|left]]
[[Файл:SerialUART_Win.png|250px|thumb|right|Номер порта в Windows]]
<br clear="both" />
'''Как найти порт: '''
 
На корпусе напротив разъема отладочного порта находится надпись ''Debug Console''.
 
'''Как подключать:'''
 
Для подключения понадобится стандартный кабель USB — Micro-USB - такой же, как для подключения сотовых телефонов. Более точное название кабеля USB (A) — Micro-USB (B). Разъем USB (А) подключается к компьютеру, Micro-USB (B) — к контроллеру.
 
Кабели от зарядных устройств подходят, но бывают исключения. Лучше выбирать такие, на которых указано, что они предназначены для передачи данных.
Если кабель выбран правильно, Windows сообщит звуком об обнаружении устройства.
 
'''Драйвер адаптера и номер виртуального COM-порта:'''
 
Внутри контроллера установлен переходник USB-UART (в версиях контроллера WB5.8-WB6.3 используется адаптер USB-Serial CH340/CH341).


При использовании '''Windows XP, 7, 8''' скачайте и установите драйвер. Для установки драйвера вам потребуются навыки администрирования ОС Windows, ссылки на файлы:
*Linux: адаптер обычно определяется автоматически, при подключении в выводе команды <code>dmesg</code> должна появится строка <code>usb 1-1: ch341-uart converter now attached to ttyUSB0</code>. Номер порта ttyUSB может меняться, в зависимости от уже подключенных устройств. Смотрите список файлов в папке /dev/ .
* для [https://wirenboard.com/wiki/images/3/38/HT42B534_inf.zip Wiren Board 6.4 или новее];
* для [http://www.wch.cn/downloads/CH341SER_ZIP.html более ранних версий].


Далее подключайте контроллер, и в Диспетчере устройств Windows вы должны увидеть виртуальный COM порт, как на иллюстрации выше.
*Windows: нужно установить [http://www.winchiphead.com/download/CH341/CH341SER.ZIP драйвер адаптера]: /CH341SER/Setup.exe (запуск от имени администратора). В Диспетчере устройств (Device Manager) в разделе Ports(COM&LPT) должен появиться виртуальный COM-порт контроллера. Если не очевидно, какой из портов используется контроллером, можно отсоединить кабель и включить снова.


В качестве программы для общения с контроллером мы рекомендуем использовать [https://mobaxterm.mobatek.net/ MobaXterm] от компании Mobatek. ЕЕ возможности очень обширны. В платной версии их больше, но для наших целей достаточно и бесплатной версии.


Нам нужно создать новую сессию '''Sessions''' → '''New session''' → '''Serial''':
[[Файл:Sessions.png|left]]
<br clear="both" />


и настроить ее:
'''Примечание.''' Начиная с ревизии '''6.4''' используется другой адаптер USB-Serial.  
[[Файл:Basic.png|left]]
<br clear="both" />


Во вкладке '''Terminal settings''' вы можете настроить шрифт, цвета и, при необходимости, указать файл для записи всего, что будет выводится на экран во время сеанса:
*Linux: адаптер обычно определяется автоматически как ''/dev/ttyACM0'', при этом номер порта ttyACM может быть иным в зависимости от уже подключенных устройств. Тем не менее, для корректной работы отладочной консоли на контроллерах данной ревизии на linux-системах, рекомендуется [[#Настройка работы отладочного порта в linux для WB6.4 и выше | настроить правило ''udev'' для ModemManager]].
[[Файл:SessionLog.png|left]]
<br clear="both" />


А во вкладке '''Bookmark settings''' укажите внятное название сессии:
*Windows 8/10: дополнительные драйвера не требуются. В Диспетчере устройств (Device Manager) в разделе Ports(COM&LPT) должен появиться виртуальный COM-порт контроллера. Если не очевидно, какой из портов используется контроллером, можно отсоединить кабель и включить снова.
[[Файл:SessionName.png|left]]
<br clear="both" />


=== Linux ===
Переходите к [[#Настройка работы с последовательным портом | настройке работы с последовательным портом]].
Порт должен назначиться автоматически. В выводе команды dmesg контроллеров '''Wiren Board 6.4 или новее''' должна появиться строка:
<syntaxhighlight lang="console">
cdc_acm:3-6:1.0: ttyACM0: USB ACM device
</syntaxhighlight>


В '''более ранних''' версиях:
<!--T:108-->
<syntaxhighlight lang="console">
usb 1-1: ch341-uart converter now attached to ttyUSB0
</syntaxhighlight>


Номер порта ttyUSBx или ttyACMx может меняться, в зависимости от того, что у вас подключено к контроллеру.  
== Подключение к отладочному порту в Wiren Board 5.6 и младше== <!--T:4-->
'''Как найти порт:'''


Для работы с Debug console мы рекомендуем использовать Minicom. Команда для подключения будет выглядеть так:
Читайте ниже в разделе [[#Wiren Board 5 | Как найти штырьки разъема отладочного порта]] .
<syntaxhighlight lang="console">
minicom -D /dev/ttyACM0 -b 115200 -8 -a off
</syntaxhighlight>
Скорее всего, для доступа к порту вам понадобятся права суперпользователя - используйте sudo.


Более подробно про Minicom смотрите в нашем [[Minicom | руководстве]].
'''Как подключать:'''


==== Linux — возможные проблемы ====
Для подключения понадобится переходник USB-UART.
Сервис '''ModemManager''' может мешать работе с портом. Если у вас WirenBoard 6.4 или новее — правильно сконфигурируйте udev.
'''Внимание!'''
* Создайте файл исключений udev:
[[Файл:Duart.jpg|thumb|right|Адаптер USB-UART]]
<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>


В свежих операционных системах Linux может потребоваться отредактировать файл:
* Подключайте Debug UART только через переходники USB-UART с напряжением 3.3 В.
<syntaxhighlight lang="bash">
* UART не является синонимом RS-232 (где напряжение на линии может быть 5 В, 12 В и т.д.). Подключение Debug UART к порту RS-232 (или переходнику USB-RS-232) напрямую '''приведет к необратимому повреждению устройства'''.
/lib/systemd/system/ModemManager.service
</syntaxhighlight>


Подробности здесь:


[https://bugs.launchpad.net/ubuntu/+source/modemmanager/+bug/1827328 ModemManager does not honor blacklisted ttys]
Подключите адаптер USB-UART к компьютеру, соедините контакты адаптера с контактами (штырьками) отладочного порта на контроллере по схеме:
*GND к GND,
*TX к RX,
*RX к TX.
На некоторых переходниках маркировка перепутана — попробуйте соединить TX с TX и RX с RX.  


[https://nick.zoic.org/art/failed-to-set-dtr-rts-systemd-modemmanager SystemD ModemManager: failed to set dtr/rts]


=== MacOS ===
'''Драйвер адаптера и номер виртуального COM-порта:'''
{{note|warn| Если у вас Wiren Board 7 и Mac с USB Тип C на процессоре Intel - нужно отключить питание контроллера, он будет питаться от USB. При наличии питания порт операционной системой не определяется. На более старые Mac и Mac на процессорах Apple эта особенность не распространяется. }}


Начиная с версии MacOS '''10.14 Mojave'''  все должно определиться автоматически. Предыдущие версии, возможно, потребуют установки драйвера [http://www.wch.cn/download/ch341ser_mac_zip.html CH341SER_MAC].  
*Windows: установите драйвер конкретного адаптера.  
*Linux: адаптер скорее всего будет сразу поддерживаться ядром, но, возможно, придётся скомпилировать соответствующий модуль.


При подключении создается устройство:
Переходите к [[#Настройка работы с последовательным портом | настройке работы с последовательным портом]].
{| border="1" class="wikitable"
! Wiren Board 7 || Wiren Board 6.4 и новее || Более ранние
|-
| /dev/tty.usbmodemWB71 || /dev/tty.usbmodem00001 ||  /dev/tty.usbserial-1410
|-
|}


Встроенная утилита cu позволит вам работать с Debug console:
== Настройка работы с последовательным портом == <!--T:7-->
<syntaxhighlight lang="bash">
=== Установка программы для работы с последовательным портом ===
sudo cu -s 115200 -l /dev/tty.usbserial-1410
</syntaxhighlight>


Для выхода из cu введите символы
<!--T:8-->
<syntaxhighlight lang="bash">
Для работы с последовательным портом установите на вашем компьютере подходящую утилиту - например, PuTTY:
~!
* версия для Windows - [http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe скачать с официального сайта]
</syntaxhighlight>
* версия для Linux Debian или Ubuntu - выполните команду ''apt-get install putty''
Подойдут также [http://elinux.org/RPi_Serial_Connection другие программы].


==== MacOS — возможные проблемы ====
Настройки соединения: '''115200 8N1''' (115200 кбит/с, 8 бит, нет бита чётности, один стоп-бит), root/wirenboard.
Порт может не определиться. Потребуется установка драйвера. Для этого (начиная с MacOS '''High Sierra 10.13''') нужно дать на это разрешение в <code>Settings → Security&Privacy → Allow apps downloaded from:</code>
[[Файл:Allow.png|left]]
<br clear="both" />


И вот хорошая [https://kig.re/2014/12/31/how-to-use-arduino-nano-mini-pro-with-CH340G-on-mac-osx-yosemite.html статья] - человек подключает Arduino к MacOS. Хоть устройство и другое, но там используется точно такой же чип. Возможно, там есть ответы на ваши вопросы.
=== Подключение === <!--T:9-->


=== Android ===
<!--T:10-->
[[Файл:OTG.png|150px|thumb|right| OTG-кабель]]
#Запустите приложение от имени администратора:
Начиная с Android версии 9 все работает без установки дополнительных драйверов. Подключение через OTG. Тестировалось с приложением [https://play.google.com/store/apps/details?id=jp.sugnakys.usbserialconsole&hl=en_US USB Serial Console], если ссылка не работает - ищите в Google Play.
#* в Windows - щёлкните по значку PuTTY правой кнопкой и выберите ''Run This Program As An Administrator''
<br clear="both" />
#* в Linux - <code>gksu putty</code> <br /><br />
#В меню слева выберите последний пункт - ''Serial''. В появившиеся поля справа введите настройки порта:
#*название последовательного порта
#**для Windows - это ''COM4'' ('''цифра может меняться''', см.выше)
#**для Linux - это ''/dev/ttyUSB0'' либо ''/dev/ttyACM0'' (для WB6.4 и выше). '''Цифра может меняться''', см.выше.
#*скорость - ''115200''
#*количество битов в посылке - ''8''
#*количество стоп-битов - ''1''
#*чётность - ''нет''
#*контроль потока - ''нет'' <br /><br />
#:[[Файл:Putty serial settings.png|500px]] <br /><br />
#В меню слева выберите первый пункт - ''Session''. Справа переключите тип подключения на Serial - должны автоматически заполниться настройки порта. Затем нажмите ''Open''.<br /><br />
#:[[Файл:Putty serial open.png|500px]] <br /><br />
#Чтобы проверить, правильно ли вы всё сделали:
#*для Wiren Board 5.6 и младше: кнопкой выключите и включите контроллер - на экране должны появиться сообщения о загрузке.  
#*для Wiren Board 5.8 и старше: нажмите Enter. Будет предложена авторизация.
#**запрос логина - введите ''root'' и нажмите ''Enter'',
#**запрос пароля - введите ''wirenboard'' (вводимые символы не будут отображаться) и нажмите ''Enter''.<br /><br />
#Появится приветственное сообщение - вы в консоли контроллера. Для перехода в визуальный файловый менеджер введите <code>mc</code>.<br /><br />
#:[[Файл:Putty serial logged in.png|500px]]


== Работа с отладочным портом ==
== Как найти штырьки разъёма отладочного порта на Wiren Board 5.6 и младше ==
[[Файл:DebugConsoleWindowLogin.png|500px|thumb|right| Отладочная консоль]]
=== Wiren Board 5 ===
Итак:
Debug UART для версии 5.3 выведен на боковую панель, для 5.6 - выведен на гребенку между разъемами FW и IR.
* Контроллер к компьютеру подключен;
* Программа запущена;
* Настройки порта программы соответствуют настройкам порта Debug console.
Теперь можно начинать работу.  


''' Если контроллер исправен '''
<gallery mode="packed" heights=200 widths=200 style="text-align:left">
Image:Wb53 uart.jpg|Wiren Board 5.3
Image:Wb56 uart.jpg|Wiren Board 5.6
</gallery>
=== Wiren Board 4 ===
Выведен на боковую панель рядом с разъёмами для microSD и microSIM карт.


Если контроллер работает нормально — вы будете видеть сообщения, выводимые операционной системой контроллера на консоль. Нажав клавишу ENTER, вы увидите приглашение операционной системы, типа такого:
===Wiren Board Smart Home 3.5===
<syntaxhighlight lang="console">
Debug UART выведен на разъём UEXT1, а также отдельно на гребёнку (рядом с аудиовыходом, см. схему)
Debian GNU/Linux 11 wirenboard-AQ4RCD2E ttyS0
Для Debug UART используются ножки 2,3,4 (см. рисунок).


wirenboard-AQ4RCD2E login:
<gallery mode="packed" heights=400 widths=400 style="text-align:left">
</syntaxhighlight>
Image:WB3.5.png|Wiren Board Smart Home rev 3.5
</gallery>


Вводите логин, пароль ({{Wbincludes:Controller SSH Default Login Password|short=true}}) — командная строка в вашем распоряжении. Можете настроить сеть, исправить конфигурационные файлы, посмотреть логи и т. д.  
===Wiren Board 2.8===
Выведен на разъём UEXT1 (чёрный разъём с десятью штырьками на длинной стороне платы).


ВАЖНО! При работе с Debug console на экран время от времени будут «выпадать» сообщения от работающих сервисов Linux. Особенно, если сервис работает с ошибкой. Вы можете продолжать ввод команды с клавиатуры — все будет отработано корректно. Для отключения вывода «лишних» сообщений на экран используйте команду <code>dmesg -n1</code>. Теперь будут выводится только те сообщения, которые требуют немедленного вмешательства.
<gallery mode="packed" heights=200 widths=200 style="text-align:left">
Image:UEXTPINS.jpg|thumb|UEXT pinout for [[Insulation-displacement connector|IDC]] connector<br/>(looking into connector on host board)
</gallery>


Логи можно смотреть через [[Journalctl]].
== Настройка работы отладочного порта в linux для WB6.4 и выше ==


''' Если контроллер неисправен '''
'''Суть проблемы:''' на некоторых системах процесс ModemManager автоматически открывает устройство ''/dev/ttyACM0''.
Для этого необходимо отключить ModemManager для данного устройства с помощью правил ''udev''.


Если контроллер нормально не функционирует - отключите питание контроллера выключателем.
* Создаем файл исключений ''udev''
{{note|info| Для Wiren Board 7 также отключите кабель USB (контроллер получает питание от USB, в обход выключателя). }}
<syntaxhighlight lang="bash"> sudo nano /etc/udev/rules.d/99-wb-debug-usb.rules </syntaxhighlight>
Включите питание контроллера. Начнется загрузка контроллера.
{{note|info| Для Wiren Board 7 сначала присоедините кабель (сразу начнется загрузка контроллера), затем включите выключатель (для питания модулей расширения).}}
Наблюдайте сообщения, появляющиеся на экране при загрузке контроллера. Текст меняется быстро, отследить его невозможно. Но, если возникнет критическая ошибка — загрузка остановится, и сообщение об ошибке будет у вас перед глазами.


Пролистывая экран назад вы можете просмотреть все сообщения, выведенные при загрузке. Обращайте внимание на  слова error, warning, filed. Не можете сами разобраться — записывайте сеанс в лог файл и обращайтесь в нашу техподдержку.
* в который записываем cтрочку
<syntaxhighlight lang="bash"> ATTRS{idVendor}=="04d9" ATTRS{idProduct}=="b534", ENV{ID_MM_DEVICE_IGNORE}="1" </syntaxhighlight>


== Физическая реализация в контроллерах ==
* После сохранения файла необходимо перезагрузить правила ''udev'':
{|  border="1" class="wikitable"
<syntaxhighlight lang="bash"> sudo udevadm control --reload-rules </syntaxhighlight>
! Версия контроллера || Тип разъема || Название разъема || Интерфейс || Чип USB/UART
|-
| 7.x || USB-C ||  Debug Console || USB/UART || HT42B534
|-
| 6.4-6.9 || Micro-USB ||  Debug Console || USB/UART || HT42B534
|-
| 5.8-6.3 || Micro-USB ||  Debug Console || USB/UART || CH340
|-
| 5.6.1 || 3-pin UART (Gnd, Rx, TX) ||  UART || UART (3,3B) || -
|-
| 4, 5.3 || 3-pin UART (Gnd, Rx, TX) ||  Debug UART || UART (3,3B) || -
|-
| 2.8, 3.5 || 3-pin UART (Gnd, Rx, TX) ||  UEXT1 (выводы 2,3,4) и 3-pin разъем без названия|| UART (3,3B) || -
|-
|}
Программно во всех случаях это последовательный порт.

Версия 18:30, 18 декабря 2018



Контроллеры Wiren Board имеют отладочный порт, через который можно получить прямой доступ к консоли контроллера. Через него можно взаимодействовать с загрузчиком и следить за загрузкой операционной системы (последовательная консоль, serial console). Другие способы подключения к контроллеру: через веб-интерфейс, по SSH.

Физическая реализация порта отладочной консоли

Физически в разных версиях контроллера отладочный порт реализован по разному:

  • для версий WB 6 и позднее он выглядит как Micro-USB разъём (подпись Debug Console);
  • для версий WB 5.8 и позднее он выглядит как Micro-USB разъём (подпись Debug Console или Debug USB);
  • для версий WB 5.6 и ранее он выглядит как трёхштыревой разъём (подпись Debug UART).

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

Разъем Debug USB

Подробнее см. таблицу:

Версия коннтроллера Тип разъема Название разъема Интерфейс Чип USB/UART
6.4 и старше microUSB Debug Console USB/UART HT42B534-1
6.0 — 6.3 microUSB Debug Console USB/UART CH340/CH341
5.8 — 5.9 microUSB Debug Console USB/UART CH340/CH341
5.6.1 3-pin UART (Gnd, Rx, Tx) UART UART (3,3 В) —
5.3 3-pin UART (Tx, Rx, GND) Debug UART UART (3,3 В) —
4 3-pin UART (Gnd, Rx, Tx) Debug UART UART (3,3 В) —
3.5 3-pin UART (Gnd, Tx, Rx) UEXT1 (выводы 2,3,4) и 3-pin разъем без названия UART (3,3 В) —
2.8 3-pin UART (Gnd, Tx, Rx) UEXT1 (выводы 2,3,4) и 3-pin разъем без названия UART (3,3 В) —


Поддержка в oперационных системах

Версия контроллера Linux Windows XP, 7, 8 Windows 10 MacOS X (High Sierra) Android 9 + USB Serial Console
6.4 и старше Модуль ядра cdc_acm (все новые дистрибутивы — из коробки) Необходим драйвер HT42B534-1 или inf-файл (см. ниже) Из коробки Из коробки Из коробки
6.0 — 6.3 Модуль ядра ch341 (все новые дистрибутивы — из коробки) Необходим драйвер CH341SER Из коробки [CH341SER_MAC.ZIP] Из коробки
5.8 — 5.9 Модуль ядра ch341 (все новые дистрибутивы — из коробки) Необходим драйвер CH341SER Из коробки [CH341SER_MAC.ZIP] Из коробки

Для контроллеров версии 5.6.1 и младше требуется переходник USB/UART. В новых моделях контроллеров используется чип Holtek HT42B534-1. Вы можете использовать драйверы производителя чипа, или установить Файл:Wb-debug-uart.inf.zip inf-файл.

Поддержка переходников USB/UART

Переходник USB/UART (чип) Linux Windows XP, 7, 8 Windows 10 MacOS X (High Sierra) Android 9 + USB Serial Console
FTDI232 Модуль ядра ftdi_sio требуют драйверов на ОС из коробки требуют драйверов на ОС из коробки Нет информации Из коробки
CP2102 Модуль ядра cp210x Silicon Labs CP210x VCP Driver Silicon Labs CP210x VCP Driver Silicon Labs CP210x VCP Driver Из коробки
CH340/CH341 Модуль ядра ch341 Необходим драйвер CH341SER Из коробки CH341SER_MAC.ZIP Из коробки
PL2303xx Модуль ядра pl2303 необходим драйвер возможно, необходим драйвер нет информации нет информации

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

Кабель USB — Micro-USB
Номер порта в Windows

Как найти порт:

На корпусе напротив разъема отладочного порта находится надпись Debug Console.

Как подключать:

Для подключения понадобится стандартный кабель USB — Micro-USB - такой же, как для подключения сотовых телефонов. Более точное название кабеля USB (A) — Micro-USB (B). Разъем USB (А) подключается к компьютеру, Micro-USB (B) — к контроллеру.

Кабели от зарядных устройств подходят, но бывают исключения. Лучше выбирать такие, на которых указано, что они предназначены для передачи данных. Если кабель выбран правильно, Windows сообщит звуком об обнаружении устройства.

Драйвер адаптера и номер виртуального COM-порта:

Внутри контроллера установлен переходник USB-UART (в версиях контроллера WB5.8-WB6.3 используется адаптер USB-Serial CH340/CH341).

  • Linux: адаптер обычно определяется автоматически, при подключении в выводе команды dmesg должна появится строка usb 1-1: ch341-uart converter now attached to ttyUSB0. Номер порта ttyUSB может меняться, в зависимости от уже подключенных устройств. Смотрите список файлов в папке /dev/ .
  • Windows: нужно установить драйвер адаптера: /CH341SER/Setup.exe (запуск от имени администратора). В Диспетчере устройств (Device Manager) в разделе Ports(COM&LPT) должен появиться виртуальный COM-порт контроллера. Если не очевидно, какой из портов используется контроллером, можно отсоединить кабель и включить снова.


Примечание. Начиная с ревизии 6.4 используется другой адаптер USB-Serial.

  • Linux: адаптер обычно определяется автоматически как /dev/ttyACM0, при этом номер порта ttyACM может быть иным в зависимости от уже подключенных устройств. Тем не менее, для корректной работы отладочной консоли на контроллерах данной ревизии на linux-системах, рекомендуется настроить правило udev для ModemManager.
  • Windows 8/10: дополнительные драйвера не требуются. В Диспетчере устройств (Device Manager) в разделе Ports(COM&LPT) должен появиться виртуальный COM-порт контроллера. Если не очевидно, какой из портов используется контроллером, можно отсоединить кабель и включить снова.

Переходите к настройке работы с последовательным портом.


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

Как найти порт:

Читайте ниже в разделе Как найти штырьки разъема отладочного порта .

Как подключать:

Для подключения понадобится переходник USB-UART. Внимание!

Адаптер 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.


Драйвер адаптера и номер виртуального COM-порта:

  • Windows: установите драйвер конкретного адаптера.
  • Linux: адаптер скорее всего будет сразу поддерживаться ядром, но, возможно, придётся скомпилировать соответствующий модуль.

Переходите к настройке работы с последовательным портом.

Настройка работы с последовательным портом

Установка программы для работы с последовательным портом

Для работы с последовательным портом установите на вашем компьютере подходящую утилиту - например, PuTTY:

Подойдут также другие программы.

Настройки соединения: 115200 8N1 (115200 кбит/с, 8 бит, нет бита чётности, один стоп-бит), root/wirenboard.

Подключение

  1. Запустите приложение от имени администратора:
    • в Windows - щёлкните по значку PuTTY правой кнопкой и выберите Run This Program As An Administrator
    • в Linux - gksu putty

  2. В меню слева выберите последний пункт - Serial. В появившиеся поля справа введите настройки порта:
    • название последовательного порта
      • для Windows - это COM4 (цифра может меняться, см.выше)
      • для Linux - это /dev/ttyUSB0 либо /dev/ttyACM0 (для WB6.4 и выше). Цифра может меняться, см.выше.
    • скорость - 115200
    • количество битов в посылке - 8
    • количество стоп-битов - 1
    • чётность - нет
    • контроль потока - нет

    Putty serial settings.png

  3. В меню слева выберите первый пункт - Session. Справа переключите тип подключения на Serial - должны автоматически заполниться настройки порта. Затем нажмите Open.

    Putty serial open.png

  4. Чтобы проверить, правильно ли вы всё сделали:
    • для Wiren Board 5.6 и младше: кнопкой выключите и включите контроллер - на экране должны появиться сообщения о загрузке.
    • для Wiren Board 5.8 и старше: нажмите Enter. Будет предложена авторизация.
      • запрос логина - введите root и нажмите Enter,
      • запрос пароля - введите wirenboard (вводимые символы не будут отображаться) и нажмите Enter.

  5. Появится приветственное сообщение - вы в консоли контроллера. Для перехода в визуальный файловый менеджер введите mc.

    Putty serial logged in.png

Как найти штырьки разъёма отладочного порта на Wiren Board 5.6 и младше

Wiren Board 5

Debug UART для версии 5.3 выведен на боковую панель, для 5.6 - выведен на гребенку между разъемами FW и IR.

  • Wiren Board 5.3

  • Wiren Board 5.6

Wiren Board 4

Выведен на боковую панель рядом с разъёмами для microSD и microSIM карт.

Wiren Board Smart Home 3.5

Debug UART выведен на разъём UEXT1, а также отдельно на гребёнку (рядом с аудиовыходом, см. схему) Для Debug UART используются ножки 2,3,4 (см. рисунок).

  • Wiren Board Smart Home rev 3.5

Wiren Board 2.8

Выведен на разъём UEXT1 (чёрный разъём с десятью штырьками на длинной стороне платы).

  • UEXT pinout for IDC connector
    (looking into connector on host board)

Настройка работы отладочного порта в linux для WB6.4 и выше

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

  • Создаем файл исключений udev
 sudo nano /etc/udev/rules.d/99-wb-debug-usb.rules
  • в который записываем cтрочку
 ATTRS{idVendor}=="04d9" ATTRS{idProduct}=="b534", ENV{ID_MM_DEVICE_IGNORE}="1"
  • После сохранения файла необходимо перезагрузить правила udev:
 sudo udevadm control --reload-rules
Источник — https://wirenboard.com/wiki/index.php?title=Debug_Console&oldid=16385