安信可離線語(yǔ)音VC-01/02：硬件規(guī)格書、開發(fā)資料、燒錄工具、應(yīng)用開發(fā)

安信可離線語(yǔ)音模組 VC-01、VC-02 系列教程 【基礎(chǔ)認(rèn)知篇】
安信可離線語(yǔ)音模組 VC-01、VC-02 系列教程 【快速上手篇】
安信可離線語(yǔ)音模組 VC-01、VC-02 系列教程 【中級(jí)入門篇】
安信可離線語(yǔ)音模組 VC-01、VC-02 系列教程 【高級(jí)進(jìn)階篇】
安信可離線語(yǔ)音模組 VC-01、VC-02 系列教程 【二次開發(fā)篇】虛擬開發(fā)環(huán)境搭建和分享
安信可離線語(yǔ)音模組 VC-01、VC-02 系列教程 【二次開發(fā)篇】事件和GPIO控制
安信可離線語(yǔ)音模組 VC-01、VC-02 系列教程 【二次開發(fā)篇】PWM輸出
安信可離線語(yǔ)音模組 VC-01、VC-02 系列教程 【二次開發(fā)篇】串口輸出
安信可離線語(yǔ)音模組 VC-01、VC-02 系列教程 【二次開發(fā)篇】SDK音頻替換失敗記錄過程
安信可離線語(yǔ)音模組 VC-01、VC-02 系列教程 【二次開發(fā)篇】自定義音頻播放控制

安信可離線語(yǔ)音模組 VC-01、VC-02 系列教程 【二次開發(fā)篇】PWM輸出

簡(jiǎn)介

在上一篇文章中我們對(duì)SDK的GPIO輸出進(jìn)行了控制， 我們將在本章節(jié)對(duì)PWM的輸出進(jìn)行控制（如果沒有看過上一篇文章的，建議先去看對(duì)組件和設(shè)計(jì)的庫(kù)函數(shù)的介紹），本篇SDK文件還是使用的上一章節(jié)的SDK（如無特殊說明，SDK不變）。

默認(rèn)PWM DEMO輸出現(xiàn)象

首先，在user_config.h 文件中開啟對(duì)PWMLED的宏， 使其用戶代碼默認(rèn)燒錄USER_DEMO_PWM_LED的例程。

根據(jù)對(duì)應(yīng)的hb_pwm_led.c 得知， 其線程啟動(dòng)后，主要是控制PWM_NUM_1_A27進(jìn)行輸出。

#define PWM_LED_GPIO_NUM  PWM_NUM_1_A27   // "MOSI" on HB-M demo board

首先對(duì)默認(rèn)的Demo進(jìn)行編譯，并且下載到VC-02中。

將示波器連接到開發(fā)板背部的GPIOA27上， 那么此時(shí)示波器的波形如下所示：

占空比緩慢變化

此時(shí)默認(rèn)的出廠PWM demo已經(jīng)測(cè)試完畢。

如果想控制對(duì)應(yīng)的PWM輸出，可以參考user_pwm.h 中的函數(shù)定義。函數(shù)聲明如下所示：

