19.9

實驗3：DTC外部中斷觸發(fā)傳輸

19.9.1

硬件設(shè)計

本實驗的目標(biāo)是使用外部中斷來觸發(fā)DTC傳輸，因此需要用到一個按鍵。

外部中斷在前面已經(jīng)學(xué)過了，按鍵的硬件電路請參考前面的第16章“外部中斷”章節(jié)。

19.9.2

軟件設(shè)計

19.9.2.1

新建工程

對于e2studio開發(fā)環(huán)境：

拷貝一份我們之前的e2s工程“19_UART_Receive_Send”，然后將工程文件夾重命名為“20_DTC_External_IRQ”，最后再將它導(dǎo)入到我們的e2studio工作空間中。

對于Keil開發(fā)環(huán)境：

拷貝一份我們之前的Keil工程“19_UART_Receive_Send”，然后將工程文件夾重命名為“20_DTC_External_IRQ”，并進(jìn)入該文件夾里面雙擊Keil工程文件，打開該工程。

工程新建好之后，在工程根目錄的“src”文件夾下面新建“dtc”文件夾，再進(jìn)入“dtc”文件夾里面新建源文件和頭文件：“bsp_dtc.c”和“bsp_dtc.h”。工程文件結(jié)構(gòu)如下。

列表18：文件結(jié)構(gòu)

左右滑動查看完整內(nèi)容

20_DTC_External_IRQ
├─ ......
└─src
├─ led
│ ├─ bsp_led.c
│ └─ bsp_led.h
├─ debug_uart
│ ├─ bsp_debug_uart.c
│ └─ bsp_debug_uart.h
├─ dtc
│ ├─ bsp_dtc.c
│ └─ bsp_dtc.h
└─ hal_entry.c

19.9.2.2

FSP配置

在前面的“外部中斷”章節(jié)，相信大家已經(jīng)學(xué)會如何配置外部中斷了。這次實驗我們要使用外部中斷來觸發(fā)/激活DTC傳輸，而使用外部中斷要用到我們的按鍵。

打開該工程的FSP配置界面。我們先加入外部中斷。點到“Pins”頁面，在ICU0里面找到IRQ09，這里我們選用P004引腳（SW2按鍵連接的引腳）連接到外部中斷IRQ09

然后點到“Stacks”頁面，按照“New Stack”→“Input”→“External IRQ”的步驟添加一個ICU模塊來配置外部中斷。ICU模塊的配置可按照如下圖所示進(jìn)行配置，中斷觸發(fā)方式默認(rèn)選擇上升沿觸發(fā)，中斷優(yōu)先級設(shè)置比UART中斷大一點，設(shè)置為優(yōu)先級10。

接著我們在“Stacks”頁面繼續(xù)加入DTC模塊，按如下圖所示步驟添加。

我們按如下圖配置一下DTC：

DTC配置項（與上圖相對應(yīng)）

表8：DTC配置屬性描述

配置完成后，直接右上角點擊生成代碼。

注：讀者可能會疑惑不需要設(shè)置DTC中斷回調(diào)函數(shù)？

19.9.2.3

使用FSP配置器生成的配置

下面的是與我們之前在FSP配置界面上的配置等效的配置代碼：

列表19：代碼清單20?16與FSP配置界面上的配置等效的配置代碼

左右滑動查看完整內(nèi)容

