Узнайте, как собирать отладочную информацию с IP-телефонов Android, таких как GP32i, BX7A, BF600S, BJ7A и Bi56A, включая syslog, отладочные пакеты, захваты пакетов, журналы ADB и скриншоты.
При возникновении проблемы во время внутреннего тестирования или развертывания IP-телефонов на Android у клиентов технический персонал может потребоваться предоставить отладочную информацию для устранения неполадок и анализа. Это руководство объясняет, как собрать необходимые диагностические файлы.
GP32i, BX7A, BF600S, BJ7A, Bi56A
1. Подготовьте один IP-телефон на Android, одну USB-флешку и коммутатор PoE или источник питания DC. Подключите телефон к коммутатору.
2. Подготовьте ПК для отладки и подключите его к тому же коммутатору. Убедитесь, что ПК и телефон могут взаимодействовать друг с другом по сети.
Подключите IP-телефон на Android (здесь в качестве примера используется A32i) к коммутатору, а ПК — к тому же коммутатору. Убедитесь, что сеть между ПК и устройством доступна. Пример подключения показан на Рисунке 1.
Рисунок 1. Схема подключения устройства и ПК
В зависимости от проблемы для анализа могут потребоваться различные типы диагностической информации. В следующих разделах объясняется, какие файлы следует предоставлять при разных обстоятельствах.
В большинстве случаев необходимо собрать три файла и предоставить их команде R&D:
1. Файл отладочного Syslog
Войдите в веб-интерфейс телефона и перейдите в System > Support Page, затем найдите System Log.
Настройте следующие параметры:
1) Включите Syslog
2) Установите Адрес сервера на IP-адрес локального ПК
3) Установите Порт сервера на 514
4) Установите Уровень системного журнала на Debug
5) Включите Экспорт журнала
6) После воспроизведения проблемы нажмите Экспорт журнала, чтобы скачать файл Syslog
Рисунок 2. Экспорт отладочного syslog
2. Отладочный пакет
Отладочный пакет содержит кэшированные журналы, информацию о работе, данные прошивки и другие внутренние диагностические данные телефона. Его можно экспортировать из веб-интерфейса.
Перейдите в System > Support Tool, найдите опцию Однокlickовый экспорт отладочной информации и нажмите Экспорт. Этот процесс может занять около одной минуты.
Рисунок 3. Экспорт отладочного пакета
3. Файл захвата сетевых пакетов
Файл захвата пакетов записывает переданные и принятые сетевые пакеты и может использоваться для анализа в таких инструментах, как Wireshark.
Для захвата сетевого трафика:
1) Нажмите Старт и дождитесь, пока веб-страница начнет процесс захвата
2) Воспроизведите проблему
3) После воспроизведения проблемы нажмите Стоп
4) Откройте страницу загрузок браузера, чтобы найти файл захваченных пакетов
Рисунок 4. Захват сетевых пакетов
После предоставления трех описанных выше файлов в некоторых ситуациях может потребоваться дополнительная информация.
После просмотра отладочного Syslog, отладочного пакета и захвата пакетов команда R&D может запросить журналы Android в реальном времени для поддержки более глубокого анализа. В следующем разделе объясняется, как собирать журналы Android в реальном времени с помощью ADB.
Журнал Android в реальном времени
Платформа Android непрерывно выводит журналы работы во время работы телефона. Эти журналы помогают инженерам определить и проанализировать проблемы.
1. Установите инструмент ADB на ПК
Вы можете скачать подходящий инструмент ADB для вашей операционной системы по адресу:
https://developer.android.google.cn/studio/releases/platform-tools
После установки добавьте путь установки ADB в системные переменные окружения. В Windows перейдите в Этот компьютер > Свойства > Дополнительные параметры системы > Дополнительно > Переменные окружения, затем добавьте абсолютный путь к каталогу ADB в переменную Path.
Рисунок 5. Добавление пути ADB
Откройте командную строку на ПК и введите команду adb. Если команда выполнена успешно, ADB установлен правильно.
Рисунок 6. Успешная установка ADB
2. Включите отладку по USB на телефоне
Для прошивки Android, выпущенной после 1 декабря 2020 года, отладка ADB отключена по умолчанию и должна быть включена вручную.
Вставьте USB-флешку в телефон, затем перейдите в Настройки > О устройстве и нажмите пять раз на номер версии прошивки, чтобы включить Режим разработчика.
Рисунок 7. Включение режима разработчика
Затем перейдите в Настройки > Система > Параметры разработчика и включите Отладку по USB.
Рисунок 8. Включение отладки по USB
3. Измените уровень отладочного журнала
Уровень журнала телефона по умолчанию обычно установлен на Notice, который записывает только основную информацию. Для захвата более детальных журналов измените уровень журнала на Trace.
Перейдите в Настройки телефона > Обслуживание системы > Инструменты и установите уровень журнала на Trace.
Рисунок 9. Изменение уровня журнала
4. Захват журналов в реальном времени
Используйте следующие команды ADB:
adb connect 172.18.8.28
Замените 172.18.8.28 на реальный IP-адрес телефона. Эта команда подключается к телефону по сети.
adb devices
Эта команда выводит список подключенных устройств и позволяет проверить, успешно ли подключен телефон.
adb logcat -G 16M
Эта команда увеличивает размер буфера журнала, чтобы можно было сохранить больше содержимого журнала.
adb logcat > logcat-202111051708.log
Эта команда сохраняет вывод журнала в реальном времени в файл на ПК. Рекомендуемый формат именования: год + месяц + день + час + минута + секунда + .log
Рисунок 10. Захват журналов в реальном времени
После завершения записи выполните:
adb disconnect 172.18.8.28
Это отключает ПК от телефона. Затем вы можете найти созданный файл журнала в реальном времени в соответствующем каталоге на вашем ПК.
Рисунок 11. Путь к файлу журнала в реальном времени
Если проблема связана с ЖК-экраном или поведением отображения, также необходимо предоставить файл скриншота.
Войдите в веб-интерфейс телефона и перейдите в System > Support Page, затем найдите Screen Screenshot. Нажмите Сохранить изображение, чтобы скачать и сохранить скриншот.
Рисунок 12. Сохранение скриншота
