
On macOS 12.6 running libusb 1.0.26, the host was seen to sometimes make an incomplete ClearFeature(ENDPOINT_HALT) request when ClearPipeStallBothEnds was called from libusb_cancel_transfer. The host would send the SETUP packet, and the firmware would call usb_transfer_schedule_ack to acknowledge the upcoming IN token. However, the host would then not send the IN token, proceeding directly to the next SETUP. Since an empty transfer was queued to schedule the ACK, the firmware would leak one transfer from the free_transfers list. After a few iterations of this, the firmware would run out of free transfers and the next request would hang waiting for one. Fix this by flushing the transfer queues for the control endpoint when a new SETUP is received, since that token implicitly cancels any previously ongoing request.
HackRF
This repository contains hardware designs and software for HackRF, a low cost, open source Software Defined Radio platform.
(photo by fd0 from https://github.com/fd0/hackrf-one-pictures)
principal author: Michael Ossmann mike@ossmann.com
Information on HackRF and purchasing HackRF: https://greatscottgadgets.com/hackrf/
Documentation
Documentation for HackRF can be viewed on Read the Docs. The raw documenation files for HackRF are in the docs folder in this repository and can be built locally by installing Sphinx Docs and running make html
. Documentation changes can be submitted through pull request and suggestions can be made as GitHub issues.
To create a PDF of the HackRF One documentation from the HackRf repository while on Ubuntu:
- run
sudo apt install latexmk texlive-latex-extra
- navigate to hackrf/docs on command line
- run the command
make latex
- run the command
make latexpdf
Getting Help
Before asking for help with HackRF, check to see if your question is listed in the FAQ.
For assistance with HackRF general use or development, please look at the issues on the GitHub project. This is the preferred place to ask questions so that others may locate the answer to your question in the future.
We invite you to join our community discussions on Discord. Note that while technical support requests are welcome here, we do not have support staff on duty at all times. Be sure to also submit an issue on GitHub if you've found a bug or if you want to ensure that your request will be tracked and not overlooked.
If you wish to see past discussions and questions about HackRF, you may also view the mailing list archives.
GitHub issues on this repository that are labelled "technical support" by Great Scott Gadgets employees can expect a response time of two weeks. We currently do not have expected response times for other GitHub issues or pull requests for this repository.