OpenSiFli · SiFli-bot · Mar 25, 2026 · Mar 25, 2026 · Mar 25, 2026 · Mar 25, 2026
diff --git a/README_EN.md b/README_EN.md
@@ -1,18 +1,20 @@
 # SiFli-SDK
 
-English | [中文](README.md)
+English | [中文](README_EN.md)
 
 ## Getting Started
-
-The SiFli SDK is an official software development framework, custom-built on RT-Thread, that enables rapid development of applications running on SiFli Technology’s chip platforms.
+The SiFli SDK is an official software development framework, custom-built on
+RT-Thread, that enables rapid development of applications running on SiFli
+Technology’s chip platforms.
 
 Relevant documentation:
 - https://wiki.sifli.com/
 - https://docs.sifli.com/projects/sdk/latest/sf32lb52x/index.html
 
 You can refer to these documents for a quick start.
 
-**Note**: Since the SDK includes submodules, you must clone the repository with the `--recursive` flag, for example:
+**Note**: Since the SDK includes submodules, you must clone the repository with
+the `--recursive` flag, for example:
 ```bash
 git clone --recursive https://github.com/OpenSiFli/SiFli-SDK
 ```
@@ -21,69 +23,95 @@ The software framework is illustrated below:
 
 ![sdk_arch_diagram](img/sdk_arch_diagram.png)
 
