一种无OS的MCU实用软件框架
1 介绍
一种无os的mcu实用软件框架，包括任务轮询管理，命令管理器、低功耗管理、环形缓冲区等实用模块。系统中广泛利用自定义段技术减少各个模块间的耦合关系，大大提供程序的可维护性。
2 主要功能
支持模块自动化管理，并提供不同优先等级初始化声明接口。
支持任务轮询管理，通过简单的宏声明即可实现，不需要复杂的声明调用。
支持低功耗管理，休眠与唤醒通知。
支持命令行解析，命令注册与执行。
blink设备支持，统一管理led、震动马达、蜂鸣器
3 使用说明
完整的代码可以参考工程文件,系统开发平台如下： mcu：stm32f401ret6 ide：iar 7.4或者keil mdk 4.72a
3.1 任务初始化及任务轮询管理(module)
使用此模块前需要系统提供滴答定时器，用于驱动任务轮询作业。（参考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次) 3.2 命令管理器(cli)
适用于在线调试、参数配置等(参考使用cli_task.c)，用户可以通过串口输出命令行控制设备行为、查询设备状态等功能。
命令格式：
cli支持的命令行格式如下：
,, , , 每行命令包含一个命令名称+命令参数(可选),命令名称及参数可以通过空格或者','进行分隔。 系统默认命令：
cli系统自带了2条默认命令，分别是?与help命令，输入他们可以列出当前系统包含的命令列表，如下所示：
? - alias for 'help'help - list all command.pm - low power control commandreset - reset systemsysinfo - 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); 3.3 低功耗管理器(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); 3.4 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 需要系统提供滴答时钟，key.c中是通过get_tick()接口获取，依赖module模块
需要在任务中定时进行轮询
联发科翻身！魅族带来超级黑科技，完秒华为Mate9！
高压放大器的优点是什么，它适用于哪些领域
S7-300/400的CPx43-1 MODBUS TCP通讯案例
锐龙5000和锐龙3000 CPU的实际使用表现
分析师：特斯拉里去年共消耗了44 GWh动力电池
一种无OS的MCU实用软件框架
深圳数研院：工业互联网来了，你可能更需要时序数据库
激光电视大屏市场首选
笔记本屏幕尺寸
CAN- 静电放电及插拔脉冲过电压防护-优恩半导体
导电滑环的用途有哪些，它的发展趋势是怎样的
特斯拉Roadster将于2022年扩建上海工厂投产
HEX文件在单片机中是如何工作起来的？
GRANDMICRO有容微IC芯片在5G基站方案应用
京东JDY-800“京鸿”货运型固定翼无人机试飞取得阶段性成果
明基智能无线投影应运而生，开启会议新时代
哪些蓝牙耳机口碑比较好？平价好用的蓝牙耳机推荐
中国无人机技术世界领先
【曦哥论币】3.16行情分析，数字货币明显拉升，暴涨暴跌你怎么看？
面向UV粘合和UV镀膜应用，新型UV-LED照射单元面世
一种无os的mcu实用软件框架，包括任务轮询管理，命令管理器、低功耗管理、环形缓冲区等实用模块。系统中广泛利用自定义段技术减少各个模块间的耦合关系，大大提供程序的可维护性。
2 主要功能
支持模块自动化管理，并提供不同优先等级初始化声明接口。
支持任务轮询管理，通过简单的宏声明即可实现，不需要复杂的声明调用。
支持低功耗管理，休眠与唤醒通知。
支持命令行解析，命令注册与执行。
blink设备支持，统一管理led、震动马达、蜂鸣器
3 使用说明
完整的代码可以参考工程文件,系统开发平台如下： mcu：stm32f401ret6 ide：iar 7.4或者keil mdk 4.72a
3.1 任务初始化及任务轮询管理(module)
使用此模块前需要系统提供滴答定时器，用于驱动任务轮询作业。（参考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次) 3.2 命令管理器(cli)
适用于在线调试、参数配置等(参考使用cli_task.c)，用户可以通过串口输出命令行控制设备行为、查询设备状态等功能。
命令格式：
cli支持的命令行格式如下：
,, , , 每行命令包含一个命令名称+命令参数(可选),命令名称及参数可以通过空格或者','进行分隔。 系统默认命令：
cli系统自带了2条默认命令，分别是?与help命令，输入他们可以列出当前系统包含的命令列表，如下所示：
? - alias for 'help'help - list all command.pm - low power control commandreset - reset systemsysinfo - 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); 3.3 低功耗管理器(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); 3.4 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
需要在任务中定时进行轮询
联发科翻身！魅族带来超级黑科技，完秒华为Mate9！
高压放大器的优点是什么，它适用于哪些领域
S7-300/400的CPx43-1 MODBUS TCP通讯案例
锐龙5000和锐龙3000 CPU的实际使用表现
分析师：特斯拉里去年共消耗了44 GWh动力电池
一种无OS的MCU实用软件框架
深圳数研院：工业互联网来了，你可能更需要时序数据库
激光电视大屏市场首选
笔记本屏幕尺寸
CAN- 静电放电及插拔脉冲过电压防护-优恩半导体
导电滑环的用途有哪些，它的发展趋势是怎样的
特斯拉Roadster将于2022年扩建上海工厂投产
HEX文件在单片机中是如何工作起来的？
GRANDMICRO有容微IC芯片在5G基站方案应用
京东JDY-800“京鸿”货运型固定翼无人机试飞取得阶段性成果
明基智能无线投影应运而生，开启会议新时代
哪些蓝牙耳机口碑比较好？平价好用的蓝牙耳机推荐
中国无人机技术世界领先
【曦哥论币】3.16行情分析，数字货币明显拉升，暴涨暴跌你怎么看？
面向UV粘合和UV镀膜应用，新型UV-LED照射单元面世