AWorksLP 對(duì)外設(shè)進(jìn)行了高度抽象化，為同一類外設(shè)提供了相同的接口，應(yīng)用程序可以輕松跨平臺(tái)。本文以MR6450（點(diǎn)擊了解詳情）平臺(tái)為例，介紹AWorksLP PWM 外設(shè)基本用法。

?簡(jiǎn)介

脈沖寬度調(diào)制(PWM)，是英文“Pulse Width Modulation”的縮寫(xiě)，簡(jiǎn)稱脈寬調(diào)制，是利用微處理器的數(shù)字輸出來(lái)對(duì)模擬電路進(jìn)行控制的一種非常有效的技術(shù)，廣泛應(yīng)用在從測(cè)量、通信到功率控制與變換的許多領(lǐng)域中。以下簡(jiǎn)述幾個(gè)關(guān)鍵的概念：

圖1

• PWM周期：指信號(hào)從高電平到低電平再回到高電平的時(shí)間，如上圖T所示。
• PWM頻率一秒內(nèi)PWM周期的次數(shù)。
• 占空比：一個(gè)周期內(nèi)高電平持續(xù)時(shí)間所占的比例即（T1 / T）。
• 脈寬時(shí)間：高電平時(shí)間。

?接口介紹

函數(shù)列表：

下表為PWM接口相關(guān)結(jié)構(gòu)體類型。

結(jié)構(gòu)體類型表：

PWM 配置信息說(shuō)明：

1. aw_pwm_config_t

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

PWM配置參數(shù)結(jié)構(gòu)體。

成員詳解：

• duty_ns：pwm周期中高電平的有效時(shí)間 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配置參數(shù)結(jié)構(gòu)體(分?jǐn)?shù)形式)，用分?jǐn)?shù)表示，更精確。

成員詳解：

duty_numerator：PWM周期中高電平的有效時(shí)間分子部分。

duty_denominator：PWM周期中高電平的有效時(shí)間分母部分。

period_numerator：PWM周期分子部分。

period_denominator：PWM周期分母部分。

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

?使用樣例

AWorksLP SDK相關(guān)使用請(qǐng)參考《AWorksLP SDK快速入門(mén)（MR6450）——開(kāi)箱體驗(yàn)》一文，本文不在贅述。

1. PWM單通道輸出功能{SDK}\demos\peripheral\pwm路徑下為PWM例程，例程關(guān)鍵代碼如下：

/** * \brief PWM演示例程入口 * \return 無(wú) */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("\nPWM demo testing...\n"); fd = aw_open(CONFIG_DEMO_PWM_DEVICE_NAME, AW_O_RDWR, 0); if(fd < 0){ aw_kprintf("pwm open failed \r\n"); aw_close(fd); return 0; } ret = aw_pwm_config_get(fd, &pwm_config);
/* period 配置不可以為0 * duty配置為0，這時(shí)可以配置成功：輸出一直為低 * duty配置為peroid，占空比為100%，也可配置成功：輸出一直為高 * PWM正在進(jìn)行輸出，不可配置 */ 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 的有效時(shí)間（高電平時(shí)間）50% ,周期 period1*/ aw_pwm_config_set(fd, &pwm_config); aw_pwm_enable(fd); /* 使能通道 */ aw_mdelay(250); aw_pwm_disable(fd); /* 禁能通道 */ aw_mdelay(250); /* 輸出五個(gè)周期pwm波*/ aw_pwm_accurate_output(fd, 5);
/* 配置 PWM 的有效時(shí)間（高電平時(shí)間）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 的有效時(shí)間（高電平時(shí)間）50% ,周期 period2*/ aw_pwm_config_set(fd, &pwm_config); aw_pwm_enable(fd); /* 使能通道 */ aw_mdelay(250); aw_pwm_disable(fd); /* 禁能通道 */ aw_mdelay(250);

/* 配置 PWM 的有效時(shí)間（高電平時(shí)間）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;}

例程默認(rèn)使用pwm3_chan4對(duì)應(yīng)開(kāi)發(fā)板的位置如圖2所示：

圖2pwm排針

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

在while循環(huán)中每間隔一段時(shí)間通過(guò)設(shè)置PWM的參數(shù)，從而輸出各種PWM的波形，下圖為例程中輸出的各種PWM波形。

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

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

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

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

2.蜂鳴器輸出{SDK}\demos\peripheral\buzzer路徑下為蜂鳴器例程，例程關(guān)鍵代碼如下：

/** * \brief 建立蜂鳴器例程入口 * \return 無(wú) */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 \r\n"); aw_close(fd); return 0; }
while(1) { /* 強(qiáng)度調(diào)節(jié)設(shè)備驅(qū)動(dòng)無(wú)源蜂鳴器 */ aw_buzzer_loud_set(fd, 80); /* 設(shè)置蜂鳴器鳴叫強(qiáng)度 */ aw_buzzer_beep(fd, 500); /* 啟動(dòng)蜂鳴器延時(shí)500ms */
/* GPIO驅(qū)動(dòng)直流蜂鳴器 */ aw_buzzer_loud_set(fd, 50); /* 設(shè)置蜂鳴器鳴叫強(qiáng)度 */ aw_buzzer_on(fd); /* 啟動(dòng)蜂鳴器 */ aw_mdelay(500); /* 延時(shí)500ms */ aw_buzzer_off(fd); /* 關(guān)閉蜂鳴器 */ aw_mdelay(500); /* 延時(shí)500ms */ } aw_close(fd); return 0;}

蜂鳴器在開(kāi)發(fā)板上的位置如圖7所示。

圖7蜂鳴器位置

蜂鳴器引腳所對(duì)應(yīng)的PWM通道為pwm3_chan1，如下圖所示。

圖8蜂鳴器對(duì)應(yīng)引腳

圖9PWM對(duì)應(yīng)引腳

圖10蜂鳴器對(duì)應(yīng)的PWM通道

上述代碼中在while循中環(huán)使用aw_buzzer_loud_set接口設(shè)置蜂鳴器的鳴叫程度為80，相當(dāng)于調(diào)節(jié)PWM的占空比。然后使用aw_buzzer_beep接口使蜂鳴器鳴叫一段時(shí)間后關(guān)閉。再設(shè)置蜂鳴器的鳴叫程度為50，使用aw_buzzer_on接口啟動(dòng)蜂鳴器，相當(dāng)于使能PWM，延時(shí)一段時(shí)間后用aw_buzzer_off接口關(guān)閉蜂鳴器，相當(dāng)于關(guān)閉PWM，然后再延時(shí)一段時(shí)間。實(shí)驗(yàn)現(xiàn)象為蜂鳴器先以較大的聲音鳴叫一段時(shí)間后以較小的聲音鳴叫一段時(shí)間后停止鳴叫，持續(xù)一段時(shí)間后再次循環(huán)。在PWM例程中，PWM作為設(shè)備資源被Buzzer引用，可在配置界面中查看所有可引用資源，也可以在界面中查看當(dāng)前平臺(tái)所有PWM資源，以便在軟件設(shè)計(jì)過(guò)程中查看修改。本文以PWM外設(shè)通用接口為例，演示了單通道的輸出以及接口特性，同時(shí)與蜂鳴器進(jìn)行設(shè)備綁定，后續(xù)將會(huì)更詳細(xì)的介紹多通道的輸出以及相關(guān)特性，請(qǐng)持續(xù)關(guān)注后續(xù)推文~