《DNK210使用指南 -CanMV版 V1.0》第十二章 跑马灯实验

正点原子运营

第十二章 跑马灯实验

1）实验平台：正点原子DNK210开发板

2) 章节摘自【正点原子】DNK210使用指南 - CanMV版 V1.0

3）购买链接:https://detail.tmall.com/item.htm?&id=782801398750

4）全套实验源码+手册+视频下载地址：http://www.openedv.com/docs/boards/k210/ATK-DNK210.html

5）正点原子官方B站：https://space.bilibili.com/394620890

6）正点原子K210技术交流企鹅群:605557868

本章实验将介绍如何使用CanMV让Kendryte K210控制板载的双色LED闪烁，以实现跑马灯的效果。通过本章的学习，读者将学习到在CanMV下控制Kendryte K210的GPIO输出高低电平。

本章分为如下几个小节：

12.1 maix.GPIO模块介绍

12.2 硬件设计

12.3 程序设计

12.4 运行验证

12.1 maix.GPIO模块介绍

Kendryte K210上有两种GPIO（General-purposeinput/output，通用输入/输出），分别为GPIOHS（高速GPIO）和GPIO（通用GPIO）。

GPIOHS一共有32个，其特点如下所示：

1. 可配置输入输出信号

2. 每个IO具有独立的中断源

3. 中断支持边缘触发和电平触发

4. 每个IO可以分配到FPIOA上48个管脚之一

5. 可配置上下拉，或者高阻

GPIO一共有8个，其特点如下所示：

1. 可配置输入输出信号

2. 8个IO使用一个中断源

3. 可配置触发IO总中断，边沿触发和电平触发

4. 每个IO可以分配到FPIOA上48个管脚之一

5. 可配置上下拉，或者高阻

在CanMV中可以使用CanMV提供的maix.GPIO模块操作Kendryte K210上的GPIOHS和GPIO。maix.GPIO模块可以配置GPIOHS和GPIO的输入输出模式、设置和获取输入输出值、使能并配置和关闭中断。下面介绍maix.GPIO模块的功能。

maix.GPIO模块中提供了一些常量，这些常用可以用于模块类函数和方法的传参，如下表所示：

表12.1.1maix.GPIO模块常量

maix.GPIO模块提供了GPIO构造函数，用于创建一个GPIO对象，GPIO构造函数如下所示：

1. class GPIO(id, mode=None, pull=None, value=None)

复制代码

通过GPIO构造函数可以通过指定参数创建一个GPIO对象。

id指的是GPIO编号。

mode可以指定GPIO的输入输出模式。

pull可以指定GPIO的上下拉模式。

value可以设置GPIO的初始输出电平。

GPIO构造函数的使用示例如下所示：

1. from maix import GPIO
   
2. gpiohs0 = GPIO(GPIO.GPIOHS0, mode=GPIO.OUT, pull=GPIO.PULL_NONE, value=0)

复制代码

maix.GPIO模块为GPIO对象提供了init()方法，用于初始化GPIO对象的参数，init()方法如下所示：

1. GPIO.init(mode=None, pull=None, value=None)

复制代码

init()方法用于初始化GPIO对象的输入输出模式、上下拉模式和初识输出电平，当然，也可以在构造GPIO对象的时候进行初始化。

init()方法的使用示例如下所示：

1. from maix import GPIO
   
2. gpiohs0 = GPIO(GPIO.GPIOHS0)
   
3. gpiohs0.init(mode=GPIO.OUT, pull=GPIO.PULL_NONE, value=0)

复制代码

maix.GPIO模块为GPIO对象提供了value()方法，value()方法如下所示：

1. GPIO.value([value])

复制代码

value为可选参数，当value参数不为空时，value()方法将设置GPIO对象输出value指定的电平，当value参数为空时，value()方法将获取并返回GPIO对象的电平状态。

value()方法的使用示例如下所示：

1. from maix import GPIO
   
2. gpiohs0 = GPIO(GPIO.GPIOHS0, mode=GPIO.OUT, pull=GPIO.PULL_NONE, value=0)
   
3. gpiohs0.value(1)
   
4. value = gpiohs0.value()

复制代码

maix.GPIO为GPIO对象提供了mode()方法，mode()方法如下所示：

1. GPIO.mode(mode=-1)

复制代码

mode()方法用于配置GPIO对象的输入输出模式或上下拉模式，当然，也可以在构造GPIO对象的时候进行配置。

mode()方法的使用示例如下所示：

