feat[driver][gd32]: Improve the RTC driver and support alarm interrupts

20 files changed, 603 insertions, 259 deletions

diff --git a/bsp/gd32/arm/gd32103c-eval/board/Kconfig b/bsp/gd32/arm/gd32103c-eval/board/Kconfig
index 04bbb2ed17..2e98cae740 100644
--- a/bsp/gd32/arm/gd32103c-eval/board/Kconfig
+++ b/bsp/gd32/arm/gd32103c-eval/board/Kconfig
@@ -140,16 +140,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32105c-eval/board/Kconfig b/bsp/gd32/arm/gd32105c-eval/board/Kconfig
index 78f854df59..85d4a8c223 100644
--- a/bsp/gd32/arm/gd32105c-eval/board/Kconfig
+++ b/bsp/gd32/arm/gd32105c-eval/board/Kconfig
@@ -136,16 +136,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32105r-start/board/Kconfig b/bsp/gd32/arm/gd32105r-start/board/Kconfig
index 175e602395..347dfd6c49 100644
--- a/bsp/gd32/arm/gd32105r-start/board/Kconfig
+++ b/bsp/gd32/arm/gd32105r-start/board/Kconfig
@@ -144,16 +144,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32107c-eval/board/Kconfig b/bsp/gd32/arm/gd32107c-eval/board/Kconfig
index 2a3c2af9e3..638e44e45c 100644
--- a/bsp/gd32/arm/gd32107c-eval/board/Kconfig
+++ b/bsp/gd32/arm/gd32107c-eval/board/Kconfig
@@ -136,16 +136,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32205r-start/board/Kconfig b/bsp/gd32/arm/gd32205r-start/board/Kconfig
index 86fa1bb592..79a1302610 100644
--- a/bsp/gd32/arm/gd32205r-start/board/Kconfig
+++ b/bsp/gd32/arm/gd32205r-start/board/Kconfig
@@ -140,16 +140,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32207i-eval/board/Kconfig b/bsp/gd32/arm/gd32207i-eval/board/Kconfig
index d5e71f3481..5cdf723083 100644
--- a/bsp/gd32/arm/gd32207i-eval/board/Kconfig
+++ b/bsp/gd32/arm/gd32207i-eval/board/Kconfig
@@ -170,16 +170,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32303e-eval/board/Kconfig b/bsp/gd32/arm/gd32303e-eval/board/Kconfig
index 6f6a7ee1cd..c0c2bfe04f 100644
--- a/bsp/gd32/arm/gd32303e-eval/board/Kconfig
+++ b/bsp/gd32/arm/gd32303e-eval/board/Kconfig
@@ -140,16 +140,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32305r-start/board/Kconfig b/bsp/gd32/arm/gd32305r-start/board/Kconfig
index 3673a722a5..ffa545e232 100644
--- a/bsp/gd32/arm/gd32305r-start/board/Kconfig
+++ b/bsp/gd32/arm/gd32305r-start/board/Kconfig
@@ -136,16 +136,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32307e-start/board/Kconfig b/bsp/gd32/arm/gd32307e-start/board/Kconfig
index eb42946b68..cfc1432f4f 100644
--- a/bsp/gd32/arm/gd32307e-start/board/Kconfig
+++ b/bsp/gd32/arm/gd32307e-start/board/Kconfig
@@ -137,16 +137,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32407v-lckfb/board/Kconfig b/bsp/gd32/arm/gd32407v-lckfb/board/Kconfig
index 818b925196..e2a75bc043 100644
--- a/bsp/gd32/arm/gd32407v-lckfb/board/Kconfig
+++ b/bsp/gd32/arm/gd32407v-lckfb/board/Kconfig
@@ -314,16 +314,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32407v-start/board/Kconfig b/bsp/gd32/arm/gd32407v-start/board/Kconfig
index 924415a552..dda538b604 100644
--- a/bsp/gd32/arm/gd32407v-start/board/Kconfig
+++ b/bsp/gd32/arm/gd32407v-start/board/Kconfig
@@ -294,16 +294,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32450z-eval/board/Kconfig b/bsp/gd32/arm/gd32450z-eval/board/Kconfig
index 7b47cebe82..a75b84f92e 100644
--- a/bsp/gd32/arm/gd32450z-eval/board/Kconfig
+++ b/bsp/gd32/arm/gd32450z-eval/board/Kconfig
@@ -362,16 +362,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32470i-eval/board/Kconfig b/bsp/gd32/arm/gd32470i-eval/board/Kconfig
index b063771866..290991f431 100644
--- a/bsp/gd32/arm/gd32470i-eval/board/Kconfig
+++ b/bsp/gd32/arm/gd32470i-eval/board/Kconfig
@@ -355,16 +355,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32470z-lckfb/board/Kconfig b/bsp/gd32/arm/gd32470z-lckfb/board/Kconfig
index 164debe5af..002adb84d7 100644
--- a/bsp/gd32/arm/gd32470z-lckfb/board/Kconfig
+++ b/bsp/gd32/arm/gd32470z-lckfb/board/Kconfig
@@ -377,16 +377,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32527I-eval/board/Kconfig b/bsp/gd32/arm/gd32527I-eval/board/Kconfig
index d5756aaa22..03f3feeb12 100644
--- a/bsp/gd32/arm/gd32527I-eval/board/Kconfig
+++ b/bsp/gd32/arm/gd32527I-eval/board/Kconfig
@@ -324,16 +324,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32e230-lckfb/board/Kconfig b/bsp/gd32/arm/gd32e230-lckfb/board/Kconfig
index 2c204fb9f1..356232d624 100644
--- a/bsp/gd32/arm/gd32e230-lckfb/board/Kconfig
+++ b/bsp/gd32/arm/gd32e230-lckfb/board/Kconfig
@@ -176,6 +176,7 @@ menu "On-chip Peripheral Drivers"
                       Fast mode: 400000 (400KHz)
                       Fast mode plus: 1000000 (1MHz)
             endif
