zephyr的GPIOTE驱动开发记录——基于nordic的NCS
简介:
本次测试了zephyr的中断驱动方式(GPIOTE),在这可以去看zephyr的官方文档对zephyr的中断定义,连接如下,Interrupts — Zephyr Project Documentation (nordicsemi.com) ;版本可能不对应,但是原理是一致的,今天记录的就是其中的零延迟中断,就是减少中断时间,让来自外部的中断能快速响应,进入到我们的中断服务程序中进行快速执行(也就是ISR)。
根据文档,就作者理解来如下,如有更好的理解可以进行指正,有些时候在执行某些线程时对时间有要求或者在临界区进行操作时,不能够被外部中断(ISQ)打断,可以禁止(中断服务程序)ISR的执行。通过IRQ禁止达到在处理某些线程时不会被打断,但是会让中断处理被延迟,但这时候又出现一个矛盾,有些中断是我想要及时处理的,那么我们需要不被屏蔽掉,就是这个中断是比前面列举的线程执行更重要的事,那么怎么办,可以直接使用零延迟中断进行定义,让这些中断直接得到响应,在零延迟中断中又分为两种:一是常规的ISR,二是直接的ISR(某些情况下比常规的更快),常规的ISR可能还是会被打断,导致一下开销产生,具体在zephyr中有4点列举:
如果某个任务完全不想要被打断,快速的执行,那么就可以使用直接ISR(direct ISR)。在作者看来正常情况下(没有其余中断打断的情况下),他们两的时间应该是一致的。具体可以点击上面链接,直接看官方描述。
本次使用的是在开发之前默认你已经配置好开发环境,如果是第一次开发,建议去安装下面给出官方环境参考文档,或者去比例比例观看环境搭建的学习视频(VS code),也可以参看我文章中的关于9160开机测试的文章。官方连接如下:开发你的第一个nRF Connect SDK(NCS)/Zephyr应用程序 – iini – 博客园 (cnblogs.com)
参考资料:
nordic的官方讲解视频,可以在哔哩哔哩上搜索nordic半导体去看关于其中一个视频:zephyr的设备驱动程序模型,中断和电源管理视频,中文讲解( //www.bilibili.com/video/BV1MU4y177Zhis_story_h5=false&p=1&share_from=ugc&share_medium=android&share_plat=android&share_session_id=c0145896-48dc-4bbf-b938f1f4b3a4644a&share_source=WEIXIN&share_tag=s_i×tamp=1668583626&unique_k=29oQkX4),或者直接参看zephyr的官方。
本次测试环境:VS code、NCS1.8
一、建立工程
建立一个zephyr的工程,如果你有NCS,并且已经安装好相关可以进行开发的环境,那么可以打开一个hello Word的工程进行添加,如果没可以zephyr的SDK,可以依据nordic官方NCS进行开发,它也有如STM32等芯片底层文件,因为nordic只是在zephyr的SDK中加入了自己的产品形成了NCS包,其余zephyr原本有的并没有删减,所以你可以在NCS中建立如STM32芯片的工程进行开发,且上层的驱动都是抽象的,只是对应余硬件的定义换成了具体的芯片定义,我们只用管APP开发,所以一套代码,可以建立成不同芯片的工程,并且在编译下载后依然可以运行,不止局限于nordic的开发。
1、zephyr工程建立
对于zephyr可以直接建立一个文件夹,然后再里面包含如下的几个文件就可以进行编译开发了,
1)、其中src中放置我们的.c文件(APP),便于管理;
2)、CMakeLists.txt是工程创建的直接根本文件,具体内容可以是如下:
#这是cmake的版本 cmake_minimum_required(VERSION 3.20.0) #添加的库 find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE}) #建立的工程名字(本次为hello_world,可以改为GPIOTE等) project(hello_world) #添加.c文件,稍后在src中建立一个main.c target_sources(app PRIVATE src/main.c)
3)、prj.conf为配置文件,很多时候还需要一个overlay文件,可以进行设备树驱动的更改,有一个默认的,如果需要定义更改,就用overlay文件进行实现
由于本次我使用的是nordic的SDK,NCS,我可以在VS code上安装好相关插件然后直接镜像创建一个工程在其余文件中(根据自己选择,但是保证和NCS处于同一个磁盘中),如果不会请参看前面提到的教学文档与视频,在看后,你就可以理解为什么只是这几个文件就可以建立一个工程了。
因此我们根据NCS中的hello_word建立一个镜像工程,并把该工程的文件夹名字命令为gpiote,且工程也建立为gpiote,,然后建立一个可以跑在nrf5340的应用核的工程,如下,该工程主要功能是,通过串口打印出,hello world+板子信息。
2、添加自定义.c文件
原本已经有一个.c文件了,该文件中主要就是串口打印信息,本次测试是需要测试中断,所以我们在定义一个名字为gpiote.c的文件,添加到我们工程,然后再进行代码编写,在src中加入一个gpiote.c文件,
然后把gpiote.c加入到工程,这就需要我们打开我们的CMakeLists.txt,添加如图所示代码:
然后点击全编译,我们就可以看到我们的工程下加入了gpiote.c文件:
全编译如下:
3、overlay文件加入
这里有一个隐藏的规则,如果你看了前面推荐的官网连接,那么应该知道,在工程目录下建立文件名和我们使用的板子一致时,可以不用在CMakeLists.txt中进行文件添加,编译器建立工程时可以识别这overlay文件,知道你要更改默认的devicetree定义,会把你加入进入,如果不知道请去看下前面给出的连接,那么zephyr第一那些板子呢,他们的名是什么,可以直接在vs code确看,就行是你建立工程时选择的板子名字:
由于我使用的是nrf5340,那么我就建立一个同名的overlay文件,最后我们工程目录如下,就看我框选部分,其余是建立hello_word镜像工程时产生的:
二、设备树更改
这里注意的是我使用了1.8的NCS,如果你使用高版本的NCS如2.1,那么overlay文件会有一点便跟,你可以参考其余工程。
主要是添加一个中断口定义,我们在nrf5340dk_nrf5340_cpuapp.overlay中进行处理,在添加前我们来看一下设备树文件zephyr.dts,建立编译工程后,可以在如下目录找到它:
可以看到已经有一个buttons的设备定义了,我想自己加一个自己的按键定义,作为中断触发源,我使用的是官方开发板,按键依然是那几个,但是我可以再定义一个,然后起一个其他名字,在overlay中添加如下代码:
/*参数加入devicetree的位置*/ /{ /*其别名,这主要给test_button其一个别名,然后可以在APP中通过别名gpiote定位到我们定义的按键*/ aliases { gpiote = &test_button; }; /*在原有的buttons下定义一个测试IO口,并且定位为GPIO0的0x17脚,即P0.23,名字为test_gpiote*/ buttons{ test_button: test_button { gpios = < &gpio0 0x17 0x11 >; label = "test_gpiote"; }; }; };
截图如下:
编译后可以在zephyr.dts中看到本次定义:
三、应用代码编写
1、常规方式:
在gpiote.c中的代码如下:
#include "device.h" #include "irq.h" #include <zephyr.h> #include <sys/printk.h> #include <sys/util.h> #include <device.h> #include <devicetree.h> #include <drivers/gpio.h> #include <nrfx.h> #include <dk_buttons_and_leds.h> #define PIN DT_GPIO_PIN(DT_ALIAS(gpiote), gpios) /* 建立一个gpio引脚的类*/ struct gpio_pin { const char * const port; const uint8_t number; }; /* 定义gpio_pin类型的变量,用于读取设备定义信息,这以数组的形式定义, 便于有多个按键时可以直接定义,ARRAY_SIZE用于计算大小*/ static const struct gpio_pin init_pin[] ={ {DT_GPIO_LABEL(DT_ALIAS(gpiote), gpios), DT_GPIO_PIN(DT_ALIAS(gpiote), gpios)}, }; /* */ static const struct device * init_device[ARRAY_SIZE(init_pin)]; /* 回调的变量*/ static struct gpio_callback gpiote_cb; /*回调函数*/ void gpio_init_handle(const struct device *port, struct gpio_callback *cb, gpio_port_pins_t pins) { printk("run to gpiote test\n"); } /*GPIOte程序*/ void gpiote_test(void) { /*如果时有多个按键可以增加数组个数*/ int err; uint32_t pin_mask = 0; // gpio_flags_t flags = (IS_ENABLED(CONFIG_DK_LIBRARY_INVERT_BUTTONS) ? // GPIO_PULL_UP : GPIO_PULL_DOWN); /*获取设备*/ init_device[0]=device_get_binding(init_pin[0].port); if (!init_device[0]) { printk("Cannot bind gpio device"); } /*配置gpio口,输入上拉*/ err = gpio_pin_configure(init_device[0], init_pin[0].number, GPIO_INPUT | GPIO_PULL_UP); if (err) { printk("Cannot configure button gpio"); } /*中断配置*/ err = gpio_pin_interrupt_configure(init_device[0], init_pin[0].number, GPIO_INT_DISABLE); if (err) { printk("Cannot disable callbacks()"); } pin_mask |= BIT(init_pin[0].number); /*回调设置*/ pin_mask |= BIT(init_pin[0].number); /*回调设置*/ gpio_init_callback(&gpiote_cb, gpio_init_handle, pin_mask); /*将刚刚绑定的结构添加到向量表中*/ err = gpio_add_callback(init_device[0], &gpiote_cb); if (err) { printk("Cannot add callback"); } /*将GPIO中断配置为下降沿触发,并启用它*/ err = gpio_pin_interrupt_configure(init_device[0], init_pin[0].number, GPIO_INT_EDGE_FALLING); if (err) { printk("Cannot disable callbacks()"); } printk("test start\n"); while(1) { } } /*创建一个区别于main.c中的线程,用于初始haulgpiote功能 */ K_THREAD_DEFINE(gpiote_test_id,1024,gpiote_test,NULL,NULL,NULL,7,0,0);
在此程序的基础上,你可以定义多个按键并放入设备模型数组,虽然我本次测试只使用了一个按键,如果你添加的是多个按键,记得初始化时用for循环,把每一个设备都添加一下,我这只有一个设备说以只使用了数组的第0位的设备(也只有一个)。
结果:
2、zephyr中的direct ISR(直接中断模式)
APP我们不用更改,只要把驱动中的IRQ_CONNECT();替换为IRQ_DIRECT_CONNECT();然后再加入zephy官方文档定义的代码:
你可以在工程的如下地方找到这个文件,然后更改原始定义,改部分代码已经更改:
可以直接替换代码:
#define CONFIG_direct_isr #ifdef CONFIG_direct_isr ISR_DIRECT_DECLARE(gpiote_event_handler_direct) { gpiote_event_handler(); ISR_DIRECT_PM(); /* PM done after servicing interrupt for best latency */ return 1; /* We should check if scheduling decision should be made */ } #endif static int gpio_nrfx_init(const struct device *port) { static bool gpio_initialized; if (!gpio_initialized) { gpio_initialized = true; #ifdef CONFIG_direct_isr IRQ_DIRECT_CONNECT(DT_IRQN(GPIOTE_NODE), DT_IRQ(GPIOTE_NODE, priority), gpiote_event_handler_direct, 0); #else IRQ_CONNECT(DT_IRQN(GPIOTE_NODE), DT_IRQ(GPIOTE_NODE, priority), gpiote_event_handler, NULL, 0); #endif irq_enable(DT_IRQN(GPIOTE_NODE)); nrf_gpiote_int_enable(NRF_GPIOTE, NRF_GPIOTE_INT_PORT_MASK); } return 0; }
编译下载即可:
四、中断向量表查看
在如下目录可以看到我们的中断服务程序入口:其中21753就是本次中断ISR的如果地址:
在这个数组下还有中断向量表,可以自行查看:
GPIO测试到此结束。如有错漏欢迎评论指正。