Add multi-channel KrakenSDR Suite V2 support - #45
Open
mickeyslaven wants to merge 1 commit into
Open
Conversation
mickeyslaven
marked this pull request as draft
August 9, 2026 15:12
mickeyslaven
force-pushed
the
kraken-five-channel-reference
branch
from
August 9, 2026 15:38
388e2ae to
05df12b
Compare
mickeyslaven
marked this pull request as ready for review
August 9, 2026 15:43
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
This updates BLAH2's KrakenSDR backend to consume the standard TCP stream from KrakenSDR Suite V2.
The existing Kraken implementation opens individual tuners through
librtlsdrand exposes a two-channel reference/surveillance pair. Suite V2 already handles Kraken device access, synchronization, and calibration, so BLAH2 now reads calibrated coherent IQ from the Suite instead.Compared with standard BLAH2, this PR adds:
array_eigenbeamreference synthesis from a configurable set of coherent channels;Compatibility
The default BLAH2 build still includes the existing RSPduo, USRP, HackRF, and Kraken backends. The Kraken-specific Dockerfile builds the same BLAH2 processor with only the Kraken capture dependencies.
The map, detection, and track schemas are unchanged. A multi-channel Kraken therefore remains one ordinary 3lips node; its antenna channels are not presented as separate receivers.
This PR does not add direction finding, ADS-B processing, frequency hopping, or localization logic.
Configuration
Kraken channel count and channel roles are now explicit.
surveillance_channelsselects the channels that produce independent maps. Inarray_eigenbeammode,reference_synthesis.channelsselects the coherent channels used to estimate the common reference. Both lists have documented defaults.Frequency and gain remain configured in Suite V2. BLAH2 verifies the streamed center frequency and channel count against its configuration.
Validation
docker/Dockerfile-krakenimage from a clean tree.