SDRPlusPlus项目在MacOS上使用SDRPlay设备的兼容性问题分析

问题背景

SDRPlusPlus是一款功能强大的软件定义无线电(SDR)应用程序，支持多种SDR硬件设备。近期有用户在MacOS Sequoia 15.1系统上使用SDRPlay设备时遇到了兼容性问题，主要表现为无法正常识别和使用RSP设备。

环境配置

用户报告的环境配置如下：

• 硬件：Apple M4芯片，512GB内存
• 操作系统：MacOS Sequoia 15.1
• SDR设备：SDRPlay RSP系列设备
• SDRPlay API版本：3.15

问题现象

用户在MacOS上安装SDRPlay API v3.15后，虽然能够成功编译SDR++并创建应用程序，但在实际使用时出现以下错误：

Could not select RSP device: sdrplay_api_Fail

问题排查过程

1. 库文件定位：用户首先确认了SDRPlay API库文件的位置在/usr/local/lib/libsdrplay_api.so.3.15，并正确复制到了应用程序的Frameworks目录。

2. API版本测试：用户尝试降级到SDRPlay API v3.14后，问题暂时得到解决，这表明v3.15版本在MacOS 15.1上可能存在兼容性问题。

3. 服务稳定性：即使用v3.14版本临时解决问题，约15分钟后sdrplay_apiService服务仍会出现USB watchdog错误和USB锁死现象，导致SDR++停止工作。

4. 设备差异：其他用户反馈显示，API 3.15在某些情况下可以识别旧款RSP1设备，但对RSP1B的支持存在问题。

技术分析

1. API服务机制：SDRPlay设备通过sdrplay_apiService后台服务与应用程序通信。在MacOS 15.1上，该服务可能存在稳定性问题，特别是在处理USB通信时。

2. 版本兼容性：SDRPlay API 3.15版本可能未充分适配MacOS 15.1的新特性或安全机制，导致设备枚举失败。

3. 权限问题：MacOS的USB设备访问权限管理可能影响了API服务的正常运行。

解决方案建议

1. 临时解决方案：

   • 使用SDRPlay API v3.14版本
   • 从v3.14版本中提取sdrplay_apiService替换v3.15版本中的对应文件

2. 长期解决方案：

   • 等待SDRPlay官方发布针对MacOS 15.1的API更新
   • 关注SDR++项目的更新，可能包含对最新API的适配

3. 替代方案：

   • 使用SDRConnect应用程序（内置SDRPlay支持，不依赖API包）
   • 考虑使用其他兼容的SDR硬件

开发者说明

SDR++开发者指出，当SDRPlay API返回错误时，这超出了SDR++的控制范围。对于RSP1B设备的支持是近期才添加的功能，用户应确保使用最新版本的SDR++。

总结

MacOS用户在使用SDRPlay设备与SDR++配合时，需要注意API版本与操作系统版本的兼容性。目前推荐使用经过验证的API v3.14版本，并关注官方更新以获取更好的兼容性支持。对于开发者和高级用户，可以尝试分析API服务日志以获取更详细的问题诊断信息。