Training File IO

Objectives

This Training Module is focused on leveraging File IO from the context of a Test Unit executing on a target. The module covers the following:

• Accessing host based files
• Read and Writing content to / from host files

There are two test files used -- TestFile.cpp & TestFile.h -- that implement one Test Unit:

• TestFile

The Test Unit has test cases already implemented (used for reference) and has one test method that you are required to implement (called Exercise). Currently this method is empty and returns a NOT IN USE status.

Instructions

Build and Run TestApp

• Build TestApp using SDK makefile
• Startup TestApp
• If not already done, create an option file (myoptions.txt) using the following content (Windows example)

 ##### Command Line Options ######
 --device "TCP:localhost:8000"
 --database "%STRIDE_DIR%\SDK\Windows\out\TestApp.sidb"
 --output "%STRIDE_DIR%\SDK\Windows\sample_src\TestApp.xml"
 --log_level all

• Execute Test File Test Unit only

 > stride -O myoptions.txt --run TestFile

 Loading database...
 Connecting to device...
 Executing...
   test unit "TestFile"
     > 0 passed, 0 failed, 0 in progress, 1 not in use.
   --------------------------------------------------------------
   Summary: 0 passed, 0 failed, 0 in progress, 1 not in use.

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

• Review the details of the test results using a Browser. Open TestApp.xml which can be found in the sample_src directory (based on the output option). By opening the xml file in a web browser the xsl is automatically applied to create html.

Implement Exercise

• Read data content TestFileInput.dat file created from the previous test method
• Make sure to Exit the test if an error occurs when opening file(s) (i.e. use srEXIT_XX)
• Take a summation of the data content using sut_add()
• Validate summation with content in TestFileSum.dat file
• Add a NOTE capturing important information such as bytes read, summation, etc. _

• Execute only TestFile

 > stride -O myoptions.txt --run TestFile

 Loading database...
 Connecting to device...
 Executing...
   test unit "TestFile"
     > 1 passed, 0 failed, 0 in progress, 0 not in use.
   --------------------------------------------------------------
   Summary: 1 passed, 0 failed, 0 in progress, 0 not in use.
  
 Disconnecting from device...
 Saving result file...

Run and Publish Results

When you have completed the Exercise(s) publish your results to Test Space. To make it easier for now we recommend that you update your existing option file (myoptions.txt) with the following if not already done:

 #### Test Space options (partial) #####
 #### Note - make sure to change username, etc. ####
 --testspace https://username:password@yourcompany.stridetestspace.com
 --project Training
 --name YOURNAME

  > stride -O myoptions.txt --run TestFile --space TestFile --upload

Note: This space has been set up with a Baseline of expected test results that you can use to validate your results.

Reference

The following reference information is related to passing parameters to Test Units.

Wiki

• File Transfer Services - important information for using file operations on host file from test code executing on the target
  • Review srFileOpen() and srFileClose()
  • Review srFileRead() and srFileWrite()
  • Other references as needed

Samples

• File Services Sample - presents a few basic examples of how to use the File Transfer Services API to interact with the host file system.