# software_resample_debug

**Repository Path**: haihuiqiu/software_resample_debug

## Basic Information

- **Project Name**: software_resample_debug
- **Description**: software_resample_debug
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-23
- **Last Updated**: 2026-03-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 软件重采样与声道转换调试工具

这是一个PC端调试软件，用于测试音频采样率转换（重采样）和声道转换功能。代码采用纯C语言编写，可直接移植到嵌入式MCU上运行。

## 功能特性

- **采样率转换**：支持不同采样率之间的音频重采样（如16kHz、44.1kHz、48kHz等）
- **声道转换**：支持单声道与立体声之间的相互转换
- **调试功能**：内置调试日志和输出质量分析功能
- **可移植性**：代码结构清晰，易于移植到嵌入式平台

## 项目结构

```
├── main.c                 # 主程序入口，包含测试代码
├── main.h                 # 主程序头文件
├── resampler.c            # 重采样核心实现
├── resampler.h            # 重采样接口定义
├── channel_conversion.c   # 声道转换测试
├── channel_conversion.h   # 声道转换头文件
├── audio_conver_config.c # 重采样配置
├── audio_conver_config.h  # 配置头文件
├── log_debug.c            # 调试日志实现
├── log_debug.h            # 调试日志头文件
├── sine_data.c            # 测试用正弦波数据
├── sine_data.h            # 正弦波数据头文件
├── typedef.h              # 类型定义
├── Makefile               # 构建配置文件
└── output.exe             # 编译输出可执行文件
```

## 构建说明

### 环境要求

- Windows 系统
- Visual Studio 2022 (或兼容的MSVC编译器)

### 编译步骤

```bash
# 清理之前的构建
make clean

# 使用MSVC工具链编译
make msvc -j

# 编译并运行
make msvc -j
./output.exe
```

## 使用说明

编译完成后运行 `output.exe`，程序将自动执行以下测试：

1. **基础功能测试**：验证重采样基本功能
2. **溢出测试**：测试边界条件下的处理能力
3. **质量分析**：分析输出音频质量

## 核心API

重采样器主要接口（在 `resampler.h` 中定义）：

- `RS_Init` - 初始化重采样器
- `RS_SetRate` - 设置输入输出采样率
- `RS_ProcessSamples` - 处理音频采样点
- `RS_Process` - 处理音频帧
- `RS_Reset` - 重置重采样器状态
- `RS_Free` - 释放重采样器资源

## 配置选项

在 `audio_conver_config.c` 中可配置：

- `RS_DEFAULT_QUALITY` - 默认重采样质量
- `RS_MAX_RAM_BYTES` - 最大内存使用量
- `RS_ENABLE_ASRC` - 异步采样率转换使能

## 移植说明

该代码设计为嵌入式友好，移植时需注意：

1. 将 `log_debug.c` 中的调试输出替换为目标平台的日志接口
2. 根据目标MCU的RAM大小调整 `RS_MAX_RAM_BYTES` 配置
3. 确保目标平台支持必要的整数类型（int16_t, uint32_t等）

## 许可证

本项目仅供学习交流使用。