HarmonyOS鸿蒙Next在蜂鸣器上播放一曲《两只老虎》

HarmonyOS鸿蒙Next在蜂鸣器上播放一曲《两只老虎》 本文介绍如何在HiSpark Wi-Fi IoT套件上，使用Harmony OS IoT硬件子系统的PWM接口 驱动蜂鸣器 播放音乐。

用PWM输出方波的API

鸿蒙系统IoT硬件子系统提供了PWM相关接口，接口头文件为wifiiot_pwm.h，其中开始输出方波的接口为：

/**
 * @brief Outputs PWM signals based on the input parameters.
 *
 * This function outputs PWM signals from a specified port based on
 * the configured frequency division multiple and duty cycle.
 *
 * @param port Indicates the PWM port number.
 * @param duty Indicates the PWM duty cycle.
 * @param freq Indicates the frequency-division multiple.
 * @return Returns {@link WIFI_IOT_SUCCESS} if the operation is successful;
 * returns an error code defined in {@link wifiiot_errno.h} otherwise.
 * @since 1.0
 * @version 1.0
 */
unsigned int PwmStart(WifiIotPwmPort port, unsigned short duty, unsigned short freq);

PWM输出的方波频率

通过PwmStart接口的注释，可以知道freq参数是分频倍数，PWM实际输出的方波频率等于 PWM时钟源频率 除以 分频倍数，即

f = Fcs / freq

其中，Fcs是PWM时钟源频率；

PWM输出方波的占空比

通过PwmStart接口的duty参数可以控制输出方波的占空比，占空比是指PWM输出的方波波形的高电平时间占整个方波周期的比例，具体占空比值是 duty 和 freq的比值，例如想要输出占空比 50%的方波信号，那么duty填的值就要是 freq/2；

音符-频率对应关系

这个表中有一个规律——音高升高一个八度，频率升高一倍。

表格来自：https://liam.page/2018/04/09/pitch-interval-and-harmonic/

开发板可以输出的最低频率

通过前面的公式，我们知道：

  1. PWM输出的方波频率和freq成反比，freq越大，输出的方波频率越小；
  2. freq是unsinged short类型，最大值为65535； 因此，输出频率的最小值取决于时钟源，而PWM的默认时钟源为160M:
unsigned int HalPwmInit(HalWifiIotPwmPort port)
{
    if (hi_pwm_set_clock(PWM_CLK_160M) != HI_ERR_SUCCESS) {
        return (unsigned int)HAL_WIFI_IOT_FAILURE;
    }
    return hi_pwm_init((hi_pwm_port)port);
}

160M时钟源条件下，输出方波的最低频率是：160M/65535=2441.44…，这个频率还是略高，在上面的表格中没有找到音名。但是我可以用上面表格值继续往后推算两个八度，就能够覆盖这个频率（不过通常只使用7个八度，所以还是有点高）。

如果时钟源频率可以更低，那么输出频率也可以更低！

幸运的是，通过调用hi_pwm_set_clock接口，可以修改时钟源：

/**
 * @ingroup iot_pwm
 *
 * Enumerates the PWM clock sources.CNcomment:PWM时钟源枚举。CNend
 */
typedef enum {
    PWM_CLK_160M, /** 160M APB clock.CNcomment:160M 工作时钟 CNend */
    PWM_CLK_XTAL, /** 24M或40M crystal clock.CNcomment:24M或40M 晶体时钟 CNend */
    PWM_CLK_MAX  /** Maximum value, which cannot be used.CNcomment:最大值，不可使用CNend */
} hi_pwm_clk_source;

hi_u32 hi_pwm_set_clock(hi_pwm_clk_source clk_type);

通过注释我们知道hi_pwm_set_clock(PWM_CLK_XTAL);可以将时钟源设置为晶体时钟，晶体时钟可能为24M或40M；

那么问题来了——晶体时钟频率到底是多少？

可以通过实验测算出晶体时钟频率，具体步骤如下：

  1. 使用 hi_pwm_set_clock(PWM_CLK_XTAL); 设置时钟源为晶体时钟；
  2. 使用PwmStart(WIFI_IOT_PWM_PORT_PWM0, 201000, 401000);输出方波信号；
  3. 使用示波器测量方波频率，根据测量的频率计算时钟源频率；

经实际测量，方波频率为1000Hz，

因此，时钟频率为 1000 * 40 * 1000，即 40 MHz;

可以输出的方波最低频率

因此，方波最低频率就是 40M / 65535 ，也就是：

40 * 1000 * 1000 / 65535
610.3608758678569

对照上面的频率表，可以知道，能够输出E5及以上的所有音符；

准备曲谱

为了代码实现起来简单，我选择了《两只老虎》的曲谱作为素材，在简谱网找到了简谱：

简谱说明

简谱上的一些记号，有的同学可能不太清楚是什么意思，这里简单说明一下：

  1. 左上角的1=C是表示调式（可以不用关心），1是唱名，C是音名，1=C是正调（就是常规的对应关系: 1-C，2-D, 3-E, 4-F, 5-G, 6-A, 7-B）；
  2. 左上角的 4/4 是四四拍，是指 四分音符为一拍， 每小节有四拍；
  3. 下面谱子上的竖线就是每个小节分隔符，和4/4对应；
  4. “跑得快”上面5后面的横线表示延时一拍；
  5. “一只没有眼睛”一句，5后面的点表示顺延半拍，一条下划线表示二分之一时间，两条下划线表示四分之一时间；

