/* ------------------------------------------------------------------------------------------------ */
/* FILE :        readme.txt                                                                         */
/*                                                                                                  */
/* CONTENTS :                                                                                       */
/*               Abassi RTOS: description for ARM Cortex M4 / Atollic                               */
/*                                                                                                  */
/*                                                                                                  */
/* Copyright (c) 2012-2014, Code-Time Technologies Inc. All rights reserved.                        */
/*                                                                                                  */
/* Code-Time Technologies retains all right, title, and interest in and to this work                */
/*                                                                                                  */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS                          */
/* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF                                       */
/* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL                          */
/* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR                             */
/* OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,                            */
/* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR                            */
/* OTHER DEALINGS IN THE SOFTWARE.                                                                  */
/*                                                                                                  */
/*                                                                                                  */
/*  $Revision: 1.1 $                                                                                */
/*  $Date: 2012/03/13 20:30:02 $                                                                    */
/*                                                                                                  */
/* ------------------------------------------------------------------------------------------------ */


Quick overview at this level:

   - The demos source code are located in the folder ./src
   - Demo #10, #11 #110 #111 file system used (in memory) is located in ./fs
   - The Atollic workspace is ./Workspace
   - All demo projects are located in individual folders in ./Workspace


/* ------------------------------------------------------------------------------------------------ */
/* IMPORTANT NOTES                                                                                  */

   - The workspace .metadata must be re-created for your computer.
     Go through these menus:
     File -> Import -> General -> Existing Projects into workspace -> Next
       Set root directory to . . . . /Abassi_CortexM3_ATOLLIC/Workspace
       DO NOT check the box "Copy projects into workspace"
       DO NOT check the box "Add project to working sets"
     Click on Finish

   - THE DEBUGGER USED FOR THE STM32-P407 BOARD IS THE SEGGER'S J-LINK
   - THE DEBUGGER USED FOR THE STM32F4 DISCOVERY BOARD IS THE ON-BOARD ST-LINK

   - Demo #2 on the STM32-P407 board cannot run in real-time due to extremely slow refresh rate
     of the LCD.

/* ------------------------------------------------------------------------------------------------ */
/* Overall file system from at this level                                                           */

. --- / --- readme.txt    [me]
      |
      / --- Abassi.eww    [IAR IDE Workspace]
      |
      / --- fs            [Files for Demo #12, #13, #112 and #113]
      |
      / --- Projects      [All projects of the workspace are in this folder]
      |
      / --- src           [Demo source code]


/* ------------------------------------------------------------------------------------------------ */
/* Short description of the demos                                                                   */

All demo files are named as follows:  Demo_N_TARGET_TOOL.c

where :   N      : demo number.
          TARGET : target platform / evaluation board.
          TOOL   : building tool chain name.

          The settings of the serial port for each demo is specified in the source file of the demo.


Demo #0    : Simple demo using 1 or 2 timers to flash LEDs with speed control using buttons and
             through the serial port by pressing the '+' and '-' keys.

Demo #1    : Same as Demo #0, except for boards without LEDS and/or buttons.
             The "flashing" is shown only the serial port and/or the buttons are replaced by pressing
             the '+' and '-' keys.

Demo #2    : Complex demo that shows the operations of some unique features of the Abassi RTOS.
             The operational characteristics of the tasks can be modify through the serial port.
             A thorough description is available on Code-Time Technologies website.

Demo #3    : Same as Demo #2, but for target platforms without an on-board display.
             The information is shown only the serial port.

Demo #4    : Joystick (or buttons) based demo, using every one of Abassi synchronization mechanisms.
             The joystick operation is shown on the on-board display and the serial port.

Demo #5    : Same as Demo #4, but for target platforms without an on-board display.
             The information is shown only the serial port.

Demo #6    : ADC based demo, the ADC value is is read, passed through a mailbox.
             The ADC value is shown on the on-board display and the serial port.

Demo #7    : Same as Demo #6, but for target platforms without an on-board display.
             The information is shown only on the serial port.

Demo #8    : This demo is board dependent.
             Typicaly show the use of on-board display(s) or other peripherals.

Demo #9    : Small file system system shell for FatFS.

Demo #10   : Webserver showing the use of lwIP with netconn and memory base file system.

Demo #11   : Webserver showing the use of lwIP with BSD sockets and memory base file system.

Demo #12   : Webserver showing the use of lwIP with netconn and FatFS file system.

Demo #13   : Webserver showing the use of lwIP with BSD sockets and FatFS file system.

Demo #110  : Same as Demo #10, but using the CMSIS V3.0 RTOS API over Abassi

Demo #111  : Same as Demo #11, but using the CMSIS V3.0 RTOS API over Abassi

Demo #112  : Same as Demo #12, but using the CMSIS V3.0 RTOS API over Abassi

Demo #113  : Same as Demo #13, but using the CMSIS V3.0 RTOS API over Abassi

/* EOF */
