一、前期准备1、确认现有材料的芯片型号1【最简单】问卖家如果有。2从板子上查看。2、其他材料1充电器5V/2.5A2内存卡够用即可。3、参考资料1树莓派官方网站https://www.raspberrypi.com/ 在SoftWare目录下找镜像和烧录器2Seeed Studio 官方资料Getting Started with Raspberry Pi | Seeed Studio Wiki3SD Card Formatterhttps://pan.baidu.com/s/1t02Piyy2YyAy2Rp5luhqiA 提取码: cy1u其他也可参考链接里的工具4关于Git直接git clone的话会time out需要有替代方案。这里使用了加速器设置“允许局域网连接”代理端口号是加速器的。你有别的替代方案可忽略这点。附我图省事直接买的套餐如果能自己搭配的也可单买。图上的“双麦语音模块”其实是v1我实际收到的是v2wiki上提供了v1和v2两个版本的区分方式核心音频编解码器也从WM8960改为TLV320AIC3104这一点要注意。二、开始项目1、硬件组装1断电操作确保树莓派 Zero W 未通电。2对齐引脚将 ReSpeaker HAT 的 40-Pin 排母对准树莓派 Zero W 的 40-Pin 排针注意方向。3轻轻按压从上往下缓慢插入确保所有引脚完全插入、无歪斜。4固定螺丝可选如果附带铜柱和螺丝用铜柱将 HAT 固定在树莓派上防止松动。⚠️ 树莓派 Zero W 需要焊接排针才能安装 HAT。如果你的 Zero W 尚未焊接 40-Pin 排针请先用烙铁焊接排针通常随 HAT 附赠。2、系统烧录1系统版本这里选择烧录的系统镜像版本是 2024-11-19-raspios-bookworm-armhf-lite.img.xz内核版本6.6.51rpt-rpi-v6原因是参考wiki中的内核版本挑选的防止内核版本不兼容等问题。2SD卡格式化从网盘中下载SD Card Formatter将要用于本次项目的SD卡格式化不建议Windows自带的格式化。3烧录器官网新下载或者用上面网盘里的都可以样式不同。下面的以网盘中的烧录器演示。1选择设备2选择操作系统选择上面下载的系统镜像3选择SD卡空白的这一步前要先格式化用上面的SD Card Formatter。4还需要配置下Wifi和SSH。5以上都准备好之后就可以写入了。6写入结束。注意这里写入结束后先不要卸载SD卡。需要加配置文件。3、启动树莓派系统烧录完成后你可以在“此电脑”下看到如下左图如果看到如下右图在确定以上烧录步骤“成功”的前提下重新弹出下SD卡再重新插回加载即可有可能反复2~3次。1补充配置文件进入“bootfs”根目录添加如下3个文件1开启SSH在 SD 卡的boot分区根目录下新建一个名为ssh的文件注意不要有任何后缀名文件内容为空。2设置默认账号密码在 SD 卡的boot分区根目录下新建一个名为 userconf 的文件注意不要有任何后缀名文件格式为username:password其中username是上面设置WiFi时的username系统默认pi也可自定义password为上面设置WiFi时的密码的明文。${username}:encrypt‌(${password}) # password是Wifi密码的明文加密后样式类似$6$/4.VdYgDm7RJ0qM1$FwXCeQgDKkqrOU3RIRuDSKpauAbBvP11msq9X58c8Que2l1Dwq3vdJMgiZlQSbEXGaY5esVHGBNbCxKLVNqZW1在Git Bash中执行以下指令得到上述password明文的加密串重新生成上面给的只是个示例echo password | openssl passwd -6 -stdin3配置Wi-Fi在SD卡的boot分区根目录下新建一个名为wpa_supplicant.conf的文件写入以下内容请替换为你的实际 Wi-Fi 信息countryCN ctrl_interfaceDIR/var/run/wpa_supplicant GROUPnetdev update_config1 network{ ssid你的无线网名称 psk你的无线网密码 key_mgmtWPA-PSK }2首次启动与SSH连接1配置好上述文件后此时再将SD卡卸载并插到树莓派设备上。2接通电源等待1~3分钟。3获取IP地址登录你的路由器管理页面通常是192.168.1.1查找名为raspberrypi的终端设备及其 IP。或在电脑上尝试ping raspberrypi.localmDNS 方式。其中raspberrypi是系统默认的设备名如果你设置Wifi时自定义了设备名那就用自定义的那个。4SSH连接通过电脑连接该设备在终端中执行以下命令ssh username树莓派的IP地址如果报错 WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!一般首次连接时不会出现但如果是重新烧录后首次连接没有重新分配IP的话会出现那么在终端中执行以下ssh-keygen -R 树莓派的IP地址如果没有其他问题则会提示输入密码输入后的密码不可见是正常的回车字体变成绿色的就是登录成功了。4、初始化系统本来在这之前是有个“替换镜像源”的步骤的但替换后总是出错各种版本不匹配不清楚是怎么回事所以就不换了使用默认的官方源慢是慢了些好歹成功了。在安装过程中会使用到git相关的操作所以要先搞定git。因为系统版本不是太新所以经常会出现不兼容的情况架构冲突GPG ErrorSegmentation fault等等。# 先记录下系统的初始状态 git --version # 预期输出-bash: git: command not found uname -r # 预期输出6.6.51rpt-rpi-v6 uname -a # 预期输出Linux 设备名 6.6.51rpt-rpi-v6 #1 Raspbian 1:6.6.51-1rpt3 (2024-10-08) armv6l GNU/Linux uname -m # 预期输出armv6l cat /etc/os-release # 预期输出以下内容 PRETTY_NAMERaspbian GNU/Linux 12 (bookworm) NAMERaspbian GNU/Linux VERSION_ID12 VERSION12 (bookworm) VERSION_CODENAMEbookworm IDraspbian ID_LIKEdebian HOME_URLhttp://www.raspbian.org/ SUPPORT_URLhttp://www.raspbian.org/RaspbianForums BUG_REPORT_URLhttp://www.raspbian.org/RaspbianBugsGit安装# 之前安装失败如果有的残留文件可能会导致后续校验错误。 sudo apt clean sudo rm -rf /var/lib/apt/lists/* # 强制更新索引 sudo apt update # 尝试安装 git sudo apt install git -y # 不报错的话验证git安装情况 git --version # 预期输出git version 2.39.5反正能输出版本号就行。然后把上一步记录系统初始状态的命令再执行一次对比是否有变化没有的话就OK。在执行git clone时如果报错Connection reset by peer可参考如下操作# 在保证树莓派设备与你的电脑在同一网络的前提下做如下配置 git config --global http.proxy http://192.168.1.100:7890 git config --global https.proxy http://192.168.1.100:7890其中192.168.1.100是你电脑的IP查看方式同上7890是代理客户端的端口号以你自己的为准。5、安装驱动从这一步开始就要参考Wiki中的步骤了我参考的时间截止到2026-7-2后面Wiki再更新的话就不用看接下来的内容了。注意不建议全部复制后一次性执行可能会报错建议一步步来每步执行后根据报错情况判断。## Install kernel sudo apt install flex bison libssl-dev bc build-essential libncurses5-dev libncursesw5-dev linux-headers-6.6.51rpt-rpi-v6 git clone --depth1 --branch rpi-6.6.y https://github.com/raspberrypi/linux.git ## Make target directory mkdir ~/tlv320aic3x_i2c_driver cd ~/tlv320aic3x_i2c_driver ## Copy code cp ~/linux/sound/soc/codecs/tlv320aic3x.c ~/tlv320aic3x_i2c_driver/ cp ~/linux/sound/soc/codecs/tlv320aic3x.h ~/tlv320aic3x_i2c_driver/ cp ~/linux/sound/soc/codecs/tlv320aic3x-i2c.c ~/tlv320aic3x_i2c_driver/ ## Modify Makefile nano Makefile ------------------- obj-m snd-soc-tlv320aic3x-i2c.o snd-soc-tlv320aic3x-i2c-objs : tlv320aic3x.o tlv320aic3x-i2c.o KDIR : /lib/modules/$(shell uname -r)/build PWD : $(shell pwd) all: $(MAKE) -C $(KDIR) M$(PWD) modules clean: $(MAKE) -C $(KDIR) M$(PWD) clean install: sudo cp snd-soc-tlv320aic3x-i2c.ko /lib/modules/$(shell uname -r)/kernel/sound/soc/codecs/ sudo depmod -a ------------------- ## Compile the driver make sudo make install sudo modprobe snd-soc-tlv320aic3x-i2c ## Check logs lsmod | grep tlv320 dmesg | grep tlv320如果执行过程中在如下位置报错执行接下来的make命令时提示Makefile:8: *** missing separator (did you mean TAB instead of 8 spaces?). Stop.则按提示修改图示位置将 8 spaces 代表的缩进替换为使用 tab 键代表的缩进。接下来wiki原文中要求操作如下图AI不建议执行“make”这个步骤驱动文件会被覆盖所以跳过“make”这一步只借用“设备树文件”不使用编译脚本# 加载代码拿到 .dts 文件。 git clone https://github.com/Seeed-Studio/seeed-linux-dtoverlays.git # 不执行 make 命令 # 确保安装了设备树编译器 sudo apt install device-tree-compiler # 找到 .dts 文件并编译它 dtc - -I dts -O dtb -o respeaker-2mic-v2_0.dtbo overlays/rpi/respeaker-2mic-v2_0-overlay.dts如果编译报错“FATAL ERROR: Couldnt open overlays/rpi/respeaker-2mic-v2_0-overlay.dts: No such file or directory”可能当前所在的目录层级不对切换一下所在位置或者根据你当前位置改变指令中的目录层级。执行成功后配置设备# 手动复制并配置 sudo cp respeaker-2mic-v2_0.dtbo /boot/firmware/overlays/ echo dtoverlayrespeaker-2mic-v2_0 | sudo tee -a /boot/firmware/config.txt如果执行成功则sudo reboot重启。等待1~3分钟后重新ssh连接连接成功后验证声卡是否识别成功。# 检查内核日志看是否报错 dmesg | grep -i respeaker\|tlv320\|simple-card # 检查声卡列表看是否有新设备出现 aplay -l # 预期输出与“seeed2micvoicec”相关的设备描述 arecord -l6、录音测试# 录制一段 5 秒钟的 wav 音频 arecord -D plughw:0,0 -f cd -d 5 test.wav # 播放刚才录制的音频通过耳机孔或HDMI输出取决于你的默认设置 aplay test.wav # 如果扬声器接在 ReSpeaker 的耳机孔上播放时可能需要指定 -D plughw:0,0执行 alsamixer可以看到如下面板