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

723 байта добавлено ,  4 месяца назад
 
(не показано 11 промежуточных версий 2 участников)
Строка 2: Строка 2:
== Описание ==
== Описание ==
У контроллеров Wiren Board есть отладочный порт. Он обозначен как «Debug console».
У контроллеров 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, вы сможете увидеть информацию, выводимую контроллером на экран при его начальной загрузке.
Подключившись к нему, как и в случае [[SSH | SSH]] подключения, вы превращаете свой компьютер в монитор и клавиатуру контроллера. И получаете доступ к его консоли (командной строке). А в отличие от SSH, вы сможете увидеть информацию, выводимую контроллером на экран при его начальной загрузке.
Строка 8: Строка 13:


== Подключение ==
== Подключение ==
[[Файл:USBA-USBC.png|right|170px|thumb| USB (A) – USB-c ]]
{{YouTube
[[Файл:USBA-MICROUSBB.png|right|170px|thumb| USB (A) – Micro-USB (B) ]]
|link=https://youtu.be/VA_XHrY1RVA?t=135
Если у вас контроллер Wiren Board 5.6 и старее, обратитесь к статье [[WB5.6_Debug_Console| Подключение к отладочному порту в Wiren Board 5.6 и младше. ]].
|text= Про командную строку, SSH и Debug Console}}
 
Если у вас контроллер Wiren Board 5.6 и старее, обратитесь к [[WB5.6_Debug_Console| статье ]].


Подключение выполняется стандартными кабелями, их легко купить. В комплекте с вашим смартфоном может быть такой.  
Подключение выполняется стандартными кабелями, их легко купить. В комплекте с вашим смартфоном может быть такой.  


{{note|warn| Бывают кабели с такими же разъёмами, но предназначенные только для зарядки — с ними могут быть проблемы. }}
{{note|warn| Бывают кабели с такими же разъёмами, но предназначенные только для зарядки — они не подойдут. }}


Для подключения  '''Wiren Board 7''' к компьютеру нужен кабель '''USB (A) – USB-c'''.
Для подключения  '''Wiren Board 7''' к компьютеру нужен кабель '''USB Тип A – USB Тип C'''.


Для подключения более ранних контроллеров - '''USB (A) – Micro-USB (B)'''.
Для подключения более ранних контроллеров - '''USB тип A – Micro-USB Тип B'''.


Далее надо настроить операционную систему и программу.
Самый простой способ проверить, подходит ли кабель для подключения к контроллеру — подключить к компьютеру через этот кабель мобильный телефон. Если компьютер обнаружил новое устройство — кабель можно использовать и для контролера.


