bladeRF-cli - En ligne dans le Cloud

PROGRAMME:

Nom

bladeRF-cli - interface de ligne de commande et utilitaire de test

SYNOPSIS

bladeRF-cli

DESCRIPTION

La bladeRF-cli L'utilitaire est utilisé pour flasher les fichiers du micrologiciel, charger les flux binaires FPGA et effectuer
d'autres tâches sur le système radio défini par logiciel nuand bladeRF.

Pour plus d'informations sur l'obtention ou la création de fichiers de firmware et de flux binaires FPGA, veuillez
visite http://nuand.com/.

Interface de ligne de commande bladeRF et utilitaire de test (1.3.1-0.2016.01 ~ rc1-3)

OPTIONS

-d, --dispositif
Utilisez le périphérique bladeRF spécifié.

-f, --flash-micrologiciel
Écrivez le fichier du firmware FX3 fourni sur flash.

-l, --load-fpga
Chargez le flux binaire FPGA fourni.

-L, --flash-fpga
Écrivez l'image FPGA fournie sur flash pour le chargement automatique. Utilisation -L X ou --flash-fpga X
pour désactiver le chargement automatique FPGA.

-p, --sonde
Recherchez les périphériques, imprimez les résultats, puis quittez. Un statut de retour différent de zéro sera
renvoyé si aucun périphérique n'est disponible.

-e, --exec
Exécutez la commande de mode interactif spécifiée. Plusieurs -e les drapeaux peuvent être
spécifié. Les commandes seront exécutées dans l'ordre indiqué.

-s, --scénario
Exécutez le script fourni.

-i, --interactif
Entrez en mode interactif.

--lib-version
Imprimez la version de libbladeRF et quittez.

-v, --verbosité
Définissez le niveau de verbosité de libbladeRF. Les niveaux, répertoriés avec une verbosité croissante, sont :

critique, erreur, avertissement,
info, débogage, verbeux

--version
Imprimez la version CLI et quittez.

-h, --Aidez-moi
Affichez ce texte d'aide.

--help-interactif
Imprimez les informations d'aide pour toutes les commandes interactives.

Notes:
La -d L'option prend une chaîne de spécificateur de périphérique. Voir la documentation bladerf_open()
pour plus d'informations sur le format de cette chaîne.

Si la -d paramètre n'est pas fourni, le premier appareil disponible sera utilisé pour
la commande fournie, ou sera ouvert avant d'entrer en mode interactif.

Les commandes sont exécutées dans l'ordre suivant :

Options de ligne de commande, -e , commandes de script, commandes en mode interactif.

Lors de l'exécution de 'rx/tx start' à partir d'un script ou via -e, assurez-vous que ces commandes sont postérieures
suivi de 'rx/tx wait [timeout]' pour s'assurer que le programme ne tentera pas de quitter
avant la fin de la réception/transmission.

INTERACTIF COMMANDES

bladeRF-cli prend en charge un mode interactif scriptable. Courir bladeRF-cli --interactif à
entrer dans ce mode. Taper "aider" pour une liste de toutes les commandes, ou "aider " pour plus
des informations sur .

étalonner
Utilisation: calibrer [options]

Effectuez l'opération d'étalonnage de l'émetteur-récepteur spécifiée.

Opérations disponibles :

· Étalonnages automatiques du décalage CC interne du LMS

· calibrer lms [afficher]

· calibrer le réglage lms [valeur]

· calibrer lms txlpf [ ]

· calibrer lms rxlpf [ ]

· calibrer lms rxvga2 [ ]

Effectuez l'auto-étalonnage spécifié, ou tous si aucun n'est fourni. Lorsque
des valeurs sont fournies, elles sont utilisées à la place des résultats de l'auto-étalonnage
procédure. Utilisez lms show pour lire et imprimer les valeurs d'étalonnage LMS actuelles.

Pour rxvga2, I1 et Q1 sont les composants I et Q de l'étape 1 respectivement, et I2 et Q2 sont
les composants Stage 2 I et Q.

· Calibrage des paramètres de correction de décalage CC RX et TX I/Q

· calibrer le courant continu [ ]

· calibrer le courant continu