编写代码

有了以上知识，我们就可以编写代码了，关键代码如下：

static const uint16_t g_tuneFreqs[] = { // 音符对应的分频系数
    0, // 40M Hz 时钟源，C6 ~ B6：
    38223, // 1 1046.5
    34052, // 2 1174.7
    30338, // 3 1318.5
    28635, // 4 1396.9
    25511, // 5 1568
    22728, // 6 1760
    20249, // 7 1975.5
    51021 // 5_ 783.99 // 低一个八度的 5
};

// 曲谱音符
static const uint8_t g_scoreNotes[] = {
    // 《两只老虎》简谱：http://www.jianpu.cn/pu/33/33945.htm
    1, 2, 3, 1,     1, 2, 3, 1,     3, 4, 5, 3, 4, 5,
    5, 6, 5, 4, 3, 1,   5, 6, 5, 4, 3, 1,   1, 8, 1, 1, 8, 1, // 最后两个 5 应该是低八度的，链接图片中的曲谱不对，声音到最后听起来不太对劲
};

// 曲谱时值，根据简谱记谱方法转写
static const uint8_t g_scoreDurations[] = {
    4, 4, 4, 4,     4, 4, 4, 4,     4, 4, 8, 4, 4, 8,
    3, 1, 3, 1, 4, 4,   3, 1, 3, 1, 4, 4,   4, 4, 8, 4, 4, 8,
};

static void *BeeperMusicTask(const char *arg)
{
    (void)arg;

    printf("BeeperMusicTask start!\r\n");

    hi_pwm_set_clock(PWM_CLK_XTAL); // 设置时钟源为晶体时钟（40MHz，默认时钟源160MHz）

    for (size_t i = 0; i < sizeof(g_scoreNotes)/sizeof(g_scoreNotes[0]); i++) {
        uint32_t tune = g_scoreNotes[i]; // 音符
        uint16_t freqDivisor = g_tuneFreqs[tune];
        uint32_t tuneInterval = g_scoreDurations[i] * (125*1000); // 音符时间
        printf("%d %d %d %d\r\n", tune, (40*1000*1000) / freqDivisor, freqDivisor, tuneInterval);
        PwmStart(WIFI_IOT_PWM_PORT_PWM0, freqDivisor/2, freqDivisor);
        usleep(tuneInterval);
        PwmStop(WIFI_IOT_PWM_PORT_PWM0);
    }

    return NULL;
}

谱子中最后两个5是错误的，应该是低八度的5，也就是5下面应该打一个点；我修改了代码，让整个曲子听起来更自然；

完整代码：https://gitee.com/hihopeorg/HarmonyOS-IoT-Application-Development/blob/master/02_device_control/beeper_music_demo.c


更多关于HarmonyOS鸿蒙Next在蜂鸣器上播放一曲《两只老虎》的实战教程也可以访问 https://www.itying.com/category-93-b0.html

6 回复

有视频，看这里：
https://www.bilibili.com/video/BV1fa4y1W7Vc/

更多关于HarmonyOS鸿蒙Next在蜂鸣器上播放一曲《两只老虎》的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


我就想知道周期为20ms的PWM输出波怎么弄？全网都没这方面的答案。

任务里面用GPIO加延时呀，为了防止过程中间被调出CPU，可以锁定内核

有点儿意思，这要是录成视频铁定会火

在HarmonyOS鸿蒙Next中，使用蜂鸣器播放《两只老虎》可以通过调用系统的音频接口实现。首先，需要获取蜂鸣器的控制权，然后通过设置频率和持续时间来生成音符。以下是实现步骤：

  1. 初始化蜂鸣器：使用AudioManager类初始化蜂鸣器设备。
  2. 定义音符：将《两只老虎》的每个音符对应的频率和持续时间定义为一个数组。
  3. 播放音符：遍历音符数组，依次调用蜂鸣器的setFrequency和play方法播放每个音符。
  4. 释放资源：播放完成后，释放蜂鸣器资源。

示例代码片段如下：

import audio from '@ohos.multimedia.audio';

// 初始化蜂鸣器
let audioManager = audio.getAudioManager();
let buzzer = audioManager.getOutputDevice(audio.DeviceFlag.DEVICE_FLAG_BUZZER);

// 定义《两只老虎》的音符和持续时间
let notes = [
    { frequency: 262, duration: 500 }, // C4
    { frequency: 294, duration: 500 }, // D4
    { frequency: 330, duration: 500 }, // E4
    { frequency: 262, duration: 500 }, // C4
    // 其他音符...
];

// 播放音符
for (let note of notes) {
    buzzer.setFrequency(note.frequency);
    buzzer.play();
    sleep(note.duration);
    buzzer.stop();
}

// 释放资源
buzzer.release();

通过以上步骤，可以在HarmonyOS鸿蒙Next的蜂鸣器上播放《两只老虎》。

在HarmonyOS鸿蒙Next中，通过控制蜂鸣器的频率和时长，可以播放《两只老虎》。首先，定义音符对应的频率，如C4为262Hz，D4为294Hz等。然后，按照《两只老虎》的旋律，依次设置蜂鸣器的频率和每个音符的持续时间。通过循环和延时函数，实现旋律的播放。具体代码需结合硬件平台和开发环境进行编写和调试。

回到顶部