Keil-MDK 中 [WEAK] 的作用

忘是亡心i 2022-08-26 00:58 199阅读 0赞

移植后的代码戳这里: [https://code.csdn.net/KISSMonX/freertos\_f3discovery\_test][https_code.csdn.net_KISSMonX_freertos_f3discovery_test]

在上一篇文章 ARM 汇编中的 "B ." 语句意义.时, 顺带介绍了 \[WEAK\] 的作用.  
昨天再思考移植问题的时候(也就是执行第一个任务时直接跳到 SVC\_Handler 里的 B . 处),  
想到了这个问题, 然后在移植配置文件中添加了几个宏定义就解决了问题, 移植成功, 具体下文介绍.  
这里再做一次解释. 看看自己是不是真正的理解了. :)  
  
第一步明显是要贴代码装逼, 去启动文件里摘取出要介绍的部分. 然后记笔记的形式摘录下来.如下:

; Reset handler 这里才是启动文件的重点啊. 不过没见到为 C 程序建立栈空间操作啊??? 直接调用 main 大丈夫? MAN???
    Reset_Handler    PROC
                     EXPORT  Reset_Handler             [WEAK]
            IMPORT  SystemInit
            IMPORT  __main
    
                     LDR     R0, =SystemInit
                     BLX     R0
                     LDR     R0, =__main
                     BX      R0
                     ENDP
    
    ; Dummy Exception Handlers (infinite loops which can be modified)
    
    NMI_Handler     PROC
                    EXPORT  NMI_Handler                [WEAK]
                    B       .
                    ENDP
    HardFault_Handler\
                    PROC
                    EXPORT  HardFault_Handler          [WEAK]
                    B       .
                    ENDP
    MemManage_Handler\
                    PROC
                    EXPORT  MemManage_Handler          [WEAK]
                    B       .
                    ENDP
    BusFault_Handler\
                    PROC
                    EXPORT  BusFault_Handler           [WEAK]
                    B       .
                    ENDP
    UsageFault_Handler\
                    PROC
                    EXPORT  UsageFault_Handler         [WEAK]
                    B       .
                    ENDP
    SVC_Handler     PROC
                    EXPORT  SVC_Handler                [WEAK]
                    B       .
                    ENDP
    DebugMon_Handler\
                    PROC
                    EXPORT  DebugMon_Handler           [WEAK]
                    B       .
                    ENDP
    PendSV_Handler  PROC
                    EXPORT  PendSV_Handler             [WEAK]
                    B       .
                    ENDP
    SysTick_Handler PROC
                    EXPORT  SysTick_Handler            [WEAK]
                    B       .
                    ENDP
    
    Default_Handler PROC
    
                    EXPORT  WWDG_IRQHandler                   [WEAK]                                        
                    EXPORT  PVD_IRQHandler                    [WEAK]                      
                    EXPORT  TAMPER_STAMP_IRQHandler           [WEAK]         
                    EXPORT  RTC_WKUP_IRQHandler               [WEAK]                     
                    EXPORT  FLASH_IRQHandler                  [WEAK]                                         
                    EXPORT  RCC_IRQHandler                    [WEAK]                                            
                    EXPORT  EXTI0_IRQHandler                  [WEAK]                                            
                    EXPORT  EXTI1_IRQHandler                  [WEAK]                                             
                    EXPORT  EXTI2_TS_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  USB_HP_CAN1_TX_IRQHandler         [WEAK]                                                
                    EXPORT  USB_LP_CAN1_RX0_IRQHandler        [WEAK]                                               
                    EXPORT  CAN1_RX1_IRQHandler               [WEAK]                                                
                    EXPORT  CAN1_SCE_IRQHandler               [WEAK]                                                
                    EXPORT  EXTI9_5_IRQHandler                [WEAK]                                    
                    EXPORT  TIM1_BRK_TIM15_IRQHandler         [WEAK]                  
                    EXPORT  TIM1_UP_TIM16_IRQHandler          [WEAK]                
                    EXPORT  TIM1_TRG_COM_TIM17_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  RTC_Alarm_IRQHandler              [WEAK]                  
                    EXPORT  USBWakeUp_IRQHandler              [WEAK]                        
                    EXPORT  TIM8_BRK_IRQHandler               [WEAK]                 
                    EXPORT  TIM8_UP_IRQHandler                [WEAK]                 
                    EXPORT  TIM8_TRG_COM_IRQHandler           [WEAK] 
                    EXPORT  TIM8_CC_IRQHandler                [WEAK]
                    EXPORT  ADC3_IRQHandler                   [WEAK]                                   
                    EXPORT  SPI3_IRQHandler                   [WEAK]                                             
                    EXPORT  UART4_IRQHandler                  [WEAK]                                            
                    EXPORT  UART5_IRQHandler                  [WEAK]                                            
                    EXPORT  TIM6_DAC_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  ADC4_IRQHandler                   [WEAK]                                 
                    EXPORT  COMP1_2_3_IRQHandler              [WEAK]                                               
                    EXPORT  COMP4_5_6_IRQHandler              [WEAK]                                               
                    EXPORT  COMP7_IRQHandler                  [WEAK]                                               
                    EXPORT  USB_HP_IRQHandler                 [WEAK]                      
                    EXPORT  USB_LP_IRQHandler                 [WEAK]                      
                    EXPORT  USBWakeUp_RMP_IRQHandler          [WEAK]                        
                    EXPORT  FPU_IRQHandler                    [WEAK]