Calibrer les paramètres de correction de décalage CC pour la fréquence et le gain actuels
Les paramètres. Si des valeurs I/Q sont fournies, elles sont appliquées directement. cal rxtx est
raccourci pour cal rx suivi de cal tx.

· Calibrage des paramètres de correction d'équilibre RX et TX I/Q

· calibrer iq

Définissez les paramètres de gain IQ ou d'équilibre de phase spécifiés.

· Générer des tableaux de paramètres de correction RX ou TX I/Q DC

· calibrer la table dc [ [f_inc]]

Générer et écrire une table de paramètres de correction I/Q dans le répertoire de travail courant,
dans un fichier nommé _dc_ .tbl. f_min et f_max sont les fréquences min et max à
inclure dans le tableau. f_inc est l'incrément de fréquence.

Par défaut, les tableaux sont générés sur toute la gamme de fréquences, par pas de 2 MHz.

clair
Utilisation : clair

Efface l'écran.

echo
Utilisation : echo [arg 1] [arg 2] ... [arg n]

Faites écho à chaque argument sur une nouvelle ligne.

effacer
Utilisation : effacer

Effacer les blocs d'effacement spécifiés SPI flash.

· - Effacer le décalage de bloc

· - Nombre de blocs d'effacement à effacer

flash_backup
Utilisation : flash_backup ( | )

Sauvegardez les données flash dans le fichier spécifié. Cette commande prend deux ou quatre
arguments. L'invocation à deux arguments est généralement recommandée pour une utilisation non liée au développement.

Paramètres:

· - Type de sauvegarde.

Cela sélectionne les valeurs d'adresse et de longueur appropriées en fonction du type sélectionné.

Les options valides sont :

Description des options
?? ??
cal Données d'étalonnage
micrologiciel fw
fpga40 Métadonnées et flux binaire pour FPGA 40 kLE
fpga115 Métadonnées et flux binaire pour FPGA 115 kLE

· - Adresse des données à sauvegarder. Doit être aligné sur les blocs d'effacement.

· - Longueur de la région à sauvegarder. Doit être aligné sur les blocs d'effacement.

Remarque : lorsqu'une adresse et une longueur sont fournies, le type d'image sera par défaut brut.

Exemples :

· flash_backup cal.bin cal

Sauvegarde la région des données d'étalonnage.

· flash_backup cal_raw.bin 0x30000 0x10000

Sauvegarde la région d'étalonnage en tant qu'image de données brutes.

image_flash
Utilisation : flash_image [options de sortie]

Imprimez les métadonnées d'une image flash ou créez une nouvelle image flash. Lorsqu'il est fourni avec le nom
d'un fichier image flash comme seul argument, cette commande imprimera le contenu des métadonnées
de l'image.

Les options suivantes peuvent être utilisées pour créer une nouvelle image flash.

· données=

Fichier contenant les données à stocker dans l'image.

· adresse=

Adresse flash. La valeur par défaut dépend du paramètre de type.

· tapez=

Type d'image flash. La valeur par défaut est brute.

Les options valides sont :

Description des options
?? ??
cal Données d'étalonnage
micrologiciel fw
fpga40 Métadonnées et flux binaire pour FPGA 40 kLE
fpga115 Métadonnées et flux binaire pour FPGA 115 kLE
données brutes brutes. Les paramètres d'adresse et de longueur doivent être
fourni si ce type est sélectionné.

· série=

# de série à stocker dans l'image. Les valeurs par défaut sont des zéros.

flash_init_cal
Utilisation : flash_init_cal [ ]

Créez et écrivez une nouvelle région de données d'étalonnage sur l'appareil actuellement ouvert ou sur un
déposer. Assurez-vous de sauvegarder les données d'étalonnage avant d'exécuter cette commande. (Voir le
commande flash_backup.)

·

Soit 40 ou 115, selon le modèle d'appareil.

·

Valeur d'ajustement VCTCXO/DAC (0x0-0xffff)

·

Fichier dans lequel écrire les données d'étalonnage. Lorsque cet argument est fourni, aucune donnée ne sera
écrit dans la mémoire flash de l'appareil.

