maixpy k210 GPIO操作

谁践踏了优雅 2022-12-20 12:37 274阅读 0赞

import time
    from Maix import GPIO
    from Maix import FPIOA
    from fpioa_manager import fm
    from board import board_info
    
    # see board/readme.md to config your sipeed's hardware.
    print(board_info.LED_R)
    print(board_info.LED_G)
    print(board_info.LED_B)
    #print(board_info.GPIOHS9)
    '''
    用fm(fpioa manager)这个内置的对象来注册芯片的外设和引脚的对应关系，
    这里　fm.fpioa.GPIO0 是　K210 的一个 GPIO 外设
    （注意区分 GPIO（外设） 和引脚（实实在在的硬件引脚）的区别 ），
    所以把 fm.fpioa.GPIO0 注册到了 引脚 board_info.LED_R；
    '''
    fpioa = FPIOA()
    fpioa.set_function(8,fpioa.GPIOHS8)
    fpioa.set_function(9,fpioa.GPIOHS9)
    #将LED外部IO注册到内部GPIO，K210引脚支持任意配置
    '''
    fm.register(12,fm.fpioa.GPIO0)
    fm.register(13,fm.fpioa.GPIO1)
    fm.register(14,fm.fpioa.GPIO2)
    '''
    fm.register(board_info.LED_R, fm.fpioa.GPIO0, force=True)
    fm.register(board_info.LED_G, fm.fpioa.GPIOHS0, force=True)
    fm.register(board_info.LED_B, fm.fpioa.GPIO2, force=True)
    fm.register(board_info.BOOT_KEY, fm.fpioa.GPIO3, force=True)
    # 构造函数  fm.fpioa.GPIO0  重新命名的
    led_r = GPIO(GPIO.GPIO0, GPIO.OUT)
    led_g = GPIO(GPIO.GPIOHS0, GPIO.OUT)
    led_b = GPIO(GPIO.GPIO2, GPIO.OUT)
    key_input = GPIO(GPIO.GPIO3, GPIO.IN)
    
    test_led1 = GPIO(GPIO.GPIOHS8,GPIO.OUT)
    test_led2 = GPIO(GPIO.GPIOHS9,GPIO.OUT)
    
    test_gpio=GPIO(GPIO.GPIOHS9,GPIO.OUT)
    
    status = 0
    for i in range(0, 200):
        led_r.value(status)#设置高低电平
        test_led1.value(status)
        time.sleep_ms(300)
        led_g.value(status)
        time.sleep_ms(300)
        led_b.value(status)
        time.sleep_ms(300)
        status = 0 if (status == 1) else 1
        time.sleep_ms(300)
        print("LED RGB(%d,%d,%d)" % (led_r.value(), led_g.value(), led_b.value()))
        time.sleep_ms(100)
        print("key_input:", key_input.value())
    
    fm.unregister(board_info.LED_R)
    fm.unregister(board_info.LED_G)
    fm.unregister(board_info.LED_B)
    fm.unregister(board_info.BOOT_KEY)

K210 支持每个外设随意映射到任意引脚， 使用 FPIOA 功能来实现。

**注意**:

以下 GPIOHS 默认已经被使用， 程序中如非必要尽量不要使用：

<table> 
 <thead> 
  <tr> 
   <th>GPIOHS</th> 
   <th>功能</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>GPIOHS31</td> 
   <td>LCD_DC</td> 
  </tr> 
  <tr> 
   <td>GPIOHS30</td> 
   <td>LCD_RST</td> 
  </tr> 
  <tr> 
   <td>GPIOHS29</td> 
   <td>SD_CS</td> 
  </tr> 
  <tr> 
   <td>GPIOHS28</td> 
   <td>MIC_LED_CLK</td> 
  </tr> 
  <tr> 
   <td>GPIOHS27</td> 
   <td>MIC_LED_DATA</td> 
  </tr> 
 </tbody> 
</table>

## 1. 类 FPIOA ##

### 1.1. 方法 ###

help(func)

显示外设及其简要描述

参数

*  `func`： 外设名（功能/编号），可以不传参， 则以表格的形式显示所有外设名即简要描述，这个表格也可以在本页的末尾找到（[附录：外设表][Link 1]）；</br> 如果传参，则传一个整型值， 找到该编号对应的外设后会打印外设名和描述，</br> 比如 `FPIOA.JTAG_TCLK` 或者 `fm.fpioa.JTAG_TCLK`（`fm`在本页后面介绍） 或者 `0`

比如：

from Maix import FPIOA
    
    fpioa = FPIOA()
    fpioa.help()
    fpioa.help(0)
    fpioa.help(fpioa.JTAG_TCLK)
    fm.fpioa.help()
    fm.fpioa.help(fm.fpioa.JTAG_TCLK)

外设名及其简要描述

set\_function(pin, func)

设置引脚对应的外设功能， 即引脚映射

参数

*  `pin`： 引脚编号，取值 \[0, 47\]， 具体的引脚连接请看电路图， 也可以使用 `board_info.` 然后按 `TAB` 按键补全来获得板子的常用引脚，比如 `board_info.LED_G`
 *  `func`： 外设功能，传一个整型值，可以通过 `fm.fpioa.help()`或者查本页末尾的 [附录： 外设表][Link 1] 表得到

