How to debug device over Android smartphone: Difference between revisions

Latest revision as of 15:29, 28 December 2023

General Technical Questions > How to debug device over Android smartphone

Solution applies for these Teltonika devices

Pair and connect device

Bluetooth® starts automatically when device is on. Take your mobile phone, go to Settings->Bluetooth® and turn it on. Scan for nearby devices, find the device in the list, distinguish the device by last IMEI digits on device module. Press pair, wait until device asks to enter pairing password, type: "5555" (as in the example on the figure). Paired device will show up in the paired device list. Download a terminal for Bluetooth®, e.g. "Serial Bluetooth® Terminal", from Play Store/App store. Run app, click Find->Connect to your paired device. Now we need to send a command to the device from Bluetooth® terminal, type: ".log:1"

Device will respond with "Log enabled" and the log will show up. Do not forget to save the log file to mobile phone.

Device debug over Android smartphone

In order to pair the device with Android smartphone, make sure that BT radio is enabled (visible) in device configuration. It can be checked via SMS command too:

"getparam 800"

The answer has to be "2", which means "Enabled and visible".

File:Android Bluetooth® settings.jpg

Scan for visible BT devices using your Android smartphone and connect to your device. Default BT name is: "DeviceModel_last_7_imei_digits". Default PIN code is: "5555".

Download "Serial Bluetooth® Terminal" application. Following link can be used: https://play.google.com/store/apps/details?id=de.kai_morich.serial_bluetooth_terminal
Run "Serial Bluetooth® Terminal", in menu press "Devices" and select paired the device.

File:Android Bluetooth® serial folder.jpg

To change the log saving folder, in the right upper corner press on 3 dots symbol->Data->Info->Edit Folder->Edit Custom, then select your preferred saving folder, e.g. "Documents", press Use this folder->Allow.

File:Android Bluetooth® serial.jpg

To start the logging, enter the command into terminal: ".log:1".
Wait ~10 minutes and press on 3 dots symbol->Data->Save. You will find the saved log file in the previously selected folder, e.g. "Files/Documents", select log files, in "Share files via Email" section select your preferred sharing method and then send these files to Teltonika support.
You can turn logging off again by entering the command ".log:0" into the terminal

Please note:
Unfortunately, it is not possible to perform debug the same way on iPhone, because there is no native SPP Bluetooth® profile support on iPhone.

@@ Line 3: / Line 3: @@
 [[TMT250]] | [[GH5200]] | [[TST100]] | [[TFT100]]
 ===Pair and connect  device===
-Bluetooth starts automatically when device is on. Take your mobile phone, go to ''Settings->Bluetooth'' and turn it on. Scan for nearby devices, find the device in the list, distinguish the device by last IMEI digits on device module. Press pair, wait until device asks to enter pairing password, type: ''"5555"'' (as in the example on the figure). Paired device will show up in the paired device list. Download a terminal for Bluetooth, e.g. "Serial Bluetooth Terminal", from Play Store/App store. Run app, click ''Find->Connect'' to your paired device. Now we need to send a command to the device from Bluetooth terminal, type: ''".log:1"''
+Bluetooth® starts automatically when device is on. Take your mobile phone, go to ''Settings->Bluetooth®'' and turn it on. Scan for nearby devices, find the device in the list, distinguish the device by last IMEI digits on device module. Press pair, wait until device asks to enter pairing password, type: ''"5555"'' (as in the example on the figure). Paired device will show up in the paired device list. Download a terminal for Bluetooth®, e.g. "Serial Bluetooth® Terminal", from Play Store/App store. Run app, click ''Find->Connect'' to your paired device. Now we need to send a command to the device from Bluetooth® terminal, type: ''".log:1"''
 Device will respond with ''"Log enabled"'' and the log will show up. Do not forget to save the log file to mobile phone.
@@ Line 19: / Line 19: @@
-{{{pic_Android_Bluetooth_settings|[[Image:Android_Bluetooth_settings.jpg|220px|right]]}}}
+{{{pic_Android_Bluetooth®_settings|[[Image:Android_Bluetooth®_settings.jpg|220px|right]]}}}
 *Scan for visible BT devices using your Android smartphone and connect to your device. Default BT name is: ''"DeviceModel_last_7_imei_digits"''. Default PIN code is: ''"5555"''.
@@ Line 51: / Line 51: @@
-*Download "Serial Bluetooth Terminal" application. Following link can be used: https://play.google.com/store/apps/details?id=de.kai_morich.serial_bluetooth_terminal
+*Download "Serial Bluetooth® Terminal" application. Following link can be used: https://play.google.com/store/apps/details?id=de.kai_morich.serial_bluetooth_terminal
-*Run "Serial Bluetooth Terminal", in menu press "Devices" and select paired the device.
+*Run "Serial Bluetooth® Terminal", in menu press "Devices" and select paired the device.
-{{{pic_Android_Bluetooth_serial_folder|[[Image:Android_Bluetooth_serial_folder.jpg|220px|right]]}}}
+{{{pic_Android_Bluetooth®_serial_folder|[[Image:Android_Bluetooth®_serial_folder.jpg|220px|right]]}}}
 *To change the log saving folder, in the right upper corner press on 3 dots symbol->''Data->Info->Edit Folder->Edit Custom'', then select your preferred saving folder, e.g. "Documents", press ''Use this folder->Allow''.
@@ Line 86: / Line 86: @@
-{{{pic_Android_Bluetooth_serial|[[Image:Android_Bluetooth_serial.jpg|220px|right]]}}}
+{{{pic_Android_Bluetooth®_serial|[[Image:Android_Bluetooth®_serial.jpg|220px|right]]}}}
 *To start the logging, enter the command into terminal: ''".log:1"''.
 *Wait ~10 minutes and press on 3 dots symbol->''Data->Save''. You will find the saved log file in the previously selected folder, e.g. "Files/Documents", select log files, in "Share files via Email" section select your preferred sharing method and then send these files to Teltonika support.
@@ Line 93: / Line 93: @@
 <gallery widths="100px" perrow="3" caption="Saving and sharing the log">
-Image:Android_Bluetooth_log1.jpg
+Image:Android_Bluetooth®_log1.jpg
-Image:Android_Bluetooth_log2.jpg
+Image:Android_Bluetooth®_log2.jpg
-Image:Android_Bluetooth_log3.jpg
+Image:Android_Bluetooth®_log3.jpg
 </gallery>
@@ Line 105: / Line 105: @@
 {| style="width: 800px;height: 60px; text-align: left; border: 1 px solid #0054A6; border-bottom: 1px solid #0054A6; border-left: 1px solid #0054A6;border-top: 1px solid #0054A6;border-right: 1px solid #0054A6;background: #E7F1FE; color: black; text-align: left; padding: 10px;"
 | style="width: 40px;height: 20px;padding: 10px;" | [[File:Note_icon.png|30 px|link=]]
-|| '''Please note:''' <br>Unfortunately, it is not possible to perform debug the same way on iPhone, because there is no native SPP Bluetooth profile support on iPhone.
+|| '''Please note:''' <br>Unfortunately, it is not possible to perform debug the same way on iPhone, because there is no native SPP Bluetooth® profile support on iPhone.
 |}
 |}
 [[Category: General Technical Questions]]