#include // 音頻播放庫

#include // SPI通信庫

#define SD_ChipSelectPin 10 // 定義SD卡模塊的CS引腳

#define SpeakerPin 9 // 定義連接放大器的引腳

TMRpcm audio; // 創建音頻對象

void setup(){
audio.speakerPin = SpeakerPin; // 設置揚聲器引腳

Serial.begin(9600);

// 初始化SD卡
if (!SD.begin(SD_ChipSelectPin)) {
Serial.println("SD卡初始化失敗！");
return;
}
Serial.println("SD卡初始化成功。");

audio.setVolume(5); // 設置音量（0-7，7最大）
audio.quality(1); // 設置音頻質量（1為高質量，但更耗資源）

// 播放指定文件
audio.play("test.wav");
Serial.println("開始播放...");
}

void loop(){
// 循環中可以進行其他控制，例如按鍵停止/播放下一首
// 示例：如果播放完畢，可以停止或執行其他操作
// if (!audio.isPlaying()) {
// Serial.println("播放完畢。");
// while(1); // 停止程序
// }
}
`

上傳代碼前，請確保：
1. 開發板型號和端口選擇正確。
2. SD卡已正確插入模塊。
3. 硬件連接無誤。

六、測試與優化

1. 上傳代碼后，打開串口監視器（波特率9600），查看初始化信息。
2. 如果聽到揚聲器發出“test.wav”文件的聲音，恭喜你成功了！
3. 優化與擴展思路：

• 添加控制：連接幾個按鈕到Arduino，通過修改代碼實現播放/暫停、上一曲/下一曲、音量加減等功能。

• 顯示歌曲信息：增加一個LCD屏幕（如1602 LCD）來顯示當前播放的文件名。

• 提升音質：使用專用的音頻解碼模塊（如VS1053），它可以解碼MP3、WAV等多種格式，音質遠好于PWM直接播放。

• 制作播放列表：讓程序讀取SD卡上的特定文件（如playlist.txt）或遍歷特定文件夾來按順序播放。

七、常見問題與解決

• 沒有聲音：檢查揚聲器和放大模塊連接、電源；確認音頻文件格式是否正確（低采樣率8位WAV）；嘗試調節音量電位器或setVolume值；檢查代碼中引腳定義與實際是否一致。
• SD卡初始化失敗：檢查接線，尤其是CS、MOSI、MISO、SCK是否接對；嘗試更換SD卡或重新格式化（FAT16/FAT32）；確保SD卡模塊供電穩定（5V）。
• 聲音失真或雜音大：PWM播放音質有限，這是正常現象。確保使用干凈的5V電源為整個系統供電（避免使用電腦USB口，其電源可能不穩定）。嘗試降低音頻文件的采樣率（如8kHz）。
• 內存不足：如果程序編譯出錯提示內存不足，嘗試使用Arduino Mega（內存更大），或簡化代碼。

通過這個項目，你可以深入理解Arduino的存儲擴展、數字模擬信號轉換和基礎音頻處理。動手試試吧！