Seeed-voicecard 项目安装与使用指南

Seeed-voicecard 项目安装与使用指南

seeed-voicecard This is an enhancement fork with the explicit aim of supporting current shipping Raspbian/Ubuntu kernels without requiring downgrading. Please donate at https://hintak.github.io/ if it works for you. Use vX.Y branch for kernel version vX.Y 项目地址: https://gitcode.com/gh_mirrors/seee/seeed-voicecard

1. 项目目录结构及介绍

Seeed-voicecard 项目是一个为 Raspberry Pi 提供音频输入输出的开源项目，支持 ReSpeaker Mic Hat、ReSpeaker 4 Mic Array、6-Mics Circular Array Kit 和 4-Mics Linear Array Kit 等硬件。项目的目录结构如下：

seeed-voicecard/
├── ac108_plugin/
├── ac108.c
├── ac108.h
├── ac108_6mic.state
├── ac108_asound.state
├── ac10x.h
├── ac101.c
├── ac101_regs.h
├── asound_2mic.conf
├── asound_4mic.conf
├── asound_6mic.conf
├── builddtbo.sh
├── default.pa
├── dkms.conf
├── install.sh
├── README.md
├── seeed-2mic-voicecard.dtbo
├── seeed-2mic-voicecard-overlay.dts
├── seeed-4mic-voicecard.dtbo
├── seeed-4mic-voicecard-overlay.dts
├── seeed-8mic-voicecard.dtbo
├── seeed-8mic-voicecard-overlay.dts
├── seeed-voicecard.c
├── seeed-voicecard.service
├── sound-compatible-4.18.h
├── ubuntu-prerequisite.sh
├── uninstall.sh
└── wm8960.c

• ac108_plugin/: 包含用于音频输入输出的插件代码。
• ac108.c 和 ac108.h: 定义了与 ReSpeaker 4 Mic Array 相关的核心代码。
• ac108_6mic.state 和 ac108_asound.state: ALSA 状态文件，用于配置音频设备。
• ac10x.h: 定义了与 ReSpeaker 相关的硬件抽象层。
• ac101.c 和 ac101_regs.h: 与 AC101 音频编解码器相关的代码。
• *asound_mic.conf: 配置文件，用于定义不同麦克风的音频接口。
• builddtbo.sh: 脚本文件，用于构建设备树 blob (dtbo) 文件。
• default.pa: PulseAudio 默认配置文件。
• dkms.conf: 用于 Debain 内核模块的管理。
• install.sh 和 uninstall.sh: 安装和卸载驱动程序的脚本。
• README.md: 项目说明文件。
• seeed-voicecard.c: 主驱动程序文件。
• seeed-voicecard.service: 系统服务文件，用于管理驱动程序服务。
• sound-compatible-4.18.h: 兼容性头文件。
• ubuntu-prerequisite.sh: 脚本文件，用于在 Ubuntu 系统上安装必要的依赖。

2. 项目的启动文件介绍

项目的启动主要是通过 install.sh 脚本完成的。以下是该脚本的简要说明：

• 安装依赖：脚本会检查并安装编译内核模块所需的依赖。
• 编译驱动：编译 seeed-voicecard.c 为内核模块。
• 加载驱动：使用 insmod 命令加载编译好的内核模块。
• 配置音频：设置音频设备的配置文件，如 asound_*mic.conf。
• 重启动：脚本会提示用户重启 Raspberry Pi 以使更改生效。

3. 项目的配置文件介绍

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

• *asound_mic.conf：这些文件定义了不同麦克风配置的音频接口，包括采样率、采样格式等。
• default.pa：PulseAudio 的默认配置文件，用于设置音频路由和混音器参数。
• dkms.conf：Debian 内核模块管理器配置文件，用于指定内核模块的参数。

在安装脚本执行完成后，这些配置文件会被放置到系统的相应位置，以供系统启动时使用。

seeed-voicecard This is an enhancement fork with the explicit aim of supporting current shipping Raspbian/Ubuntu kernels without requiring downgrading. Please donate at https://hintak.github.io/ if it works for you. Use vX.Y branch for kernel version vX.Y 项目地址: https://gitcode.com/gh_mirrors/seee/seeed-voicecard