【库文件汉化】1- 基于AiPi-Eyes-DU 点亮LED

介绍：

最近在学习小安派，手里也收到了来自于安信可的小安派S1，但是由于S1上并没有GPIO引出，因此为了验证芯片功能，我还同时购买了AIPI-Eyes-DU。此系列将GPIO口全部引出。非常方便学习和验证。
本章节将学习使用如何操作和使用GPIO。
首先要使用GPIO需要引入对应的GPIO头文件，文件位于 aithinker_Ai-M6X_SDK\drivers\lhal\include\bflb_gpio.h （当然也可以不引入，这样的话需要手动的根据BL616芯片手册结合原理图操作寄存器）。我这里为了方便学习使用，自己并且结合Chatgpt对bflb_gpio.h 做了注释的汉化，更方便大家的理解。
同时，我每使用一个外设资源便会将对应的外设资源汉化，并且上传到Github，非专业翻译，请大家以官方手册为准。如果有不准确的地方欢迎提Issue，我好加以修复。
汉化如下所示：

1. /**
   
2. * @brief 初始化GPIO引脚。
   
3. *
   
4. * @param [in] dev 设备句柄
   
5. * @param [in] pin GPIO引脚，使用 @ref GPIO_PIN
   
6. * @param [in] cfgset GPIO配置掩码
   
7. */
   
8. void bflb_gpio_init(struct bflb_device_s *dev, uint8_t pin, uint32_t cfgset);
   
9. 
   
10. /**
    
11. * @brief 使能GPIO引脚并设置为输入浮空状态。
    
12. *
    
13. * @param [in] dev 设备句柄
    
14. * @param [in] pin GPIO引脚，使用 @ref GPIO_PIN
    
15. */
    
16. void bflb_gpio_deinit(struct bflb_device_s *dev, uint8_t pin);
    
17. 
    
18. /**
    
19. * @brief 设置GPIO引脚为高电平。
    
20. *
    
21. * @param [in] dev 设备句柄
    
22. * @param [in] pin GPIO引脚，使用 @ref GPIO_PIN
    
23. */
    
24. void bflb_gpio_set(struct bflb_device_s *dev, uint8_t pin);
    
25. 
    
26. /**
    
27. * @brief 设置GPIO引脚为低电平。
    
28. *
    
29. * @param [in] dev 设备句柄
    
30. * @param [in] pin GPIO引脚，使用 @ref GPIO_PIN
    
31. */
    
32. void bflb_gpio_reset(struct bflb_device_s *dev, uint8_t pin);
    
33. 
    
34. /**
    
35. * @brief 从GPIO引脚读取电平状态。
    
36. *
    
37. * @param [in] dev 设备句柄
    
38. * @param [in] pin GPIO引脚，使用 @ref GPIO_PIN
    
39. * @return true表示高电平，否则为低电平
    
40. */
    
41. bool bflb_gpio_read(struct bflb_device_s *dev, uint8_t pin);
    
42. 
    
43. /**
    
44. * @brief 写入0~31号GPIO引脚。
    
45. *
    
46. * @param [in] dev 设备句柄
    
47. * @param [in] val 0~31号GPIO引脚的值
    
48. */
    
49. void bflb_gpio_pin0_31_write(struct bflb_device_s *dev, uint32_t val);
    
50. 
    
51. /**
    
52. * @brief 写入32~63号GPIO引脚。
    
53. *
    
54. * @param [in] dev 设备句柄
    
55. * @param [in] val 32~63号GPIO引脚的值
    
56. */
    
57. void bflb_gpio_pin32_63_write(struct bflb_device_s *dev, uint32_t val);
    
58. 
    
59. /**
    
60. * @brief 从0~31号GPIO引脚读取电平。
    
61. *
    
62. * @param [in] dev 设备句柄
    
63. * @return 0~31号GPIO引脚的电平
    
64. */
    
65. uint32_t bflb_gpio_pin0_31_read(struct bflb_device_s *dev);
    
66. 
    
67. /**
    
68. * @brief 从32~63号GPIO引脚读取电平。
    
69. *
    
70. * @param [in] dev 设备句柄
    
71. * @return 32~63号GPIO引脚的电平
    
72. */
    
73. uint32_t bflb_gpio_pin32_63_read(struct bflb_device_s *dev);
    
74. 
    
75. /**
    
76. * @brief 配置GPIO引脚中断。
    
77. *
    
78. * @param [in] dev 设备句柄
    
79. * @param [in] pin GPIO引脚，使用 @ref GPIO_PIN
    
80. * @param [in] trig_mode 触发中断的模式
    
81. */
    