+    endmenu
 
     menuconfig BSP_USING_ADC
         bool "Enable ADC"
@@ -206,16 +207,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select RTC clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC using LSE (External Crystal)"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC using LSI (Internal RC)"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32e503v-eval/board/Kconfig b/bsp/gd32/arm/gd32e503v-eval/board/Kconfig
index 1d9c0d9290..62280643b5 100644
--- a/bsp/gd32/arm/gd32e503v-eval/board/Kconfig
+++ b/bsp/gd32/arm/gd32e503v-eval/board/Kconfig
@@ -157,16 +157,22 @@ menu "On-chip Peripheral Drivers"
         select RT_USING_RTC
         default n
         if BSP_USING_ONCHIP_RTC
-            choice
-                prompt "Select clock source"
-                default BSP_RTC_USING_LSE
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
 
-                config BSP_RTC_USING_LSE
-                    bool "RTC USING LSE"
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
 
-                config BSP_RTC_USING_LSI
-                    bool "RTC USING LSI"
-            endchoice
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
         endif
 
     config BSP_USING_WDT
diff --git a/bsp/gd32/arm/gd32h759i-start/board/Kconfig b/bsp/gd32/arm/gd32h759i-start/board/Kconfig
index 54a654ed6e..a8e0d16464 100644
--- a/bsp/gd32/arm/gd32h759i-start/board/Kconfig
+++ b/bsp/gd32/arm/gd32h759i-start/board/Kconfig
@@ -69,6 +69,29 @@ menu "On-chip Peripheral Drivers"
 
         endif
 
+    menuconfig BSP_USING_ONCHIP_RTC
+        bool "Enable RTC"
+        select RT_USING_RTC
+        default n
+        if BSP_USING_ONCHIP_RTC
+            config BSP_USING_ALARM
+                bool "Enable RTC alarm"
+                select RT_USING_ALARM
+                default n
+            if BSP_USING_ALARM
+                choice
+                    prompt "Select rtc alarm device"
+                    default BSP_USING_ALARM0
+
+                    config BSP_USING_ALARM0
+                        bool "Enable RTC Alarm0"
+
+                    config BSP_USING_ALARM1
+                        bool "Enable RTC Alarm1"
+                endchoice
+            endif
+        endif
+
     source "$(BSP_DIR)/../libraries/gd32_drivers/Kconfig"
 
 endmenu
