soc: add realtek amebad SOC integration

zjian-zhang · zjian-zhang · commit 23abfbe95231 · 2025-06-25T11:02:38.000+08:00
Add initial version of Amebad Soc integration

Signed-off-by: zjian zhang &lt;zjian_zhang@realsil.com.cn&gt;
diff --git a/soc/realtek/ameba/CMakeLists.txt b/soc/realtek/ameba/CMakeLists.txt
@@ -0,0 +1,7 @@
+# Copyright (c) 2024 Realtek Semiconductor Corp.
+# SPDX-License-Identifier: Apache-2.0
+
+zephyr_include_directories(common)
+
+add_subdirectory(common)
+add_subdirectory(${CONFIG_SOC})
diff --git a/soc/realtek/ameba/Kconfig b/soc/realtek/ameba/Kconfig
@@ -0,0 +1,12 @@
+# Copyright (c) 2024 Realtek Semiconductor Corp.
+# SPDX-License-Identifier: Apache-2.0
+
+config SOC_FAMILY_REALTEK_AMEBA
+	select BUILD_OUTPUT_HEX
+	select SOC_EARLY_INIT_HOOK
+
+if SOC_FAMILY_REALTEK_AMEBA
+
+rsource "*/Kconfig"
+
+endif # SOC_FAMILY_REALTEK_AMEBA
diff --git a/soc/realtek/ameba/Kconfig.defconfig b/soc/realtek/ameba/Kconfig.defconfig
@@ -0,0 +1,8 @@
+# Copyright (c) 2024 Realtek Semiconductor Corp.
+# SPDX-License-Identifier: Apache-2.0
+
+if SOC_FAMILY_REALTEK_AMEBA
+
+rsource "*/Kconfig.defconfig"
+
+endif # SOC_FAMILY_REALTEK_AMEBA
diff --git a/soc/realtek/ameba/Kconfig.soc b/soc/realtek/ameba/Kconfig.soc
@@ -0,0 +1,10 @@
+# Copyright (c) 2024 Realtek Semiconductor Corp.
+# SPDX-License-Identifier: Apache-2.0
+
+config SOC_FAMILY_REALTEK_AMEBA
+	bool
+
+config SOC_FAMILY
+	default "realtek_ameba" if SOC_FAMILY_REALTEK_AMEBA
+
+rsource "*/Kconfig.soc"
diff --git a/soc/realtek/ameba/amebad/CMakeLists.txt b/soc/realtek/ameba/amebad/CMakeLists.txt
@@ -0,0 +1,14 @@
+# Copyright (c) 2024 Realtek Semiconductor Corp.
+# SPDX-License-Identifier: Apache-2.0
+
+zephyr_include_directories(${ZEPHYR_BASE}/drivers)
+zephyr_include_directories(.)
+
+zephyr_sources(soc.c)
+
+zephyr_linker_sources(SECTIONS boot_section.ld)
+set(SOC_LINKER_SCRIPT ${ZEPHYR_BASE}/include/zephyr/arch/arm/cortex_m/scripts/linker.ld CACHE INTERNAL "")
+
+zephyr_link_libraries(
+  -T${CMAKE_CURRENT_SOURCE_DIR}/ameba_rom_symbol_acut.ld
+)
diff --git a/soc/realtek/ameba/amebad/Kconfig b/soc/realtek/ameba/amebad/Kconfig
@@ -0,0 +1,16 @@
+# Copyright (c) 2024 Realtek Semiconductor Corp.
+# SPDX-License-Identifier: Apache-2.0
+
+config SOC_AMEBAD
+	select ARM
+	select CPU_CORTEX_M33
+	select CPU_HAS_DCACHE
+	select CPU_HAS_ICACHE
+	select CPU_HAS_ARM_SAU
+	select CPU_HAS_FPU
+	select CPU_HAS_VFP
+	select ARMV8_M_DSP
+	select CPU_HAS_ARM_MPU
+	select ARM_MPU
+	select ARM_TRUSTZONE_M
+	select ARM_ON_EXIT_CPU_IDLE
diff --git a/soc/realtek/ameba/amebad/Kconfig.defconfig b/soc/realtek/ameba/amebad/Kconfig.defconfig
@@ -0,0 +1,15 @@
+# Copyright (c) 2024 Realtek Semiconductor Corp.
+# SPDX-License-Identifier: Apache-2.0
+
+if SOC_AMEBAD
+
+config NUM_IRQS
+	default 64
+
+config SYS_CLOCK_HW_CYCLES_PER_SEC
+	default $(dt_node_int_prop_int,/clocks/clk_sys,clock-frequency)
+
+config CACHE_MANAGEMENT
+	default y
+
+endif #SOC_AMEBAD
diff --git a/soc/realtek/ameba/amebad/Kconfig.soc b/soc/realtek/ameba/amebad/Kconfig.soc
@@ -0,0 +1,9 @@
+# Copyright (c) 2024 Realtek Semiconductor Corp.
+# SPDX-License-Identifier: Apache-2.0
+
+config SOC_AMEBAD
+	bool
+	select SOC_FAMILY_REALTEK_AMEBA
+
+config SOC
+	default "amebad" if SOC_AMEBAD
diff --git a/soc/realtek/ameba/amebad/boot_section.ld b/soc/realtek/ameba/amebad/boot_section.ld
@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2024 Realtek Semiconductor Corp.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+	SECTION_PROLOGUE(.ram_image2.entry,,SUBALIGN(32))
+	{
+		__image2_entry_func__ = .;
+		KEEP(*(SORT(.image2.entry.data*)))
+		. = ALIGN(32);
+	} GROUP_DATA_LINK_IN(RAMABLE_REGION, ROMABLE_REGION)
+
+	SECTION_PROLOGUE(.psram_image2.text.data,,)
+	{
+		 __image2_backtrace_start__ = .;
+		 *(*.sramdram.only.text)
+
+		 . = ALIGN (4);
+		 __ipc_table_start__ = .;
+		 KEEP(*(*.ipc.table.data*))
+		 __ipc_table_end__ = .;
+		/*-----------------*/
+		__image2_backtrace_end__ = .;
+
+		. = ALIGN (32);
+	} GROUP_LINK_IN(ROMABLE_REGION)
diff --git a/soc/realtek/ameba/amebad/soc.c b/soc/realtek/ameba/amebad/soc.c
@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2024 Realtek Semiconductor Corp.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+#include <soc.h>
+#include <ameba_soc.h>
+#include <zephyr/device.h>
+#include <zephyr/init.h>
+#include <zephyr/kernel.h>
+#include <zephyr/cache.h>
+#include "ameba_system.h"
+
+void z_arm_reset(void);
+
+IMAGE2_ENTRY_SECTION
+RAM_START_FUNCTION Img2EntryFun0 = {z_arm_reset, NULL, /* BOOT_RAM_WakeFromPG, */
+				    (uint32_t)NewVectorTable};
+
+static void app_vdd1833_detect(void)
+{
+	u32 temp;
+
+	if (FALSE == is_power_supply18()) {
+		temp = HAL_READ32(SYSTEM_CTRL_BASE_HP, REG_HS_RFAFE_IND_VIO1833);
+		temp |= BIT_RFAFE_IND_VIO1833;
+		HAL_WRITE32(SYSTEM_CTRL_BASE_HP, REG_HS_RFAFE_IND_VIO1833, temp);
+	}
+
+	printk("REG_HS_RFAFE_IND_VIO1833 (0 is 1.8V): %x\n",
+	       HAL_READ32(SYSTEM_CTRL_BASE_HP, REG_HS_RFAFE_IND_VIO1833));
+}
+
+void soc_early_init_hook(void)
+{
+	/*
+	 * Cache is enabled by default at reset, disable it before
+	 * sys_cache*-functions can enable them.
+	 */
+	Cache_Enable(DISABLE);
+	sys_cache_data_enable();
+	sys_cache_instr_enable();
+
+	SystemSetCpuClk(CLK_KM4_200M);
+
+	app_vdd1833_detect();
+}
diff --git a/soc/realtek/ameba/amebad/soc.h b/soc/realtek/ameba/amebad/soc.h
@@ -0,0 +1,17 @@
+/*
+ * Copyright (c) 2024 Realtek Semiconductor Corp.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef ZEPHYR_SOC_REALTEK_AMEBA_AMEBAD_H_
+#define ZEPHYR_SOC_REALTEK_AMEBA_AMEBAD_H_
+
+#ifndef _ASMLANGUAGE
+
+#include <zephyr/sys/util.h>
+#include "cmsis_cpu.h"
+
+#endif /* _ASMLANGUAGE */
+
+#endif /* ZEPHYR_SOC_REALTEK_AMEBA_AMEBAD_H_ */
diff --git a/soc/realtek/ameba/amebad/soc_cpu_idle.h b/soc/realtek/ameba/amebad/soc_cpu_idle.h
@@ -0,0 +1,8 @@
+/*
+ * Copyright (c) 2024 Realtek Semiconductor Corp.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/* Workaround for WFI fused instruction issue */
+#define SOC_ON_EXIT_CPU_IDLE __NOP();
diff --git a/soc/realtek/ameba/common/CMakeLists.txt b/soc/realtek/ameba/common/CMakeLists.txt
@@ -0,0 +1,4 @@
+# Copyright (c) 2024 Realtek Semiconductor Corp.
+# SPDX-License-Identifier: Apache-2.0
+
+add_subdirectory(os_wrapper)
diff --git a/soc/realtek/ameba/common/os_wrapper/CMakeLists.txt b/soc/realtek/ameba/common/os_wrapper/CMakeLists.txt
@@ -0,0 +1,4 @@
+# Copyright (c) 2024 Realtek Semiconductor Corp.
+# SPDX-License-Identifier: Apache-2.0
+
+zephyr_include_directories(include)
diff --git a/soc/realtek/ameba/common/os_wrapper/include/os_wrapper.h b/soc/realtek/ameba/common/os_wrapper/include/os_wrapper.h
@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2024 Realtek Semiconductor Corp.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef __OS_WRAPPER_H__
+#define __OS_WRAPPER_H__
+
+/**
+ * @brief  Necessary headers
+ */
+#include <stdio.h>
+#include <string.h>
+#include <stdint.h>
+
+#include "platform_autoconf.h"
+#include "ameba.h"
+#include <zephyr/kernel.h>
+
+/**
+ * @brief  Common header file
+ */
+#ifdef __cplusplus
+extern "C" {
+#endif
+#include "os_wrapper_semaphore.h"
+#include "os_wrapper_critical.h"
+#include "os_wrapper_memory.h"
+#include "os_wrapper_mutex.h"
+#include "os_wrapper_queue.h"
+#include "os_wrapper_semaphore.h"
+#include "os_wrapper_task.h"
+#include "os_wrapper_time.h"
+#include "os_wrapper_timer.h"
+#ifdef __cplusplus
+}
+#endif
+
+/**
+ * @brief  General macro definition
+ */
+
+#define RTOS_MAX_DELAY   0xFFFFFFFFUL
+#define RTOS_MAX_TIMEOUT 0xFFFFFFFFUL
+
+#endif
diff --git a/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_critical.h b/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_critical.h
@@ -0,0 +1,31 @@
+/*
+ * Copyright (c) 2024 Realtek Semiconductor Corp.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef __OS_WRAPPER_CRITCAL_H__
+#define __OS_WRAPPER_CRITCAL_H__
+
+/**
+ * @brief  Check if in task interrupt
+ * @retval 1: interrupt; 0: context
+ */
+int rtos_critical_is_in_interrupt(void);
+
+/**
+ * @brief  Internally handles interrupt status (PRIMASK/CPSR) save
+ */
+void rtos_critical_enter(void);
+
+/**
+ * @brief  Internally handles interrupt status(PRIMASK/CPSR) restore
+ */
+void rtos_critical_exit(void);
+
+/**
+ * @brief  get task enter critical state
+ * @retval >0: in critical state; 0: exit critical state
+ */
+uint32_t rtos_get_critical_state(void);
+#endif
diff --git a/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_memory.h b/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_memory.h
@@ -0,0 +1,68 @@
+/*
+ * Copyright (c) 2024 Realtek Semiconductor Corp.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef __OS_WRAPPER_MEMORY_H__
+#define __OS_WRAPPER_MEMORY_H__
+
+/**
+ * @brief  Initialize dynamic memory pool
+ */
+void rtos_mem_init(void);
+
+/**
+ * @brief  Allocate memory from the heap. The buffer value is random
+ * @note   The return buffer size/address is cacheline size aligned
+ * @param  size: buffer size in byte
+ * @retval Pointer to memory the caller can now use
+ */
+void *rtos_mem_malloc(uint32_t size);
+
+/**
+ * @brief  Allocate memory from the heap. The buffer value is zero
+ * @note   The return buffer size/address is cacheline size aligned
+ * @param  size: buffer size in byte
+ * @retval Pointer to memory the caller can now use
+ */
+void *rtos_mem_zmalloc(uint32_t size);
+
+/**
+ * @brief  Allocate memory from the heap. The buffer value is zero
+ * @note   The return buffer size/address is cacheline size aligned
+ * @param  elementNum:  Number of elements, memory size is elementNum*elementSize
+ * @param  elementSize: Size of each array element (in bytes).
+ * @retval Pointer to memory the caller can now use
+ */
+void *rtos_mem_calloc(uint32_t elementNum, uint32_t elementSize);
+
+/**
+ * @brief  Reuse or extend memory previously allocated by the malloc(), calloc(), and realloc()
+ * functions
+ * @note   The return buffer size/address is cacheline size aligned
+ * @param  pbuf: Pointer containing the address
+ * @param  size: The number of bytes of memory to be newly allocated.
+ * @retval Pointer to memory the caller can now use
+ */
+void *rtos_mem_realloc(void *pbuf, uint32_t size);
+
+/**
+ * @brief  Deallocate memory from the heap.
+ * @param  pbuf: a pointer to memory previously allocated
+ */
+void rtos_mem_free(void *pbuf);
+
+/**
+ * @brief  Get free heap size.
+ * @retval Free heap size in byte
+ */
+uint32_t rtos_mem_get_free_heap_size(void);
+
+/**
+ * @brief  Get minimum ever free heap size.
+ * @retval Minimum ever free heap size in byte
+ */
+uint32_t rtos_mem_get_minimum_ever_free_heap_size(void);
+
+#endif
diff --git a/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_mutex.h b/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_mutex.h
diff --git a/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_queue.h b/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_queue.h
diff --git a/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_semaphore.h b/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_semaphore.h
diff --git a/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_task.h b/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_task.h
diff --git a/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_time.h b/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_time.h
diff --git a/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_timer.h b/soc/realtek/ameba/common/os_wrapper/include/os_wrapper_timer.h
diff --git a/soc/realtek/ameba/common/os_wrapper/include/platform_stdlib.h b/soc/realtek/ameba/common/os_wrapper/include/platform_stdlib.h
diff --git a/soc/realtek/ameba/soc.yml b/soc/realtek/ameba/soc.yml