#ifndef USER_INC_USER_PWM_H_
#define USER_INC_USER_PWM_H_
#ifdef __cplusplus
  extern "C" {
#endif
#include "unione.h"
/** @ingroup uni_pwm_def
* PWM管腳號(hào)
*/
typedef enum {
  PWM_NUM_1_A27 = 0,
  PWM_NUM_1_B0,
  PWM_NUM_1_B2,      ///< PWM 1 only 1 pin work a time
  PWM_NUM_2_A28,     ///< used for PA enable, don't use it on HB-M demo board
  PWM_NUM_2_B1,
  PWM_NUM_2_B3,      ///< PWM 2 only 1 pin work a time
  PWM_NUM_MAX
}USER_PWM_NUM;
/** @addtogroup uni_pwm_inf
@{*/
/**
*@brief PWM初始化
*@param num PWM管腳號(hào)
*@param hz 頻率
*@param is_high_duty a TRUE :占空比用高電平持續(xù)時(shí)間計(jì)算; a FALSE :占空比用低電平持續(xù)時(shí)間計(jì)算
*@retval 0  操作成功
*@retval -1 操作失敗
*/
int user_pwm_init(USER_PWM_NUM num, uni_u32 hz, uni_bool is_high_duty);
/**
*@brief PWM反初始化
*@param num PWM管腳號(hào)
*@retval 0  操作成功
*@retval -1 操作失敗
*/
int user_pwm_final(USER_PWM_NUM num);
/**
*@brief 開使PWM輸出
*@param num PWM管腳號(hào)
*@param duty 占空比
*@retval 0  操作成功
*@retval -1 操作失敗
*/
int user_pwm_start(USER_PWM_NUM num, uni_u8 duty);
/**
*@brief 停止PWM輸出
*@param num PWM管腳號(hào)
*@retval 0  操作成功
*@retval -1 操作失敗
*/
int user_pwm_stop(USER_PWM_NUM num);
/**
*@brief 暫停PWM輸出
*@param num PWM管腳號(hào)
*@retval 0  操作成功
*@retval -1 操作失敗
*/
int user_pwm_pause(USER_PWM_NUM num);
/**
*@brief 恢復(fù)PWM輸出
*@param num PWM管腳號(hào)
*@retval 0  操作成功
*@retval -1 操作失敗
*/
int user_pwm_resume(USER_PWM_NUM num);
/**
*@brief PWM占空比切換
*@param num PWM管腳號(hào)
*@param duty 占空比
*@retval 0  操作成功
*@retval -1 操作失敗
*/
int user_pwm_change_duty(USER_PWM_NUM num, uni_u8 duty);
/**
*@brief PWM占空比增加
*@param num PWM管腳號(hào)
*@param ch_duty 增加的占空比
*@retval 0  操作成功
*@retval -1 操作失敗
*/
int user_pwm_duty_inc(USER_PWM_NUM num, uni_u8 ch_duty);
/**
*@brief PWM占空比減小
*@param num PWM管腳號(hào)
*@param ch_duty 減小的占空比
*@retval 0  操作成功
*@retval -1 操作失敗
*/
int user_pwm_duty_dec(USER_PWM_NUM num, uni_u8 ch_duty);
/** @}*/
#ifdef __cplusplus
}
#endif
#endif

自定義控制命令

嘗試使用喚醒命令 “你好小美” 來啟動(dòng)PWM進(jìn)程， 使用 “打開臺(tái)燈” 命令來刪除這個(gè)進(jìn)程，從而控制PWM進(jìn)行輸出。

由于官方的SDK寫的非常規(guī)范， 所以建議凡是個(gè)人相關(guān)的代碼都可以寫在example目錄下。

1、首先在example 目錄下創(chuàng)建hb_user_pwm_testing.c 文件，代碼如下所示：