/* FSP 配置界面的傳輸信息配置（正常傳輸模式）等效于下面 fsp_transfer_info_normal 里
的配置（除了源地址和目標(biāo)地址）
源地址和目標(biāo)地址在 FSP 配置界面設(shè)置的話不太方便，我們會在 DTC_Init 函數(shù)里設(shè)置。
關(guān)于偏移值（Offset value）和源緩沖大?。⊿ource Buffer Size），在 transfer_info_
→t 里沒有這兩項設(shè)置，建議在 FSP 配置界面設(shè)置
- 偏移值只有在地址模式是偏移模式的情況下才會用到；
- 而源緩沖大小與之相關(guān)的功能本例程不會涉及到，所以暫不考慮。
下面的 fsp_transfer_info_normal 僅作為對比參考，在本例程中是沒有用到的。
*/
//transfer_info_t fsp_transfer_info_normal =
//{
// .transfer_settings_word_b.dest_addr_mode = TRANSFER_ADDR_MODE_FIXED,?
→//每次傳輸后，目標(biāo)地址指針固定不變
// .transfer_settings_word_b.repeat_area = TRANSFER_REPEAT_AREA_
→SOURCE,//源區(qū)域重復(fù) (正常模式下無效)
// .transfer_settings_word_b.irq = TRANSFER_IRQ_END, ?
→//傳輸完成后中斷
// .transfer_settings_word_b.chain_mode = TRANSFER_CHAIN_MODE_
→DISABLED,//不使能（DMAC 沒有該功能，僅 DTC 有）
// .transfer_settings_word_b.src_addr_mode = TRANSFER_ADDR_MODE_FIXED,?
→//每次傳輸后，源地址指針固定不變
// .transfer_settings_word_b.size = TRANSFER_SIZE_2_BYTE, ?
→//每次傳輸 2 字節(jié)
// .transfer_settings_word_b.mode = TRANSFER_MODE_NORMAL, ?
→//正常傳輸模式
// .p_dest = (void *) DST_Buffer, ?
→//目標(biāo)地址
// .p_src = (void const *) SRC_Buffer,
→//源地址
// .num_blocks = 0, //指定傳輸?shù)膲K數(shù)（正常模式和重復(fù)模式下均無效，僅
塊模式下有效）
// .length = 1, //指定傳輸?shù)拈L度（即正常的傳輸次數(shù)或重復(fù)模式下重
復(fù)大小 或 塊模式下傳輸?shù)膲K大?。?//};
// 按照上述傳輸信息配置，期待的正確傳輸結(jié)果為：
uint32_tExpected_DST_Buffer[BUFFER_SIZE] = {
0x00000304,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000};

19.9.2.4

使用代碼配置：正常傳輸模式

下面是DTC在正常模式下傳輸?shù)呐渲么a：

列表20：代碼清單20?17 DTC正常傳輸模式配置

左右滑動查看完整內(nèi)容

/* 正常傳輸模式 */
transfer_info_tmy_transfer_info_normal =
{
.transfer_settings_word_b.dest_addr_mode = TRANSFER_ADDR_MODE_
→INCREMENTED,//每次傳輸后，目標(biāo)地址指針都會增加
.transfer_settings_word_b.repeat_area = TRANSFER_REPEAT_AREA_SOURCE,
→//源區(qū)域重復(fù) (正常模式下無效)
.transfer_settings_word_b.irq = TRANSFER_IRQ_END, ?
→//傳輸完成后中斷
.transfer_settings_word_b.chain_mode = TRANSFER_CHAIN_MODE_
→DISABLED,//不使能（DMAC 沒有該功能，僅 DTC 有）
.transfer_settings_word_b.src_addr_mode = TRANSFER_ADDR_MODE_
→INCREMENTED,//每次傳輸后，源地址指針都會增加
.transfer_settings_word_b.size = TRANSFER_SIZE_4_BYTE, ?
→//每次傳輸 4 字節(jié)
.transfer_settings_word_b.mode = TRANSFER_MODE_NORMAL, ?
→//正常傳輸模式
.p_dest = (void*) DST_Buffer, ?
→//目標(biāo)地址
.p_src = (voidconst *) SRC_Buffer, ?
→//源地址
.num_blocks =0,//指定傳輸?shù)膲K數(shù)（正常模式和重復(fù)模式下均無效，僅塊
模式下有效）
.length =1,//指定傳輸?shù)拈L度（即正常的傳輸次數(shù)或重復(fù)模式下重復(fù)
大小 或 塊模式下傳輸?shù)膲K大?。?};
// 按照上述傳輸信息配置，期待的正確傳輸結(jié)果為：
uint32_tExpected_DST_Buffer[BUFFER_SIZE] = {
0x01020304,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000};

