path: root/c/src/lib/libbsp/shared/bootcard.c

/*
 *  This is the C entry point for ALL RTEMS BSPs.  It is invoked
 *  from the assembly language initialization file usually called
 *  start.S.  It provides the framework for the BSP initialization
 *  sequence.  The basic flow of initialization is:
 *
 *  + start.S: basic CPU setup (stack, zero BSS) 
 *    + boot_card
 *      + if defined(BSP_BOOTCARD_HANDLES_RAM_ALLOCATION)
 *        - obtain information on BSP memory and allocate RTEMS Workspace
 *      + bspstart.c: bsp_start - more advanced initialization
 *      + rtems_initialize_data_structures
 *      + if defined(BSP_BOOTCARD_HANDLES_RAM_ALLOCATION)
 *        - Allocate memory to C Program Heap
 *        - initialize C Library and C Program Heap
 *      + bsp_pretasking_hook
 *      + if defined(RTEMS_DEBUG)
 *        - rtems_debug_enable( RTEMS_DEBUG_ALL_MASK );
 *      + rtems_initialize_before_drivers
 *      + bsp_predriver_hook
 *      + rtems_initialize_device_drivers
 *        - all device drivers
 *      + bsp_postdriver_hook
 *      + rtems_initialize_start_multitasking
 *        - 1st task executes C++ global constructors
 *          .... appplication runs ...
 *          - exit
 *     + back to here eventually
 *     + bspclean.c: bsp_cleanup
 *
 *  This style of initialization ensures that the C++ global
 *  constructors are executed after RTEMS is initialized.
 *  Thanks to Chris Johns <cjohns@plessey.com.au> for the idea
 *  to move C++ global constructors into the first task.
 *
 *  COPYRIGHT (c) 1989-2008.
 *  On-Line Applications Research Corporation (OAR).
 *
 *  The license and distribution terms for this file may be
 *  found in the file LICENSE in this distribution or at
 *  http://www.rtems.com/license/LICENSE.
 *
 *  $Id$
 */

#include <bsp.h>

/*
 *  Since there is a forward reference
 */
char *rtems_progname;


/*
 *  Prototypes of external routines
 */
extern void bsp_start( void );
extern void bsp_cleanup( void );
extern void bsp_pretasking_hook(void);
extern void bsp_libc_init( void *, uint32_t, int );
extern void bsp_predriver_hook(void);
extern void bsp_postdriver_hook(void);

/*
 *  These are the prototypes and helper routines which are used
 *  when the BSP lets the framework handle RAM allocation between
 *  the RTEMS Workspace and C Program Heap.
 */
#if defined(BSP_BOOTCARD_HANDLES_RAM_ALLOCATION)
  extern void bsp_get_workarea( void **, size_t *, size_t *);

  void bootcard_bsp_libc_helper(
    void   *workarea_base,
    size_t  workarea_size,
    size_t  requested_heap_size
  )
  {
    uint32_t     heap_start;
    uint32_t     heap_size;

    heap_start = (uint32_t) workarea_base;
    if (heap_start & (CPU_ALIGNMENT-1))
      heap_start = (heap_start + CPU_ALIGNMENT) & ~(CPU_ALIGNMENT-1);

    if ( requested_heap_size == 0 ) {
      heap_size = Configuration.work_space_start - workarea_base;
      heap_size &= 0xfffffff0;  /* keep it as a multiple of 16 bytes */
    } else {
      heap_size = requested_heap_size;
    }

    bsp_libc_init((void *) heap_start, heap_size, 0);
  }
#endif

/*
 *  This is the initialization framework routine that weaves together
 *  calls to RTEMS and the BSP in the proper sequence to initialize
 *  the system while maximizing shared code and keeping BSP code in C
 *  as much as possible.
 */
