第21章_瑞萨MCU零基础入门系列教程之事件链接控制器ELC

本教程基于韦东山百问网出的 DShanMCU-RA6M5开发板 进行编写,需要的同学可以在这里获取: https://item.taobao.com/item.htm?id=728461040949

配套资料获取:https://renesas-docs.100ask.net

瑞萨MCU零基础入门系列教程汇总: https://blog.csdn.net/qq_35181236/article/details/132779862


第21章 事件链接控制器ELC

本章目标

  • 了解ELC基本概念和RA6M5处理器的ELC模块;
  • 学会使用RASC配置ELC链接不同外设,并触发设备工作;

21.1 ELC简介

21.1.1 ELC的特征

ELC:Event Link Controller,事件链接控制器。它用于链接芯片上两个不同的外设,通过外设A的某个中断事件触发外设B去执行某个动作,这个过程是通过芯片内部硬件信号的连接完成的,不需要占用CPU资源。因而ELC可以帮助开发者完成许多同步触发的工作,而不会引起CPU资源的过多浪费。

ELC支持的事件类型多达219种。当产生了一个ELC事件的时候,也可以触发激活DTC功能。

21.1.2 ELC的系统框图

ECL的系统框图如下图所示:

  1. 事件控制器

  2. ELC相关寄存器:用户可以配置和观察这些寄存器来调试ELC。

  3. ELC支持连接的事件:并不是所有的中断事件都能够用于ELC,只有框图中显示的这些中断事件可以。

1.1.1 支持的事件

ELC支持互相连接触发的外设模块见下表:

  • 外部中断IRQ触发定时器GPT开始计数;
  • 定时器开始计数后,当计数溢出事件产生时,同步触发ADC转换和CTSU的测量模式;
  • 串口中断触发DTC开启数据传输;

这所有的触发操作都是无需CPU干预处理。

21.2 ELC模块的配置

21.2.1 配置ELC模块

ELC本身只是一个连接控制器,不涉及双方设备的设置。具体模块的触发条件,需要去设置该模块。因而在RASC中,ELC的配置很简单,只需要在FSP的“Stacks”中添加ELC的Stack即可,无需额外配置,如下图所示:

击“New Stack”后在“System”中找到“Event Link Controller(r_elc)”添加ELC模块即可(在用户代码里,再去打开、使能它即可)。

对于ELC的Stack配置,只能设置它的名字(使用默认值即可):

21.2.2 配置信息解读

使用RASC配置ELC并生成代码后,在common_data.c中生成一个elc_instance_t结构体类型的全局变量g_elc,它包括ELC控制参数成员、ELC配置信息、ELC控制接口成员。代码如下:

const elc_instance_t g_elc = {.p_ctrl = &g_elc_ctrl,.p_api  = &g_elc_on_elc,.p_cfg  = &g_elc_cfg
};
  • g_elc_ctrl:elc_instance_ctrl_t结构体类型,表明ELC的状态,原型如下:
typedef struct st_elc_instance_ctrl
{uint32_t     open;void const * p_context;
} elc_instance_ctrl_t;
  • g_elc_on_elc:ELC的控制接口,elc_api_t结构体指针,指向g_elc_on_elc结构体。g_elc_on_elc在r_elc.c中实现:
const elc_api_t g_elc_on_elc =
{.open                  = R_ELC_Open,.close                 = R_ELC_Close,.softwareEventGenerate = R_ELC_SoftwareEventGenerate,.linkSet               = R_ELC_LinkSet,.linkBreak             = R_ELC_LinkBreak,.enable                = R_ELC_Enable,.disable               = R_ELC_Disable,
};

这些控制API将会在下一小节进行介绍讲解。

  • g_elc_cfg:ELC的控制配置信息,它是elc_cfg_t结构体指针,此结构体原型如下:
typedef struct st_elc_cfg
{elc_event_t const link[ELC_PERIPHERAL_NUM]; ///< Event link register (ELSR) settings
} elc_cfg_t;

此结构体在elc_data.c中生成,以本章外部中断触发定时器开始计数为例,生成的列表内容如下:

const elc_cfg_t g_elc_cfg = {.link[ELC_PERIPHERAL_GPT_A] = ELC_EVENT_ICU_IRQ6, /* ICU IRQ6 (External pin interrupt 6) */.link[ELC_PERIPHERAL_GPT_B] = ELC_EVENT_ICU_IRQ1, /* ICU IRQ1 (External pin interrupt 1) */.link[ELC_PERIPHERAL_GPT_C] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_GPT_D] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_GPT_E] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_GPT_F] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_GPT_G] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_GPT_H] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_ADC0] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_ADC0_B] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_ADC1] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_ADC1_B] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_DAC0] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_DAC1] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_IOPORT1] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_IOPORT2] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_IOPORT3] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_IOPORT4] = ELC_EVENT_NONE, /* No allocation */.link[ELC_PERIPHERAL_CTSU] = ELC_EVENT_NONE, /* No allocation */
};
  • 第02行:IRQ6触发ELC_GPTA类事件;
  • 第03行:IRQ1触发ELC_GPTB类事件;

