File Services Sample - Revision history

Marku at 17:04, 9 June 2011

2011-06-09T17:04:20Z

← Older revision		Revision as of 17:04, 9 June 2011
Line 24:		Line 24:
	This example shows how to use the line-oriented functions - [[File_Transfer_Services#srFileGets\|srFileGets]] and [[File_Transfer_Services#srFilePuts\|srFilePuts]] - to read and write lines of text.		This example shows how to use the line-oriented functions - [[File_Transfer_Services#srFileGets\|srFileGets]] and [[File_Transfer_Services#srFilePuts\|srFilePuts]] - to read and write lines of text.

			== Run Tests ==
			Now launch the test app (if you have not already) and execute the runner with the following commands:

			''Test FList tests'':
			<pre>
			stride --device="TCP:localhost:8000" --database="../out/TestApp.sidb" --run="s2_testflist_basic_fixtures; s2_testflist_basic_simple" --output=FList.xml
			</pre>

			Note the command will produce distinct result files for the run (per the --output command above). Please use the result file to peruse the results by opening each in your browser.

			== Observations ==
			The FileServices sample demonstrates basic usage of the [[File_Transfer_Services\|STRIDE File Transfer APIs]], which provide a way to transfer files to/from the host to the running device. All the data for the file transmission is done using STRIDE messaging between the STRIDE Runner on the host and the STRIDE Runtime on the device, so no additional communication ports are required to use these services. Review the source code in the directory and follow the sample description.

			The following are some test observations:
			* most of the functions return an integer status code which should be checked - any nonzero status indicates a failure. We wrote a macro for this sample (''fsASSERT'') that checks return codes and adds any errors to the report. You might choose to do something similar, depending on your needs.
			* the file transfer API has both byte and line oriented read/write functions. You can use whichever functions are most appropriate for your needs.
			* this sample uses the local filesystem ([http://en.wikipedia.org/wiki/Stdio stdio]) to write some data to a tempfile - however the STRIDE APIs are themselves buffer/byte oriented and don't require a local filesystem in general. If your device under test ''does'' have a filesystem, the STRIDE APIs can certainly be used to transfer resources to/from the device filesystem.

	[[Category: Samples]]		[[Category: Samples]]

Marku: moved File Services Samples to File Services Sample

2011-06-06T23:51:01Z

moved File Services Samples to File Services Sample

← Older revision	Revision as of 23:51, 6 June 2011
(No difference)

Mikee: /* Tests Description */

2010-05-05T18:21:04Z

Tests Description

← Older revision		Revision as of 18:21, 5 May 2010
Line 19:		Line 19:

	This example shows how to open a file and [[File_Transfer_Services#srFileSeek \| seek]] to a specific location.		This example shows how to open a file and [[File_Transfer_Services#srFileSeek \| seek]] to a specific location.


	===ReadAndWriteLines===		===ReadAndWriteLines===

	This example shows how to use the line-oriented functions - [[File_Transfer_Services#srFileGets\|srFileGets]] and [[File_Transfer_Services#~~srFilePets~~\|~~srFilePets~~]] - to read and write lines of text.		This example shows how to use the line-oriented functions - [[File_Transfer_Services#srFileGets\|srFileGets]] and [[File_Transfer_Services#srFilePuts\|srFilePuts]] - to read and write lines of text.


	[[Category: Samples]]		[[Category: Samples]]

Mikee: /* Tests Description */

2010-05-05T18:20:29Z

Tests Description

← Older revision		Revision as of 18:20, 5 May 2010
Line 19:		Line 19:

	This example shows how to open a file and [[File_Transfer_Services#srFileSeek \| seek]] to a specific location.		This example shows how to open a file and [[File_Transfer_Services#srFileSeek \| seek]] to a specific location.


			===ReadAndWriteLines===

			This example shows how to use the line-oriented functions - [[File_Transfer_Services#srFileGets\|srFileGets]] and [[File_Transfer_Services#srFilePets\|srFilePets]] - to read and write lines of text.


	[[Category: Samples]]		[[Category: Samples]]

Mikee: /* SeekAndTell */

2009-11-13T00:35:08Z

SeekAndTell

← Older revision		Revision as of 00:35, 13 November 2009
Line 18:		Line 18:
	===SeekAndTell===		===SeekAndTell===

	This example shows how to open a file		This example shows how to open a file and [[File_Transfer_Services#srFileSeek \| seek]] to a specific location.


	[[Category: Samples]]		[[Category: Samples]]

Mikee: /* Tests Description */

2009-11-13T00:06:56Z

Tests Description

← Older revision		Revision as of 00:06, 13 November 2009
Line 7:		Line 7:
	==Tests Description==		==Tests Description==

	~~=== Basic ===~~

	====CopyHostToTarget====		===CopyHostToTarget===

	~~====WriteToHostTempFile====~~		This example shows how to [[File_Transfer_Services#srFileOpen \| open a file on the host]] for read access and write all bytes to a local file. We use a temporary file buffer for writing, but any writable stream could be used as a destination.

	===~~=SeekAndTell=~~===		===WriteToHostTempFile===

			This example shows how to request a [[File_Transfer_Services#srFileGetTempName\| temporary file name]] on the host and [[File_Transfer_Services#srFileWrite \| write data to the file]]. We also demonstrate how to use the [[File_Transfer_Services#srFileRename\|rename]] and [[File_Transfer_Services#srFileRemove\|remove]] functionality.

			===SeekAndTell===

			This example shows how to open a file


	[[Category: Samples]]		[[Category: Samples]]

Mikee: Created page with '==Introduction== Please read the File Transfer Services article before proceeding in order to understand the concepts. This example presents a few basic examples of how to…'

2009-11-12T22:44:06Z

Created page with '==Introduction== Please read the File Transfer Services article before proceeding in order to understand the concepts. This example presents a few basic examples of how to…'

New page

==Introduction==

Please read the [[File Transfer Services]] article before proceeding in order to understand the concepts.

This example presents a few basic examples of how to use the File Transfer Services API to interact with the host filesystem from test code executing on the device. These services are only available when your code is executing under the control of the [[STRIDE Runner]], such as when you are running [[Test Units]].

==Tests Description==

=== Basic ===

====CopyHostToTarget====

====WriteToHostTempFile====

====SeekAndTell====

[[Category: Samples]]