19.9.2.5

使用代碼配置：重復(fù)傳輸模式

下面是DTC在重復(fù)傳輸模式下傳輸?shù)呐渲么a：

列表21：代碼清單20?18 DTC重復(fù)傳輸模式配置

左右滑動查看完整內(nèi)容

/* 重復(fù)傳輸模式 */
transfer_info_tmy_transfer_info_repeat =
{
.transfer_settings_word_b.dest_addr_mode = TRANSFER_ADDR_MODE_
→INCREMENTED,//每次傳輸后，目標(biāo)地址指針都會增加
.transfer_settings_word_b.repeat_area = TRANSFER_REPEAT_AREA_SOURCE,
→//源區(qū)域重復(fù) (正常模式下無效)
.transfer_settings_word_b.irq = TRANSFER_IRQ_EACH, ?
→//傳輸完成后中斷
.transfer_settings_word_b.chain_mode = TRANSFER_CHAIN_MODE_
→DISABLED,//不使能（DMAC 沒有該功能，僅 DTC 有）
.transfer_settings_word_b.src_addr_mode = TRANSFER_ADDR_MODE_
→INCREMENTED,//每次傳輸后，源地址指針都會增加
.transfer_settings_word_b.size = TRANSFER_SIZE_4_BYTE, ?
→//每次傳輸 4 字節(jié)
.transfer_settings_word_b.mode = TRANSFER_MODE_REPEAT, ?
→//重復(fù)傳輸模式
.p_dest = (void*) DST_Buffer, ?
→//目標(biāo)地址
.p_src = (voidconst *) SRC_Buffer, ?
→//源地址
.num_blocks =0,//指定傳輸?shù)膲K數(shù)（正常模式和重復(fù)模式下均無效，僅塊
模式下有效）
.length =2,//指定傳輸?shù)拈L度（即正常的傳輸次數(shù)或重復(fù)模式下重復(fù)
大小 或 塊模式下傳輸?shù)膲K大?。?};
// 按照上述傳輸信息配置，期待的正確傳輸結(jié)果為：
uint32_tExpected_DST_Buffer[BUFFER_SIZE] = {
0x01020304,0x05060708,0x01020304,0x05060708,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000,
0x00000000,0x00000000,0x00000000,0x00000000};

19.9.2.6

使用代碼配置：塊傳輸模式

下面是DTC在塊傳輸模式下傳輸?shù)呐渲么a：

列表22：代碼清單20?19 DTC塊傳輸模式配置

左右滑動查看完整內(nèi)容