ELC_GPT_A~H是指ELC允许的GPT事件类型名称,如下表所示:

21.2.3 API接口及其使用

在上一小节已经了解到ELC的控制接口,其原型是elc_api_t结构体,如下:

typedef struct st_elc_api
{fsp_err_t (* open)(elc_ctrl_t * const p_ctrl, elc_cfg_t const * const p_cfg);fsp_err_t (* close)(elc_ctrl_t * const p_ctrl);fsp_err_t (* softwareEventGenerate)(elc_ctrl_t * const p_ctrl, elc_software_event_t event_num);fsp_err_t (* linkSet)(elc_ctrl_t * const p_ctrl, elc_peripheral_t peripheral, elc_event_t signal);fsp_err_t (* linkBreak)(elc_ctrl_t * const p_ctrl, elc_peripheral_t peripheral);fsp_err_t (* enable)(elc_ctrl_t * const p_ctrl);fsp_err_t (* disable)(elc_ctrl_t * const p_ctrl);
} elc_api_t;

本小节就对这些操作API进行一一介绍讲解。

  1. 打开ELC设备
fsp_err_t (* open)(elc_ctrl_t * const p_ctrl, elc_cfg_t const * const p_cfg);
  • p_ctrl:elc_ctrl_t结构体类型,此结构体实际上是void类型,实际会指向elc_instance_ctrl_t结构体全局变量g_elc_ctrl;
  • p_cfg:elc_cfg_t结构体类型,实际会指向elc_cfg_t全局常量g_elc_cfg;

open函数的主要功能就是将事件连接列表的设置值,用来初始化ELC模块。可以参考以下代码来初始化ELC设备:

fsp_err_t err = g_elc.p_api->open(g_elc.p_ctrl, g_elc.p_cfg);
if(FSP_SUCCESS != err)
{printf("Function:%s\tLine:%d\r\n", __FUNCTION__, __LINE__);return;
}
  1. 关闭ELC设备
fsp_err_t (* close)(elc_ctrl_t * const p_ctrl);

关闭ELC函数实现的功能比较简单,就是将代表ELC的状态成员变量设置为CLOSED,并且失能ELC设备:

/* Set state to closed */
p_instance_ctrl->open = ELC_CLOSED;/* Globally disable the operation of the Event Link Controller */
R_ELC->ELCR = ELC_ELCR_ELCON_DISABLE;
  1. 使能和失能ELC功能
fsp_err_t (* enable)(elc_ctrl_t * const p_ctrl);
fsp_err_t (* disable)(elc_ctrl_t * const p_ctrl);

只有在使能了ELC的情况下,外设模块的事件触发才能生效。而使能、失能ELC实际上就是对ELC的ELCR寄存器进行控制:

/* Globally enable ELC function */
R_ELC->ELCR = ELC_ELCR_ELCON_ENABLE;/* Globally disable ELC function */
R_ELC->ELCR = ELC_ELCR_ELCON_DISABLE;
  1. 设置事件链接
fsp_err_t (* linkSet)(elc_ctrl_t * const p_ctrl, elc_peripheral_t peripheral, elc_event_t signal);

在初始化设置列表之后,如果要额外添加事件,可以使用这个API。支持的外设列表在r_elc_api.h中的elc_peripheral_t枚举中定义,支持的事件信号类型在bsp_elc.h中的elc_event_t枚举定义。

用户可以参考以下代码使用这个函数:

fsp_err_t err = R_ELC_LinkSet(&g_elc_ctrl, ELC_PERIPHERAL_DAC0, ELC_EVENT_ICU_IRQ10);
if(FSP_SUCCESS != err)
{printf("Function:%s\tLine:%d\r\n", __FUNCTION__, __LINE__);return;
}
  1. 断开事件链接
fsp_err_t (* linkBreak)(elc_ctrl_t * const p_ctrl, elc_peripheral_t peripheral);

断开连接只需要传入需要断开连接的设备序号即可。

  1. 件触发产生事件
fsp_err_t (* softwareEventGenerate)(elc_ctrl_t * const p_ctrl, elc_software_event_t event_num);

ELC支持的软件触发事件只有两种,在r_elc_api.h中定义的elc_software_event_t枚举类型里列出了这2种事件:

