Wideband autonomous SDR analysis engine forked from sdr-visual-suite

Jan Svabenik 094ee9ddff Introduce reusable gpudemod batch runner		vor 2 Tagen
..
build	Checkpoint before runtime optimization	vor 2 Tagen
native	Use shared-memory FIR kernel in gpudemod	vor 2 Tagen
README.md	docs: split CUDA build paths by platform	vor 3 Tagen
batch.go	Add batch extraction API to gpudemod	vor 2 Tagen
batch_runner.go	Introduce reusable gpudemod batch runner	vor 2 Tagen
doc.go	docs: add initial CUDA demod kernel source	vor 3 Tagen
errors.go	Introduce reusable gpudemod batch runner	vor 2 Tagen
gpudemod.go	Add GPU shift-filter-decimate path for signal extraction	vor 2 Tagen
gpudemod_cufft_test.go	build: wire CUDA demod package through nvcc and MSVC	vor 3 Tagen
gpudemod_stub.go	Add GPU shift-filter-decimate path for signal extraction	vor 2 Tagen
gpudemod_test.go	feat: prepare CUDA demod launch boundary	vor 3 Tagen
gpudemod_windows.go	Add GPU shift-filter-decimate path for signal extraction	vor 2 Tagen
kernels.cu	feat: add demod validation and GPU mode telemetry	vor 3 Tagen
validation.go	feat: wire CUDA freq-shift launcher	vor 3 Tagen
validation_extra.go	feat: add demod validation and GPU mode telemetry	vor 3 Tagen
validation_extra_test.go	feat: add demod validation and GPU mode telemetry	vor 3 Tagen
validation_runtime.go	Disable GPU validation by default in production	vor 2 Tagen
validation_test.go	feat: validate CUDA freq-shift output	vor 3 Tagen

README.md

gpudemod

Phase 1 CUDA demod scaffolding.

Current state

Standard Go builds use gpudemod_stub.go (!cufft).
cufft builds allocate GPU buffers and cross the CGO/CUDA launch boundary.
If CUDA launch wrappers are not backed by compiled kernels yet, the code falls back to CPU DSP.
The shifted IQ path is already wired so a successful GPU freq-shift result can be copied back and reused immediately.
Build orchestration should now be considered OS-specific; see docs/build-cuda.md.

First real kernel

kernels.cu contains the first candidate implementation:

gpud_freq_shift_kernel

This is not compiled automatically yet in the current environment because the machine currently lacks a CUDA compiler toolchain in PATH (nvcc not found).

Next machine-side step

On a CUDA-capable dev machine with toolchain installed:

Compile kernels.cu into an object file and archive it into a linkable library
- helper script: tools/build-gpudemod-kernel.ps1
On Jan's Windows machine, the working kernel-build path currently relies on nvcc + MSVC cl.exe in PATH
Link gpudemod_kernels.lib into the cufft build
Replace gpud_launch_freq_shift(...) stub body with the real kernel launch
Validate copied-back shifted IQ against dsp.FreqShift
Only then move the next stage (FM discriminator) onto the GPU

Why this is still useful

The runtime/buffer/recorder/fallback structure is already in place, so once kernel compilation is available, real acceleration can be inserted without another architecture rewrite.