一种无OS的STM32实用软件框架

发布时间:2023-09-05  

介绍

一种无OS的STM32实用软件框架,包括任务轮询管理,命令管理器、低功耗管理、环形缓冲区等实用模块。系统中广泛利用自定义段技术减少各个模块间的耦合关系,大大提供程序的可维护性。


主要功能

支持模块自动化管理,并提供不同优先等级初始化声明接口。



支持任务轮询管理,通过简单的宏声明即可实现,不需要复杂的声明调用。


支持低功耗管理,休眠与唤醒通知。


支持命令行解析,命令注册与执行。


blink设备支持,统一管理LED、震动马达、蜂鸣器


使用说明

点击STM32嵌入式开发公众号文末的“阅读原文”,可以完整的工程代码,系统开发平台如下:


MCU:STM32F401RET6


IDE:IAR 7.4或者Keil MDK 4.72A


任务初始化及任务轮询管理(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次)

命令管理器(cli)

适用于在线调试、参数配置等(参考使用cli_task.c),用户可以通过串口输出命令行控制设备行为、查询设备状态等功能。


命令格式

cli支持的命令行格式如下:


< param1> < param2> < paramn> < > ,< param1>, < param2>, < paramn>, < >


每行命令包含一个命令名称+命令参数(可选),命令名称及参数可以通过空格或者','进行分隔。


系统默认命令

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);  

}


文章来源于:电子工程世界    原文链接
本站所有转载文章系出于传递更多信息之目的,且明确注明来源,不希望被转载的媒体或个人可与我们联系,我们将立即进行删除处理。

相关文章

    供支援2个 SATA 3.0 的储存装置界面 Q4. 解决方案中人工智能处理器支持框架有哪几种? A:Hailo-8 支持框架有 TensorFLow、TensorFlow Lite、ONNX......
    示波器实验系统出现误差,原因哪有哪几种;示波器是用来测量交流电或脉冲电流波的形状的仪器,由电子管放大器、扫描振荡器、阴极射线管等组成。那么示波器实验系统误差产生原因哪有哪几种? 示波......
    STM32单片机有哪几种常见的开发环境?;STM32单片机是一款广泛应用于嵌入式系统开发的单片机,针对其开发,有以下几种常见的方式: STM32单片机有哪几种常见的开发环境? Keil MDK......
    PLC 开关量输出接口有哪几种类型?各有什么特点?;工业生产和科技的发展都离不开PLC的自动化控制,PLC可以广义的理解为:集中的继电器延伸控制柜,实际的生产应用中,PLC大大......
    液体流量计有哪几种,液体流量计算公式及单位;  液体流量计是根据卡门涡原理制造用于测量密封管道中液体、气体、蒸汽流量的精密仪表。   液体流量计有哪几种   1、防腐蚀流量计   2、差压......
    。     3、PLC开关量输出接口有哪几种类型?各有什么特点? 晶闸管输出型:一般情况下,只能带交流负载,响应速度快,动作频率高; 晶体管输出型:一般情况下,只能带直流负载,响应速度快,动作频率高; 继电......
    /O接口:PLC与工业生产现场被控对象之间的连接部件,用来接受被控设备的信号和输出程序的执行结果; 4)通信接口:通过通信接口与监视器、打印机等其他设备进行信息交换; 5)电源。 3、PLC开关量输出接口有哪几种......
    通信接口与监视器、打印机等其他设备进行信息交换; (5)电源。 3、 PLC 开关量输出接口有哪几种类型?各有什么特点?  晶闸管输出型:一般情况下,只能带交流负载,响应速度快,动作频率高; 晶体管输出型:一般......
    通信接口与监视器、打印机等其他设备进行信息交换; (5)电源。 3、 PLC 开关量输出接口有哪几种类型?各有什么特点?  晶闸管输出型:一般情况下,只能带交流负载,响应速度快,动作频率高; 晶体管输出型:一般......
    。 3、PLC开关量输出接口有哪几种类型?各有......

我们与500+贴片厂合作,完美满足客户的定制需求。为品牌提供定制化的推广方案、专属产品特色页,多渠道推广,SEM/SEO精准营销以及与公众号的联合推广...详细>>

利用葫芦芯平台的卓越技术服务和新产品推广能力,原厂代理能轻松打入消费物联网(IOT)、信息与通信(ICT)、汽车及新能源汽车、工业自动化及工业物联网、装备及功率电子...详细>>

充分利用其强大的电子元器件采购流量,创新性地为这些物料提供了一个全新的窗口。我们的高效数字营销技术,不仅可以助你轻松识别与连接到需求方,更能够极大地提高“闲置物料”的处理能力,通过葫芦芯平台...详细>>

我们的目标很明确:构建一个全方位的半导体产业生态系统。成为一家全球领先的半导体互联网生态公司。目前,我们已成功打造了智能汽车、智能家居、大健康医疗、机器人和材料等五大生态领域。更为重要的是...详细>>

我们深知加工与定制类服务商的价值和重要性,因此,我们倾力为您提供最顶尖的营销资源。在我们的平台上,您可以直接接触到100万的研发工程师和采购工程师,以及10万的活跃客户群体...详细>>

凭借我们强大的专业流量和尖端的互联网数字营销技术,我们承诺为原厂提供免费的产品资料推广服务。无论是最新的资讯、技术动态还是创新产品,都可以通过我们的平台迅速传达给目标客户...详细>>

我们不止于将线索转化为潜在客户。葫芦芯平台致力于形成业务闭环,从引流、宣传到最终销售,全程跟进,确保每一个potential lead都得到妥善处理,从而大幅提高转化率。不仅如此...详细>>