环境

芯片

STM32L475VETx

处理器：Cortex-M4F
架构：ARMv7E-M

这里我们需要清楚其相关资源（在后续步骤中会使用到）：

SRAM1
大小是 96 KB（0x0001 8000），起始地址是 0x2000 0000。
SRAM2
大小是 32 KB（0x0000 8000），起始地址是 0x1000 0000。
可以在 Standby 模式下保留数据。
Flash
大小是 512 KB（0x0008 0000），起始地址是 0x0800 0000。

开发板

正点原子 Pandora IOT 开发板。

板载有三色 LED，我们可以用它进行测试（低电平有效）：

Red：PE7
Green：PE8
Blue：PE9

依赖组件

CMSIS

CMSIS（Common Microcontroller Software Interface Standard，通用微控制器软件接口标准），是 ARM 公司主导制定的一套开源软件标准。

当前最新的版本是 CMSIS_6，这里我们需要的文件如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
.
└── CMSIS
    └── Core
        └── Include
            ├── m-profile
            │   ├── armv7m_mpu.h
            │   ├── cmsis_armclang_m.h
            │   └── cmsis_gcc_m.h
            ├── cmsis_armclang.h
            ├── cmsis_compiler.h
            ├── cmsis_gcc.h
            ├── cmsis_version.h
            └── core_cm4.h

如果是 Cortex-M7 架构，m-profile 目录里面还需要 armv7m_cachel1.h 这个头文件。

注意：

CMSIS_5 版本的启动文件是汇编文件，CMSIS_6 版本的启动文件是 C 文件。
其参考模板的目录路径为：CMSIS/Core/Template/Device_M/Source。
1 2 3
Source ├── startup_Device.c # 启动文件 └── system_Device.c
对于编译器 AC6 和 GCC，CMSIS 也提供有链接脚本的参考模板。
其参考模板的路径为：CMSIS/Core/Template/Device_M/Config，后缀名分别为 .sct 和 .ld。

cmsis-device-l4

cmsis-device-l4 是 ST 为 STM32L4 系列提供的 CMSIS 设备组件。

这里我们需要的文件如下：

1
2
3
4
5
6
7
8
.
├── Include
│   ├── stm32l4xx.h
│   ├── stm32l475xx.h
│   └── system_stm32l4xx.h
└── Source
    └── Templates
        └── system_stm32l4xx.c

注意：

该仓库针对不同的编译器，提供有使用汇编编写的启动文件，其目录路径为：Source/Templates。

stm32l4xx-hal-driver

stm32l4xx-hal-driver 是 ST 为 STM32L4 系列提供的 HAL 库，方便开发外设。

这里我们需要的文件如下：

1
2
3
.
├── Inc  # 除了后缀为 _template.h, 其他文件都需要
└── Src  # 除了后缀为 _template.c, 其他文件都需要

注意：

该仓库提供有个一个配置文件的模板 Inc/stm32l4xx_hal_conf_template.h，通过配置文件可以按需开启不同的外设模块。
我们需要参考该配置文件，提供一个配置头文件。
该仓库提供有一个初始化文件的模板 Src/stm32l4xx_hal_msp_template.c。
我们需要参考该初始化文件，提供一个初始化文件。
该仓库在编译过程中，需要我们定义下面这两个宏：
- USE_HAL_DRIVER。
- STM32L475xx。

适配

当前的目录结构如下所示：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
.
├── cmsis
│   ├── cmsis_armclang.h
│   ├── cmsis_compiler.h
│   ├── cmsis_gcc.h
│   ├── cmsis_version.h
│   ├── core_cm4.h
│   └── m-profile
│       ├── armv7m_mpu.h
│       ├── cmsis_armclang_m.h
│       └── cmsis_gcc_m.h
├── cmsis-device-l4
│   ├── include
│   │   ├── stm32l475xx.h
│   │   ├── stm32l4xx.h
│   │   └── system_stm32l4xx.h
│   └── source
│       └── system_stm32l4xx.c
└── stm32l4xx-hal-driver
    ├── include
    │   ├── Legacy
    │   ├── ...
    │   ├── stm32l4xx_hal_conf.h
    │   └── ...
    └── source
        ├── Legacy
        ├── ...
        ├── stm32l4xx_hal_msp.c
        └── ...