82. void bflb_gpio_int_init(struct bflb_device_s *dev, uint8_t pin, uint8_t trig_mode);
    
83. 
    
84. /**
    
85. * @brief 使能或禁用GPIO引脚中断。
    
86. *
    
87. * @param [in] dev 设备句柄
    
88. * @param [in] pin GPIO引脚，使用 @ref GPIO_PIN
    
89. * @param [in] mask true表示禁用，false表示使能
    
90. */
    
91. void bflb_gpio_int_mask(struct bflb_device_s *dev, uint8_t pin, bool mask);
    
92. 
    
93. /**
    
94. * @brief 获取GPIO引脚中断状态。
    
95. *
    
96. * @param [in] dev 设备句柄
    
97. * @param [in] pin GPIO引脚，使用 @ref GPIO_PIN
    
98. * @return true表示有中断，false表示无中断
    
99. */
    
100. bool bflb_gpio_get_intstatus(struct bflb_device_s *dev, uint8_t pin);
     
101. 
     
102. /**
     
103. * @brief 清除GPIO引脚中断状态。
     
104. *
     
105. * @param [in] dev 设备句柄
     
106. * @param [in] pin GPIO引脚，使用 @ref GPIO_PIN
     
107. */
     
108. void bflb_gpio_int_clear(struct bflb_device_s *dev, uint8_t pin);
     
109. 
     
110. /**
     
111. * @brief 配置GPIO引脚为UART功能。
     
112. *
     
113. * @param [in] dev 设备句柄
     
114. * @param [in] pin GPIO引脚，使用 @ref GPIO_PIN
     
115. * @param [in] uart_func UART功能，使用 @ref GPIO_UART_FUNC
     
116. */
     
117. void bflb_gpio_uart_init(struct bflb_device_s *dev, uint8_t pin, uint8_t uart_func);
     
118. 
     
119. /**
     
120. * @brief 控制GPIO功能。
     
121. *
     
122. * @param [in] dev 设备句柄
     
123. * @param [in] cmd 功能命令，使用 @ref GPIO_CMD
     
124. * @param [in] arg 用户数据
     
125. * @return 失败时返回负数的错误值。
     
126. */
     
127. 
     
128. int bflb_gpio_feature_control(struct bflb_device_s *dev, int cmd, size_t arg);
     

复制代码

点亮RGB led灯，AiPi-Eyes-DU 默认出厂烧录了PWM RGB灯闪烁的代码，既然我们要学习肯定要自己去点亮一个小灯泡。
代码如下所示：

1. #include "bflb_gpio.h"
   
2. #include "board.h"
   
3. struct bflb_device_s *gpio;
   
4. int main(void)
   
5. {
   
6.     board_init();
   
7.    
   
8. 
   
9.     /**
   
10.      * @brief 从系统库函数中获取支持的外设,支持获取的外设资源如下
    
11.       adc dac ef_ctrl gpio uart0 uart1 spi0 pwm0 dma0_ch0
    
12.       dma0_ch1 dma0_ch2 dma0_ch3 dma0_ch4 dma0_ch5 dma0_ch6
    
13.       dma0_ch7 i2c0 timer0 timer1 rtc aes sha trng pka
    
14.       watchdog irtx irrx sdio2
    
15.      */
    
16.     gpio = bflb_device_get_by_name("gpio");
    
17.    
    
18.     //初始化GPIO端口，并且指定当前的端口模式
    
19.     bflb_gpio_init(gpio, GPIO_PIN_14,GPIO_OUTPUT |GPIO_PULLUP);
    
20.     bflb_gpio_init(gpio, GPIO_PIN_15,GPIO_OUTPUT |GPIO_PULLUP);
    
21.     bflb_gpio_init(gpio, GPIO_PIN_12,GPIO_OUTPUT |GPIO_PULLUP);
    
22. 
    
23.     //Enable GPIO 即高电平
    
24.     bflb_gpio_set(gpio,GPIO_PIN_14);
    
25.     bflb_gpio_set(gpio,GPIO_PIN_12);
    
26.     bflb_gpio_set(gpio,GPIO_PIN_15);
    
27.     while(1){};
    
28. }
    

复制代码

实验现象如下：



GitHub仓库： https://github.com/mz1874/bl616-chinese-header-files.git

打卡学习

学习

向大佬学习

王哥666

王哥666

yyds

大佬，多发点这个

学习