然后到 keil 的帮助文档里找到这么一句话:

/* WEAK : symbol is only imported into other sources if no other source exports an alternative symbol. 
    If [WEAK] is used without symbol, all exported symbols are weak. */

紧接着下面就有这种介绍:

![SouthEast][]

这里是针对汇编语言的, C 语言级别的别捉急. 英语好的可以直接移步:[About weak references and definitions][]  
比我介绍的详细准确多了.  
英语不好的就算了吧. 大致意思就是:

// 意思就是告诉链接器: 
    // "我略弱但我很绅士, 如果你在别处看到和我一样的符号实例.你就用它吧. 表管我, 求忽视! "

所以......知道这个, 就可以解决为什么 FreeRTOS 在执行到下面这段代码老是跳转到 SVC\_Handler 处了.

<乱入> SVC 作用:  SVCall  A supervisor call (SVC) is an exception that is triggered by the SVC instruction. In an OS environment, applications can use SVC instructions to   
access OS kernel functions and device drivers.

__asm void prvStartFirstTask( void )
    {
    	PRESERVE8
    
    	/* Use the NVIC offset register to locate the stack. */
    	ldr r0, =0xE000ED08
    	ldr r0, [r0]
    	ldr r0, [r0]
    	/* Set the msp back to the start of the stack. */
    	msr msp, r0
    	/* Globally enable interrupts. */
    	cpsie i
    	dsb
    	isb
    	/* Call SVC to start the first task. */
    	svc 0  // 0 号系统调用, 更多关于 SVC 可以参考 google 或者 ARM Cortex-M3 权威指南
    	nop
    }

因为各个开发工具厂家对这些启动文件的异常和中断只做了简单的处理. 基本都是死循环(也就是"B .").  
而且特意加上了 \[WEAK\] 修饰. 这样用户可以根据自己的需要重新编写自己的处理函数, 而且只要命名一样就 OK 了.  
那名字要是不一样怎么办? 然后, 我去找了 SVC\_Handler 这个名字, 并没有找到, 但是在 port.c 中找到了  
下面这个函数:

__asm void vPortSVCHandler( void )
    {
    	PRESERVE8
    
    	/* Get the location of the current TCB. */
    	ldr	r3, =pxCurrentTCB
    	ldr r1, [r3]
    	ldr r0, [r1]
    	/* Pop the core registers. */
    	ldmia r0!, {r4-r11, r14}
    	msr psp, r0
    	isb
    	mov r0, #0
    	msr	basepri, r0
    	bx r14
    }

这不就是披了马甲的 SVC\_Handler 吗? 尼玛......显然里面的内容我不太明白, 就不解释了. 再学.  
然后我当然没有那么聪明, 我找到了以前移植过的文件看了一下, 发现在 portmacro.h 中有下面三个宏定义:

#define vPortSVCHandler      SVC_Handler
    #define xPortSysTickHandler  SysTick_Handler
    #define xPortPendSVHandler   PendSV_Handler

扫噶. 原来宏名也比 WEAK 修饰过的强啊. 重新编译链接没错. 烧写, 各任务运行正常.

[https_code.csdn.net_KISSMonX_freertos_f3discovery_test]: https://code.csdn.net/KISSMonX/freertos_f3discovery_test
[SouthEast]: /images/20220824/b265ec26c23f49ec8e896e3790d0d1f4.png
[About weak references and definitions]: http://www.keil.com/support/man/docs/armlink/armlink_CACCEEIF.htm