3 KiB
bladeRF Version Change Checklist
This document describes tasks that must be performed when updating the version numbers of various components contained in this repository.
Build and functional tasks are a given are documented elsewhere and are not covered here.
When multiple components in the repo have changed, this checklist should be performed in the following order:
- FPGA
- FX3 Firmware
- libbladeRF
- bladeRF-cli
- Project-wide items
FPGA
-
Update the
hdl/CHANGELOGfile -
Update the version number in the NIOS II lms_spi_controller.c file.
-
Update the version compatibilty table in the libbladeRF
version_compat.cfile. -
Apply the tag:
fpga_vX.Y.Z -
Generate the official bitstreams at the tag and have them uploaded to https://www.nuand.com/fpga
-
Update the
bladerf-fpga-hostedx115.postinstandbladerf-fpga-hostedx40.postinstfiles underhost/debian/.
FX3 Firmware
-
Update the
fx3_firmware/CHANGELOGfile -
Update the version number in the FX3 firmware CMakeLists.txt file
-
Update the version compatibility table in the libbladeRF
version_compat.cfile. -
Apply the tag:
firmware_vX.Y.Z -
Generate the official image at the tag with the following CMake config:
-DTAGGED_RELEASE=Yes(If building from top-level)-DVERSION_INFO_EXTRA=""(If building in fx3_firmware)
-
Have the image uploaded to https://www.nuand.com/fx3
-
Update the
bladerf-firmware-fx3.postinstfile underhost/debian.
libbladeRF
-
Update the
libbladeRF/CHANGELOGfile -
Update the version number in the CMakeLists.txt file
-
Apply the tag:
libbladeRF_vX.Y.Z -
Generate Doxygen pages at the tag with:
-DTAGGED_RELEASE=Yes(If building from top-level)-DVERSION_INFO_EXTRA=""(If building inhost/)
bladeRF-cli
-
Regenerate the fallback
cmd_help.*items using thegenerate.bashscript. (This is insrc/cmd/doc/.) -
Update the version number in the CMakeLists.txt file
-
Update the
bladeRF-cli/CHANGELOGfile -
Apply the tag
bladeRF-cli_vX.Y.X
Project-wide items
-
Ensure all of the above items are at a tagged version
-
Update the top-level CHANGELOG file.
-
Update the
debian/CHANGELOGfile -
Apply the tag: YYYY-MM[-rcN]
-
Prepare the API docs and binary packages