bladeRF/host/libraries/libbladeRF_bindings/python
Rey Tucker 5240d995b0
host: python: Python packaging (#18)
* host: python: reorganize files for packaging

* host: python: move bladerf-tool CLI into main()

* host: python: move cdef string into its own file

Since packaging lets us have multiple files easily, this cleans up
bladerf.py a lot.

* host: python: add __init__.py skeleton

* host: python: fixup py3flakes and pycodestyle

* host: python: fix unused local variable

* host: python: more reorganization to appease Python

* host: python: update .gitignore for setup detritus

* host: python: initial setup.py

* host: python: update accompanying documentation

* host: python: cleanup setup.py

* host: python: move license stuff into files

* host: python: version 1.0.0
2018-03-26 12:26:46 -04:00
..
bladerf host: python: Python packaging (#18) 2018-03-26 12:26:46 -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: python: Python packaging (#18) 2018-03-26 12:26:46 -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.