bladerf-cli(1)

NAME
bladerf-cli - bladeRF command line interface and test utility

SYNPOSIS

bladeRF-cli [options]

DESCRIPTION

The bladeRF-cli utility is used to flash firmware files, load FPGA bitstreams, and perform other tasks on the Nuand bladeRF software-defined radio system.

For more information on obtaining or building firmware files and FPGA bitstreams, please visit http://nuand.com/.

OPTIONS

The program follows the usual GNU command line syntax, with long options starting with two dashes (--).

-d, --device <device>
    Use the specified bladeRF device.

Note:
    The -d option takes a device specifier string. See the bladerf_open() documentation for more information about the format of this string. If the -d parameter is not provided, the first available device will be used for the provided command, or will be opened prior to entering interactive mode.

-f, --flash-firmware <file>
    Flash specified firmware file.

-l, --load-fpga <file>
    Load specified FPGA bitstream.

-p, --probe
    Probe for devices, print results, then exit.

-s, --script <file>
    Run provided script.

-i, --interactive
    Enter interactive mode.

-L, --lib-version
    Print libbladeRF version and exit.

-v, --verbosity <level>
    Set the libbladeRF verbosity level. Levels, listed in increasing verbosity, are: critical, error, warning, info, debug, verbose

-V, --version
    Print CLI version and exit.

-h, --help
    Show this help text.

MODE COMMANDS

The following commands are available when interactive mode is enabled by the -i or --interactive command line options.

calibrate
    Calibrate transceiver

rx <start | stop | config [param=val [param=val [...]]>
    Receive IQ samples

tx <start | stop | config [parameters]>
    Transmit IQ samples

set <param> <arguments>
    Set device settings. The set command takes a parameter and an arbitrary number of arguments for that particular command.

         aram bandwidth       Bandwidth settings
         aram config          Overview of everything
         aram frequency       Frequency settings
         aram lmsregs         LMS6002D register dump
         aram loopback        Loopback settings
         aram mimo            MIMO settings
         aram pa              PA settings
         aram pps             PPS settings
         aram refclk          Reference clock settings
         aram rxvga1          Gain setting of RXVGA1 in dB (range: )
         aram rxvga2          Gain setting of RXVGA2 in dB (range: )
         aram samplerate      Samplerate settings
         aram trimdac         VCTCXO Trim DAC settings
         aram txvga1          Gain setting of TXVGA1 in dB (range: )
         aram txvga2          Gain setting of TXVGA2 in dB (range: )

poke <dac|lms|si> <address> <data>
    Poke a memory location

peek <dac|lms|si> <address> [num addresses]
    Peek a memory location

help [<command>]
    Provide information about specified command

info
    Print information about the currently opened device

load <fpga|fx3> <filename>
    Load FPGA or FX3

print <param>
    Print information about the device. The print command takes a parameter to print.

         aram bandwidth       Bandwidth settings
         aram config          Overview of everything
         aram frequency       Frequency settings
         aram lmsregs         LMS6002D register dump
         aram loopback        Loopback settings
         aram mimo            MIMO settings
         aram pa              PA settings
         aram pps             PPS settings
         aram refclk          Reference clock settings
         aram rxvga1          Gain setting of RXVGA1 in dB (range: )
         aram rxvga2          Gain setting of RXVGA2 in dB (range: )
         aram samplerate      Samplerate settings
         aram trimdac         VCTCXO Trim DAC settings
         aram txvga1          Gain setting of TXVGA1 in dB (range: )
         aram txvga2          Gain setting of TXVGA2 in dB (range: )

open [device identifiers]
    Open a bladeRF device. Open the specified device for use with successive commands. Any previously opened device will be closed. See the bladerf_open() documentation for the device specifier format.

probe
    List attached bladeRF devices

erase
    Erase part of FX3 flash device

version
    Host software and device version information

recover [<bus> <address> <firmware file>]
    Load firmware onto a device running in bootloader mode, or list all devices currently in bootloader mode.

jump_to_boot
    Jump to FX3 bootloader

clear
    Clear the screen

quit
    Exit the CLI

ALSO

bladeRF-flash(1).

More documentation is available at http://nuand.com/ and https://github.com/nuand/bladerf.

AUTHOR

bladeRF-cli was written by the contributors to the bladeRF Project. See the CONTRIBUTORS file for more information.