#include "user_gpio.h"
#include "user_pwm_led.h"
#include "user_event.h"
#include "user_player.h"
#include "user_config.h"
#define PWM_LED_GPIO_NUM  PWM_NUM_1_A27   // "MOSI" on HB-M demo board
static uni_pthread_t g_pwm_thread_id = 0;
static bool g_pwm_thread_running = false;
// Thread function to update LED brightness levels
static void _pwm_led_process(void *args) {
  LED_BRIGHT_LEVEL level = BRIGHT_LEVEL_0;
  g_pwm_thread_running = true;
  while (g_pwm_thread_running) {
    user_pwm_led_set_brightness(PWM_LED_GPIO_NUM, level);
    level += 1;
    if (level >= BRIGHT_LEVEL_MAX) {
      level = BRIGHT_LEVEL_0;
    }
    // uni_sleep(1); // Optional: slow down effect
  }
}
// Create PWM LED thread
static Result _create_pwm_led_thread(void) {
  if (g_pwm_thread_running) {
    return E_OK;
  }
  thread_param param;
  uni_memset(?m, 0, sizeof(param));
  param.stack_size = STACK_SMALL_SIZE;
  param.priority = OS_PRIORITY_LOW;
  uni_strncpy(param.task_name, "pwm_led", sizeof(param.task_name) - 1);
  if (0 != uni_pthread_create(&g_pwm_thread_id, ?m, _pwm_led_process, NULL)) {
    return E_FAILED;
  }
  uni_pthread_detach(g_pwm_thread_id);  // Auto cleanup
  return E_OK;
}
// Stop PWM thread
static void _stop_pwm_led_thread(void) {
  if (!g_pwm_thread_running) {
    return;
  }
  g_pwm_thread_running = false;
  // Destroy thread if supported (may be platform-specific)
  if (g_pwm_thread_id != 0) {
    uni_pthread_destroy(g_pwm_thread_id);  // Hard stop
    g_pwm_thread_id = 0;
  }
  user_pwm_led_set_brightness(PWM_LED_GPIO_NUM, BRIGHT_LEVEL_0);  // Turn off LED
}
// Callback on voice command
static void _on_wakeup_cmd_cb(USER_EVENT_TYPE event, user_event_context_t *context) {
  if (context == NULL) return;
  event_goto_awakend_t *awake = &context->goto_awakend;
  if (strcmp(awake->cmd, "wakeup_uni") == 0) {
    _create_pwm_led_thread();
    user_player_reply_list_random(awake->reply_files);
  }
}
static void _custom_setting_cb(USER_EVENT_TYPE event,
                               user_event_context_t *context) {
  event_custom_setting_t *setting = NULL;
  if (context) {
    setting = &context->custom_setting;
    if (strcmp(setting->cmd, "TurnOn") == 0) {
       _stop_pwm_led_thread();
       user_player_reply_list_random(setting->reply_files);
    }
  }
}
// Register event callback
static void _register_event_callback(void) {
  user_event_subscribe_event(USER_GOTO_AWAKENED, _on_wakeup_cmd_cb);
  user_event_subscribe_event(USER_CUSTOM_SETTING, _custom_setting_cb);
}
// Main entry
int hb_user_pwm_testing(void) {
  if (0 != user_pwm_led_init(PWM_LED_GPIO_NUM)) {
    return -1;
  }
  _register_event_callback();
  return 0;
}

上述代碼的主要功能是定義兩個(gè)用戶事件 ：

第一個(gè)為自定義設(shè)置的事件。

另一個(gè)則是喚醒事件 （上一篇文章中有介紹）。在識(shí)別到 “你好小美” 和 “打開燈光” 的時(shí)候控制對(duì)應(yīng)的PWM行為。 如果當(dāng)前PWM輸出的線程沒有被創(chuàng)建， 那么當(dāng)識(shí)別到“你好小美”的時(shí)候?qū)?dòng)線程。當(dāng)識(shí)別到“打開燈光”的時(shí)候則根據(jù)上述創(chuàng)建線程時(shí)的線程號(hào)刪除線程。

2、添加編譯支持在

/home/vc02/Downloads/uni_hb_m_solution/unione_lite_app_hb_m/build/user/src/examples下的subdir.mk添加對(duì)當(dāng)前編譯文件的引用。

3、 修改/home/vc02/Downloads/uni_hb_m_solution/unione_lite_app_hb_m/user/inc/user_config.h文件， 增加對(duì)應(yīng)的demo宏支持。

4、修改

/home/vc02/Downloads/uni_hb_m_solution/unione_lite_app_hb_m/user/src/user_main.c ，增加對(duì)上述自定義宏的支持。

5、編譯并且燒錄固件。

實(shí)驗(yàn)現(xiàn)象

默認(rèn)上電波形如下（不清楚為什么會(huì)有毛刺）

使用“你好小美” 喚醒，波形如下：

使用“你好小美”喚醒 + “打開燈光” 關(guān)閉PWM，輸出如下：

附件

uni_app_release_update.zip(882.62 KB, 下載次數(shù): 0)

總結(jié)

在上文中主要結(jié)合IO和PWM的example進(jìn)行了二次開發(fā)。其實(shí)可以發(fā)現(xiàn)，無論什么自定義功能，都是首先找到對(duì)應(yīng)的庫(kù)函數(shù)或者example進(jìn)行引用。

在明白原理之后定義創(chuàng)建自己的.c 文件，然再將當(dāng)前文件添加到編譯的上下文中，在對(duì)應(yīng)的h文件中開啟對(duì)自定義C文件的宏定義，即可完成自定義的功能的二次開發(fā)。

實(shí)際上這個(gè)SDK的完整度非常高， 代碼也非常規(guī)范！相信通過這幾篇文章你能很快上手安信可的離線語(yǔ)音產(chǎn)品，下期再見~

審核編輯 黃宇