diff --git a/bsp/gd32/arm/libraries/gd32_drivers/SConscript b/bsp/gd32/arm/libraries/gd32_drivers/SConscript
index 6f8e59a79d..5d3a2a85de 100644
--- a/bsp/gd32/arm/libraries/gd32_drivers/SConscript
+++ b/bsp/gd32/arm/libraries/gd32_drivers/SConscript
@@ -18,8 +18,8 @@ if GetDepend(['RT_USING_SERIAL']):
         src += ['drv_usart_v2.c']
     else:
         src += ['drv_usart.c']
- 
- # add i2c hard drivers.       
+
+# add i2c hard drivers.       
 if GetDepend(['RT_USING_I2C']):
     if GetDepend('BSP_USING_HARD_I2C0') or GetDepend('BSP_USING_HARD_I2C1') or GetDepend('BSP_USING_HARD_I2C2') or GetDepend('BSP_USING_HARD_I2C3') or GetDepend('BSP_USING_HARD_I2C4') or GetDepend('BSP_USING_HARD_I2C5'):
         src += ['drv_hard_i2c.c']
diff --git a/bsp/gd32/arm/libraries/gd32_drivers/drv_rtc.c b/bsp/gd32/arm/libraries/gd32_drivers/drv_rtc.c
index b8e07954f4..fee92af39a 100644
--- a/bsp/gd32/arm/libraries/gd32_drivers/drv_rtc.c
+++ b/bsp/gd32/arm/libraries/gd32_drivers/drv_rtc.c
@@ -6,9 +6,13 @@
  * Change Logs:
  * Date           Author            Notes
  * 2022-01-25     iysheng           first version
+ * 2025-09-25     kurisaw           adapt to rt_rtc_ops interface
+ * 2025-09-25     kurisaw           add alarm interrupt support
  */
 
 #include <board.h>
+#include <rtdevice.h>
+#include <rthw.h>
 #include <sys/time.h>
 
 #define DBG_TAG             "drv.rtc"
@@ -18,11 +22,37 @@
 
 #ifdef RT_USING_RTC
 
-typedef struct {
-    struct rt_device rtc_dev;
-} gd32_rtc_device;
+#if defined(BSP_USING_ALARM)
+#if defined(BSP_USING_ALARM0) && defined(BSP_USING_ALARM1)
+#error "Only supports using one alarm at a time."
+#elif !defined(BSP_USING_ALARM0) && !defined(BSP_USING_ALARM1)
+#error "Please Enable RTC alarm define (BSP_USING_ALARM0 | BSP_USING_ALARM1)"
+#elif defined(BSP_USING_ALARM0)
+    #define BSP_ALARM_FLAG         RTC_FLAG_ALARM0
+    #define BSP_RTC_ALARM          RTC_ALARM0
+    #define BSP_RTC_INT_ALARM      RTC_INT_ALARM0
+#elif defined(BSP_USING_ALARM1)
+    #define BSP_ALARM_FLAG         RTC_FLAG_ALARM1
+    #define BSP_RTC_ALARM          RTC_ALARM1
+    #define BSP_RTC_INT_ALARM      RTC_INT_ALARM1
+#endif
+#endif
+
+#if defined(SOC_SERIES_GD32H7xx) || defined(SOC_SERIES_GD32F5xx)
 
