===========================================================================
Nucleus Samples - Storage - Directory Usage
===========================================================================

Introduction
------------

The Nucleus Sample Application demonstrates the use of the Nucleus Storage component.

Purpose & Goals
---------------

The purpose behind this sample application is to show how to use the Nucleus Storage component.
This sample accomplishes the following:

 1) Opens a drive
 2) Read through the directory
 3) Print file name, size, updated date, updated time, created date, created time
 4) Wait 30secs for a new device.

What You Will Need
------------------

To run this demonstration you will need a Nucleus platform with a BSP that has a Storage
device enabled.

Components Used
---------------
Please reference the sample *.config file for a minimal configuration.  This configuration is set to ramdisk
by default.  To run this sample with other storage media, changes to the *.config file are required to enable 
those devices.  Depending on the product these can be found within the \samples\ folder or at the base of the 
system project named <app_project_name>.<build_config>.config


Building the Application
------------------------

Open the provided development shell, e.g. Nucleus Dev Shell (CS GNU ARM).bat, and execute the following command for the desired platform. 

make PLATFORM=<platform> 

For example, <platform> can be "at91sam9263ek". For more information, please refer to Nucleus ReadyStart reference manual.

As a result of above command, one of the generated output images should be *.out.

Setting up Hardware
-------------------

Connect a appropriate Serial cable (straight or cross-over) between the target and PC and open a
console application in the PC at 115200 baud, 8 start-bits, 1 stop-bit, no parity and flow control
mode.

How To Run The Application
--------------------------

Load and run the directory_usage.out file. Verify output on the console window on the PC.  
