| 概述
如果您的微控制器或微型計算機具有數字音頻功能，則此放大器適合您！它采用標準的I2S數字音頻輸入，不僅可以將其解碼為模擬，還可以將其直接放大為揚聲器。完美地添加緊湊的放大聲音，需要2個分支（I2S DAC + Amp），并將它們組合為一個。
I2S（不要與I2C混淆）電路板上使用的協議，用于傳遞音頻數據。許多高端芯片和處理器以數字I2S格式管理所有音頻。然后，使用三個或四個引腳輸入或輸出數據（數據輸入，數據輸出，位時鐘和左右通道選擇）。通常，對于音頻設備，有一個DAC芯片可將I2S引入并轉換為可驅動耳機的模擬信號。
這款小型單聲道放大器功能強大，令人驚訝。為4歐姆阻抗揚聲器提供3.2瓦功率（5V電源@ 10％THD）。微型芯片內部是D類控制器，能夠以2.7V-5.5VDC的電壓運行。由于該放大器是D類，因此效率極高-非常適合便攜式和電池供電項目。它具有過熱和過流保護功能，但我們幾乎無法判斷它發燙了。
音頻輸入為I2S標準，可以使用3.3V或5V邏輯數據。輸出是“橋接”的-這意味著它們直接連接到輸出，沒有接地。輸出是〜300KHz方波PWM，然后由揚聲器線圈“平均”出-不會聽到高頻。以上所有這些都意味著您無法將輸出連接到另一個放大器，它應該直接驅動揚聲器。
有一個增益引腳，可以操縱該引腳更改增益。默認情況下，該放大器將為您提供 9dB 的增益。通過連接上拉或下拉電阻器或直接布線，可以將增益引腳設置為3dB，6dB，9dB，12dB或15dB。
ShutDown/Mode引腳可用于放置芯片處于關閉狀態或設置了哪個I2S音頻通道通過管道傳輸到揚聲器。默認情況下，放大器將（L + R）/2立體聲混音輸出為單聲道輸出。通過添加電阻器，您可以將其更改為左輸出或右輸出
與Raspberry Pi，Arduino Zero以及任何其他具有I2S音頻輸出的微控制器或微型計算機配合使用，效果很好
規格：
輸出功率：4Ω時為3.2W，10％THD，8Ω時為1.8W，10％THD，電源為5V
PSRR：在1KHz時，典型值為77 dB（典型值）
I2S采樣率從8kHz到96kHz
不需要MCLK
Click + Pop減少
五種引腳可選增益：3dB，6dB，9dB，12dB，15dB
出色的雜音抑制功能
熱關斷保護
作為經過組裝和測試的接線板提供，帶有一小塊可選的插頭和3.5mm接線端子。如果需要的話，需要一些焊接來連接插頭和接線盒。
插腳
MAX98357A是 I2S 放大器-不使用模擬輸入，僅支持數字音頻輸入！不要將I2S與I2C混淆，I2S是一種聲音協議，而I2C是用于少量數據。
揚聲器輸出
該放大器僅用于驅動動圈式揚聲器。揚聲器阻抗必須為4Ω或更大。輸出信號是330KHz PWM方波，其占空比與音頻信號成比例。揚聲器線圈的電感用作低通濾波器，以均衡高頻分量。請勿嘗試將其用作前置放大器。
每個通道的輸出均為“橋接”，沒有接地。這意味著對于每個通道，+和-交替極性可創建具有兩倍可用功率的單通道放大器。
使用3.5mm螺釘接線端子連接揚聲器。
5V插入4Ω@ 10％THD-最大3W
5V插入4Ω@ 1％THD-最大2.5W
3.3Vinto4Ω@ 10％THD-最大1.3W
3.3Vinto4Ω@ 1％THD-1.0W最大
5V轉換為8Ω@ 10％THD-最大1.8W
5V轉換為8Ω@ 1％THD-1.4W最大
3.3Vinto8Ω@ 10％THD的最大-0.8W
3.3Vinto8Ω@ 1％THD-最大0.6W
電源引腳
這是放大器的功率和放大器的邏輯。您可以提供2.5V至5.5V的電壓。請注意，在5V電壓下，您最終可以在揚聲器中輸入高達2.8W的功率，因此請確保您的電源可以輕松處理高達650mA的電流，并且我們建議使用至少800mA的電源規格，以便為您提供一些“房間”
如果您有3.3V邏輯設備，仍然可以從5V為放大器供電，建議您獲得最大的輸出功率！
I2S引腳
三個引腳用于接收音頻數據。這些可以是3.3-5V邏輯
LRC （左/右時鐘）-這是告訴放大器何時數據用于左聲道以及何時用于左聲道的引腳。
BCLK （位時鐘）-這是告訴放大器何時讀取數據引腳上數據的引腳。
DIN （數據輸入）-這是輸入實際數據的引腳，左右數據都在該引腳上發送，LRC引腳指示何時發送左或右信號
請注意，此放大器不需要 MCLK 引腳，如果您具有MCLK輸出，則可以將其斷開連接！
其他圖釘
其他設置由 GAIN 和 SD
增益
GAI N 是增益設置。您可以具有 3dB，6dB，9dB，12dB 或 15dB 的增益。
15dB 如果 GAIN 直接連接到 GAIN 和 GND
12dB 之間，則100K電阻 GND
9dB ，如果 GAIN 未連接任何東西（這是默認設置）
如果將 GAIN 直接連接到 Vin
3dB ，則 6dB 在 GAIN 和 Vin
之間，這樣，默認增益為9dB，但是您可以通過調整與 GAIN 引腳。請注意，您可能需要執行電源重置以調整增益。
SD/MODE
此引腳用于關機模式，但也用于設置輸出哪個通道。這有點令人困惑，但本質上是：
如果 SD 直接接地（電壓低于0.16V），則放大器關閉 》
如果 SD 上的電壓在0.16V至0.77V之間，則輸出為（Left + Right）/2，即立體聲平均值。
如果 SD 上的電壓介于0.77V和1.4V之間，則輸出僅是右聲道
如果 SD 上的電壓更高大于1.4V，則輸出為左聲道。
這與 SD 上的內部 100K下拉電阻復合在一起，因此您需要在SD上使用上拉電阻來平衡100K內部下拉。
對于分線板，從 SD 到 Vin 有一個1Mohm電阻， ，以5V供電時，將為您提供“立體聲平均”輸出。如果僅需要左聲道或右聲道，或者是使用非5V電源供電，則可能需要嘗試使用不同的電阻器在 SD
上獲得所需的電壓
程序集
《表class =“ build-table”》
準備標題欄：
如有必要，將條切成一定長度。如果將其插入面包板，則焊接會更容易-長按針腳
添加分線板：
將分線板放在插針上，以便短插針穿過分線墊
還有焊料！
請務必焊接所有引腳以確保可靠的電接觸。
（有關焊接的技巧，請務必查看我們的 優良焊接指南 ）。
您已完成！目視檢查焊點，然后繼續進行下一步
如果要使用接線端子來連接揚聲器，請放置3.5mm的接線端子，以使嘴巴指向。
兩個引腳上的焊料都帶有大量焊料！
Raspberry Pi接線
如果您有Raspberry Pi，并且希望獲得比耳機插孔所能提供的更高質量的音頻，則I2S是一個不錯的選擇！您僅需使用3個引腳，并且由于它是純數字輸出，因此可以減少噪聲和干擾。當然，您需要確保您擁有一個不錯的5V強電源，因此請確保為您的電源要求增加500mA或更多！
此板還與沒有具有像Pi Zero這樣的音頻
該技術將適用于任何帶有2x20連接器的Raspberry Pi。帶有2x13連接器的較早的Pi 1很難像這樣拔出I2S引腳
連接：
Amp Vin 至Raspbery Pi 5V
放大器GND 至Raspbery Pi GND
放大器DIN 至Raspbery Pi ＃21
放大器BCLK 至Raspbery Pi ＃18
Amp LRCLK 到Raspbery Pi ＃19
Raspberry Pi設置
目前，Raspbery Pi linux內核不支持I2S界面中的單聲道音頻只能播放立體聲，因此任何單聲道音頻文件可能都需要轉換為立體聲！
2017-11-2 Raspbian PIXEL（“滿”）在音量控制方面有問題。 I2S可以運行，但是沒有軟件卷設置，如果需要，請嘗試Raspbian Lite-我們會找出原因：）
快速安裝
幸運的是，它非常容易在Raspbian上安裝對I2S DAC的支持。
這些說明完全來自Pimoroni那些可愛的人的PhatDAC說明！
從具有Internet連接的Raspberry Pi運行以下內容：
curl -sS https://raw.githubusercontent.com/adafruit/Raspberry-Pi-Installer-Scripts/master/i2samp.sh | bash
我們添加了一個額外的helper systemd腳本，該腳本將在不使用I2S外設時播放安靜的音頻。開始播放或停止播放時，這會消除彈出聲。它使用很少的CPU時間（在Pi Zero上為5％，在Pi 2或3上可忽略不計）。您無需在RetroPie上使用它，因為它永遠不會發布I2S設備，但對Raspbian來說非常有用。
安裝后將需要重新啟動。
必須重新啟動才能啟用揚聲器硬件！
重新啟動后，重新登錄并再次運行腳本。。.它將詢問您是否您想測試揚聲器。說 y es，然后聽音頻從揚聲器中發出。。.
如果聽起來真的很失真，則可能是音量太高。但是，為了使音量控制出現在Raspbian桌面或Retropie中，您必須在進行揚聲器測試后再次重啟，方法是 sudo reboot
您必須重新啟動兩次*才能啟用alsamixer音量（確實如此！）
重新啟動后，嘗試運行 alsamixer ，然后使用箭頭鍵降低音量，50％是一個不錯的開始。
如果您仍然遇到音頻問題，請嘗試重新運行腳本，并說 N （禁用）/dev/zero playback service。
然后，您可以轉到下一頁以測試和優化設置。如果腳本適合您，請在詳細的 安裝上跳過此頁面的其余部分！
詳細安裝
如果由于某種原因，您不能只運行腳本而又想去通過手動安裝-這是所有步驟！
更新/etc/modprobe.d（如果存在）
登錄到Pi并進入串行控制臺（通過控制臺電纜，電視控制臺，RXVT或您擁有的設備）
使用
sudo nano /etc/modprobe.d/raspi-blacklist.conf
編輯raspi黑名單
如果文件為空，則跳過此步驟
但是，如果看到以下幾行：
blacklist i2c-bcm2708
blacklist snd-soc-pcm512x
blacklist snd-soc-wm8804
通過在每行之前放置＃來更新行
通過鍵入保存》 Control-X Y 《返回》
禁用耳機音頻（如果已設置）
使用
sudo nano /etc/modules
編輯raspi模塊列表（如果已設置）為空，只需跳過此步驟
但是，如果看到以下行：
snd_bcm2835
輸入＃
并使用 Control-X Y
創建asound.conf文件
使用
sudo nano /etc/asound.conf
編輯raspi模塊列表》
此文件應該為空！
復制并粘貼以下內容xt到文件中
下載：文件
復制代碼
pcm.speakerbonnet {
type hw card 0
}
pcm.dmixer {
type dmix
ipc_key 1024
ipc_perm 0666
slave {
pcm “speakerbonnet”
period_time 0
period_size 1024
buffer_size 8192
rate 44100
channels 2
}
}
ctl.dmixer {
type hw card 0
}
pcm.softvol {
type softvol
slave.pcm “dmixer”
control.name “PCM”
control.card 0
}
ctl.softvol {
type hw card 0
}
pcm.！default {
type plug
slave.pcm “softvol”
} pcm.speakerbonnet {
type hw card 0
}
pcm.dmixer {
type dmix
ipc_key 1024
ipc_perm 0666
slave {
pcm “speakerbonnet”
period_time 0
period_size 1024
buffer_size 8192
rate 44100
channels 2
}
}
ctl.dmixer {
type hw card 0
}
pcm.softvol {
type softvol
slave.pcm “dmixer”
control.name “PCM”
control.card 0
}
ctl.softvol {
type hw card 0
}
pcm.！default {
type plug
slave.pcm “softvol”
}
照常保存文件
添加設備樹覆蓋
使用
sudo nano /boot/config.txt
編輯您的Pi配置文件，然后向下滾動至底部。如果您看到一行顯示：dtparam=audio=on
通過在前面放置＃禁用它。
然后添加：
dtoverlay=hifiberry-dac
dtoverlay=i2s-mmap
在下一行。保存文件。
使用 sudo reboot
重啟您的Pi Raspberry Pi測試
揚聲器測試！
好的，您可以使用任何喜歡的軟件播放音頻，但是如果您想測試揚聲器的輸出，可以使用以下一些快速命令來驗證放大器和揚聲器是否正常工作！
簡單的白噪聲揚聲器測試
運行speaker-test -c2會在揚聲器之間產生左右交替的白噪聲。
如果您有單聲道輸出放大器，則I2S放大器會合并左右聲道，因此您會聽到連續的白噪聲
簡單的WAV揚聲器測試
一旦您有了一些東西出來，嘗試使用揚聲器測試（對于WAV文件，而不是MP3）播放音頻文件
speaker-test -c2 --test=wav -w /usr/share/sounds/alsa/Front_Center.wav
聽到來自左右交替揚聲器的音頻
簡單的MP3揚聲器測試
如果要播放音樂流，可以嘗試
sudo apt-get install -y mpg123
mpg123 http://ice1.somafm.com/u80s-128-mp3
如果您想在命令中播放MP3，請查看本教程，其中涵蓋了如何進行設置。
目前，Jessie Raspbery Pi內核不支持單聲道音頻在I2S界面之外，您只能播放立體聲，因此任何單聲道音頻文件都可能需要轉換為立體聲！
omxplayer似乎沒有將I2S接口用于音頻-僅是HDMI-因此您將無法使用它
音量調節
許多程序，例如PyGame和Sonic Pi在應用程序中具有音量控制。對于其他程序，您可以使用名為 alsamixer 的命令行工具來設置音量。只需輸入alsamixer，然后使用向上/向下箭頭設置音量。設置完后按Escape鍵
在Raspbian PIXEL中，您可以使用菜單項控件來設置音量。如果它有一個X，請嘗試重新啟動Pi（安裝后必須重新啟動兩次，以使PIXEL識別音量控制
Pi I2S調整
此頁面已棄用，我們的安裝程序已執行這些步驟為您服務，但我們會將其保留在此處供存檔使用！
減少爆音
對于遵循我們原始安裝說明并進行簡單alsa配置的用戶，他們可能會發現播放新音頻時會彈出I2S音頻。
解決方法是使用軟件混頻器向I2S設備輸出固定的采樣率，以使位時鐘不變。我使用ALSA，因此我配置了 dmixer ，并且不再有任何彈出聲或點擊聲。請注意，默認情況下，RaspPi I2S驅動程序不支持 dmixer ，您必須按照提供的這些說明進行添加。繼續逐步了解如何啟用它！
步驟1
首先通過修改/boot/config.txt 來添加dtoverlay=i2s-mmap
運行 sudo nano/boot/config.txt ，然后將文本添加到底部，如下所示：
保存并退出。
然后將/etc/asound.conf 更改為：
下載：文件
復制代碼
pcm.speakerbonnet {
type hw card 0
}
pcm.！default {
type plug
slave.pcm “dmixer”
}
pcm.dmixer {
type dmix
ipc_key 1024
ipc_perm 0666
slave {
pcm “speakerbonnet”
period_time 0
period_size 1024
buffer_size 8192
rate 44100
channels 2
}
}
ctl.dmixer {
type hw card 0
} pcm.speakerbonnet {
type hw card 0
}
pcm.！default {
type plug
slave.pcm “dmixer”
}
pcm.dmixer {
type dmix
ipc_key 1024
ipc_perm 0666
slave {
pcm “speakerbonnet”
period_time 0
period_size 1024
buffer_size 8192
rate 44100
channels 2
}
}
ctl.dmixer {
type hw card 0
}
通過運行sudo nano /etc/asound.conf
，這將創建一個稱為Speakerbonnet的PCM設備，該設備已連接到硬件I2S設備。然后，我們制作一個名為type dmix的新“ dmix”設備（pcm.dmixer）。我們為它提供了唯一的進程間通信密鑰（ipc_key 1024）和可在世界范圍內讀取的（ipc_perm 0666權限）混合器將控制硬件pcm設備Speakerbonnet（pcm“ speakerbonnet”）并具有一個緩沖區設置好它的好又快。設置了通信緩沖區，因此沒有延遲（period_time 0，period_size 1024和buffer_size 8192正常工作）。默認的混合速率是44.1khz立體聲（rate 44100 channels 2）
最后，我們設置了一個控制接口，但最終效果最好是僅將硬件設備放在此處-ctl.dmixer { type hw card 0 }
保存并退出。然后重新啟動Pi以啟用混音器。另外，雖然它會極大地減少彈出聲，但有時還是會偶爾碰到一次-特別是在第一次播放音頻時！
添加軟件音量控制
此處使用的基本I2S芯片組未內置軟件控制。因此我們必須“欺騙” Pi來創建軟件音量控件。幸運的是，一旦您知道如何做就不難了。
在〜/.asoundrc 中使用nano ~/.asoundrc創建一個新的音頻配置文件，并在其中放置以下文本：
下載：文件
復制代碼
pcm.speakerbonnet {
type hw card 0
}
pcm.dmixer {
type dmix
ipc_key 1024
ipc_perm 0666
slave {
pcm “speakerbonnet”
period_time 0
period_size 1024
buffer_size 8192
rate 44100
channels 2
}
}
ctl.dmixer {
type hw card 0
}
pcm.softvol {
type softvol
slave.pcm “dmixer”
control.name “PCM”
control.card 0
}
ctl.softvol {
type hw card 0
}
pcm.！default {
type plug
slave.pcm “softvol”
} pcm.speakerbonnet {
type hw card 0
}
pcm.dmixer {
type dmix
ipc_key 1024
ipc_perm 0666
slave {
pcm “speakerbonnet”
period_time 0
period_size 1024
buffer_size 8192
rate 44100
channels 2
}
}
ctl.dmixer {
type hw card 0
}
pcm.softvol {
type softvol
slave.pcm “dmixer”
control.name “PCM”
control.card 0
}
ctl.softvol {
type hw card 0
}
pcm.！default {
type plug
slave.pcm “softvol”
}
這假定您將調音臺設置為不彈出！
保存并退出
現在，這就是竅門，您必須重新啟動，然后通過alsa播放一些音頻，然后重新啟動以使alsamixer正確同步：
speaker-test -c2 --test=wav -w /usr/share/sounds/alsa/Front_Center.wav
然后然后您可以鍵入 alsamixer 以使用“經典” alsa控制音量混合界面
只需按向上和向下箭頭設置音量，然后按ESC退出
使用PyGame播放音頻
您可以使用 mpg123 進行基本測試，但要動態更改音量或有一個互動程序。為了獲得更強大的音頻播放，我們建議使用PyGame播放各種音頻格式（包括MP3！）
安裝PyGame
首先安裝pygame支持，您需要在具有網絡訪問權限的Pi上打開控制臺并運行：
下載：文件
復制代碼
sudo apt-get install python-pygame sudo apt-get install python-pygame
下一步，將該pygame示例zip下載到您的Pi
點擊下載PyGame示例代碼和示例mp3
在命令行上運行
wget https://cdn-learn.adafruit.com/assets/assets/000/041/506/original/pygame_example.zip
unzip pygame_example.zip
運行演示
在zip內的示例是 pygam, eMP3.py
此示例將播放腳本文件夾中的所有MP3。為了演示您也可以在pygame中調整音量，第二個參數是要播放的音量。使用介于0.0和1.0之間的命令行參數指定要播放的音量
例如，以下是如何以75％的音量播放：
下載：文件
復制代碼
python pygameMP3.py 0.75 python pygameMP3.py 0.75
如果您有自己的mp3，請使用以下代碼！
下載：文件
復制代碼
‘’‘ pg_midi_sound101.py
play midi music files （also mp3 files） using pygame
tested with Python273/331 and pygame192 by vegaseat
’‘’
#code modified by James DeVito from here： https://www.daniweb.com/programming/software-development/code/454835/let-pygame-play-your-midi-or-mp3-files
#！/usr/bin/python
import sys
import pygame as pg
import os
import time
def play_music（music_file）：
‘’‘
stream music with mixer.music module in blocking manner
this will stream the sound from disk while playing
’‘’
clock = pg.time.Clock（）
try：
pg.mixer.music.load（music_file）
print（“Music file {} loaded！”.format（music_file））
except pygame.error：
print（“File {} not found！ {}”.format（music_file， pg.get_error（）））
return
pg.mixer.music.play（）
# If you want to fade in the audio.。。
# for x in range（0，100）：
# pg.mixer.music.set_volume（float（x）/100.0）
# time.sleep（.0075）
# # check if playback has finished
while pg.mixer.music.get_busy（）：
clock.tick（30）
freq = 44100 # audio CD quality
bitsize = -16 # unsigned 16 bit
channels = 2 # 1 is mono， 2 is stereo
buffer = 2048 # number of samples （experiment to get right sound）
pg.mixer.init（freq， bitsize， channels， buffer）
if len（sys.argv） 》 1：
try：
user_volume = float（sys.argv［1］）
except ValueError：
print “Volume argument invalid. Please use a float （0.0 - 1.0）”
pg.mixer.music.fadeout（1000）
pg.mixer.music.stop（）
raise SystemExit
print（“Playing at volume： ” + str（user_volume）+ “ ”）
pg.mixer.music.set_volume（user_volume）
mp3s = ［］
for file in os.listdir（“。”）：
if file.endswith（“.mp3”）：
mp3s.append（file）
print mp3s
for x in mp3s：
try：
play_music（x）
time.sleep（.25）
except KeyboardInterrupt：
# if user hits Ctrl/C then exit
# （works only in console mode）
pg.mixer.music.fadeout（1000）
pg.mixer.music.stop（）
raise SystemExit
else：
print（“Please specify volume as a float！ （0.0 - 1.0）”） ‘’‘ pg_midi_sound101.py
play midi music files （also mp3 files） using pygame
tested with Python273/331 and pygame192 by vegaseat
’‘’
#code modified by James DeVito from here： https://www.daniweb.com/programming/software-development/code/454835/let-pygame-play-your-midi-or-mp3-files
#！/usr/bin/python
import sys
import pygame as pg
import os
import time
def play_music（music_file）：
‘’‘
stream music with mixer.music module in blocking manner
this will stream the sound from disk while playing
’‘’
clock = pg.time.Clock（）
try：
pg.mixer.music.load（music_file）
print（“Music file {} loaded！”.format（music_file））
except pygame.error：
print（“File {} not found！ {}”.format（music_file， pg.get_error（）））
return
pg.mixer.music.play（）
# If you want to fade in the audio.。。
# for x in range（0，100）：
# pg.mixer.music.set_volume（float（x）/100.0）
# time.sleep（.0075）
# # check if playback has finished
while pg.mixer.music.get_busy（）：
clock.tick（30）
freq = 44100 # audio CD quality
bitsize = -16 # unsigned 16 bit
channels = 2 # 1 is mono， 2 is stereo
buffer = 2048 # number of samples （experiment to get right sound）
pg.mixer.init（freq， bitsize， channels， buffer）
if len（sys.argv） 》 1：
try：
user_volume = float（sys.argv［1］）
except ValueError：
print “Volume argument invalid. Please use a float （0.0 - 1.0）”
pg.mixer.music.fadeout（1000）
pg.mixer.music.stop（）
raise SystemExit
print（“Playing at volume： ” + str（user_volume）+ “ ”）
pg.mixer.music.set_volume（user_volume）
mp3s = ［］
for file in os.listdir（“。”）：
if file.endswith（“.mp3”）：
mp3s.append（file）
print mp3s
for x in mp3s：
try：
play_music（x）
time.sleep（.25）
except KeyboardInterrupt：
# if user hits Ctrl/C then exit
# （works only in console mode）
pg.mixer.music.fadeout（1000）
pg.mixer.music.stop（）
raise SystemExit
else：
print（“Please specify volume as a float！ （0.0 - 1.0）”）
Arduino接線和測試
基于ATmega328P的經典Arduino（如UNO和Metro 328）沒有I2S接口，因此不能 》與他們一起使用此突破
但是基于零速，Metro M0和Feather M0的新型基于ATSAMD21的板可以！ （注意，Gemma M0和Trinket M0沒有可用的I2S引腳）。甚至新的基于ATSAMD51的板卡（例如Metro M4和Feather M4）也可以。
要在M0或M4板上使用I2S，您需要安裝Adafruit Zero I2S庫。可通過庫管理器使用。您可以搜索（見下文），然后單擊安裝按鈕。
接線
接線連接與CircuitPython所用的相同。因此，請轉到 CircuitPython接線和測試頁面，了解如何為您的特定電路板接線。
基本測試
要進行測試，請嘗試運行下面的演示。它隨庫安裝一起提供，因此您可以通過以下方式找到它：
文件-》示例-》 Adafruit零I2S庫-》基本
請確保更改此行：
下載：文件
復制代碼
Adafruit_ZeroI2S i2s（0， 1， 9， 2）; Adafruit_ZeroI2S i2s（0， 1， 9， 2）;
，以匹配用于設置的引腳。如果已按照本指南中的說明進行接線，則可以通過將默認線路更改為以下方式來嘗試使用默認引腳：
下載：文件
復制代碼
Adafruit_ZeroI2S i2s; Adafruit_ZeroI2S i2s;
下載：Project Zip 或 basic.ino | 查看Github
復制代碼
Temporarily unable to load content：
Temporarily unable to load content：
DMA測試
上面的基本測試是通過循環使用i2s.write（）函數直接創建輸出的。另一種方法是使用DMA生成輸出。使用這種方法，您可以進行一些初始設置來配置DMA引擎以進行回放。然后，它可以在后臺生成輸出，從而允許您在代碼中執行其他操作。
要采用這種方法，您將需要安裝Zero DMA庫。您可以通過庫管理器來做到這一點：
然后您可以使用在零I2S庫中找到的DMA示例：
文件-》示例-》 Adafruit零I2S庫-》 dma
下載：Project Zip 或 dma.ino | 在Github上查看
復制代碼
#include
#include
#include “utility/dma.h”
#include
/* max volume for 32 bit data */
#define VOLUME （ （1UL 《《 31） - 1）
/* create a buffer for both the left and right channel data */
#define BUFSIZE 256
int data［BUFSIZE］;
Adafruit_ZeroDMA myDMA;
ZeroDMAstatus stat; // DMA status codes returned by some functions
Adafruit_ZeroI2S i2s;
void dma_callback（Adafruit_ZeroDMA *dma） {
/* we don‘t need to do anything here */
}
void setup（）
{
Serial.begin（115200）;
//while（！Serial）; // Wait for Serial monitor before continuing
Serial.println（“I2S output via DMA”）;
int *ptr = data;
/*the I2S module will be expecting data interleaved LRLR*/
for（int i=0; i /* create a sine wave on the left channel */
*ptr++ = sin（ （2*PI / （BUFSIZE/2） ） * i） * VOLUME;
/* create a cosine wave on the right channel */
*ptr++ = cos（ （2*PI / （BUFSIZE/2） ） * i） * VOLUME;
}
Serial.println（“Configuring DMA trigger”）;
myDMA.setTrigger（I2S_DMAC_ID_TX_0）;
myDMA.setAction（DMA_TRIGGER_ACTON_BEAT）;
Serial.print（“Allocating DMA channel.。。”）;
stat = myDMA.allocate（）;
myDMA.printStatus（stat）;
Serial.println（“Setting up transfer”）;
myDMA.addDescriptor（
data， // move data from here
#if defined（__SAMD51__）
（void *）（&I2S-》TXDATA.reg）， // to here （M4）
#else
（void *）（&I2S-》DATA［0］.reg）， // to here （M0+）
#endif
BUFSIZE， // this many.。。
DMA_BEAT_SIZE_WORD， // bytes/hword/words
true， // increment source addr？
false）;
myDMA.loop（true）;
Serial.println（“Adding callback”）;
myDMA.setCallback（dma_callback）;
/* begin I2S on the default pins. 24 bit depth at
* 44100 samples per second
*/
i2s.begin（I2S_32_BIT， 44100）;
i2s.enableTx（）;
stat = myDMA.startJob（）;
}
void loop（）
{
Serial.println（“do other things here while your DMA runs in the background.”）;
delay（2000）;
}
#include
#include
#include “utility/dma.h”
#include
/* max volume for 32 bit data */
#define VOLUME （ （1UL 《《 31） - 1）
/* create a buffer for both the left and right channel data */
#define BUFSIZE 256
int data［BUFSIZE］;
Adafruit_ZeroDMA myDMA;
ZeroDMAstatus stat; // DMA status codes returned by some functions
Adafruit_ZeroI2S i2s;
void dma_callback（Adafruit_ZeroDMA *dma） {
/* we don’t need to do anything here */
}
void setup（）
{
Serial.begin（115200）;
//while（！Serial）; // Wait for Serial monitor before continuing
Serial.println（“I2S output via DMA”）;
int *ptr = data;
/*the I2S module will be expecting data interleaved LRLR*/
for（int i=0; i /* create a sine wave on the left channel */
*ptr++ = sin（ （2*PI / （BUFSIZE/2） ） * i） * VOLUME;
/* create a cosine wave on the right channel */
*ptr++ = cos（ （2*PI / （BUFSIZE/2） ） * i） * VOLUME;
}
Serial.println（“Configuring DMA trigger”）;
myDMA.setTrigger（I2S_DMAC_ID_TX_0）;
myDMA.setAction（DMA_TRIGGER_ACTON_BEAT）;
Serial.print（“Allocating DMA channel.。。”）;
stat = myDMA.allocate（）;
myDMA.printStatus（stat）;
Serial.println（“Setting up transfer”）;
myDMA.addDescriptor（
data， // move data from here
#if defined（__SAMD51__）
（void *）（&I2S-》TXDATA.reg）， // to here （M4）
#else
（void *）（&I2S-》DATA［0］.reg）， // to here （M0+）
#endif
BUFSIZE， // this many.。。
DMA_BEAT_SIZE_WORD， // bytes/hword/words
true， // increment source addr？
false）;
myDMA.loop（true）;
Serial.println（“Adding callback”）;
myDMA.setCallback（dma_callback）;
/* begin I2S on the default pins. 24 bit depth at
* 44100 samples per second
*/
i2s.begin（I2S_32_BIT， 44100）;
i2s.enableTx（）;
stat = myDMA.startJob（）;
}
void loop（）
{
Serial.println（“do other things here while your DMA runs in the background.”）;
delay（2000）;
}
CircuitPython接線和測試
CircuitPython 3.0及更高版本內置了I2S，這意味著您可以在支持的M0和M4 Express CircuitPython板上輕松使用此突破口！支持的板是Feather M0 Express，Feather M4 Express，Metro M0 Express，Metro M4 Express和ItsyBitsy M0 Express。
請注意，飾品M0，Gemma M0和ItsyBitsy M4不支持I2S（最后一個不是錯字！）
M0板具有多個可用的I2S引腳組合。我們將為每塊板演示單個引腳組合。
接線
以下接線圖顯示了如何將MAX98357分支連接到CircuitPython板上。您將使用電壓輸入，接地，位時鐘，左/右時鐘和數據引腳。
VIN 是 red 線。
GND 是黑色導線。
BCLK 是藍色導線。
LRC 是黃色導線。
DIN 是《綠色電線。
對于Feather M0 Express，ItyBitsy M0 Express和Metro M0 Express：
在突破口上連接 VIN 到板上的 3V/3.3 。
將 分支上的 GND連接到主板上的 G/GND。板。
在分支上連接 BCLK 連接到板上的 D1/TX 。
將分支中的 LRC 連接到板上的 D0/RX strong》。
將分組中的 DIN 連接到板上的 D9 。
對于Feather M4 Express：
將分支上的 VIN 連接到板上的 3V 。
連接 分支上的GND到板上的 Gind 。
將分支上的 BCLK連接到《。
將分組中的 LRC 連接到板上的 D10 。
將分組中的 DIN 連接到板上的 D11 。
對于Metro M4 Express：
在分支上連接 VIN 》連接到板上的 3.3 。
將分支中的 GND 連接到板上的 GND strong》。
在分支上將 BCLK 連接到板上的 D3 。
在分支上將 LRC連接連接到板上的 D9 。
將分支中的 DIN 連接到板上的 D8 。
代碼示例
我們有兩個CircuitPython代碼示例。前者在分組討論中通過揚聲器播放生成的音調。第二個播放波形文件。讓我們看一下！
音調生成
第一個示例生成一個正弦波的一個周期，然后循環生成一個音調。您可以通過更改關聯的變量來更改音量和音調的Hz。在循環內，我們播放音調一秒鐘，然后將其停一秒鐘。
下載：Project Zip 或 CircuitPython_I2S_Tone.py | 在Github上查看
復制代碼
import time
import array
import math
import audioio
import board
import audiobusio
sample_rate = 8000
tone_volume = .1 # Increase or decrease this to adjust the volume of the tone.
frequency = 440 # Set this to the Hz of the tone you want to generate.
length = sample_rate // frequency # One freqency period
sine_wave = array.array（“H”， ［0］ * length）
for i in range（length）：
sine_wave［i］ = int（（math.sin（math.pi * 2 * frequency * i / sample_rate） *
tone_volume + 1） * （2 ** 15 - 1））
# For Feather M0 Express， ItsyBitsy M0 Express， Metro M0 Express
audio = audiobusio.I2SOut（board.D1， board.D0， board.D9）
# For Feather M4 Express
# audio = audiobusio.I2SOut（board.D1， board.D10， board.D11）
# For Metro M4 Express
# audio = audiobusio.I2SOut（board.D3， board.D9， board.D8）
sine_wave_sample = audioio.RawSample（sine_wave， sample_rate=sample_rate）
while True：
audio.play（sine_wave_sample， loop=True）
time.sleep（1）
audio.stop（）
time.sleep（1）
import time
import array
import math
import audioio
import board
import audiobusio
sample_rate = 8000
tone_volume = .1 # Increase or decrease this to adjust the volume of the tone.
frequency = 440 # Set this to the Hz of the tone you want to generate.
length = sample_rate // frequency # One freqency period
sine_wave = array.array（“H”， ［0］ * length）
for i in range（length）：
sine_wave［i］ = int（（math.sin（math.pi * 2 * frequency * i / sample_rate） *
tone_volume + 1） * （2 ** 15 - 1））
# For Feather M0 Express， ItsyBitsy M0 Express， Metro M0 Express
audio = audiobusio.I2SOut（board.D1， board.D0， board.D9）
# For Feather M4 Express
# audio = audiobusio.I2SOut（board.D1， board.D10， board.D11）
# For Metro M4 Express
# audio = audiobusio.I2SOut（board.D3， board.D9， board.D8）
sine_wave_sample = audioio.RawSample（sine_wave， sample_rate=sample_rate）
while True：
audio.play（sine_wave_sample， loop=True）
time.sleep（1）
audio.stop（）
time.sleep（1）
對于羽毛M0 Express，ItsyBitsy M0 Express 和 Metro M0 Express ，
對于羽毛M4 Express ，注釋掉audio = audiobusio.I2SOut（board.D1， board.D0， board.D9）并取消注釋# audio = audiobusio.I2SOut（board.D1， board.D10， board.D11）。
對于 Metro M4 Express ，注釋掉audio = audiobusio.I2SOut（board.D1， board.D0， board.D9）并取消注釋# audio = audiobusio.I2SOut（board.D3， board.D3， board.D8）。
現在您將聽到440Hz音調的一秒鐘和一秒鐘的聲音。沉默
您可以嘗試更改音調的Hz以產生不同的音調。嘗試更改time.sleep（）中的秒數以產生更長或更短的音調。
波形文件
第二個示例播放波形文件。我們以可讀格式打開文件。然后在循環中，我們播放文件，并告訴代碼繼續播放文件，直到完成為止。您可以使用任何受支持的wave文件。我們已經在代碼中包含了wave文件。
StreetChicken.wav
下載：Project Zip 或 CircuitPython_I2S_Wave.py | 在Github上查看
復制代碼
import audioio
import board
import audiobusio
wave_file = open（“StreetChicken.wav”， “rb”）
wave = audioio.WaveFile（wave_file）
# For Feather M0 Express， ItsyBitsy M0 Express， Metro M0 Express
audio = audiobusio.I2SOut（board.D1， board.D0， board.D9）
# For Feather M4 Express
# audio = audiobusio.I2SOut（board.D1， board.D10， board.D11）
# For Metro M4 Express
# audio = audiobusio.I2SOut（board.D3， board.D9， board.D8）
while True：
audio.play（wave）
while audio.playing：
pass
import audioio
import board
import audiobusio
wave_file = open（“StreetChicken.wav”， “rb”）
wave = audioio.WaveFile（wave_file）
# For Feather M0 Express， ItsyBitsy M0 Express， Metro M0 Express
audio = audiobusio.I2SOut（board.D1， board.D0， board.D9）
# For Feather M4 Express
# audio = audiobusio.I2SOut（board.D1， board.D10， board.D11）
# For Metro M4 Express
# audio = audiobusio.I2SOut（board.D3， board.D9， board.D8）
while True：
audio.play（wave）
while audio.playing：
pass
代碼中的對象設置與上面相同。
對于 Feather M0 Express，ItsyBitsy M0 Express 和 Metro M0 Express ，無需更改即可運行代碼。
對于 Feather M4 Express ，注釋掉audio = audiobusio.I2SOut（board.D1， board.D0， board.D9）并取消注釋# audio = audiobusio.I2SOut（board.D1， board.D10， board.D11）。
對于 Metro M4 Express ，注釋掉audio = audiobusio.I2SOut（board.D1， board.D0， board.D9）并取消注釋# audio = audiobusio.I2SOut（board.D3， board.D3， board.D8）
現在，您將聽到wave文件播放并循環播放。
此示例可以做很多事情。嘗試播放其他波形文件，或者包括while audio.playing： pass而不是包含time.sleep（），以使其播放指定的秒數。查閱CircuitPython Essentials指南中的pause和resume功能的“音頻輸出”頁面。
我的I2S在哪里？
我們之前提到過，支持的M0板具有多個I2S引腳組合供您使用。 M4板有一種選擇。無論哪種方式，如果您想知道可用的選項，請將以下代碼復制到 code.py ，連接到串行控制臺和檢查輸出。
這些是ItsyBitsy M0 Express的結果。
下載：Project Zip 或 I2S_Test_Script.py | 在Github上查看
復制代碼
import board
import audiobusio
from microcontroller import Pin
def is_hardware_i2s（bit_clock， word_select， data）：
try：
p = audiobusio.I2SOut（bit_clock， word_select， data）
p.deinit（）
return True
except ValueError：
return False
def get_unique_pins（）：
exclude = ［‘NEOPIXEL’， ‘APA102_MOSI’， ‘APA102_SCK’］
pins = ［pin for pin in ［
getattr（board， p） for p in dir（board） if p not in exclude］
if isinstance（pin， Pin）］
unique = ［］
for p in pins：
if p not in unique：
unique.append（p）
return unique
for bit_clock_pin in get_unique_pins（）：
for word_select_pin in get_unique_pins（）：
for data_pin in get_unique_pins（）：
if bit_clock_pin is word_select_pin or bit_clock_pin is data_pin or word_select_pin\
is data_pin：
continue
else：
if is_hardware_i2s（bit_clock_pin， word_select_pin， data_pin）：
print（“Bit clock pin：”， bit_clock_pin， “ Word select pin：”， word_select_pin，
“ Data pin：”， data_pin）
else：
pass
import board
import audiobusio
from microcontroller import Pin
def is_hardware_i2s（bit_clock， word_select， data）：
try：
p = audiobusio.I2SOut（bit_clock， word_select， data）
p.deinit（）
return True
except ValueError：
return False
def get_unique_pins（）：
exclude = ［‘NEOPIXEL’， ‘APA102_MOSI’， ‘APA102_SCK’］
pins = ［pin for pin in ［
getattr（board， p） for p in dir（board） if p not in exclude］
if isinstance（pin， Pin）］
unique = ［］
for p in pins：
if p not in unique：
unique.append（p）
return unique
for bit_clock_pin in get_unique_pins（）：
for word_select_pin in get_unique_pins（）：
for data_pin in get_unique_pins（）：
if bit_clock_pin is word_select_pin or bit_clock_pin is data_pin or word_select_pin\
is data_pin：
continue
else：
if is_hardware_i2s（bit_clock_pin， word_select_pin， data_pin）：
print（“Bit clock pin：”， bit_clock_pin， “ Word select pin：”， word_select_pin，
“ Data pin：”， data_pin）
else：
pass
I2S音頻常見問題解答
嘿，在Raspbian Pixel桌面中，揚聲器圖標已X化！
播放一些音頻后，嘗試重新啟動一次。另外，請確保您具有我們最新的alsa配置（請檢查Raspberry Pi安裝頁面上的詳細安裝頁面中的/etc/asound.conf！
。如果它仍然不起作用，您仍然可以更改音量，只需在終端命令提示符下使用 alsamixer 。
即使啟用了dmixer，當Pi首次啟動或當它第一次開始播放音頻時
是的，這是Raspbian Linux的已知東西是的Linux！我們沒有修復程序，如果可以讓您感覺更好，我的高檔Windows開發計算機會對臺式機揚聲器執行相同的操作。
i2s設置腳本中的“/dev/zero play”選項（我們于2018年10月添加了該選項），但您仍然可能會得到一個初始彈出音
我的DAC上的音頻聽起來真的很差/失真
請確保降低了音量。默認值為100％，太高了！使用 alsamixer 將音量降低到50％左右
可以與我最喜歡的軟件一起使用嗎？
它將與任何支持alsa音頻的一起使用。有成千上萬個linux程序，所以我們不能保證它們都能正常工作，但這是我們確定能做到的！
PyGame -請參閱播放音頻的頁面以PyGame為例的代碼。可以在pygame
mpg123 -命令行mp3音頻播放中控制音量。使用alsamixer控制音量
播放-用于在命令行上播放wav文件
Sonic Pi -已在像素桌面。使用Sonic Pi設置面板更改音量-似乎并不在乎您設置的全局音量！
Scratch 2 -已在Pixel桌面上進行了測試。效果很好，但可能會有所延遲，并且在您第一次播放音頻時會發出爆裂的聲音。您可以使用alsamixer設置音量，也可以通過應用程序使用將音量設置為nn％塊
從頭開始1 設置音量-無效，有些
RetroPie/Emulation Station 不能在Scratch 1上設置？-音頻在游戲中有效（我們測試了NES和MAME libretro），但在“主屏幕”中不起作用‘（選擇要玩的游戲界面）
下載
MAX98357數據表
帶有EagleCAD PCB文件的GitHub
Adafruit Fritzing庫中的Fritzing對象
示意圖
單擊以進行簽名
制造打印
英寸尺寸
|