/* 塊傳輸模式 */
transfer_info_tmy_transfer_info_block =
{
.transfer_settings_word_b.dest_addr_mode = TRANSFER_ADDR_MODE_
→INCREMENTED,//每次傳輸后，目標(biāo)地址指針都會增加
.transfer_settings_word_b.repeat_area = TRANSFER_REPEAT_AREA_SOURCE,
→//源區(qū)域重復(fù) (正常模式下無效)
.transfer_settings_word_b.irq = TRANSFER_IRQ_END, ?
→//傳輸完成后中斷
.transfer_settings_word_b.chain_mode = TRANSFER_CHAIN_MODE_
→DISABLED,//不使能（DMAC 沒有該功能，僅 DTC 有）
.transfer_settings_word_b.src_addr_mode = TRANSFER_ADDR_MODE_
→INCREMENTED,//每次傳輸后，源地址指針都會增加
.transfer_settings_word_b.size = TRANSFER_SIZE_4_BYTE, ?
→//每次傳輸 4 字節(jié)
.transfer_settings_word_b.mode = TRANSFER_MODE_BLOCK, ?
→//塊傳輸模式
.p_dest = (void*) DST_Buffer, ?
→//目標(biāo)地址
.p_src = (voidconst *) SRC_Buffer, ?
→//源地址
.num_blocks =1,//指定傳輸?shù)膲K數(shù)（正常模式和重復(fù)模式下均無效，僅塊
模式下有效）
.length = BUFFER_SIZE,//指定傳輸?shù)拈L度（即正常的傳輸次數(shù)或重復(fù)模式下重復(fù)
大小 或 塊模式下傳輸?shù)膲K大?。?};
// 按照上述傳輸信息配置，期待的正確傳輸結(jié)果為：
uint32_tExpected_DST_Buffer[BUFFER_SIZE] = {
0x01020304,0x05060708,0x090A0B0C,0x0D0E0F10,
0x11121314,0x15161718,0x191A1B1C,0x1D1E1F20,
0x21222324,0x25262728,0x292A2B2C,0x2D2E2F30,
0x31323334,0x35363738,0x393A3B3C,0x3D3E3F40,
0x41424344,0x45464748,0x494A4B4C,0x4D4E4F50,
0x51525354,0x55565758,0x595A5B5C,0x5D5E5F60,
0x61626364,0x65666768,0x696A6B6C,0x6D6E6F70,
0x71727374,0x75767778,0x797A7B7C,0x7D7E7F80};

19.9.2.7

DTC初始化函數(shù)

DTC初始化函數(shù)如下所示：

列表23：代碼清單20?20 DTC初始化函數(shù)

左右滑動查看完整內(nèi)容

/* DTC 初始化函數(shù) */
voidDTC_Init(void)
{
fsp_err_terr;
/* 使用 FSP 界面的配置：需要先重新設(shè)置傳輸?shù)脑吹刂泛湍康牡刂?*/
#ifndefUSE_MY_TRANSFER_INFOR_CONFIG
set_transfer_dst_src_address(&g_transfer_dtc_cfg, SRC_Buffer, DST_
→Buffer);
#endif
err =R_DTC_Open(&g_transfer_dtc_ctrl, &g_transfer_dtc_cfg);
assert(FSP_SUCCESS == err);
/* 使用我們新的自定義的傳輸信息：重新配置傳輸 */
#ifdefUSE_MY_TRANSFER_INFOR_CONFIG
// 根據(jù)我們要使用的傳輸模式進(jìn)行選擇配置：
#if(DTC_TRANSFER_MODE == DTC_TRANSFER_NORMAL_MODE)//正常模式
err =R_DTC_Reconfigure(&g_transfer_dtc_ctrl, &my_transfer_info_
→normal);
assert(FSP_SUCCESS == err);
#elif(DTC_TRANSFER_MODE == DTC_TRANSFER_REPEAT_MODE)//重復(fù)模式
err =R_DTC_Reconfigure(&g_transfer_dtc_ctrl, &my_transfer_info_
→repeat);
assert(FSP_SUCCESS == err);
#elif(DTC_TRANSFER_MODE == DTC_TRANSFER_BLOCK_MODE)//塊模式
err =R_DTC_Reconfigure(&g_transfer_dtc_ctrl, &my_transfer_info_block);
assert(FSP_SUCCESS == err);
#endif//DTC_TRANSFER_MODE
#endif//USE_MY_TRANSFER_INFOR_CONFIG
}

19.9.2.8

按鍵外部中斷回調(diào)函數(shù)

按鍵外部中斷回調(diào)函數(shù)如下所示：

列表24：代碼清單20?21按鍵外部中斷回調(diào)函數(shù)

左右滑動查看完整內(nèi)容

/* 按鍵按下標(biāo)志 */
volatilebool key_sw2_press =false;
/* 按鍵中斷回調(diào)函數(shù) */
voidicu_external_irq_callback(external_irq_callback_args_t *p_args)
{
/* 判斷中斷通道 */
if(9== p_args->channel)
{
key_sw2_press =true;// 按鍵 SW2 按下
}
}

