Módulo out-of-tree (OOT) de GNU Radio para bloques de QRadioLink.
AVISO IMPORTANTE: Este código es generado por IA.
Este código no ha sido revisado por programadores profesionales, es una tarea grande. Hay pruebas disponibles en el repositorio de código, revise esas pruebas y su código.
Módulo fuera del árbol (OOT) de GNU Radio para bloques de QRadioLink.
Rama main: OOT de GNU Radio 3.10 (CMake find_package(gnuradio)). El puerto experimental
de GNU Radio 4 está en la rama gnuradio4 (README_gr4.md en esa rama).
Navegación del código: docs/CODE_MAP.md (archivos, funciones, índice de bloques). Enrutamiento de modo ZMQ gr-ident: docs/GRIDENT_ZMQ.md (preámbulo de gr-ident en :5560).
El IQ de referencia para los bloques moduladores se verificó con radio-modulation-validator (2026-05-31). Resumen: FALLO SUAVE — 6/19 bloques pasaron, 13 fallo suave, 0 fallo grave, 3 omitidos.
Todos los modos probados fueron identificados en la familia de modulación correcta (FSK, PSK, AM, FM). Los fallos suaves a nivel de orden (por ejemplo, FSK predicho como CPFSK en lugar de 4FSK o GMSK) reflejan limitaciones del clasificador de orden del validador, no evidencia de que estos moduladores produzcan la familia de forma de onda incorrecta.
El escaneo utiliza IQ de referencia incorporado (no bloques OOT construidos); los resultados se aplican a los modos listados en este README en main y se reflejan en gnuradio4.
Resultados completos por bloque: VALIDATION_REPORT.md
Este proyecto está documentado en el siguiente preprint:
Cryptographically Keyed Gaussian-Distributed Spread-Spectrum for Enhanced Covert Communications: Design, Implementation, and Simulated Performance in ITU Channel Models
IACR Cryptology ePrint Archive, Paper 2025/108456
https://eprint.iacr.org/2025/108456
Marca de tiempo del registro del archivo: 21 de marzo de 2026.
Este módulo proporciona bloques de GNU Radio para varios esquemas de modulación digital y analógica, especializados para radioaficionados y comunicaciones de voz digital.
Este módulo fue convertido desde la aplicación QRadioLink, que es un transceptor SDR multimodo para GNU Radio, ADALM-Pluto, LimeSDR, USRP y otro hardware SDR. El código fuente original se encuentra en https://codeberg.org/qradiolink/qradiolink.
Validación: Los bloques convertidos que tienen una contraparte en QRadioLink han sido validados contra el código fuente original de QRadioLink (rama next, codeberg.org/qradiolink/qradiolink) para que los grafos de flujo, parámetros de filtro, constantes de escalado y comportamiento de los bloques coincidan. Las cadenas de modulador/demodulador SSB y AM (incluyendo la estructura CESSB y las constantes de clipper/stretcher) fueron restauradas para coincidir con las originales donde habían divergido. Algunos bloques en este módulo no tienen una fuente correspondiente en src/gr/ de QRadioLink; su origen se indica en la tabla a continuación.
Crédito y origen:
next, src/gr/): modulación/demodulación (2FSK, 4FSK, GMSK, BPSK, QPSK, AM, SSB, NBFM, WBFM), voz digital (FreeDV, M17, DMR) y bloques de soporte (RSSI, M17 deframer, MMDVM source/sink, clipper, stretcher, zero_idle_bursts, gr_4fsk_discriminator, demod_mmdvm_multi, demod_mmdvm_multi2, mod_mmdvm_multi2). El comportamiento de DSP y modo para estos bloques se derivaron o reimplementaron de la aplicación QRadioLink.gr_* en src/gr/ de QRadioLink): 8FSK, SOQPSK, CPM-4FSK, dPMR, NXDN, POCSAG, D-STAR, YSF, P25. Su origen se da en la tabla de origen de bloques a continuación.Origen de bloques (validación / atribución):
| Block(s) | Origin | Notes |
|---|---|---|
| 2FSK, 4FSK, GMSK, BPSK, QPSK, AM, SSB, NBFM, WBFM, FreeDV, M17, DMR | QRadioLink | Validado contra QRadioLink src/gr/ (gr_demod_, gr_mod_). |
| MMDVM source/sink, demod_mmdvm_multi, demod_mmdvm_multi2, mod_mmdvm_multi2, RSSI, clipper, stretcher, zero_idle_bursts, gr_4fsk_discriminator | QRadioLink | Validado contra QRadioLink src/gr/. |
| 8FSK | Implementado para este módulo | No hay gr_demod_8fsk/gr_mod_8fsk en QRadioLink. Extensión del diseño estilo 4FSK. |
| SOQPSK | Implementado para este módulo | No hay gr_demod_soqpsk/gr_mod_soqpsk en QRadioLink. De literatura/especificaciones SOQPSK. |
| CPM-4FSK | Implementado para este módulo | No hay gr_mod_cpm_4fsk en QRadioLink. |
| dPMR | Implementado para este módulo | No hay gr_* en QRadioLink. De ETSI TS 102 658 (vectores de prueba y comentarios de código). |
| NXDN | Implementado para este módulo | No hay gr_* en QRadioLink. De especificaciones del foro NXDN; el mapeo de símbolos referencia la convención MMDVM. |
| POCSAG | Implementado para este módulo | No hay gr_* en QRadioLink. De POCSAG/ITU-R M.584-2; protocolo compatible con MMDVMHost. |
| D-STAR | Implementado para este módulo | No hay gr_* en QRadioLink. De especificación D-STAR/JARL (FEC Golay); compatible con MMDVMHost. |
| YSF | Implementado para este módulo | No hay gr_* en QRadioLink. De documentación del protocolo YSF; compatible con MMDVMHost. |
| P25 | Implementado para este módulo | No hay gr_* en QRadioLink. De P25 Fase 1 TIA-102; compatible con MMDVMHost. |
| DSSS (base) | QRadioLink | Validado contra QRadioLink gr_demod_dsss/gr_mod_dsss. |
| DSSS (mejoras), GDSS | Este módulo | DSSS: mejoras sobre la base de QRadioLink. GDSS: de Shakeel et al., Sensors 2023. |
| Enrutamiento ZMQ gr-ident | Este módulo | Interoperabilidad con PUB de preámbulo de gr-ident; no proviene de QRadioLink. |
El código ha sido fuzzeado extensamente usando libFuzzer con más de 104 millones de ejecuciones en múltiples bloques, y no se descubrieron fallos ni fugas de memoria. Consulte fuzzing-results/results.md para detalles de cobertura.