int boot_card(
  int    argc, 
  char **argv, 
  char **envp
)
{
  static char  *argv_pointer = NULL;
  static char  *envp_pointer = NULL;
  char **argv_p = &argv_pointer;
  char **envp_p = &envp_pointer;
  rtems_interrupt_level bsp_isr_level;
  #if defined(BSP_BOOTCARD_HANDLES_RAM_ALLOCATION)
    void   *workarea_base;
    size_t  workarea_size;
    size_t  heap_size;
  #endif

  /*
   *  Make sure interrupts are disabled.
   */
  rtems_interrupt_disable( bsp_isr_level );

  /*
   *  Set things up so we have real pointers for argv and envp.
   *  If the BSP has passed us something useful, then pass it on.
   *  Somehow we need to eventually make this available to
   *  a real main() in user land. :)
   */
  if ( argv ) argv_p = argv;
  if ( envp ) envp_p = envp;

  /*
   *  Set the program name in case some application cares.
   */
  if ((argc > 0) && argv && argv[0])
    rtems_progname = argv[0];
  else
    rtems_progname = "RTEMS";

  /*
   *  Find out where the block of memory the BSP will use for
   *  the RTEMS Workspace and the C Program Heap is.
   */
  #if defined(BSP_BOOTCARD_HANDLES_RAM_ALLOCATION)
  {
    unsigned char     *work_space_start;

    bsp_get_workarea( &workarea_base, &workarea_size, &heap_size );

    work_space_start = workarea_base + workarea_size
      - rtems_configuration_get_work_space_size();

    if ( work_space_start <= (unsigned char *)workarea_base ) {
      printk( "bootcard: Not enough RAM!!!\n" );
      bsp_cleanup();
      return -1;
    }

    Configuration.work_space_start = work_space_start;

    #if (BSP_DIRTY_MEMORY == 1)
      memset(workarea_base, 0xCF,  workarea_size);
    #endif
  }

  #endif

  /*
   * Invoke Board Support Package initialization routine written in C.
   */
  bsp_start();

  /*
   *  Initialize RTEMS data structures
   */
  rtems_initialize_data_structures( &Configuration );

  /*
   *  Initialize the C library for those BSPs using the shared
   *  framework.
   */
  #if defined(BSP_BOOTCARD_HANDLES_RAM_ALLOCATION)
    bootcard_bsp_libc_helper( workarea_base, workarea_size, heap_size );
  #endif

  /*
   *  All BSP to do any required initialization now that RTEMS
   *  data structures are initialized.  In older BSPs or those
   *  which do not use the shared framework, this is the typical
   *  time when the C Library is initialized so malloc()
   *  can be called by device drivers.  For BSPs using the shared
   *  framework, this routine can be empty.
   */
  bsp_pretasking_hook();

  /*
   *  If debug is enabled, then enable all dynamic RTEMS debug 
   *  capabilities.
   *
   *  NOTE: Most debug features are conditionally compiled in
   *        or enabled via configure time plugins.
   */
  #ifdef RTEMS_DEBUG
    rtems_debug_enable( RTEMS_DEBUG_ALL_MASK );
  #endif

  /*
   *  Let RTEMS perform initialization it requires before drivers
   *  are allowed to be initialized.
   */
  rtems_initialize_before_drivers();

  /*
   *  Execute BSP specific pre-driver hook. Drivers haven't gotten
   *  to initialize yet so this is a good chance to initialize
   *  buses, spurious interrupt handlers, etc.. 
   *
   *  NOTE: Many BSPs do not require this handler and use the
   *        shared stub.
   */
  bsp_predriver_hook();

  /*
   *  Let RTEMS perform initialization it requires before drivers
   *  are allowed to be initialized.
   */
  rtems_initialize_before_drivers();

  /*
   *  Execute BSP specific pre-driver hook. Drivers haven't gotten
   *  to initialize yet so this is a good chance to initialize
   *  buses, spurious interrupt handlers, etc.. 
   *
   *  NOTE: Many BSPs do not require this handler and use the
   *        shared stub.
   */
  bsp_predriver_hook();

  /*
   *  Initialize all device drivers.
   */
  rtems_initialize_device_drivers();

  /*
   *  Invoke the postdriver hook.  This normally opens /dev/console
   *  for use as stdin, stdout, and stderr.
   */
  bsp_postdriver_hook();

  /*
   *  Complete initialization of RTEMS and switch to the first task.
   *  Global C++ constructors will be executed in the context of that task.
   */
  rtems_initialize_start_multitasking();

  /***************************************************************
   ***************************************************************
   *  APPLICATION RUNS HERE!!!  When it shuts down, we return!!! *
   ***************************************************************
   ***************************************************************
   */

  /*
   *  Perform any BSP specific shutdown actions which are written in C.
   */
  bsp_cleanup();

  /*
   *  Now return to the start code.
   */

  return 0;
}