该存储库包含与 conda 包管理器捆绑在一起的一系列开源软件无线电包的跨平台安装程序,包括
并支持以下 SDR 设备和设备库:
设备 | 图书馆 |
---|---|
亚当-冥王星 | libiio(设置) |
Airspy R2/Mini/HF+ | airspy/airspyhf(设置) |
刀片射频 | BladeRF(设置) |
埃图斯USRP | 超高清(设置) |
黑客射频 | HackRF(设置) |
石灰SDR | 石灰套房(设置) |
Mirics MSi001 + MSi2500 SDR 设备 | libmirisdr(设置) |
红火龙果 | 肥皂红火龙果 |
RFSpace/NetSDR/CloudSDR | SoapyNetSDR |
RTL-SDR | RTL-SDR(设置) |
声卡/音频设备 | 肥皂音频 |
完整的软件包列表可以在这里找到。您可以通过提出问题来建议添加其他软件。如果您在 radioconda 之上从源代码构建了其他软件,请将您的结果记录在问题中以帮助其他人(并帮助我打包它!)。
安装后,您将拥有功能齐全的 conda 发行版/环境,这意味着您可以使用conda
或mamba
命令安装其他软件包(如果通过 conda-forge 提供)或升级到最新版本。将 radioconda 视为 Anaconda 或 Miniforge 的替代品,但专门用于软件无线电。
注意: Radioconda 是由 conda-forge 项目维护的软件包构建的。如果您对特定软件包的 conda 安装有疑问或问题,请在相应的原料存储库中报告。
Radioconda 安装程序可在此处获取:https://github.com/ryanvolz/radioconda/releases。
操作系统 | 建筑学 | 安装者类型 | 下载 |
---|---|---|---|
Linux | x86_64 (amd64) | 命令行 | radioconda-Linux-x86_64.sh |
Linux | aarch64(arm64) | 命令行 | radioconda-Linux-aarch64.sh |
Linux | ppc64le (POWER8/9) | 命令行 | radioconda-Linux-ppc64le.sh |
macOS | x86_64(英特尔) | 命令行 | radioconda-MacOSX-x86_64.sh |
macOS | x86_64(英特尔) | 图形化 | radioconda-MacOSX-x86_64.pkg |
macOS | arm64(苹果芯片) 1 | 命令行 | radioconda-MacOSX-arm64.sh |
macOS | arm64(苹果芯片) 1 | 图形化 | radioconda-MacOSX-arm64.pkg |
视窗 | x86_64 (amd64) | 图形化 | radioconda-Windows-x86_64.exe |
对于命令行安装,请下载安装程序并运行:
bash radioconda-*-Linux-x86_64.sh # or similar for other installers for unix platforms
对于图形安装,请下载安装程序并双击它。
如果您已经安装了 conda/mamba,则可以跳过安装程序并通过运行以下命令创建包含所有 radioconda 软件包的新环境:
conda create -n radioconda -c conda-forge -c ryanvolz --only-deps radioconda
请参阅下文了解特定软件无线电设备的其他安装步骤。
对于非交互式使用,请通过运行以下命令查看选项:
bash radioconda-*-Linux-x86_64.sh -h # or similar for other installers for unix platforms
或者如果您使用的是 Windows,请运行:
start /wait "" build/radioconda--Windows-x86_64.exe /InstallationType=JustMe /RegisterPython=0 /S /D=%UserProfile%radioconda
尽管在 Windows 上某些应用程序会安装“开始”菜单的快捷方式,但您主要通过命令行使用 radioconda。
从“开始”菜单启动“radioconda Prompt”(您可以在“radioconda”目录下找到它)。从此命令行中,您可以运行mamba
来安装/升级软件包或运行使用 radioconda 安装的任何应用程序。某些应用程序还可以通过添加到“开始”菜单的快捷方式启动。
启动您最喜欢的终端。根据您在安装时选择的选项,您可能已经或可能尚未自动激活 radioconda“base”环境(您将在命令行提示符上看到“(base)”)。要以其他方式激活 radioconda“base”环境,请运行:
conda activate base
如果由于找不到conda
命令而失败,您可以通过运行手动激活环境
sh /bin/activate
在激活的环境中,您将能够运行mamba
来安装/升级软件包或运行使用 radioconda 安装的任何应用程序。
要安装特定的包:
mamba install
安装 radioconda 后,您可以通过以下方式保持所有软件包的最新状态:
mamba upgrade --all
要特别安装最新版本,请运行
(在 Windows 上):
mamba install --file https://github.com/ryanvolz/radioconda/releases/latest/download/radioconda-win-64.lock
(在 Linux/macOS 上):
mamba install --file https://github.com/ryanvolz/radioconda/releases/latest/download/radioconda-$(conda info | sed -n -e 's/^.*platform : //p').lock
要安装特定发行版本,请替换所需的版本号并运行
(在 Windows 上):
mamba install --file https://github.com/ryanvolz/radioconda/releases/download/20NN.NN.NN/radioconda-win-64.lock
(在 Linux/macOS 上):
mamba install --file https://github.com/ryanvolz/radioconda/releases/download/20NN.NN.NN/radioconda-$(conda info | sed -n -e 's/^.*platform : //p').lock
如果您开始使用全新环境或习惯于处理包冲突,则可以使用ryanvolz
频道中的radioconda
元包安装最新版本:
mamba install -c conda-forge -c ryanvolz --only-deps radioconda
(需要先指定conda-forge
通道,即使它是你的默认通道,这样ryanvolz
通道就不会优先。)
要安装特定发行版本,请替换所需的版本号并运行
mamba install -c conda-forge -c ryanvolz --only-deps radioconda=20NN.NN.NN
要使用特定的软件无线电设备,可能需要安装额外的驱动程序或固件。在下面找到您的设备并按照说明进行操作。 (如果说明不起作用或者您有其他说明需要添加,请通过提交问题来帮助添加到此部分!)
使用 Zadig 安装 WinUSB 驱动程序,选择名为“Bulk-In,接口(接口 0)”的设备。
将 DVB-T 模块列入黑名单,否则会占用该设备:
sudo ln -s $CONDA_PREFIX/etc/modprobe.d/rtl-sdr-blacklist.conf /etc/modprobe.d/radioconda-rtl-sdr-blacklist.conf
sudo modprobe -r $(cat $CONDA_PREFIX/etc/modprobe.d/rtl-sdr-blacklist.conf | sed -n -e 's/^blacklist //p')
通过在 radioconda 安装中创建链接来安装 udev 规则:
sudo ln -s $CONDA_PREFIX/lib/udev/rules.d/rtl-sdr.rules /etc/udev/rules.d/radioconda-rtl-sdr.rules
sudo udevadm control --reload
sudo udevadm trigger
通过下载并安装此文件来安装最新的 USB 驱动程序。
通过在 radioconda 安装中创建链接来安装 udev 规则:
sudo ln -s $CONDA_PREFIX/lib/udev/rules.d/90-libiio.rules /etc/udev/rules.d/90-radioconda-libiio.rules
sudo udevadm control --reload
sudo udevadm trigger
一旦您可以与硬件对话(按照下面的说明),您可能需要执行 Pluto 用户 wiki 上详细说明的安装后步骤。
您的设备的 WinUSB 驱动程序很可能会自动安装,在这种情况下,无需进行额外的设置。如果由于某种原因未安装驱动程序并且无法识别设备,请使用 Zadig 安装 WinUSB 驱动程序,并选择您的 Airspy 设备。
通过在 radioconda 安装中创建链接来安装 udev 规则:
# run the next line only for the Airspy R2 or Mini
sudo ln -s $CONDA_PREFIX/lib/udev/rules.d/52-airspy.rules /etc/udev/rules.d/52-radioconda-airspy.rules
# run the next line only for the Airspy HF+
sudo ln -s $CONDA_PREFIX/lib/udev/rules.d/52-airspyhf.rules /etc/udev/rules.d/52-radioconda-airspyhf.rules
sudo udevadm control --reload
sudo udevadm trigger
然后,确保您的用户帐户属于 Plugdev 组,以便能够访问您的设备:
sudo usermod -a -G plugdev
您可能需要重新启动才能使此更改生效。
使用 Zadig 安装 WinUSB 驱动程序,选择您的 HackRF 设备。
通过在 radioconda 安装中创建链接来安装 udev 规则:
sudo ln -s $CONDA_PREFIX/lib/udev/rules.d/53-hackrf.rules /etc/udev/rules.d/53-radioconda-hackrf.rules
sudo udevadm control --reload
sudo udevadm trigger
然后,确保您的用户帐户属于 Plugdev 组,以便能够访问您的设备:
sudo usermod -a -G plugdev
您可能需要重新启动才能使此更改生效。
使用 Zadig 安装 WinUSB 驱动程序,选择您的 BladeRF 设备。
通过在 radioconda 安装中创建链接来安装 udev 规则:
sudo ln -s $CONDA_PREFIX/lib/udev/rules.d/88-nuand-bladerf1.rules /etc/udev/rules.d/88-radioconda-nuand-bladerf1.rules
sudo ln -s $CONDA_PREFIX/lib/udev/rules.d/88-nuand-bladerf2.rules /etc/udev/rules.d/88-radioconda-nuand-bladerf2.rules
sudo ln -s $CONDA_PREFIX/lib/udev/rules.d/88-nuand-bootloader.rules /etc/udev/rules.d/88-radioconda-nuand-bootloader.rules
sudo udevadm control --reload
sudo udevadm trigger
然后,确保您的用户帐户属于 Plugdev 组,以便能够访问您的设备:
sudo usermod -a -G plugdev
您可能需要重新启动才能使此更改生效。
conda-forge 包使用 libusb 通过 USB 与 LimeSDR 设备进行通信,而不是使用非开源的标准 CyUSB 库。如果您已将 LimeSDR 与其他软件包一起使用,则必须将 USB 驱动程序切换为与 WinUSB/libusb 兼容的驱动程序。
使用 Zadig 安装 WinUSB 驱动程序,选择您的 Lime 设备。
通过在 radioconda 安装中创建链接来安装 udev 规则:
sudo ln -s $CONDA_PREFIX/lib/udev/rules.d/64-limesuite.rules /etc/udev/rules.d/64-radioconda-limesuite.rules
sudo udevadm control --reload
sudo udevadm trigger
通过激活 conda 提示符并运行来下载固件文件
uhd_images_downloader
您可能必须为该设备安装 USB 驱动程序。按照 Ettus 网站的说明进行操作,或使用 Zadig 安装 WinUSB 驱动程序(您的设备将具有以 2500 或 3923 开头的 USB ID)。
通过在 radioconda 安装中创建链接来安装 udev 规则:
sudo ln -s $CONDA_PREFIX/lib/uhd/utils/uhd-usrp.rules /etc/udev/rules.d/radioconda-uhd-usrp.rules
sudo udevadm control --reload
sudo udevadm trigger
使用 Zadig 安装 WinUSB 驱动程序,选择您的 MiriSDR 设备。
通过在 radioconda 安装中创建链接来安装 udev 规则:
sudo ln -s $CONDA_PREFIX/lib/udev/rules.d/mirisdr.rules /etc/udev/rules.d/radioconda-mirisdr.rules
sudo udevadm control --reload
sudo udevadm trigger
许多 USB 设备使用 libusb,并且需要在 Windows 上安装 WinUSB 驱动程序。请按照以下步骤为您的设备安装驱动程序:
下载并运行 Zadig
选择您的设备
确保目标驱动程序(界面中间)读取“WinUSB”
单击“安装驱动程序”或“替换驱动程序”
每个安装程序包都是使用 conda 构造函数从 installer_specs 中的规范目录构建的。可以使用 build_installer.py 脚本手动构建安装程序。规范目录设置所包含包的确切版本,以便constructor
将生成可预测的结果,每个版本都可以由 git 跟踪。反过来,通过使用 rerender.py 脚本重新渲染radioconda 环境规范文件来创建/更新规范目录。
因此,创建新安装程序包的过程是:
radioconda.yaml
。rerender.py
重新渲染构造函数规范目录。build_installer.py
构建特定平台的安装程序包。要使用 GitHub 的 CI 发布新版本的 radioconda 并构建安装程序包:
注意:使用预发布对于确保“最新”链接有效非常重要。
苹果的芯片构建是实验性的,没有像其他平台那样进行测试。 ↩ ↩ 2