??簡介

脈沖寬度調制(PWM)，是英文“Pulse Width Modulation”的縮寫，簡稱脈寬調制，是利用微處理器的數字輸出來對模擬電路進行控制的一種非常有效的技術，廣泛應用在從測量、通信到功率控制與變換的許多領域中。以下簡述幾個關鍵的概念：

圖1

• PWM周期：指信號從高電平到低電平再回到高電平的時間，如上圖T所示。
• PWM頻率一秒內PWM周期的次數。
• 占空比：一個周期內高電平持續時間所占的比例即（T1 / T）。
• 脈寬時間：高電平時間。

??接口介紹

函數列表：

下表為PWM接口相關結構體類型。

結構體類型表：

1. aw_pwm_config_t

typedef struct { 
    uint32_t duty_ns;
    uint32_t period_ns;
    uint32_t is_inverse;
} aw_pwm_config_t;

成員詳解：

• duty_ns：pwm周期中高電平的有效時間 ns為單位。
• period_ns：pwm周期ns為單位。

• is_inverse：輸出波形是否反相，0表示不反相。

2. aw_pwm_config_frac

typedef struct aw_pwm_config_frac { 


    uint32_t duty_numerator;
    uint32_t duty_denominator; 
    uint32_t period_numerator;
    uint32_t period_denominator;
    uint32_t is_inverse;
} aw_pwm_config_frac_t;

PWM配置參數結構體(分數形式)，用分數表示，更精確。

• duty_numerator：PWM周期中高電平的有效時間分子部分。

• duty_denominator：PWM周期中高電平的有效時間分母部分。

• period_numerator：PWM周期分子部分。

• period_denominator：PWM周期分母部分。

• is_inverse：PWM輸出波形輸出是否反向，0:不反向，1：反向。

??使用樣例

AWorksLP SDK相關使用請參考《AWorksLP SDK快速入門（MR6450）——開箱體驗》一文，本文不在贅述。

/**
 * rief PWM演示例程入口
 * 
eturn 無
 */
aw_local void* __task_handle (void *arg)
{
    uint32_t    period1 = 2000000;      /* (ns) */
    uint32_t    period2 = 1000000;      /* (ns) */
    int         fd;
    int         ret;
    aw_pwm_config_t         pwm_config;


    aw_kprintf("
PWM demo testing...
");
    fd = aw_open(CONFIG_DEMO_PWM_DEVICE_NAME, AW_O_RDWR, 0);
    if(fd < 0){
        aw_kprintf("pwm open failed 
");
        aw_close(fd);
        return 0;
    }
    ret = aw_pwm_config_get(fd, &pwm_config);


    /* period 配置不可以為0
     * duty配置為0，這時可以配置成功：輸出一直為低
     * duty配置為peroid，占空比為100%，也可配置成功：輸出一直為高
     * PWM正在進行輸出，不可配置 */
    pwm_config.duty_ns = period1 / 2;
    pwm_config.is_inverse = 0;
    pwm_config.period_ns = period1;
    aw_pwm_config_set(fd, &pwm_config);
    while(1) {


        /* 配置 PWM 的有效時間（高電平時間）50% ,周期 period1*/
        aw_pwm_config_set(fd, &pwm_config);
        aw_pwm_enable(fd);      /* 使能通道 */
        aw_mdelay(250);
        aw_pwm_disable(fd);     /* 禁能通道 */
        aw_mdelay(250);
        
        /* 輸出五個周期pwm波*/
        aw_pwm_accurate_output(fd, 5);


        /* 配置 PWM 的有效時間（高電平時間）2% ,周期 period1*/
        pwm_config.duty_ns =  period1 / 50;
        aw_pwm_config_set(fd, &pwm_config);
        aw_pwm_enable(fd);      /* 使能通道 */
        aw_mdelay(250);
        aw_pwm_disable(fd);     /* 禁能通道 */
        aw_mdelay(250);


        pwm_config.duty_ns = period2 / 2;
        pwm_config.period_ns = period2;
        /* 配置 PWM 的有效時間（高電平時間）50% ,周期 period2*/
        aw_pwm_config_set(fd, &pwm_config);
        aw_pwm_enable(fd);      /* 使能通道 */
        aw_mdelay(250);
        aw_pwm_disable(fd);     /* 禁能通道 */
        aw_mdelay(250);




        /* 配置 PWM 的有效時間（高電平時間）2% ,周期 period2*/
        pwm_config.duty_ns = period2 / 50;
        aw_pwm_config_set(fd, &pwm_config);
        aw_pwm_enable(fd);      /* 使能通道 */
        aw_mdelay(250);
        aw_pwm_disable(fd);     /* 禁能通道 */
        aw_mdelay(250);


        pwm_config.duty_ns = period1 / 2;
        pwm_config.period_ns = period1;
    }


    return 0;
}

圖2pwm排針

上述代碼中使用aw_pwm_config_get接口獲取PWM當前的配置信息，PWM周期中高電平的有效時間為1000000ns，PWM周期為2000000ns,也就是設置PWM的占空比為50%。使用aw_pwm_config_set接口設置PWM。使用aw_pwm_enable接口使能PWM，使用aw_pwm_disable接口關閉PWM，使用aw_pwm_accurate_output接口輸出任意個PWM波。

圖3占空比50%，周期2ms

圖4占空比2%，周期2ms

圖5占空比50%，周期1ms

圖6占空比2%，周期1ms

/**
 * rief 建立蜂鳴器例程入口
 * 
eturn 無
 */
aw_local void* __task_handle (void *arg)
{
    int             fd;
    fd = aw_open("/dev/Buzzer", AW_O_RDWR, 0);
    if(fd < 0){
        aw_kprintf("Buzzer open failed 
");
        aw_close(fd);
        return 0;
    }


    while(1) {
        /* 強度調節設備驅動無源蜂鳴器 */
        aw_buzzer_loud_set(fd, 80); /* 設置蜂鳴器鳴叫強度 */
        aw_buzzer_beep(fd, 500);    /* 啟動蜂鳴器延時500ms */


        /* GPIO驅動直流蜂鳴器 */
        aw_buzzer_loud_set(fd, 50); /* 設置蜂鳴器鳴叫強度 */
        aw_buzzer_on(fd);         /* 啟動蜂鳴器 */
        aw_mdelay(500);         /* 延時500ms */
        aw_buzzer_off(fd);        /* 關閉蜂鳴器 */
        aw_mdelay(500);         /* 延時500ms */
    }
    aw_close(fd);
    return 0;
}

蜂鳴器在開發板上的位置如圖7所示。

圖7蜂鳴器位置

蜂鳴器引腳所對應的PWM通道為pwm3_chan1，如下圖所示。

圖8蜂鳴器對應引腳

圖9PWM對應引腳

圖10蜂鳴器對應的PWM通道