Running Diagnostics With Target
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
- ↑ You need to have an account with access to a dedicated project and space created by your Test Space administrator