Using Device Diagnostic Tool

Device Diagnostic Tool 2.1

Overview

Device Diagnostic Tool supports two modes of operation:

  1. Admin mode - The administrator can access app settings, modify test configurations and run each individual test. This is the default mode.
  2. User mode - The user is restricted to only run tests; there is no access to app settings nor test configurations. To set user mode, disable admin_mode as referenced in the Configuration section.

Launch the App

Run Device Diagnostic Tool using one of the following methods:

  1. Manually using the User Interface - The user launches Device Diagnostic Tool and runs the tests manually. See User Interface section below.
  2. 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. If both methods are used simultaneously, unexpected behavior can occur.

User Interface

When launching the app for the first time, the main screen displays the tests available to run: Main screen
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.

Scanner Test

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.

Button Test

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.

Touch Screen Test

The user is prompted to touch each grid box on the screen

  • Touch Screen Test – test successful, test failed, or test timed-out

Bluetooth Tests

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

Wifi Tests

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; On Android O and above, the location is required to be enabled in device settings due to Android restrictions. If the device location is not enabled, the value is returned as unknown ssid.
    • ip – displays IP address
    • bssid – valid or invalid
    • speed – displays connection speed
  • Radio Power Cycle – test successful or test failed

Battery Tests

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

WWAN Tests

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

Audio Test

Checks for operation of the device microphone and speaker. Results:

  • Audio Test – test successful or test failed


See Also