-- **HAL** is the Hardware Abstraction Layer, providing driver functionality without relying on any operating system services.  
-- **RT-Thread Device Drivers** are built on top of HAL and offer a higher-level abstraction; users do not need to write interrupt service routines, making them easier to use. For a detailed comparison between HAL and RT-Thread device drivers, see [Chip Peripheral Drivers](https://docs.sifli.com/projects/sdk/v2.3/sf32lb55x/app_development/drivers.html).  
-- **Middleware (components)** includes RT-Thread’s built-in software components (e.g., finsh, ulog), third-party components (under the `external` directory), and in-house components (under the `middleware` directory). Applications can use all service interfaces, including HAL, to build their software.
+- **HAL** is the Hardware Abstraction Layer, providing driver functionality
+  without relying on any operating system services.
+- **RT-Thread Device Drivers** are built on top of HAL and offer a higher-level
+  abstraction; users do not need to write interrupt service routines, making
+  them easier to use. For a detailed comparison between HAL and RT-Thread device
+  drivers, see [Chip Peripheral
+  Drivers](https://docs.sifli.com/projects/sdk/v2.3/sf32lb55x/app_development/drivers.html).
+- **Middleware (components)** includes RT-Thread’s built-in software components
+  (e.g., finsh, ulog), third-party components (under the `external` directory),
+  and in-house components (under the `middleware` directory). Applications can
+  use all service interfaces, including HAL, to build their software.
 
-### SDK Directory Structure
+SDK Directory Structure
 
 ```
-+---customer                 // Board Support Package
++---customer                 // Board Support Package (BSP)
 |   +---boards               // Board configuration files
+|   |
 |   +---peripherals          // Board-level peripheral drivers
 |
+|
 +---drivers
-|   +---cmsis                // Chip register headers, startup files, linker scripts
+|   +---cmsis                // Register headers, startup files, and linker scripts
 |   |   +---Include
 |   |   +---sf32lb52x
+|   |   |     
 |   |   +---sf32lb55x
+|   |   | 
 |   |   +---sf32lb56x
-|   |   +---sf32lb58x
-|   +---hal                  // HAL implementation code
-|   \---Include              // HAL header files
+|   |   |
+|   |   \---sf32lb58x
+|   |     
+|   +---hal                  // HAL implementation
+|   |
+|   \---Include              // HAL headers
+| 
++---example                  // Sample projects
 |
-+---example                  // Examples
 +---external                 // Third-party components
-+---middleware               // In-house components
+|
++---middleware               // Proprietary components
+|
 +---rtos                     // Operating systems
 |   +---freertos             // FreeRTOS
-|   +---os_adaptor           // OS abstraction layer
+|   |
+|   +---os_adaptor           // OS Abstraction Layer (OSAL)
+|   |
+|   |
 |   \---rtthread             // RT-Thread
 |       \---bsp
 |           \---sifli
-|               \---drivers  // RT-Thread device driver adapters
-\---tools                    // Tools
+|               \---drivers  // RT-Thread device driver adaptation
+|       
+|       
+|
+\---tools                    // Toolsets
 ```
 
 ## Versioning Policy
-
 Version numbers follow the [Semantic Versioning](https://semver.org/) scheme.
 
 The version format is **MAJOR.MINOR.PATCH**, with the following increment rules:
-
-- **MAJOR** version: incompatible API changes (e.g., v1.0.0 → v2.0.0)  
-- **MINOR** version: backward-compatible new features or enhancements (e.g., v2.3.0 → v2.4.0)  
-- **PATCH** version: backward-compatible bug fixes or small functional tweaks (e.g., v2.3.1 → v2.3.2)  
+- **MAJOR** version: incompatible API changes (e.g., v1.0.0 → v2.0.0)
+- **MINOR** version: backward-compatible new features or enhancements (e.g.,
+  v2.3.0 → v2.4.0)
+- **PATCH** version: backward-compatible bug fixes or small functional tweaks
+  (e.g., v2.3.1 → v2.3.2)
 
 Each release is tagged as `vX.Y.Z`.
 
 ### Release Cadence
-
-- **Patch releases**: as needed, typically as fast as one week  
-- **Minor releases**: every 4–5 months  
-- **Major releases**: once a year or longer  
+- **Patch releases**: as needed, typically as fast as one week
+- **Minor releases**: every 4–5 months
+- **Major releases**: once a year or longer
 
 ### Branches
-
 The repository contains the following branches:
-
-- `main`: development branch where all new features and fixes land. **Not recommended** for production development.  
-- `release/vX.Y`: minor release branches containing all patches for that minor version. All official releases are made from these branches (tags are placed on commits in these branches). **Recommended** for project development is either the latest release tag or the tip of the corresponding `release/vX.Y` branch.  
-- Other branches: temporary or feature branches for internal development. **Not recommended** for general use.  
+- `main`: development branch where all new features and fixes land. **Not
+  recommended** for production development.
+- `release/vX.Y`: minor release branches containing all patches for that minor
+  version. All official releases are made from these branches (tags are placed
+  on commits in these branches). **Recommended** for project development is
+  either the latest release tag or the tip of the corresponding `release/vX.Y`
+  branch.
+- Other branches: temporary or feature branches for internal development. **Not
+  recommended** for general use.
 
 ### Support Timeline
-
 | Version | Release Date     | End-of-Support Date | Supported |
-|---------|------------------|---------------------|-----------|
+| ------- | ---------------- | ------------------- | --------- |
 | v2.3    | January 21, 2025 |                     | Yes       |
 | v2.4    | June 5, 2025     |                     | Yes       |
diff --git a/docs/source/en/api/hal/adc.md b/docs/source/en/api/hal/adc.md
@@ -1,5 +1,6 @@
 (hal-adc)=
 # bf0_hal_adc.h
 ```{doxygenfile} bf0_hal_adc.h
+
 ```
 
diff --git a/docs/source/en/api/hal/aes.md b/docs/source/en/api/hal/aes.md
@@ -1,6 +1,7 @@
 (hal-aes)=
 # bf0_hal_aes.h
 ```{doxygenfile} bf0_hal_aes.h
+
 ```
 
 
diff --git a/docs/source/en/api/hal/aon.md b/docs/source/en/api/hal/aon.md
@@ -1,5 +1,6 @@
 (hal-aon)=
 # bf0_hal_aon.h
 ```{doxygenfile} bf0_hal_aon.h
+
 ```
 
diff --git a/docs/source/en/api/hal/atim.md b/docs/source/en/api/hal/atim.md
@@ -1,4 +1,5 @@
 (hal-tim-ex)=
 # bf0_hal_tim_ex.h
 ```{doxygenfile} bf0_hal_tim_ex.h
+
 ```
diff --git a/docs/source/en/api/hal/audcodec.md b/docs/source/en/api/hal/audcodec.md
@@ -1,4 +1,5 @@
 (hal-audcodec)=
 # bf0_hal_audcodec.h
 ```{doxygenfile} bf0_hal_audcodec.h
-```
+
+```
diff --git a/docs/source/en/api/hal/audprc.md b/docs/source/en/api/hal/audprc.md
@@ -1,6 +1,7 @@
 (hal-audprc)=
 # bf0_hal_audprc.h
 ```{doxygenfile} bf0_hal_audprc.h
+
 ```
 
 
diff --git a/docs/source/en/api/hal/busmon.md b/docs/source/en/api/hal/busmon.md
@@ -1,4 +1,5 @@
 
 # bf0_hal_busmon.h
 ```{doxygenfile} bf0_hal_busmon.h
+
 ```
diff --git a/docs/source/en/api/hal/cache.md b/docs/source/en/api/hal/cache.md
@@ -1,4 +1,5 @@
 (hal-cache)=
 # bf0_hal_cache.h
 ```{doxygenfile} bf0_hal_cache.h
+
 ```
diff --git a/docs/source/en/api/hal/crc.md b/docs/source/en/api/hal/crc.md
@@ -1,3 +1,4 @@
 # bf0_hal_crc.h
 ```{doxygenfile} bf0_hal_crc.h
+
 ```
diff --git a/docs/source/en/api/hal/dma.md b/docs/source/en/api/hal/dma.md
@@ -1,4 +1,5 @@
 # bf0_hal_dma.h
 ```{doxygenfile} bf0_hal_dma.h
+
 ```
 
diff --git a/docs/source/en/api/hal/dsi.md b/docs/source/en/api/hal/dsi.md
@@ -1,4 +1,5 @@
 # bf0_hal_dsi.h
 ```{doxygenfile} bf0_hal_dsi.h
+
 ```
 
diff --git a/docs/source/en/api/hal/efuse.md b/docs/source/en/api/hal/efuse.md
@@ -1,4 +1,5 @@
 # bf0_hal_efuse.h
 ```{doxygenfile} bf0_hal_efuse.h
+
 ```
 
diff --git a/docs/source/en/api/hal/epic.md b/docs/source/en/api/hal/epic.md
@@ -1,5 +1,6 @@
 (hal-epic)=
 # bf0_hal_epic.h
 ```{doxygenfile} bf0_hal_epic.h
+
 ```
 
diff --git a/docs/source/en/api/hal/ext_dma.md b/docs/source/en/api/hal/ext_dma.md
@@ -1,5 +1,6 @@
 # bf0_hal_ext_dma.h
 ```{doxygenfile} bf0_hal_ext_dma.h
+
 ```
 
 
diff --git a/docs/source/en/api/hal/ezip.md b/docs/source/en/api/hal/ezip.md
@@ -1,5 +1,6 @@
 (hal-ezip)=
 # bf0_hal_ezip.h
 ```{doxygenfile} bf0_hal_ezip.h
+
 ```
 
diff --git a/docs/source/en/api/hal/facc.md b/docs/source/en/api/hal/facc.md
@@ -1,6 +1,7 @@
 (hal-facc)=
 # bf0_hal_facc.h
 ```{doxygenfile} bf0_hal_facc.h
+
 ```
 
 
diff --git a/docs/source/en/api/hal/fft.md b/docs/source/en/api/hal/fft.md
@@ -1,5 +1,6 @@
 (hal-fft)=
 # bf0_hal_fft.h
 ```{doxygenfile} bf0_hal_fft.h
+
 ```
 
diff --git a/docs/source/en/api/hal/gpio.md b/docs/source/en/api/hal/gpio.md
@@ -1,5 +1,6 @@
 (hal-gpio)=
 # bf0_hal_gpio.h
 ```{doxygenfile} bf0_hal_gpio.h
+
 ```
 
diff --git a/docs/source/en/api/hal/gpt.md b/docs/source/en/api/hal/gpt.md
@@ -1,5 +1,6 @@
 (hal-tim)=
 # bf0_hal_tim.h
 ```{doxygenfile} bf0_hal_tim.h
+
 ```
 
diff --git a/docs/source/en/api/hal/i2c.md b/docs/source/en/api/hal/i2c.md
@@ -1,5 +1,6 @@
 (hal-i2c)=
 # bf0_hal_i2c.h
 ```{doxygenfile} bf0_hal_i2c.h
+
 ```
 
diff --git a/docs/source/en/api/hal/i2s.md b/docs/source/en/api/hal/i2s.md
@@ -1,5 +1,6 @@
 (hal-i2s)=
 # bf0_hal_i2s.h
 ```{doxygenfile} bf0_hal_i2s.h
+
 ```
 
diff --git a/docs/source/en/api/hal/index.md b/docs/source/en/api/hal/index.md
@@ -5,5 +5,4 @@
 :glob:
 
 *
-
-```
+```
diff --git a/docs/source/en/api/hal/lcdc.md b/docs/source/en/api/hal/lcdc.md
@@ -1,4 +1,5 @@
 # bf0_hal_lcdc.h
 ```{doxygenfile} bf0_hal_lcdc.h
+
 ```
 
diff --git a/docs/source/en/api/hal/lptim.md b/docs/source/en/api/hal/lptim.md
@@ -1,5 +1,6 @@
 (hal-lptim)=
 # bf0_hal_lptim.h
 ```{doxygenfile} bf0_hal_lptim.h
+
 ```
 
diff --git a/docs/source/en/api/hal/mailbox.md b/docs/source/en/api/hal/mailbox.md
@@ -1,6 +1,7 @@
 (hal-mailbox)=
 # bf0_hal_mailbox.h
 ```{doxygenfile} bf0_hal_mailbox.h
+
 ```
 
 
diff --git a/docs/source/en/api/hal/mpi.md b/docs/source/en/api/hal/mpi.md
@@ -1,5 +1,6 @@
 # bf0_hal_mpi.h
 ```{doxygenfile} bf0_hal_mpi.h
+
 ```
 
 
diff --git a/docs/source/en/api/hal/nnacc.md b/docs/source/en/api/hal/nnacc.md
@@ -1,4 +1,5 @@
 # bf0_hal_nn_acc.h
 ```{doxygenfile} bf0_hal_nn_acc.h
+
 ```
 
diff --git a/docs/source/en/api/hal/patch.md b/docs/source/en/api/hal/patch.md
@@ -1,5 +1,6 @@
 # bf0_hal_patch.h
 ```{doxygenfile} bf0_hal_patch.h
+
 ```
 
 
diff --git a/docs/source/en/api/hal/pcd.md b/docs/source/en/api/hal/pcd.md
@@ -1,4 +1,5 @@
 # bf0_hal_pcd.h
 ```{doxygenfile} bf0_hal_pcd.h
+
 ```
 
diff --git a/docs/source/en/api/hal/pdm.md b/docs/source/en/api/hal/pdm.md
@@ -1,5 +1,6 @@
 # bf0_hal_pdm.h
 ```{doxygenfile} bf0_hal_pdm.h
+
 ```
 
 
diff --git a/docs/source/en/api/hal/pinmux.md b/docs/source/en/api/hal/pinmux.md
@@ -1,6 +1,7 @@
 (hal-pinmux)=
 # bf0_hal_pinmux.h
 ```{doxygenfile} bf0_hal_pinmux.h
+
 ```
 
 
diff --git a/docs/source/en/api/hal/pmu.md b/docs/source/en/api/hal/pmu.md
@@ -1,6 +1,7 @@
 (hal-pmu)=
 # bf0_hal_pmu.h
 ```{doxygenfile} bf0_hal_pmu.h
+
 ```
 
 

diff --git a/docs/source/en/api/hal/psram.md b/docs/source/en/api/hal/psram.md
@@ -1,5 +1,6 @@
 # bf0_hal_psram.h
 ```{doxygenfile} bf0_hal_psram.h
+
 ```
 
 
diff --git a/docs/source/en/api/hal/qspi.md b/docs/source/en/api/hal/qspi.md
@@ -1,5 +1,6 @@
 (hal-qspi)=
 # bf0_hal_qspi.h
 ```{doxygenfile} bf0_hal_qspi.h
+
 ```
 
diff --git a/docs/source/en/api/hal/rcc.md b/docs/source/en/api/hal/rcc.md
@@ -1,4 +1,5 @@
 # bf0_hal_rcc.h
 ```{doxygenfile} bf0_hal_rcc.h
+
 ```
 
diff --git a/docs/source/en/api/hal/rng.md b/docs/source/en/api/hal/rng.md
@@ -1,5 +1,6 @@
 # bf0_hal_rng.h
 ```{doxygenfile} bf0_hal_rng.h
+
 ```
-Original file line number
+Diff line change
@@ Expand Up / @@ -5,5 +5,4 @@ @@
     :glob:
     *
-    ```
+    ```