一、准备工作
二、硬件设计
三、软件设计
- 主要代码分析
- PWM API分析
- IoTPwmStart()
四、编译调试
- 修改 BUILD.gn 文件
- 运行结果

PWM输出

本示例将演示如何在BearPi-HM_Nano 2开发板上使用GPIO的PWM功能实现呼吸灯的效果。

一、准备工作

参考BearPi-HM_Nano_2十分钟上手教程完成开发环境搭建、代码获取等工作，以及熟悉代码的编译和烧录流程。

二、硬件设计

本案例将使用板载的LED来验证GPIO的PWM功能，在BearPi-HM_Nano 2开发板上LED的连接电路图如下图所示，LED的控制引脚与主控芯片的GPIO_2连接，所以需要编写软件去控制GPIO_2输出PWM波实现呼吸灯的效果。

打开device\bearpi\bearpi_hm_nano2\app\B3_basic_pwm_led\pwm_example.c，PWMTask()为PWM测试主任务，该任务先调用 IoTGpioInit()初始化GPIO，因为LED灯的控制引脚接在GPIO_2上，所以通过调用IoTGpioSetFunc()将GPIO_2复用为PWM功能，并通过IoTPwmInit()初始化PWM2端口，最后在死循环里面间隔10us输出不同占空比的PWM波，实现呼吸灯的效果。

/**
 * @brief pwm task output PWM with different duty cycle
 * 
 */
static void PwmTask(void)
{
    unsigned int i;

    //init gpio of LED
    IoTGpioInit(LED_GPIO);

    //set the GPIO_2 multiplexing function to PWM
    IoTGpioSetFunc(LED_GPIO, IOT_GPIO_FUNC_GPIO_2_PWM2_OUT);

    //set GPIO_2 is output mode
    IoTGpioSetDir(LED_GPIO, IOT_GPIO_DIR_OUT);

    //init PWM2 
    IoTPwmInit(LED_GPIO);

    while (1) {
        for (i = 0; i < 100; i ++)
        {
            //output PWM with different duty cycle
            IoTPwmStart(LED_GPIO, i, 40000);
            usleep(10);
        }
        i = 0;
    }
}

PWM API分析

本案例主要使用了以下几个API完成PWM功能实现呼吸灯功能。

IoTGpioInit()

unsigned int IoTGpioInit(unsigned int id);

描述：

初始化GPIO外设。

IoTGpioSetFunc()

unsigned int IoTGpioSetFunc(unsigned int id, unsigned char val);

描述：

设置GPIO引脚复用功能。

参数：

参数名	描述
id	表示GPIO引脚号。
val	表示GPIO复用功能。

IoTGpioSetDir()

unsigned int IoTGpioSetDir(unsigned int id, IotGpioDir dir);

描述：

设置GPIO输出方向。

参数：

参数名	描述
id	表示GPIO引脚号。
dir	表示GPIO输出方向。

IoTPwmInit()

unsigned int IoTPwmInit(unsigned int port);

描述： 初始化PWM功能。

参数：

参数名	描述
port	表示PWM设备端口号。

IoTPwmStart()

unsigned int IoTPwmStart(unsigned int port, unsigned short duty, unsigned int freq);

描述：

根据输入参数输出PWM信号。

参数：

参数名	描述
port	PWM端口号。
duty	占空比。
freq	分频倍数。

四、编译调试

修改 BUILD.gn 文件

修改device\bearpi\bearpi_hm_nano2\app 路径下 BUILD.gn 文件，指定 pwm_example 参与编译。

#"B1_basic_led_blink:led_example",
#"B2_basic_button:button_example",
"B3_basic_pwm_led:pwm_example",
#"B4_basic_adc:adc_example",
#"B5_basic_i2c_nfc:i2c_example",
#"B6_basic_uart:uart_example",

运行结果

示例代码编译烧录代码后，按下开发板的RESET按键，开发板开始正常工作，LED开始不断变化亮度，实现呼吸灯的效果。