/* ------------------------------------------------------------------------------------------------ */
/* FILE :        readme.txt                                                                         */
/*                                                                                                  */
/* CONTENTS :                                                                                       */
/*               mAbassi SMP RTOS: description for ARM Cortex A9 / ZedBoard                         */
/*                                                                                                  */
/*                                                                                                  */
/* Copyright (c) 2013-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.2 $                                                                                */
/*  $Date: 2014/06/01 11:34:09 $                                                                    */
/*                                                                                                  */
/* ------------------------------------------------------------------------------------------------ */

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

. --- / --- readme.txt                       [me]
      |
      / --- BOOT.BIN                         [Demo image for the ZedBoard]
      |
      / --- Demo_3_SMP_ZEDBOARD.bin          [Demo #3 image]
      |
      / --- Demo_9_SMP_ZEDBOARD.bin          [Demo #9 image]
      |
      / --- Demo_10_SMP_ZEDBOARD.bin         [Demo #10 image]
      |
      / --- Demo_11_SMP_ZEDBOARD.bin         [Demo #11 image]
      |
      / --- Demo_12_SMP_ZEDBOARD.bin         [Demo #12 image]
      |
      / --- Demo_13_SMP_ZEDBOARD.bin         [Demo #13 image]
      |
      / --- Demo_110_SMP_ZEDBOARD.bin        [Demo #110 image]
      |
      / --- Demo_111_SMP_ZEDBOARD.bin        [Demo #111 image]
      |
      / --- Demo_112_SMP_ZEDBOARD.bin        [Demo #112 image]
      |
      / --- Demo_113_SMP_ZEDBOARD.bin        [Demo #113 image]
      |
      / --- 404.html                         [File for FatFS based WebServers]
      |
      / --- Buttons.shtml                    [File for FatFS based WebServers]
      |
      / --- default.shtml                    [File for FatFS based WebServers]
      |
      / --- LCD.shtml                        [File for FatFS based WebServers]
      |
      / --- LED.sthml                        [File for FatFS based WebServers]
      |
      / --- RTC.shtml                        [File for FatFS based WebServers]
      |
      / --- Switches.shtml                   [File for FatFS based WebServers]
      |
      / --- TaskList.shtml                   [File for FatFS based WebServers]
      |
      / --- src                              [Demo sample code]
      |
      / --- images --- / --- logo.png        [File for FatFS based WebServers]
                       |
                       / --- SW0.png         [File for FatFS based WebServers]
                       |
                       / --- SW1.png         [File for FatFS based WebServers]

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

    To run the demo on the ZedBoard, copy the file BOOT.BIN on a FAT16/FAT32 formatted MMC card.
    Insert the card and power-cycle the board.
    After around 10 seconds, the blue LED LD12 (Done) will light up and the demo will start.

    Make sure the following jumpers are set as follows:
           JP7  - GND
           JP8  - GND
           JP9  - 3.3V
           JP10 - 3.3V
           JP11 - GND

    Serial port settings:
           Baud Rate: 115200
           Data bits:      8
           Stop bits:      1
           Parity:      none
           Flow Ctrl:   none
           Emulation: VT-100

    Refer to Code Time Technologies website for the meaning of the letters on the right of
    display and to have a description of the syntax for the commands to modify the operating
    set-up of mAbassi.
    e.g.
       Info        : dumps the current configuration of each task
       RRA RR 100  : sets task RRA's round robin time slice  to 1.00 s 

/* ------------------------------------------------------------------------------------------------ */
/* 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 */
