TM4C123-使用ROM中的函数库

一、前言

Many Tiva devices have portions of the peripheral driver library stored in an on-chip ROM. By using the code in the on-chip ROM, more flash is available for use by the application. The boot loader is also contained within the ROM, which can be called by an application in order to start a firmware update.

TM4C123的ROM中有peripheral driver library 和bootloader 。peripheral driver library 中存储了部分函数的实现源码以实现功能。
调用ROM中的函数可以节省flash空间。

对内存及指针定义的了解有助于深入理解编程：
关于TM4C123ROM中函数指针映射的说明，参看文章TivaWare函数指针在ROM中的映射
关于内存及寄存器地址的说明，参看文章内存及寄存器地址说明

二、调用方式

调用ROM中的函数有两种方式，直接调用和映射调用
1.Direct ROM Calls

define preprocessor symbol
可以在源码中定义或是在工程中通过预编译宏定义设置
例：#define TARGET_IS_TM4C123_RA1
#include “driverlib/rom.h”
代码中调用函数

 #define TARGET_IS_TM4C123_RA1
#include "driverlib/rom.h"
#include "driverlib/systick.h"
int
main(void)
{
ROM_SysTickPeriodSet(0x1000);
ROM_SysTickEnable();
// ...
}

2.Mapped ROM Calls
When code is intended to be shared between projects, and some of the projects run on devices with a ROM and some run on devices without a ROM, it is convenient to have the code automatically call the ROM or the flash version of the API without having #ifdef-s in the code. rom_map.h
provides an automatic mapping feature for accessing the ROM. Similar to the ROM_Function() APIs provided by rom.h, a set of MAP_Function() APIs are provided. If the function is available in ROM, MAP_Function() simply calls ROM_Function(); otherwise it calls Function().
ROM映射调用主要是考虑到代码的移植性。有的处理器可能没有相应的ROM函数库，如果使用ROM版本的函数调用，则编译时会出错。
rom_map.h 进行了#ifdef-s 定义，如下例所示：

#ifdef ROM_TimerRTCDisable
#define MAP_TimerRTCDisable                                                   \ROM_TimerRTCDisable
#else
#define MAP_TimerRTCDisable                                                   \TimerRTCDisable
#endif

当有ROM版本定义时，MAP_xx为ROM版的别名，否则为普通版的别名。
则代码中统一使用MAP_ xx 即可保证代码的移值性。

#include "driverlib/rom.h"
#include "driverlib/rom_map.h"
#include "driverlib/systick.h"
void
SetupSysTick(void)
{
MAP_SysTickPeriodSet(0x1000);
Map_SysTickEnable();
}

该代码在编译时即会处理，也起到了调用ROM中函数以节约内存的作用。同时有更灵活的移植性。