**NOTE**
   This file will be replaced by a quickstart guide in the final release.

**GENERAL INFORMATION**
   This project is intended to both show that the Quadros RTOS supports the 
   Cortex-M3 architecture (specifically, the Luminary Micro LM3S37x8 processor) 
   and to show that the VisualRTXC design tool is also supported in this 
   environment.  
   
   The Quadros kernel and Luminary Micro driver libraries have been provided as 
   a pre-built library.  The demo application has been provided as source code 
   that was generated by the VisualRTXC design tool.  Note that an installation 
   of VisualRTXC is not required to build the demo application.  The 
   application can be built with both IAR Embedded Workbench for ARM (v 5.11) 
   and with Keil uVision3 (v3.60).
   
   The application has essentially two parts.  The first part utilizes the UART
   provided by the Debug USB connector on the evaluation board.  See the 
   evaluation board documentation for help setting up this connection.  The 
   UART output can be viewed using terminal software attached to the Virtual 
   COM port on the PC at 19200 baud, 8 data bits, no parity, and 1 stop bit.
   The UART output will show that four tasks are running.  Example task 1 uses 
   a kernel alarm to awaken every 1 second to output its message.  Example task
   2 uses another alarm to awaken every 5 seconds to outupt its message.
   Example task 3 uses a kernel mailbox to send a message to example task 4.
   Example task 4 waits on a message, prints the message, and acknowledges the
   message.
   
   The second part of the application uses the LCD screen provided on the 
   evaluation board.  On the top portion of the LCD, a simple header with text 
   and background is printed.  The colors of this header are cycled at every 
   expiration of an associated cyclic kernel alarm.  The bottom portion of the
   LCD displays a time counter which uses one of the on-chip timers running
   at 10 kHz.  On top of this timer is drawn a colored circle (ball) that 
   bounces off of the edges of the bottom portion of the screen.  The 
   parameters of the ball can be controller using the NAVIGATE button on the 
   evaluation board.  Pressing UP and DOWN will increase and decrease the speed 
   of the ball, respectively.  Pressing RIGHT and LEFT will increase and 
   decrease the size of the ball, respectively.  Clicking the NAVIGATE button 
   will cycle through the colors of the ball.
   
   
**BUILDING/RUNNING THE PROJECT**
   **IAR Embedded Workbench for ARM v5.11**
      1.) Open the provided workspace 
          (Examples\Quadros_Ms\EWARM\Quadros_Ms.eww)
          with IAR Embedded Workbench for ARM (EWARM).
      2.) From within the EWARM IDE, click 'Project->Make' from the top menu to 
          build the project.
      3.) Connect a J-Link JTAG emulator between your PC and the JTAG/SWD 
          connector on the evaluation board.
      4.) Click 'Project->Debug' to load the application to on-chip Flash and 
          start the debugger.
      5.) Click 'Debug->Go' to execute the application.
      
   **Keil uVision3**
      1.) Open the provided workspace 
          (Examples\Quadros_Ms\uVision\Quadros_Ms.Uv2)
          with Keil uVision3 (uVision).
      2.) From within the uVision IDE, click 'Project->Build Target' from the 
          top menu to build the project.
      3.) Connect a ULINK2 JTAG adapter between your PC and the JTAG/SWD
          connector on the evaluation board.
      4.) Click 'Flash->Erase' to fully erase the on-chip flash.
      5.) Press the RESET button on the evaluation board.
      6.) Click 'Flash->Download' to load the application to on-chip Flash.
      7.) Click 'Debug->Start/Stop Debug Session' to start the debugger.
      8.) Click 'Debug->Run' to execute the application.      

IMPORTANT NOTE ON TERMS AND CONDITIONS FOR USE OF THIS EVALUATION
------------------------------------------------------------------------------------------------------------------------------
When you unzip these files and install this evaluation are agreeing to the terms and conditions listed below

Quadros Systems, Inc. (QSI), hereby grants permission to the above named Licensee to use the RTXC Quadros Multi-Stack RTOS software, evaluation software, and any related software included in this download for a period of thirty (30) days (Evaluation Period) from the date of receipt by Licensee.  This Evaluation Agreement is QSI's authorization to deliver and permit the installation of Product on Contact’s computer located at the address specified above solely for evaluation purposes. QSI will permit Licensee to extend access to Product to other Licensee employees, in addition to Contact, who need Product for purposes pursuant to this Agreement, provided that Licensee identifies to QSI in writing such personnel and their locations.

QSI hereby represents, and Licensee hereby acknowledges, that Product contains substantial trade secrets of QSI and/or its licensors. Such trade secrets have been entrusted to Licensee for use only as expressly authorized under this Agreement. Product may contain programs in source code, binary/object code or executable form and documentation files. All such content shall be used solely for such purpose as intended by the Agreement and shall not be used for any other purpose or for the benefit of or distribution to any third party. Where applicable, Licensee shall not, under any circumstance, decompile or reverse engineer Product. Licensee acknowledges that Product is the proprietary material of QSI or its licensors and agrees not to make any copies or partial copies of any computer media, manuals or other material provided by QSI. 

Licensee recognizes the confidential nature of Product, including those portions of Product licensed by QSI from third parties (if any), and all information related thereto, and agrees to preserve and protect QSI’s and QSI’s licensors’ interest therein and to hold the same in strict confidence.   Licensee further agrees to take appropriate action by instruction, agreement or otherwise with all personnel permitted access to Product to ensure that such personnel are aware of the terms and conditions of this Agreement and that Licensee’s obligations under this Agreement are satisfied.  Licensee also agrees that QSI shall have no liability whatsoever under this Agreement except to provide Product, and that QSI offers no express or implied warranties under this Agreement.
