Einführung

Übersicht

Wenn bei internen Tests oder der Kundenbereitstellung von Android-IP-Telefonen ein Problem auftritt, muss das technische Personal möglicherweise Debug-Informationen zur Fehlerbehebung und Analyse bereitstellen. Diese Anleitung erklärt, wie die erforderlichen Diagnosedateien gesammelt werden.

Unterstützte Modelle

GP32i, BX7A, BF600S, BJ7A, Bi56A

Voraussetzungen

1. Bereiten Sie ein Android-IP-Telefon, einen USB-Stick und einen PoE-Switch oder ein DC-Netzteil vor. Schließen Sie das Telefon an den Switch an.

2. Bereiten Sie einen PC zum Debuggen vor und schließen Sie ihn an denselben Switch an. Stellen Sie sicher, dass PC und Telefon über das Netzwerk miteinander kommunizieren können.

Verbindungsdiagramm von Gerät und PC

Schließen Sie das Android-IP-Telefon (hier wird A32i als Beispiel verwendet) an den Switch an und den PC an denselben Switch. Stellen Sie sicher, dass das Netzwerk zwischen PC und Gerät erreichbar ist. Das Verbindungsbeispiel ist in Abbildung 1 dargestellt.

                 Abbildung 1. Verbindungsdiagramm von Gerät und PC

Fehlerbehebungsmethoden

Je nach Problem können unterschiedliche Arten von Diagnoseinformationen für die Analyse erforderlich sein. Die folgenden Abschnitte erklären, welche Dateien unter verschiedenen Umständen bereitzustellen sind.

Allgemeine Fälle

In den meisten Fällen müssen drei Dateien gesammelt und dem F&E-Team zur Verfügung gestellt werden:

1. Debug-Syslog-Datei
Melden Sie sich bei der Telefon-Weboberfläche an und gehen Sie zu System > Support Page, dann finden Sie System Log.

Konfigurieren Sie die folgenden Einstellungen:

1) Aktivieren Sie Syslog
2) Legen Sie die Serveradresse auf die IP-Adresse des lokalen PCs fest
3) Legen Sie den Serverport auf 514 fest
4) Legen Sie den Systemprotokoll-Level auf Debug fest
5) Aktivieren Sie Protokoll exportieren
6) Klicken Sie nach der Reproduktion des Problems auf Protokoll exportieren, um die Syslog-Datei herunterzuladen

                                                                                                                                   Abbildung 2. Exportieren des Debug-Syslogs

2. Debug-Paket
Das Debug-Paket enthält zwischengespeicherte Protokolle, Laufzeitinformationen, Firmware-Details und andere interne Diagnosedaten des Telefons. Es kann über die Weboberfläche exportiert werden.

Gehen Sie zu System > Support Tool, suchen Sie die Option Ein-Klick-Export von Debug-Informationen und klicken Sie auf Exportieren. Dieser Vorgang kann etwa eine Minute dauern.

                                                                                                                                        Abbildung 3. Exportieren des Debug-Pakets

3. Netzwerkpaketerfassungsdatei
Eine Paketerfassungsdatei zeichnet gesendete und empfangene Netzwerkpakete auf und kann zur Analyse in Tools wie Wireshark verwendet werden.

Zum Erfassen des Netzwerkverkehrs:

1) Klicken Sie auf Start und warten Sie, bis die Webseite den Erfassungsprozess startet
2) Reproduzieren Sie das Problem
3) Klicken Sie nach der Reproduktion des Problems auf Stoppen
4) Öffnen Sie die Browser-Downloadseite, um die erfasste Paketdatei zu finden

                                                                                                                                          Abbildung 4. Erfassen von Netzwerkpaketen

Sonderfälle

Nach der Bereitstellung der drei oben beschriebenen Dateien kann in einigen Situationen weiterhin zusätzliche Informationen erforderlich sein.

Auf Anfrage der F&E

Nach Überprüfung des Debug-Syslogs, des Debug-Pakets und der Paketerfassung kann das F&E-Team Android-Echtzeitprotokolle zur Unterstützung einer tieferen Analyse anfordern. Der folgende Abschnitt erklärt, wie Android-Echtzeitprotokolle mit ADB gesammelt werden.

