树莓派Zero W添加音频输出
编译:陈拓chentuo@ms.xab.ac.cn 2018.06.07/2018.07.14
原文:Adding Basic Audio Ouput to Raspberry Pi Zero
https://learn.adafruit.com/adding-basic-audio-ouput-to-raspberry-pi-zero
0. 概述
为了保持树莓派Zero W低成本和尽可能小,Pi Zero W不包括3.5mm音频插座。也没有音频输出端子。下面我们为Pi Zero W添加基本的音频输出。
本文的另一个重点是GPIO引脚复用,也就是通过设置改变引脚的功能。
1. 原理
在其他的树莓派上音频是怎样工作的呢?用于PI的Broadcom芯片组没有真正的模拟输出。作为替代,用两个PWM引脚(脉宽调制)以非常高的速度工作,并且有滤波。PWM频率至少10倍于我们想要重现的音频最高频率。然后,通过调整PWM的占空比,我们就可以“伪造”音频信号。
音频是20Hz到20kHz,从PI输出的PWM是50MHz,所以我们可以很容易地过滤高50MHz输出(无论如何都听不到)。
看其他树莓派音频输出示意图,我们可以看到PWM0OUT和PWM1OUT是左右通道。R21和R20是分压器,使3.3V信号下降到约1.1V MAX(这是音频线路电平所需的最大峰值到峰值电压)。
C20/C26与R21/R27一起工作,产生一个“RC低通滤波器”。你可以用1/(2*pi*RC) = 1/(2*pi*270*33*10-9) = 17865 Hz计算截止频率,这非常接近20kHz。
C48/C34作为直流滤波电容器,它只允许交流通过扬声器和耳机。
BAV99 是ESD保护二极管。保护树莓派防止来自PWM引脚的静电。
2. Pi Zero W音频
[https://learn.adafruit.com/adding-basic-audio-ouput-to-raspberry-pi-zero/pi-zero-pwm-audio]
2.1 BCM2835 GPIO功能
在PI Zero W的PCB板上,没有引出PIN PWM0(引脚#40)和PWM1(引脚#45)。但是可以通过GPIO#18(ALT5)访问PWM0,通过GPIO#13(ALT0)或GPIO#19(ALT5)访问PWM1,请参阅下面的引脚和备用功能的完整列表:https://elinux.org/RPi_BCM2835_GPIOs
BCM2835 GPIO功能
GPIO ALT就像单片机的引脚复用。
2.2 在PI Zero W上实现PWM
- 用ssh登录到命令行控制台。
用putty连接电脑和Pi Zero W,看本文最后的参考文档。Host Name填raspberrypi.local,端口22,用户名pi,密码raspberry。
注意:boot分区有一个名为ssh的空文本文件,这个ssh文件容易丢失,如果ssh不能登录了,先检查ssh是否丢失。
- 设置引脚和PWM的方法
有两种选择,简单的方法是使用DTO来设置所有引脚和PWM,但是,我们还没有测试过。另一种方法是手动设置引脚GPIO alt功能,我们已经测试过了,但难度更大!
选择1. 使用设备树覆盖(Device Tree Overlay - DTO)
有两个建议的DTO选项,第一个使用了最近加入的DTO:
1) 有一种简单的方法来配置PWM音频的PI GPIO引脚。只需将以下行添加到/boot/config.txt,即可在引导是重新配置引脚,无需任何外部软件或服务:
dtoverlay=pwm-2chan,pin=18,func=2,pin2=13,func2=4
将左通道映射到引脚33(BCM = 13),将右通道映射到引脚12(BCM = 18)。
我们先用这个方法试试:
命令: sudo nano /boot/config.txt
输入后,使用组合键“Ctrl + X”,然后输入“Y”,回车保存修改。
设置好/boot/config.txt以后,跳转到2.3 低通滤波器接线。
2) 或者,你可以制作自己的DTO,参考下面的文章
嗨,使用dtoValay,我让PWM音频工作在我的pi-zero上:
https://hackaday.io/project/9467-pigrrl-zero/log/35090-pi-zero-pwm-audio-device-tree-overlay
无论哪种方式使用DTO,下一步就是低通滤波器(看本文后面):[https://learn.adafruit.com/adding-basic-audio-ouput-to-raspberry-pi-zero/pi-zero-pwm-audio#low-pass-filter-wiring]
选择2. 手动分配PWM引脚
如果您想设置单独的引脚和用途,则可以手动设置引脚功能。
- 恢复做选择1时修改的/boot/config.txt
pi@raspberrypi:~ $ sudo nano /boot/config.txt
- 重新启动Pi Zero W
pi@raspberrypi:~ $ sudo shutdown -h now
等待电源指示灯熄灭后,关闭电源
重新上电,登录ssh。
- 使用wiringpi的GPIO实用工具
在我们开始之前,先使用wiringpi的GPIO实用工具列出所有GPIO引脚和它们的当前功能/替代设置,请看: http://wiringpi.com/download-and-install/
上的文章:Wiring Pi -GPIO Interface library for the Raspberry Pi。
下载和安装Wiring Pi请看参考文档《树莓派GPIO控制》一文。
读取所有引脚的状态
pi@raspberrypi:~ $ gpio readall
这两个引脚的MODE类型为IN - 这意味着它们只是简单的输入。
- 下载更改GPIO ALT的工具
我们可以在Pi论坛中使用TimG的一个非常方便的工具来手动调整GPIO ALT(https://www.raspberrypi.org/forums/viewtopic.php?f=44&t=39138)。下载地址:https://learn.adafruit.com/pages/6577/elements/1960154/download
以下是完整的代码:
/*
Utility to switch Raspberry-Pi GPIO pin functions
Tim Giles 01/04/2013
Usage:
$ gpio_alt -p PIN_NUMBER -f ALT_NUMBER
Based on RPi code from Dom and Gert, 15-Feb-2013, <http://elinux.org/RPi_Low-level_peripherals#C_2>
and Gnu getopt() example <http://www.gnu.org/software/libc/manual/html_node/Example-of-Getopt.html#Example-of-Getopt>
*/
#include <ctype.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <fcntl.h>
#include <sys/mman.h>
#define BCM2708_PERI_BASE 0x20000000
#define GPIO_BASE (BCM2708_PERI_BASE + 0x200000) /* GPIO controller */
#define PAGE_SIZE (4*1024)
#define BLOCK_SIZE (4*1024)
int mem_fd;
void *gpio_map;
volatile unsigned *gpio;
void setup_io();
// GPIO setup macros. Always use INP_GPIO(x) before using OUT_GPIO(x) or SET_GPIO_ALT(x,y)
#define INP_GPIO(g) *(gpio+((g)/10)) &= ~(7<<(((g)%10)*3))
#define OUT_GPIO(g) *(gpio+((g)/10)) |= (1<<(((g)%10)*3))
#define SET_GPIO_ALT(g,a) *(gpio+(((g)/10))) |= (((a)<=3?(a)+4:(a)==4?3:2)<<(((g)%10)*3))
#define GPIO_SET *(gpio+7) // sets bits which are 1 ignores bits which are 0
#define GPIO_CLR *(gpio+10) // clears bits which are 1 ignores bits which are 0
int main (int argc, char **argv) {
int opt, flag, n_pin, n_alt;
flag=0;
while ((opt = getopt (argc, argv, "hp:f:")) != -1) {
switch (opt) {
case 'h':
break;
case 'p':
n_pin = atoi(optarg); flag |= 0b0001; break;
case 'f':
n_alt = atoi(optarg); flag |= 0b0010; break;
case '?':
// getopt() prints error messages, so don't need to repeat them here
return 1;
default:
abort ();
}
}
if (flag != 0b0011) {
fprintf (stderr, "Usage:\n$ gpio_alt -p PIN_NUM -f FUNC_NUM\n");
return 1;
}
setup_io(); // Set up gpi pointer for direct register access
INP_GPIO(n_pin); // Always use INP_GPIO(x) before using SET_GPIO_ALT(x,y)
SET_GPIO_ALT(n_pin, n_alt);
printf("Set pin %i to alternative-function %i\n", n_pin, n_alt);
return 0;
}
void setup_io() {
/* open /dev/mem */
if ((mem_fd = open("/dev/mem", O_RDWR|O_SYNC) ) < 0) {
printf("can't open /dev/mem \n");
exit(-1);
}
/* mmap GPIO */
gpio_map = mmap(
NULL, //Any adddress in our space will do
BLOCK_SIZE, //Map length
PROT_READ|PROT_WRITE,// Enable reading & writting to mapped memory
MAP_SHARED, //Shared with other processes
mem_fd, //File to map
GPIO_BASE //Offset to GPIO peripheral
);
close(mem_fd); //No need to keep mem_fd open after mmap
if (gpio_map == MAP_FAILED) {
printf("mmap error %d\n", (int)gpio_map);//errno also set!
exit(-1);
}
// Always use volatile pointer!
gpio = (volatile unsigned *)gpio_map;
}
在Pi ZeroW上,创建一个新文件并进行编辑(不管在什么目录):
pi@raspberrypi:~ $ nano gpio_alt.c
然后粘贴上面的整个代码。保存...
- 编译并安装
编译
pi@raspberrypi:~ $ gcc -o gpio_alt gpio_alt.c
改变所有者
pi@raspberrypi:~ $ sudo chown root:root gpio_alt
给gpio_alt以suid权限,可以像root用户一样操作
pi@raspberrypi:~ $ sudo chmod u+s gpio_alt
将gpio_alt移动到/usr/local/bin/
pi@raspberrypi:~ $ sudo mv gpio_alt /usr/local/bin/
- 现在你可以设置两个GPIO 的ALT功能了!
pi@raspberrypi:~ $ gpio_alt -p 13 -f 0
pi@raspberrypi:~ $ gpio_alt -p 18 -f 5
现在回到wiringPi检查我们是否做到了!
pi@raspberrypi:~ $ gpio readall
你可以看到新的ALT设置。当然,用选择1,设置/boot/config.txt的方法也可以看到这张图,殊途同归嘛。
2.3 低通滤波器接线
现在按照第1节的电路原理图,将低通滤波电路连接到GPIO#13和GPIO#18上,作为PWM1和PWM0。4个二极管可以忽略,跳过二极管。元件的参数不用太严格。
不必做的这么正规,我利用手头的元件,用洞洞板焊了一个低通滤波器,用起来挺好。看,就是这个:
3.5mm音频插座,左右声道和地接线。
用杜邦线和Pi Zero W连接起来,插上耳机:
2.4 设置音频输出
你还需要设置Pi Zero W,这样音频才会通过“耳机插孔”(PWM输出)流出,而不是HDMI。从控制台运行:
pi@raspberrypi:~ $ sudo raspi-config
转到Advanced Options
然后是音频
强制3.5mm耳机
选择OK,回车,然后Finish退出。这个过程你只需要做一次。
2.5 测试
你现在可以播放音频了!要重新启动一下Pi Zero W,注意,不要用reboot命令重启,容易丢失ssh文件!
关机:
- pi@raspberrypi:~ $ sudo shutdown -h now
- 等待电源指示灯熄灭后,关闭电源
插入有源扬声器或耳机,重新上电,登录ssh。
我们使用内置的aplay(该命令是ALSA系统的一部分)音频播放器播放内置的音频文件。运行:
pi@raspberrypi:~ $ aplay /usr/share/sounds/alsa/Front_Center.wav
你听到声音了吗,音质还不错哦。
2.6 调整音量
你可能会注意到一点点嗡嗡声,或者可能只是声音不大。要获得最佳音质,你需要调节音频电平。你可以用alsamixer或amixer调节音量,但我认为alsamixer更容易。
运行pi@raspberrypi:~ $ alsamixer
在终端上,音量是用ascii字符排列的图像界面来表现的,用4个方向箭头键调节,点击Esc保存并退出。
现在我们再回过头去试试第二种方法,虽然有点麻烦,但是对于机制的理解更好。
3. 自动化
如果你希望在启动时自动设置alt,我可以这样做。
- 首先创建一个shell脚本pwmaudio.sh
pi@raspberrypi:~ $ sudo nano /root/pwmaudio.sh
内容:
#!/bin/bash
/usr/local/bin/gpio_alt -p 13 -f 0
/usr/local/bin/gpio_alt -p 18 -f 5
- 修改权限
运行:
pi@raspberrypi:~ $ sudo chmod +x /root/pwmaudio.sh
- 创建另一个脚本pwmaudio.service
sudo nano /lib/systemd/system/pwmaudio.service
内容:
[Unit]
Description=PWM Audio Service
[Service]
ExecStart=/root/pwmaudio.sh
StandardOutput=null
[Install]
WantedBy=multi-user.target
Alias=pwmaudio.service
保存文件。
- 启用该服务enable
pi@raspberrypi:~ $ sudo systemctl enable pwmaudio.service
- 启动该服务start
pi@raspberrypi:~ $ sudo systemctl start pwmaudio.service
- 重新启动pi
注意:慎用sudo reboot,容易丢失文件,ssh文件很容易丢失。
pi@raspberrypi:~ $ sudo shutdown -h now
等待电源指示灯熄灭后,重新上电。
- 测试
重新登录。运行gpio readall命令来验证是否已设置了alts
成功!
参考文档
- 树莓派介绍https://blog.csdn.net/chentuo2000/article/details/81051241
- 电脑连接树莓派Zero W
https://blog.csdn.net/chentuo2000/article/details/81051308 - 树莓派GPIO控制https://blog.csdn.net/chentuo2000/article/details/81051645
- 树莓派 Zero W+温度传感器DS18B20
https://blog.csdn.net/chentuo2000/article/details/81051701 - Pi Zero PWM Audio - device tree overlay
https://hackaday.io/project/9467-piboy-zero/log/35090-pi-zero-pwm-audio-device-tree-overlay