添加内存信息的头文件

创建一个名为 region.h 的头文件：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
/**
 * region.h
 *
 * SPDX-License-Identifier: Apache-2.0
 * SPDX-FileCopyrightText: 2026 Zeepunt
 */
#ifndef __REGION_H__
#define __REGION_H__

#define __IROM_BASE    0x08000000
#define __IROM_SIZE    0x00080000

#define __RAM1_BASE    0x20000000
#define __RAM1_SIZE    0x00018000
#define __RAM1_END     (__RAM1_BASE + __RAM1_SIZE)

/* 栈提供给中断服务函数使用 (MSP), 4 KB */
#define __STACK_SIZE   0x1000

/* 堆提供给内存分配使用 (malloc), 48 KB */
#define __HEAP_SIZE    0xC000

#endif /* __REGION_H__ */

添加启动文件

创建一个名为 startup.c 的启动文件：

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
/**
 * startup.c
 *
 * SPDX-License-Identifier: Apache-2.0
 * SPDX-FileCopyrightText: 2026 Zeepunt
 */
#include <stdint.h>

#include "stm32l475xx.h"

typedef void (*VECTOR_TABLE_Type)(void);

/* 定义在 cmsis_armclang_m.h 或 cmsis_gcc_m.h 头文件中 */
extern uint32_t __INITIAL_SP;
extern __NO_RETURN void __PROGRAM_START(void);

__NO_RETURN void Reset_Handler(void);
void Default_Handler(void);

/* 弱声明, 默认中断处理函数都是 Default_Handler */
void NMI_Handler            (void) __attribute__ ((weak, alias("Default_Handler")));
void HardFault_Handler      (void) __attribute__ ((weak, alias("Default_Handler")));
void MemManage_Handler      (void) __attribute__ ((weak, alias("Default_Handler")));
void BusFault_Handler       (void) __attribute__ ((weak, alias("Default_Handler")));
void UsageFault_Handler     (void) __attribute__ ((weak, alias("Default_Handler")));
void SVC_Handler            (void) __attribute__ ((weak, alias("Default_Handler")));
void DebugMon_Handler       (void) __attribute__ ((weak, alias("Default_Handler")));
void PendSV_Handler         (void) __attribute__ ((weak, alias("Default_Handler")));
void SysTick_Handler        (void) __attribute__ ((weak, alias("Default_Handler")));

