Device Diagnostic Tool supports two modes of operation:
- Admin mode - The administrator can access app settings, modify test configurations and run each individual test. This is the default mode.
- User mode - The user is restricted to only run tests. There is no access to app settings, test configurations nor individual tests. To set user mode, disable admin_mode as referenced in the Configuration section.
Run Device Diagnostic Tool using one of the following methods:
- Manually using the User Interface - The user launches Device Diagnostic Tool and runs the tests manually. See User Interface section below.
- Remotely with an EMM (Enterprise Mobility Management) system - Launch Device Diagnostic Tool in the background and generate a log using command:
adb shell am broadcast -n "com.symbol.selfdiagnostics/com.symbol.selfdiagnostics.SESReceiver"
Only one of the methods should be used to run Device Diagnostic Tool, otherwise unexpected behavior can occur.
When launching the app for the first time, the main screen displays the tests available to run:
If tests have already been conducted, the test name is followed by the date when the last test was conducted.
Tap Run Tests from the main screen to execute all the tests. Test execution is based on the tests selected in the Configure Tests screen. Once the test is initiated, the user is prompted to perform additional actions during test execution of the following: Scanner Test, Button Test, Touch Screen Test, and Audio Test. It is recommended for all tests to be performed while the device is in normal use, i.e. not docked in a cradle or connected via USB to a computer. Once testing is complete, the results are displayed:
Pass - Test executed and passed. Result passed test criteria.
Fail -Test executed and did not meet the test criteria.
Information -Data retrieved and displayed.
Alternatively, in admin mode individual tests can be performed by tapping on the individual test category and then tapping Run Tests.
Test failed and test timed-out result to the same red hazard icon.
Help option is available by tapping on the top right menu of the main screen. This links to the Device Diagnostics Tool support portal.
The user is prompted to scan a barcode. Results:
- Scanner Test – displays barcode data
- Label Type – displays barcode type or decoder scanned
Note: When performing the Scanner Test on TC55, the user must long press the scanner button for it to be detected.
The user is prompted to press the hard buttons on the device: scan trigger (left or right), push-to-talk, volume up, and volume down. Results:
- Button Test – test successful, test failed, or test timed-out
Note: If hard key buttons are remapped, the Button test does not work as expected.
The user is prompted to touch each grid box on the screen
- Touch Screen Test – test successful, test failed, or test timed-out
Checks whether the Bluetooth radio is operable and returns Bluetooth related information. Results:
- Name – displays the Bluetooth name
- Radio Power Cycle – test successful or test failed. The state of the radio is preserved prior to this test.
- Functional/Non-functional – functional or non-functional
- Discoverable/Connectable - connectable, discoverable, or none
Checks for operation of the WiFi radio and returns WiFi related information. Results:
- MAC Address – valid or invalid
- Network Test – displays connected or not connected Failure occurs if the WiFi is not connected to any network. The state of the radio is preserved prior to this test. If test is successful, the following values are displayed:
- strength – displays signal strength
- essid – displays ESSID. To display the ESSID on Android O and above, Location is required to be enabled in device settings due to Android restrictions. If Location is not enabled, the user is prompted to enable it. If the user proceeds to run the test without Location enabled, ESSID returns "Location not enabled."
- ip – displays IP address
- bssid – valid or invalid
- speed – displays connection speed
Checks the battery status and returns battery related information. Results:
- Part number – displays the part number
- Serial number – displays the serial number
- Manufacture date – displays the battery date of manufacture
- Decommission status – displays the health of the battery as:
- Good – the battery is in a healthy state
- Decommissioned – the battery has reached the threshold designated, currently 400 charge cycles, indicating that the battery should be replaced with a new one soon.
- Unknown – indicates a problem retrieving the battery health information
- Voltage – displays the voltage
- Current – displays the current
- Temperature – displays the temperature
- Level - displays the percentage (%) of remaining battery
- Current Capacity - displays the amount of energy stored in the battery in mAh (milliampere hour). Only supported with PowerPrecision+ batteries.
Checks the operation of the WWAN radio and returns related WWAN information. Results:
- Sim State – Airplane mode must be disabled. Displays one of the following values:
- Present – sim card is present
- Absent – sim card is not present
- Voice State - displays one of the following values:
- Voice in service
- Voice out of service
- Voice Emergency only
- Voice power off
- Unknown voice
- Data State – displays one of the following values:
- Data connected
- Data disconnected
- Data connecting
- Data suspended
- Unknown data
- WAN Type – displays the network type, such as: LTE, 2G, 3G, 4G, or Not Available
- Signal Strength – displays one of the following:
- Not applicable - SIM card absent
- Unknown – device could be in airplane mode
- Signal strength - in dBm
- Phone Number – valid or invalid, depending on whether or not the phone number is exposed by the service provider.
- Device ID – valid or invalid, depending on whether or not the device ID is exposed
Checks for operation of the device microphone and speaker. Results:
- Audio Test – test successful or test failed