Although I/Q DC offsets were being applied when tuning the device's
center frequency, the LMS DC registers' calibration results were not being
applied from the table, making the I/Q DC offsets from the table less
effective.
These values are now written to the LMS during the init_device() call,
which occurs once after the FPGA is loaded, if DC calibration tables are
loaded. If only an RX or only a TX table is available, all of the
register values included with the table are used. Otherwise, only
relevant items from each table are used and the LPF Tuning value is
checked for a discrepancy.
To achieve this, the config_load_all() function has been split into
the DC cal table loading and FPGA loading functions, because the DC cal
table must be loaded prior to init_device(), whereas the FPGA loading is
intended to be the last call made.
Cleanup items here were just removal of unused bitrot:
- Removal of the load_calibration_table() function. This was
a vestige of earlier development efforts. The functionality here
is performed in dc_cal_table.c and in the updates to
init_device().
- Removal of the lms_dc_ref_vals structure. This was replaced by
bladerf_lms_dc_cals in
|
||
|---|---|---|
| .. | ||
| doc | ||
| include | ||
| src | ||
| tests | ||
| bladerf.rc.in | ||
| CHANGELOG | ||
| CMakeLists.txt | ||
| libbladeRF.pc.in | ||
| README.md | ||
bladeRF Library (libbladeRF)
This is the source for the library which interacts with the bladeRF device.
It is meant to be used as a simple and intuitive way to think about not just the bladeRF device itself, but most any radio hardware. Fundamental operations such as setting the tuning frequency, manipulating switches on the board for different paths, and changing the different transmit and receive gains are all parts of a radio system which need to be exposed at a library level.
Functionality provided by this library includes:
- Opening/closing devices and querying information about them
- Tuning to various frequencies
- Configuring the sample rate
- Configuring the bandwidth and gain of the RF chain
- Configuring RF gains
- Transmitting and receiving complex baseband samples
- Updating the device's firmware and FPGA
- Low-level access to on-board devices, for testing and debugging
For more information, please generate and view the doxygen documentation. From your host/build directory, run:
cmake -DBUILD_DOCUMENTATION=ON ../
make libbladeRF-doxygen
The HTML documentation will be placed in <build dir>/libraries/libbladerf/doc/doxygen/html. The index.html file is the "main" documentation page.
Please see the CHANGELOG file for a summary of changes across libbladeRF versions.
Build Variables
Below is a list of useful and project-specific CMake options. Please see the CMake [variable list] in CMake's documentation for more information.
| Option | Description |
|---|---|
| -DBUILD_LIBBLADERF_DOCUMENTATION=<ON/OFF> | Builds API documentation using Doxygen. Default: equal to BUILD_DOCUMENTATION |
| -DENABLE_BACKEND_USB=<ON/OFF> | Enables USB backends in libbladeRF. Default: ON |
| -DENABLE_BACKEND_LIBUSB=<ON/OFF> | Enables libusb backend. Default: ON if libusb is available, OFF otherwise. |
| -DENABLE_BACKEND_CYAPI=<ON/OFF>a | Enables (Windows-only) Cypress driver/library based backend. Default: ON if the FX3 SDK is available, OFF otherwise. |
| -DENABLE_BACKEND_DUMMY=<ON/OFF> | Enables dummy backend support. Only useful for some developers. Default: OFF |
| -DENABLE_LIBBLADERF_LOGGING=<ON/OFF> | Enable log messages. Default: ON |
| -DENABLE_LIBBLADERF_SYNC_LOG_VERBOSE=<ON/OFF> | Enable log_verbose() calls in the sync interface's data path. Note that this may harm performance. Default: OFF |
| -DENABLE_LOCK_CHECKS=<ON/OFF> | Enable checks for lock acquistion failures (e.g., deadlock). Default: OFF |
| -DLIBUSB_PATH=</path/to/libusb> | Path to libusb files. This is generally only needed for Windows users who downloaded binary distributions. |