【K210】【MaixPy】一、Maix Dock入门之FPIOA和GPIO

    那么我们来进行神圣的点灯仪式吧。

    本次用到的类：fpioa_manager、FPIOA、GPIO
    本次用到的全局变量：board_info

0、引言

    K210上的物理引脚通过FPIOA功能来映射到GPIO，物理引脚共有48个对应于原理图上的IO0~IO47,可以将GPIO（分为通用和高速）任意分配给这些引脚，接下来介绍如何将GPIO接口分配给这些物理引脚。

---

1、关于类GPIO

    相信玩过一些嵌入式MCU的都了解GPIO的含义这里就不赘述了。特别的是 K210的GPIO分为高速GPIO(GPIOHS)和通用GPIO(GPIO)区别如下：

    下面是Maix系列开发板已经被使用的GPIOHS（高速GPIO）(也就是说没事别动这些接口就好)

    可以通过构造函数来新建一个对象比如：
    led_r=GPIO(GPIO.GPIO0,GPIO.OUT)
    关于这个函数：
    class GPIO(ID,MODE,PULL,VALUE)
    注意：这里的上拉和下拉在输入模式才可以配置

    这样你就可以通过led_r这个对象来修改和查询对应的接口了。（比如说我可以通过led_r修改GPIO0的输出值也可以给它配置一个外部中断服务函数（前提他的模式式输入的情况下，现在是输出））

---

2、关于全局变量board_info

    主要用于方便用户使用开发板引脚配置，其中内置了对人友好的命名及接口，可以使用户减少对电器连接原理图的依赖。

    board_info.LED_R代表LED_R所连接引脚的编号。

    在你忘记引脚名称的时候你可以使用内置的方法来查表：
    board_info.pin_map()

---

3、关于类fpioa_manager

fpioa_manager：简称fm，该模块用于注册芯片内部功能和引脚，帮助用户管理内部功能和引脚
fm 实际上是使用 Fpioa_Manager 类定义的一个对象， 使用 Micropython 编写并集成带固件中
所以我们可以直接使用已经定义的对象fm进行操作。

    fpioa_manager类中的主要方法包含了注册和注销函数的功能:
这两个函数可以将物理引脚对应上GPIO接口

    注册函数：
    fm.register(pin,function，[force=True])
    注销函数：
    fm.unregister(pin,function)
    它们的参数表：

比如:
    fm.register(board_info.LED_R, fm.fpioa.GPIO0)将LED_R的物理引脚信息注册到接口GPIO0，然后我们就可以操作GPIO接口进而影响引脚电平了。

    注意：已经注册的物理引脚：

---

4、关于类FPIOA

    其实我不是很懂这个类起到的功能几乎和fpio_manage一样但是它为什么会存在，如果有大神知道请不吝赐教。

    查表方法：
    fpioa.help()

    注意：这里所谓的外设其实就是指GPIO、SPI等等MCU内置的接口或功能。
    注册示例：fpioa.set_function(board_info.LED_R,fm.fpioa.GPIO0)将LED_R的物理引脚信息注册到接口GPIO0

---

5、代码

实现三种颜色的灯轮流闪烁：

from fpioa_manager import *#导入fpioa_manager模块中的所有函数
from Maix import GPIO
from Maix import FPIOA     #从Maix模块中导入GPIO和FPIOA类中的函数
import utime

fpioa = FPIOA()     #生成FPIOA类对象
#fpioa.help()        #显示外设及其简要描述列表
#fm.fpioa.help()     #显示外设及其简要描述列表

#board_info.pin_map()#打印所有功能引脚的引脚编号
#board_info.LED_R 代表LED_R所连接引脚的编号


#fm为Fpioa_Manager类已经定义的对象
fm.register(board_info.LED_R, fm.fpioa.GPIO0)#将LED_R的物理引脚信息注册到接口GPIO0
fm.register(board_info.LED_G, fm.fpioa.GPIO1)
fm.register(board_info.LED_B, fm.fpioa.GPIO2)

'''
#另一种注册方法
fpioa.set_function(board_info.LED_R,fm.fpioa.GPIO0)
fpioa.set_function(board_info.LED_G,fm.fpioa.GPIO1)
fpioa.set_function(board_info.LED_B,fm.fpioa.GPIO2)
'''
led_r=GPIO(GPIO.GPIO0,GPIO.OUT)
led_g=GPIO(GPIO.GPIO1,GPIO.OUT)
led_b=GPIO(GPIO.GPIO2,GPIO.OUT)

while True:
    led_r.value(0)
    utime.sleep_ms(500)#延时500ms
    led_r.value(1)
    led_g.value(0)
    utime.sleep_ms(500)
    led_g.value(1)
    led_b.value(0)
    utime.sleep_ms(500)
    led_b.value(1)