void WWDG_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void PVD_PVM_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void TAMP_STAMP_IRQHandler              (void) __attribute__ ((weak, alias("Default_Handler")));
void RTC_WKUP_IRQHandler                (void) __attribute__ ((weak, alias("Default_Handler")));
void FLASH_IRQHandler                   (void) __attribute__ ((weak, alias("Default_Handler")));
void RCC_IRQHandler                     (void) __attribute__ ((weak, alias("Default_Handler")));
void EXTI0_IRQHandler                   (void) __attribute__ ((weak, alias("Default_Handler")));
void EXTI1_IRQHandler                   (void) __attribute__ ((weak, alias("Default_Handler")));
void EXTI2_IRQHandler                   (void) __attribute__ ((weak, alias("Default_Handler")));
void EXTI3_IRQHandler                   (void) __attribute__ ((weak, alias("Default_Handler")));
void EXTI4_IRQHandler                   (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA1_Channel1_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA1_Channel2_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA1_Channel3_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA1_Channel4_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA1_Channel5_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA1_Channel6_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA1_Channel7_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void ADC1_2_IRQHandler                  (void) __attribute__ ((weak, alias("Default_Handler")));
void CAN1_TX_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void CAN1_RX0_IRQHandler                (void) __attribute__ ((weak, alias("Default_Handler")));
void CAN1_RX1_IRQHandler                (void) __attribute__ ((weak, alias("Default_Handler")));
void CAN1_SCE_IRQHandler                (void) __attribute__ ((weak, alias("Default_Handler")));
void EXTI9_5_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM1_BRK_TIM15_IRQHandler          (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM1_UP_TIM16_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM1_TRG_COM_TIM17_IRQHandler      (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM1_CC_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM2_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM3_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM4_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void I2C1_EV_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void I2C1_ER_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void I2C2_EV_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void I2C2_ER_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void SPI1_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void SPI2_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void USART1_IRQHandler                  (void) __attribute__ ((weak, alias("Default_Handler")));
void USART2_IRQHandler                  (void) __attribute__ ((weak, alias("Default_Handler")));
void USART3_IRQHandler                  (void) __attribute__ ((weak, alias("Default_Handler")));
void EXTI15_10_IRQHandler               (void) __attribute__ ((weak, alias("Default_Handler")));
void RTC_Alarm_IRQHandler               (void) __attribute__ ((weak, alias("Default_Handler")));
void DFSDM1_FLT3_IRQHandler             (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM8_BRK_IRQHandler                (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM8_UP_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM8_TRG_COM_IRQHandler            (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM8_CC_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void ADC3_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void FMC_IRQHandler                     (void) __attribute__ ((weak, alias("Default_Handler")));
void SDMMC1_IRQHandler                  (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM5_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void SPI3_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void UART4_IRQHandler                   (void) __attribute__ ((weak, alias("Default_Handler")));
void UART5_IRQHandler                   (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM6_DAC_IRQHandler                (void) __attribute__ ((weak, alias("Default_Handler")));
void TIM7_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA2_Channel1_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA2_Channel2_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA2_Channel3_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA2_Channel4_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA2_Channel5_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void DFSDM1_FLT0_IRQHandler             (void) __attribute__ ((weak, alias("Default_Handler")));
void DFSDM1_FLT1_IRQHandler             (void) __attribute__ ((weak, alias("Default_Handler")));
void DFSDM1_FLT2_IRQHandler             (void) __attribute__ ((weak, alias("Default_Handler")));
void COMP_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void LPTIM1_IRQHandler                  (void) __attribute__ ((weak, alias("Default_Handler")));
void LPTIM2_IRQHandler                  (void) __attribute__ ((weak, alias("Default_Handler")));
void OTG_FS_IRQHandler                  (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA2_Channel6_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void DMA2_Channel7_IRQHandler           (void) __attribute__ ((weak, alias("Default_Handler")));
void LPUART1_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void QUADSPI_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void I2C3_EV_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void I2C3_ER_IRQHandler                 (void) __attribute__ ((weak, alias("Default_Handler")));
void SAI1_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void SAI2_IRQHandler                    (void) __attribute__ ((weak, alias("Default_Handler")));
void SWPMI1_IRQHandler                  (void) __attribute__ ((weak, alias("Default_Handler")));
void TSC_IRQHandler                     (void) __attribute__ ((weak, alias("Default_Handler")));
void RNG_IRQHandler                     (void) __attribute__ ((weak, alias("Default_Handler")));
void FPU_IRQHandler                     (void) __attribute__ ((weak, alias("Default_Handler")));

/* 中断向量表 */
const VECTOR_TABLE_Type __VECTOR_TABLE[] __VECTOR_TABLE_ATTRIBUTE = {
    (VECTOR_TABLE_Type)(&__INITIAL_SP),       /* Initial Stack Pointer */
    Reset_Handler,                            /* Reset Handler */
    NMI_Handler,                              /* NMI Handler           (-14) */
    HardFault_Handler,                        /* Hard Fault Handler    (-13) */
    MemManage_Handler,                        /* MPU Fault Handler     (-12) */
    BusFault_Handler,                         /* Bus Fault Handler     (-11) */
    UsageFault_Handler,                       /* Usage Fault Handler   (-10) */
    0,                                        /* Reserved */
    0,                                        /* Reserved */
    0,                                        /* Reserved */
    0,                                        /* Reserved */
    SVC_Handler,                              /* SVC Handler           (-5) */
    DebugMon_Handler,                         /* Debug Monitor Handler (-4) */
    0,                                        /* Reserved */
    PendSV_Handler,                           /* PendSV Handler        (-2) */
    SysTick_Handler,                          /* SysTick Handler       (-1) */

    /* 外部中断 */
    WWDG_IRQHandler,                          /* Window WatchDog */
    PVD_PVM_IRQHandler,                       /* PVD/PVM1/PVM2/PVM3/PVM4 through EXTI Line detection */
    TAMP_STAMP_IRQHandler,                    /* Tamper and TimeStamps through the EXTI line */
    RTC_WKUP_IRQHandler,                      /* RTC Wakeup through the EXTI line */
    FLASH_IRQHandler,                         /* FLASH */
    RCC_IRQHandler,                           /* RCC */
    EXTI0_IRQHandler,                         /* EXTI Line0 */
    EXTI1_IRQHandler,                         /* EXTI Line1 */
    EXTI2_IRQHandler,                         /* EXTI Line2 */
    EXTI3_IRQHandler,                         /* EXTI Line3 */
    EXTI4_IRQHandler,                         /* EXTI Line4 */
    DMA1_Channel1_IRQHandler,                 /* DMA1 Channel 1 */
    DMA1_Channel2_IRQHandler,                 /* DMA1 Channel 2 */
    DMA1_Channel3_IRQHandler,                 /* DMA1 Channel 3 */
    DMA1_Channel4_IRQHandler,                 /* DMA1 Channel 4 */
    DMA1_Channel5_IRQHandler,                 /* DMA1 Channel 5 */
    DMA1_Channel6_IRQHandler,                 /* DMA1 Channel 6 */
    DMA1_Channel7_IRQHandler,                 /* DMA1 Channel 7 */
    ADC1_2_IRQHandler,                        /* ADC1, ADC2 */
    CAN1_TX_IRQHandler,                       /* CAN1 TX */
    CAN1_RX0_IRQHandler,                      /* CAN1 RX0 */
    CAN1_RX1_IRQHandler,                      /* CAN1 RX1 */
    CAN1_SCE_IRQHandler,                      /* CAN1 SCE */
    EXTI9_5_IRQHandler,                       /* External Line[9:5]s */
    TIM1_BRK_TIM15_IRQHandler,                /* TIM1 Break and TIM15 */
    TIM1_UP_TIM16_IRQHandler,                 /* TIM1 Update and TIM16 */
    TIM1_TRG_COM_TIM17_IRQHandler,            /* TIM1 Trigger and Commutation and TIM17 */
    TIM1_CC_IRQHandler,                       /* TIM1 Capture Compare */
    TIM2_IRQHandler,                          /* TIM2 */
    TIM3_IRQHandler,                          /* TIM3 */
    TIM4_IRQHandler,                          /* TIM4 */
    I2C1_EV_IRQHandler,                       /* I2C1 Event */
    I2C1_ER_IRQHandler,                       /* I2C1 Error */
    I2C2_EV_IRQHandler,                       /* I2C2 Event */
    I2C2_ER_IRQHandler,                       /* I2C2 Error */
    SPI1_IRQHandler,                          /* SPI1 */
    SPI2_IRQHandler,                          /* SPI2 */
    USART1_IRQHandler,                        /* USART1 */
    USART2_IRQHandler,                        /* USART2 */
    USART3_IRQHandler,                        /* USART3 */
    EXTI15_10_IRQHandler,                     /* External Line[15:10] */
    RTC_Alarm_IRQHandler,                     /* RTC Alarm (A and B) through EXTI Line */
    DFSDM1_FLT3_IRQHandler,                   /* DFSDM1 Filter 3 global Interrupt */
    TIM8_BRK_IRQHandler,                      /* TIM8 Break Interrupt */
    TIM8_UP_IRQHandler,                       /* TIM8 Update Interrupt */
    TIM8_TRG_COM_IRQHandler,                  /* TIM8 Trigger and Commutation Interrupt */
    TIM8_CC_IRQHandler,                       /* TIM8 Capture Compare Interrupt */
    ADC3_IRQHandler,                          /* ADC3 global Interrupt */
    FMC_IRQHandler,                           /* FMC */
    SDMMC1_IRQHandler,                        /* SDMMC1 */
    TIM5_IRQHandler,                          /* TIM5 */
    SPI3_IRQHandler,                          /* SPI3 */
    UART4_IRQHandler,                         /* UART4 */
    UART5_IRQHandler,                         /* UART5 */
    TIM6_DAC_IRQHandler,                      /* TIM6 and DAC1&2 underrun errors */
    TIM7_IRQHandler,                          /* TIM7 */
    DMA2_Channel1_IRQHandler,                 /* DMA2 Channel 1 */
    DMA2_Channel2_IRQHandler,                 /* DMA2 Channel 2 */
    DMA2_Channel3_IRQHandler,                 /* DMA2 Channel 3 */
    DMA2_Channel4_IRQHandler,                 /* DMA2 Channel 4 */
    DMA2_Channel5_IRQHandler,                 /* DMA2 Channel 5 */
    DFSDM1_FLT0_IRQHandler,                   /* DFSDM1 Filter 0 global Interrupt */
    DFSDM1_FLT1_IRQHandler,                   /* DFSDM1 Filter 1 global Interrupt */
    DFSDM1_FLT2_IRQHandler,                   /* DFSDM1 Filter 2 global Interrupt */
    COMP_IRQHandler,                          /* COMP Interrupt */
    LPTIM1_IRQHandler,                        /* LP TIM1 interrupt */
    LPTIM2_IRQHandler,                        /* LP TIM2 interrupt */
    OTG_FS_IRQHandler,                        /* USB OTG FS */
    DMA2_Channel6_IRQHandler,                 /* DMA2 Channel 6 */
    DMA2_Channel7_IRQHandler,                 /* DMA2 Channel 7 */
    LPUART1_IRQHandler,                       /* LP UART1 interrupt */
    QUADSPI_IRQHandler,                       /* Quad SPI global interrupt */
    I2C3_EV_IRQHandler,                       /* I2C3 event */
    I2C3_ER_IRQHandler,                       /* I2C3 error */
    SAI1_IRQHandler,                          /* Serial Audio Interface 1 global interrupt */
    SAI2_IRQHandler,                          /* Serial Audio Interface 2 global interrupt */
    SWPMI1_IRQHandler,                        /* Serial Wire Interface 1 global interrupt */
    TSC_IRQHandler,                           /* Touch Sense Controller global interrupt */
    0,                                        /* Reserved */
    0,                                        /* Reserved */
    RNG_IRQHandler,                           /* RNG global interrupt */
    FPU_IRQHandler,                           /* FPU */
};

__NO_RETURN void Reset_Handler(void)
{
    SystemInit();

    /* Enter PreMain (C library entry point) */
    __PROGRAM_START();
}

void Default_Handler(void)
{
    while(1);
}

添加链接脚本

针对不同的编译器，链接脚本也不一样。

armclang 编译器

链接脚本的后缀名是 .sct，这里我们创建一个需要预处理的链接脚本 link.sct.in。

因为我们的链接脚本需要使用宏定义，所以需要预处理后才能得到真正的链接脚本。
预处理的命令为：armclang --target=arm-arm-none-eabi -mcpu=cortex-m4 -E -P -x c -I. link.sct.in -o link.sct。
其中 -I. 表示 region.h 这个头文件位于当前目录。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
#include "region.h"

LR_IROM __IROM_BASE __IROM_SIZE
{
    ER_IROM __IROM_BASE __IROM_SIZE {
        *.o (RESET, +First)

        *(InRoot$$Sections)

        .ANY (+RO)
    }

    RW_IRAM1 __RAM1_BASE (__RAM1_SIZE - __HEAP_SIZE - __STACK_SIZE)  {
        .ANY (+RW +ZI)
    }

#if __HEAP_SIZE > 0
    ARM_LIB_HEAP AlignExpr(+0, 8) EMPTY __HEAP_SIZE
    {
    }
#endif

#if __STACK_SIZE > 0
    ARM_LIB_STACK __RAM1_END EMPTY -__STACK_SIZE
    {
    }
#endif
}

gcc 编译器

链接脚本的后缀名是 .ld，这里我们创建一个需要预处理的链接脚本 link.ld.in。

因为我们的链接脚本需要使用宏定义，所以需要预处理后才能得到真正的链接脚本。
预处理的命令为：gcc -E -P -x c -I. link.ld.in -o link.ld。
其中 -I. 表示 region.h 这个头文件位于当前目录。

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
#include "region.h"

MEMORY
{
    FLASH (rx)  : ORIGIN = __IROM_BASE, LENGTH = __IROM_SIZE
    RAM   (xrw) : ORIGIN = __RAM1_BASE, LENGTH = __RAM1_SIZE
}

ENTRY(Reset_Handler)

SECTIONS
{
    .text :
    {
        KEEP(*(.vectors))

        *(.text*)

        KEEP (*(.init))
        KEEP (*(.fini))

        /* .ctors */
        *crtbegin.o(.ctors)
        *crtbegin?.o(.ctors)
        *(EXCLUDE_FILE(*crtend?.o *crtend.o) .ctors)
        *(SORT(.ctors.*))
        *(.ctors)

        /* .dtors */
        *crtbegin.o(.dtors)
        *crtbegin?.o(.dtors)
        *(EXCLUDE_FILE(*crtend?.o *crtend.o) .dtors)
        *(SORT(.dtors.*))
        *(.dtors)

        *(.rodata*)

        KEEP(*(.eh_frame*))
    } >FLASH

    .ARM.extab : { 
        *(.ARM.extab* .gnu.linkonce.armextab.*)
    } >FLASH

    .ARM.exidx : {
        __exidx_start = .;

        *(.ARM.exidx* .gnu.linkonce.armexidx.*)

        __exidx_end = .;
    } > FLASH

    .copy.table :
    {
        . = ALIGN(4);

        __copy_table_start__ = .;

        LONG (LOADADDR(.data))
        LONG (ADDR(.data))
        LONG (SIZEOF(.data) / 4)

        __copy_table_end__ = .;
    } > FLASH

    .zero.table :
    {
        . = ALIGN(4);

        __zero_table_start__ = .;
        __zero_table_end__ = .;
    } > FLASH

    PROVIDE(__etext = LOADADDR(.data));

    .data : ALIGN(4)
    {
        __data_start__ = .;

        *(vtable)
        *(.data)
        *(.data.*)

        . = ALIGN(4);

        PROVIDE_HIDDEN (__preinit_array_start = .);
        KEEP(*(.preinit_array))
        PROVIDE_HIDDEN (__preinit_array_end = .);

        . = ALIGN(4);

        PROVIDE_HIDDEN (__init_array_start = .);
        KEEP(*(SORT(.init_array.*)))
        KEEP(*(.init_array))
        PROVIDE_HIDDEN (__init_array_end = .);

        . = ALIGN(4);

        PROVIDE_HIDDEN (__fini_array_start = .);
        KEEP(*(SORT(.fini_array.*)))
        KEEP(*(.fini_array))
        PROVIDE_HIDDEN (__fini_array_end = .);

        . = ALIGN(4);

        __data_end__ = .;
    } > RAM AT > FLASH

    .bss :
    {
        . = ALIGN(4);

        __bss_start__ = .;

        *(.bss)
        *(.bss.*)
        *(COMMON)

        . = ALIGN(4);

        __bss_end__ = .;
    } > RAM AT > RAM

    .heap (NOLOAD) :
    {
        . = ALIGN(8);

        __end__ = .;
        PROVIDE(end = .);

        . += __HEAP_SIZE;

        . = ALIGN(8);

        __HeapLimit = .;
    } > RAM

    .stack (ORIGIN(RAM) + LENGTH(RAM) - __STACK_SIZE) (NOLOAD) :
    {
        . = ALIGN(8);

        __StackLimit = .;

        . += __STACK_SIZE;

        . = ALIGN(8);

        __StackTop = .;
    } > RAM

    PROVIDE(__stack = __StackTop);

    ASSERT(__StackLimit >= __HeapLimit, "region RAM overflowed with stack")
}

测试

创建一个 main.c 文件：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
/**
 * main.c
 *
 * SPDX-License-Identifier: Apache-2.0
 * SPDX-FileCopyrightText: 2026 Zeepunt
 */
#include "stm32l4xx.h"

void SysTick_Handler(void)
{
    HAL_IncTick();
}

int main(int argc, char *argv[])
{
    HAL_Init();

    __HAL_RCC_GPIOE_CLK_ENABLE();

    GPIO_InitTypeDef gpio_init = {0};
    gpio_init.Pin = GPIO_PIN_7 | GPIO_PIN_8 | GPIO_PIN_9;
    gpio_init.Mode = GPIO_MODE_OUTPUT_PP;
    gpio_init.Pull = GPIO_NOPULL;
    gpio_init.Speed = GPIO_SPEED_FREQ_HIGH;

    HAL_GPIO_WritePin(GPIOE, GPIO_PIN_7 | GPIO_PIN_8 | GPIO_PIN_9, GPIO_PIN_SET);
    HAL_GPIO_Init(GPIOE, &gpio_init);

    while (1) {
        HAL_GPIO_TogglePin(GPIOE, GPIO_PIN_7);
        HAL_Delay(200);

        HAL_GPIO_TogglePin(GPIOE, GPIO_PIN_8);
        HAL_Delay(200);

        HAL_GPIO_TogglePin(GPIOE, GPIO_PIN_9);
        HAL_Delay(200);
    }

    return 0;
}

Keil

Keil 使用的是 armclang 编译器。

新建一个名为 stm32 的 Keil 工程（后缀名为 .uvprojx），具体配置过程省略。

如果第一次编译失败，应该是链接脚本预处理问题，再编译一次就行了。

一些关键的部分：

Arm 编译器版本 6 对应 armclang 编译器。
编译前需要对链接脚本进行预处理。
添加编译时的宏定义，以及头文件路径。
选择链接脚本。
添加的源代码。
其中 HAL 库的文件太多了，这里就不展开了。

Makefile

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
#
# Makefile
#
# SPDX-License-Identifier: Apache-2.0
# SPDX-FileCopyrightText: 2026 Zeepunt

Q := @

ifeq ($(V),1)
	quiet =
	cmd = $(cmd_$(1))
else
	quiet = quiet_
	cmd = $(Q)$(if $(quiet_cmd_$(1)),echo '  $(quiet_cmd_$(1))' &&) $(cmd_$(1))
endif

BUILD_DIR := build

TARGET    := main

CC_PREFIX := arm-none-eabi-
AS        := $(CC_PREFIX)as
CC        := $(CC_PREFIX)gcc
LD        := $(CC_PREFIX)ld
NM        := $(CC_PREFIX)nm
AR        := $(CC_PREFIX)ar
OBJCOPY   := $(CC_PREFIX)objcopy
OBJDUMP   := $(CC_PREFIX)objdump
SIZE      := $(CC_PREFIX)size
STRIP     := $(CC_PREFIX)strip

LD_SCRIPT_IN := link.ld.in
LD_SCRIPT    := $(BUILD_DIR)/link.ld

ELF := $(BUILD_DIR)/$(TARGET).elf
BIN := $(BUILD_DIR)/$(TARGET).bin
MAP := $(BUILD_DIR)/$(TARGET).map

CPU := 	\
	-mcpu=cortex-m4 \
	-mthumb \
	-mfpu=fpv4-sp-d16 \
	-mfloat-abi=hard

CFLAGS := \
	$(CPU) \
	-std=c11

CFLAGS += \
	-fdata-sections \
	-ffunction-sections

CFLAGS += \
	-DUSE_HAL_DRIVER \
	-DSTM32L475xx

LDFLAGS := \
	$(CPU) \
	-T$(LD_SCRIPT) \
	--specs=nano.specs \
	--specs=nosys.specs \
	-Wl,--gc-sections \
	-Wl,-Map=$(MAP) \
	-Wl,--print-memory-usage

LDLIBS :=

INCLUDES := \
	-Icmsis \
	-Icmsis/m-profile \
	-Icmsis-device-l4/include \
	-Istm32l4xx-hal-driver/include \
	-Istm32l4xx-hal-driver/include/Legacy \
	-I.

SOURCES := \
	cmsis-device-l4/source/system_stm32l4xx.c \
	stm32l4xx-hal-driver/source/stm32l4xx_hal.c \
	stm32l4xx-hal-driver/source/stm32l4xx_hal_cortex.c \
	stm32l4xx-hal-driver/source/stm32l4xx_hal_flash.c \
	stm32l4xx-hal-driver/source/stm32l4xx_hal_flash_ex.c \
	stm32l4xx-hal-driver/source/stm32l4xx_hal_flash_ramfunc.c \
	stm32l4xx-hal-driver/source/stm32l4xx_hal_gpio.c \
	stm32l4xx-hal-driver/source/stm32l4xx_hal_pwr.c \
	stm32l4xx-hal-driver/source/stm32l4xx_hal_pwr_ex.c \
	stm32l4xx-hal-driver/source/stm32l4xx_hal_rcc.c \
	stm32l4xx-hal-driver/source/stm32l4xx_hal_rcc_ex.c \
	startup.c \
	main.c

OBJS := $(patsubst %.c,$(BUILD_DIR)/%.o,$(SOURCES))

quiet_cmd_cc = CC      $<
cmd_cc       = $(CC) $(CFLAGS) $(INCLUDES) -c -o $@ $<

quiet_cmd_ld = LD      $(TARGET)
cmd_ld       = $(CC) $(LDFLAGS) -o $@ $(OBJS) $(LDLIBS)

quiet_cmd_bin = OBJCOPY $(BIN)
cmd_bin       = $(OBJCOPY) -O binary $< $@

quiet_cmd_size = SIZE    $(TARGET)
cmd_size       = $(SIZE) $@

PHONY :=
PHONY += all
all: $(ELF) $(BIN)

$(LD_SCRIPT): $(LD_SCRIPT_IN) | $(BUILD_DIR)
	$(Q)$(CC) -E -P -x c -I. $(LD_SCRIPT_IN) -o $@

$(ELF): $(OBJS) $(LD_SCRIPT)
	$(call cmd,ld)

$(BIN): $(ELF)
	$(call cmd,bin)

$(BUILD_DIR)/%.o: %.c | $(BUILD_DIR)
	$(Q)mkdir -p $(dir $@)
	$(call cmd,cc)

$(BUILD_DIR):
	$(Q)mkdir -p $(BUILD_DIR)

PHONY += clean
clean:
	$(Q)rm -rf $(BUILD_DIR)

PHONY += run
run: $(BINARY)
	$(Q)$(BINARY)

PHONY += size
size: $(ELF)
	$(SIZE) $(ELF)

.PHONY: $(PHONY)

注意：

可以使用 STM32CubeProgrammer 软件将生成的 bin 文件烧录到开发板。

参考

参考工程

环境#

芯片#

开发板#

依赖组件#

CMSIS#

cmsis-device-l4#

stm32l4xx-hal-driver#

适配#

添加内存信息的头文件#

添加启动文件#

添加链接脚本#

测试#

Keil#

Makefile#

参考#

环境

芯片

开发板