IoT-For-Beginners 的 ReSpeaker HAT 未被检测到如何安装 seeed-voicecard 驱动并验证音频设备【免费下载链接】IoT-For-Beginners12 Weeks, 24 Lessons, IoT for All!项目地址: https://gitcode.com/GitHub_Trending/io/IoT-For-Beginners在 IoT-For-Beginners 的消费类项目第 6 项目「consumer」第 1 课中你会给 Raspberry Pi 配一个麦克风之后用语音控制智能定时器。如果选用的麦克风是 ReSpeaker 2-Mics Pi HAT把它扣到 Pi 上之后运行arecord -l设备列表里却没有 ReSpeaker 条目——即故障排查文档中描述的「Audio device not detected」。这时需要安装 seeed-voicecard 音频卡驱动再逐步验证录音和放音设备是否可用。以下内容整理自仓库的 TROUBLESHOOTING.md 与 pi-microphone.md。安装驱动前先确认物理连接在动手装驱动之前先排除硬件层面的问题因为驱动装对了也救不了没插好的 HAT确认 ReSpeaker HAT 已正确压在 GPIO 排针上GPIO pins 完全贴合。ReSpeaker 2-Mics Pi HAT 是扣在 Pi 上的如果你之前用了 Grove Base Hat需要先把 Grove Base Hat 拆下来再装上 ReSpeaker HAT。这个 HAT 自带一个 Grove 按键装上它之后就不再需要 Grove Base Hat。确认安装是否缺失的最直接方法是在 Pi 的终端或 VS Code 的远程 SSH 会话运行arecord -l如果输出里只有 USB 麦克风之类的设备、没有 ReSpeaker说明驱动还没装上进入下一步。安装 seeed-voicecard 驱动故障排查文档给出的驱动安装命令如下。先确认 Pi 上有git——文档特别提醒如果没装git先执行sudo apt install git --yes然后克隆驱动仓库并运行安装脚本git clone https://github.com/HinTak/seeed-voicecard cd seeed-voicecard sudo ./install.sh sudo reboot注意./install.sh是系统级安装脚本需要sudo权限它会把 seeed-voicecard 的 ALSA 驱动写入系统执行完必须按文档要求sudo reboot重启 Pi驱动才会生效。验证音频设备是否被检测到重启后按以下顺序验证。1. 确认麦克风出现在设备列表再次运行arecord -l文档中的判断标准是arecord -l应该列出 ReSpeaker。列表中的设备带有 card 编号例如文档给出的示例输出文档示例你的设备名和 card 编号可能不同piraspberrypi:~ $ arecord -l **** List of CAPTURE Hardware Devices **** card 1: M0 [eMeet M0], device 0: USB Audio [USB Audio] Subdevices: 1/1 Subdevice #0: subdevice #0记下 ReSpeaker 对应的 card 编号后续写录音代码时要用它。如果系统里还有其他麦克风课程文档建议只保留一个在位、拔掉其余的因为 Linux 上多个麦克风并存时配置容易出问题。2. 确认扬声器并设置默认输出卡运行aplay -l输出中总会有一项card 0: Headphones这是 Pi 内置 3.5mm 耳机口你外接的扬声器会作为额外的 card 出现在列表里。如果你用的是外接扬声器而不是插在耳机口的设备需要把它设为默认输出sudo nano /usr/share/alsa/alsa.conf用方向键找到这一行defaults.pcm.card 0把0改成aplay -l里目标声卡的 card 编号例如改成defaults.pcm.card 1。用Ctrlx退出、按y保存、按回车确认文件名。3. 录音并回放端到端确认设备可用用麦克风录 5 秒命令运行期间对着麦克风说话或其他出声arecord --formatS16_LE --duration5 --rate16000 --file-typewav out.wav5 秒后命令自动停止然后回放aplay --formatS16_LE --rate16000 out.wav能听到刚才录的内容说明 ReSpeaker 的录音链路已经通了。音量不合适时可以用alsamixer调整音量或麦克风增益。仍然异常时的检查项回放报错课程文档指回alsa.conf里设置的defaults.pcm.card确认填的 card 编号与aplay -l输出一致。Pi OS 版本差异故障排查文档提到某些 Raspberry Pi OS 版本需要更新驱动Update firmware: Some Pi OS versions need driver updates如果当前系统装完驱动仍识别不到优先怀疑这一点重新拉取 seeed-voicecard 仓库并再次执行安装。进入下一步代码时的提示音后续按 pi-audio.md 写 PyAudio 录音代码先sudo apt install libportaudio0 libportaudio2 libportaudiocpp0 portaudio19-dev libasound2-plugins --yes再pip3 install pyaudio运行时出现如下 ALSA 报错属于文档中明确说可以忽略的情况文档示例输出ALSA lib pcm.c:2565:(snd_pcm_open_noupdate) Unknown PCM cards.pcm.front ALSA lib pcm.c:2565:(snd_pcm_open_noupdate) Unknown PCM cards.pcm.rear如果出现OSError: [Errno -9997] Invalid sample rate按文档把代码里的rate从 48000 改成 44100 或 16000。到这里arecord -l列出 ReSpeaker、5 秒录音能正常回放就说明 HAT 已就位、驱动安装成功。接下来可以继续课程里的录音代码任务和语音转文本部分参考 pi-audio.md 与 pi-speech-to-text.md。【免费下载链接】IoT-For-Beginners12 Weeks, 24 Lessons, IoT for All!项目地址: https://gitcode.com/GitHub_Trending/io/IoT-For-Beginners创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