-static gd32_rtc_device g_gd32_rtc_dev;
+#define rtc_year            year
+#define rtc_month           month
+#define rtc_date            date
+#define rtc_day_of_week     day_of_week
+#define rtc_hour            hour
+#define rtc_minute          minute
+#define rtc_second          second
+#define rtc_display_format  display_format
+
+#endif
+
+static time_t get_rtc_timestamp(void);
+static rt_err_t set_rtc_timestamp(time_t time_stamp);
 
 /**
  * @brief  Helper function: Convert BCD value to binary.
@@ -44,183 +74,371 @@ static rt_uint8_t bin_to_bcd(rt_uint8_t val)
     return ((val / 10) << 4) | (val % 10);
 }
 
+#ifdef BSP_USING_ALARM
+/* RTC device for alarm callback */
+static rt_device_t g_rtc_device = RT_NULL;
+
+/**
+ * @brief RTC Alarm Interrupt Handler
+ */
+void RTC_Alarm_IRQHandler(void)
+{
+    rt_interrupt_enter();
+
+    /* Check if alarm interrupt occurred */
+    if (rtc_flag_get(RTC_FLAG_ALARM0) != RESET)
+    {
+        /* Clear alarm flag */
+        rtc_flag_clear(RTC_FLAG_ALARM0);
+        exti_flag_clear(EXTI_17);
+
+        /* Notify RTC framework about alarm event */
+        if (g_rtc_device != RT_NULL)
+        {
+            rt_alarm_update(g_rtc_device, 1);
+        }
+        LOG_D("RTC Alarm0 triggered");
+    }
+
+    if (rtc_flag_get(RTC_FLAG_ALARM1) != RESET)
+    {
+        /* Clear alarm flag */
+        rtc_flag_clear(RTC_FLAG_ALARM1);
+        exti_flag_clear(EXTI_17);
+
+        /* Notify RTC framework about alarm event */
+        if (g_rtc_device != RT_NULL)
+        {
+            rt_alarm_update(g_rtc_device, 1);
+        }
+        LOG_D("RTC Alarm1 triggered");
+    }
+
+    rt_interrupt_leave();
+}
+#endif /* BSP_USING_ALARM */
+
+static rt_err_t gd_rtc_init(void)
+{
+    /* Enable PMU and backup domain clocks */
+    rcu_periph_clock_enable(RCU_PMU);
+    pmu_backup_write_enable();
+
+    /* Enable BKP and RTC clocks */
+#ifdef SOC_SERIES_GD32F10x
+    rcu_periph_clock_enable(RCU_BKPI);
+#else
+    rcu_periph_clock_enable(RCU_RTC);
+#endif
+
+    /* Check if RTC is already initialized by backup domain reset */
+    if (RTC_STAT & RTC_STAT_INITF)
+    {
+        LOG_D("RTC already initialized");
+        return RT_EOK;
+    }
+
+    /* Reset backup domain only if RTC is not running */
+    if ((RTC_STAT & RTC_STAT_RSYNF) == 0)
+    {
+        rcu_bkp_reset_enable();
+        rcu_bkp_reset_disable();
+
+        /* Re-enable clocks after reset */
+#ifdef SOC_SERIES_GD32F10x
+        rcu_periph_clock_enable(RCU_BKPI);
+#else
+        rcu_periph_clock_enable(RCU_RTC);
+#endif
+    }
+
+    /* Use LSE (32.768kHz) as RTC clock source */
+#define PRESCALER_S     0xFF
+#define PRESCALER_A     0x7F
+
+    rcu_osci_on(RCU_LXTAL);
+    if (rcu_osci_stab_wait(RCU_LXTAL) != SUCCESS)
+    {
+        LOG_E("LSE oscillator failed to stabilize");
+        return -RT_ERROR;
+    }
+    rcu_rtc_clock_config(RCU_RTCSRC_LXTAL);
+    LOG_D("RTC clock source: LSE (32.768kHz)");
+
+    /* Wait for RTC registers synchronization */
+    if (rtc_register_sync_wait() != SUCCESS)
+    {
+        LOG_E("RTC register synchronization failed");
+        return -RT_ERROR;
+    }
+
+    /* Set default time if RTC is not initialized */
+    if ((RTC_DATE == 0) || (RTC_TIME == 0))
+    {
+        time_t default_time = 1704067200; /* 2024-01-01 00:00:00 */
+        if (set_rtc_timestamp(default_time) != RT_EOK)
+        {
+            LOG_E("Failed to set default RTC time");
+            return -RT_ERROR;
+        }
+        LOG_D("RTC set to default time: 2024-01-01 00:00:00");
+    }
+
+    LOG_D("RTC initialization successful");
+    return RT_EOK;
+}
+
 static time_t get_rtc_timestamp(void)
 {
-    #if defined SOC_SERIES_GD32E23x
-    struct tm tm_new;
+    struct tm tm_new = {0};
     rtc_parameter_struct rtc_current_time;
 
+    /* Wait for register synchronization before reading */
+    if (rtc_register_sync_wait() != SUCCESS)
+    {
+        LOG_E("RTC sync failed before reading time");
+        return 0;
+    }
+
     rtc_current_time_get(&rtc_current_time);
 
-    tm_new.tm_year = bcd_to_bin(rtc_current_time.rtc_year) + 100; /* tm_year: years since 1900 */
-    tm_new.tm_mon  = bcd_to_bin(rtc_current_time.rtc_month) - 1;  /* tm_mon: month (0 = January, 11 = December) */
+    /* Convert BCD to binary and adjust year/month values */
+    tm_new.tm_year = bcd_to_bin(rtc_current_time.rtc_year) + 100; /* RTC year starts from 2000 */
+    tm_new.tm_mon  = bcd_to_bin(rtc_current_time.rtc_month) - 1;  /* tm_mon: 0-11 */
     tm_new.tm_mday = bcd_to_bin(rtc_current_time.rtc_date);
     tm_new.tm_hour = bcd_to_bin(rtc_current_time.rtc_hour);
     tm_new.tm_min  = bcd_to_bin(rtc_current_time.rtc_minute);
     tm_new.tm_sec  = bcd_to_bin(rtc_current_time.rtc_second);
 
-    return mktime(&tm_new);
-    #else
-    time_t rtc_counter;
+    /* Convert weekday: RTC uses 1-7 (Monday-Sunday), tm uses 0-6 (Sunday-Saturday) */
+    uint8_t rtc_wday = bcd_to_bin(rtc_current_time.rtc_day_of_week);
+    tm_new.tm_wday = (rtc_wday == 7) ? 0 : rtc_wday; /* Sunday conversion */
 
-    rtc_counter = (time_t)rtc_counter_get();
+    /* Calculate day of year */
+    tm_new.tm_yday = 0; /* Will be calculated by timegm */
+    tm_new.tm_isdst = 0; /* No daylight saving */
 
-    return rtc_counter;
-    #endif
+    /* Use timegm instead of mktime to avoid timezone issues */
+    return timegm(&tm_new);
+}
+
+static rt_err_t gd_get_secs(time_t *sec)
+{
+    if (sec == RT_NULL)
+    {
+        return -RT_EINVAL;
+    }
+
+    *sec = get_rtc_timestamp();
+    LOG_D("RTC: get timestamp %lu", *sec);
+
+    return RT_EOK;
 }
 
 static rt_err_t set_rtc_timestamp(time_t time_stamp)
 {
-    #if defined SOC_SERIES_GD32E23x
-    struct tm *p_tm;
+    struct tm now;
     rtc_parameter_struct rtc_init_struct;
+    ErrStatus status;
 
-    p_tm = gmtime(&time_stamp);
+    /* Use gmtime_r for thread safety */
+    gmtime_r(&time_stamp, &now);
 
-    /* GD32 RTC uses year starting from 2000; thus tm_year must be at least 100 (i.e., 2000 - 1900) */
-
-    if (p_tm->tm_year < 100)
+    if (now.tm_year < 100)
     {
+        LOG_E("Year must be >= 2000");
         return -RT_ERROR;
     }
 
-    rtc_init_struct.rtc_year = bin_to_bcd(p_tm->tm_year - 100);
-    rtc_init_struct.rtc_month = bin_to_bcd(p_tm->tm_mon + 1);
-    rtc_init_struct.rtc_date = bin_to_bcd(p_tm->tm_mday);
+    /* Convert to BCD format */
+    rtc_init_struct.rtc_year = bin_to_bcd(now.tm_year - 100); /* RTC year: 0-99 (2000-2099) */
+    rtc_init_struct.rtc_month = bin_to_bcd(now.tm_mon + 1);   /* RTC month: 1-12 */
+    rtc_init_struct.rtc_date = bin_to_bcd(now.tm_mday);
+
+    /* Convert weekday: tm_wday 0-6 (Sun-Sat) to RTC 1-7 (Mon-Sun) */
+    rtc_init_struct.rtc_day_of_week = bin_to_bcd(now.tm_wday == 0 ? 7 : now.tm_wday);
 
-    rtc_init_struct.rtc_day_of_week = bin_to_bcd(p_tm->tm_wday == 0 ? 7 : p_tm->tm_wday);
-    rtc_init_struct.rtc_hour = bin_to_bcd(p_tm->tm_hour);
-    rtc_init_struct.rtc_minute = bin_to_bcd(p_tm->tm_min);
-    rtc_init_struct.rtc_second = bin_to_bcd(p_tm->tm_sec);
+    rtc_init_struct.rtc_hour = bin_to_bcd(now.tm_hour);
+    rtc_init_struct.rtc_minute = bin_to_bcd(now.tm_min);
+    rtc_init_struct.rtc_second = bin_to_bcd(now.tm_sec);
     rtc_init_struct.rtc_display_format = RTC_24HOUR;
 
-#if defined(BSP_RTC_USING_LSI)
-    rtc_init_struct.rtc_factor_asyn = 39;
-    rtc_init_struct.rtc_factor_syn = 999;
-#elif defined(BSP_RTC_USING_LSE)
-    rtc_init_struct.rtc_factor_asyn = 127;
-    rtc_init_struct.rtc_factor_syn = 255;
-#endif
+    /* Use default prescaler values */
+    rtc_init_struct.factor_asyn = PRESCALER_A;
+    rtc_init_struct.factor_syn = PRESCALER_S;
+    rtc_init_struct.am_pm = RTC_AM;
 
-    if (rtc_init(&rtc_init_struct) != SUCCESS)
+    status = rtc_init(&rtc_init_struct);
+    if (status != SUCCESS)
     {
-        LOG_E("Failed to set RTC time.");
+        LOG_E("RTC time set failed: %d", status);
         return -RT_ERROR;
     }
 
+    /* Wait for synchronization after setting time */
+    if (rtc_register_sync_wait() != SUCCESS)
+    {
+        LOG_E("RTC sync failed after setting time");
+        return -RT_ERROR;
+    }
+
+    LOG_D("RTC time set successfully: %lu", time_stamp);
     return RT_EOK;
-    #else
-    uint32_t rtc_counter;
+}
+
+static rt_err_t gd_set_secs(time_t *sec)
+{
+    if (sec == RT_NULL)
+    {
+        return -RT_EINVAL;
+    }
+
+    rt_err_t result = set_rtc_timestamp(*sec);
+    if (result == RT_EOK)
+    {
+        LOG_D("RTC: set rtc_time %lu", *sec);
+    }
+    else
+    {
+        LOG_E("RTC: set rtc_time failed %lu", *sec);
+    }
 
-    rtc_counter = (uint32_t)time_stamp;
+    return result;
+}
+
+#ifdef BSP_USING_ALARM
+static rt_err_t gd_get_alarm(struct rt_rtc_wkalarm *alarm)
+{
+    if (alarm == RT_NULL)
+    {
+        return -RT_EINVAL;
+    }
 
-    /* wait until LWOFF bit in RTC_CTL to 1 */
-    rtc_lwoff_wait();
-    /* enter configure mode */
-    rtc_configuration_mode_enter();
-    /* write data to rtc register */
-    rtc_counter_set(rtc_counter);
-    /* exit configure mode */
-    rtc_configuration_mode_exit();
-    /* wait until LWOFF bit in RTC_CTL to 1 */
-    rtc_lwoff_wait();
+    rtc_alarm_struct rtc_alarm;
+
+    /* Get current alarm configuration */
+    rtc_alarm_get(BSP_RTC_ALARM, &rtc_alarm);
+
+    /* Convert RTC alarm to RT-Thread alarm format */
+    alarm->tm_hour = bcd_to_bin(rtc_alarm.alarm_hour);
+    alarm->tm_min = bcd_to_bin(rtc_alarm.alarm_minute);
+    alarm->tm_sec = bcd_to_bin(rtc_alarm.alarm_second);
+
+    /* Check if alarm is enabled */
+    uint32_t alarm_enable_bit = (BSP_RTC_ALARM == RTC_ALARM0) ? RTC_CTL_ALRM0EN : RTC_CTL_ALRM1EN;
+    alarm->enable = (RTC_CTL & alarm_enable_bit) ? 1 : 0;
+
+    LOG_D("RTC: get alarm %02d:%02d:%02d, enable: %d",
+          alarm->tm_hour, alarm->tm_min, alarm->tm_sec, alarm->enable);
 
     return RT_EOK;
-    #endif
 }
 
