Running Diagnostics With Target

From STRIDE Wiki
Jump to navigation Jump to search

This article describes how to run the built-in STRIDE diagnostics with your target device. It assumes that your have completed the steps described in the article Build Integration.

Running STRIDE Diagnostics

To execute the diagnostic tests, use a desktop (Windows, Linux or FreeBSD) host computer that has connectivity with the target system via your configured STRIDE transport (TCP/IP or serial). Additionally, make the generated STRIDE database (.sidb) visible to the host computer via a shared filesystem or a file copy to the host system.

If not already present, install the appropriate desktop Framework package on the host computer.

Start the target app running on the target hardware, then run stride as follows:

stride --diagnostics --database=<path>/stride.sidb --device=<device_address> --run="*" --output=diagnostics

Specify your database and device options as required.

Interpreting Diagnostic Results

Upon running, the host console running stride will display summary test results:

Loading database...
Connecting to device...
  runtime version: 5.x.yy 
Executing diagnostics...
  test unit "Link"
    Loopback ............
    Payload Fragmentation
    Stub-Proxy Deadlock
    Target Characteristics
    > 4 passed, 0 failed, 0 in progress, 0 not in use.
  test unit "Stat"
    > 2 passed, 0 failed, 0 in progress, 0 not in use.
  test unit "Time"
    > 2 passed, 0 failed, 0 in progress, 0 not in use.
  --------------------------------------------------------------------- 
  Summary: 8 passed, 0 failed, 0 in progress, 0 not in use.

Disconnecting from device...
Saving result file...

Once the test run is complete, you will see the files diagnostics.xml (result name defaults to same as database name if the '--output" option is not used) and, if you were connected to the Internet when you ran the tests, diagnostics.xsl in the directory from which you ran stride.

By opening diagnostics.xml in a web browser, the xsl is automatically applied to create html in the browser.

All tests should pass.

Publishing Results

Optionally, if you have Internet connectivity and access to your company's Test Space[1] you could run again the diagnostics and upload the results by submitting the following command line parameters to stride:

--diagnostics
--run "*"
--database <path>/stride.sidb --device=<device_address> 
--testspace <user>:<pwd>@<mycompany>.stridetestspace.com 
--project Sandbox 
--space Diagnostics 
--upload

Notes

  1. You need to have an account with access to a dedicated project and space created by your Test Space administrator