radio-condé
2024.05.29
Ce référentiel contient des installateurs multiplateformes pour une collection de packages radio de logiciels open source fournis avec le gestionnaire de packages conda, notamment
et prise en charge des appareils SDR et bibliothèques d'appareils suivants :
| Appareil | Bibliothèque |
|---|---|
| ADALM-PLUTON | libiio (configuration) |
| Airspy R2/Mini/HF+ | airspy/airspyhf (configuration) |
| LameRF | bladeRF (configuration) |
| USRP Ettus | UHD (configuration) |
| HackRF | HackRF (configuration) |
| ChauxSDR | Suite Lime (configuration) |
| Appareils Mirics MSi001 + MSi2500 SDR | libmirisdr (installation) |
| Pitaya rouge | SavonnantRougePitaya |
| RFSpace/NetSDR/CloudSDR | SoapyNetSDR |
| RTL-SDR | rtl-sdr (configuration) |
| Carte son/périphériques audio | SoapyAudio |
La liste complète des packages peut être trouvée ici. Vous pouvez suggérer des logiciels supplémentaires à inclure en signalant un problème. Si vous avez créé un logiciel supplémentaire à partir des sources au-dessus de radioconda, documentez vos résultats dans un problème pour aider les autres (et aidez-moi à le conditionner !).
Une fois installé, vous disposerez d'une distribution/environnement conda entièrement fonctionnel, ce qui signifie que vous pourrez utiliser les commandes conda ou mamba pour installer des packages supplémentaires (si disponibles via conda-forge) ou mettre à niveau vers les dernières versions. Considérez radioconda comme une alternative à Anaconda ou Miniforge, mais spécialisée dans la radio logicielle.
REMARQUE : Radioconda est construit à partir de packages maintenus par le projet conda-forge. Si vous avez des questions ou des problèmes spécifiques à l'installation conda d'un package particulier, veuillez les signaler au référentiel de matières premières correspondant.
Les installateurs de Radioconda sont disponibles ici : https://github.com/ryanvolz/radioconda/releases.
| Système d'exploitation | Architecture | Type d'installateur | Télécharger |
|---|---|---|---|
| Linux | x86_64 (amd64) | Ligne de commande | radioconda-Linux-x86_64.sh |
| Linux | aarch64 (bras64) | Ligne de commande | radioconda-Linux-aarch64.sh |
| Linux | ppc64le (PUISSANCE8/9) | Ligne de commande | radioconda-Linux-ppc64le.sh |
| macOS | x86_64 (Intel) | Ligne de commande | radioconda-MacOSX-x86_64.sh |
| macOS | x86_64 (Intel) | Graphique | radioconda-MacOSX-x86_64.pkg |
| macOS | arm64 (Apple Silicium) 1 | Ligne de commande | radioconda-MacOSX-arm64.sh |
| macOS | arm64 (Apple Silicium) 1 | Graphique | radioconda-MacOSX-arm64.pkg |
| Fenêtres | x86_64 (amd64) | Graphique | radioconda-Windows-x86_64.exe |
Pour une installation en ligne de commande, téléchargez le programme d'installation et exécutez :
bash radioconda-*-Linux-x86_64.sh # or similar for other installers for unix platforms
Pour une installation graphique, téléchargez le programme d'installation et double-cliquez dessus.
Si vous disposez déjà de conda/mamba, vous pouvez ignorer le programme d'installation et créer un nouvel environnement avec tous les packages radioconda en exécutant :
conda create -n radioconda -c conda-forge -c ryanvolz --only-deps radioconda
Voir ci-dessous pour les étapes d'installation supplémentaires pour des périphériques radio logiciels particuliers.
Pour une utilisation non interactive, examinez les options en exécutant ce qui suit :
bash radioconda-*-Linux-x86_64.sh -h # or similar for other installers for unix platforms
ou si vous êtes sous Windows, exécutez :
start /wait "" build/radioconda--Windows-x86_64.exe /InstallationType=JustMe /RegisterPython=0 /S /D=%UserProfile%radioconda
Vous utiliserez principalement radioconda via la ligne de commande, bien que sous Windows, certaines applications installeront des raccourcis vers le menu Démarrer.
Lancez "radioconda Prompt" depuis le menu Démarrer (vous pouvez le trouver dans le répertoire "radioconda"). À partir de cette ligne de commande, vous pouvez exécuter mamba pour installer/mettre à niveau des packages ou exécuter l'une des applications installées avec radioconda. Certaines applications peuvent également être lancées via des raccourcis ajoutés au menu Démarrer.
Lancez votre terminal préféré. Selon les options que vous avez choisies lors de l'installation, l'environnement "base" de radioconda peut ou non être activé automatiquement (vous verrez "(base)" sur votre invite de ligne de commande). Pour activer autrement l'environnement "de base" de radioconda, exécutez :
conda activate base
Si cela échoue parce que la commande conda est introuvable, vous pouvez activer l'environnement manuellement en exécutant
sh /bin/activate
À partir d'un environnement activé, vous pourrez exécuter mamba pour installer/mettre à niveau des packages ou exécuter n'importe laquelle des applications installées avec radioconda.
Pour installer un package particulier :
mamba install
Une fois radioconda installé, vous pouvez rester à jour pour tous les packages avec :
mamba upgrade --all
Pour installer la dernière version en particulier, exécutez
(sous Windows) :
mamba install --file https://github.com/ryanvolz/radioconda/releases/latest/download/radioconda-win-64.lock
(sous Linux/macOS) :
mamba install --file https://github.com/ryanvolz/radioconda/releases/latest/download/radioconda-$(conda info | sed -n -e 's/^.*platform : //p').lock
Pour installer une version particulière, remplacez le numéro de version souhaité et exécutez
(sous Windows) :
mamba install --file https://github.com/ryanvolz/radioconda/releases/download/20NN.NN.NN/radioconda-win-64.lock
(sous 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
Si vous démarrez avec un nouvel environnement ou si vous êtes à l'aise avec les conflits de packages, vous pouvez installer la dernière version à l'aide du métapaquet radioconda du canal ryanvolz :
mamba install -c conda-forge -c ryanvolz --only-deps radioconda
(Il faut d'abord préciser le canal conda-forge , même s'il s'agit de votre canal par défaut, afin que le canal ryanvolz ne soit pas prioritaire.)
Pour installer une version particulière, remplacez le numéro de version souhaité et exécutez
mamba install -c conda-forge -c ryanvolz --only-deps radioconda=20NN.NN.NN
Pour utiliser des périphériques radio logiciels particuliers, il peut être nécessaire d'installer des pilotes ou un micrologiciel supplémentaires. Trouvez votre appareil ci-dessous et suivez les instructions. (Aidez à compléter cette section en signalant un problème si les instructions ne fonctionnent pas ou si vous avez des instructions supplémentaires à ajouter !)
Installez le pilote WinUSB avec Zadig, en sélectionnant le périphérique appelé "Bulk-In, Interface (Interface 0)".
Mettez sur liste noire les modules DVB-T qui autrement réclameraient l'appareil :
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')
Installez une règle udev en créant un lien dans votre installation radioconda :
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
Installez les derniers pilotes USB en téléchargeant et en installant ce fichier.
Installez une règle udev en créant un lien dans votre installation radioconda :
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
Une fois que vous pouvez parler au matériel (en suivant les instructions ci-dessous), vous souhaiterez peut-être effectuer les étapes de post-installation détaillées sur le wiki des utilisateurs de Pluto.
Le pilote WinUSB de votre appareil sera probablement installé automatiquement et dans ce cas, aucune configuration supplémentaire n'est nécessaire. Si pour une raison quelconque le pilote n'est pas installé et que le périphérique n'est pas reconnu, installez le pilote WinUSB avec Zadig, en sélectionnant votre périphérique Airspy.
Installez une règle udev en créant un lien dans votre installation radioconda :
# 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
Ensuite, assurez-vous que votre compte utilisateur appartient au groupe plugdev afin de pouvoir accéder à votre appareil :
sudo usermod -a -G plugdev
Vous devrez peut-être redémarrer pour que cette modification prenne effet.
Installez le pilote WinUSB avec Zadig, en sélectionnant votre périphérique HackRF.
Installez une règle udev en créant un lien dans votre installation radioconda :
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
Ensuite, assurez-vous que votre compte utilisateur appartient au groupe plugdev afin de pouvoir accéder à votre appareil :
sudo usermod -a -G plugdev
Vous devrez peut-être redémarrer pour que cette modification prenne effet.
Installez le pilote WinUSB avec Zadig, en sélectionnant votre appareil BladeRF.
Installez une règle udev en créant un lien dans votre installation radioconda :
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
Ensuite, assurez-vous que votre compte utilisateur appartient au groupe plugdev afin de pouvoir accéder à votre appareil :
sudo usermod -a -G plugdev
Vous devrez peut-être redémarrer pour que cette modification prenne effet.
Le package conda-forge utilise libusb pour communiquer via USB avec votre appareil LimeSDR, au lieu de la bibliothèque CyUSB standard qui n'est pas open source. Si vous avez utilisé votre LimeSDR avec un autre logiciel, vous devrez remplacer les pilotes USB par un pilote compatible avec WinUSB/libusb.
Installez le pilote WinUSB avec Zadig, en sélectionnant votre appareil Lime.
Installez une règle udev en créant un lien dans votre installation radioconda :
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
Téléchargez les fichiers du firmware en activant votre invite conda et en exécutant
uhd_images_downloader
Vous devrez probablement installer un pilote USB pour l'appareil. Suivez les instructions du site Ettus, ou installez le pilote WinUSB avec Zadig (votre appareil aura un identifiant USB qui commence par 2500 ou 3923).
Installez une règle udev en créant un lien dans votre installation radioconda :
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
Installez le pilote WinUSB avec Zadig, en sélectionnant votre périphérique MiriSDR.
Installez une règle udev en créant un lien dans votre installation radioconda :
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
De nombreux périphériques USB utilisent libusb et nécessitent un pilote WinUSB installé sous Windows. Suivez cette procédure pour installer le pilote de votre appareil :
Téléchargez et exécutez Zadig
Sélectionnez votre appareil
Assurez-vous que le pilote cible (au milieu de l'interface) lit "WinUSB"
Cliquez sur "Installer le pilote" ou "Remplacer le pilote"
Chaque package d'installation est construit à partir d'un répertoire de spécifications dans installer_specs à l'aide du constructeur conda. Un programme d'installation peut être créé manuellement à l'aide du script build_installer.py. Les répertoires de spécifications définissent les versions exactes des packages inclus afin que constructor produise un résultat prévisible qui puisse être suivi par git pour chaque version. À leur tour, les répertoires de spécifications sont créés/mis à jour en rendant à nouveau le fichier de spécification de l'environnement radioconda à l'aide du script rerender.py.
Ainsi, la procédure pour créer un nouveau package d’installation est la suivante :
radioconda.yaml , si vous le souhaitez.rerender.py .build_installer.py .Pour publier une nouvelle version de radioconda et créer des packages d'installation à l'aide du CI de GitHub :
REMARQUE : il est important d'utiliser une version préliminaire pour s'assurer que les "derniers" liens fonctionnent.
Les versions de silicium Apple sont expérimentales et n'ont pas été testées comme les autres plates-formes. ↩ ↩ 2