比如 需要将连接 `绿色 LED` 的引脚映射到 `高速 GPIO0` 上：

fpioa = FPIOA()
    fpioa.set_function(board_info.LED_G, fm.fpioa.GPIOHS0)

get\_Pin\_num(func)

获取外设映射到哪个引脚上了

参数

*  `func`： 外设功能，传一个整型值，可以通过 `fm.fpioa.help()`或者查本页末尾的 [附录： 外设表][Link 1] 表得到

比如：

fpioa = FPIOA()
    fpioa.set_function(board_info.LED_G, fm.fpioa.GPIOHS0)
    pin = fpioa.get_Pin_num(fm.fpioa.GPIOHS0)
    if pin == board_info.LED_G:
        print("set function ok")

## 2. 附录： 外设表 ##

<table> 
 <thead> 
  <tr> 
   <th>外设功能（func）</th> 
   <th>简要描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>JTAG_TCLK</td> 
   <td>JTAG Test Clock</td> 
  </tr> 
  <tr> 
   <td>JTAG_TDI</td> 
   <td>JTAG Test Data In</td> 
  </tr> 
  <tr> 
   <td>JTAG_TMS</td> 
   <td>JTAG Test Mode Select</td> 
  </tr> 
  <tr> 
   <td>JTAG_TDO</td> 
   <td>JTAG Test Data Out</td> 
  </tr> 
  <tr> 
   <td>SPI0_D0</td> 
   <td>SPI0 Data 0</td> 
  </tr> 
  <tr> 
   <td>SPI0_D1</td> 
   <td>SPI0 Data 1</td> 
  </tr> 
  <tr> 
   <td>SPI0_D2</td> 
   <td>SPI0 Data 2</td> 
  </tr> 
  <tr> 
   <td>SPI0_D3</td> 
   <td>SPI0 Data 3</td> 
  </tr> 
  <tr> 
   <td>SPI0_D4</td> 
   <td>SPI0 Data 4</td> 
  </tr> 
  <tr> 
   <td>SPI0_D5</td> 
   <td>SPI0 Data 5</td> 
  </tr> 
  <tr> 
   <td>SPI0_D6</td> 
   <td>SPI0 Data 6</td> 
  </tr> 
  <tr> 
   <td>SPI0_D7</td> 
   <td>SPI0 Data 7</td> 
  </tr> 
  <tr> 
   <td>SPI0_SS0</td> 
   <td>SPI0 Chip Select 0</td> 
  </tr> 
  <tr> 
   <td>SPI0_SS1</td> 
   <td>SPI0 Chip Select 1</td> 
  </tr> 
  <tr> 
   <td>SPI0_SS2</td> 
   <td>SPI0 Chip Select 2</td> 
  </tr> 
  <tr> 
   <td>SPI0_SS3</td> 
   <td>SPI0 Chip Select 3</td> 
  </tr> 
  <tr> 
   <td>SPI0_ARB</td> 
   <td>SPI0 Arbitration</td> 
  </tr> 
  <tr> 
   <td>SPI0_SCLK</td> 
   <td>SPI0 Serial Clock</td> 
  </tr> 
  <tr> 
   <td>UARTHS_RX</td> 
   <td>UART High speed Receiver</td> 
  </tr> 
  <tr> 
   <td>UARTHS_TX</td> 
   <td>UART High speed Transmitter</td> 
  </tr> 
  <tr> 
   <td>RESV6</td> 
   <td>Reserved function</td> 
  </tr> 
  <tr> 
   <td>RESV7</td> 
   <td>Reserved function</td> 
  </tr> 
  <tr> 
   <td>CLK_SPI1</td> 
   <td>Clock SPI1</td> 
  </tr> 
  <tr> 
   <td>CLK_I2C1</td> 
   <td>Clock I2C1</td> 
  </tr> 
  <tr> 
   <td>GPIOHS0</td> 
   <td>GPIO High speed 0</td> 
  </tr> 
  <tr> 
   <td>GPIOHS1</td> 
   <td>GPIO High speed 1</td> 
  </tr> 
  <tr> 
   <td>GPIOHS2</td> 
   <td>GPIO High speed 2</td> 
  </tr> 
  <tr> 
   <td>GPIOHS3</td> 
   <td>GPIO High speed 3</td> 
  </tr> 
  <tr> 
   <td>GPIOHS4</td> 
   <td>GPIO High speed 4</td> 
  </tr> 
  <tr> 
   <td>GPIOHS5</td> 
   <td>GPIO High speed 5</td> 
  </tr> 
  <tr> 
   <td>GPIOHS6</td> 
   <td>GPIO High speed 6</td> 
  </tr> 
  <tr> 
   <td>GPIOHS7</td> 
   <td>GPIO High speed 7</td> 
  </tr> 
  <tr> 
   <td>GPIOHS8</td> 
   <td>GPIO High speed 8</td> 
  </tr> 
  <tr> 
   <td>GPIOHS9</td> 
   <td>GPIO High speed 9</td> 
  </tr> 
  <tr> 
   <td>GPIOHS10</td> 
   <td>GPIO High speed 10</td> 
  </tr> 
  <tr> 
   <td>GPIOHS11</td> 
   <td>GPIO High speed 11</td> 
  </tr> 
  <tr> 
   <td>GPIOHS12</td> 
   <td>GPIO High speed 12</td> 
  </tr> 
  <tr> 
   <td>GPIOHS13</td> 
   <td>GPIO High speed 13</td> 
  </tr> 
  <tr> 
   <td>GPIOHS14</td> 
   <td>GPIO High speed 14</td> 
  </tr> 
  <tr> 
   <td>GPIOHS15</td> 
   <td>GPIO High speed 15</td> 
  </tr> 
  <tr> 
   <td>GPIOHS16</td> 
   <td>GPIO High speed 16</td> 
  </tr> 
  <tr> 
   <td>GPIOHS17</td> 
   <td>GPIO High speed 17</td> 
  </tr> 
  <tr> 
   <td>GPIOHS18</td> 
   <td>GPIO High speed 18</td> 
  </tr> 
  <tr> 
   <td>GPIOHS19</td> 
   <td>GPIO High speed 19</td> 
  </tr> 
  <tr> 
   <td>GPIOHS20</td> 
   <td>GPIO High speed 20</td> 
  </tr> 
  <tr> 
   <td>GPIOHS21</td> 
   <td>GPIO High speed 21</td> 
  </tr> 
  <tr> 
   <td>GPIOHS22</td> 
   <td>GPIO High speed 22</td> 
  </tr> 
  <tr> 
   <td>GPIOHS23</td> 
   <td>GPIO High speed 23</td> 
  </tr> 
  <tr> 
   <td>GPIOHS24</td> 
   <td>GPIO High speed 24</td> 
  </tr> 
  <tr> 
   <td>GPIOHS25</td> 
   <td>GPIO High speed 25</td> 
  </tr> 
  <tr> 
   <td>GPIOHS26</td> 
   <td>GPIO High speed 26</td> 
  </tr> 
  <tr> 
   <td>GPIOHS27</td> 
   <td>GPIO High speed 27</td> 
  </tr> 
  <tr> 
   <td>GPIOHS28</td> 
   <td>GPIO High speed 28</td> 
  </tr> 
  <tr> 
   <td>GPIOHS29</td> 
   <td>GPIO High speed 29</td> 
  </tr> 
  <tr> 
   <td>GPIOHS30</td> 
   <td>GPIO High speed 30</td> 
  </tr> 
  <tr> 
   <td>GPIOHS31</td> 
   <td>GPIO High speed 31</td> 
  </tr> 
  <tr> 
   <td>GPIO0</td> 
   <td>GPIO pin 0</td> 
  </tr> 
  <tr> 
   <td>GPIO1</td> 
   <td>GPIO pin 1</td> 
  </tr> 
  <tr> 
   <td>GPIO2</td> 
   <td>GPIO pin 2</td> 
  </tr> 
  <tr> 
   <td>GPIO3</td> 
   <td>GPIO pin 3</td> 
  </tr> 
  <tr> 
   <td>GPIO4</td> 
   <td>GPIO pin 4</td> 
  </tr> 
  <tr> 
   <td>GPIO5</td> 
   <td>GPIO pin 5</td> 
  </tr> 
  <tr> 
   <td>GPIO6</td> 
   <td>GPIO pin 6</td> 
  </tr> 
  <tr> 
   <td>GPIO7</td> 
   <td>GPIO pin 7</td> 
  </tr> 
  <tr> 
   <td>UART1_RX</td> 
   <td>UART1 Receiver</td> 
  </tr> 
  <tr> 
   <td>UART1_TX</td> 
   <td>UART1 Transmitter</td> 
  </tr> 
  <tr> 
   <td>UART2_RX</td> 
   <td>UART2 Receiver</td> 
  </tr> 
  <tr> 
   <td>UART2_TX</td> 
   <td>UART2 Transmitter</td> 
  </tr> 
  <tr> 
   <td>UART3_RX</td> 
   <td>UART3 Receiver</td> 
  </tr> 
  <tr> 
   <td>UART3_TX</td> 
   <td>UART3 Transmitter</td> 
  </tr> 
  <tr> 
   <td>SPI1_D0</td> 
   <td>SPI1 Data 0</td> 
  </tr> 
  <tr> 
   <td>SPI1_D1</td> 
   <td>SPI1 Data 1</td> 
  </tr> 
  <tr> 
   <td>SPI1_D2</td> 
   <td>SPI1 Data 2</td> 
  </tr> 
  <tr> 
   <td>SPI1_D3</td> 
   <td>SPI1 Data 3</td> 
  </tr> 
  <tr> 
   <td>SPI1_D4</td> 
   <td>SPI1 Data 4</td> 
  </tr> 
  <tr> 
   <td>SPI1_D5</td> 
   <td>SPI1 Data 5</td> 
  </tr> 
  <tr> 
   <td>SPI1_D6</td> 
   <td>SPI1 Data 6</td> 
  </tr> 
  <tr> 
   <td>SPI1_D7</td> 
   <td>SPI1 Data 7</td> 
  </tr> 
  <tr> 
   <td>SPI1_SS0</td> 
   <td>SPI1 Chip Select 0</td> 
  </tr> 
  <tr> 
   <td>SPI1_SS1</td> 
   <td>SPI1 Chip Select 1</td> 
  </tr> 
  <tr> 
   <td>SPI1_SS2</td> 
   <td>SPI1 Chip Select 2</td> 
  </tr> 
  <tr> 
   <td>SPI1_SS3</td> 
   <td>SPI1 Chip Select 3</td> 
  </tr> 
  <tr> 
   <td>SPI1_ARB</td> 
   <td>SPI1 Arbitration</td> 
  </tr> 
  <tr> 
   <td>SPI1_SCLK</td> 
   <td>SPI1 Serial Clock</td> 
  </tr> 
  <tr> 
   <td>SPI_SLAVE_D0</td> 
   <td>SPI Slave Data 0</td> 
  </tr> 
  <tr> 
   <td>SPI_SLAVE_SS</td> 
   <td>SPI Slave Select</td> 
  </tr> 
  <tr> 
   <td>SPI_SLAVE_SCLK</td> 
   <td>SPI Slave Serial Clock</td> 
  </tr> 
  <tr> 
   <td>I2S0_MCLK</td> 
   <td>I2S0 Master Clock</td> 
  </tr> 
  <tr> 
   <td>I2S0_SCLK</td> 
   <td>I2S0 Serial Clock(BCLK)</td> 
  </tr> 
  <tr> 
   <td>I2S0_WS</td> 
   <td>I2S0 Word Select(LRCLK)</td> 
  </tr> 
  <tr> 
   <td>I2S0_IN_D0</td> 
   <td>I2S0 Serial Data Input 0</td> 
  </tr> 
  <tr> 
   <td>I2S0_IN_D1</td> 
   <td>I2S0 Serial Data Input 1</td> 
  </tr> 
  <tr> 
   <td>I2S0_IN_D2</td> 
   <td>I2S0 Serial Data Input 2</td> 
  </tr> 
  <tr> 
   <td>I2S0_IN_D3</td> 
   <td>I2S0 Serial Data Input 3</td> 
  </tr> 
  <tr> 
   <td>I2S0_OUT_D0</td> 
   <td>I2S0 Serial Data Output 0</td> 
  </tr> 
  <tr> 
   <td>I2S0_OUT_D1</td> 
   <td>I2S0 Serial Data Output 1</td> 
  </tr> 
  <tr> 
   <td>I2S0_OUT_D2</td> 
   <td>I2S0 Serial Data Output 2</td> 
  </tr> 
  <tr> 
   <td>I2S0_OUT_D3</td> 
   <td>I2S0 Serial Data Output 3</td> 
  </tr> 
  <tr> 
   <td>I2S1_MCLK</td> 
   <td>I2S1 Master Clock</td> 
  </tr> 
  <tr> 
   <td>I2S1_SCLK</td> 
   <td>I2S1 Serial Clock(BCLK)</td> 
  </tr> 
  <tr> 
   <td>I2S1_WS</td> 
   <td>I2S1 Word Select(LRCLK)</td> 
  </tr> 
  <tr> 
   <td>I2S1_IN_D0</td> 
   <td>I2S1 Serial Data Input 0</td> 
  </tr> 
  <tr> 
   <td>I2S1_IN_D1</td> 
   <td>I2S1 Serial Data Input 1</td> 
  </tr> 
  <tr> 
   <td>I2S1_IN_D2</td> 
   <td>I2S1 Serial Data Input 2</td> 
  </tr> 
  <tr> 
   <td>I2S1_IN_D3</td> 
   <td>I2S1 Serial Data Input 3</td> 
  </tr> 
  <tr> 
   <td>I2S1_OUT_D0</td> 
   <td>I2S1 Serial Data Output 0</td> 
  </tr> 
  <tr> 
   <td>I2S1_OUT_D1</td> 
   <td>I2S1 Serial Data Output 1</td> 
  </tr> 
  <tr> 
   <td>I2S1_OUT_D2</td> 
   <td>I2S1 Serial Data Output 2</td> 
  </tr> 
  <tr> 
   <td>I2S1_OUT_D3</td> 
   <td>I2S1 Serial Data Output 3</td> 
  </tr> 
  <tr> 
   <td>I2S2_MCLK</td> 
   <td>I2S2 Master Clock</td> 
  </tr> 
  <tr> 
   <td>I2S2_SCLK</td> 
   <td>I2S2 Serial Clock(BCLK)</td> 
  </tr> 
  <tr> 
   <td>I2S2_WS</td> 
   <td>I2S2 Word Select(LRCLK)</td> 
  </tr> 
  <tr> 
   <td>I2S2_IN_D0</td> 
   <td>I2S2 Serial Data Input 0</td> 
  </tr> 
  <tr> 
   <td>I2S2_IN_D1</td> 
   <td>I2S2 Serial Data Input 1</td> 
  </tr> 
  <tr> 
   <td>I2S2_IN_D2</td> 
   <td>I2S2 Serial Data Input 2</td> 
  </tr> 
  <tr> 
   <td>I2S2_IN_D3</td> 
   <td>I2S2 Serial Data Input 3</td> 
  </tr> 
  <tr> 
   <td>I2S2_OUT_D0</td> 
   <td>I2S2 Serial Data Output 0</td> 
  </tr> 
  <tr> 
   <td>I2S2_OUT_D1</td> 
   <td>I2S2 Serial Data Output 1</td> 
  </tr> 
  <tr> 
   <td>I2S2_OUT_D2</td> 
   <td>I2S2 Serial Data Output 2</td> 
  </tr> 
  <tr> 
   <td>I2S2_OUT_D3</td> 
   <td>I2S2 Serial Data Output 3</td> 
  </tr> 
  <tr> 
   <td>RESV0</td> 
   <td>Reserved function</td> 
  </tr> 
  <tr> 
   <td>RESV1</td> 
   <td>Reserved function</td> 
  </tr> 
  <tr> 
   <td>RESV2</td> 
   <td>Reserved function</td> 
  </tr> 
  <tr> 
   <td>RESV3</td> 
   <td>Reserved function</td> 
  </tr> 
  <tr> 
   <td>RESV4</td> 
   <td>Reserved function</td> 
  </tr> 
  <tr> 
   <td>RESV5</td> 
   <td>Reserved function</td> 
  </tr> 
  <tr> 
   <td>I2C0_SCLK</td> 
   <td>I2C0 Serial Clock</td> 
  </tr> 
  <tr> 
   <td>I2C0_SDA</td> 
   <td>I2C0 Serial Data</td> 
  </tr> 
  <tr> 
   <td>I2C1_SCLK</td> 
   <td>I2C1 Serial Clock</td> 
  </tr> 
  <tr> 
   <td>I2C1_SDA</td> 
   <td>I2C1 Serial Data</td> 
  </tr> 
  <tr> 
   <td>I2C2_SCLK</td> 
   <td>I2C2 Serial Clock</td> 
  </tr> 
  <tr> 
   <td>I2C2_SDA</td> 
   <td>I2C2 Serial Data</td> 
  </tr> 
  <tr> 
   <td>CMOS_XCLK</td> 
   <td>DVP System Clock</td> 
  </tr> 
  <tr> 
   <td>CMOS_RST</td> 
   <td>DVP System Reset</td> 
  </tr> 
  <tr> 
   <td>CMOS_PWDN</td> 
   <td>DVP Power Down Mode</td> 
  </tr> 
  <tr> 
   <td>CMOS_VSYNC</td> 
   <td>DVP Vertical Sync</td> 
  </tr> 
  <tr> 
   <td>CMOS_HREF</td> 
   <td>DVP Horizontal Reference output</td> 
  </tr> 
  <tr> 
   <td>CMOS_PCLK</td> 
   <td>Pixel Clock</td> 
  </tr> 
  <tr> 
   <td>CMOS_D0</td> 
   <td>Data Bit 0</td> 
  </tr> 
  <tr> 
   <td>CMOS_D1</td> 
   <td>Data Bit 1</td> 
  </tr> 
  <tr> 
   <td>CMOS_D2</td> 
   <td>Data Bit 2</td> 
  </tr> 
  <tr> 
   <td>CMOS_D3</td> 
   <td>Data Bit 3</td> 
  </tr> 
  <tr> 
   <td>CMOS_D4</td> 
   <td>Data Bit 4</td> 
  </tr> 
  <tr> 
   <td>CMOS_D5</td> 
   <td>Data Bit 5</td> 
  </tr> 
  <tr> 
   <td>CMOS_D6</td> 
   <td>Data Bit 6</td> 
  </tr> 
  <tr> 
   <td>CMOS_D7</td> 
   <td>Data Bit 7</td> 
  </tr> 
  <tr> 
   <td>SCCB_SCLK</td> 
   <td>SCCB Serial Clock</td> 
  </tr> 
  <tr> 
   <td>SCCB_SDA</td> 
   <td>SCCB Serial Data</td> 
  </tr> 
  <tr> 
   <td>UART1_CTS</td> 
   <td>UART1 Clear To Send</td> 
  </tr> 
  <tr> 
   <td>UART1_DSR</td> 
   <td>UART1 Data Set Ready</td> 
  </tr> 
  <tr> 
   <td>UART1_DCD</td> 
   <td>UART1 Data Carrier Detect</td> 
  </tr> 
  <tr> 
   <td>UART1_RI</td> 
   <td>UART1 Ring Indicator</td> 
  </tr> 
  <tr> 
   <td>UART1_SIR_IN</td> 
   <td>UART1 Serial Infrared Input</td> 
  </tr> 
  <tr> 
   <td>UART1_DTR</td> 
   <td>UART1 Data Terminal Ready</td> 
  </tr> 
  <tr> 
   <td>UART1_RTS</td> 
   <td>UART1 Request To Send</td> 
  </tr> 
  <tr> 
   <td>UART1_OUT2</td> 
   <td>UART1 User-designated Output 2</td> 
  </tr> 
  <tr> 
   <td>UART1_OUT1</td> 
   <td>UART1 User-designated Output 1</td> 
  </tr> 
  <tr> 
   <td>UART1_SIR_OUT</td> 
   <td>UART1 Serial Infrared Output</td> 
  </tr> 
  <tr> 
   <td>UART1_BAUD</td> 
   <td>UART1 Transmit Clock Output</td> 
  </tr> 
  <tr> 
   <td>UART1_RE</td> 
   <td>UART1 Receiver Output Enable</td> 
  </tr> 
  <tr> 
   <td>UART1_DE</td> 
   <td>UART1 Driver Output Enable</td> 
  </tr> 
  <tr> 
   <td>UART1_RS485_EN</td> 
   <td>UART1 RS485 Enable</td> 
  </tr> 
  <tr> 
   <td>UART2_CTS</td> 
   <td>UART2 Clear To Send</td> 
  </tr> 
  <tr> 
   <td>UART2_DSR</td> 
   <td>UART2 Data Set Ready</td> 
  </tr> 
  <tr> 
   <td>UART2_DCD</td> 
   <td>UART2 Data Carrier Detect</td> 
  </tr> 
  <tr> 
   <td>UART2_RI</td> 
   <td>UART2 Ring Indicator</td> 
  </tr> 
  <tr> 
   <td>UART2_SIR_IN</td> 
   <td>UART2 Serial Infrared Input</td> 
  </tr> 
  <tr> 
   <td>UART2_DTR</td> 
   <td>UART2 Data Terminal Ready</td> 
  </tr> 
  <tr> 
   <td>UART2_RTS</td> 
   <td>UART2 Request To Send</td> 
  </tr> 
  <tr> 
   <td>UART2_OUT2</td> 
   <td>UART2 User-designated Output 2</td> 
  </tr> 
  <tr> 
   <td>UART2_OUT1</td> 
   <td>UART2 User-designated Output 1</td> 
  </tr> 
  <tr> 
   <td>UART2_SIR_OUT</td> 
   <td>UART2 Serial Infrared Output</td> 
  </tr> 
  <tr> 
   <td>UART2_BAUD</td> 
   <td>UART2 Transmit Clock Output</td> 
  </tr> 
  <tr> 
   <td>UART2_RE</td> 
   <td>UART2 Receiver Output Enable</td> 
  </tr> 
  <tr> 
   <td>UART2_DE</td> 
   <td>UART2 Driver Output Enable</td> 
  </tr> 
  <tr> 
   <td>UART2_RS485_EN</td> 
   <td>UART2 RS485 Enable</td> 
  </tr> 
  <tr> 
   <td>UART3_CTS</td> 
   <td>UART3 Clear To Send</td> 
  </tr> 
  <tr> 
   <td>UART3_DSR</td> 
   <td>UART3 Data Set Ready</td> 
  </tr> 
  <tr> 
   <td>UART3_DCD</td> 
   <td>UART3 Data Carrier Detect</td> 
  </tr> 
  <tr> 
   <td>UART3_RI</td> 
   <td>UART3 Ring Indicator</td> 
  </tr> 
  <tr> 
   <td>UART3_SIR_IN</td> 
   <td>UART3 Serial Infrared Input</td> 
  </tr> 
  <tr> 
   <td>UART3_DTR</td> 
   <td>UART3 Data Terminal Ready</td> 
  </tr> 
  <tr> 
   <td>UART3_RTS</td> 
   <td>UART3 Request To Send</td> 
  </tr> 
  <tr> 
   <td>UART3_OUT2</td> 
   <td>UART3 User-designated Output 2</td> 
  </tr> 
  <tr> 
   <td>UART3_OUT1</td> 
   <td>UART3 User-designated Output 1</td> 
  </tr> 
  <tr> 
   <td>UART3_SIR_OUT</td> 
   <td>UART3 Serial Infrared Output</td> 
  </tr> 
  <tr> 
   <td>UART3_BAUD</td> 
   <td>UART3 Transmit Clock Output</td> 
  </tr> 
  <tr> 
   <td>UART3_RE</td> 
   <td>UART3 Receiver Output Enable</td> 
  </tr> 
  <tr> 
   <td>UART3_DE</td> 
   <td>UART3 Driver Output Enable</td> 
  </tr> 
  <tr> 
   <td>UART3_RS485_EN</td> 
   <td>UART3 RS485 Enable</td> 
  </tr> 
  <tr> 
   <td>TIMER0_TOGGLE1</td> 
   <td>TIMER0 Toggle Output 1</td> 
  </tr> 
  <tr> 
   <td>TIMER0_TOGGLE2</td> 
   <td>TIMER0 Toggle Output 2</td> 
  </tr> 
  <tr> 
   <td>TIMER0_TOGGLE3</td> 
   <td>TIMER0 Toggle Output 3</td> 
  </tr> 
  <tr> 
   <td>TIMER0_TOGGLE4</td> 
   <td>TIMER0 Toggle Output 4</td> 
  </tr> 
  <tr> 
   <td>TIMER1_TOGGLE1</td> 
   <td>TIMER1 Toggle Output 1</td> 
  </tr> 
  <tr> 
   <td>TIMER1_TOGGLE2</td> 
   <td>TIMER1 Toggle Output 2</td> 
  </tr> 
  <tr> 
   <td>TIMER1_TOGGLE3</td> 
   <td>TIMER1 Toggle Output 3</td> 
  </tr> 
  <tr> 
   <td>TIMER1_TOGGLE4</td> 
   <td>TIMER1 Toggle Output 4</td> 
  </tr> 
  <tr> 
   <td>TIMER2_TOGGLE1</td> 
   <td>TIMER2 Toggle Output 1</td> 
  </tr> 
  <tr> 
   <td>TIMER2_TOGGLE2</td> 
   <td>TIMER2 Toggle Output 2</td> 
  </tr> 
  <tr> 
   <td>TIMER2_TOGGLE3</td> 
   <td>TIMER2 Toggle Output 3</td> 
  </tr> 
  <tr> 
   <td>TIMER2_TOGGLE4</td> 
   <td>TIMER2 Toggle Output 4</td> 
  </tr> 
  <tr> 
   <td>CLK_SPI2</td> 
   <td>Clock SPI2</td> 
  </tr> 
  <tr> 
   <td>CLK_I2C2</td> 
   <td>Clock I2C2</td> 
  </tr> 
 </tbody> 