-static rt_err_t rt_gd32_rtc_control(rt_device_t dev, int cmd, void *args)
+static rt_err_t gd_set_alarm(struct rt_rtc_wkalarm *alarm)
 {
-    rt_err_t result = RT_EOK;
+    if (alarm == RT_NULL)
+    {
+        return -RT_EINVAL;
+    }
+
+    rtc_alarm_struct rtc_alarm;
+
+    rtc_alarm_disable(BSP_RTC_ALARM);
+    /* Initialize alarm structure */
+    rtc_alarm.alarm_mask = RTC_ALARM_ALL_MASK;
+    rtc_alarm.weekday_or_date = RTC_ALARM_DATE_SELECTED;
+    rtc_alarm.alarm_day = 1; /* Not used when mask is set to ALL_MASK */
+    rtc_alarm.alarm_hour = bin_to_bcd(alarm->tm_hour);
+    rtc_alarm.alarm_minute = bin_to_bcd(alarm->tm_min);
+    rtc_alarm.alarm_second = bin_to_bcd(alarm->tm_sec);
+    rtc_alarm.am_pm = RTC_AM;
 
-    RT_ASSERT(dev != RT_NULL);
-    switch (cmd)
+    /* Configure alarm */
+    rtc_alarm_config(BSP_RTC_ALARM, &rtc_alarm);
+
+    /* Enable or disable alarm */
+    if (alarm->enable)
     {
-    case RT_DEVICE_CTRL_RTC_GET_TIME:
-        *(rt_uint32_t *)args = get_rtc_timestamp();
-        break;
+        /* Clear any pending alarm flag first */
+        rtc_flag_clear(BSP_ALARM_FLAG);
 
-    case RT_DEVICE_CTRL_RTC_SET_TIME:
-        if (set_rtc_timestamp(*(rt_uint32_t *)args))
-        {
-            result = -RT_ERROR;
-        }
-        break;
+        /* Clear EXTI line 17 flag */
+        exti_flag_clear(EXTI_17);
+
+        /* Enable RTC alarm interrupt */
+        rtc_interrupt_enable(BSP_RTC_INT_ALARM);
+
+        /* Enable alarm */
+        rtc_alarm_enable(BSP_RTC_ALARM);
+
+        /* Configure EXTI line 17 for RTC alarm interrupt */
+        exti_init(EXTI_17, EXTI_INTERRUPT, EXTI_TRIG_RISING);
+
+        /* Enable RTC Alarm global interrupt in NVIC */
+        nvic_irq_enable(RTC_Alarm_IRQn, 0, 0);
+
+        LOG_D("RTC Alarm enabled with interrupt");
     }
+    else
+    {
+        /* Disable alarm interrupt first */
+        rtc_interrupt_disable(BSP_RTC_INT_ALARM);
 
-    return result;
+        /* Disable alarm */
+        rtc_alarm_disable(BSP_RTC_ALARM);
+
+        /* Clear alarm flag */
+        rtc_flag_clear(BSP_ALARM_FLAG);
+        exti_flag_clear(EXTI_17);
+
+        LOG_D("RTC Alarm disabled");
+    }
+
+    LOG_D("RTC: set alarm %02d:%02d:%02d, enable: %d",
+          alarm->tm_hour, alarm->tm_min, alarm->tm_sec, alarm->enable);
+
+    return RT_EOK;
 }
