1. Zebra Service Agent User Guide V4.x
  2. Functional Overview
  3. Diagnostic Tool
  • Zebra Services Agent User Guide V4.x
Diagnostic Tool

Diagnostic Tool

This module of the ZSA mobile application provides tests that verify the device's hardware functionality to determine the system's health and its result. When necessary, the Zebra Help Desk uses this tool to troubleshoot device issues, using the results to determine the ideal steps for resolution. This functionality is beneficial for quickly addressing device problems, increasing worker productivity, and reducing device downtime and unnecessary returns to the Zebra Repair Center.
New Enhancements:
Support for Non-Zebra Devices: The Device Diagnostic Tool (DDT) is now extended to non-Zebra devices, enabling advanced diagnostics across a wider range of hardware and increasing its versatility.
Immediate and Scheduled Testing: Admin can trigger tests immediately or schedule them as one-time or recurring tests, ensuring proactive and efficient device health monitoring.
Diagnostic Tool Tests
Zebra Support
Non-Zebra Support
Scanner
Yes
Partial (It is supported only on Datalogic and Honeywell devices)
Button
Yes
Yes
Touch Screen
Yes
Yes
Bluetooth
Yes
Partial (It is supported only on Android 12 and below versions)
Wi-Fi
Yes
No
Battery
Yes
No
WWAN
Yes
No
Audio
Yes
Yes
SD Card
Yes
Yes
USB
Yes
Yes
Network
Yes
Yes
Keyboard
Yes
Yes
Camera
Yes
Yes
This feature can be configured using Managed Configuration through MDM or VIQ and is applicable to Zebra and non-Zebra devices (partially).
  1. Users access the
    Diagnostic Tool
     module from the home screen of the ZSA mobile application. The main screen of this module displays a list of tests that help identify the device's system health and determine whether it needs to be sent to the Zebra Repair Center.
    Run All Test
  2. The
    Run All Test
     runs all the listed tests in sequence to verify the system's health and simultaneously generates a result report.
  3. Users can perform individual tests to verify if a specific device function works correctly. After each test, the results are saved to a file and uploaded to the designated FTP network. The outcome of the test is also displayed on the test result screen.
    Below is an example of a
    Bluetooth
     test.
    • Click
      Run Test
      .
      Run Test
    • The
      Testing in Progress
       page displays.
      Bluetooth Test
    • After completing the test, the
      Result
       page displays.
      Bluetooth Test
    • Users can cancel the test while it is in progress. A message prompts for confirmation with options for
      Yes
       or
      No.
      Cancel Test
  4. The
    Diagnostic Tool
     module includes additional features, such as
    Settings
    ,
    Configure
    ,
    Test Scheduler
    ,
    Upload
     and the option to enable or disable tests.
    Settings
  5. The
    Settings
     feature allows users to import diagnostic tool configurations from a configuration XML file, export the current configuration to a file for later use, or use the same configuration on different devices. The user can also configure the FTP server to upload test logs to a specific server.
    Settings FTP
  6. The
    Configure
     feature provides different required configurations related to performing any test. This feature allows users to enable or disable tests and specify the time interval allocated to finish the test. The user can also view a list of sub-tests and enable or disable them from the configure test page.
    Configure Test Screen
  7. The
    Test Scheduler
     feature allows scheduling weekly tests that are automatically executed at a specific time of the day. All the schedulers are visible on the schedule tests screen, as displayed below.
    Time
    Days
  8. By selecting the
    Time
    ,
    All Tests
    , and
    Days
     of the week, the tests are scheduled to run automatically in the background at the specified times on the chosen days.
    Test Scheduler
  9. A new pre-alarm feature has been added to DDT tests, providing an alarm notification 15 minutes before a scheduled test. Users have the flexibility to dismiss the upcoming test directly from the notification if needed. When a test is dismissed, feedback regarding the action is automatically sent to the server for tracking and analysis.
    Pre-alarm feature
  10. After completing the test, whether successful or unsuccessful, the results are saved and uploaded to the designated FTP server. Users can modify server configurations via the
    Settings
     feature or the
    Upload
     feature. The
    Upload
     feature allows users to manually upload data to the FTP server anytime, even without conducting tests.
    Upload
The configurations are in the following table.
Key
Description
Default value
Min
Max
Enable/Disable DDT
Enable or disable the Diagnostic Tool.
true
Clear DDT configurations
Whether to clear the Diagnostic Tool configuration.
false
Upload preference
Upload the log file for the condition only (1: Only on Failure, 2: All test logs).
1/2
1
2
Test-log retention
Action after log upload (0: Keep the log file, 1: Delete the log file).
0/1
0
1
Trigger DDT full suite
Triggers the full DDT test suite immediately.
false
Run DDT instantly
Triggers DDT tests, which do not require user intervention immediately.
false
Schedule tests on specific dates
Schedule tests based on date (in DD-MM-YYYY format).
None
Schedule tests on specific days
Schedule tests based on days of the week (in MON,TUE,WED format).
None
Schedule tests at specific time
Time of the day for the test (in HH:MM format).
None
Test Plan - System to test
Name of the test (for example, Bluetooth). Only non-user intervention tests.
None
Test Plan – Test Day and Test Time
Specify the Day of the week for the test (for example, Monday) and the Time of the day for the test (in HH:MM format).
None
Test Plan - Delivery
Specify FTP username, FTP protocol, FTP password, and FTP server IP address.
None