Dieses Repository enthält plattformübergreifende Installationsprogramme für eine Sammlung von Open-Source -Software-Radiopaketen, die mit dem Conda-Paketmanager gebündelt sind, einschließlich
und Unterstützung für die folgenden SDR-Geräte und Gerätebibliotheken:
Gerät | Bibliothek |
---|---|
ADALM-PLUTO | libiio (Einrichtung) |
Airspy R2/Mini/HF+ | airspy/airspyhf (Einrichtung) |
BladeRF | bladeRF (Einrichtung) |
Ettus USRPs | UHD (Setup) |
HackRF | HackRF (Einrichtung) |
LimeSDR | Lime Suite (Einrichtung) |
Mirics MSi001 + MSi2500 SDR-Geräte | libmirisdr (Setup) |
Rote Pitaya | SoapyRedPitaya |
RFSpace/NetSDR/CloudSDR | SoapyNetSDR |
RTL-SDR | RTL-SDR (Setup) |
Soundkarte/Audiogeräte | SoapyAudio |
Die vollständige Liste der Pakete finden Sie hier. Sie können zusätzliche Software zur Einbindung vorschlagen, indem Sie ein Problem einreichen. Wenn Sie zusätzlich zu Radioconda zusätzliche Software aus dem Quellcode erstellt haben, dokumentieren Sie Ihre Ergebnisse in einer Ausgabe, um anderen zu helfen (und helfen Sie mir beim Verpacken!).
Nach der Installation verfügen Sie über eine voll funktionsfähige Conda-Distribution/-Umgebung, was bedeutet, dass Sie die Befehle conda
oder mamba
verwenden können, um zusätzliche Pakete zu installieren (sofern über conda-forge verfügbar) oder auf die neuesten Versionen zu aktualisieren. Stellen Sie sich Radioconda als eine Alternative zu Anaconda oder Miniforge vor, die jedoch auf Software-Radio spezialisiert ist.
HINWEIS: Radioconda wird aus Paketen erstellt, die vom Conda-Forge-Projekt verwaltet werden. Wenn Sie Fragen oder Probleme haben, die sich speziell auf die Conda-Installation eines bestimmten Pakets beziehen, melden Sie diese bitte im entsprechenden Feedstock-Repository.
Radioconda-Installationsprogramme sind hier verfügbar: https://github.com/ryanvolz/radioconda/releases.
Betriebssystem | Architektur | Installateurtyp | Herunterladen |
---|---|---|---|
Linux | x86_64 (amd64) | Befehlszeile | radioconda-Linux-x86_64.sh |
Linux | aarch64 (arm64) | Befehlszeile | radioconda-Linux-aarch64.sh |
Linux | ppc64le (POWER8/9) | Befehlszeile | radioconda-Linux-ppc64le.sh |
macOS | x86_64 (Intel) | Befehlszeile | radioconda-MacOSX-x86_64.sh |
macOS | x86_64 (Intel) | Grafisch | radioconda-MacOSX-x86_64.pkg |
macOS | arm64 (Apple Silicon) 1 | Befehlszeile | radioconda-MacOSX-arm64.sh |
macOS | arm64 (Apple Silicon) 1 | Grafisch | radioconda-MacOSX-arm64.pkg |
Windows | x86_64 (amd64) | Grafisch | radioconda-Windows-x86_64.exe |
Laden Sie für eine Befehlszeileninstallation das Installationsprogramm herunter und führen Sie Folgendes aus:
bash radioconda-*-Linux-x86_64.sh # or similar for other installers for unix platforms
Für eine grafische Installation laden Sie das Installationsprogramm herunter und doppelklicken darauf.
Wenn Sie bereits über Conda/Mamba verfügen, können Sie das Installationsprogramm überspringen und eine neue Umgebung mit allen Radioconda-Paketen erstellen, indem Sie Folgendes ausführen:
conda create -n radioconda -c conda-forge -c ryanvolz --only-deps radioconda
Weitere Installationsschritte für bestimmte Software-Funkgeräte finden Sie weiter unten.
Sehen Sie sich bei nicht interaktiver Nutzung die Optionen an, indem Sie Folgendes ausführen:
bash radioconda-*-Linux-x86_64.sh -h # or similar for other installers for unix platforms
oder wenn Sie Windows verwenden, führen Sie Folgendes aus:
start /wait "" build/radioconda--Windows-x86_64.exe /InstallationType=JustMe /RegisterPython=0 /S /D=%UserProfile%radioconda
Sie verwenden Radioconda meist über die Befehlszeile, obwohl einige Anwendungen unter Windows Verknüpfungen zum Startmenü installieren.
Starten Sie „radioconda Prompt“ über das Startmenü (Sie finden es im Verzeichnis „radioconda“). Von dieser Befehlszeile aus können Sie mamba
ausführen, um Pakete zu installieren/aktualisieren oder eine der mit radioconda installierten Anwendungen auszuführen. Einige Anwendungen können auch über Verknüpfungen gestartet werden, die dem Startmenü hinzugefügt werden.
Starten Sie Ihr Lieblingsterminal. Abhängig von den Optionen, die Sie während der Installation ausgewählt haben, ist die Radioconda-Umgebung „base“ möglicherweise bereits automatisch aktiviert (in Ihrer Befehlszeilenaufforderung wird „(base)“ angezeigt). Um die Radioconda-Basisumgebung anderweitig zu aktivieren, führen Sie Folgendes aus:
conda activate base
Wenn dies fehlschlägt, weil der Befehl conda
nicht gefunden wird, können Sie die Umgebung manuell durch Ausführen aktivieren
sh /bin/activate
In einer aktivierten Umgebung können Sie mamba
ausführen, um Pakete zu installieren/aktualisieren oder alle mit radioconda installierten Anwendungen auszuführen.
So installieren Sie ein bestimmtes Paket:
mamba install
Sobald Sie Radioconda installiert haben, können Sie über alle Pakete auf dem Laufenden bleiben mit:
mamba upgrade --all
Um insbesondere die neueste Version zu installieren, führen Sie Folgendes aus:
(unter Windows):
mamba install --file https://github.com/ryanvolz/radioconda/releases/latest/download/radioconda-win-64.lock
(unter Linux/macOS):
mamba install --file https://github.com/ryanvolz/radioconda/releases/latest/download/radioconda-$(conda info | sed -n -e 's/^.*platform : //p').lock
Um eine bestimmte Release-Version zu installieren, ersetzen Sie die gewünschte Versionsnummer und führen Sie sie aus
(unter Windows):
mamba install --file https://github.com/ryanvolz/radioconda/releases/download/20NN.NN.NN/radioconda-win-64.lock
(unter 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
Wenn Sie mit einer neuen Umgebung beginnen oder mit Paketkonflikten vertraut sind, können Sie die neueste Version mithilfe des radioconda
Metapakets aus dem ryanvolz
-Kanal installieren:
mamba install -c conda-forge -c ryanvolz --only-deps radioconda
(Es ist notwendig, zuerst den conda-forge
-Kanal anzugeben, auch wenn es Ihr Standardkanal ist, damit der ryanvolz
-Kanal keine Priorität hat.)
Um eine bestimmte Release-Version zu installieren, ersetzen Sie die gewünschte Versionsnummer und führen Sie sie aus
mamba install -c conda-forge -c ryanvolz --only-deps radioconda=20NN.NN.NN
Um bestimmte Software-Funkgeräte nutzen zu können, kann es erforderlich sein, zusätzliche Treiber oder Firmware zu installieren. Suchen Sie unten nach Ihrem Gerät und befolgen Sie die Anweisungen. (Helfen Sie mit, diesen Abschnitt zu ergänzen, indem Sie ein Problem einreichen, wenn die Anweisungen nicht funktionieren oder Sie zusätzliche Anweisungen hinzufügen möchten!)
Installieren Sie den WinUSB-Treiber mit Zadig und wählen Sie das Gerät mit der Bezeichnung „Bulk-In, Interface (Interface 0)“ aus.
Setzen Sie die DVB-T-Module auf die schwarze Liste, die sonst das Gerät beanspruchen würden:
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')
Installieren Sie eine udev-Regel, indem Sie einen Link in Ihre Radioconda-Installation erstellen:
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
Installieren Sie die neuesten USB-Treiber, indem Sie diese Datei herunterladen und installieren.
Installieren Sie eine udev-Regel, indem Sie einen Link in Ihre Radioconda-Installation erstellen:
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
Sobald Sie mit der Hardware kommunizieren können (indem Sie die nachstehenden Anweisungen befolgen), möchten Sie möglicherweise die im Pluto-Benutzer-Wiki beschriebenen Schritte nach der Installation ausführen.
Der WinUSB-Treiber für Ihr Gerät wird höchstwahrscheinlich automatisch installiert und in diesem Fall ist keine zusätzliche Einrichtung erforderlich. Wenn der Treiber aus irgendeinem Grund nicht installiert ist und das Gerät nicht erkannt wird, installieren Sie den WinUSB-Treiber mit Zadig und wählen Sie Ihr Airspy-Gerät aus.
Installieren Sie eine udev-Regel, indem Sie einen Link in Ihre Radioconda-Installation erstellen:
# 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
Stellen Sie dann sicher, dass Ihr Benutzerkonto zur Gruppe plugdev gehört, um auf Ihr Gerät zugreifen zu können:
sudo usermod -a -G plugdev
Möglicherweise müssen Sie neu starten, damit diese Änderung wirksam wird.
Installieren Sie den WinUSB-Treiber mit Zadig und wählen Sie Ihr HackRF-Gerät aus.
Installieren Sie eine udev-Regel, indem Sie einen Link in Ihre Radioconda-Installation erstellen:
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
Stellen Sie dann sicher, dass Ihr Benutzerkonto zur Gruppe plugdev gehört, um auf Ihr Gerät zugreifen zu können:
sudo usermod -a -G plugdev
Möglicherweise müssen Sie neu starten, damit diese Änderung wirksam wird.
Installieren Sie den WinUSB-Treiber mit Zadig und wählen Sie Ihr BladeRF-Gerät aus.
Installieren Sie eine udev-Regel, indem Sie einen Link in Ihre Radioconda-Installation erstellen:
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
Stellen Sie dann sicher, dass Ihr Benutzerkonto zur Gruppe plugdev gehört, um auf Ihr Gerät zugreifen zu können:
sudo usermod -a -G plugdev
Möglicherweise müssen Sie neu starten, damit diese Änderung wirksam wird.
Das conda-forge-Paket verwendet libusb, um über USB mit Ihrem LimeSDR-Gerät zu kommunizieren, anstelle der Standard-CyUSB-Bibliothek, die nicht Open Source ist. Wenn Sie Ihr LimeSDR mit einem anderen Softwarepaket verwendet haben, müssen Sie die USB-Treiber auf einen mit WinUSB/libusb kompatiblen umstellen.
Installieren Sie den WinUSB-Treiber mit Zadig und wählen Sie Ihr Lime-Gerät aus.
Installieren Sie eine udev-Regel, indem Sie einen Link in Ihre Radioconda-Installation erstellen:
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
Laden Sie die Firmware-Dateien herunter, indem Sie Ihre Conda-Eingabeaufforderung aktivieren und ausführen
uhd_images_downloader
Sie müssen wahrscheinlich einen USB-Treiber für das Gerät installieren. Befolgen Sie die Anweisungen auf der Ettus-Website oder installieren Sie den WinUSB-Treiber mit Zadig (Ihr Gerät verfügt über eine USB-ID, die mit 2500 oder 3923 beginnt).
Installieren Sie eine udev-Regel, indem Sie einen Link in Ihre Radioconda-Installation erstellen:
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
Installieren Sie den WinUSB-Treiber mit Zadig und wählen Sie Ihr MiriSDR-Gerät aus.
Installieren Sie eine udev-Regel, indem Sie einen Link in Ihre Radioconda-Installation erstellen:
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
Viele USB-Geräte verwenden libusb und erfordern die Installation eines WinUSB-Treibers unter Windows. Befolgen Sie dieses Verfahren, um den Treiber für Ihr Gerät zu installieren:
Laden Sie Zadig herunter und führen Sie es aus
Wählen Sie Ihr Gerät aus
Stellen Sie sicher, dass der Zieltreiber (in der Mitte der Schnittstelle) „WinUSB“ lautet.
Klicken Sie auf „Treiber installieren“ oder „Treiber ersetzen“.
Jedes Installationspaket wird mithilfe des Conda-Konstruktors aus einem Spezifikationsverzeichnis in installer_specs erstellt. Ein Installationsprogramm kann manuell mit dem Skript build_installer.py erstellt werden. Die Spezifikationsverzeichnisse legen die genauen Versionen der enthaltenen Pakete fest, sodass constructor
ein vorhersehbares Ergebnis liefert, das von Git für jede Version verfolgt werden kann. Die Spezifikationsverzeichnisse wiederum werden durch erneutes Rendern der Radioconda-Umgebungsspezifikationsdatei mithilfe des Skripts rerender.py erstellt/aktualisiert.
Das Verfahren zum Erstellen eines neuen Installationspakets ist also:
radioconda.yaml
.rerender.py
ausführen.build_installer.py
ausführen.So veröffentlichen Sie eine neue Version von Radioconda und erstellen Installationspakete mit GitHubs CI:
HINWEIS: Die Verwendung einer Vorabversion ist wichtig, um sicherzustellen, dass die „neuesten“ Links funktionieren.
Apple-Silicon-Builds sind experimentell und wurden im Gegensatz zu den anderen Plattformen nicht getestet. ↩ ↩ 2