該儲存庫包含與 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