rtkconnectivity · janegu593 · Jan 20, 2026 · Feb 2, 2026 · Feb 2, 2026 · Feb 2, 2026
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -2,3 +2,4 @@
 # SPDX-License-Identifier: Apache-2.0
 
 add_subdirectory_ifdef(CONFIG_SOC_FAMILY_REALTEK_AMEBA ameba)
+add_subdirectory_ifdef(CONFIG_SOC_FAMILY_REALTEK_BEE bee)
diff --git a/Kconfig b/Kconfig
@@ -2,3 +2,4 @@
 # SPDX-License-Identifier: Apache-2.0
 
 rsource "ameba/Kconfig"
+rsource "bee/Kconfig"
diff --git a/README.rst b/README.rst
@@ -1,8 +1,35 @@
-Important Information About This Repository
-*******************************************
 
-HAL Realtek (or `hal_realtek`) is a collection of tools, low-level APIs, and hardware access functions for Realtek Devices.
+Realtek HAL Module (hal_realtek)
+################################
 
-This repository is a copy (not a fork) of the [ameba-rtos repository](https://github.com/Ameba-AIoT/ameba-rtos) that contains Ameba SoCs.
+HAL Realtek (or ``hal_realtek``) is a collection of tools, low-level APIs, and hardware access functions for Realtek Devices, enabling support within the Zephyr RTOS ecosystem.
 
-After following the standard Zephyr guide for compilation, both app and bootloader images tailored for Ameba SoCs will be generated. [Refer to this tutorial](https://github.com/Ameba-AIoT/ameba-rtos/) for Flashing these images and running on Ameba SoCs.
+Currently, the ``hal_realtek`` repository supports two primary SoC series: **Ameba** and **Bee**.
+
+Supported SoC Series
+*******************
+
+Ameba Series (ameba)
+====================
+
+The ``ameba`` directory contains the HAL for Ameba series SoCs.
+
+This repository is a copy (not a fork) of the `ameba-rtos repository <https://github.com/Ameba-AIoT/ameba-rtos>`_ that contains Ameba SoCs.
+
+After following the standard Zephyr guide for compilation, both app and bootloader images tailored for Ameba SoCs will be generated. Refer to this `tutorial <https://github.com/Ameba-AIoT/ameba-rtos/>`_ for Flashing these images and running on Ameba SoCs.
+
+Bee Series (bee)
+================
+
+The ``bee`` directory hosts the HAL for Bee series SoCs. The sources in this directory are extracted from their respective SDKs:
+
+* **RTL87x2G**: `rtkconnectivity/rtl87x2g_sdk <https://github.com/rtkconnectivity/rtl87x2g_sdk>`_
+
+* **RTL8752H**: `rtkconnectivity/rtl8752h_sdk <https://github.com/rtkconnectivity/rtl8752h_sdk>`_
+
+Maintenance & Synchronization Strategy
+**************************************
+
+Since the HALs for the **Ameba** and **Bee** series are maintained by different teams within Realtek, and additional SoC series may be added to ``hal_realtek`` in the future, there is no single upstream Git history for this repository.
+
+Therefore, this module adheres to the **"Updating modules with a diff from upstream"** practice as defined in the `Zephyr Project Documentation <https://docs.zephyrproject.org/latest/develop/modules.html#allowed-practices>`_.
diff --git a/ameba/Kconfig b/ameba/Kconfig
@@ -10,5 +10,6 @@ config REALTEK_AMEBA_HAL_LIB
 	  This option enables the Realtek Ameba HAL library.
 
 rsource "ameba*/Kconfig"
+rsource "common/wifi/Kconfig"
 
 endif # SOC_FAMILY_REALTEK_AMEBA
diff --git a/ameba/amebaG2/source/fwlib/include/ameba_phy.h b/ameba/amebaG2/source/fwlib/include/ameba_phy.h
diff --git a/ameba/amebaG2/source/fwlib/ram_km4tz/ameba_phy.c b/ameba/amebaG2/source/fwlib/ram_km4tz/ameba_phy.c
diff --git a/ameba/amebad/CMakeLists.txt b/ameba/amebad/CMakeLists.txt
@@ -1,20 +1,35 @@
 # Copyright (c) 2024 Realtek Semiconductor Corp.
 # SPDX-License-Identifier: Apache-2.0
+
+zephyr_link_libraries_ifdef(CONFIG_WIFI_AMEBA
+  -Wl,--start-group
+  ${LIB_PATH}/lib_wifi_rtk_app.a
+  ${LIB_PATH}/lib_wifi_single_core.a
+  -Wl,--end-group
+  ${LIB_PATH}/lib_wifi_api.a
+  ${LIB_PATH}/lib_rtw_event.a
+  ${LIB_PATH}/lib_wpa_lite.a
+  ${LIB_PATH}/lib_wifi_com_sec.a
+)
 zephyr_compile_options(-mcmse)
 
 zephyr_include_directories(
   include
   source/cmsis
   source/misc
   source/swlib
+  source/lib/include
   source/fwlib/include
+  source/usrcfg/include
   source/app/monitor/include
 )
 
 # used by common
 zephyr_library_sources(
   source/fwlib/ram_hp/ameba_system.c
+  source/fwlib/ram_common/ameba_pll.c
   source/swlib/log.c
+  source/fwlib/ram_common/ameba_reset.c
 )
 
 # used by driver, need use zephyr_library_sources_ifdef
@@ -37,31 +52,3 @@ zephyr_link_libraries(
   gcc
   -T${CMAKE_CURRENT_SOURCE_DIR}/ld/ameba_rom_symbol_acut.ld
 )
-
-# west sign
-if(CONFIG_SOC_AMEBA_NP_IMAGE)
-  file(GLOB blob_bin_file "${ZEPHYR_HAL_REALTEK_MODULE_DIR}/zephyr/blobs/${CONFIG_SOC_SERIES}/bin/*.bin")
-
-  if(blob_bin_file)
-    set(python_script_args
-      --soc ${CONFIG_SOC_SERIES}
-      --bin-file ${ZEPHYR_BINARY_DIR}/${KERNEL_BIN_NAME}
-      --out-dir ${CMAKE_BINARY_DIR}
-      --module-dir ${ZEPHYR_HAL_REALTEK_MODULE_DIR}
-    )
-
-    add_custom_target(zephyr.raw.map ALL
-      DEPENDS ${ZEPHYR_BINARY_DIR}/${KERNEL_NAME}.raw.map
-    )
-
-    add_custom_command(
-      OUTPUT ${ZEPHYR_BINARY_DIR}/${KERNEL_NAME}.raw.map
-      COMMAND ${CMAKE_NM} ${ZEPHYR_BINARY_DIR}/${KERNEL_ELF_NAME} | sort > ${ZEPHYR_BINARY_DIR}/${KERNEL_NAME}.raw.map
-      COMMAND ${CMAKE_OBJDUMP} -d ${ZEPHYR_BINARY_DIR}/${KERNEL_ELF_NAME} > ${ZEPHYR_BINARY_DIR}/${KERNEL_NAME}.asm
-      COMMAND ${PYTHON_EXECUTABLE} ${ZEPHYR_HAL_REALTEK_MODULE_DIR}/ameba/scripts/merge_bin.py ${python_script_args}
-      DEPENDS ${ZEPHYR_BINARY_DIR}/${KERNEL_ELF_NAME} ${blob_bin_file} ${CMAKE_CURRENT_SOURCE_DIR}/manifest.json5
-    )
-  else()
-    message(WARNING "Missing Realtek blobs. Run: `west blobs fetch hal_realtek`")
-  endif()
-endif()
diff --git a/ameba/amebad/Kconfig b/ameba/amebad/Kconfig
@@ -4,3 +4,6 @@
 config ARM_CORE_CM4
 	bool
 	default y if SOC_SERIES_AMEBAD
+
+config SOC_SERIES_AMEBAD
+	select SINGLE_CORE_WIFI if WLAN
diff --git a/ameba/amebad/include/platform_autoconf.h b/ameba/amebad/include/platform_autoconf.h
@@ -9,6 +9,7 @@
 #define CONFIG_IMG2_FLASH 1
 #define CONFIG_SUPPORT_ATCMD 1
 #define CONFIG_ATCMD_LOGUART 1
+#define CONFIG_VFS_LITTLEFS_INCLUDED 1
 #define CONFIG_LINK_ROM_SYMB 1
 #define CONFIG_CPU_HAS_FPU 1
 #define CONFIG_ARM_CORE_CM4 1
@@ -18,3 +19,4 @@
 #define CONFIG_AMEBAD_B_CUT 1
 #define CONFIG_SOC_PS_EN 1
 #define CONFIG_SOC_PS_MODULE 1
+#include <zephyr/autoconf.h>
diff --git a/ameba/amebad/source/fwlib/include/ameba.h b/ameba/amebad/source/fwlib/include/ameba.h
@@ -51,7 +51,7 @@
 #else
 #include "ameba_rcc_lp.h"
 #endif
-// #include "sscanf_minimal.h"
+#include "sscanf_minimal.h"
 
 #include "ameba_trustzone.h"
 #include "ameba_arch.h"

diff --git a/ameba/amebad/source/fwlib/include/ameba_efuse.h b/ameba/amebad/source/fwlib/include/ameba_efuse.h
@@ -159,7 +159,7 @@ int OTP_LogicalMap_Write(u32 addr, u32 cnts, u8 *data);
 int OTPSetCRC(void);
 int OTP_Read8(u32 Addr, u8 *Data);
 int OTP_Write8(u32 Addr, u8 Data);
-
+void EFUSE_GetUUID(u32 *UUID);
 /**
   * @}
   */

diff --git a/ameba/amebad/source/fwlib/include/ameba_gdma.h b/ameba/amebad/source/fwlib/include/ameba_gdma.h
@@ -459,7 +459,7 @@ _LONG_CALL_ void GDMA_SetChnlPriority(u8 GDMA_Index, u8 GDMA_ChNum, u32 ChnlPrio
 _LONG_CALL_ void GDMA_Suspend(u8 GDMA_Index, u8 GDMA_ChNum);
 _LONG_CALL_ void GDMA_Resume(u8 GDMA_Index, u8 GDMA_ChNum);
 _LONG_CALL_ u8 GDMA_Abort(u8 GDMA_Index, u8 GDMA_ChNum);
-
+_LONG_CALL_ u8 GDMA_ChannelIsActive(u8 GDMA_Index, u8 GDMA_ChNum);
 
 /**
   * @}

diff --git a/ameba/amebad/source/fwlib/include/ameba_reset.h b/ameba/amebad/source/fwlib/include/ameba_reset.h
@@ -12,6 +12,12 @@
 
 /* AUTO_GEN_END */
 
+#define	AON_BIT_RSTF_DSLP		BIT_BOOT_DSLP_RESET_HAPPEN
+#define	AON_BIT_RSTF_BOR		BIT_BOOT_BOD_RESET_HAPPEN
+
+#define IS_WDG_RESET(reason)	((reason) & (BIT_BOOT_WDG_RESET_HAPPEN | BIT_BOOT_KM4WDG_RESET_HAPPEN))
+#define IS_SYS_RESET(reason)	((reason) & (BIT_BOOT_SYS_RESET_HAPPEN | BIT_BOOT_KM4SYS_RESET_HAPPEN))
+
 extern void System_Reset(void);
 
 #endif
diff --git a/ameba/amebad/source/fwlib/include/ameba_ssi.h b/ameba/amebad/source/fwlib/include/ameba_ssi.h
@@ -660,6 +660,11 @@ extern const SPI_DevTable SPI_DEV_TABLE[2];
 #define SPI_BIT_RXFIS		BIT_ISR_RXFIS
 #define SPI_BIT_TXEIS		BIT_ISR_TXEIS
 
+/* SPI_SR */
+#define SPI_BIT_DCOL		BIT_SR_DCOL
+#define SPI_BIT_TFE			BIT_SR_TFE
+#define SPI_BIT_BUSY		BIT_SR_BUSY
+
 /* SPI_IMR */
 #define SPI_BIT_RXFIM		BIT_IMR_RXFIM
 #define SPI_BIT_RXOIM		BIT_IMR_RXOIM
Original file line number	Diff line number	Diff line change
Expand Up		@@ -2,3 +2,4 @@
		# SPDX-License-Identifier: Apache-2.0

		add_subdirectory_ifdef(CONFIG_SOC_FAMILY_REALTEK_AMEBA ameba)
		add_subdirectory_ifdef(CONFIG_SOC_FAMILY_REALTEK_BEE bee)