Sipeed 6+1Mic Array 声源定位波束成形麦克风阵列

这个API为你提供了在MaixPy环境下处理音频文件的基础工具，目前主要包括音频格式常量和文件读写类。

maix.audio 模块通过一个 Format 枚举定义了一套音频采样格式，用来统一处理不同的数据类型和字节序。文档里还提供了一个 fmt_bits 变量，可以方便地查询每种格式对应的位深。

maix.audio.File 类提供了读写音频文件的核心功能。

构造函数 __init__：创建一个新的文件对象。你可以提前指定音频参数，这在处理不含头的PCM文件时是必须的。 from maix import audio # 创建一个用于处理16000Hz采样率、单声道、16位采样深度的PCM文件的对象 my_audio_file = audio.File(sample_rate=16000, channels=1, bits_per_sample=16)
加载文件 load：从文件路径加载音频文件。它能够智能识别WAV文件头，而对于PCM文件，如果构造函数中没有指定参数，则需要在 load() 方法中提供。
python # 加载WAV文件 (会自动读取头信息) err = my_audio_file.load("/sd/record.wav") # 加载PCM文件 (需指定参数) err = my_audio_file.load("/sd/record.pcm", sample_rate=16000, channels=1, bits_per_sample=16)

这是一块专为麦克风阵列设计的驱动板，核心是BL616芯片，主要功能是将麦克风阵列采集到的音频和声场数据上传到电脑或其他设备。

8通道音频采集 (UAC 2.0)：通过USB将8通道、48kHz采样率、16位有符号小端格式的PCM音频数据，直接传输给电脑，可被识别为标准麦克风设备。
声场热力图输出 (CDC ACM / UART)：将声源定位、波束成形的计算结果（16x16网格的声场热力图），通过两种接口实时输出：
- USB虚拟串口 (CDC ACM)：在电脑端接收热力图数据。
- UART：以2,000,000 bps的高波特率，为MCU等嵌入式设备提供数据。
声场可视化：输出的声场热力图数据可用于在上位机或MCU上进行声场成像和声源定位分析。

以下指南可以帮助你快速上手：

硬件准备：
- 使用5V USB线将MA-USB8连接到电脑（标准模式）或MCU开发板（UART模式）。
- MA-USB8会自动上电，指示灯会亮起或闪烁。
模式选择：
- 首选模式 (USB)：同时使用UAC 2.0（8通道音频）和CDC ACM（串口热力图数据）。这是最推荐的方式，可以在电脑上同时获得音频与声场信息。
- 备用模式 (UART / USB2TTL)：仅通过UART（2,000,000波特率）获取声场热力图数据，适合嵌入式MCU场景。
设备验证 (Linux)：
- 检查识别：插入设备后，运行 dmesg | tail 应能看到创建了 /dev/ttyACM0 设备。
- 检查音频：运行 arecord -l，在列表中应能看到一个8通道的UAC音频设备。
设备验证 (Windows)：
- 打开“设备管理器”，应在“音频、视频和游戏控制器”下看到“MicArray (UAC2.0)”，在“端口 (COM和LPT)”下看到“USB串行设备 (CDC ACM)”。

补充说明：BL616是一颗来自博流智能（Bouffalo Lab）的RISC-V架构芯片，为MA-USB8提供了核心算力。MA-USB8需要配合独立的麦克风阵列模块（如Sipeed的6+1麦克风阵列）才能完整工作。

这两个页面紧密相关：maix.audio API 是在 MaixPy 软件层面进行音频处理（如播放、录音）的工具，而 MA-USB8 则是一个硬件驱动板，专门用于采集多通道音频和声场数据，并可通过 maix.audio 等工具在电脑上进行分析处理。

MaixPy 还提供了更多进阶的音频处理和识别功能：

常见问题

输出的8个通道的音频和阵列上麦克风的对应关系是什么？前6个对应着板上一圈麦克风的序号。第8个是中心的麦克风。第7个通道是波束成形处理后的音频。