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~~
原文地址:https://www.cnblogs.com/suncoolcat/p/3301773.html