</table>

# GPIO #

General Purpose Input Output （通用输入/输出）简称为 GPIO，或总线扩展器。

K210上有高速 GPIO(GPIOHS) 和通用 GPIO 在 K210 上， GPIO 有一下特征：

*  高速 GPIO：
    
    高速 GPIO 为 GPIOHS，共 32 个。具有如下特点：
    
     *  可配置输入输出信号
     *  每个 IO 具有独立中断源
     *  中断支持边沿触发和电平触发
     *  每个 IO 可以分配到 FPIOA 上 48 个管脚之一
     *  可配置上下拉，或者高阻
 *  通用 GPIO：
    
    通用 GPIO 共 8 个，具有如下特点:
    
     *  8 个 IO 使用一个中断源
     *  可配置输入输出信号
     *  可配置触发 IO 总中断，边沿触发和电平触发
     *  每个 IO 可以分配到 FPIOA 上 48 个管脚之一

**注意**:

一下 GPIOHS 默认已经被使用， 程序中如非必要尽量不要使用：

## 1. 构造函数 ##

class GPIO(ID, MODE, PULL, VALUE)

通过指定的参数新建一个 SPI 对象

### 1.1. 参数 ###

*  `ID`： 使用的 GPIO 引脚(一定要使用 GPIO 里带的常量来指定)
 *  `MODE`： GPIO模式
    
    • GPIO.IN就是输入模式
    
    • GPIO.OUT就是输出模式
 *  `PULL`： GPIO上下拉模式
    
    • GPIO.PULL\_UP 上拉
    
    • GPIO.PULL\_DOWN 下拉
    
    • GPIO.PULL\_NONE 即不上拉也不下拉

