CSL概述(翻译总结自TI官方文档)

时间:2022-05-31 12:30:45

一、简单介绍

  CSL是函数,宏和符号常数的集合,用来控制和配置片上外设。(Chip Support Library)

  每一个外设都有自己对应的CSL模块。每个模块有自己的支持符,来表示对于给定的设备,该模块是否被支持。比如若当前的设备支持DMA模块,则_DMA_SUPPORT为1,否则为0。表1-1为各CSL模块的介绍、头文件、模块支持符。

CSL概述(翻译总结自TI官方文档)

  表1-2为CSL支持的C5000系列的设备、每个设备对应的库文件(分小存储模式和大存储模式)和每个设备的设备支持符(在CCS中设置编译选项时使用)。

CSL概述(翻译总结自TI官方文档)

二、命名规则

CSL中函数、宏和数据类型的命名规则如表1-3所示。

CSL概述(翻译总结自TI官方文档)

三、数据类型

CSL的数据类型定义于stdinc.h文件中,如表1-4所示。数据类型均以大写字母开头。

CSL概述(翻译总结自TI官方文档)

四、函数

CSL中常用的函数如表1-5所示。[handle]只用于基于句柄的外设:DAT,DMA,MCBSP和TIMER。[priority]只用于DAT外设。

CSL概述(翻译总结自TI官方文档)

使用CSL函数对外设进行编程有两种方法:

1.PER_config() 函数。直接对寄存器初始化。

初始化一个外设的所有寄存器。如例1-1所示。

CSL概述(翻译总结自TI官方文档)

2.PER_setup() 函数。使用函数参数进行初始化。PER_setup()是基于参数的函数中最常用的,其他特定模块中的此类函数有PLL_setFreq()和ADC_setFreq()等。

CSL概述(翻译总结自TI官方文档)

五、CSL中的宏

PER:外设

REG:寄存器

REG#:带通道号的寄存器

FIELD:字段

regval:寄存器的值[整数,整型变量,符号常数PER_REG_DEFAULT,宏值PER_REG_RMK()](MK表示make)

fieldval:字段的值[整数,整型变量,符号常数PER_REG_FIELD_SYMVAL,宏值PER_FMK()]

CSL概述(翻译总结自TI官方文档)

CSL概述(翻译总结自TI官方文档)

上表中使用REG#来标识该寄存器属于哪一个通道。除此之外,还可以使用句柄来标识。如表1-7所示。

CSL概述(翻译总结自TI官方文档)

六、CSL中符号化的常数

功能:便于在程序中数值的初始化

SYMVAL:寄存器字段的符号化的值。

CSL概述(翻译总结自TI官方文档)

七、CSL中句柄的使用

  句柄用于多通道的外设中。

  PER_open 函数以通道号或者端口号作为形参,返回一个指向句柄的指针。首先检查in_use标志位,当该通道或者端口可用时,返回该外设预定义的句柄,否则返回的是无效句柄INV(符号化的常数)。

  PER_close 函数释放该通道或者端口以供其他进程使用,并清零in_use标志位。

步骤:

1.首先定义一个句柄对象:DMA_Handle = myDma;

2.通过调用PER_open函数给句柄赋值:

myDma = DMA_open(DMA_CHA0,DMA_OPEN_RESET);

3.然后此句柄可以用于其他的API函数中:

DMA_start(myDma);

...

DMA_close(myDma);