CSL学习笔记--第二章 怎么应用CSL

第二章怎么应用CSL

2.1 概述

外设可以通过CSL声明/初始化目标来进行配置，同时在你的C源代码中调用CSL函数。

2.2 应用C SL

此部分提供了一个实例来应用CSL的APIｓ，利用CSL可以有两种方式对外设编程：

1.基于寄存器配置（PER_config）：通过设置存储器映像寄存器中的全部变量来配

置外设，相对于功能参数配置，基于寄存器配置需要很少的周期和代码长度，但不会抽象。

2.功能参数配置（PER_setup）：通过参数的设置配置外设。相比于基于寄存器的配

置，功能参数配置需要更多的周期和代码的长度，但是更加抽象。

下面这个例子是基于寄存器配置说明了用CSL初始化DMA通道0并把0x3000地址上的数据复制到0x2000。

源地址：2000h

目的地址：3000h

传送长度：16个16位单字节

2.2.1 应用DMA_config() 函数

以下的实例和步骤是应用DMA_config()函数来初始化寄存器，本例用于C5509器件。

1.加载csl.h 和含有dma外设的.不同的头文件在表1.1列出。

#include

#include

// Example-specific initialization

#define N 16 // block size to transfer

#pragma DA TA_SECTION(src,”table1”)

/* scr data table address */Uint16 src[N] = {

0xBEEFu, 0xBEEFu, 0xBEEFu, 0xBEEFu,

0xBEEFu, 0xBEEFu, 0xBEEFu, 0xBEEFu,

0xBEEFu, 0xBEEFu, 0xBEEFu, 0xBEEFu,

0xBEEFu, 0xBEEFu, 0xBEEFu, 0xBEEFu

};

#pragma DA TA_SECTION(dst, ”table2”)

/* dst data table address */

Uint16 dst[N];

2.定义和初始化DMA通道配置结构体。

