NevynUK commented on code in PR #20125: URL: https://github.com/apache/nuttx/pull/20125#discussion_r4093538479
########## arch/risc-v/src/common/espressif/esp_userspace.c: ########## @@ -0,0 +1,458 @@ +/**************************************************************************** + * arch/risc-v/src/common/espressif/esp_userspace.c + * + * SPDX-License-Identifier: Apache-2.0 + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. The + * ASF licenses this file to you 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. + * + ****************************************************************************/ + +/**************************************************************************** + * Included Files + ****************************************************************************/ + +#include <nuttx/config.h> + +#include <assert.h> +#include <stdint.h> +#include <string.h> + +#include <nuttx/compiler.h> +#include <nuttx/userspace.h> + +#include <arch/board/board_memorymap.h> + +#include "riscv_internal.h" + +#include "esp_userspace.h" + +#include "esp_rom_sys.h" +#include "soc/soc.h" +#include "hal/cache_hal.h" +#include "hal/cache_ll.h" +#include "hal/mmu_hal.h" +#include "hal/mmu_types.h" +#include "spi_flash_mmap.h" +#include "bootloader_flash_priv.h" + +#if defined(CONFIG_ESPRESSIF_SPIRAM) && \ + defined(CONFIG_ESPRESSIF_SPIRAM_USER_HEAP) +# include "esp_psram.h" +# include "esp_private/esp_psram_extram.h" +#endif + +#ifdef CONFIG_BUILD_PROTECTED + +/**************************************************************************** + * Pre-processor Definitions + ****************************************************************************/ + +#define USER_IMAGE_OFFSET CONFIG_ESPRESSIF_USER_IMAGE_OFFSET + +/**************************************************************************** + * Private Types + ****************************************************************************/ + +/* Emitted at the start of the user image by user-space.ld. It tells the + * kernel where the user image expects its flash-mapped regions to live, so + * that the flash MMU can be programmed before any user code is reachable. + */ + +struct user_image_load_header_s +{ + uintptr_t drom_vma; /* Destination address (VMA) for DROM region */ + uintptr_t drom_lma; /* Flash offset (LMA) for start of DROM region */ + uintptr_t drom_size; /* Size of DROM region */ + uintptr_t irom_vma; /* Destination address (VMA) for IROM region */ + uintptr_t irom_lma; /* Flash offset (LMA) for start of IROM region */ + uintptr_t irom_size; /* Size of IROM region */ +}; + +/**************************************************************************** + * Private Data + ****************************************************************************/ + +static struct user_image_load_header_s g_header; + +/**************************************************************************** + * Private Functions + ****************************************************************************/ + +/**************************************************************************** + * Name: load_header + * + * Description: + * Read the user image load header out of flash. + * + * Unlike the ESP32-C3 protected port, which temporarily mapped a scratch + * flash window to reach the header, this reads it directly. The SPI flash + * driver is already initialised by the time esp_userspace() runs, and + * esp_start() uses the same call to parse the kernel image header, so no + * scratch mapping is needed. + * + * Input Parameters: + * None. + * + * Returned Value: + * None. + * + ****************************************************************************/ + +static void load_header(void) +{ + int ret = bootloader_flash_read(USER_IMAGE_OFFSET, &g_header, + sizeof(g_header), true); + + if (ret != 0) + { + esp_rom_printf("ERROR: user image header read failed: rc=%d at 0x%x\n", + ret, (unsigned int)USER_IMAGE_OFFSET); + PANIC(); + } +} + +/**************************************************************************** + * Name: configure_mmu + * + * Description: + * Map the user image's flash-resident code and read-only data into the + * virtual address space. + * + * This is deliberately additive. esp_start()'s map_rom_segments() calls + * mmu_hal_unmap_all() before installing the kernel's own mappings; doing + * that here would unmap the kernel while it is executing. Only the two + * user regions are added. + * + * The cache is disabled across the update, so this function -- and + * everything it calls -- must be resident in IRAM. The linker script + * places this object there by name. + * + * Input Parameters: + * None. + * + * Returned Value: + * None. + * + ****************************************************************************/ + +static void noinline_function configure_mmu(void) +{ + uint32_t actual_mapped_len = 0; + uint32_t drom_lma = USER_IMAGE_OFFSET + g_header.drom_lma; + uint32_t irom_lma = USER_IMAGE_OFFSET + g_header.irom_lma; + uint32_t drom_lma_aligned = drom_lma & MMU_FLASH_MASK; + uint32_t drom_vma_aligned = g_header.drom_vma & MMU_FLASH_MASK; + uint32_t irom_lma_aligned = irom_lma & MMU_FLASH_MASK; + uint32_t irom_vma_aligned = g_header.irom_vma & MMU_FLASH_MASK; + cache_bus_mask_t bus_mask; + + cache_hal_disable(CACHE_LL_LEVEL_EXT_MEM, CACHE_TYPE_ALL); + + mmu_hal_map_region(0, MMU_TARGET_FLASH0, + drom_vma_aligned, drom_lma_aligned, + g_header.drom_size, &actual_mapped_len); + + mmu_hal_map_region(0, MMU_TARGET_FLASH0, + irom_vma_aligned, irom_lma_aligned, + g_header.irom_size, &actual_mapped_len); + + bus_mask = cache_ll_l1_get_bus(0, drom_vma_aligned, g_header.drom_size); + cache_ll_l1_enable_bus(0, bus_mask); + bus_mask = cache_ll_l1_get_bus(0, irom_vma_aligned, g_header.irom_size); + cache_ll_l1_enable_bus(0, bus_mask); + Review Comment: Added documentation. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
