add commit to ld files

STM32H723XG_FLASH.ld

@@ -1,7 +1,6 @@
 /*
 ******************************************************************************
 **
-
 **  File        : LinkerScript.ld
 **
 **  Author		: STM32CubeMX
@@ -16,7 +15,7 @@
 **
 **  Target      : STMicroelectronics STM32
 **
-**  Distribution: The file is distributed “as is,” without any warranty
+**  Distribution: The file is distributed "as is," without any warranty
 **                of any kind.
 **
 *****************************************************************************
@@ -24,105 +23,95 @@
 **
 ** <h2><center>&copy; COPYRIGHT(c) 2025 STMicroelectronics</center></h2>
 **
-** Redistribution and use in source and binary forms, with or without modification,
+** 版权声明和许可条款
-** are permitted provided that the following conditions are met:
-**   1. Redistributions of source code must retain the above copyright notice,
-**      this list of conditions and the following disclaimer.
-**   2. Redistributions in binary form must reproduce the above copyright notice,
-**      this list of conditions and the following disclaimer in the documentation
-**      and/or other materials provided with the distribution.
-**   3. Neither the name of STMicroelectronics nor the names of its contributors
-**      may be used to endorse or promote products derived from this software
-**      without specific prior written permission.
-**
-** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-** AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-** IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-** DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-** FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-** DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-** SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-** CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-** OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 **
 *****************************************************************************
 */
 
-/* Entry Point */
+/* 程序入口点 - 指定复位处理程序为程序的起始执行点 */
 ENTRY(Reset_Handler)
 
-/* Specify the memory areas */
+/* 定义内存区域 */
 MEMORY
 {
+/* 数据紧耦合内存 (Data TCM) - 128KB，零等待周期，用于高性能数据访问 */
 DTCMRAM (xrw)      : ORIGIN = 0x20000000, LENGTH = 128K
+/* D1域RAM (AXI SRAM) - 320KB，主系统内存 */
 RAM_D1 (xrw)      : ORIGIN = 0x24000000, LENGTH = 320K
+/* D2域RAM (AHB SRAM) - 32KB，用于外设数据缓冲 */
 RAM_D2 (xrw)      : ORIGIN = 0x30000000, LENGTH = 32K
+/* D3域RAM (备份域RAM) - 16KB，在低功耗模式下保持数据 */
 RAM_D3 (xrw)      : ORIGIN = 0x38000000, LENGTH = 16K
+/* 指令紧耦合内存 (Instruction TCM) - 64KB，零等待周期，用于高性能代码执行 */
 ITCMRAM (xrw)      : ORIGIN = 0x00000000, LENGTH = 64K
+/* 主闪存 - 1024KB，存储程序代码和常量数据 */
 FLASH (rx)      : ORIGIN = 0x8000000, LENGTH = 1024K
 }
 
-/* Highest address of the user mode stack */
+/* 定义用户模式栈的最高地址（栈向低地址增长） */
-_estack = ORIGIN(DTCMRAM) + LENGTH(DTCMRAM);    /* end of RAM */
+_estack = ORIGIN(DTCMRAM) + LENGTH(DTCMRAM);    /* RAM的末尾作为栈起始位置 */
-/* Generate a link error if heap and stack don't fit into RAM */
-_Min_Heap_Size = 0x4000;      /* required amount of heap  */
-_Min_Stack_Size = 0x4000; /* required amount of stack */
 