## 2. 方法 ##

### 2.1. value ###

修改/读取 GPIO 引脚状态

GPIO.value([value])

参数

*  `[value]`： 可选参数，如果此参数不为空，则返回当前 GPIO 引脚状态

返回值

如果 `[value]` 参数不为空，则返回当前 GPIO 引脚状态

### 2.2. irq ###

配置一个中断处理程序，当 `pin` 的触发源处于活动状态时调用它。如果管脚模式为 pin.in，则触发源是管脚上的外部值。

GPIO.irq(CALLBACK_FUNC,TRIGGER_CONDITION,GPIO.WAKEUP_NOT_SUPPORT,PRORITY)

参数

*  `CALLBACK_FUNC`：中断回调函数，当中断触发的时候被调用，一个入口函数 `pin_num`
    
    • PIN\_NUM 返回的是触发中断的 GPIO 引脚号(只有GPIOHS支持中断，所以这里的引脚号也是GPIOHS的引脚号)
 *  `TRIGGER_CONDITION`：GPIO 引脚的中断触发模式
    
    • GPIO.IRQ\_RISING 上升沿触发
    
    • GPIO.IRQ\_FALLING 下降沿触发
    
    • GPIO.IRQ\_BOTH 上升沿和下降沿都触发

返回值

无

### 2.3. disirq ###