Android-Echtzeitprotokoll
Die Android-Plattform gibt kontinuierlich Laufzeitprotokolle aus, während das Telefon betrieben wird. Diese Protokolle helfen Ingenieuren, Probleme zu identifizieren und zu analysieren.

1. Installieren Sie das ADB-Tool auf dem PC

Sie können das passende ADB-Tool für Ihr Betriebssystem herunterladen von:

https://developer.android.google.cn/studio/releases/platform-tools

Fügen Sie nach der Installation den ADB-Installationspfad zu den Systemumgebungsvariablen hinzu. Gehen Sie unter Windows zu Dieser PC > Eigenschaften > Erweiterte Systemeinstellungen > Erweitert > Umgebungsvariablen, dann fügen Sie den absoluten ADB-Verzeichnispfad zur Variable Path hinzu.

                                                                                                        Abbildung 5. Hinzufügen des ADB-Pfads

Öffnen Sie eine Eingabeaufforderung auf dem PC und geben Sie den Befehl adb ein. Wenn der Befehl erfolgreich ausgeführt wird, wurde ADB korrekt installiert.

                                                                                                          Abbildung 6. Erfolgreiche ADB-Installation

2. Aktivieren Sie die USB-Debugging auf dem Telefon

Für Android-Firmware, die nach dem 1. Dezember 2020 veröffentlicht wurde, ist das ADB-Debugging standardmäßig deaktiviert und muss manuell aktiviert werden.

Stecken Sie einen USB-Stick in das Telefon, gehen Sie dann zu Einstellungen > Über das Gerät und tippen Sie fünfmal auf die Firmware-Versionsnummer, um den Entwicklermodus zu aktivieren.

                                                                                                                     Abbildung 7. Aktivieren des Entwicklermodus

Gehen Sie dann zu Einstellungen > System > Entwickleroptionen und schalten Sie USB-Debugging ein.

                                                                                                                Abbildung 8. Aktivieren des USB-Debuggings

3. Ändern Sie den Debug-Protokoll-Level

Der Standard-Protokoll-Level des Telefons ist normalerweise auf Notice eingestellt, der nur wesentliche Informationen aufzeichnet. Um detailliertere Protokolle zu erfassen, ändern Sie den Protokoll-Level auf Trace.

Gehen Sie zu Telefoneinstellungen > Systemwartung > Tools und setzen Sie den Protokoll-Level auf Trace.

                                                                                                                  Abbildung 9. Ändern des Protokoll-Levels

4. Erfassen Sie Echtzeitprotokolle

Verwenden Sie die folgenden ADB-Befehle:

adb connect 172.18.8.28
Ersetzen Sie 172.18.8.28 durch die tatsächliche IP-Adresse des Telefons. Dieser Befehl stellt eine Netzwerkverbindung zum Telefon her.

adb devices
Dieser Befehl listet verbundene Geräte auf und ermöglicht Ihnen die Überprüfung, ob das Telefon erfolgreich verbunden ist.

adb logcat -G 16M
Dieser Befehl erhöht die Größe des Protokollpuffers, sodass mehr Protokollinhalt gespeichert werden kann.

adb logcat > logcat-202111051708.log
Dieser Befehl speichert die Echtzeitprotokollausgabe in einer Datei auf dem PC. Ein empfohlenes Benennungsformat ist: Jahr + Monat + Tag + Stunde + Minute + Sekunde + .log

                                                                                                              Abbildung 10. Erfassen von Echtzeitprotokollen

Führen Sie nach Abschluss der Protokollierung aus:

adb disconnect 172.18.8.28

Dadurch wird der PC vom Telefon getrennt. Anschließend finden Sie die generierte Echtzeitprotokolldatei im entsprechenden Verzeichnis auf Ihrem PC.

                                                                                                                   Abbildung 11. Pfad zur Echtzeitprotokolldatei

Bildschirmbezogene Probleme

Wenn das Problem mit dem LCD-Bildschirm oder dem Anzeigeverhalten zusammenhängt, sollte zusätzlich eine Screenshot-Datei bereitgestellt werden.

Melden Sie sich bei der Telefon-Weboberfläche an und gehen Sie zu System > Support Page, dann finden Sie Screen Screenshot. Klicken Sie auf Bild speichern, um den Screenshot herunterzuladen und zu speichern.

                                                                                                                 Abbildung 12. Speichern eines Screenshots