Seeed-voicecard 项目使用教程

1. 项目目录结构及介绍

Seeed-voicecard 项目是一个为 Raspberry Pi 上的 ReSpeaker Mic Hat、ReSpeaker 4 Mic Array、6-Mics Circular Array Kit 和 4-Mics Linear Array Kit 提供驱动支持的开源项目。项目的目录结构如下：

• ac108_plugin/: 包含 AC108 插件相关文件。
• patches/: 包含一些补丁文件，用于调整和修复与内核版本相关的兼容性问题。
• pulseaudio/: 包含 PulseAudio 相关配置文件。
• tools/: 包含一些用于测试和配置的脚本工具。
• LICENSE: 项目使用的 GPL-3.0 许可证文件。
• Makefile: 编译项目所需的 Makefile 文件。
• README.md: 项目说明文件。
• ac101.c: AC101 驱动实现文件。
• ac101_regs.h: AC101 寄存器定义头文件。
• ac108.c: AC108 驱动实现文件。
• ac108.h: AC108 驱动头文件。
• ac108_6mic.state: AC108 6麦状态文件。
• ac108_asound.state: AC108 音频状态文件。
• ac10x.h: AC10x 驱动头文件。
• asound_2mic.conf: 2麦音频配置文件。
• asound_4mic.conf: 4麦音频配置文件。
• asound_6mic.conf: 6麦音频配置文件。
• builddtbo.sh: 用于构建 dtbo 文件的脚本。
• default.pa: PulseAudio 默认配置文件。
• dkms.conf: DKMS 配置文件。
• install.sh: 安装脚本。
• seeed-2mic-voicecard-overlay.dts: 2麦声卡设备树文件。
• seeed-2mic-voicecard.dtbo: 2麦声卡设备树二进制文件。
• seeed-4mic-voicecard-overlay.dts: 4麦声卡设备树文件。
• seeed-4mic-voicecard.dtbo: 4麦声卡设备树二进制文件。
• seeed-8mic-voicecard-overlay.dts: 8麦声卡设备树文件。
• seeed-8mic-voicecard.dtbo: 8麦声卡设备树二进制文件。
• seeed-voicecard: 声卡内核模块文件。
• seeed-voicecard.c: 声卡内核模块实现文件。
• seeed-voicecard.service: 系统服务文件。
• sound-compatible-4.18.h: 兼容性头文件。
• ubuntu-prerequisite.sh: Ubuntu 系统安装依赖脚本。
• uninstall.sh: 卸载脚本。
• wm8960.c: WM8960 驱动实现文件。
• wm8960.h: WM8960 驱动头文件。
• wm8960_asound.state: WM8960 音频状态文件。

2. 项目的启动文件介绍

项目的启动主要是通过 install.sh 脚本进行的。以下是启动文件的基本步骤：

1. 克隆项目代码到本地。
2. 切换到项目目录。
3. 运行 install.sh 脚本进行安装。

git clone https://github.com/HinTak/seeed-voicecard.git
cd seeed-voicecard
sudo ./install.sh

安装完成后，需要重启 Raspberry Pi 以使驱动生效。

3. 项目的配置文件介绍

项目的配置文件主要用于设置音频设备和调整音频参数。以下是一些主要的配置文件：

• asound_2mic.conf, asound_4mic.conf, asound_6mic.conf: 这些文件是针对不同数量麦克风的音频配置文件，用于定义音频设备的参数。

• default.pa: PulseAudio 默认配置文件，用于设置 PulseAudio 系统的默认行为。

• install.sh 和 uninstall.sh: 这些脚本包含了安装和卸载驱动时需要的配置步骤，例如更新设备树、加载内核模块等。

在安装驱动后，可以根据具体需求调整这些配置文件以优化音频输出。