关闭中断

GPIO.disirq()

参数

无

返回值

无

### 2.4. mode ###

GPIO模式

GPIO.mode(MODE)

参数

*  MODE
    
    • `GPIO.IN` 就是输入模式
    
    • `GPIO.OUT` 就是输出模式

返回值

无

### 2.5. pull ###

GPIO上下拉模式

GPIO.pull(PULL)

参数

*  PULL
    
    • `GPIO.IRQ_RISING` 上升沿触发
    
    • `GPIO.IRQ_FALLING` 下降沿触发
    
    • `GPIO.IRQ_BOTH` 上升沿和下降沿都触发

返回值

无

## 3. 常量 ##

*  `GPIO0`: GPIO0
 *  `GPIO1`: GPIO1
 *  `GPIO2`: GPIO2
 *  `GPIO3`: GPIO3
 *  `GPIO4`: GPIO4
 *  `GPIO5`: GPIO5
 *  `GPIO6`: GPIO6
 *  `GPIO7`: GPIO7
 *  `GPIOHS0`: GPIOHS0
 *  `GPIOHS1`: GPIOHS1
 *  `GPIOHS2`: GPIOHS2
 *  `GPIOHS3`: GPIOHS3
 *  `GPIOHS4`: GPIOHS4
 *  `GPIOHS5`: GPIOHS5
 *  `GPIOHS6`: GPIOHS6
 *  `GPIOHS7`: GPIOHS7
 *  `GPIOHS8`: GPIOHS8
 *  `GPIOHS9`: GPIOHS9
 *  `GPIOHS10`: GPIOHS10
 *  `GPIOHS11`: GPIOHS11
 *  `GPIOHS12`: GPIOHS12
 *  `GPIOHS13`: GPIOHS13
 *  `GPIOHS14`: GPIOHS14
 *  `GPIOHS15`: GPIOHS15
 *  `GPIOHS16`: GPIOHS16
 *  `GPIOHS17`: GPIOHS17
 *  `GPIOHS18`: GPIOHS18
 *  `GPIOHS19`: GPIOHS19
 *  `GPIOHS20`: GPIOHS20
 *  `GPIOHS21`: GPIOHS21
 *  `GPIOHS22`: GPIOHS22
 *  `GPIOHS23`: GPIOHS23
 *  `GPIOHS24`: GPIOHS24
 *  `GPIOHS25`: GPIOHS25
 *  `GPIOHS26`: GPIOHS26
 *  `GPIOHS27`: GPIOHS27
 *  `GPIOHS28`: GPIOHS28
 *  `GPIOHS29`: GPIOHS29
 *  `GPIOHS30`: GPIOHS30
 *  `GPIOHS31`: GPIOHS31
 *  `GPIO.IN`: 输入模式
 *  `GPIO.OUT`: 输出模式
 *  `GPIO.PULL_UP`: 上拉
 *  `GPIO.PULL_DOWN`: 下拉
 *  `GPIO.PULL_NONE`: 即不上拉也不下拉
 *  `GPIO.IRQ_RISING`: 上升沿触发
 *  `GPIO.IRQ_FALLING`:下降沿触发
 *  `GPIO.IRQ_BOTH`: 上升沿和下降沿都触发