flash_restaurer
Utilisation : flash_restore [ ]

Restaurez les données flash à partir d'un fichier, en remplaçant éventuellement les valeurs des métadonnées de l'image.

·

La valeur par défaut est l'adresse spécifiée dans le fichier d'image flash fourni.

·

La valeur par défaut est la longueur des données dans le fichier image fourni.

fw_log
Utilisation : fw_log [nom de fichier]

Lisez le contenu du journal du micrologiciel de l'appareil et écrivez-le dans le fichier spécifié. Sinon
nom de fichier est spécifié, le contenu du journal est écrit sur stdout.

aider
Utilisation : aide [ ]

Fournit une aide étendue, comme celle-ci, sur n'importe quelle commande.

info
Utilisation : informations

Imprime les informations suivantes sur un périphérique ouvert :

· Numéro de série

· Valeur d'étalonnage VCTCXO DAC

· Taille FPGA

· Si le FPGA est chargé ou non

· Bus USB, adresse et vitesse

· Backend (indique quel code d'interface de périphérique est utilisé.)

· Numéro d'instance

sauter_to_boot
Utilisation : jump_to_boot

Effacez un mot de signature FW en flash et passez au chargeur de démarrage FX3.

L'appareil continuera à démarrer dans le chargeur de démarrage FX3 à travers les cycles d'alimentation jusqu'à ce que le nouveau
firmware est écrit sur l'appareil.

charge
Utilisation : charge

Chargez un train de bits FPGA ou programmez le flash SPI du FX3.

xb
Utilisation : xb [paramètres]

Activer ou configurer une carte d'extension.

Valeurs valides pour board_model :

· 100

Carte d'extension GPIO XB-100

· 200

Carte d'extension de convertisseur XB-200 LF/MF/HF/VHF

Sous-commandes courantes :

· permettre

Activez la carte d'extension XB-100 ou XB-200.

Sous-commandes XB-200 :

· filtrer [rx|tx] [50|144|222|custom|auto_1db|auto_3db]

Sélectionne le filtre RX ou TX spécifié sur la carte XB-200. Vous trouverez ci-dessous des descriptions de
chacune des options de filtre.

· 50

Sélectionnez le filtre 50-54 MHz (bande de 6 mètres).

· 144

Sélectionnez le filtre 144-148 MHz (bande de 2 mètres).

· 222

Sélectionnez le filtre 222-225 MHz (bande de 1.25 mètre). De façon réaliste,
cette option de filtre est en fait légèrement plus large, couvrant
206MHz - 235MHz.

· Douane

Sélectionne le chemin du filtre personnalisé. L'utilisateur doit connecter un filtre
le long des connexions FILT et FILT-ANT correspondantes lors de l'utilisation
cette option. Alternativement, on peut cavalier le FILT et FILT-ANT
connexions pour réaliser "aucun filtre" pour la réception. (Cependant, c'est
_fortement_ déconseillé pour les transmissions.)

· auto_1db

Sélectionne automatiquement l'un des choix ci-dessus en fonction de la fréquence
et les points 1dB des filtres. Le chemin personnalisé est utilisé pour les cas
qui ne sont pas associés aux filtres embarqués.

· auto_3db

Sélectionne automatiquement l'un des choix ci-dessus en fonction de la fréquence
et les points 3dB des filtres. Le chemin personnalisé est utilisé pour les cas
qui ne sont pas associés aux filtres embarqués.

Exemples :

· xb 200 activer

Active et configure la carte d'extension du convertisseur XB-200.

· xb 200 filtre rx 144

Sélectionne le filtre de réception 144-148 MHz sur la carte d'extension du convertisseur XB-200.

mimo
Utilisation : mimo [maître | trimer]

Modifier le fonctionnement MIMO de l'appareil.

ouvert
Utilisation : ouvrir [identifiants de l'appareil]

Ouvrez le périphérique spécifié pour une utilisation avec des commandes successives. Tout appareil précédemment ouvert
sera fermé.

La forme générale de la chaîne d'identifiant de périphérique est :

:[appareil= : ] [instance= ] [série= ]

Voir la documentation bladerf_open() dans libbladeRF pour le spécificateur de périphérique complet
le format.

coup d'oeil
Utilisation: coup d'oeil [nombre_adresses]

La commande peek peut lire n'importe quel périphérique suspendu au FPGA qui inclut le
L'émetteur-récepteur LMS6002D, le DAC trim VCTCXO ou la puce du générateur d'horloge Si5338.

Si num_addresses est fourni, l'adresse est incrémentée de 1 et un autre coup d'œil est
effectué pour autant d'adresses.

Plages d'adresses valides :

Plage d'adresses de périphérique
??
dac 0 à 255

lms 0 à 127
si 0 à 255

Mise en situation :

· coup d'oeil si ...

tisonner
Utilisation: pousser

La commande poke peut écrire n'importe quel périphérique suspendu au FPGA qui inclut le
L'émetteur-récepteur LMS6002D, le DAC trim VCTCXO ou la puce du générateur d'horloge Si5338.

Plages d'adresses valides :

Plage d'adresses de périphérique
??
dac 0 à 255
lms 0 à 127
si 0 à 255

Mise en situation :

· piquer des lms...

impression
Utilisation : print [paramètre]

La commande print prend un paramètre à imprimer. Les paramètres disponibles sont répertoriés ci-dessous. Si
aucun paramètre n'est spécifié, tous les paramètres sont imprimés.

Paramètre Description
?? ??
Bande passante Paramètres de bande passante
fréquence Paramètres de fréquence
gpio FX3 <-> état GPIO FPGA
Paramètres de bouclage
lnagain Réglage du gain du RX LNA, en dB
rx_mux FPGA RX FIFO paramètre mux d'entrée
rxvga1 Réglage du gain de RXVGA1, en dB
rxvga2 Réglage du gain de RXVGA2, en dB
txvga1 Réglage du gain de TXVGA1, en dB
txvga2 Réglage du gain de TXVGA2, en dB
échantillonnage Mode d'échantillonnage externe ou interne
taux d'échantillonnage paramètres de taux d'échantillonnage
paramètres trimdac VCTCXO Trim DAC
vctcxo_tamer Mode dompteur VCTCXO actuel.
xb_gpio Valeurs GPIO de la carte d'extension
xb_gpio_dir Direction GPIO de la carte d'extension (1=sortie, 0=entrée)

sonde
Utilisation : sonde [strict]

Recherchez le périphérique bladeRF connecté et imprimez une liste de résultats.

Sans spécifier strict, l'absence de périphériques disponibles n'est pas considérée comme une erreur.

Lorsqu'elle est fournie avec l'argument strict facultatif, cette commande traitera la situation où aucun
les périphériques sont détectés comme une erreur, provoquant des scripts ou des listes de commandes fournies via le -e
argument de ligne de commande pour terminer immédiatement.

quitter
Utilisation : quitter

Quittez l'interface de ligne de commande.

récupérer
Utilisation : récupérer [ ]

Chargez le micrologiciel sur un appareil fonctionnant en mode bootloader ou répertoriez tous les appareils actuellement en
mode chargeur de démarrage.

Sans arguments, cette commande répertorie le bus USB et l'adresse des périphériques basés sur FX3.
fonctionnant en mode bootloader.

Lorsqu'un bus, une adresse et un chemin d'accès à un fichier de micrologiciel sont fournis, le périphérique spécifié sera
chargé avec et commencer à exécuter le firmware fourni.

Dans la plupart des cas, après avoir chargé avec succès le firmware dans la RAM de l'appareil, les utilisateurs doivent
ouvrez l'appareil avec la commande "open", et écrivez le firmware pour flasher via
"charger fx3 "

courir
Utilisation : courir

Exécutez le script fourni.

rx
Utilisation : rx

Recevez des échantillons IQ et écrivez-les dans le fichier spécifié. La réception est contrôlée et
configuré par l'un des éléments suivants :

Description de la commande
?? ??
commencer Commencer à recevoir des échantillons
stop Ne plus recevoir d'échantillons
wait Attendez la fin de la transmission de l'échantillon ou jusqu'à ce qu'un
un laps de temps spécifié s'écoule
config Configurer la réception des échantillons. Si aucun paramètre n'est
fourni, les paramètres courants sont imprimés.

L'exécution de rx sans aucune commande supplémentaire est un raccourci valide pour la configuration de rx.

La commande wait prend un paramètre de délai d'attente facultatif. Ce paramètre prend par défaut les unités de
millisecondes (ms). L'unité de temporisation peut être spécifiée à l'aide des suffixes ms ou s. Si ce
paramètre n'est pas fourni, la commande attendra la fin de la réception ou Ctrl-C
est pressé.

Les paramètres de configuration prennent la forme param=valeur et peuvent être spécifiés dans un seul ou
plusieurs appels de configuration rx. Vous trouverez ci-dessous une liste des paramètres disponibles.

Paramètre Description
?? ??
n Nombre d'échantillons à recevoir. 0 = inf.
file Nom du fichier dans lequel écrire les échantillons reçus
format Format du fichier de sortie. L'un des éléments suivants :
csv : CSV des échantillons SC16 Q11
bin : échantillons bruts du DAC SC16 Q11
échantillons Nombre d'échantillons par tampon à utiliser dans le
flux asynchrone. Doit être divisible par 1024 et
>= 1024.
buffers Nombre de tampons d'échantillons à utiliser dans le
flux. La valeur minimale est 4.
xfers Nombre de transferts simultanés pour permettre la
flux asynchrone à utiliser. Cela devrait être moins
que le paramètre buffers.
timeout Délai d'expiration du flux de données. Sans suffixe, la valeur par défaut
l'unité est ms. La valeur par défaut est de 1000 ms (1 s).
Les suffixes valides sont ms et s.

Mise en situation :

· fichier de configuration rx=/tmp/data.bin format=bin n=10K

Recevoir (10240 = 10 * 1024) échantillons, en les écrivant dans /tmp/data.bin dans le DAC binaire
le format.

Notes:

· Les paramètres n, samples, buffers et xfers prennent en charge les suffixes K, M et G, qui
sont des multiples de 1024.

· Un rx stop suivi d'un rx start entraînera la troncature du fichier d'échantillons. Si
ce n'est pas souhaité, assurez-vous d'exécuter rx config pour définir un autre fichier avant de redémarrer le
flux rx.

· Pour des taux d'échantillonnage plus élevés, il est conseillé d'utiliser le format de sortie binaire et le
fichier de sortie soit écrit dans la RAM (par exemple / Tmp, / dev / shm), si l'espace le permet. Pour les plus grands
captures à des taux d'échantillonnage plus élevés, envisagez d'utiliser un SSD au lieu d'un disque dur.

tx
Utilisation : tx

Lisez les échantillons IQ à partir du fichier spécifié et transmettez-les. La transmission est contrôlée et
configuré par l'un des éléments suivants :

Description de la commande
?? ??
start Commencer à transmettre des échantillons
stop Arrêter la transmission des échantillons
wait Attendez la fin de la transmission de l'échantillon ou jusqu'à ce qu'un
un laps de temps spécifié s'écoule
config Configurez la transmission de l'échantillon. Si aucun paramètre n'est
fourni, les paramètres courants sont imprimés.

L'exécution de tx sans aucune commande supplémentaire est un raccourci valide pour tx config.

La commande wait prend un paramètre de délai d'attente facultatif. Ce paramètre prend par défaut les unités de
millisecondes (ms). L'unité de temporisation peut être spécifiée à l'aide des suffixes ms ou s. Si ce
paramètre n'est pas fourni, la commande attendra la fin de la transmission ou
Ctrl-C est enfoncé.

Les paramètres de configuration prennent la forme param=valeur et peuvent être spécifiés dans un seul ou
plusieurs appels de configuration tx. Vous trouverez ci-dessous une liste des paramètres disponibles.

Paramètre Description
?? ??
fichier Nom du fichier à partir duquel lire les échantillons
format Format du fichier d'entrée. L'un des éléments suivants :
csv : CSV des échantillons SC16 Q11 ([-2048, 2047])
bin : échantillons bruts du DAC SC16 Q11 ([-2048, 2047])
répéter Le nombre de fois que le contenu du fichier doit être
transmis. 0 implique la répétition jusqu'à l'arrêt.
delay Le nombre de microsecondes à retarder entre
retransmettre le contenu du fichier. 0 n'implique aucun délai.
échantillons Nombre d'échantillons par tampon à utiliser dans le
flux asynchrone. Doit être divisible par 1024 et
>= 1024.
buffers Nombre de tampons d'échantillons à utiliser dans le
flux. La valeur minimale est 4.
xfers Nombre de transferts simultanés pour permettre la
flux asynchrone à utiliser. Cela devrait être < le
paramètre buffers.
timeout Délai d'expiration du flux de données. Sans suffixe, la valeur par défaut
l'unité est ms. La valeur par défaut est de 1000 ms (1 s).
Les suffixes valides sont « ms » et « s ».

Mise en situation :

· tx config file=format data.bin=bin repeat=2 delay=250000

Transmettre le contenu de data.bin deux fois, avec un délai d'environ 250 ms entre
transmissions.

Notes:

· Les paramètres n, samples, buffers et xfers prennent en charge les suffixes K, M et G, qui
sont des multiples de 1024.

· Pour des fréquences d'échantillonnage plus élevées, il est conseillé de stocker le fichier d'entrée dans la RAM (par ex. / Tmp,
/ dev / shm) ou sur un SSD, plutôt que sur un disque dur.

· Lors de la fourniture de données CSV, cette commande les convertira d'abord en un format binaire, stocké
dans un fichier du répertoire de travail courant. Au cours de ce processus, les valeurs hors limites
sera serré.

· Lors de l'utilisation d'un format binaire, l'utilisateur est responsable de s'assurer que les données fournies
les valeurs sont dans la plage autorisée. Cette condition préalable atténue la nécessité de cette
programme pour effectuer des vérifications de plage dans les rappels sensibles au temps.

set
Utilisation: ensemble

La commande set prend un paramètre et un nombre arbitraire d'arguments pour ce
paramètre. Le paramètre est l'un des suivants :

Paramètre Description
?? ??
Bande passante Paramètres de bande passante
fréquence Paramètres de fréquence
gpio FX3 <-> état GPIO FPGA
loopback Paramètres de bouclage. Exécutez 'set loopback' pour lister les modes.
lnagain Réglage du gain du RX LNA, en dB. Valeurs : 0, 3, 6
rxvga1 Réglage du gain de RXVGA1, en dB. Plage : [5, 30]
rx_mux Mode mux d'entrée FPGA RX FIFO. Les options sont :
BASEBAND_LMS, 12BIT_COUNTER, 32BIT_COUNTER,
DIGITAL_LOOPBACK
rxvga1 Réglage du gain de RXVGA1, en dB. Plage : [5, 30]
rxvga2 Réglage du gain de RXVGA2, en dB. Plage : [0, 30]
txvga1 Réglage du gain de TXVGA1, en dB. Plage : [-35, -4]
txvga2 Réglage du gain de TXVGA2, en dB. Plage : [0, 25]
échantillonnage Mode d'échantillonnage externe ou interne
taux d'échantillonnage Paramètres de taux d'échantillonnage
trimdac VCTCXO trim paramètres du DAC
vctcxo_tamer Mode dompteur VCTCXO. Options : désactivé, 1PPS, 10MHz
xb_gpio Valeurs GPIO de la carte d'extension
xb_gpio_dir Direction GPIO de la carte d'extension (1=sortie, 0=entrée)

version
Utilisation : version

Imprime les informations de version pour le logiciel hôte et le périphérique actuel.

EXEMPLES

$ bladeRF-cli -l hébergéx40.rbf

Charge une image FPGA nommée hostx40.rbf sur le FPGA du bladeRF.

Notes: L'image FPGA chargée avec --load-fpga sera perdue à la mise hors tension.

$ bladeRF-cli -f firmware.img

Clignote firmware.img sur le firmware du bladeRF.

$ bladeRF-cli -L hébergéx40.rbf

Flashe l'image FPGA nommée hostx40.rbf sur le bladeRF, où elle sera
automatiquement chargé à la mise sous tension.

Utilisez bladeRF-cli en ligne à l'aide des services onworks.net