HAL库GPIO在cubemx中的配置及注意事项

本节内容介绍
1、hal库gpio在cubemx中的配置及注意事项;
2、hal库gpio操作详解与结构介绍;
3、rt-thread任务介绍与创建;
4、利用多任务点灯,实现rtos多任务创建于执行;
hal库gpio在cubemx中的配置
上节课程我们介绍了cubemx的界面、时钟配置以及如何新建工程等,本节咱们就继续进行程序员届的“hello world”-“点灯”。
gpio选择与配置
嵌入式软件工程师拿到板子第一件事要做的一定是熟悉原理图,你可以不会设计,但一定要能看懂,软件工程师调试代码,一看原理图,二才是写代码、调试代码
先来看看开发板上的led是哪个引脚,可以看到pb6、pe3、pd15都是led控制引脚,采用的是灌电流的方式,低电平灯亮:
接下来,咱们在cubemx对这些io进行配置,小飞哥只选择了两个led灯,名字命名和原理图保持一致或者是按照实际功能命名
右击选择第一个选项,就可以修改label
单击选中,会有很多功能,mcu的一个引脚是可以复用为许多功能的,我们根据自己的需要配置对应的模式即可,此处我们控制led灯,低电平-灯亮,高电平-灯灭,显然是要配置为输出模式的,选择output即可,其他输出引脚同理
接下来我们来看下gpio的一些模式配置
对于开发板上的led控制引脚,我们可以按照如下配置,初始化输出高电平,led不开启,这样初始化就可以设置gpio输出电平,设置为需要的状态:
gpio配置比较简单,就不再啰嗦了
hal库gpio操作详解与结构介绍
打开生成的代码,看看上面配置的gpio初始化内容,上面cubemx的配置项可以看到已经生成对应的代码了,gpio的配置顺序:使能gpio时钟->配置相关采参数:
void mx_gpio_init(void){  gpio_inittypedef gpio_initstruct = {0};  /* gpio ports clock enable */  __hal_rcc_gpioe_clk_enable();  __hal_rcc_gpioc_clk_enable();  __hal_rcc_gpioh_clk_enable();  __hal_rcc_gpiob_clk_enable();  __hal_rcc_gpioa_clk_enable();  /*configure gpio pin output level */  hal_gpio_writepin(y_led_gpio_port, y_led_pin, gpio_pin_reset);  /*configure gpio pin output level */  hal_gpio_writepin(cp_led_gpio_port, cp_led_pin, gpio_pin_reset);  /*configure gpio pin : ptpin */  gpio_initstruct.pin = y_led_pin;  gpio_initstruct.mode = gpio_mode_output_pp;  gpio_initstruct.pull = gpio_nopull;  gpio_initstruct.speed = gpio_speed_freq_low;  hal_gpio_init(y_led_gpio_port, &gpio_initstruct);  /*configure gpio pin : ptpin */  gpio_initstruct.pin = cp_led_pin;  gpio_initstruct.mode = gpio_mode_output_pp;  gpio_initstruct.pull = gpio_nopull;  gpio_initstruct.speed = gpio_speed_freq_low;  hal_gpio_init(cp_led_gpio_port, &gpio_initstruct);}  
关于gpio操作的api:
/* initialization and de-initialization functions *****************************/void              hal_gpio_init(gpio_typedef  *gpiox, gpio_inittypedef *gpio_init);void              hal_gpio_deinit(gpio_typedef  *gpiox, uint32_t gpio_pin);/*** @}*//** @addtogroup gpio_exported_functions_group2 io operation functions* @{*//* io operation functions *****************************************************/gpio_pinstate     hal_gpio_readpin(gpio_typedef* gpiox, uint16_t gpio_pin);void              hal_gpio_writepin(gpio_typedef* gpiox, uint16_t gpio_pin, gpio_pinstate pinstate);void              hal_gpio_togglepin(gpio_typedef* gpiox, uint16_t gpio_pin);hal_statustypedef hal_gpio_lockpin(gpio_typedef* gpiox, uint16_t gpio_pin);void              hal_gpio_exti_irqhandler(uint16_t gpio_pin);void              hal_gpio_exti_callback(uint16_t gpio_pin);  
本节由于是led操作,我们只需要操作:
void hal_gpio_init(gpio_typedef  *gpiox, gpio_inittypedef *gpio_init);void hal_gpio_writepin(gpio_typedef* gpiox, uint16_t gpio_pin, gpio_pinstate pinstate);void hal_gpio_togglepin(gpio_typedef* gpiox, uint16_t gpio_pin);  
如何使用呢?
参数gpio_typedef  *gpiox可以是gpio组的地址:#define gpioa               ((gpio_typedef *) gpioa_base)#define gpiob               ((gpio_typedef *) gpiob_base)#define gpioc               ((gpio_typedef *) gpioc_base)#define gpiod               ((gpio_typedef *) gpiod_base)#define gpioe               ((gpio_typedef *) gpioe_base)#define gpiof               ((gpio_typedef *) gpiof_base)#define gpiog               ((gpio_typedef *) gpiog_base)#define gpioh               ((gpio_typedef *) gpioh_base)#define gpioi               ((gpio_typedef *) gpioi_base)参数gpio_pin可以是gpio的引脚号:#define gpio_pin_0                 ((uint16_t)0x0001)  /* pin 0 selected    */#define gpio_pin_1                 ((uint16_t)0x0002)  /* pin 1 selected    */#define gpio_pin_2                 ((uint16_t)0x0004)  /* pin 2 selected    */#define gpio_pin_3                 ((uint16_t)0x0008)  /* pin 3 selected    */#define gpio_pin_4                 ((uint16_t)0x0010)  /* pin 4 selected    */#define gpio_pin_5                 ((uint16_t)0x0020)  /* pin 5 selected    */#define gpio_pin_6                 ((uint16_t)0x0040)  /* pin 6 selected    */#define gpio_pin_7                 ((uint16_t)0x0080)  /* pin 7 selected    */#define gpio_pin_8                 ((uint16_t)0x0100)  /* pin 8 selected    */#define gpio_pin_9                 ((uint16_t)0x0200)  /* pin 9 selected    */#define gpio_pin_10                ((uint16_t)0x0400)  /* pin 10 selected   */#define gpio_pin_11                ((uint16_t)0x0800)  /* pin 11 selected   */#define gpio_pin_12                ((uint16_t)0x1000)  /* pin 12 selected   */#define gpio_pin_13                ((uint16_t)0x2000)  /* pin 13 selected   */#define gpio_pin_14                ((uint16_t)0x4000)  /* pin 14 selected   */#define gpio_pin_15                ((uint16_t)0x8000)  /* pin 15 selected   */#define gpio_pin_all               ((uint16_t)0xffff)  /* all pins selected */参数gpio_pinstate pinstate可以是:/**  * @brief  gpio bit set and bit reset enumeration  */typedef enum{  gpio_pin_reset = 0u,  gpio_pin_set} gpio_pinstate;  
输出低电平:
/*configure gpio pin output level */  hal_gpio_writepin(y_led_gpio_port, y_led_pin, gpio_pin_reset);  /*configure gpio pin output level */  hal_gpio_writepin(cp_led_gpio_port, cp_led_pin, gpio_pin_reset);  
输出高电平:
/*configure gpio pin output level */  hal_gpio_writepin(y_led_gpio_port, y_led_pin, gpio_pin_set);  /*configure gpio pin output level */  hal_gpio_writepin(cp_led_gpio_port, cp_led_pin, gpio_pin_set);  
翻转电平:
hal_gpio_togglepin(y_led_gpio_port,y_led_pin);  hal_gpio_togglepin(cp_led_gpio_port,cp_led_pin);  
关于gpio输出不外乎这几个api,掌握如何使用就可以了
rt-thread任务介绍与创建
主要摘取一些比较关键的信息,也可参见rt-thread官网介绍
线程管理
嵌入式系统执行这样的任务,系统通过传感器采集数据,并通过显示屏将数据显示出来,在多线程实时系统中,可以将这个任务分解成两个子任务,如下图所示,一个子任务不间断地读取传感器数据,并将数据写到共享内存中,另外一个子任务周期性的从共享内存中读取数据,并将传感器数据输出到显示屏上。
在 rt-thread 中,与上述子任务对应的程序实体就是线程,线程是实现任务的载体,它是 rt-thread 中最基本的调度单位,它描述了一个任务执行的运行环境,也描述了这个任务所处的优先等级,重要的任务可设置相对较高的优先级,非重要的任务可以设置较低的优先级,不同的任务还可以设置相同的优先级,轮流运行。
线程状态
线程运行的过程中,同一时间内只允许一个线程在处理器中运行,从运行的过程上划分,线程有多种不同的运行状态,如初始状态、挂起状态、就绪状态等。在 rt-thread 中,线程包含五种状态,操作系统会自动根据它运行的情况来动态调整它的状态。rt-thread 中线程的五种状态,如下表所示:
状态 描述
初始状态 当线程刚开始创建还没开始运行时就处于初始状态;在初始状态下,线程不参与调度。此状态在 rt-thread 中的宏定义为 rt_thread_init
就绪状态 在就绪状态下,线程按照优先级排队,等待被执行;一旦当前线程运行完毕让出处理器,操作系统会马上寻找最高优先级的就绪态线程运行。此状态在 rt-thread 中的宏定义为 rt_thread_ready
运行状态 线程当前正在运行。在单核系统中,只有 rt_thread_self() 函数返回的线程处于运行状态;在多核系统中,可能就不止这一个线程处于运行状态。此状态在 rt-thread 中的宏定义为 rt_thread_running
挂起状态 也称阻塞态。它可能因为资源不可用而挂起等待,或线程主动延时一段时间而挂起。在挂起状态下,线程不参与调度。此状态在 rt-thread 中的宏定义为 rt_thread_suspend
关闭状态 当线程运行结束时将处于关闭状态。关闭状态的线程不参与线程的调度。此状态在 rt-thread 中的宏定义为 rt_thread_close
线程状态切换
rt-thread 提供一系列的操作系统调用接口,使得线程的状态在这五个状态之间来回切换。几种状态间的转换关系如下图所示:
线程优先级
rt-thread 线程的优先级是表示线程被调度的优先程度。每个线程都具有优先级,线程越重要,赋予的优先级就应越高,线程被调度的可能才会越大。
rt-thread 最大支持 256 个线程优先级 (0~255),数值越小的优先级越高,0 为最高优先级。在一些资源比较紧张的系统中,可以根据实际情况选择只支持 8 个或 32 个优先级的系统配置;对于 arm cortex-m 系列,普遍采用 32 个优先级。最低优先级默认分配给空闲线程使用,用户一般不使用。在系统中,当有比当前线程优先级更高的线程就绪时,当前线程将立刻被换出,高优先级线程抢占处理器运行。
时间片
每个线程都有时间片这个参数,但时间片仅对优先级相同的就绪态线程有效。系统对优先级相同的就绪态线程采用时间片轮转的调度方式进行调度时,时间片起到约束线程单次运行时长的作用,其单位是一个系统节拍(os tick),详见《时钟管理》章节。假设有 2 个优先级相同的就绪态线程 a 与 b,a 线程的时间片设置为 10,b 线程的时间片设置为 5,那么当系统中不存在比 a 优先级高的就绪态线程时,系统会在 a、b 线程间来回切换执行,并且每次对 a 线程执行 10 个节拍的时长,对 b 线程执行 5 个节拍的时长,如下图。
线程通过调用函数 rt_thread_create/init() 进入到初始状态(rt_thread_init);
初始状态的线程通过调用函数 rt_thread_startup() 进入到就绪状态(rt_thread_ready);
就绪状态的线程被调度器调度后进入运行状态(rt_thread_running);当处于运行状态的线程调用 rt_thread_delay(),rt_sem_take(),rt_mutex_take(),rt_mb_recv() 等函数或者获取不到资源时,将进入到挂起状态(rt_thread_suspend);
处于挂起状态的线程,如果等待超时依然未能获得资源或由于其他线程释放了资源,那么它将返回到就绪状态。挂起状态的线程,如果调用 rt_thread_delete/detach() 函数,将更改为关闭状态(rt_thread_close);
而运行状态的线程,如果运行结束,就会在线程的最后部分执行 rt_thread_exit() 函数,将状态更改为关闭状态。
线程相关的api
创建和删除线程
一个线程要成为可执行的对象,就必须由操作系统的内核来为它创建一个线程。可以通过如下的接口创建一个动态线程:
rt_thread_t rt_thread_create(const char* name,                            void (*entry)(void* parameter),                            void* parameter,                            rt_uint32_t stack_size,                            rt_uint8_t priority,                            rt_uint32_t tick);  
调用这个函数时,系统会从动态堆内存中分配一个线程句柄以及按照参数中指定的栈大小从动态堆内存中分配相应的空间。分配出来的栈空间是按照 rtconfig.h 中配置的 rt_align_size 方式对齐。线程创建 rt_thread_create() 的参数和返回值见下图:
对于一些使用 rt_thread_create() 创建出来的线程,当不需要使用,或者运行出错时,我们可以使用下面的函数接口来从系统中把线程完全删除掉:
rt_err_t rt_thread_delete(rt_thread_t thread);  
初始化和脱离线程
线程的初始化可以使用下面的函数接口完成,来初始化静态线程对象:
rt_err_t rt_thread_init(struct rt_thread* thread,                        const char* name,                        void (*entry)(void* parameter), void* parameter,                        void* stack_start, rt_uint32_t stack_size,                        rt_uint8_t priority, rt_uint32_t tick);  
静态线程的线程句柄(或者说线程控制块指针)、线程栈由用户提供。静态线程是指线程控制块、线程运行栈一般都设置为全局变量,在编译时就被确定、被分配处理,内核不负责动态分配内存空间。需要注意的是,用户提供的栈首地址需做系统对齐(例如 arm 上需要做 4 字节对齐)。线程初始化接口 rt_thread_init() 的参数和返回值见下表:
对于用 rt_thread_init() 初始化的线程,使用 rt_thread_detach() 将使线程对象在线程队列和内核对象管理器中被脱离。线程脱离函数如下:
rt_err_t rt_thread_detach (rt_thread_t thread);  
启动线程
创建(初始化)的线程状态处于初始状态,并未进入就绪线程的调度队列,我们可以在线程初始化 / 创建成功后调用下面的函数接口让该线程进入就绪态:
rt_err_t rt_thread_startup(rt_thread_t thread);  
...还有其他一些线程api,就不再一一赘述了,可以在rt-thread官网查看
创建任务
上面对线程的介绍,罗里吧嗦的说了一大堆,接下来一起实战来看看,如何创建并运行任务
创建任务实现多任务点灯
根据创建任务的api
rt_thread_t rt_thread_create(const char* name,                            void (*entry)(void* parameter),                            void* parameter,                            rt_uint32_t stack_size,                            rt_uint8_t priority,                            rt_uint32_t tick);  
来创建我们的2个任务:
/** ****************************************************************************** * @file    rt_user_task.c * @brief   用户任务文件 * ****************************************************************************** * @attention * * copyright (c) 2022 公众号:小飞哥玩嵌入式. * all rights reserved. * author:小飞哥 * *****************************************************************************//* includes ------------------------------------------------------------------*/#include main.h#include #include rt_user_task.h/* private typedef -----------------------------------------------------------*//* private define ------------------------------------------------------------*/#define thread1_priority  27    //线程#define thread_stack_size 512  //线程栈深度#define thread_timeslice  5    //线程的时间片#define thread2_priority 26    //线程/* private macro -------------------------------------------------------------*//* private variables ---------------------------------------------------------*//* private function prototypes -----------------------------------------------*//* private user code ---------------------------------------------------------*//** * @function rt_ledflash_entry * @author:小飞哥玩嵌入式-小飞哥 * @todo: led控制线程 * @param: * @return: null */static void rt_led1_flash_entry(void *parameter){  for (;;)  {    hal_gpio_togglepin(y_led_gpio_port, y_led_pin);    rt_kprintf(led1 task is running!);    rt_thread_mdelay(500);  }}/** * @function rt_led2flash_entry * @author:小飞哥玩嵌入式-小飞哥 * @todo: led控制线程 * @param: * @return: null */static void rt_led2_flash_entry(void *parameter){  for (;;)  {    hal_gpio_togglepin(cp_led_gpio_port, cp_led_pin);  rt_kprintf(led2 task is running!);    rt_thread_mdelay(500);  }}/** * @function rt_user_thread_entry * @author:小飞哥玩嵌入式-小飞哥 * @todo: 创建线程 * @param: * @return: null */int rt_user_thread_entry(void){  static rt_thread_t result = rt_null;  /*创建一个线程,名称是rt_ledflash,入口是rt_ledflash_entry*/  result = rt_thread_create(rt_led1flash, rt_led1_flash_entry,                            null,                            thread_stack_size,                            thread1_priority,                            thread_timeslice);  if (result != rt_null) //线程创建成功 {  rt_thread_startup(result); } else {  rt_kprintf(rt_led1flash thread create failed); }  /*创建一个线程,名称是rt_ledflash,入口是rt_ledflash_entry*/  result = rt_thread_create(rt_led2flash, rt_led2_flash_entry,                            null,                            thread_stack_size,                            thread2_priority,                            thread_timeslice);  if (result != rt_null) //线程创建成功 {  rt_thread_startup(result); } else {  rt_kprintf(rt_led2flash thread create failed); }  return 0;}  
上面创建了两个任务,rt-thread任务的数值越小优先级是越高的,我们设置任务1的优先级为27,任务2的优先级为26,按照优先级设置规则,任务2的优先级是比较高的,接下来我们通过打印的方式(led就不展示啦)来看看是不是按照我们的优先级去执行,可以看到,任务2的优先级是比较任务1高的
然后我们测试下同一个优先级情况下会发生什么,不出意外的话,应该是先执行先创建的任务,下图也可以看到,确实如此
至此,本节教程就完了,讲的还是比较粗略的,led就不展示啦,希望对小伙们有所帮助哈!


超级芯片GH200发布,AI算力是H100的两倍
专注4G手机/网络基础设施/物联网,Qorvo致力攻克射频复杂性问题
2018年中国低压电器行业竞争格局及发展趋势分析 国产品牌崛起势不可挡
jvm调优参数
与互联网行业比,为何运营商裁员总笼罩“阴霾”?
HAL库GPIO在cubemx中的配置及注意事项
人工智能技术的巨大潜力,需更多监督
国产首款数字信号处理器魂芯二号A正式发布
区块链商业应用平台公有链项目才链Talust介绍
电还原CO制乙酸太难?耦合阳极氧化来支招
驱动电机温度传感器的工作原理
使用NVIDIA数学库加速GPU应用程序
重大违法退市新规 明确四项强制退市关键
低压防雷箱综合选型应用方案
一键对讲求助终端 壁挂式对讲求助终端
关于BMW第5代电驱系统性能分析
九州风神PX1000G WH电源参数详解
光猫和路由器哪个无线信号更强
八项PCB设计最佳实践
自动浇灌喷淋控制系统怎样来实现