typedef enum e_elc_software_event
{ELC_SOFTWARE_EVENT_0,              ///< Software event 0ELC_SOFTWARE_EVENT_1,              ///< Software event 1
} elc_software_event_t;

21.3 外部中断触发GPT启停

本实验会使用到按键外部中断、串口的printf和GPT,请读者阅读前面的章节参考配置相关外设模块。

21.3.1 设计目的

使用两个外部中断来触发GPT定时器计数的开始和停止,让用户了解ELC的使用方法。

21.3.2 模块配置

  1. 外部中断

外部中断在FSP的“Pins”中选好ICU的引脚后,配置各自的Stack如下图示:

本次实验选用的外部中断是IRQ1和IRQ6,使用的引脚是P205和P000。通过ELC使用IRQ触发GPT计数,是通过内部硬件的信号连接来实现的,所以不需要使用外部中断的中断服务函数及其中断回调函数。

  1. LC外设

在前文已经说明,ELC的配置除了模块名称外,并不需要做额外配置。

  1. GPT定时器

GPT定时器的配置除了通道、周期值、计数类型等常规配置如下图所示:

本章的实验还需要配置GPT模块的Input项中关于开启计数触发源和停止计数触发源的设置:

对于开启触发源和停止触发源,里面的可选项是一样的,本次实验使用IRQ6触发定时器开始计数,使用IRQ1触发定时器停止计数,因而“Start Source”和“Stop Source”的配置如下图所示:

image12

21.3.3 驱动程序

  1. 外部中断

外部中断IRQ信号会直接链接触发GPT,因而只需要在RASC中配置IRQ模块,不需要在代码中初始化IRQ。

  1. GPT初始化函数

对于GPT的初始化,只需要调用open、enable函数指针:

void GPTDrvInit(void)
{{fsp_err_t err = g_timer0.p_api->open(g_timer0.p_ctrl, g_timer0.p_cfg);if(FSP_SUCCESS != err)printf("Function:%s\tLine:%d\r\n", __FUNCTION__, __LINE__);}{fsp_err_t err = g_timer0.p_api->enable(g_timer0.p_ctrl);if(FSP_SUCCESS != err)printf("Function:%s\tLine:%d\r\n", __FUNCTION__, __LINE__);}
}

瑞萨对于GPT的enable函数解释是:“Enables external event triggers that start, stop, clear, or capture the counter.”,也就是使能外部中断事件触发计数器的开始、停止、清除和捕获。

  1. GPT中断回调函数和溢出等待函数

GPT的中断回调函数,只是设置一个溢出标志值,函数代码如下:

static volatile bool gGPTOverflow = false;
/* Callback function */
void gpt_timer0_callback(timer_callback_args_t *p_args)
{/* TODO: add your own code here */if(p_args->event == TIMER_EVENT_CYCLE_END)gGPTOverflow = true;
}void GPTDrvWaitOverflow(void)
{while(!gGPTOverflow);gGPTOverflow = false;
}
  1. ELC初始化函数

对于ELC的初始化,只需要调用open、enable函数指针,代码如下:

