bladeRF-fsk - manuel de référence, options, exemples de commandes


NOM

bladeRF-fsk - application fsk en ligne de commande

DESCRIPTION

Le projet bladeRF-fsk est un simple modem logiciel basé sur la modulation par déplacement de fréquence (FSK) implémenté entièrement côté PC hôte en code C. Le projet utilise libbladeRF pour transmettre/recevoir des échantillons avec un appareil bladeRF. Un port USB 3.0 n'est pas nécessaire lors de l'utilisation de ce modem. Le projet contient également une simulation/implémentation MATLAB/Octave de la partie couche physique (PHY) du modem.

Le programme C bladeRF-fsk de niveau supérieur démontre la fonctionnalité du modem dans un simple programme de transfert de données bladeRF à bladeRF. Ce programme peut transmettre/recevoir à la fois du texte (comme un programme de chat) et des fichiers binaires (comme un programme de transfert de fichiers) avec un taux de liaison brut de 250 kbps. Pour démontrer correctement le programme, deux instances du programme doivent être exécutées avec deux périphériques bladeRF distincts (le bouclage n'est pas pris en charge).

Le modem module avec une modulation par déplacement de fréquence en phase continue (CPFSK). Les échantillons CPFSK I/Q en bande de base sont envoyés au dispositif bladeRF, à l'intérieur duquel ils sont convertis du numérique à l'analogique, mélangés avec des porteuses RF en quadrature et transmis dans les airs. Les signaux reçus sont mélangés avec des porteuses RF en quadrature pour les convertir en bande de base I/Q, échantillonnés avec un ADC et envoyés au programme PC hôte via la connexion USB.

Le code de couche physique comprend un filtre passe-bas FIR, une normalisation de puissance, une corrélation de préambule pour la détection de signal, une modulation/démodulation CPFSK et un brouillage. Le code de la couche de liaison comprend le cadrage, la détection d'erreurs via des sommes de contrôle CRC32 et la livraison garantie des trames via des accusés de réception et des retransmissions.

Ce projet se veut un exemple expérimental et ne doit pas être traité comme un modem rigoureux.

EXEMPLES

Pour exécuter le programme bladeRF-fsk de niveau supérieur avec les valeurs par défaut, saisissez dans un terminal :

bladeRF-fsk

Pour voir une liste des options de configuration et comment les définir, tapez :

bladeRF-fsk -h

_REMARQUE_ : sous Windows 10, si vous exécutez deux instances du programme sur le même PC, vous devez spécifier le numéro de série bladeRF avec l'option '-d', en raison du [Problème #484](https://github.com /Nuand/bladeRF/issues/484). Exemple:

bladeRF-fsk -d *:serial=4e

Par défaut, le programme utilise le premier périphérique bladeRF disponible, obtient l'entrée TX de stdin, écrit la sortie RX sur stdout et utilise un ensemble par défaut de fréquences et de gains d'émission/réception. Les gains peuvent devoir être ajustés pour une bonne connexion avec un autre bladeRF exécutant bladeRF-fsk. Pour transférer des fichiers, utilisez les options '-i' et '-o'. Si vous utilisez stdin pour les données tx, le programme transmettra les données ligne par ligne.

Le programme s'exécute jusqu'à ce qu'il obtienne un EOF dans son entrée TX.

### Exemple : Transfert de fichiers ### 1) Assurez-vous que deux appareils bladeRF sont connectés à votre PC (ou à deux PC distincts) avec les antennes TX et RX connectées.

2) Exécutez bladeRF-fsk sur l'un des périphériques (récepteur), avec le fichier RX de sortie spécifié :

bladeRF-fsk -r 904M -t 924M -o rx.jpg

3) Exécutez bladeRF-fsk sur l'autre appareil (expéditeur), avec des fréquences opposées et le fichier TX d'entrée spécifié :

bladeRF-fsk -r 924M -t 904M -i puppy.jpg

4) Le fichier commencera à être transféré et la progression sera imprimée dans le terminal de l'appareil d'envoi.

5) Une fois la transmission terminée, appuyez sur [CTRL-D] sous Linux/OSX ou [CTRL-Z puis ENTER] sous Windows pour arrêter le programme du côté récepteur.

Si l'appareil émetteur n'obtient aucune réponse de l'appareil récepteur, il quittera le programme. Essayez d'augmenter les gains et relancez-le.

LIMITES CONNUES

1) Le programme ne prend pas actuellement en charge l'utilisation d'une carte d'extension transverter XB-200 pour transmettre/recevoir à des fréquences inférieures à 300 MHz. Afin d'ajouter le support XB-200, une nouvelle option de configuration ainsi que des fonctions de la section "Cartes d'extension" de l'API libbladeRF devraient être ajoutées au code source.

2) Le programme est actuellement incapable d'effectuer simultanément deux transferts de fichiers dans les deux sens. Raison n ° 1: le programme s'exécute jusqu'à ce qu'il obtienne un EOF dans son entrée TX, ce qui signifie que le côté qui finit de transmettre son fichier en premier quittera et cessera de recevoir. Un bit EOF devrait être ajouté au format de paquet de couche liaison afin d'arrêter ce comportement. Raison #2 : Le programme ne semble pas fonctionner correctement lors de ces transferts de fichiers simultanés et perd généralement la connexion. Une enquête plus approfondie est nécessaire pour déboguer cela.

Voir également

lameRF-cli(1)