1. from maix import GPIO
   
2. gpiohs0 = GPIO(GPIO.GPIOHS0, mode=GPIO.OUT, pull=GPIO.PULL_NONE, value=0)
   
3. gpiohs0.mode(GPIO.IN)
   
4. gpiohs0.mode(GPIO.PUll_UP)

复制代码

maix.GPIO为GPIO对象提供了irq()方法，irq()方法如下所示：

1. GPIO.irq(handler=None, trigger=GPIO.IRQ_BOTH, wake=None, priority=7)

复制代码

irq()方法用于配置GPIO对象的中断，可以配置GPIO对象的中断处理函数、中断触发方式、中断优先等级等参数。

irq()方法的使用示例如下所示：

1. from maix import GPIO
   
2. def gpio_irq_handler(gpio):
   
3.     print('Hello', gpio)
   
4. gpiohs0 = GPIO(GPIO.GPIOHS0, GPIO.IN, GPIO.PULL_PU)
   
5. gpiohs0.irq(gpio_irq_handler, GPIO.IRQ_FALLING, GPIO.WAKEUP_NOT_SUPPORT, 7)

复制代码

maix.GPIO为GPIO对象提供了disirq()方法，disirq()方法如下所示：

1. GPIO.disirq()

复制代码

disirq()方法用于关闭GPIO对象的中断。

disirq()方法的使用示例如下所示：

1. from maix import GPIO
   
2. def gpio_irq_handler(gpio):
   
3.     print('Hello', gpio)
   
4. gpiohs0 = GPIO(GPIO.GPIOHS0, GPIO.IN, GPIO.PULL_PU)
   
5. gpiohs0.irq(gpio_irq_handler, GPIO.IRQ_FALLING, GPIO.WAKEUP_NOT_SUPPORT, 7)
   
6. gpiohs0.disirq()

复制代码

12.2 硬件设计

12.2.1 例程功能

1. 控制板载双色LED轮流闪烁，实现跑马灯的效果

12.2.2 硬件资源

1. 双色LED

       LEDR -IO24

       LEDB -IO25

12.2.3 原理图

本章实验内容，需要控制板载双色LED轮流闪烁，以实现跑马灯的效果，正点原子DNK210开发板上双色LED的连接原理图，如下图所示：                                 

图12.2.3.1 双色LED连接原理图

通过以上原理图可以看出，双色LED中红色和蓝色LED对应的IO编号分别为IO24和IO25，且都是当IO输出低电平时LED亮起，当IO输出高电平时LED熄灭。

12.3 程序设计

12.3.1 maix.GPIO模块

有关maix.GPIO模块的介绍，请见第12.1小节《maix.GPIO模块介绍》。

12.3.2 程序流程图

图12.3.2.1 跑马灯实验流程图

12.3.3 main.py代码

main.py中的脚本代码如下所示：

1. from board import board_info
   
2. from fpioa_manager import fm
   
3. from maix import GPIO
   
4. import time
   
5. # 为LED连接的IO注册GPIO功能
   
6. fm.register(board_info.LEDR, fm.fpioa.GPIO0)
   
7. fm.register(board_info.LEDB, fm.fpioa.GPIO1)
   
8. # 构造GPIO对象
   
9. ledr = GPIO(GPIO.GPIO0, mode=GPIO.OUT, pull=GPIO.PULL_NONE, value=1)
   
10. ledb = GPIO(GPIO.GPIO1, mode=GPIO.OUT, pull=GPIO.PULL_NONE, value=1)
    
11. while True:
    
12.     # 设置LED对应的GPIO对象输出对应的高低电平
    
13.    ledr.value(0)
    
14.     ledb.value(1)
    
15.    time.sleep_ms(200)
    
16.    ledr.value(1)
    
17.     ledb.value(0)
    
18.    time.sleep_ms(200)

复制代码

可以看到，首先通过fm.register()方法为控制双色LED的两个IO分别分配了GPIO0和GPIO1的功能，然后通过GPIO构造函数构造了两个GPIO对象，并均配置为输出模式，最后在一个循环中轮流设置这两个GPIO对象输出不同的高低电平并延时一段时间，从而应该能看到板载的双色LED轮流亮起、熄灭，实现跑马灯的效果。

12.4 运行验证

将DNK210开发板连接CanMV IDE，并点击CanMV IDE上的“开始(运行脚本)”按钮后，可以看到板载的双色LED轮流亮起、熄灭，实现跑马灯的效果，这与理论推断的结果一致。