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

本文介绍如何在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

---

原文连接：
https://developer.huawei.com/consumer/cn/forum/topic/0204398682948650101?fid=0101303901040230869做者：思惟