DMA_Config myconfig = { /* DMA configuration structure*/

DMA_DMACSDP_RMK(

DMA_DMACSDP_DSTBEN_NOBURST , /* Destination burst :?

DMA_DMACSDP_DSTBEN_NOBURST

DMA_DMACSDP_DSTBEN_BURST4

*/

DMA_DMACSDP_DSTPACK_OFF, /* Destination packing :?

DMA_DMACSDP_DSTPACK_ON

DMA_DMACSDP_DSTPACK_OFF */

DMA_DMACSDP_DST_SARAM , /* Destination selection :?

DMA_DMACSDP_DST_SARAM

DMA_DMACSDP_DST_DARAM

DMA_DMACSDP_DST_EMIF

DMA_DMACSDP_DST_PERIPH */

DMA_DMACSDP_SRCBEN_NOBURST , /* Source burst :?

DMA_DMACSDP_SRCBEN_NOBURST

DMA_DMACSDP_SRCBEN_BURST4 */

DMA_DMACSDP_SRCPACK_OFF, /* Source packing :?

DMA_DMACSDP_SRCPACK_ON

DMA_DMACSDP_SRCPACK_OFF */

DMA_DMACSDP_SRC_SARAM , /* Source selection :?

DMA_DMACSDP_SRC_SARAM

DMA_DMACSDP_SRC_DARAM

DMA_DMACSDP_SRC_EMIF

DMA_DMACSDP_SRC_PERIPH */

DMA_DMACSDP_DA TA TYPE_16BIT /* Data type :?

DMA_DMACSDP_DA TA TYPE_8BIT

DMA_DMACSDP_DA TA TYPE_16BIT

DMA_DMACSDP_DA TA TYPE_32BIT */

) /* DMACSDP */

DMA_DMACCR_RMK(

DMA_DMACCR_DSTAMODE_POSTINC, /* Destination address mode :?DMA_DMACCR_DSTAMODE_CONST

DMA_DMACCR_DSTAMODE_POSTINC

DMA_DMACCR_DSTAMODE_SGLINDX

DMA_DMACCR_DSTAMODE_DBLINDX */

DMA_DMACCR_SRCAMODE_POSTINC, /* Source address mode :?DMA_DMACCR_SRCAMODE_CONST

DMA_DMACCR_SRCAMODE_POSTINC

DMA_DMACCR_SRCAMODE_SGLINDX

DMA_DMACCR_SRCAMODE_DBLINDX */

DMA_DMACCR_ENDPROG_OFF, /* End of programmation bit :?DMA_DMACCR_ENDPROG_ON

DMA_DMACCR_ENDPROG_OFF */

DMA_DMACCR_REPEA T_OFF,/* Repeat condition :?

DMA_DMACCR_REPEA T_ON

DMA_DMACCR_REPEA T_ALWAYS

DMA_DMACCR_REPEA T_ENDPROG1

DMA_DMACCR_REPEA T_OFF */

DMA_DMACCR_AUTOINIT_OFF,/* Auto initialization bit :?

DMA_DMACCR_AUTOINIT_ON

DMA_DMACCR_AUTOINIT_OFF */

DMA_DMACCR_EN_STOP,/* Channel enable :?

DMA_DMACCR_EN_START

DMA_DMACCR_EN_STOP */

DMA_DMACCR_PRIO_LOW, /* Channel priority :?

DMA_DMACCR_PRIO_HI

DMA_DMACCR_PRIO_LOW */

DMA_DMACCR_FS_ELEMENT, /* Frame\Element Sync :?

DMA_DMACCR_FS_ENABLE

DMA_DMACCR_FS_DISABLE

DMA_DMACCR_FS_ELEMENT

DMA_DMACCR_FS_FRAME */

DMA_DMACCR_SYNC_NONE /* Synchronization control :?DMA_DMACCR_SYNC_NONE

DMA_DMACCR_SYNC_REVT0

DMA_DMACCR_SYNC_XEVT0

DMA_DMACCR_SYNC_REVTA0

DMA_DMACCR_SYNC_XEVTA0

DMA_DMACCR_SYNC_REVT1

DMA_DMACCR_SYNC_XEVT1

DMA_DMACCR_SYNC_REVTA1

DMA_DMACCR_SYNC_XEVTA1

DMA_DMACCR_SYNC_REVT2

DMA_DMACCR_SYNC_XEVT2

DMA_DMACCR_SYNC_REVTA2

DMA_DMACCR_SYNC_XEVTA2

DMA_DMACCR_SYNC_TIM1INT

DMA_DMACCR_SYNC_TIM2INT

DMA_DMACCR_SYNC_EXTINT0

DMA_DMACCR_SYNC_EXTINT1

DMA_DMACCR_SYNC_EXTINT2

DMA_DMACCR_SYNC_EXTINT3

DMA_DMACCR_SYNC_EXTINT4

DMA_DMACCR_SYNC_EXTINT5 */

) /* DMACCR */

DMA_DMACICR_RMK(

DMA_DMACICR_BLOCKIE_ON , /* Whole block interrupt enable :?DMA_DMACICR_BLOCKIE_ON

DMA_DMACICR_BLOCKIE_OFF */

DMA_DMACICR_LASTIE_ON, /* Last frame Interrupt enable :?

DMA_DMACICR_LASTIE_ON

DMA_DMACICR_LASTIE_OFF */

DMA_DMACICR_FRAMEIE_ON, /* Whole frame interrupt enable :?

DMA_DMACICR_FRAMEIE_ON

DMA_DMACICR_FRAMEIE_OFF */

DMA_DMACICR_FIRSTHALFIE_ON, /* HAlf frame interrupt enable :?

DMA_DMACICR_FIRSTHALFIE_ON

DMA_DMACICR_FIRSTHALFIE_OFF */

DMA_DMACICR_DROPIE_ON, /* Sync. event drop interrupt enable :?DMA_DMACICR_DROPIE_ON

DMA_DMACICR_DROPIE_OFF */

DMA_DMACICR_TIMEOUTIE_ON /* Time out inetrrupt enable :?DMA_DMACICR_TIMEOUTIE_ON

DMA_DMACICR_TIMEOUTIE_OFF */

), /* DMACICR */

(DMA_AdrPtr) &src, /* DMACSSAL */

0, /* DMACSSAU */

(DMA_AdrPtr)&dst, /* DMACDSAL */

0, /* DMACDSAU */

N, /* DMACEN */

1, /* DMACFN */

0, /* DMACFI */

0 /* DMACEI */

3.定义DMA_Handle 指针。当DMA通道打开时会调用DMA_open 初始化该句柄。

DMA_Handle myhDma;

void main(void) {

// .....

4.初始化CSL库。在调用CSL模块API前必须一次性初始化CSL库。

CSL_init(); /* Init CSL */

5.对于多资源外设，比如：McBSP和DMA，调用PER_open来预留资源

（McBSP_open(), DMA_open()...）。

myhDma = DMA_open(DMA_CHA0, 0);/* Open DMA Channel 0 */

默认情况下，TMS320C55xx编译器会分配说有的数据符号字地址。但对于DMA来说，期望所有的地址为字节地址，所以，你必须偏移两个地址以期实现字

地址和字节地址的匹配。

6.调用DMA_config()函数配置DMA通道。

myconfig.dmacssal =

(DMA_AdrPtr)(((Uint16)(myconfig.dmacssal)<<1)&0xFFFF);

myconfig.dmacdsal =

(DMA_AdrPtr)(((Uint16)(myconfig.dmacdsal)<<1)&0xFFFF);

myconfig.dmacssau = (((Uint32) &src) >> 15) & 0xFFFF;

myconfig.dmacdsau = (((Uint32) &dst) >> 15) & 0xFFFF;

DMA_config(myhDma, &myConfig); /* Configure Channel */

7.调用DMA_start()开始DMA传输。

DMA_start(myhDma); /* Begin Transfer */

8.等待DMA寄存器中的FRAME状态位，传输完成。

while (!DMA_FGETH(myhDma, DMACSR, FRAME)) {

;

}

9.关闭DMA通道。

DMA_close(myhDma); /* Close channel (Optional) */

}

2.3 利用CCS编译连接CSL

为了编译连接CSL，必须配置CCS IDE工程环境。按照如下步骤完成此过程：

1. 指定目标器件。（参考

2.

3.1部分）

2. 决定是用小存储器还是大存储器同时指定你所需要的CSL和RTS库。（参考2.

3.1.1）

3. 创建连接命令文件（含有特定的.csldata部分），添加文件到工程中。（参考2.3.1.2）

4. 确定是否使用内联（参考2.3.1.3）。

本章剩余部分将会提供更多关于以上各步骤的细节和解释。

注意：

对于被定义包含的文件和库，CCS将会自动按照表2-1的路径进行搜索，不需要设置选项。

表2-1 CSL目录结构

CSL构成组件... 位于目录

Libraries \c5500\csl\lib

Source Library \c5500\csl\lib

Include files \c5500\csl\include

Examples \examples\\csl

Documentation \docs

2.3.1 指定目标器件

按照以下的步骤指定目标器件的配置：

1.在CCS中，选择Project →Options.

2.在Build Options对话框中，选择Compiler标签（参见图2-1）

3.在Category 列表中选中Preprocessor.

4.在Define Symbols处,输入一个支持的器件代号。器件代号见第一章1-5中的表1-2。

5.点击OK

图2-1 定义目标器件

2.3.1.1 大/小存储器模型选择

应用CSL要求所有的数据驻留在存储器的64K（Page0）基地址中，这是为了实现小数据存储模型的实现。

在编译器中通过设置所有的XAR寄存器来初始指向在内存中.bss段所在处区域可以实现小存储模型页面的独立性。当C环境引导入口_c_int00被执行后，以上过程才会完成。编译器接着会利用ARx寻址所有的数据存取，保持没有被影响的XARx的上部分。

由于CSL是由C语言编写的，它要依赖于编译器来执行数据/外设存储器的存取来读写外设和CPU寄存器。所以在小存储器数据存储模型下，所有的外设/CPU寄存器都可以通过ARx的寻址来存取。因为外设控制寄存器和CPU状态寄存器分别驻留在I/O和数据空间基本的64K空间内，这在利用CSL的小模型编译时会迫使所有的数据进入存储器的Page0。

注意这个问题只是在小模式下才会有，在用到大模式时没有此限制。

如果你利用任何大模式库时，按照下面步骤定义编译器的-ml项和连接大存储器模式实时库（rts55x.lib）：

1.在CCS中，选择Project →Options.

2.在Build Options对话框中，选择Compiler标签(表2-2)

3.在Category 列表中选中advanced.

4.选择Use Large memory model (-ml).

5.点击OK

表2-2 定义大存储器模式

之后还必须指定在工程中连接到的CSL和RTS库。

1. 在CCS中选择Project →Options.

2. 在Build Options对话框中选择Linker标签(见表2?3).

3. 在Category列表中选择Basic.

4. 在Library search Path field (-l)填入\c5500\csl\lib (由CCS自动分配)

5. 在Include Libraries (-l) field, 填入页1-5中表1-2中列出的正确的库

6.例如，如果你使用的是5510器件，输入 csl5510.lib 或者相近的csl5510x.lib，另外，还必须包含相应的rts55.lib或者rts55x.lib编译器实时支持库。

7.点击OK。

表2-3 定义库路径

2.3.1.2 创建链接器命令文件

CSL的连接器命令文件有两个要求：

1.必须分配.csldata段。

CSL创建.csl数据段来维护同配置数据一起实现功能的全局数据，你必须将此段分配在基本的64K地址空间。

2. 必须在高速缓存区保留0x7b地址

CSL用到数据空间的0x7b地址作为指向.csldata段的指针，它在执行CSL_init()时被初始化，所以，你必须在调用其他任何CSL函数前调用CSL_init()，覆盖0x7b 会引起CSL函数失效。

例2-1 应用链接器命令文件

|-——————————————————————————————————| MEMORY

{

PROG0: origin = 8000h, length = 0D000h

PROG1: origin = 18000h, length = 08000h

DA TA: origin = 1000h, length = 04000h

}

SECTIONS

{

.text > PROG0

.cinit > PROG0

.switch > PROG0

.data > DA TA

.bss > DA TA

.const > DA TA

.sysmem > DA TA

.stack > DA TA

.csldata > DA TA

table1 : load = 6000h

table2 : load = 4000h

} |——————————————————————————————————| 2.3.1.3 使用函数内联

由于一些CSL函数很短（它们可能仅仅被设置成单独位），而使得一个C函数调用的开销不总是必要的。如果启用了内联，CSL会把这些函数声明为静态内联，以期提升代码效率。