说明

产品简介

前言

本产品是基于树莓派而设计的音频模块，专为树莓派设计的音频声卡扩展板，立体声编解码，支持高音质播放。

产品特性

• 供电电压：5V
• 逻辑电压：3.3V
• 音频编解码芯片：PCM5122
• 控制接口：I2C
• 音频接口：I2S
• DAC信噪比：112dB

硬件资源

LP、LN分别对应左扬声器的正、负极; RP、RN分别对应右扬声器的正、负极。

树莓派使用

（本产品例程只适用于树莓派官方系统）

安装驱动

屏蔽树莓派默认音频：

sudo nano /boot/config.txt

找到dtparam=audio=on,在最前面加上#号，将其改成#dtparam=audio=on，改成ctrl+c然后Y保存退出

更新软件源：

sudo apt-get update
sudo apt-get full-upgrade
sudo reboot

检查内核版本：

uname -a
下载驱动程序：
git clone https://github.com/waveshare/WM8960-Audio-HAT

安装WM8960驱动：

cd WM8960-Audio-HAT
#需要等待一定的时间
chmod +x install.sh
sudo ./install.sh 
sudo reboot

重启后运行如下命令看下驱动是否加载成功。

sudo dkms status

pi@raspberrypi:~ $ sudo dkms status 
wm8960-soundcard, 1.0, 4.19.58-v7l+, armv7l: installed

注意：首次安装如果更新了内核可能会出现有噪声等问题，需要重启后再次运行命令安装驱动就可以了。
这里提供的是一个完成教程，如果安装多次还是无法出现驱动可以使用我们做好的镜像（版本2019-07-10，密码l9jz）使用。

检测声卡

• 检查播放：aplay -l

pi@raspberrypi:~ $ aplay -l
**** List of PLAYBACK Hardware Devices ****
card 0: wm8960soundcard [wm8960-soundcard], device 0: bcm2835-i2s-wm8960-hifi wm8960-hifi-0 []
  Subdevices: 1/1
  Subdevice #0: subdevice #0

• 检查录音：arecord -l

pi@raspberrypi:~ $ arecord -l
**** List of CAPTURE Hardware Devices ****
card 0: wm8960soundcard [wm8960-soundcard], device 0: bcm2835-i2s-wm8960-hifi wm8960-hifi-0 []
  Subdevices: 1/1
  Subdevice #0: subdevice #0

录音播放测试

录播测试

sudo arecord -f cd -Dhw:0 | aplay -Dhw:0

程序运行后通过耳机或者喇叭会听到麦克风采集到的声音，注意喇叭不能开靠近麦克风，否则会导致共振产生啸叫。

录音

sudo arecord -D hw:0,0 -f S32_LE -r 16000 -c 2 test.wav

test.wav是录制生成的文件名。

播放

sudo aplay -Dhw:0 test.wav

播放刚刚录制的音频

调节音量

默认的音量是比较小的

sudo alsamixer

如果 WM8960 声卡没有设置为默认声卡则需要按 F6 选择声卡设备。

实际上右边还有很多可以调节的选项。

mpg123播放器

aplay只支持wav的音乐，实际上MP3格式的音乐会更加多，安装：

sudo apt-get install mpg123 
sudo mpg123 music.mp3

需要注意，这里的music.mp3需要替换成你的mp3音乐。

图形化smplayer

如果是命令行系统可以跳过，如果你的是桌面系统，安装：

sudo apt-get install smplayer

在界面中右键选择wm8960-soundcard为默认

在菜单中打开smplayer软件，打开音频文件即可播放。(smplayer也可以播放视频)

程序控制

我们提供了一个简单的python控制例程。

• 安装对应的库

sudo apt-get install libasound2-dev
git clone https://github.com/larsimmisch/pyalsaaudio
cd pyalsaaudio
sudo python setup.py build
sudo python setup.py install

• 下载例程

wget http://www.waveshare.net/w/upload/1/19/WM8960_Audio_HAT_Code.tar.gz
tar zxvf WM8960_Audio_HAT_Code.tar.gz
sudo chmod 777 -R WM8960_Audio_HAT_Code

• 播放

sudo python playwav.py music.wav

• 录音

sudo python recordwav.py out.wav