-/* Define output sections */
+/* 如果堆和栈不能放入RAM则生成链接错误 */
+_Min_Heap_Size = 0x4000;      /* 最小堆大小 - 16KB */
+_Min_Stack_Size = 0x4000;     /* 最小栈大小 - 16KB */
+
+/* 定义输出段 */
 SECTIONS
 {
-  /* The startup code goes first into FLASH */
+  /* 启动代码首先放入FLASH */
   .isr_vector :
   {
-    . = ALIGN(4);
+    . = ALIGN(4);  /* 4字节对齐 */
-    KEEP(*(.isr_vector)) /* Startup code */
+    KEEP(*(.isr_vector)) /* 保留中断向量表（启动代码） */
     . = ALIGN(4);
   } >FLASH
 
-  /* The program code and other data goes into FLASH */
+  /* 程序代码和其他数据放入FLASH */
   .text :
   {
     . = ALIGN(4);
-    *(.text)           /* .text sections (code) */
+    *(.text)           /* 所有.text段（代码） */
-    *(.text*)          /* .text* sections (code) */
+    *(.text*)          /* 所有.text*段（代码） */
-    *(.glue_7)         /* glue arm to thumb code */
+    *(.glue_7)         /* ARM和Thumb代码粘合段 */
-    *(.glue_7t)        /* glue thumb to arm code */
+    *(.glue_7t)        /* Thumb和ARM代码粘合段 */
-    *(.eh_frame)
+    *(.eh_frame)       /* 异常处理帧信息 */
 
-    KEEP (*(.init))
+    KEEP (*(.init))    /* 保留初始化代码 */
-    KEEP (*(.fini))
+    KEEP (*(.fini))    /* 保留终止化代码 */
 
     . = ALIGN(4);
-    _etext = .;        /* define a global symbols at end of code */
+    _etext = .;        /* 定义代码结束的全局符号 */
   } >FLASH
 
-  /* Constant data goes into FLASH */
+  /* 常量数据放入FLASH */
   .rodata :
   {
     . = ALIGN(4);
-    *(.rodata)         /* .rodata sections (constants, strings, etc.) */
+    *(.rodata)         /* .rodata段（常量、字符串等） */
-    *(.rodata*)        /* .rodata* sections (constants, strings, etc.) */
+    *(.rodata*)        /* .rodata*段（常量、字符串等） */
     . = ALIGN(4);
   } >FLASH
 
-  .ARM.extab (READONLY) : /* The "READONLY" keyword is only supported in GCC11 and later, remove it if using GCC10 or earlier. */
+  /* ARM异常处理表段 */
+  .ARM.extab (READONLY) : /* "READONLY"关键字仅在GCC11及以后版本支持，如果使用GCC10或更早版本请移除 */
   {
     . = ALIGN(4);
     *(.ARM.extab* .gnu.linkonce.armextab.*)
     . = ALIGN(4);
   } >FLASH
 
-  .ARM (READONLY) : /* The "READONLY" keyword is only supported in GCC11 and later, remove it if using GCC10 or earlier. */
+  /* ARM异常索引表段 */
+  .ARM (READONLY) : /* "READONLY"关键字仅在GCC11及以后版本支持，如果使用GCC10或更早版本请移除 */
   {
     . = ALIGN(4);
-    __exidx_start = .;
+    __exidx_start = .;  /* 异常索引表开始 */
     *(.ARM.exidx*)
-    __exidx_end = .;
+    __exidx_end = .;    /* 异常索引表结束 */
     . = ALIGN(4);
   } >FLASH
 
-  .preinit_array (READONLY) : /* The "READONLY" keyword is only supported in GCC11 and later, remove it if using GCC10 or earlier. */
+  /* 预初始化数组段 */
+  .preinit_array (READONLY) : /* "READONLY"关键字仅在GCC11及以后版本支持，如果使用GCC10或更早版本请移除 */
   {
     . = ALIGN(4);
     PROVIDE_HIDDEN (__preinit_array_start = .);
@@ -131,56 +120,59 @@ SECTIONS
     . = ALIGN(4);
   } >FLASH
 
-  .init_array (READONLY) : /* The "READONLY" keyword is only supported in GCC11 and later, remove it if using GCC10 or earlier. */
+  /* 初始化数组段 */
+  .init_array (READONLY) : /* "READONLY"关键字仅在GCC11及以后版本支持，如果使用GCC10或更早版本请移除 */
   {
     . = ALIGN(4);
     PROVIDE_HIDDEN (__init_array_start = .);
-    KEEP (*(SORT(.init_array.*)))
+    KEEP (*(SORT(.init_array.*)))  /* 排序的初始化数组 */
     KEEP (*(.init_array*))
     PROVIDE_HIDDEN (__init_array_end = .);
     . = ALIGN(4);
   } >FLASH
 
-  .fini_array (READONLY) : /* The "READONLY" keyword is only supported in GCC11 and later, remove it if using GCC10 or earlier. */
+  /* 终止化数组段 */
+  .fini_array (READONLY) : /* "READONLY"关键字仅在GCC11及以后版本支持，如果使用GCC10或更早版本请移除 */
   {
     . = ALIGN(4);
     PROVIDE_HIDDEN (__fini_array_start = .);
-    KEEP (*(SORT(.fini_array.*)))
+    KEEP (*(SORT(.fini_array.*)))  /* 排序的终止化数组 */
     KEEP (*(.fini_array*))
     PROVIDE_HIDDEN (__fini_array_end = .);
     . = ALIGN(4);
   } >FLASH
 
-  /* used by the startup to initialize data */
+  /* 用于启动时初始化数据的加载地址 */
   _sidata = LOADADDR(.data);
 
-  /* Initialized data sections goes into RAM, load LMA copy after code */
+  /* 已初始化数据段放入RAM，但在FLASH中保留加载镜像 */
   .data :
   {
     . = ALIGN(4);
-    _sdata = .;        /* create a global symbol at data start */
+    _sdata = .;        /* 在数据开始处创建全局符号 */
-    *(.data)           /* .data sections */
+    *(.data)           /* .data段 */
-    *(.data*)          /* .data* sections */
+    *(.data*)          /* .data*段 */
-    *(.RamFunc)        /* .RamFunc sections */
+    *(.RamFunc)        /* 在RAM中执行的函数段 */
-    *(.RamFunc*)       /* .RamFunc* sections */
+    *(.RamFunc*)       /* 在RAM中执行的函数段 */
 
     . = ALIGN(4);
-  } >DTCMRAM AT> FLASH
+    _edata = .;        /* 在数据结束处定义全局符号 */
+  } >DTCMRAM AT> FLASH  /* VMA在DTCMRAM，LMA在FLASH */
 
