/* ------------------------------------------------------------------------------------------------ */
/* FILE :        readme.txt                                                                         */
/*                                                                                                  */
/* CONTENTS :                                                                                       */
/*               mAbassi SMP RTOS: description for ARM Cortex M3 / CCS                              */
/*                                                                                                  */
/*                                                                                                  */
/* Copyright (c) 2012-2013, 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 RTOS source code (Abassi.c & Abassi.h) is located in the folder ../Abassi, one level above
   - The SMP source code (mAbassi.c & mAbassi.h) is located in the folder ../Abassi, one level above
   - The RTOS assembly file for this port is located in the folder ./src
   - The demos source code are located in the folder ./src
   - The demos build options (AbassiDemo.h) is located in the folder ../Abassi, one level above
   - The CCS 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:
     Project -> Import Existing CCS Eclipse Projects
       Browse: Set root directory to . . . . /mDemo_SMP_CortexM3_CCS/Workspace
       DO NOT check the box "Copy projects into workspace"
       DO NOT check the box "Add project to working sets"
     Click on Finish

   *** PANDA:
     On the OMAP4460 (processor on the Pandaboard), the pair of Cortex M3 processors are slave to the
     Cortex A9 processors.  Therefore, it is necessary to first get control of the Cortex A9, then
     set up the Cortex M3. Unless this is done, the Cortex M3 remain in reset.  This is why there
     are 2 projects for the Cortex M3 demo:
                    Demo_PANDA_M3_A9_CCS:    Project for the Cortex A9 #0
                    Demo_3_SMP_PANDA_M3_CCS: Project for the Cortex M3s

     Both projects must be built, but only the Demo_PANDA_M3_A9_CCS is used for debugging.
     The application built for the Cortex9_0 must be ran, otherwise the Cortex M3s are not usable.
     - Debugging
       When launching a debug session for the first time, the target CPUs must be selected.
       Remove ALL the check boxes except for this one:
                    CortexA9_0
       When the CortexA9_0 has properly set-up the Cortex M3s, messages are printed on the console.
       Upon success, connect to the Cortex_M3_0 only and load the output file of SMP_PANDA_M3_M3_CCS
       on Cortex_M3_0.  The output file is located in Workspace/Demo_3_SMP_PANDA_M3_M3_CCS/Debug and
       is named Demo_3_SMP_PANDA_M3_M3_CCS.out. Resume Cortex_M3_0 then wait a while for Cortex_M3_1
       to get reset.  When the selected processor becomes Cortex_M3_1, resume it.


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


. --- / --- readme.txt
      |
      / --- Workspace     [CCS Workspace]
      |
      / --- src           [Abassi object files and demo source code]

/* EOF */