### 3.1. DEMO1: 点亮 LED ###

import utime
    from Maix import GPIO
    from board import board_info
    from fpioa_manager import fm
    
    fm.register(board_info.LED_R,fm.fpioa.GPIO0)
    led_r=GPIO(GPIO.GPIO0,GPIO.OUT)
    utime.sleep_ms(500)
    led_r.value()
    fm.unregister(board_info.LED_R,fm.fpioa.GPIO0)

### 3.2. DEMO2: 按键按下点亮 LED ###

import utime
    from Maix import GPIO
    from board import board_info
    from fpioa_manager import fm
    
    fm.register(board_info.LED_R,fm.fpioa.GPIO0)
    led_b = GPIO(GPIO.GPIO0,GPIO.OUT)
    led_b.value(1)
    
    fm.register(board_info.BOOT_KEY, fm.fpioa.GPIOHS1)
    key = GPIO(GPIO.GPIOHS1, GPIO.IN)
    
    utime.sleep_ms(100)
    while True:
        if key.value() == 0: # 等待按键按下
            led_b.value(0)
            utime.sleep_ms(1000)
            break
        utime.sleep_ms(10)
    
    
    led_b.value(1)
    
    fm.unregister(board_info.LED_R,fm.fpioa.GPIOHS0)
    fm.unregister(board_info.BOOT_KEY,fm.fpioa.GPIOHS1)

### 3.3. DEMO3: 在 3 秒内等待按键触发中断 ###

import utime
    from Maix import GPIO
    from board import board_info
    from fpioa_manager import fm
    
    def test_irq(pin_num):
        print("key", pin_num, "\n")
    
    fm.register(board_info.BOOT_KEY, fm.fpioa.GPIOHS0)
    key = GPIO(GPIO.GPIOHS0, GPIO.IN, GPIO.PULL_NONE)
    
    utime.sleep_ms(100)
    key.irq(test_irq, GPIO.IRQ_BOTH, GPIO.WAKEUP_NOT_SUPPORT,7)
    utime.sleep_ms(3000) # 在 3 秒内等待触发
    
    key.disirq() # 禁用中断
    fm.unregister(board_info.BOOT_KEY,fm.fpioa.GPIOHS0)

[Link 1]: https://cn.maixpy.sipeed.com/zh/api_reference/Maix/fpioa.html#%E9%99%84%E5%BD%95%EF%BC%9A-%E5%A4%96%E8%AE%BE%E8%A1%A8