- /* Initialized TLS data section */
+  /* 已初始化TLS（线程局部存储）数据段 */
   .tdata : ALIGN(4)
   {
     *(.tdata .tdata.* .gnu.linkonce.td.*)
     . = ALIGN(4);
-    _edata = .;        /* define a global symbol at data end */
-    PROVIDE(__data_end = .);
     PROVIDE(__tdata_end = .);
   } >DTCMRAM AT> FLASH
 
+  /* 提供TLS相关符号供启动代码和运行时使用 */
   PROVIDE( __tdata_start = ADDR(.tdata) );
   PROVIDE( __tdata_size = __tdata_end - __tdata_start );
 
   PROVIDE( __data_start = ADDR(.data) );
+  PROVIDE( __data_end = _edata );
   PROVIDE( __data_size = __data_end - __data_start );
 
   PROVIDE( __tdata_source = LOADADDR(.tdata) );
@@ -188,23 +180,26 @@ SECTIONS
   PROVIDE( __tdata_source_size = __tdata_source_end - __tdata_source );
 
   PROVIDE( __data_source = LOADADDR(.data) );
-  PROVIDE( __data_source_end = __tdata_source_end );
+  PROVIDE( __data_source_end = LOADADDR(.data) + SIZEOF(.data) );
   PROVIDE( __data_source_size = __data_source_end - __data_source );
-  /* Uninitialized data section */
+
+  /* 未初始化的TLS BSS段 */
   .tbss (NOLOAD) : ALIGN(4)
   {
-     /* This is used by the startup in order to initialize the .bss secion */
+     /* 启动代码使用此符号来初始化.bss段 */
-    _sbss = .;         /* define a global symbol at bss start */
+    _sbss = .;         /* 在bss开始处定义全局符号 */
     __bss_start__ = _sbss;
     *(.tbss .tbss.*)
     . = ALIGN(4);
     PROVIDE( __tbss_end = . );
   } >DTCMRAM
 
+  /* 提供TLS BSS相关符号 */
   PROVIDE( __tbss_start = ADDR(.tbss) );
   PROVIDE( __tbss_size = __tbss_end - __tbss_start );
   PROVIDE( __tbss_offset = ADDR(.tbss) - ADDR(.tdata) );
 
+  /* 提供TLS基础信息 */
   PROVIDE( __tls_base = __tdata_start );
   PROVIDE( __tls_end = __tbss_end );
   PROVIDE( __tls_size = __tls_end - __tls_base );
@@ -213,41 +208,41 @@ SECTIONS
   PROVIDE( __arm32_tls_tcb_offset = MAX(8, __tls_align) );
   PROVIDE( __arm64_tls_tcb_offset = MAX(16, __tls_align) );
 
+  /* 常规BSS段（未初始化数据） */
   .bss (NOLOAD) : ALIGN(4)
   {
     *(.bss)
     *(.bss*)
-    *(COMMON)
+    *(COMMON)          /* 未初始化的全局变量 */
 
-      . = ALIGN(4);
+    . = ALIGN(4);
-    _ebss = .;         /* define a global symbol at bss end */
+    _ebss = .;         /* 在bss结束处定义全局符号 */
     __bss_end__ = _ebss;
-      PROVIDE( __bss_end = .);
+    PROVIDE( __bss_end = .);
   } >DTCMRAM
+
   PROVIDE( __non_tls_bss_start = ADDR(.bss) );
 
-  PROVIDE( __bss_start = __tbss_start );
+  /* 提供完整的BSS信息（包含TLS和非TLS） */
+  PROVIDE( __bss_start = _sbss );
   PROVIDE( __bss_size = __bss_end - __bss_start );
 
-  /* User_heap_stack section, used to check that there is enough RAM left */
+  /* 用户堆栈段，用于检查剩余RAM是否足够 */
   ._user_heap_stack (NOLOAD) :
   {
     . = ALIGN(8);
-    PROVIDE ( end = . );
+    PROVIDE ( end = . );      /* 堆起始位置 */
     PROVIDE ( _end = . );
-    . = . + _Min_Heap_Size;
+    . = . + _Min_Heap_Size;   /* 分配堆空间 */
-    . = . + _Min_Stack_Size;
+    . = . + _Min_Stack_Size;  /* 分配栈空间 */
     . = ALIGN(8);
   } >DTCMRAM
 
-
+  /* 从标准库中移除调试信息 */
-
-  /* Remove information from the standard libraries */
   /DISCARD/ :
   {
-    libc.a:* ( * )
+    libc.a:* ( * )    /* 丢弃C库的调试信息 */
-    libm.a:* ( * )
+    libm.a:* ( * )    /* 丢弃数学库的调试信息 */
-    libgcc.a:* ( * )
+    libgcc.a:* ( * )  /* 丢弃GCC库的调试信息 */
   }
-
+}
-}