pdf-icon

Arduino 上手教程

2. 设备开发 & 案例程序

6. 应用案例

Cardputer Speaker 扬声器

Cardputer Speaker 扬声器相关 API 与案例程序,适用于 Cardputer 和 Cardputer-Adv。

关于 3.5mm AUX 插孔
Cardputer-Adv 的 3.5mm AUX 插孔同样适用本页面,只要连接到耳机或音箱等播放设备,音频输出就会从扬声器切换到 AUX 通道。

案例程序

编译要求

  • M5Stack 板管理版本 >= 3.2.2
  • 开发板选项 = M5Cardputer
  • M5Cardputer 库版本 >= 1.1.0
  • M5Unified 库版本 >= 0.2.8
  • M5GFX 库版本 >= 0.2.10

蜂鸣示例

cpp
1 2 3 4 5 6 7 8 9 10 11 12 13
#include "M5Cardputer.h"

void setup() {
  auto cfg = M5.config();
  M5Cardputer.begin(cfg);
}

void loop() {
  M5Cardputer.Speaker.tone(7000, 100);  // frequency, duration
  delay(1000);
  M5Cardputer.Speaker.tone(4000, 20);  // frequency, duration
  delay(1000);
}

播放 wav 文件示例

打开M5Unified驱动库中的示例程序Advanced -> Speaker_SD_wav_file。如下图箭头所指,将SDCARD_CSPIN的值改为GPIO_NUM_12,将files[]中的文件名改为你要播放的 wav 文件路径(开头的/表示 microSD 卡的根目录)。点击上传按钮,将程序编译并烧录至设备。将 microSD 卡插入设备(卡的触点朝向与设备屏幕朝向相反),启动设备即可按顺序播放程序中指定的 wav 文件。

API

M5Cardputer库基于M5Unified库实现,Speaker 扬声器部分驱动使用了M5Unified库中的Speaker_Class,更多相关的 API 可以参考下方文档:

On This Page