nanoFramework.Iot.Device.Buzzer 1.2.613

蜂鸣器 - 蜂鸣器控制器

此设备绑定允许使用压电蜂鸣器播放特定音调。它使用占空比 50% 的 PWM 和各种频率。

支持三个引脚的压电蜂鸣器，以及两个引脚的压电蜂鸣器。

设备系列

此绑定已在两种类型的压电蜂鸣器上进行过测试。第一种类型的蜂鸣器有两个引脚 vcc 和 gnd。第二种类型的蜂鸣器有一个额外的 信号 引脚。

用法

Buzzer 类可以使用软件或硬件 PWM。这是通过初始化完全透明地完成的。

如果您要使用软件 PWM，请调用接受一个整数作为参数的构造函数： public Buzzer(int pinNumber)。

要使用硬件 PWM，确保正确地引用您想要使用的芯片和通道，并调用接受两个整数（芯片和通道）的构造函数。

另外，如果您想自己构造，也可以显式传递一个 PWMChannel。

以下是如何使用 Buzzer 的示例。

using (Buzzer buzzer = new Buzzer(21)); // Initialize buzzer with software PWM connected to pin 21.
{
    buzzer.PlayTone(440, 1000); // Play tone with frequency 440 hertz for one second.
}

重要 根据您的平台，您可能需要正确设置引脚。在 ESP32 的情况下，使用 nanoFramework.Hardware.Esp32 nuget，然后正确配置引脚，例如：Configuration.SetPinFunction(21, DeviceFunction.PWM1);。这应该在创建蜂鸣器之前完成。

蜂鸣器 允许在一定时间内播放特定音调，如上述示例所示。或者，您可以在开始播放音调后执行某些操作，然后再停止播放音调，如下例所示。

using (Buzzer buzzer = new Buzzer(21));
{
    buzzer.StartPlaying(440);
    Thread.Sleep(1000);
    buzzer.StopPlaying();
}

结果将与上一个示例相同。

蜂鸣器 允许您在任何时刻只播放一个音调。如果您将以不同的频率顺序调用 SetFrequency，则最后一个调用将覆盖之前的调用。以下示例解释了这一点。

using (Buzzer buzzer = new Buzzer(21)); // Initialize buzzer with software PWM connected to pin 21.
{
    buzzer.StartPlaying(440);
    Thread.Sleep(1000);
    buzzer.StartPlaying(880);
    Thread.Sleep(1000);
    buzzer.StopPlaying();
}

该示例将播放频率为 440Hz 的音调一秒钟，然后播放频率为 880Hz 的音调一秒钟。

使用蜂鸣器播放字母歌的示例

原理图

您有 2 种类型的蜂鸣器：只有 2 个引脚的蜂鸣器和有 3 个引脚的蜂鸣器。对于具有 3 个引脚的蜂鸣器：只需将蜂鸣器的 信号 引脚连接到晶体管开关引脚（任何有效的 GPIO），将 引脚连接到 +5v，将 gnd 引脚连接到地。对于具有 2 个引脚的蜂鸣器：将蜂鸣器的 引脚连接到晶体管开关引脚（任何有效的 GPIO）并将 gnd 连接到地。

您可以使用任何类型的蜂鸣器，顺序随意。无需对代码进行任何更改。

代码

此示例包含一个名为 MelodyPlayer 的蜂鸣器包装器。

MelodyPlayer 和 MelodyElement

使用以下语句创建 MelodyPlayer 的实例

MelodyPlayer player = new MelodyPlayer(new  Buzzer(26));

构造函数接受一个参数类型为 Buzzer。

初始化后，MelodyPlayer 允许通过一系列 MelodyElement 对象播放旋律。MelodyElement 是两种元素的基类

• NoteElement - 它将被播放。因此，在构造函数中，它接受 Note 和 Octave 以确定声音的频率，以及 Duration 以确定声音的持续时间。
• PauseElement - 它应该在前两个 NoteElement 之间创建一个停顿，因此它只具有作为构造函数参数的停顿持续时间。

如何使用

以下示例演示了如何创建 MelodyElement 序列以及如何使用 MelodyPlayer 播放它

IListMelodyElement sequence = new ListMelodyElement()
{
    new NoteElement(Note.C, Octave.Fourth, Duration.Quarter),
    new PauseElement(Duration.Quarter),
    new NoteElement(Note.C, Octave.Fourth, Duration.Quarter)
};

using (var player = new MelodyPlayer(new Buzzer(21)))
{
    player.Play(sequence, 100);
}

Play 方法 MelodyPlayer 接受一个 MelodyElement 序列作为第一个参数和一个速度作为第二个参数。速度是每分钟的四分之一音符数量。因此，速度越高，旋律播放的速度越快。

此外，还有 MelodyPlayer.Play 的重载，它接受 3 个参数：MelodyElement 序列、速度和移调值。移调值增加或减少旋律序列中每个音调的半音数目。例如：以下行将将序列中的每个音调降低一个八度，因为八度包含 12 个半音。

player.Play(sequence, 100, -12);

并行蜂鸣器播放

因为 MelodyPlayer.Play 方法不是异步的，所以此方法的调用被如下任务包装

var player1 = new MelodyPlayer(new Buzzer(21));
player1.Play(AlphabetSong, 100, -12);
player1.Play(AlphabetSong, 100);

这种方法允许独立播放两个旋律，但上面的示例使用两个不同的蜂鸣器在同一时间播放一个旋律。

字母歌

提供的示例使用两个蜂鸣器播放字母歌。歌曲硬编码在 Buzzer.Sample.cs 文件中，作为 MelodyElement 的序列。有关字母歌的更多信息，请参阅维基百科：Wikipedia