zoukankan      html  css  js  c++  java
  • core_cm3文件函数一览

    core_cm3是ARM公司推出来的统一规定,这是对下游芯片厂商的统一规定,因此可以再Cortex-M3(CM3)之间进行移植。此文件中定义了一些对特殊功能寄存器的C语言形式的操作,本质上是内敛汇编和嵌入式汇编。本文均已μC/OS-II移植为例进行举例。

    那么先通过几个例子介绍下内敛汇编和嵌入式汇编的形式吧,,因为下面要用到,看完这几个例子就能看懂了,但是如果需要详细学习,请参考文末的参考资料,因为与真正的汇编还是有不少区别的,比如在内敛汇编中我们操作的都是虚拟寄存器(那么它是如何转到真正的寄存器的呢?不晓得,⊙﹏⊙b汗),“pc(r15)、lr(r14) 和 sp(r13) 寄存器根本不能访问。访问这些寄存器时,会产生错误消息。”等等。
    1. 单行内敛汇编
     C++ Code 
    1
    2
     
    #define OS_ENTER_CRITICAL()          __asm( "CPSID   I")
    #define OS_EXIT_CRITICAL()           __asm( "CPSIE   I")
    主要是小括号+双引号。

    2.多行内敛汇编
     C++ Code 
    1
    2
    3
    4
     
    __asm
    {
         //原汁原味的汇编语句
    }
    用大括号取代了小括号,并且不需要双引号了,直接加上就可以了。不过要是用到R0寄存器不声明的话,会有个warning,可以在前面int R0声明下。
    这里用的时候我产生了一个小疑问,当我用到R0,R1这些寄存器的时候,需不需要先PUSH,用完之后在POP呢?看完《编译器用户指南》之后,它说了, 不用,编译器帮我们做了。

    3.嵌入式汇编
     C++ Code 
    1
    2
    3
    4
    5
     
    __asm uint32_t __get_PSP( void)
    {
      mrs r0, psp
      bx lr
    }
    在前面加上__asm关键字即可。不过要注意的是需要在最后加上 bx lr显式返回,我之前就忘了返回,然后就HardFault_Handler了。


    直接看代码:
     编译器厂商宏定义选择
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
     
    /* define compiler specific symbols */
    #if defined ( __CC_ARM   )
       #define __ASM             __asm                                       /*!< asm keyword for ARM Compiler          */
       #define __INLINE          __inline                                    /*!< inline keyword for ARM Compiler       */

    #elif defined ( __ICCARM__ )
       #define __ASM            __asm                                        /*!< asm keyword for IAR Compiler          */
       #define __INLINE         inline                                       /*!< inline keyword for IAR Compiler. Only avaiable in High optimization mode! */

    #elif defined   (  __GNUC__  )
       #define __ASM             __asm                                       /*!< asm keyword for GNU Compiler          */
       #define __INLINE          inline                                      /*!< inline keyword for GNU Compiler       */

    #elif defined   (  __TASKING__  )
       #define __ASM             __asm                                       /*!< asm keyword for TASKING Compiler      */
       #define __INLINE          inline                                      /*!< inline keyword for TASKING Compiler   */

    #endif
    就我所知,对ARM芯片进行编程,市面上大抵有三款编译器可供选择:ARM自家的ARM Compiler,第三方的IAR Compiler和GNU针对ARM的Compiler。最后一个木有见过, TASKING Compiler   Embedded software development tools )?
    不同的编译器具有的不同关键字形式,不过貌似就ARM自家的内敛关键字的前面多两个下划线,但是人家形式看上去更加统一一点,这对于有“强迫症”的工程师是不错的。

    然后就是针对不同编译器的函数定义,也是通过与以上形式一致的方式来实现的,给出个框架先。用哪个编译器就用编译相对应的代码即可。
     core_cm3.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
     

    /* ###################  Compiler specific Intrinsics  ########################### */

    #if defined ( __CC_ARM   )  /*------------------RealView Compiler -----------------*/
    /* ARM armcc specific functions */


    #elif (defined (__ICCARM__))  /*------------------ ICC Compiler -------------------*/
    /* IAR iccarm specific functions */


    #elif (defined (__GNUC__))  /*------------------ GNU Compiler ---------------------*/


    #elif (defined (__TASKING__))  /*------------------ TASKING Compiler ---------------------*/
    /* TASKING carm specific functions */


    /*
     * The CMSIS functions have been implemented as intrinsics in the compiler.
     * Please use "carm -?i" to get an up to date list of all instrinsics,
     * Including the CMSIS ones.
     */


    #endif


    然后针对ARM Compiler形式的函数进行讨论,即对 /* ARM armcc specific functions */讨论下。
     进程堆栈:获取PSP和设置PSP
    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
     
    /**
     * @brief  Return the Process Stack Pointer
     *
     * @return ProcessStackPointer
     *
     * Return the actual process stack pointer
     */

    __ASM uint32_t __get_PSP( void)
    {
      mrs r0, psp
      bx lr
    }

    /**
     * @brief  Set the Process Stack Pointer
     *
     * @param  topOfProcStack  Process Stack Pointer
     *
     * Assign the value ProcessStackPointer to the MSP 
     * (process stack pointer) Cortex processor register
     */

    __ASM  void __set_PSP(uint32_t topOfProcStack)
    {
      msr psp, r0
      bx lr
    }
    这里的两个函数都是用R0的原因是ARM有默认的规定,传入的参数从左至右依次放入R0-R4中,这里也就是写C函数的时候,输入的参数不要过多,不然得PUSH到栈中,速度就下来;如果有返回值,则将R0的值返回。
    这里放一个自己发现的此函数的一个小例子,在CM3上移植μC/OS-II时,需要移植首次启动时-OSStart函数中最后调用的OSStartHighRdy,一般采用汇编编写,如下所示,不想看的直接跳过看下面的中文描述也可:
     os_cpu_a.asm: OSStartHighRdy
    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
     
    ;定义几个常量,类似C语言中的#define预处理指令。     
    NVIC_INT_CTRL       EQU     0xE000ED04  ; 中断控制寄存器
    NVIC_SYSPRI14       EQU     0xE000ED22  ; PendSV优先级寄存器的地址
    NVIC_PENDSV_PRI     EQU     0x000000FF  ; PendSV中断的优先级为255(最低)
    NVIC_PENDSVSET      EQU     0x10000000  ; 触发软件中断的值,位28为1.
    ;********************************************************************************************************
    ;                                         START MULTITASKING
    ;                                       void OSStartHighRdy( void)
    ;
    ; Note(s) :  1) This function triggers a PendSV exception (essentially, causes a context  switch) to cause
    ;              the first task to start.
    ;
    ;            2) OSStartHighRdy() MUST:
    ;              a) Setup PendSV exception priority to lowest;
    ;              b) Set initial PSP to  0, to tell context switcher  this is first run;
    ;              c) Set the main stack to OSRunning
    ;              d) Trigger PendSV exception;
    ;              e) Enable interrupts (tasks will run with interrupts enabled).
    ;********************************************************************************************************
    OSStartHighRdy
            ;设置PendSV中断的优先级
            LDR     R4, =NVIC_SYSPRI14      ; set the PendSV exception priority
            LDR     R5, =NVIC_PENDSV_PRI
            STR     R5, [R4]
            ;设置PSP为0
            MOV     R4, #0                 ; set the PSP to  0  for initial context  switch call
            MSR     PSP, R4
            ;设置OSRunning为TRUE
            LDR     R4, =OSRunning         ; OSRunning = TRUE
            MOV     R5, #1
            STRB    R5, [R4]

            ;触发PendSV中断
            LDR     R4, =NVIC_INT_CTRL     ;rigger the PendSV exception (causes context  switch)
            LDR     R5, =NVIC_PENDSVSET
            STR     R5, [R4]

            CPSIE   I                      ;enable interrupts at processor level
            ;死循环,应该不会到这里
    OSStartHang
            B       OSStartHang            ;should never get here
    转换成中文描述过程如下:
    1. 设置PendSV优先级
    2. 设置PSP为0
    3. 设置系统的运行状态
    4. 开始执行最高优先级任务
    5. 开中断
    补充说明下:关于第1点,参考权威指南讨论PendSV即可;关于第2点,其实不设置也是可以的,它的作用是 省掉第一次上下文切换时候的R4-R11的入栈保护,仅此而已,这是事实没错,但是这个考虑会增加代码的编写,体现在此处和PendSV中断函数的编写上,不过这也表明作者的多OS过程的认识,思维的严谨。关于第5点,显示声明中断要开着,没有也没关系,因为本来中断就是开着的,只要你不蛋疼的去把它关掉。

    改成C语言形式如下:
     os_cpu_c.c
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
     
    #define  NVIC_INT_CTRL              *((OS_CPU_SR *)0xE000ED04)   //中断控制寄存器ICSR
    #define  NVIC_PENDSVSET             0x10000000   //触发软件中断的值,位28为1.
    #define  OS_TASK_SW()               NVIC_INT_CTRL = NVIC_PENDSVSET
    #define  OSIntCtxSw()               NVIC_INT_CTRL = NVIC_PENDSVSET

    #define OS_ENTER_CRITICAL()          __asm( "CPSID   I");
    #define OS_EXIT_CRITICAL()           __asm( "CPSIE   I");

    #define NVIC_SYSPRI14               *((OS_CPU_SR *)0xE000ED22)   //PendSV优先级寄存器的地址
    #define NVIC_PENDSV_PRI             0x000000FF                   //PendSV中断的优先级为255(最低)
    #define SET_PENDSV_FF()             NVIC_SYSPRI14=NVIC_PENDSV_PRI

    void OSStartHighRdy( void)
    {   
        SET_PENDSV_FF();          //这里写FF是因为把它的中断优先级设置为最低255
        __set_PSP( 0);
        OSRunning =  1;
        OS_TASK_SW();
        OS_EXIT_CRITICAL();
    }

    怎么样,优雅多了吧,而且也比较明了。此处我把它 放在os_cpu_c.c文件中,当然一般的宏定义还是会放在头文件oc_cpu.h中的。
    要是与会变形式的再像一点,在最后加上死循环while(1);则完全一致了,只不过不会在这里的,因为它马上就去优先级最高的任务那里去了。
    这里还要说一下,在我们板子启动的时候,使用的MSP,要是我们使用前后台的形式来开发程序,不管在用户程序还是中断程序里面,我们就用一个MSP就ok了,因为就相当于一个线程在那里不停的跑。而当我们使用RTOS,如μC/OS-II,那么我们在所有的用户任务中,使用的 PSP,这也是我之前没注意的地方,

    扯远了,看下一个:
     主堆栈:获取MSP和设置MSP
    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
     
    /**
     * @brief  Return the Main Stack Pointer
     *
     * @return Main Stack Pointer
     *
     * Return the current value of the MSP (main stack pointer)
     * Cortex processor register
     */

    __ASM uint32_t __get_MSP( void)
    {
      mrs r0, msp
      bx lr
    }

    /**
     * @brief  Set the Main Stack Pointer
     *
     * @param  topOfMainStack  Main Stack Pointer
     *
     * Assign the value mainStackPointer to the MSP 
     * (main stack pointer) Cortex processor register
     */

    __ASM  void __set_MSP(uint32_t mainStackPointer)
    {
      msr msp, r0
      bx lr
    }
    使用尚待开发。


     反转无符号16位值和有符号16位值
    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
     
    /**
     * @brief  Reverse byte order in unsigned short value
     *
     * @param   value  value to reverse
     * @return         reversed value
     *
     * Reverse byte order in unsigned short value
     */

    __ASM uint32_t __REV16(uint16_t value)
    {
      rev16 r0, r0
      bx lr
    }

    /**
     * @brief  Reverse byte order in signed short value with sign extension to integer
     *
     * @param   value  value to reverse
     * @return         reversed value
     *
     * Reverse byte order in signed short value with sign extension to integer
     */

    __ASM int32_t __REVSH(int16_t value)
    {
      revsh r0, r0
      bx lr
    }
    使用尚待开发。


     C++ Code 
    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
     
    /**
     * @brief  Remove the exclusive lock created by ldrex
     *
     * Removes the exclusive lock which is created by ldrex.
     */

    __ASM  void __CLREX( void)
    {
      clrex
    }

    /**
     * @brief  Return the Base Priority value
     *
     * @return BasePriority
     *
     * Return the content of the base priority register
     */

    __ASM uint32_t  __get_BASEPRI( void)
    {
      mrs r0, basepri
      bx lr
    }

    /**
     * @brief  Set the Base Priority value
     *
     * @param  basePri  BasePriority
     *
     * Set the base priority register
     */

    __ASM  void __set_BASEPRI(uint32_t basePri)
    {
      msr basepri, r0
      bx lr
    }

    /**
     * @brief  Return the Priority Mask value
     *
     * @return PriMask
     *
     * Return state of the priority mask bit from the priority mask register
     */

    __ASM uint32_t __get_PRIMASK( void)
    {
      mrs r0, primask
      bx lr
    }

    /**
     * @brief  Set the Priority Mask value
     *
     * @param  priMask  PriMask
     *
     * Set the priority mask bit in the priority mask register
     */

    __ASM  void __set_PRIMASK(uint32_t priMask)
    {
      msr primask, r0
      bx lr
    }

    /**
     * @brief  Return the Fault Mask value
     *
     * @return FaultMask
     *
     * Return the content of the fault mask register
     */

    __ASM uint32_t  __get_FAULTMASK( void)
    {
      mrs r0, faultmask
      bx lr
    }

    /**
     * @brief  Set the Fault Mask value
     *
     * @param  faultMask  faultMask value
     *
     * Set the fault mask register
     */

    __ASM  void __set_FAULTMASK(uint32_t faultMask)
    {
      msr faultmask, r0
      bx lr
    }

    /**
     * @brief  Return the Control Register value
     * 
     * @return Control value
     *
     * Return the content of the control register
     */

    __ASM uint32_t __get_CONTROL( void)
    {
      mrs r0, control
      bx lr
    }

    /**
     * @brief  Set the Control Register value
     *
     * @param  control  Control value
     *
     * Set the control register
     */

    __ASM  void __set_CONTROL(uint32_t control)
    {
      msr control, r0
      bx lr
    }
    以上的嵌入汇编可以拿来对照权威指南学习,看看寄存器的变化过程以及造成的影响,主要是P14页的”特殊功能寄存器“中的那些个特殊功能寄存器。使用尚待开发。




    如果文中有描述不清楚或者错误的地方,请参考《编译器用户指南》和《ARM Cortex-M3权威指南》,并以此为准。

    另外,虽然μC/OS-II的移植已经被讲烂了,但是看了这个还是有点搞头的,新版的正在紧张改写中,它更加简洁明了。
    To Be Continued~~
  • 相关阅读:
    如何借助BM算法轻松理解KMP算法
    如何实现文本编辑器中的查找替换功能?——BF算法
    C++中求数组长度与memset的用法
    什么是素数/质数/合数
    深度和广度优先搜索:如何找出社交网络中的三度好友关系?
    如何存储微博、微信等社交网络中的好友关系?
    为什么说堆排序没有快速排序快?
    HTML5中标记与特殊属性
    margin外边距问题
    html热点区域
  • 原文地址:https://www.cnblogs.com/suncoolcat/p/3301773.html
Copyright © 2011-2022 走看看