19.9.2.9

hal_entry入口函數(shù)

列表25：代碼清單20?22 hal_entry.c文件

左右滑動查看完整內(nèi)容

/* 用戶頭文件包含 */
#include"led/bsp_led.h"
#include"debug_uart/bsp_debug_uart.h"
#include"dtc/bsp_dtc.h"
externconstuint32_tSRC_Buffer[BUFFER_SIZE];
externuint32_tDST_Buffer[BUFFER_SIZE];
externuint32_tExpected_DST_Buffer[BUFFER_SIZE];
externvolatilebool dtc_complete_transmission_sign;
uint8_tBufferCompare(constuint32_t*pBuffer1,constuint32_t*pBuffer2,?
→uint16_tBufferLength)
voidBufferShow_HexData(constuint32_t*pBuffer,uint16_tBufferLength);
voidhal_entry(void)
{
/*TODO:add your own code here */
uint8_tres;
LED_Init();// LED 初始化
Debug_UART4_Init();// SCI4 UART 調(diào)試串口初始化
/* 初始化 DTC */
DTC_Init();
printf("這是一個 DTC 存儲器到存儲器的傳輸實驗例程
");
printf("打開串口助手，查看接收窗口打印的相關(guān)提示信息
");
printf("按下按鍵 SW2 激活 DTC 傳輸
");
printf("觀察板載 LED 燈，本實驗使用兩個 LED 燈來指示 DTC 傳輸結(jié)果
");
printf("- DTC 數(shù)據(jù)傳輸失敗，則 LED1 亮（紅色）
");
printf("- DTC 數(shù)據(jù)傳輸成功，則 LED2 亮（藍(lán)色）
");
printf("--------------------------------------------
");
/* Open ICU module */
R_ICU_ExternalIrqOpen(&g_external_irq9_ctrl, &g_external_irq9_cfg);
/* 允許中斷 */
R_ICU_ExternalIrqEnable(&g_external_irq9_ctrl);
/* 使能 DTC 模塊 */
R_DTC_Enable(&g_transfer_dtc_ctrl);
/*************************************/
/* 使用按鍵外部中斷觸發(fā)激活 DTC 傳輸 */
/*************************************/
#ifndefUSE_MY_TRANSFER_INFOR_CONFIG
/* 根據(jù) FSP 配置界面的傳輸信息進(jìn)行傳輸 */
/* 等待激活 DTC 傳輸 */
for(uint16_ti =0; i 
");
}
else
{
/* 源數(shù)據(jù)與傳輸后數(shù)據(jù)相等時，LED1 亮（藍(lán)色），表示傳輸成功 */
LED2_ON;
printf("< 傳輸成功>
");
}
printf("
SRC:");
BufferShow_HexData(SRC_Buffer, BUFFER_SIZE);
printf("
DST:（應(yīng)與 Expected_DST 一致）");
BufferShow_HexData(DST_Buffer, BUFFER_SIZE);
printf("
Expected_DST:");
BufferShow_HexData(Expected_DST_Buffer, BUFFER_SIZE);
while(1)
{
}
#ifBSP_TZ_SECURE_BUILD
/* Enter non-secure code */
R_BSP_NonSecureEnter();
#endif
}

19.9.3

實驗現(xiàn)象

首先通過宏USE_MY_TRANSFER_INFOR_CONFIG（在bsp_dtc.h文件中）來選擇是使用我們自定義的傳輸信息，還是使用在FSP配置界面配置的傳輸信息。

其次通過宏DMAC_TRANSFER_MODE（在bsp_dtc.h文件中）來選擇不同的傳輸模式。

最后編譯工程并下載到開發(fā)板上，打開串口助手可以查看程序運行打印的提示信息。按下啟明6M5開發(fā)板上的按鍵SW2，即觸發(fā)DT傳輸。如果DTC傳輸成功，則藍(lán)色LED2亮起，如果傳輸失敗則紅色LED1亮起。