+#endif /* BSP_USING_ALARM */
 
-#ifdef RT_USING_DEVICE_OPS
-const static struct rt_device_ops g_gd32_rtc_ops =
+static const struct rt_rtc_ops gd_rtc_ops =
 {
-    RT_NULL,
-    RT_NULL,
-    RT_NULL,
-    RT_NULL,
-    RT_NULL,
-    rt_gd32_rtc_control
-};
+    .init      = gd_rtc_init,
+    .get_secs  = gd_get_secs,
+    .set_secs  = gd_set_secs,
+#ifdef BSP_USING_ALARM
+    .set_alarm = gd_set_alarm,
+    .get_alarm = gd_get_alarm,
 #endif
+};
+
+static rt_rtc_dev_t gd_rtc_dev;
 
 static int rt_hw_rtc_init(void)
 {
-    rt_err_t ret;
-    time_t rtc_counter;
+    rt_err_t result;
 
-    rcu_periph_clock_enable(RCU_PMU);
-    pmu_backup_write_enable();
-#ifndef SOC_SERIES_GD32E23x
-    rcu_periph_clock_enable(RCU_BKPI);
-#endif
+    gd_rtc_dev.ops = &gd_rtc_ops;
 
-    rtc_counter = get_rtc_timestamp();
-    /* once the rtc clock source has been selected, if can't be changed
-     * anymore unless the Backup domain is reset */
-    rcu_bkp_reset_enable();
-    rcu_bkp_reset_disable();
-    rcu_periph_clock_enable(RCU_RTC);
-#if defined(BSP_RTC_USING_LSE)
-    rcu_osci_on(RCU_LXTAL);
-    if (SUCCESS == rcu_osci_stab_wait(RCU_LXTAL))
+    result = rt_hw_rtc_register(&gd_rtc_dev, "rtc", RT_DEVICE_FLAG_RDWR, RT_NULL);
+    if (result != RT_EOK)
     {
-        /* set lxtal as rtc clock source */
-        rcu_rtc_clock_config(RCU_RTCSRC_LXTAL);
+        LOG_E("RTC register failed: %d", result);
+        return result;
     }
-#elif defined(BSP_RTC_USING_LSI)
-    rcu_osci_on(RCU_IRC40K);
-    if (SUCCESS == rcu_osci_stab_wait(RCU_IRC40K))
-    {
-        /* set IRC40K as rtc clock source */
-        rcu_rtc_clock_config(RCU_RTCSRC_IRC40K);
-    }
-#endif
-    set_rtc_timestamp(rtc_counter);
-
-#ifdef RT_USING_DEVICE_OPS
-    g_gd32_rtc_dev.rtc_dev.ops         = &g_gd32_rtc_ops;
-#else
-    g_gd32_rtc_dev.rtc_dev.init        = RT_NULL;
-    g_gd32_rtc_dev.rtc_dev.open        = RT_NULL;
-    g_gd32_rtc_dev.rtc_dev.close       = RT_NULL;
-    g_gd32_rtc_dev.rtc_dev.read        = RT_NULL;
-    g_gd32_rtc_dev.rtc_dev.write       = RT_NULL;
-    g_gd32_rtc_dev.rtc_dev.control     = rt_gd32_rtc_control;
-#endif
-    g_gd32_rtc_dev.rtc_dev.type        = RT_Device_Class_RTC;
-    g_gd32_rtc_dev.rtc_dev.rx_indicate = RT_NULL;
-    g_gd32_rtc_dev.rtc_dev.tx_complete = RT_NULL;
-    g_gd32_rtc_dev.rtc_dev.user_data   = RT_NULL;
 
-    ret = rt_device_register(&g_gd32_rtc_dev.rtc_dev, "rtc", \
-        RT_DEVICE_FLAG_RDWR);
-    if (ret != RT_EOK)
+#ifdef BSP_USING_ALARM
+    /* Store RTC device for alarm callback */
+    g_rtc_device = rt_device_find("rtc");
+    if (g_rtc_device == RT_NULL)
     {
-        LOG_E("failed register internal rtc device, err=%d", ret);
+        LOG_W("RTC device not found for alarm callback");
     }
+#endif
 
-    return ret;
+    LOG_D("RTC hardware init success");
+    return RT_EOK;
 }
 INIT_DEVICE_EXPORT(rt_hw_rtc_init);
-#endif
 
+#endif /* RT_USING_RTC */