;******************** (C) COPYRIGHT 2009 STMicroelectronics ********************;* File Name : startup_stm32f10x_cl.s
;* Author : MCD Application Team
;* Version : V3.1.0
;* Date : 06/19/2009
;* Description : STM32F10x Connectivity line devices vector table for RVMDK
;* toolchain.
;* This module performs:
;* - Set the initial SP
;* - Set the initial PC == Reset_Handler
;* - Set the vector table entries with the exceptions ISR address
;* - Branches to __main in the C library (which eventually
;* calls main()).
;* After Reset the CortexM3 processor is in Thread mode,
;* priority is Privileged, and the Stack is set to Main.
;* <<< Use Configuration Wizard in Context Menu >>>
;*******************************************************************************
; THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
; WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE TIME.
; AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY DIRECT,
; INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING FROM THE
; CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE CODING
; INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
;*******************************************************************************
; Amount of memory (in bytes) allocated for Stack
; Tailor this value to your application needs
; <h> Stack Configuration
; <o> Stack Size (in Bytes) <0x0-0xFFFFFFFF:8>
; </h>
; 首先對棧和堆的大小進行定義，並在代碼區的起始處建立中斷向量表，其第一個表項是棧
; 頂地址，第二個表項是復位中斷服務入口地址。然後在復位中斷服務程序中跳轉C/C++標
; 準實時庫的__main函數。假設STM32被設置爲從內部FLASH啓動中斷向量表起始地位爲0x8000000，
; 則棧頂地址存放於0x8000000處，而復位中斷服務入口地址存放於0x8000004處。當STM32遇
; 到復位信號後，則從0x80000004處取出復位中斷服務入口地址繼而執行復位中斷服務程序，
; 然後跳轉__main函數，最後來到C的世界。
; DCD指令：作用是開闢一段空間，其意義等價於C語言中的地址符“&”。開始建立的中斷向量
; 表則類似於使用C語.其每一個成員都是一個函數指針，分別指向各個中斷服務函數
;僞指令AREA，表示開闢一段大小爲Stack_Size的內存空間作爲棧，段名是STACK，可讀可寫。
;NOINIT：指定此數據段僅僅保留了內存單元，而沒有將各初始值寫入內存單元，或者將各個內存單元值初始化爲0
;常見的數據定義僞指令有如下幾種：
;— DCB 用於分配一片連續的字節存儲單元並用指定的數據初始化。
;— DCW （DCWU） 用於分配一片連續的半字存儲單元並用指定的數據初始化。
;— DCD （DCDU） 用於分配一片連續的字存儲單元並用指定的數據初始化。
;— DCFD （DCFDU）用於爲雙精度的浮點數分配一片連續的字存儲單元並用指 定的數據初始化。
;— DCFS DCFSU） 用於爲單精度的浮點數分配一片連續的字存儲單元並用指 定的數據初始化。
;— DCQ DCQU） 用於分配一片以 8 字節爲單位的連續的存儲單元並用指定 的數據初始化。
;— SPACE 用於分配一片連續的存儲單元
;— MAP 用於定義一個結構化的內存表首地址
;— FIELD 用於定義一個結構化的內存表的數據域
;EXPORT僞指令用於在程序中聲明一個全局的標號，該標號可在其他的文件中引用。EXPORT可用GLOBAL代替。標號在程序中區分大小寫，[WEAK]選項聲明其他的同名標號優先於該標號被引用。
;;啓動代碼作用一般是：
;;1）堆和棧的初始化；
;2）向量表定義；
;;3）地址重映射及中斷向量表的轉移；
;;4）設置系統時鐘頻率；
;;5）中斷寄存器的初始化；
;;6）進入C應用程序。
;1）堆和棧的初始化
Stack_Size EQU 0x00000400 ;棧區（stack）— 由編譯器自動分配釋放 ，存放函數的參數值，局部變量的值等。其操作方式類似於數據結構中的棧
;SPACE用來分配一片連續的存儲區域並初始化爲0.
AREA STACK, NOINIT, READWRITE, ALIGN=3 ;AREA 僞指令用於定義一個代碼段或數據,；定義棧，可初始爲0，8字節對齊2*2*2,2的3次方
;NOINIT：指定此數據段僅僅保留了內存單元，
;READWRITE屬性：指定本段爲可讀可寫，數據段的默認屬性爲READWRITE。
;STACK 段名
;ALIGN屬性：使用方式爲ALIGN 表達式。在默認時，ELF（可執行連接文件）的代碼段和數據段是按字對齊的，表達式的取值範圍爲0～31，相應的對齊方式爲2表達式次方。
Stack_Mem SPACE Stack_Size ;；分配0x400個連續字節，並初始化爲0
__initial_sp ;標號__initial_sp，表示棧空間頂地址。 ；彙編代碼地址標號
; <h> Heap Configuration
; <o> Heap Size (in Bytes) <0x0-0xFFFFFFFF:8>
; </h>
Heap_Size EQU 0x00000200 ;堆區（heap） — 一般由程序員分配釋放， 若程序員不釋放，程序結束時可能由OS回收 。注意它與數據結構中的堆是兩回事，分配方式倒是類似於鏈表
AREA HEAP, NOINIT, READWRITE, ALIGN=3 ;ALIGN用來指定對齊方式， 8字節對齊
__heap_base ;表示堆空間起始地址
Heap_Mem SPACE Heap_Size
__heap_limit ;表示堆空間結束地址
PRESERVE8 ;PRESERVE8 指令指定當前文件保持堆棧八字節對齊
THUMB ; 告訴彙編器下面是32位的Thumb指令，如果需要彙編器將插入位以保證對齊
;2)中斷向量表定義
; Vector Table Mapped to Address 0 at Reset ;實際上是在CODE區（假設STM32從FLASH啓動，則此中斷向量表起始地址即爲0x8000000）
AREA RESET, DATA, READONLY ;定義一塊數據段，只可讀，段名字是RESET
;DATA屬性：用於定義數據段，默認爲READWRITE。指定本段爲可讀可寫
EXPORT __Vectors ;EXPORT：在程序中聲明一個全局的標號__Vectors，該標號可在其他的文件中引用
EXPORT __Vectors_End ;在程序中聲明一個全局的標號__Vectors_End
EXPORT __Vectors_Size ;在程序中聲明一個全局的標號__Vectors_Size
__Vectors DCD __initial_sp ; Top of Stack 第一個表項是棧頂地址
;該處物理地址值即爲 __Vetors 標號所表示的值，
;該地址中存儲__initial_sp所表示的地址值，
;大小爲一個字（32bit）
DCD Reset_Handler ; Reset Handler 第二個表項是復位中斷服務入口地址
DCD NMI_Handler ; NMI Handler 不可屏蔽中斷?
DCD HardFault_Handler ; Hard Fault Handler 硬件錯誤處理
DCD MemManage_Handler ; MPU Fault Handler 存儲器錯誤處理
DCD BusFault_Handler ; Bus Fault Handler 總線錯誤處理
DCD UsageFault_Handler ; Usage Fault Handler 用法錯誤處理
DCD 0 ; Reserved ; 這種形式就是保留地址，不給任何標號分配
DCD 0 ; Reserved
DCD 0 ; Reserved
DCD 0 ; Reserved
DCD SVC_Handler ; SVCall Handler 執行系統服務調用指令（SVC）引發的異常
DCD DebugMon_Handler ; Debug Monitor Handler 調試監視器（斷點，數據觀察點，或者是外部調試請求
DCD 0 ; Reserved
DCD PendSV_Handler ; PendSV Handler 爲系統設備而設的“可懸掛請求” （pendable request）
DCD SysTick_Handler ; SysTick Handler 系統滴答定時器
; External Interrupts 外設中斷
DCD WWDG_IRQHandler ; Window Watchdog 窗口看門狗
DCD PVD_IRQHandler ; PVD through EXTI Line detect 電源電壓檢測(PVD)中斷
DCD TAMPER_IRQHandler ; Tamper
DCD RTC_IRQHandler ; RTC
DCD FLASH_IRQHandler ; Flash
DCD RCC_IRQHandler ; RCC
DCD EXTI0_IRQHandler ; EXTI Line 0
DCD EXTI1_IRQHandler ; EXTI Line 1
DCD EXTI2_IRQHandler ; EXTI Line 2
DCD EXTI3_IRQHandler ; EXTI Line 3
DCD EXTI4_IRQHandler ; EXTI Line 4
DCD DMA1_Channel1_IRQHandler ; DMA1 Channel 1
DCD DMA1_Channel2_IRQHandler ; DMA1 Channel 2
DCD DMA1_Channel3_IRQHandler ; DMA1 Channel 3
DCD DMA1_Channel4_IRQHandler ; DMA1 Channel 4
DCD DMA1_Channel5_IRQHandler ; DMA1 Channel 5
DCD DMA1_Channel6_IRQHandler ; DMA1 Channel 6
DCD DMA1_Channel7_IRQHandler ; DMA1 Channel 7
DCD ADC1_2_IRQHandler ; ADC1 and ADC2
DCD CAN1_TX_IRQHandler ; CAN1 TX
DCD CAN1_RX0_IRQHandler ; CAN1 RX0
DCD CAN1_RX1_IRQHandler ; CAN1 RX1
DCD CAN1_SCE_IRQHandler ; CAN1 SCE
DCD EXTI9_5_IRQHandler ; EXTI Line 9..5
DCD TIM1_BRK_IRQHandler ; TIM1 Break
DCD TIM1_UP_IRQHandler ; TIM1 Update
DCD TIM1_TRG_COM_IRQHandler ; TIM1 Trigger and Commutation
DCD TIM1_CC_IRQHandler ; TIM1 Capture Compare
DCD TIM2_IRQHandler ; TIM2
DCD TIM3_IRQHandler ; TIM3
DCD TIM4_IRQHandler ; TIM4
DCD I2C1_EV_IRQHandler ; I2C1 Event
DCD I2C1_ER_IRQHandler ; I2C1 Error
DCD I2C2_EV_IRQHandler ; I2C2 Event
DCD I2C2_ER_IRQHandler ; I2C1 Error
DCD SPI1_IRQHandler ; SPI1
DCD SPI2_IRQHandler ; SPI2
DCD USART1_IRQHandler ; USART1
DCD USART2_IRQHandler ; USART2
DCD USART3_IRQHandler ; USART3
DCD EXTI15_10_IRQHandler ; EXTI Line 15..10
DCD RTCAlarm_IRQHandler ; RTC alarm through EXTI line
DCD OTG_FS_WKUP_IRQHandler ; USB OTG FS Wakeup through EXTI line
DCD 0 ; Reserved
DCD 0 ; Reserved
DCD 0 ; Reserved
DCD 0 ; Reserved
DCD 0 ; Reserved
DCD 0 ; Reserved
DCD 0 ; Reserved
DCD TIM5_IRQHandler ; TIM5
DCD SPI3_IRQHandler ; SPI3
DCD UART4_IRQHandler ; UART4
DCD UART5_IRQHandler ; UART5
DCD TIM6_IRQHandler ; TIM6
DCD TIM7_IRQHandler ; TIM7
DCD DMA2_Channel1_IRQHandler ; DMA2 Channel1
DCD DMA2_Channel2_IRQHandler ; DMA2 Channel2
DCD DMA2_Channel3_IRQHandler ; DMA2 Channel3
DCD DMA2_Channel4_IRQHandler ; DMA2 Channel4
DCD DMA2_Channel5_IRQHandler ; DMA2 Channel5
DCD ETH_IRQHandler ; Ethernet
DCD ETH_WKUP_IRQHandler ; Ethernet Wakeup through EXTI line
DCD CAN2_TX_IRQHandler ; CAN2 TX
DCD CAN2_RX0_IRQHandler ; CAN2 RX0
DCD CAN2_RX1_IRQHandler ; CAN2 RX1
DCD CAN2_SCE_IRQHandler ; CAN2 SCE
DCD OTG_FS_IRQHandler ; USB OTG FS
__Vectors_End ; 結束
__Vectors_Size EQU __Vectors_End - __Vectors ;得到向量表的大小,304個字節也就是0x130個字節
;3）地址重映射及中斷向量表的轉移；
AREA |.text|, CODE, READONLY ;定義一個代碼段，可讀，段名字是.text 段名若以數字開頭，則該段名需用"|"括起來，如|1_test|。
;定義只讀數據段，實際上是在CODE區，如果在FLASH區起動，則 中斷向量起始地址爲0X8000000
;；CODE屬性：用於定義代碼段，默認爲READONLY
; Reset handler routine
Reset_Handler PROC ;；標記一個函數的開始;利用PROC、ENDP這一對僞指令把程序段分爲若干個過程，使程序的結構加清晰
EXPORT Reset_Handler [WEAK] ;在外部沒有定義該符號時導出該符號Reset_Handler
;EXPORT僞指令用於在程序中聲明一個全局的標號
IMPORT __main ;IMPORT：僞指令用於通知編譯器要使用的標號在其他的源文件中定義
LDR R0, =__main ;__main爲運行時庫提供的函數；完成堆棧，堆的初始化等工作，會調用下面定義的__user_initial_stackheap
BX R0 ;跳到__main，進入C的世界
ENDP
; Dummy Exception Handlers (infinite loops which can be modified)
;虛擬異常處理器(無限循環可以修改了)
NMI_Handler PROC ;PROC表示彙編函數的開始
EXPORT NMI_Handler [WEAK] ;WEAK聲明其他的同名標號優先於該標號被引用,就是說如果外面聲明瞭的話，
B . ;會調用外面的
ENDP
HardFault_Handler\
PROC ;PROC表示彙編函數的開始
EXPORT HardFault_Handler [WEAK] ;\換行的意思
B .
ENDP
MemManage_Handler\
PROC ;PROC表示彙編函數的開始
EXPORT MemManage_Handler [WEAK]
B .
ENDP
BusFault_Handler\
PROC ;PROC表示彙編函數的開始
EXPORT BusFault_Handler [WEAK]
B .
ENDP
UsageFault_Handler\
PROC
EXPORT UsageFault_Handler [WEAK]
B .
ENDP
SVC_Handler PROC ;PROC表示彙編函數的開始
EXPORT SVC_Handler [WEAK]
B .
ENDP
DebugMon_Handler\
PROC ;PROC表示彙編函數的開始
EXPORT DebugMon_Handler [WEAK]
B .
ENDP
PendSV_Handler PROC
EXPORT PendSV_Handler [WEAK]
B .
ENDP
SysTick_Handler PROC ;PROC表示彙編函數的開始
EXPORT SysTick_Handler [WEAK]
B .
ENDP
Default_Handler PROC
EXPORT WWDG_IRQHandler [WEAK]
EXPORT PVD_IRQHandler [WEAK]
EXPORT TAMPER_IRQHandler [WEAK]
EXPORT RTC_IRQHandler [WEAK]
EXPORT FLASH_IRQHandler [WEAK]
EXPORT RCC_IRQHandler [WEAK]
EXPORT EXTI0_IRQHandler [WEAK]
EXPORT EXTI1_IRQHandler [WEAK]
EXPORT EXTI2_IRQHandler [WEAK]
EXPORT EXTI3_IRQHandler [WEAK]
EXPORT EXTI4_IRQHandler [WEAK]
EXPORT DMA1_Channel1_IRQHandler [WEAK]
EXPORT DMA1_Channel2_IRQHandler [WEAK]
EXPORT DMA1_Channel3_IRQHandler [WEAK]
EXPORT DMA1_Channel4_IRQHandler [WEAK]
EXPORT DMA1_Channel5_IRQHandler [WEAK]
EXPORT DMA1_Channel6_IRQHandler [WEAK]
EXPORT DMA1_Channel7_IRQHandler [WEAK]
EXPORT ADC1_2_IRQHandler [WEAK]
EXPORT CAN1_TX_IRQHandler [WEAK]
EXPORT CAN1_RX0_IRQHandler [WEAK]
EXPORT CAN1_RX1_IRQHandler [WEAK]
EXPORT CAN1_SCE_IRQHandler [WEAK]
EXPORT EXTI9_5_IRQHandler [WEAK]
EXPORT TIM1_BRK_IRQHandler [WEAK]
EXPORT TIM1_UP_IRQHandler [WEAK]
EXPORT TIM1_TRG_COM_IRQHandler [WEAK]
EXPORT TIM1_CC_IRQHandler [WEAK]
EXPORT TIM2_IRQHandler [WEAK]
EXPORT TIM3_IRQHandler [WEAK]
EXPORT TIM4_IRQHandler [WEAK]
EXPORT I2C1_EV_IRQHandler [WEAK]
EXPORT I2C1_ER_IRQHandler [WEAK]
EXPORT I2C2_EV_IRQHandler [WEAK]
EXPORT I2C2_ER_IRQHandler [WEAK]
EXPORT SPI1_IRQHandler [WEAK]
EXPORT SPI2_IRQHandler [WEAK]
EXPORT USART1_IRQHandler [WEAK]
EXPORT USART2_IRQHandler [WEAK]
EXPORT USART3_IRQHandler [WEAK]
EXPORT EXTI15_10_IRQHandler [WEAK]
EXPORT RTCAlarm_IRQHandler [WEAK]
EXPORT OTG_FS_WKUP_IRQHandler [WEAK]
EXPORT TIM5_IRQHandler [WEAK]
EXPORT SPI3_IRQHandler [WEAK]
EXPORT UART4_IRQHandler [WEAK]
EXPORT UART5_IRQHandler [WEAK]
EXPORT TIM6_IRQHandler [WEAK]
EXPORT TIM7_IRQHandler [WEAK]
EXPORT DMA2_Channel1_IRQHandler [WEAK]
EXPORT DMA2_Channel2_IRQHandler [WEAK]
EXPORT DMA2_Channel3_IRQHandler [WEAK]
EXPORT DMA2_Channel4_IRQHandler [WEAK]
EXPORT DMA2_Channel5_IRQHandler [WEAK]
EXPORT ETH_IRQHandler [WEAK]
EXPORT ETH_WKUP_IRQHandler [WEAK]
EXPORT CAN2_TX_IRQHandler [WEAK]
EXPORT CAN2_RX0_IRQHandler [WEAK]
EXPORT CAN2_RX1_IRQHandler [WEAK]
EXPORT CAN2_SCE_IRQHandler [WEAK]
EXPORT OTG_FS_IRQHandler [WEAK]
WWDG_IRQHandler
PVD_IRQHandler
TAMPER_IRQHandler
RTC_IRQHandler
FLASH_IRQHandler
RCC_IRQHandler
EXTI0_IRQHandler
EXTI1_IRQHandler
EXTI2_IRQHandler
EXTI3_IRQHandler
EXTI4_IRQHandler
DMA1_Channel1_IRQHandler
DMA1_Channel2_IRQHandler
DMA1_Channel3_IRQHandler
DMA1_Channel4_IRQHandler
DMA1_Channel5_IRQHandler
DMA1_Channel6_IRQHandler
DMA1_Channel7_IRQHandler
ADC1_2_IRQHandler
CAN1_TX_IRQHandler
CAN1_RX0_IRQHandler
CAN1_RX1_IRQHandler
CAN1_SCE_IRQHandler
EXTI9_5_IRQHandler
TIM1_BRK_IRQHandler
TIM1_UP_IRQHandler
TIM1_TRG_COM_IRQHandler
TIM1_CC_IRQHandler
TIM2_IRQHandler
TIM3_IRQHandler
TIM4_IRQHandler
I2C1_EV_IRQHandler
I2C1_ER_IRQHandler
I2C2_EV_IRQHandler
I2C2_ER_IRQHandler
SPI1_IRQHandler
SPI2_IRQHandler
USART1_IRQHandler
USART2_IRQHandler
USART3_IRQHandler
EXTI15_10_IRQHandler
RTCAlarm_IRQHandler
OTG_FS_WKUP_IRQHandler
TIM5_IRQHandler
SPI3_IRQHandler
UART4_IRQHandler
UART5_IRQHandler
TIM6_IRQHandler
TIM7_IRQHandler
DMA2_Channel1_IRQHandler
DMA2_Channel2_IRQHandler
DMA2_Channel3_IRQHandler
DMA2_Channel4_IRQHandler
DMA2_Channel5_IRQHandler
ETH_IRQHandler
ETH_WKUP_IRQHandler
CAN2_TX_IRQHandler
CAN2_RX0_IRQHandler
CAN2_RX1_IRQHandler
CAN2_SCE_IRQHandler
OTG_FS_IRQHandler
B .
ENDP
ALIGN
;*******************************************************************************
; User Stack and Heap initialization（4）堆和棧的初始化
;*******************************************************************************
IF :DEF:__MICROLIB ;判斷是否使用DEF:__MICROLIB（micro lib）
EXPORT __initial_sp ;使用的話則將棧頂地址，堆始末地址賦予全局屬
EXPORT __heap_base ;使外部程序可以使用
EXPORT __heap_limit
ELSE ;如果使用默認C庫運行時
IMPORT __use_two_region_memory ;定義全局標號__use_two_region_memory
EXPORT __user_initial_stackheap ;聲明全局標號__user_initial_stackheap，這樣外程序也可調用此標號
;則進行堆棧和堆的賦值，在__main函數執行過程中調用
__user_initial_stackheap ;標號__user_initial_stackheap，表示用戶堆棧初始化程序入口
LDR R0, = Heap_Mem ;保存堆始地址
LDR R1, =(Stack_Mem + Stack_Size) ;保存棧的大小
LDR R2, = (Heap_Mem + Heap_Size) ;保存堆的大小
LDR R3, = Stack_Mem ;保存棧頂指針
BX LR
ALIGN ;ALIGN屬性：使用方式爲ALIGN 表達式。在默認時，ELF（可執行連接文件）的代碼段和數據段是按字對齊的，表達式的取值範圍爲0～31，相應的對齊方式爲2表達式次方
ENDIF
END
;******************* (C) COPYRIGHT 2009 STMicroelectronics *****END OF FILE*****