void ELCDrvInit(void)
{{fsp_err_t err = g_elc.p_api->open(g_elc.p_ctrl, g_elc.p_cfg);if(FSP_SUCCESS != err){printf("Function:%s\tLine:%d\r\n", __FUNCTION__, __LINE__);return;}}{fsp_err_t err = g_elc.p_api->enable(g_elc.p_ctrl);if(FSP_SUCCESS != err){printf("Function:%s\tLine:%d\r\n", __FUNCTION__, __LINE__);return;}}
}`

21.3.4 测试程序

本次实验的测试程序比较简单,每次GPT计数溢出后就计数一次,串口将计数值打印,代码如下:

void ELCAppTest(void)
{ELCDrvInit();UARTDrvInit();GPTDrvInit();printf("\r\nStart ELC Test!\r\n");uint32_t tick = 0;while(1){GPTDrvWaitOverflow();printf("Tick: %d\r", (int)tick++);}
}

21.3.5 测试结果

在hal_entry.c中的hal_entry()函数中调用测试函数,将编译出来的二进制文件烧写到板子上运行。按下开发板的按键后,就会触发开启定时器开始计数,将开发板的P205引脚和GND短接后就会触发定时器停止计数:


本章完

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.hqwc.cn/news/108507.html

如若内容造成侵权/违法违规/事实不符,请联系编程知识网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

TableConvert-免费在线表格转工具 让表格转换变得更容易

在线表格转工具TableConvert TableConvert 是一个基于web的免费且强大在线表格转换工具&#xff0c;它可以在 Excel、CSV、LaTeX 表格、HTML、JSON 数组、insert SQL、Markdown 表格 和 MediaWiki 表格等之间进行互相转换&#xff0c;也可以通过在线表格编辑器轻松的创建和生成…

A股风格因子看板 (2023.09 第03期)

该因子看板跟踪A股风格因子&#xff0c;该因子主要解释沪深两市的市场收益、刻画市场风格趋势的系列风格因子&#xff0c;用以分析市场风格切换、组合风格暴露等。 今日为该因子跟踪第03期&#xff0c;指数组合数据截止日2023-08-31&#xff0c;要点如下 近1年A股风格因子检验统…

第四范式通过聆讯,AI上市公司将再添薪火

四次递表之后&#xff0c;估值超过200亿元的AI独角兽第四范式近日如愿通过港交所聆讯&#xff0c;即将成为资本市场AI皇冠上的又一颗明珠。 第四范式成立于2014年&#xff0c;历经11轮融资&#xff0c;不仅股东阵容豪华&#xff0c;也在商业化层面进展可观。今年4月底&#xf…

华为云云耀云服务器L实例评测|老用户回归的初印象

华为云云耀云服务器L实例评测&#xff5c;老用户回归的初印象 前言一、新面孔1. 云耀云服务器2. 服务器特色 二、上手感官体验1. 性价比感受2. 推荐宝塔面板3. CloudShell登录4. 安全性 总结 前言 其实笔者接触华为云已经很久了&#xff0c;第一次使用的云服务器就是华为云。当…

【计算机网络】什么是WebSocket?

目录 WebSocket简介协议优点使用场景 WebSocket WebSocket是一种网络传输协议,可在单个TCP连接上进行全双工通信&#xff0c;位于OSI模型的应用层。 WebSocket使得客户端和服务器之间的数据交换变得更加简单&#xff0c;允许服务器主动向客户端推送数据。在WebSocket API中&a…

电脑死机的时候,CPU到底在做什么?

电脑死机&#xff0c;应该每个接触计算机的小伙伴都经历过吧。 尤其是早些年&#xff0c;电脑配置还没现在这么高的时候&#xff0c;多开几个重量级应用程序&#xff0c;死机就能如约而至&#xff0c;就算你把键盘上的CTRLALTDELETE按烂了&#xff0c;任务管理器也出不来&…

[移动通讯]【Carrier Aggregation-4】【LTE-4】

前言&#xff1a; 推荐两个在线工具 UECapabilityInformation Decoder: https://www.sqimway.com/ue_capa.php FGI Decoder: http://howltestuffworks.blogspot.com/2016/11/lte-feature-group-indicators-decoder.html 参考&#xff1a; 载波聚合&#xff08;CA&#xff09;…

PyTorch实战-实现神经网络图像分类基础Tensor最全操作详解(二)

前言 PyTorch可以说是三大主流框架中最适合初学者学习的了&#xff0c;相较于其他主流框架&#xff0c;PyTorch的简单易用性使其成为初学者们的首选。这样我想要强调的一点是&#xff0c;框架可以类比为编程语言&#xff0c;仅为我们实现项目效果的工具&#xff0c;也就是我们…

SeaArt.ai: 海艺AI绘画艺术图片模型创作平台

【产品介绍】 • 名称 SeaArt.ai • 具体描述 SeaArt.ai是一个基于人工智能技术的AI绘画工具&#xff0c;它可以根据你的描述或者关键词来生成符合你想象的图片。你可以选择不同的模式来创建不同类型的图片&#xff0c;比如人物、风景、建筑、神话、自…

【Spring】手动实现Spring底层机制-问题的引出

&#x1f384;欢迎来到边境矢梦的csdn博文&#x1f384; &#x1f384;本文主要梳理手动实现Spring底层机制-问题的引出 &#x1f384; &#x1f308;我是边境矢梦&#xff0c;一个正在为秋招和算法竞赛做准备的学生&#x1f308; &#x1f386;喜欢的朋友可以关注一下&#x1…

TypeScript类型兼容:结构化类型

&#x1f3ac; 岸边的风&#xff1a;个人主页 &#x1f525; 个人专栏 :《 VUE 》 《 javaScript 》 ⛺️ 生活的理想&#xff0c;就是为了理想的生活 ! 目录 1. 鸭子类型&#xff1a;定义和示例 2. 鸭子类型的优点 2.1 代码的灵活性 2.2 代码的复用 2.3 与 JavaScript 的…

Revit SDK 介绍:TypeRegeneration 修改类型,更新文档 ValidateParameters 参数合法性验证

前言 这篇文章介绍两个例子&#xff0c;逻辑比较简单&#xff1a; TypeRegeneration 修改类型&#xff0c;更新文档ValidateParameters 参数合法性验证 内容 TypeRegeneration FamilyType 不是继承自 Element 的&#xff0c;而是独立于 Element 体系之外&#xff0c;直接从…