ADS1.2在汇编代码中调用C函数来源:www.another-prj.com
对于ARM体系来说,不同语言撰写的函数之间相互调用(mix calls)遵循的是 ATPCS(ARM-Thumb ProcedureCallStandard),ATPCS主要是定义了函数呼叫时参数的传递规则以及如何从函数返回,关于ATPCS的详细内容可以查看ADS1.2Online Books ——Developer Guide的2.1节。这篇文档要讲的是汇编代码中对C函数调用时如何进行参数的传递以及如何从C函数正确返回
不同于x86的参数传递规则,ATPCS建议函数的形参不超过4个,如果形参个数少于或等于4,则形参由R0,R1,R2,R3四个寄存器进行传递;若形参个数大于4,大于4的部分必须通过堆栈进行传递。
我们先讨论一下形参个数为4的情况.
实例1:
test_asm_args.asm
//--------------------------------------------------------------------------------
IMPORTtest_c_args ;声明test_c_args函数
AREATEST_ASM, CODE, READONLY
EXPORTtest_asm_args
test_asm_args
STR lr, [sp,#-4]! ;保存当前lr
ldrr0,=0x10 ;参数 1
ldrr1,=0x20 ;参数 2
ldrr2,=0x30 ;参数 3
ldrr3,=0x40 ;参数 4
bltest_c_args ;调用C函数
LDR pc, [sp],#4 ;将lr装进pc(返回main函数)
END
test_c_args.c
//--------------------------------------------------------------------------------
void test_c_args(int a,int b,int c,int d)
{
printk("test_c_args:\n");
printk("%0x%0x %0x %0x\n",a,b,c,d);
}
main.c
//--------------------------------------------------------------------------------
int main()
{
test_asm_args();
for(;;);
}
程序从main函数开始执行,main调用了test_asm_args,test_asm_args调用了test_c_args,最后从test_asm_args返回main.
代码分别使用了汇编和C定义了两个函数,test_asm_args 和test_c_args,test_asm_args调用了test_c_args,其参数的传递方式就是向R0~R3分别写入参数值,之后使用bl语句对test_c_args进行调用。其中值得注意的地方是用红色标记的语句,test_asm_args在调用test_c_args之前必须把当前的lr入栈,调用完test_c_args之后再把刚才保存在栈中的lr写回pc,这样才能返回到main函数中。
如果test_c_args的参数是8个呢?这种情况test_asm_args应该怎样传递参数呢?
实例2:
test_asm_args.asm
//--------------------------------------------------------------------------------
IMPORTtest_c_args ;声明test_c_args函数
AREATEST_ASM, CODE, READONLY
EXPORTtest_asm_args
test_asm_args
STR lr, [sp,#-4]! ;保存当前lr
ldrr0,=0x1 ;参数 1
ldr r1,=0x2 ;参数 2
ldr r2,=0x3 ;参数 3
ldr r3,=0x4 ;参数 4
ldr r4,=0x8
str r4,[sp,#-4]! ;参数 8 入栈
ldr r4,=0x7
str r4,[sp,#-4]! ;参数 7 入栈
ldr r4,=0x6
str r4,[sp,#-4]! ;参数 6 入栈
ldr r4,=0x5
str r4,[sp,#-4]! ;参数 5 入栈
bltest_c_args_lots
ADD sp, sp, #4 ;清除栈中参数 5,本语句执行完后sp指向参数6
ADD sp, sp, #4 ;清除栈中参数 6,本语句执行完后sp指向参数7
ADD sp, sp, #4 ;清除栈中参数 7,本语句执行完后sp指向参数8
ADD sp, sp, #4 ;清除栈中参数 8,本语句执行完后sp指向lr
LDR pc, [sp],#4 ;将lr装进pc(返回main函数)
END
test_c_args.c
//--------------------------------------------------------------------------------
void test_c_args(int a,int b,int c,int d,int e,int f,int g,inth)
{
printk("test_c_args_lots:\n");
printk("%0x %0x %0x %0x %0x %0x %0x%0x\n",
a,b,c,d,e,f,g,h);
}
main.c
//--------------------------------------------------------------------------------
int main()
{
test_asm_args();
for(;;);
}
这部分的代码和实例1的代码大部分是相同的,不同的地方是test_c_args的参数个数和test_asm_args的参数传递方式。
在test_asm_args中,参数1~参数4还是通过R0~R3进行传递,而参数5~参数8则是通过把其压入堆栈的方式进行传递,不过要注意这四个入栈参数的入栈顺序,是以参数8->参数7->参数6->参数5的顺序入栈的。
直到调用test_c_args之前,堆栈内容如下:
sp->+----------+
| 参数5 |
+----------+
| 参数6 |
+----------+
| 参数7 |
+----------+
| 参数8 |
+----------+
| lr |
+----------+
test_c_args执行返回后,则设置sp,对之前入栈的参数进行清除,最后将lr装入pc返回main函数,在执行 LDR pc, [sp],#4指令之前堆栈内容如下:
+----------+
| 参数5 |
+----------+
| 参数6 |
+----------+
| 参数7 |
+----------+
| 参数8 |
sp->+----------+
| lr |
+----------+
A.5.1 文件格式
ARM 源程序文件(即源文件)为文件格式,可以使用任一文本编辑器编写程序代码。
在一个项目中,至少要有一个汇编源文件或C 程序文件,可以有多个汇编源文件或多个C 程序文件,或者C程序文件和汇编文件两者的组合。
A.5.2 ARM 汇编的一些规范
(1)汇编语句格式
ARM 汇编中,所有标号必须在一行的顶格书写,其后面不要添加“:”,而所有指令均不能顶格书写。ARM汇编器对标识符大小写敏感,书写标号及指令时字母大小写要一致,在ARM 汇编程序中,一个ARM指令、伪指令、寄存器名可以全部为大写字母,也可以全部为小写字母,但不要大小写混合使用。注释使用“;”,注释内容由“;”开始到此行结束,注释可以在一行的顶格书写。
格式:[标号] <指令|条件|S><操作数>[;注释]
源程序中允许有空行,适当地插入空行可以提高源代码的可读性。如果单行太长,可以使用字符“”将其分行,“”后不能有任何字符,包括空格和制表符等。对于变量的设置,常量的定义,其标识符必须在一行的顶格书写。
汇编指令正确的例子和错误的例子如下:
正确的例子:
…
Str1 SETS My string1.” ;设置字符串变量Str1
Count RN R0 ;定义寄存器名Count
USR_STACK EQU 64 ;定义常量
START LDR R0,=0x1123456 ;R0=0x123456H
MOV R1,#0
LOOP
MOV R2,#3
…
错误的例子:
START MOV R0,#1 ;标号START没有顶格写
ABC: MOV R1,#2 ;标号后不能带:
MOV R2,#3 ;命令不允许顶格书写
loop Mov R2,#3 ;指令中大小写混合
B Loop ;无法跳转到Loop标号