bladeRF/host/libraries/libbladeRF_bindings/python
Rey Tucker a0d498e723
host: typedef common parameter types (#51)
* libbladeRF: add typedefs for common parameter types

This adds typedefs for, and changes libbladeRF.h to use said typedefs
for, the following:

bladerf_gain -> int
bladerf_sample_rate -> unsigned int
bladerf_bandwidth -> unsigned int
bladerf_frequency -> uint64_t
bladerf_timestamp -> uint64_t
bladerf_correction_value -> int16_t
2018-05-25 11:45:38 -04:00
..
bladerf host: typedef common parameter types (#51) 2018-05-25 11:45:38 -04:00
scripts host: python: Python packaging (#18) 2018-03-26 12:26:46 -04:00
.gitignore host: python: Python packaging (#18) 2018-03-26 12:26:46 -04:00
README.md host: python: Python packaging (#18) 2018-03-26 12:26:46 -04:00
setup.py host: make low-level API calls generic by removing part numbers (#49) 2018-05-25 10:55:04 -04:00

Python 3 Bindings

This package provides libbladeRF bindings for Python 3, using the CFFI interface.

Installation

  • To install system-wide: sudo python3 setup.py install
  • To install for your user: python3 setup.py install

Usage: Python module

A Python module is provided. To use, import bladerf and then instantiate the bladerf.BladeRF class to access your board.

An example of opening the first available device and changing the frequency of the first RX channel:

>>> import bladerf
>>> d = bladerf.BladeRF()
>>> d
<BladeRF(<DevInfo(libusb:device=6:53 instance=0 serial=...)>)>
>>> ch = d.Channel(bladerf.CHANNEL_RX(0))
>>> ch
<Channel(<BladeRF(<DevInfo(libusb:device=6:53 instance=0 serial=...)>)>,CHANNEL_RX(0))>
>>> ch.frequency
2484000000
>>> ch.frequency = 1.0e9
>>> ch.frequency
1000000000

Usage: bladerf-tool

A command-line interface named bladerf-tool is provided. For usage instructions, type bladerf-tool --help.

Example usage:

$ bladerf-tool info
*** Devices found: 1

*** Device 0
Board Name        bladerf1
Device Speed      Super
FPGA Size         40
FPGA Configured   True
FPGA Version      v0.6.0 ("0.6.0")
Firmware Version  v2.1.0 ("2.1.0")
RX Channel Count  1
  Channel RX1:
    Gain          39
    Gain Mode     Manual
    Symbol RSSI   None
    Frequency     1000000000
    Bandwidth     28000000
    Sample Rate   1000000
TX Channel Count  1
  Channel TX1:
    Gain          -14
    Gain Mode     Manual
    Frequency     2446999999
    Bandwidth     28000000
    Sample Rate   1000000

License

This code is distributed under an MIT License.