STM32的API接口的BIN文件的生成以及调用

     有时候我们需要将一些$STM32$单片机上面的$API$接口生成$BIN$文件的形式给别人进行调用，下面介绍的方法可以使得生成的$BIN$文件尽可能的小且方便调用。这里假设我们生成$API$接口$BIN$文件的工程布局如图1所示，其中$api.c$文件里面就是我们准备给别人使用的$API$接口。

　

图1.

     $api.c$文件源码如下所示，这里假设只有两个$API$接口（在实际应用中可以扩展为多个接口，这里只是一个示例，没有限制说只能是两个$API$接口），为了实现使得生成的$BIN$文件尽可能的小且方便调用，这里额外的定义了一个用来存储每个接口的函数指针的结构体并定义了一个对应的结构体变量且初始化为每一个$API$接口的函数指针，然后我们将这个结构体变量放到$API$接口对应的$BIN$文件存放的存储区域的起始地址（这里假设从地址$0x20008000$开始存放），这样就可以实现使得生成的$BIN$文件尽可能的小且方便调用。

#include "api.h"	  

typedef const struct
{
    int (*user_api1)(int para1, int para2);
    float (*user_api2)(float para1, float para2);
}API_ADDRESS;

int api1(int para1, int para2)
{       
    int result=0;
	  result=para1+para2;
    return result;
}
  

float api2(float para1, float para2)
{     
    float result=0;
	  result=para1-para2;
    return result;
}

API_ADDRESS my_api_address __attribute__((section("BIN_FILE_START")))=
{
    api1,
	  api2
};

     为了实现以上目的需要用到$sct$文件，这里的工程对应的$sct$文件如下所示：

; *************************************************************
; *** Scatter-Loading Description File generated by uVision ***
; *************************************************************
 
LR_IROM 0x08000000 0x00080000
{ 
    ER_IROM 0x08000000 0x00080000  
	{ 
        *.o (RESET, +First)
       *(InRoot$$Sections)
       .ANY (+RO)
       .ANY (+XO)	   
    } 
    RW_IRAM 0x20000000 0x00008000  
	{ 
        .ANY (+RW +ZI)
    }
} 

LR_API 0x20008000 0x00008000
{ 
    ER_API 0x20008000 0x00008000 
	{ 
        *.o(BIN_FILE_START, +First)
        api.o(+RO)   
    } 
 }

     生成的两个$BIN$文件如图2所示，图2中红圈中的$BIN$文件就是$API$接口对应的$BIN$文件，这个$BIN$文件的内容如图3所示，最前面两个字的内容就是我们这里定义的两个$API$接口的函数指针。

　

图2.

　

图3.

     假设现在已经拿到了$BIN$文件并且将$BIN$文件下载到了对应的存储空间区域，此时如果需要调用$BIN$文件里面的$API$接口我们可以这样操作，定义一个指向前面定义的存储每个接口的函数指针的结构体的指针变量且赋值为$BIN$文件下载区域的起始地址（这里是地址$0x20008000$），然后对每个接口的调用就很简单了，可以像是调用普通的函数一样调用。工程在这里。

API_ADDRESS *p_my_api_address=0x20008000;
p_my_api_address->api1(1,2);
p_my_api_address->api1(10.0,2.0);