1# BearPi-HM_Nano开发板基础外设开发——PWM输出 2本示例将演示如何在BearPi-HM_Nano开发板上使用GPIO的PWM功能实现呼吸灯的效果。 3 4 5## PWM API分析 6本案例主要使用了以下几个API完成PWM功能实现呼吸灯功能。 7### IoTGpioInit() 8```c 9unsigned int IoTGpioInit(unsigned int id); 10``` 11 **描述：** 12 13初始化GPIO外设。 14### IoTGpioSetFunc() 15```c 16unsigned int IoTGpioSetFunc(unsigned int id, unsigned char val); 17``` 18**描述：** 19 20设置GPIO引脚复用功能。 21 22**参数：** 23 24|参数名|描述| 25|:--|:------| 26| id | 表示GPIO引脚号。 | 27| val | 表示GPIO复用功能。 | 28 29### IoTGpioSetDir() 30```c 31unsigned int IoTGpioSetDir(unsigned int id, IotGpioDir dir); 32``` 33**描述：** 34 35设置GPIO输出方向。 36 37**参数：** 38 39|参数名|描述| 40|:--|:------| 41| id | 表示GPIO引脚号。 | 42| dir | 表示GPIO输出方向。 | 43 44 45### IoTPwmInit() 46```c 47unsigned int IoTPwmInit(unsigned int port); 48``` 49**描述：** 50初始化PWM功能。 51 52**参数：** 53 54|参数名|描述| 55|:--|:------| 56| port | 表示PWM设备端口号。 | 57 58 59 60## IoTPwmStart() 61```c 62unsigned int IoTPwmStart(unsigned int port, unsigned short duty, unsigned int freq); 63``` 64**描述：** 65 66根据输入参数输出PWM信号。 67 68**参数：** 69 70|参数名|描述| 71|:--|:------| 72| port | PWM端口号。 | 73| duty| 占空比。 | 74| freq| 分频倍数。 | 75 76 77## 硬件设计 78本案例将使用板载的LED来验证GPIO的PWM功能，在BearPi-HM_Nano开发板上LED的连接电路图如下图所示，LED的控制引脚与主控芯片的GPIO_2连接，所以需要编写软件去控制GPIO_2输出PWM波实现呼吸灯的效果。 79 80 81 82## 软件设计 83 84**主要代码分析** 85 86PWMTask()为PWM测试主任务，该任务先调用 IoTGpioInit()初始化GPIO，因为LED灯的控制引脚接在GPIO_2上，所以通过调用IoTGpioSetFunc()将GPIO_2复用为PWM功能，并通过IoTPwmInit()初始化PWM2端口，最后在死循环里面间隔10us输出不同占空比的PWM波，实现呼吸灯的效果。 87```c 88/** 89 * @brief pwm task output PWM with different duty cycle 90 * 91 */ 92static void PwmTask(void) 93{ 94 unsigned int i; 95 96 // init gpio of LED 97 IoTGpioInit(LED_GPIO); 98 99 // set the GPIO_2 multiplexing function to PWM 100 IoTGpioSetFunc(LED_GPIO, IOT_GPIO_FUNC_GPIO_2_PWM2_OUT); 101 102 // set GPIO_2 is output mode 103 IoTGpioSetDir(LED_GPIO, IOT_GPIO_DIR_OUT); 104 105 // init PWM2 106 IoTPwmInit(LED_GPIO); 107 108 while (1) { 109 for (i = 0; i < PWM_CHANGE_TIMES; i++) { 110 // output PWM with different duty cycle 111 IoTPwmStart(LED_GPIO, i, PWM_FREQ); 112 usleep(PWM_DELAY_10US); 113 } 114 i = 0; 115 } 116} 117``` 118 119## 编译调试 120 121### 修改 BUILD.gn 文件 122 123 124修改`device\bearpi\bearpi_hm_nano\app` 路径下 BUILD.gn 文件，指定 `pwm_example` 参与编译。 125 126```r 127#"B1_basic_led_blink:led_example", 128#"B2_basic_button:button_example", 129"B3_basic_pwm_led:pwm_example", 130#"B4_basic_adc:adc_example", 131#"B5_basic_i2c_nfc:i2c_example", 132#"B6_basic_uart:uart_example", 133``` 134 135 136### 运行结果 137 138示例代码编译烧录代码后，按下开发板的RESET按键，开发板开始正常工作，LED开始不断变化亮度，实现呼吸灯的效果。 139 140