text: /****************************************************************************
   *
   * Copyright 2017 Samsung Electronics All Rights Reserved.
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   * http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing,
   * software distributed under the License is distributed on an
   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
   * either express or implied. See the License for the specific
   * language governing permissions and limitations under the License.
   *
   ****************************************************************************/
  /****************************************************************************
   * arch/arm/src/tiva/tiva_allocateheap.c
   *
   *   Copyright (C) 2013, 2015 Gregory Nutt. All rights reserved.
   *   Author: Gregory Nutt <gnutt@nuttx.org>
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   * 3. Neither the name NuttX nor the names of its contributors may be
   *    used to endorse or promote products derived from this software
   *    without specific prior written permission.
   *
   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
   * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
   * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
   * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
   * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
   * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
   * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
   * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
   * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
   * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
   * POSSIBILITY OF SUCH DAMAGE.
   *
   ****************************************************************************/
  
  /****************************************************************************
   * Included Files
   ****************************************************************************/
  
  #include <tinyara/config.h>
  
  #include <sys/types.h>
  #include <stdint.h>
  #include <assert.h>
  #include <debug.h>
  
  #include <tinyara/arch.h>
  #include <tinyara/board.h>
  #include <tinyara/userspace.h>
  #include <tinyara/mm/mm.h>
  #include <tinyara/mm/heap_regioninfo.h>
  
  #include <arch/board/board.h>
  
  #include "mpu.h"
  #include "up_arch.h"
  #include "up_internal.h"
  #include "tiva_mpuinit.h"
  
  /****************************************************************************
   * Private Definitions
   ****************************************************************************/
  
  /****************************************************************************
   * Private Data
   ****************************************************************************/
  
  /****************************************************************************
   * Private Functions
   ****************************************************************************/
  
  /****************************************************************************
   * Public Functions
   ****************************************************************************/
  
  /****************************************************************************
   * Name: up_allocate_heap
   *
   * Description:
   *   This function will be called to dynamically set aside the heap region.
   *
   *   For the kernel build (CONFIG_BUILD_PROTECTED=y) with both kernel- and
   *   user-space heaps (CONFIG_MM_KERNEL_HEAP=y), this function provides the
   *   size of the unprotected, user-space heap.
   *
   *   If a protected kernel-space heap is provided, the kernel heap must be
   *   allocated (and protected) by an analogous up_allocate_kheap().
   *
   *   The following memory map is assumed for the flat build:
   *
   *     .data region.  Size determined at link time.
   *     .bss  region  Size determined at link time.
   *     IDLE thread stack.  Size determined by CONFIG_IDLETHREAD_STACKSIZE.
   *     Heap.  Extends to the end of SRAM.
   *
   *   The following memory map is assumed for the kernel build:
   *
   *     Kernel .data region.  Size determined at link time.
   *     Kernel .bss  region  Size determined at link time.
   *     Kernel IDLE thread stack.  Size determined by CONFIG_IDLETHREAD_STACKSIZE.
   *     Padding for alignment
   *     User .data region.  Size determined at link time.
   *     User .bss region  Size determined at link time.
   *     Kernel heap.  Size determined by CONFIG_MM_KERNEL_HEAPSIZE.
   *     User heap.  Extends to the end of SRAM.
   *
   ****************************************************************************/
  
  void up_allocate_heap(FAR void **heap_start, size_t *heap_size)
  {
  #if defined(CONFIG_BUILD_PROTECTED) && defined(CONFIG_MM_KERNEL_HEAP)
  	/* Get the unaligned size and position of the user-space heap.
  	 * This heap begins after the user-space .bss section at an offset
  	 * of CONFIG_MM_KERNEL_HEAPSIZE (subject to alignment).
  	 */
  
  	uintptr_t ubase = (uintptr_t) USERSPACE->us_bssend + CONFIG_MM_KERNEL_HEAPSIZE;
  	size_t usize = REGION_END - ubase;
  	int log2;
  
  	DEBUGASSERT(ubase < (uintptr_t)(REGION_END);
  
  	/* Adjust that size to account for MPU alignment requirements.
  	 * NOTE that there is an implicit assumption that the RAM_END(REGION_START + REGION_SIZE)
  	 * is aligned to the MPU requirement.
  	 */
  
  	log2 = (int)mpu_log2regionfloor(usize);
  	DEBUGASSERT((REGION_END & ((1 << log2) - 1)) == 0);
  
  	usize = (1 << log2);
  	ubase = REGION_END - usize;
  
  	/* Return the user-space heap settings */
  
  	board_led_on(LED_HEAPALLOCATE);
  	*heap_start = (FAR void *)ubase;
  	*heap_size = usize;
  
  	/* Allow user-mode access to the user heap memory */
  
  	tiva_mpu_uheap((uintptr_t) ubase, usize);
  #else
  
  	/* Return the heap settings */
  
  	board_led_on(LED_HEAPALLOCATE);
  	*heap_start = (FAR void *)g_idle_topstack;
  	*heap_size =  REGION_END - (uint32_t)(*heap_start);
  #endif
  }
  
  /****************************************************************************
   * Name: up_allocate_kheap
   *
   * Description:
   *   For the kernel build (CONFIG_BUILD_PROTECTED=y) with both kernel- and
   *   user-space heaps (CONFIG_MM_KERNEL_HEAP=y), this function allocates
   *   (and protects) the kernel-space heap.
   *
   ****************************************************************************/
  
  #if defined(CONFIG_BUILD_PROTECTED) && defined(CONFIG_MM_KERNEL_HEAP)
  void up_allocate_kheap(FAR void **heap_start, size_t *heap_size)
  {
  	/* Get the unaligned size and position of the user-space heap.
  	 * This heap begins after the user-space .bss section at an offset
  	 * of CONFIG_MM_KERNEL_HEAPSIZE (subject to alignment).
  	 */
  
  	uintptr_t ubase = (uintptr_t) USERSPACE->us_bssend + CONFIG_MM_KERNEL_HEAPSIZE;
  	size_t usize = REGION_END - ubase;
  	int log2;
  
  	DEBUGASSERT(ubase < (uintptr_t)(REGION_END));
  
  	/* Adjust that size to account for MPU alignment requirements.
  	 * NOTE that there is an implicit assumption that the RAM_END(REGION_START + REGION_SIZE)
  	 * is aligned to the MPU requirement.
  	 */
  
  	log2 = (int)mpu_log2regionfloor(usize);
  	DEBUGASSERT((REGION_END & ((1 << log2) - 1)) == 0);
  
  	usize = (1 << log2);
  	ubase = REGION_END - usize;
  
  	/* Return the kernel heap settings (i.e., the part of the heap region
  	 * that was not dedicated to the user heap).
  	 */
  
  	*heap_start = (FAR void *)USERSPACE->us_bssend;
  	*heap_size = ubase - (uintptr_t)USERSPACE->us_bssend;
  }
  #endif
  