bootcard.h

Go to the documentation of this file.

/*
 * Copyright (c) 2008-2014 embedded brains GmbH.  All rights reserved.
 *
 *  embedded brains GmbH
 *  Dornierstr. 4
 *  82178 Puchheim
 *  Germany
 *  <rtems@embedded-brains.de>
 *
 * The license and distribution terms for this file may be
 * found in the file LICENSE in this distribution or at
 * http://www.rtems.org/license/LICENSE.
 */

#ifndef LIBBSP_SHARED_BOOTCARD_H
#define LIBBSP_SHARED_BOOTCARD_H

#include <string.h>

#include <rtems/config.h>
#include <rtems/bspIo.h>
#include <rtems/malloc.h>
#include <rtems/score/wkspace.h>

#include <bspopts.h>

#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */

extern const char *bsp_boot_cmdline;

void bsp_start(void);

void bsp_reset(void);

void boot_card(const char *cmdline) RTEMS_NO_RETURN;

#ifdef CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK

  ptrdiff_t bsp_sbrk_init(Heap_Area *area, uintptr_t min_size);
#endif

static inline void bsp_work_area_initialize_default(
  void *area_begin,
  uintptr_t area_size
)
{
  Heap_Area area = {
    .begin = area_begin,
    .size = area_size
  };

  #if BSP_DIRTY_MEMORY == 1
    memset(area.begin, 0xCF,  area.size);
  #endif

  #ifdef CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK
    {
      uintptr_t overhead = _Heap_Area_overhead(CPU_HEAP_ALIGNMENT);
      uintptr_t work_space_size = rtems_configuration_get_work_space_size();
      ptrdiff_t sbrk_amount = bsp_sbrk_init(
        &area,
        work_space_size
          + overhead
          + (rtems_configuration_get_unified_work_area() ? 0 : overhead)
      );

      rtems_heap_set_sbrk_amount(sbrk_amount);
    }
  #endif

  /*
   *  The following may be helpful in debugging what goes wrong when
   *  you are allocating the Work Area in a new BSP.
   */
  #ifdef BSP_GET_WORK_AREA_DEBUG
    {
      void *sp = __builtin_frame_address(0);
      void *end = (char *) area.begin + area.size;
      printk(
        "work_area_start = 0x%p\n"
        "work_area_size = %lu 0x%08lx\n"
        "end = 0x%p\n"
        "current stack pointer = 0x%p%s\n",
        area.begin,
        (unsigned long) area.size,  /* decimal */
        (unsigned long) area.size,  /* hexadecimal */
        end,
        sp,
        (uintptr_t) sp >= (uintptr_t) area.begin
          && (uintptr_t) sp <= (uintptr_t) end ?
            " OVERLAPS!" : ""
      );
    }
  #endif

  _Workspace_Handler_initialization(&area, 1, NULL);

  #ifdef BSP_GET_WORK_AREA_DEBUG
    printk(
      "heap_start = 0x%p\n"
      "heap_size = %lu\n",
      area.begin,
      (unsigned long) area.size
    );
  #endif

  RTEMS_Malloc_Initialize(&area, 1, NULL);
}

static inline void bsp_work_area_initialize_with_table(
  Heap_Area *areas,
  size_t area_count
)
{
  _Workspace_Handler_initialization(areas, area_count, _Heap_Extend);
  RTEMS_Malloc_Initialize(areas, area_count, _Heap_Extend);
}

void bsp_work_area_initialize(void);

struct Per_CPU_Control;

void bsp_start_on_secondary_processor(struct Per_CPU_Control *cpu_self);

#ifdef __cplusplus
}
#endif /* __cplusplus */

#endif /* LIBBSP_SHARED_BOOTCARD_H */