diff --git a/README.md b/README.md index 92408d2..39f037f 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,35 @@ # CodeBrick ## 介绍 -一种无OS的MCU实用软件管理系统，包括任务轮询框架，命令管理器、低功耗管理、环形缓冲区等实用模块。 +一种无OS的MCU实用软件框架，包括任务轮询管理，命令管理器、低功耗管理、环形缓冲区等实用模块。系统中广泛利用自定义段技术减少各个模块间的耦合关系，大大提供程序的可维护性。 -### module模块 - 时间轮询框架，统一管理设备所有任务模块,使用例子： - -1.使用此模块前需要系统提供滴答定时器，用于驱动任务轮询作业 +## 主要功能 + - 支持模块自动化管理，并提供不同优先等级初始化声明接口。 + - 支持任务轮询管理，通过简单的宏声明即可实现，不需要复杂的声明调用。 + - 支持低功耗管理，休眠与唤醒通知。 + - 支持命令行解析，命令注册与执行。 + - blink设备支持，统一管理LED、震动马达、蜂鸣器 +## 使用说明 + +完整的代码可以参考工程文件,系统开发平台如下： + +MCU：STM32F401RET6 + +IDE：IAR 7.4或者Keil MDK 4.72A + +### 任务初始化及任务轮询管理(module) + +使用此模块前需要系统提供滴答定时器，用于驱动任务轮询作业。（参考platform.c） ```c //定时器中断(提供系统滴答) -void timer_interrupt(void) +void SysTick_Handler(void) { systick_increase(SYS_TICK_INTERVAL); //增加系统节拍 } ``` -2.任务初始化及注册(以按键扫描为例) + +注册初始化入口及任务(参考自key_task.c) ```c static void key_init(void) @@ -28,38 +42,57 @@ static void key_scan(void) /*do something*/ } -module_init("key", key_init); //注册按键初始化接口 -task_register("key", key_scan, 20); //注册按键任务(20ms轮询1次) +module_init("key", key_init); //注册按键初始化接口 +driver_register("key", key_scan, 20); //注册按键任务(20ms轮询1次) ``` ### 命令管理器(cli) - 适用于设备间通信、在线调试、参数配置等, 使用例子(参考cli_task.c)： - -1. 定义命令行管理器 +适用于在线调试、参数配置等(参考使用cli_task.c)，用户可以通过串口输出命令行控制设备行为、查询设备状态等功能。 + +#### 命令格式 + +cli支持的命令行格式如下： + +<cmd name> < param1> < param2> < paramn> < \r\n > +<cmd name> ,< param1>, < param2>, < paramn>, < \r\n > + + +每行命令包含一个命令名称+命令参数(可选),命令名称及参数可以通过空格或者','进行分隔。 + +#### 系统默认命令 + +cli系统自带了2条默认命令，分别是"?"与"help"命令，输入他们可以列出当前系统包含的命令列表，如下所示： + +```C +? - alias for 'help' +help - list all command. +pm - Low power control command +reset - reset system +sysinfo - show system infomation. -```c -static cli_obj_t cli; /*命令行对象 */ ``` -2.命令行初始化及接口适配 + +#### 适配命令管理器 +完整的例子可以参考cli_task.c. ```c +static cli_obj_t cli; /*命令管理器对象 */ + /* * @brief 命令行任务初始化 * @return none */ static void cli_task_init(void) { - cli_port_t p = {tty.write, tty.read}; /*使用串口进行适配 */ + cli_port_t p = {tty.write, tty.read}; /*读写接口 */ cli_init(&cli, &p); /*初始化命令行对象 */ - cli_enable(&cli); + cli_enable(&cli); + + cli_exec_cmd(&cli,"sysinfo"); /*显示系统信息*/ } -module_init("cli", cli_task_init); -``` -3.命令行任务轮询 -```c /* * @brief 命令行任务处理 * @return none @@ -68,35 +101,124 @@ static void cli_task_process(void) { cli_process(&cli); } - -task_register("cli", cli_task_process, 10); /*注册命令行任务*/ + +module_init("cli", cli_task_init); +task_register("cli", cli_task_process, 10); /*注册命令行任务*/ ``` -### comdef模块 -包含常用宏定义,段定义、匿名类型等。 +#### 命令注册 + +以复位命令为例(参考cmd_devinfo.c)： + +```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进行初始化适配，并提供当前系统允许的最大休眠时间，进入休眠的函数接口，基本的接口定义如下： +```C +/*低功耗适配器 ---------------------------------------------------------*/ +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文件进行编译即可使用。 + +#### 注册低功耗设备 + +以按键扫描为例，正常情况下，如果按键没有按下，那么系统休眠可以进入休眠状态，对按键功能是没有影响的。如果按键按下时，那么系统需要定时唤醒并轮询按键任务。 + +所以在一个低功耗系统下，为了不影响按键实时性需要处理好两个事情： + +1. 系统休眠状态下，如果有按键按下，那系统系统应立即唤醒，以便处理接下来的扫描工作。 +2. 如果按键按下时，系统可以进入休眠，但需要定时唤醒起来轮询按键任务。 + +对于第一种情况，将按键配置为边沿中断唤醒即可，以STM32F4为例(参考key_task.c)，它支持外部中断唤醒功能。 +```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来处理，当系统请求休眠时，如果此时按键按下，则返回下次唤醒时间即可，如下面的例子所示。 +```C +//参考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模块 - 需要在任务中定时进行轮询 -```c -//主程序入口 -void main(void) -{ - while (1) { - blink_dev_process(); //定时轮询 - } - -} -``` 或者通过"module"模块的任务注册来实现 ```c task_register("blink", blink_dev_process, 50); //50ms轮询1次 ``` -***使用例子,以LED为例*** +#### LED驱动 ```c blink_dev_t led; //定义led设备 diff --git a/driver/inc/tty.h b/driver/inc/tty.h index 90456be..36f9c43 100644 --- a/driver/inc/tty.h +++ b/driver/inc/tty.h @@ -7,7 +7,8 @@ * * Change Logs: * Date Author Notes - * 2015-07-03 Morro + * 2015-07-03 Morro + * 2021-03-07 Morro ӷͻж ******************************************************************************/ #ifndef _TTY_H_ @@ -22,6 +23,7 @@ typedef struct { unsigned int (*write)(const void *buf, unsigned int len); unsigned int (*read)(void *buf, unsigned int len); bool (*tx_isfull)(void); /*ͻ*/ + bool (*tx_isempty)(void); /*ͻ*/ bool (*rx_isempty)(void); /*ջ*/ }tty_t; diff --git a/driver/src/tty.c b/driver/src/tty.c index 802faca..82e6112 100644 --- a/driver/src/tty.c +++ b/driver/src/tty.c @@ -7,14 +7,13 @@ * * Change Logs: * Date Author Notes - * + * 2015-07-03 Morro ******************************************************************************/ #include "stm32f4xx.h" #include "ringbuffer.h" #include "tty.h" -#include "public.h" +#include "public.h" #include - #if (TTY_RXBUF_SIZE & (TTY_RXBUF_SIZE - 1)) != 0 #error "TTY_RXBUF_SIZE must be power of 2!" #endif @@ -50,7 +49,7 @@ static void uart_init(int baudrate) uart_conf(USART1, baudrate); /**/ nvic_conf(USART1_IRQn, 1, 1); - + } /* @@ -85,6 +84,12 @@ static bool tx_isfull(void) return ring_buf_len(&rbsend) == TTY_TXBUF_SIZE; } +/*ͻ*/ +bool tx_isempty(void) +{ + return ring_buf_len(&rbsend) == 0; +} + /*ջ*/ bool rx_isempty(void) { @@ -97,6 +102,7 @@ const tty_t tty = { uart_write, uart_read, tx_isfull, + tx_isempty, rx_isempty }; diff --git a/framework/blink.c b/framework/blink.c index 1ce7398..68f4a64 100644 --- a/framework/blink.c +++ b/framework/blink.c @@ -59,6 +59,15 @@ void blink_dev_ctrl(blink_dev_t *dev, int ontime, int offtime, int repeats) } } +/* + * @brief æж + */ +bool blink_dev_busy(blink_dev_t *dev) +{ + return dev->ontime; +} + + /* * @brief blink豸 * @param[in] none @@ -75,7 +84,7 @@ void blink_dev_process(void) dev->enable = true; dev->ioctrl(true); } - } else if(get_tick() - dev->tick < dev->offtime) { /**/ + } else if(get_tick() - dev->tick < dev->offtime) { if (dev->enable) { dev->enable = false; dev->ioctrl(false); @@ -92,3 +101,4 @@ void blink_dev_process(void) } } } + diff --git a/framework/blink.h b/framework/blink.h index a835eeb..3b4b8e6 100644 --- a/framework/blink.h +++ b/framework/blink.h @@ -8,6 +8,7 @@ * Change Logs: * Date Author Notes * 2019-04-01 Morro Initial version + * 2021-03-07 Morro æжϽӿ ******************************************************************************/ #ifndef _BLINK_H_ #define _BLINK_H_ @@ -34,6 +35,8 @@ void blink_dev_create(blink_dev_t *dev, void (*ioctrl)(bool enable)); void blink_dev_ctrl(blink_dev_t *dev, int ontime, int offtime, int repeat); +bool blink_dev_busy(blink_dev_t *dev); + void blink_dev_process(void); #ifdef __cplusplus diff --git a/framework/key.c b/framework/key.c index 839eee1..fd6bfa3 100644 --- a/framework/key.c +++ b/framework/key.c @@ -40,6 +40,15 @@ bool key_create(key_t *key, int (*readkey)(void), return 1; } +/******************************************************************************* + * @brief æж + * @return none + ******************************************************************************/ +bool key_busy(key_t *k) +{ + return k->tick != 0; +} + /******************************************************************************* * @brief ɨ账 * @return none diff --git a/framework/key.h b/framework/key.h index 6b01931..d716a5b 100644 --- a/framework/key.h +++ b/framework/key.h @@ -8,6 +8,7 @@ * Change Logs: * Date Author Notes * 2017-08-10 Morro Initial version + * 2021-03-07 Morro æжϽӿ ******************************************************************************/ #ifndef _KEY_H_ @@ -47,6 +48,9 @@ typedef struct key_t { bool key_create(key_t *key, int (*readkey)(void), /**/ void (*event)(int type, unsigned int duration)); + +bool key_busy(key_t *k); /*æж*/ + void key_scan_process(void); /*ɨ账*/ #ifdef __cplusplus diff --git a/framework/pm.c b/framework/pm.c index 0149ec8..c02e16a 100644 --- a/framework/pm.c +++ b/framework/pm.c @@ -7,19 +7,24 @@ * * Change Logs: * Date Author Notes - * 2021-01-17 Morro Initial version. + * 2021-03-02 Morro Initial version. ******************************************************************************/ #include "pm.h" #include /** - * @brief pm - */ -static const pm_adapter_t *pm_ctrl; + * @brief pm + */ +typedef struct { + const pm_adapter_t *adt; + bool enable; +}pm_watch_t; -static const pm_item_t pm_tbl_start SECTION("init.item.0"); +static pm_watch_t pm_watch; -static const pm_item_t pm_tbl_end SECTION("init.item.2"); +static const pm_item_t pm_tbl_start SECTION("pm.item.0"); + +static const pm_item_t pm_tbl_end SECTION("pm.item.2"); /* * @brief ϵͳм @@ -28,7 +33,7 @@ static bool system_is_idle(void) { const pm_item_t *it; for (it = &pm_tbl_start + 1; it < &pm_tbl_end; it++) { - if (!it->idle()) + if (it->idle != NULL && !it->idle()) return false; } return true; @@ -39,26 +44,31 @@ static bool system_is_idle(void) */ static void system_goto_sleep(void) { - const pm_item_t *it; + const pm_item_t *it; + const pm_adapter_t *adt; + unsigned int sleep_time; unsigned int tmp; - unsigned int sleep_time = pm_ctrl->max_sleep_time; + + adt = pm_watch.adt; + + sleep_time = adt->max_sleep_time; //ߴ for (it = &pm_tbl_start + 1; it < &pm_tbl_end; it++) { - if (it->suspend == NULL) + if (it->sleep_notify == NULL) continue; - it->suspend(&tmp); //豸,õ豸ڴ´λʱ - if (tmp < sleep_time) //豸еСʱ + tmp = it->sleep_notify(); //,õ豸ڴ´λʱ + if (tmp && tmp < sleep_time) //豸еСʱ sleep_time = tmp; } - pm_ctrl->goto_sleep(sleep_time); + adt->goto_sleep(sleep_time); //Ѵ for (it = &pm_tbl_start + 1; it < &pm_tbl_end; it++) { - if (it->resume == NULL) + if (it->wakeup_notify == NULL) continue; - it->resume(); + it->wakeup_notify(); } } @@ -68,7 +78,25 @@ static void system_goto_sleep(void) */ void pm_init(const pm_adapter_t *adt) { - pm_ctrl = adt; + pm_watch.adt = adt; +} + +/** + * @brief Ĺ + * @retval none + */ +void pm_enable(void) +{ + pm_watch.enable = true; +} + +/** + * @brief ùĹ + * @retval none + */ +void pm_disable(void) +{ + pm_watch.enable = false; } /** @@ -77,7 +105,7 @@ void pm_init(const pm_adapter_t *adt) */ void pm_process(void) { - if (!system_is_idle()) + if (!pm_watch.enable || !system_is_idle()) return; system_goto_sleep(); -} \ No newline at end of file +} diff --git a/framework/pm.h b/framework/pm.h index f435379..dce33fc 100644 --- a/framework/pm.h +++ b/framework/pm.h @@ -7,7 +7,7 @@ * * Change Logs: * Date Author Notes - * 2021-01-17 Morro Initial version. + * 2021-03-02 Morro Initial version. ******************************************************************************/ #ifndef _PM_H_ #define _PM_H_ @@ -26,20 +26,20 @@ typedef struct { const char *name; /** * @brief ǰ豸״̬(ֻеpm_item_t,ϵͳ) + * @note NULL,ʾϵͳ * @retval true - ״̬,false - ģʽ, */ bool (*idle)(void); /** - * @brief 豸 - * @param[out] next_wakup_time - ´λʱ - * @retval ʱ(λ:ms, 0 - ʾϵͳ) + * @brief ֪ͨ + * @retval ´λʱ(λ:ms, 0 - ʾϵͳ) */ - void (*suspend)(unsigned int *next_wakup_time); + unsigned int (*sleep_notify)(void); /** - * @brief ָ + * @brief ֪ͨ * @retval none */ - void (*resume)(void); + void (*wakeup_notify)(void); }pm_item_t; /*͹ ---------------------------------------------------------------*/ @@ -52,24 +52,32 @@ typedef struct { * @brief ״̬ * @param[in] time - ڴʱ(ms) * @retval ʵʱ + * @note ֮Ҫ,1ҪʱιŹ, + * ڼ䷢.һҪʱϵͳδʱ, + * ʱ䲻׼ */ - void (*goto_sleep)(unsigned int time); + unsigned int (*goto_sleep)(unsigned int time); }pm_adapter_t; /** * @brief Ĺע * @param[in] name - Ŀ - * @param[in] idle - ָʾ豸Ƿ - * @param[in] suspend - ϵͳ֪ͨ - * @param[in] resume - ֪ͨ + * @param[in] idle - ָʾ豸Ƿ,NULL,ʾϵͳ + * @param[in] sleep_notify - ֪ͨ,ҪNULL + * @param[in] wakeup_notify - ֪ͨ,ҪNULL */ -#define pm_dev_register(name, idle, suspend, resume)\ -__pm_item_register(name, idle, suspend, resume) +#define pm_dev_register(name, idle, sleep_notify, wakeup_notify)\ +__pm_item_register(name, idle, sleep_notify, wakeup_notify) void pm_init(const pm_adapter_t *adt); +void pm_enable(void); + +void pm_disable(void); + void pm_process(void); -#endif \ No newline at end of file +#endif + diff --git a/iar/codebrick.ewd b/iar/codebrick.ewd index 7368127..2612870 100644 --- a/iar/codebrick.ewd +++ b/iar/codebrick.ewd @@ -45,7 +45,7 @@