== Настройка операционной системы, программное обеспечение ==
== Настройка порта, программное обеспечение ==
Необходимо определить, к какому порту компьютера подключен Wiren Board, и настроить этот порт в соответствии с настройками Debug console.  
Необходимо определить, к какому порту компьютера подключен Wiren Board, и настроить этот порт в соответствии с настройками Debug console.  
{|  border="1" class="wikitable"  
{|  border="1" class="wikitable"  
Строка 44: Строка 51:


=== Windows ===
=== Windows ===
Если у вас на компьютере '''Windows 10''', а контроллер '''Wiren Board 6.4 или новее''', то система сама, после физического подключения, назначит виртуальный COM порт и установит необходимый драйвер. Увидеть это можно в Диспетчере устройств Windows:
Если у вас на компьютере '''Windows 10''', а контроллер '''Wiren Board 6.4 или новее''', то система сама, после физического подключения, назначит виртуальный COM порт и установит необходимый драйвер. Увидеть номер этого порта можно в Диспетчере устройств Windows:
[[Файл:Dispatcher.png|left]]
[[Файл:Dispatcher.png|left]]
<br clear="both" />
<br clear="both" />


При использовании '''Windows XP, 7, 8''' скачайте и установите драйвер:
При использовании '''Windows XP, 7, 8''' скачайте и установите драйвер. Для установки драйвера вам потребуются навыки администрирования ОС Windows, ссылки на файлы:
* для [https://wirenboard.com/wiki/images/3/38/HT42B534_inf.zip Wiren Board 6.4 или старше];
* для [https://wirenboard.com/wiki/images/3/38/HT42B534_inf.zip Wiren Board 6.4 или новее];
* для [http://www.wch.cn/downloads/CH341SER_ZIP.html более ранних версий].
* для [http://www.wch.cn/downloads/CH341SER_ZIP.html более ранних версий].
 
Далее подключайте контроллер, и в Диспетчере устройств Windows вы должны увидеть виртуальный COM порт, как на иллюстрации выше.
Далее подключайте контроллер, и в Диспетчере устройств Windows вы должны увидеть виртуальный COM порт, как на иллюстрации выше.


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


Нам нужно создать новую сессию '''Sessions''' → '''New session''' → '''Serial''':
Нам нужно создать новую сессию '''Sessions''' → '''New session''' → '''Serial''':
Строка 87: Строка 94:
Для работы с Debug console мы рекомендуем использовать Minicom. Команда для подключения будет выглядеть так:
Для работы с Debug console мы рекомендуем использовать Minicom. Команда для подключения будет выглядеть так:
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
minicom -D /dev/ttyUSB0 -b 115200 -8 -a off
minicom -D /dev/ttyACM0 -b 115200 -8 -a off
</syntaxhighlight>
</syntaxhighlight>
Скорее всего, для доступа к порту вам понадобятся права суперпользователя - используйте sudo.
Скорее всего, для доступа к порту вам понадобятся права суперпользователя - используйте sudo.
Строка 108: Строка 115:
</syntaxhighlight>
</syntaxhighlight>


Для '''более ранних''' контроллеров необходимо отредактировать файл:  
В свежих операционных системах Linux может потребоваться отредактировать файл:  
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
/lib/systemd/system/ModemManager.service
/lib/systemd/system/ModemManager.service
Строка 120: Строка 127:


=== MacOS ===
=== MacOS ===
{{note|warn| Если у вас Wiren Board 7 и Mac с USB Type-C на процессоре Intel - нужно отключить питание контроллера, он будет питаться от USB. При наличии питания порт операционной системой не определяется. На более старые Mac и Mac на процессорах Apple эта особенность не распространяется. }}
{{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].  
Начиная с версии MacOS '''10.14 Mojave'''  все должно определиться автоматически. Предыдущие версии, возможно, потребуют установки драйвера [http://www.wch.cn/download/ch341ser_mac_zip.html CH341SER_MAC].  
Строка 155: Строка 162:


== Работа с отладочным портом ==
== Работа с отладочным портом ==
[[Файл:Putty serial logged in.png|500px|thumb|right| Отладочная консоль]]
[[Файл:DebugConsoleWindowLogin.png|500px|thumb|right| Отладочная консоль]]
Итак:
Итак:
* Контроллер к компьютеру подключен;
* Контроллер к компьютеру подключен;
Строка 164: Строка 171:
''' Если контроллер исправен '''  
''' Если контроллер исправен '''  


Если контроллер работает нормально - вы будете видеть сообщения, выводимые операционной системой контроллера на консоль. Нажав клавишу ENTER, вы увидите приглашение операционной системы, типа такого:  
Если контроллер работает нормально вы будете видеть сообщения, выводимые операционной системой контроллера на консоль. Нажав клавишу ENTER, вы увидите приглашение операционной системы, типа такого:  
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
Debian GNU/Linux 11 wirenboard-AQ4RCD2E ttyS0
Debian GNU/Linux 11 wirenboard-AQ4RCD2E ttyS0
Строка 170: Строка 177:
wirenboard-AQ4RCD2E login:
wirenboard-AQ4RCD2E login:
</syntaxhighlight>
</syntaxhighlight>
Вводите логин, пароль — командная строка в вашем распоряжении. Можете настроить сеть, исправить конфигурационные файлы, посмотреть логи и т. д.  
 
Вводите логин, пароль ({{Wbincludes:Controller SSH Default Login Password|short=true}}) — командная строка в вашем распоряжении. Можете настроить сеть, исправить конфигурационные файлы, посмотреть логи и т. д.  


ВАЖНО! При работе с Debug console на экран время от времени будут «выпадать» сообщения от работающих сервисов Linux. Особенно, если сервис работает с ошибкой. Вы можете продолжать ввод команды с клавиатуры — все будет отработано корректно. Для отключения вывода «лишних» сообщений на экран используйте команду <code>dmesg -n1</code>. Теперь будут выводится только те сообщения, которые требуют немедленного вмешательства.
ВАЖНО! При работе с Debug console на экран время от времени будут «выпадать» сообщения от работающих сервисов Linux. Особенно, если сервис работает с ошибкой. Вы можете продолжать ввод команды с клавиатуры — все будет отработано корректно. Для отключения вывода «лишних» сообщений на экран используйте команду <code>dmesg -n1</code>. Теперь будут выводится только те сообщения, которые требуют немедленного вмешательства.
Логи можно смотреть через [[Journalctl]].


''' Если контроллер неисправен '''
''' Если контроллер неисправен '''


Если контроллер нормально не функционирует - отключите питание контроллера клавишей питания.  
Если контроллер нормально не функционирует - отключите питание контроллера выключателем.  
{{note|info| Для Wiren Board 7 отключите и кабель USB (контроллер получает питание от USB, в обход клавиши питания). }}
{{note|info| Для Wiren Board 7 также отключите кабель USB (контроллер получает питание от USB, в обход выключателя). }}
Включите питание контроллера. Начнется загрузка контроллера.
Включите питание контроллера. Начнется загрузка контроллера.
{{note|info| Для Wiren Board 7 сначала присоедините кабель (сразу начнется загрузка контроллера), затем включите клавишу питания (для питания модулей расширения).}}
{{note|info| Для Wiren Board 7 сначала присоедините кабель (сразу начнется загрузка контроллера), затем включите выключатель (для питания модулей расширения).}}
Наблюдайте сообщения, появляющиеся на экране при загрузке контроллера. Текст меняется быстро, отследить его невозможно. Но, если возникнет критическая ошибка — загрузка остановится, и сообщение об ошибке будет у вас перед глазами.
Наблюдайте сообщения, появляющиеся на экране при загрузке контроллера. Текст меняется быстро, отследить его невозможно. Но, если возникнет критическая ошибка — загрузка остановится, и сообщение об ошибке будет у вас перед глазами.


Пролистывая экран назад вы можете просмотреть все сообщения, выведенные при загрузке. Обращайте внимание на  error, warning, filed. Не можете сами разобраться — записывайте сеанс в лог файл и обращайтесь в нашу техподдержку.
Пролистывая экран назад вы можете просмотреть все сообщения, выведенные при загрузке. Обращайте внимание на  слова error, warning, filed. Не можете сами разобраться — записывайте сеанс в лог файл и обращайтесь в нашу техподдержку.


== Физическая реализация в контроллерах ==
== Физическая реализация в контроллерах ==