很强大!低耦合高内聚的MCU实用软件框架
大家好,我是晓宇,不知道大家有没有听过软件设计中的低耦合,高内聚的两个原则。
具体是什么意思呢?
在一个项目中:每个模块之间相联系越紧密,则耦合性越高;这样你改动其中一个模块,其他模块也需要一起改动,换言之:牵一发而动全身。
一个模块内部各个元素之间的联系的紧密程度,如果各个元素(语句、程序段)之间的联系程度越高,则内聚性越高,也就是高内聚。
如果一个程序的逻辑处理部分,分散到好几个文件中,那么每次改动,就会改动好几个文件,这就是高耦合。
高耦合,低内聚
低耦合,高内聚
现在的软件结构设计,都会要求“低耦合,高内聚”,来保证软件的高质量,提高软件的可维护性。
下面是一个低耦合高内聚的一种无OS的MCU实用软件框架。
包括任务轮询管理,命令管理器、低功耗管理、环形缓冲区等实用模块。系统中广泛利用自定义段技术减少各个模块间的耦合关系,大大提供程序的可维护性。
主要功能
支持模块自动化管理,并提供不同优先等级初始化声明接口。
支持任务轮询管理,通过简单的宏声明即可实现,不需要复杂的声明调用。
支持低功耗管理,休眠与唤醒通知。
支持命令行解析,命令注册与执行。
blink设备支持,统一管理LED、震动马达、蜂鸣器
使用说明
完整的代码可以参考工程文件,系统开发平台如下:
MCU:STM32F401RET6
IDE:IAR 7.4或者Keil MDK 4.72A
任务初始化及任务轮询管理
使用此模块前需要系统提供滴答定时器,用于驱动任务轮询作业。(参考platform.c)
//定时器中断(提供系统滴答)
void SysTick_Handler(void)
{systick_increase(SYS_TICK_INTERVAL); //增加系统节拍
}
注册初始化入口及任务(参考自key_task.c)
static void key_init(void)
{/*do something*/
}static void key_scan(void)
{/*do something*/
}module_init("key", key_init); //注册按键初始化接口
driver_register("key", key_scan, 20); //注册按键任务(20ms轮询1次)
命令管理器(cli)
适用于在线调试、参数配置等(参考使用cli_task.c),用户可以通过串口输出命令行控制设备行为、查询设备状态等功能。
命令格式
cli支持的命令行格式如下:
<cmd name> < param1> < param2> < paramn> < \r\n > <cmd name> ,< param1>, < param2>, < paramn>, < \r\n >
每行命令包含一个命令名称+命令参数(可选),命令名称及参数可以通过空格或者','进行分隔。
系统默认命令
cli系统自带了2条默认命令,分别是"?"与"help"命令,输入他们可以列出当前系统包含的命令列表,如下所示:
? - alias for 'help'
help - list all command.
pm - Low power control command
reset - reset system
sysinfo - show system infomation.
适配命令管理器
完整的例子可以参考cli_task.c
static cli_obj_t cli; /*命令管理器对象 *//* * @brief 命令行任务初始化* @return none*/
static void cli_task_init(void)
{cli_port_t p = {tty.write, tty.read}; /*读写接口 */cli_init(&cli, &p); /*初始化命令行对象 */cli_enable(&cli);cli_exec_cmd(&cli,"sysinfo"); /*显示系统信息*/
}/* * @brief 命令行任务处理* @return none*/
static void cli_task_process(void)
{cli_process(&cli);
}module_init("cli", cli_task_init);
task_register("cli", cli_task_process, 10); /*注册命令行任务*/
命令注册
以复位命令为例(参考cmd_devinfo.c):
#include "cli.h"
//...
/* * @brief 复位命令*/
int do_cmd_reset(struct cli_obj *o, int argc, char *argv[])
{NVIC_SystemReset();return 0;
}cmd_register("reset",do_cmd_reset, "reset system");
低功耗管理器(pm)
控制间歇运行,降低系统功耗。其基本的工作原理是通过轮询系统中各个模块是否可以允许系统进入低功耗。实际上这是一种判决机制,所有模块都具有有票否决权,即只要有一个模块不允许休眠,那么系统就不会进入休眠状态。pm模块在休眠前会统计出各个模块会返回最小允许休眠时长,并以最小休眠时长为单位进行休眠。
如何适配
使用前需要通过pm_init进行初始化适配,并提供当前系统允许的最大休眠时间,进入休眠的函数接口,基本的接口定义如下:
/*低功耗适配器 ---------------------------------------------------------*/
typedef struct {/*** @brief 系统最大休眠时长(ms)*/ unsigned int max_sleep_time;/*** @brief 进入休眠状态* @param[in] time - 期待休眠时长(ms)* @retval 实际休眠时长* @note 休眠之后需要考虑两件事情,1个是需要定时起来给喂看门狗,否则会在休眠* 期间发送重启.另外一件事情是需要补偿休眠时间给系统滴答时钟,否则会* 造成时间不准。*/ unsigned int (*goto_sleep)(unsigned int time);
}pm_adapter_t;
void pm_init(const pm_adapter_t *adt);void pm_enable(void);void pm_disable(void);void pm_process(void);
完成的使用例子可以参考platform-lowpower.c,默认情况下是禁用低功耗功能的,读者可以去除工程中原来不带低功耗版本的platform.c,并加入platform-lowpower.c文件进行编译即可使用。
注册低功耗设备
以按键扫描为例,正常情况下,如果按键没有按下,那么系统休眠可以进入休眠状态,对按键功能是没有影响的。如果按键按下时,那么系统需要定时唤醒并轮询按键任务。所以在一个低功耗系统下,为了不影响按键实时性需要处理好两个事情:
系统休眠状态下,如果有按键按下,那系统系统应立即唤醒,以便处理接下来的扫描工作。
如果按键按下时,系统可以进入休眠,但需要定时唤醒起来轮询按键任务。对于第一种情况,将按键配置为边沿中断唤醒即可,以STM32F4为例(参考key_task.c),它支持外部中断唤醒功能。
/* * @brief 按键 io初始化* PC0 -> key;* @return none*/
static void key_io_init(void)
{/* Enable GPIOA clock */RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE);gpio_conf(GPIOC, GPIO_Mode_IN, GPIO_PuPd_UP, GPIO_Pin_0);//低功耗模式下,为了能够检测到按键,配置为中断唤醒RCC_APB2PeriphClockCmd(RCC_APB2Periph_SYSCFG, ENABLE);SYSCFG_EXTILineConfig(EXTI_PortSourceGPIOC, EXTI_PinSource0);exti_conf(EXTI_Line0, EXTI_Trigger_Falling, ENABLE);nvic_conf(EXTI0_IRQn, 0x0F, 0x0F);key_create(&key, readkey, key_event); /*创建按键*/
}
对于第二种情况,可以通过pm_dev_register来处理,当系统请求休眠时,如果此时按键按下,则返回下次唤醒时间即可,如下面的例子所示。
//参考key_task.c
#include "pm.h"
/** @brief 休眠通知*/
static unsigned int key_sleep_notify(void)
{return key_busy(&key) || readkey() ? 20 : 0; /* 非空闲时20ms要唤醒1次*/
} pm_dev_register("key", NULL, key_sleep_notify, NULL);
blink模块
具有闪烁特性(led, motor, buzzer)的设备(led, motor, buzzer)管理 使用步骤:
需要系统提供滴答时钟,blick.c中是通过get_tick()接口获取,依赖module模块
需要在任务中定时进行轮询
或者通过"module"模块的任务注册来实现
task_register("blink", blink_dev_process, 50); //50ms轮询1次
LED驱动
blink_dev_t led; //定义led设备/**@brief 红色LED控制(GPIOA.8)*@param[in] on - 亮灭控制*/
static void led_ctrl(int on)
{if (on)GPIOA->ODR |= (1 << 8);else GPIOA->ODR &= ~(1 << 8);
}/**@brief led初始化程序*/
void led_init(void)
{led_io_init(void); //led io初始化blink_dev_create(&led, led_ctrl); //创建led设备blink_dev_ctrl(&led, 50, 100, 0); //快闪(50ms亮, 100ms灭)
}
按键管理模块
类似blink模块,使用之前有两个注意事项:
需要系统提供滴答时钟,key.c中是通过get_tick()接口获取,依赖module模块
需要在任务中定时进行轮询
key_t key; //定义按键管理器/**@brief 按键事件*@param[in] type - 按键类型(KEY_PRESS, KEY_LONG_DOWN, KEY_LONG_UP) *@param[in] duration - 长按持续时间*/
void key_event(int type, unsigned int duration)
{if (type == KEY_PRESS) { //短按} else if (type == KEY_LONG_DOWN) { //长按}
} //读取键值(假设按键输出口为STM32 MCU PA8)
int read_key(void)
{return GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_8) == Bit_RESET;
}/**@brief 按键初始化*/
void key_init(void)
{//打开GPIO 时钟RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE);//配置成输入模式gpio_conf(GPIOA, GPIO_Mode_IN, GPIO_PuPd_NOPULL, GPIO_Pin_8); //创建1个按键key_create(&key, read_key, key_event);
}
开源地址:https://gitee.com/moluo-tech/CodeBrick
来源:小麦大叔
很强大!低耦合高内聚的MCU实用软件框架相关推荐
- 详解高耦合低内聚,低耦合高内聚
什么是高耦合低内聚,低耦合高内聚 耦合:不就是耦合系数高与低吗,就是关联性强不强 内聚:内聚是指是不是具有很强的功能性,一个模块或方法是不是只干一件事,越强的内聚或者高内聚模块应当恰好只做一件事. 用 ...
- 程序开发之——低耦合高内聚
内聚概念 内聚性,又称块内联系.指模块的功能强度的度量,即一个模块内部各个元素彼此结合的紧密程度的度量. 内聚性是对一个模块内部各个组成元素之间相互结合的紧密程度的度量指标.模块中组成元素结合的越紧密 ...
- c语言如何实现高内聚低耦合_如何实现高内聚低耦合?高内聚低耦合的现实例子...
下面要给大家分享的是一个高内聚低耦合例子,那么编程应该如何实现高内聚低耦合呢?一起来看看下面的实例吧! 案例: 在一个学校里面,有着老师若干名,依次编号. 有学生若干名,依次编号. 现在的话,是要求要 ...
- Java中的低耦合高内聚法则
java框架模式_低耦合高内聚法则 定义:一个对象应该对其他对象保持最少的了解. 问题由来:类与类之间的关系越来越密切,耦合度越来越大,当一个类发生改变时,对另外一个类的影响也越大. 解决方案:尽量降 ...
- 低耦合高内聚什么意思?
低耦合高内聚 很多小伙伴不理解低耦合高内聚什么意思?我给大家通俗的讲一下 低耦合 解决冗余(rongyu)代码,提高代码重复使用率 冗余:很多相似的代码
- 3分钟Tips:用大白话告诉你什么是低耦合|高内聚
1.高内聚 首先我们来看看内聚的含义:软件含义上的内聚其实是从化学中的分子的内聚演变过来的,化学中的分子间的作用力,作用力强则表现为内聚程度高.在软件中内聚程度的高低,标识着软件设计的好坏. 我们在进 ...
- 简单理解高内聚低耦合-高内聚低耦合通俗理解是什么?
低耦合: 耦合就是元素与元素之间的连接,感知和依赖量度.这里说的元素即是功能,对象,系统,子系统.模块. 例如:现在有方法A和方法B 我们在A元素去调用B元素,当B元素有问题或者不存在的时候,A元素就 ...
- 耦合关系从强到弱顺序_低耦合 高内聚
一 什么是低耦合 耦合度(Coupling)是对模块间关联程度的度量.耦合的强弱取决与模块间接口的复杂性.调用模块的方式以及通过界面传送数据的多少. 模块间的耦合度是指模块之间的依赖关系,包括控制关系 ...
- 低耦合高内聚 原则的应用
这次主要是分享对软件设计中的"低耦合.高内聚"原则的一些个人体会,通过lorawan代码等实例分析,让大家对这个设计思想有一些具象的理解. 本文作者twowinter,转载请注明作 ...
最新文章
- 因特网的域名服务器系统的好处,dns域名服务器的作用是什么
- 小程序异常监控及错误处理
- SharedActivityContext要引用那个单元?
- 安全——《微服务设计》读书笔记
- JVM启动参数手册——JVM之八
- 如何在iPhone / Android上进行Facebook联系人同步
- java web sqlmapapi,Sqlmap的sqlmapapi.py简单使用
- android studio 2.3.3 最新 中文 汉化包 韩梦飞沙 安卓工作室 美化包
- 树莓派安装拼音输入法(此处为谷歌拼音输入法)
- opencv源码下载编译
- 海康威视SDKjava二次开发身份证人脸识别
- 7大需求分析方法与5大分析过程
- 07-----给音视频文件添加字幕流
- Servlet和JSP小结
- C语言编程>第十六周 ⑦ s是全部由小写字母字符和空格字符组成的字符串,由len传入字符串的长度,请补充fun函数,该函数的功能是:统计字符串s中的单词数,结果由变量len传回。
- iPhone6适配指南
- 2055013-56-2,Ald-Ph-PEG2-amine TFA salt,CHO-Ph-PEG2-amine TFA
- 计算机换系统之后无法打印,打印机win7系统正常打印,换成win10后打印机驱动消失无法打印?...
- 安全合规/GDPR--21--我们是如何开展PTA、PIA、DPIA风险评估的
- 「游戏引擎 浅入浅出」前言
热门文章
- spring boot 启动报错Log4j2 could not find a logging implementation 解决
- Github每日精选(第75期):colly 爬取网站所有的数据
- 无法远程访问工作组计算机,如何在另一个工作组计算机上进行远程调试?
- 基石为勤能补拙的迷宫之旅——第八天(Python文件操作)
- 信息系统项目管理-项目采购管理-十二
- 作文 我眼中的计算机1000字,你眼中的我作文1000字
- 【CYW20189】一、芯片手册
- 【VMware】VMware 虚拟机使用笔记
- react native 和 小米 MIUI
- burpsuite 爆破的骚操作