Radiomódem#

Radiomódem es la página de la administración web que une el firmware con la radio. Allí se elige la modulación en el aire, se temporiza el acceso al canal, se acota el tiempo de transmisión propio de la estación y se describe la relación eléctrica entre los pines ADC/DAC del ESP32 y el transceptor. Todas las demás páginas deciden qué se transmite; esta decide cómo, cuándo y con cuánto nivel.

Este capítulo documenta cada control de la página, uno por uno: qué es, qué cambia realmente dentro del firmware, cómo elegir un valor, ejemplos de uso y los errores que cada ajuste puede provocar. Para el DSP y el componente del módem que hay detrás, véase El módem por software y La cadena de señal DSP.

Propiedad	Valor
Entrada de menú	Radiomódem
Rutas	`GET /radio`, `POST /radio`, más `POST /radio/looptest`, `POST /radio/level` y `POST /radio/txtest` para los tres botones de diagnóstico.
Manejador	`components/webconfig/pages/page_radio.c`
Almacenado en	`/storage/radio.json` (descargable y subible desde la página Almacenamiento)
Se aplica	En vivo al Guardar, salvo Activar módem ADC/DAC de audio y Frecuencia de muestreo de transmisión, que necesitan reinicio.

Por qué algunos campos necesitan reinicio#

page_radio_post() escribe todo el formulario en g_config bajo un solo bloqueo, guarda radio.json y luego llama a aprs_service_apply_modem_config(), que empuja los ajustes nuevos al módem en marcha a través de modem_set_modem(). Todo lo que el módem admite mientras funciona surte efecto en el instante en que Guardar devuelve: sin reinicio, sin tramas perdidas y sin reiniciar el servicio.

Dos ajustes quedan fuera de ese camino:

Activar módem ADC/DAC de audio — modem_init() se ejecuta exactamente una vez, desde main.c, y sólo si este interruptor ya estaba activo en el arranque. Activarlo guarda el ajuste pero no levanta ningún hardware hasta el siguiente reinicio.
Frecuencia de muestreo de transmisión — el periodo del reloj de muestreo y cada incremento de fase derivado de él se programan con el hardware del módem detenido, así que afskSetDacSampleRate() se niega a actuar sobre un módem vivo y el valor lo aplica el siguiente modem_init().

En ambos casos el formulario sigue mostrando el valor guardado, que es el que usará el próximo arranque, no aquel con el que el módem está funcionando en este momento.

Advertencia

Tres botones de esta página — PRUEBA DE BUCLE, NIVEL RX y PRUEBA TX — guardan el formulario antes de ejecutarse, exactamente como si se hubiera pulsado Guardar. No los use para «probar» un ajuste que no piensa conservar. Dos de los tres, además, activan el transmisor.

Protocolo#

FX.25 (AX.25 con corrección de errores)#

Qué es. FX.25 envuelve una trama AX.25 corriente en un bloque Reed–Solomon con una etiqueta de correlación por delante. Un receptor que entiende FX.25 puede reparar errores de bit que de otro modo harían fallar el CRC de la trama; un receptor que no lo entiende sigue encontrando dentro la trama AX.25 sencilla y la decodifica con normalidad. Es una extensión compatible, no un protocolo distinto.

Qué hace aquí el desplegable. Un selector de tres opciones guarda fx25Mode = 0, 1 o 2, que Ax25Init() interpreta directamente:

Apagado (0, el valor por defecto) — AX.25 sencillo en ambos sentidos (Ax25Config.fx25 = 0, Ax25Config.fx25Tx = 0).
Solo recepción (1) — FX.25 en recepción, AX.25 sencillo en transmisión (Ax25Config.fx25 = 1, Ax25Config.fx25Tx = 0). Esto le compra a la estación una mejor decodificación de las estaciones FX.25 que oye, sin añadir redundancia a lo que transmite.
Recepción y transmisión (2) — FX.25 en ambos sentidos (Ax25Config.fx25 = 1, Ax25Config.fx25Tx = 1). Esta estación también envuelve sus propias tramas salientes en el bloque Reed–Solomon, de modo que cualquier vecino que entienda FX.25 recibe de ella la misma corrección de errores.

Cuándo activarlo.

Casi siempre, en un canal APRS normal. El coste es tiempo de CPU en el receptor y nada en el aire.
Sin duda, en un trayecto débil o ruidoso donde se oyen paquetes parciales, si algún vecino transmite FX.25.
Déjelo apagado mientras persigue un problema de recepción y quiere la cadena de señal más simple posible.

Nota

FX.25 sólo cambia cómo se ensamblan en tramas los bits recibidos y si las tramas salientes se encapsulan. No afecta a los demoduladores ni a sus prefiltros, así que activarlo o desactivarlo nunca cambia cómo se recibe el audio en sí.

Audio / AFSK#

Activar módem ADC/DAC de audio#

Qué es. El interruptor maestro del módem por software integrado. Con él activo, el propio ESP32 es el TNC: el SAR-ADC escucha el audio de recepción de la radio, el DAC genera el audio de transmisión y un GPIO acciona el PTT. Con él apagado, modem_init() no se llama nunca, no corre ninguna tarea de audio, no se configura ADC ni DAC, y aprs_service_can_transmit() devuelve falso: toda transmisión de RF que el firmware intente se descarta en el origen y se contabiliza bajo DROP_MODEM_NOT_READY.

Usos.

Activado — el caso normal: una estación completa e independiente (IGate, digipeater, tracker, meteorología, telemetría) con una radio conectada.
Apagado — una estación sólo de internet. Un IGate que sólo reenvía APRS-IS a Telegram, un cliente Winlink de sólo recepción por internet o una unidad de banco de pruebas sin radio alguna. Apagar el módem libera las tareas de audio y su cuota de CPU, y hace imposible activar nada por accidente.

Advertencia

Este es el único campo de la página cuyo cambio no hace nada hasta que se reinicia el dispositivo. Márquelo, Guardar y reinicie desde la página Acerca de / Firmware. Los botones PRUEBA DE BUCLE y PRUEBA TX detectan este estado y lo dicen explícitamente en lugar de fallar de forma oscura.

Modulación#

Qué es. La modulación en el aire y la velocidad en baudios usadas tanto en recepción como en transmisión.

Valor	Perfil	Baudios	Tonos	Dónde se usa
0	AFSK300	300	1600 / 1800 Hz	Packet en HF (30 m, 20 m). Suficientemente estrecho para un canal de SSB.
1	Bell 202 (predeterminado)	1200	1200 / 2200 Hz	APRS estándar en todo el mundo — 144.390 MHz en Norteamérica, 144.800 MHz en la mayor parte de Europa, 145.175 MHz en Australia, etc.
2	ITU V.23	1200	1300 / 2100 Hz	Enlaces packet europeos heredados. No interopera con Bell 202.
3	G3RUH FSK	9600	FSK directo	Enlaces de alta velocidad, trabajo por satélite. Exige un camino de audio plano en ambos sentidos.

Qué cambia internamente. ModemInit() reconstruye toda la cadena de demodulación: coeficientes de los filtros, paso del PLL, umbrales de DCD y el número de demoduladores. Los perfiles de 1200 Bd ejecutan el juego de demoduladores elegido en Demodulador de recepción — tres en paralelo por omisión, cada uno tras un prefiltro pasabanda con distinta inclinación, de modo que una trama que un camino pierde puede recuperarla otro; los de 300 Bd y 9600 Bd ejecutan un solo demodulador.

Ejemplos.

Un IGate doméstico en la frecuencia APRS nacional → 1200 Bd Bell 202. No lo cambie. Cualquier otra cosa deja la estación sorda y muda en ese canal.
Un enlace packet a 9600 Bd con un emplazamiento vecino en una frecuencia símplex dedicada → 9600 Bd G3RUH, con Entrada de audio plana / de discriminador marcada y conexión por puerto de datos en ambos extremos.
Una pasarela de HF en 10.147,6 MHz USB → 300 Bd AFSK.

Advertencia

La modulación debe coincidir con la de todas las estaciones con las que pretenda trabajar. No hay detección automática ni respaldo: un desajuste significa que no se decodifica nada en ninguna dirección, y sus transmisiones las oirán como ruido todos los demás en el canal. Si una estación que funcionaba deja de decodificar de repente, este es el primer campo que hay que revisar.

Advertencia

9600 Bd G3RUH no pasa por los conectores de micrófono y altavoz de una radio. El preénfasis, el deénfasis y el ancho de banda de audio de un camino de voz lo destruyen. Requiere un auténtico puerto de datos plano (una conexión de «packet 9600» o de discriminador) tanto en transmisión como en recepción.

Hardware de audio (en tiempo de compilación)#

Debajo del selector de modulación se muestra un único bloque de sólo lectura. No es un ajuste: es la definición de placa con la que se compiló el firmware, de modo que una elección de cableado pueda distinguirse de un valor guardado de un vistazo. Informa del pin de salida del DAC (MODEM_DAC_GPIO, por omisión GPIO25), el pin de entrada del ADC (MODEM_ADC_GPIO, por omisión GPIO33), el pin de PTT (MODEM_PTT_GPIO, Desactivado cuando es -1), PTT activo en alto (MODEM_PTT_ACTIVE_HIGH), la atenuación del ADC (MODEM_ADC_ATTEN) y la frecuencia de muestreo del ADC (MODEM_ADC_SAMPLERATE) con la que se compiló el firmware. La frecuencia de muestreo de transmisión no aparece: es un ajuste guardado, que se elige en Frecuencia de muestreo de transmisión más abajo en esta misma página.

Todos los valores de compilación proceden del CMakeLists.txt de nivel superior y sólo pueden cambiarse recompilando el firmware — por ejemplo idf.py build -DMODEM_ADC_GPIO=32. El pin de PTT está registrado en la tabla de propiedad de GPIO de la administración, de modo que aparece como usado — PTT en cualquier otro selector de GPIO de la web (la salida de alarma de mensajes, por ejemplo), que es lo que impide que dos funciones reclamen el mismo pin.

Nota

El pin del DAC sólo puede ser GPIO25 (DAC1) o GPIO26 (DAC2); el DAC del ESP32 no es enrutable a ningún otro pin, y la compilación falla con un error explícito si se indica otro número.

Entrada de audio plana / de discriminador#

Qué es. Una declaración sobre de dónde procede el audio de recepción, no un filtro que se activa por gusto. Les dice a los demoduladores si el audio que reciben ya ha sido deenfatizado y, por tanto, qué juego de inclinaciones de prefiltro usan los preajustes de Demodulador de recepción.

Activado (por omisión) — el audio viene de un puerto de datos o directamente del discriminador. Esa señal es plana y sin filtrar, y sigue llevando el preénfasis que haya aplicado la estación transmisora: una estación que entra por su micrófono llega con el tono de 2200 Hz entre 5 y 12 dB más fuerte que el de 1200 Hz; una que entra por una entrada de datos plana llega con ambos iguales. Los preajustes combinan por eso un prefiltro plano con prefiltros que atenúan el tono de 2200 Hz (y, con tres filtros, uno que lo realza).
Apagado — el audio viene de un conector de altavoz o de auriculares. La salida de audio de un receptor de voz ya está deenfatizada y limitada en banda, así que un transmisor de entrada plana llega con el tono de 2200 Hz atenuado. Los preajustes combinan un prefiltro plano con prefiltros que realzan el tono de 2200 Hz.

El preajuste Clásico ejecuta en cambio una pareja fija: un pasabanda de 8 coeficientes (plano para Activado, inclinado hacia 2200 Hz para Apagado) y un demodulador sin prefiltro.

Los juegos Multicomparador no dependen de este ajuste: sus doce demoduladores cubren el desbalance de los dos tipos de audio con un solo juego de tablas.

Ejemplos.

Baofeng UV-5R, audio tomado del conector de altavoz de 3,5 mm → apagado.
Un transceptor móvil con conector mini-DIN de datos de 6 pines, usando el pin 4 (packet 1200 Bd) → normalmente apagado; usando el pin de discriminador de 9600 Bd → activado.
Cualquier enlace G3RUH de 9600 Bd → activado, siempre.
Un SDR que entrega audio de FM demodulado sin deénfasis en la cadena → activado.

Advertencia

Poner esto al revés no impide la decodificación del todo: reduce en silencio a la mitad la sensibilidad de la estación. El síntoma es una estación que decodifica perfectamente los paquetes locales fuertes y pierde todo lo débil. Si su tasa de decodificación parece pobre y los niveles son correctos, conmute esto y compare.

Truco

Este es un ajuste que tiene sentido probar empíricamente. Ejecute NIVEL RX con cada opción mientras hay tráfico real en el canal y observe cuál informa DCD sí más a menudo y produce más decodificaciones en la tabla de tráfico del panel.

Preámbulo (ms)#

Qué es. El TXDelay de AX.25: cuánto tiempo permanece el transmisor activado, enviando sólo bytes de bandera HDLC, antes del primer bit de datos de la trama. Da tiempo al squelch de las estaciones receptoras a abrirse, a su AGC a estabilizarse y a los PLL de sus demoduladores a engancharse.

Rango 50–2000 ms, por omisión 300 ms.

Ax25TxDelay() convierte los milisegundos en un número de bytes de bandera según la velocidad en baudios actual. A 1200 Bd, 8 bits tardan unos 6,7 ms, de modo que 300 ms son unos 45 bytes de bandera y cada 1000 ms adicionales añaden unos 150 bytes más de portadora muerta delante de cada una de las tramas que transmite.

Cómo elegir.

300 ms es correcto para la mayoría de los transceptores modernos en símplex.
Súbalo a 400–600 ms si su transmisor tarda en alcanzar plena potencia, si pasa por un repetidor o si estaciones lejanas informan de que oyen su portadora pero sólo decodifican algunas de sus tramas.
Súbalo más, hacia 800–1000 ms, sólo para un camino de PTT realmente lento: un amplificador conmutado por relé, un transvertidor, un equipo antiguo con conmutación T/R lenta.
Bájelo hacia 150–200 ms sólo con una radio moderna, rápida y conectada directamente, y sólo si ha confirmado con un vecino que sus tramas siguen decodificándose.

Advertencia

Un preámbulo largo es un impuesto puro sobre un canal compartido. A 1200 Bd, un informe de posición APRS suele estar en el aire alrededor de medio segundo; un preámbulo de 2000 ms significa que cinco sextas partes de cada activación son portadora muerta. En una frecuencia concurrida, esta es una de las formas más rápidas de convertirse en la estación de la que todos se quejan.

Advertencia

Un preámbulo demasiado corto es la causa clásica de «algunas estaciones nunca me oyen». La trama empieza antes de que su squelch se haya abierto, de modo que sus primeros bytes — incluido el campo de dirección — se pierden, y la trama falla sin contabilizarse como error en ningún sitio visible. Si le digipitean de forma inconsistente, pruebe a subir esto antes que nada.

Cola de TX (ms)#

Qué es. El TXTail de AX.25: cuánto tiempo sigue activo el transmisor después de la bandera de cierre de una trama, enviando más bytes de bandera, antes de liberar el PTT. La cadena de audio de la radio - preénfasis, filtros y, en muchos portátiles como el UV-5R, una conmutación de transmisión a recepción que silencia el audio unos milisegundos antes de que caiga la portadora - retrasa o recorta el final de lo que envía el módem. Sin cola, la bandera de cierre o los últimos bits del FCS pueden perderse en el aire aunque el módem los haya emitido, y entonces todos los receptores descartan la trama. La prueba de lazo no puede mostrarlo: en su cable no hay radio.

Rango 0–500 ms, por defecto 20 ms.

Ax25TxTail() convierte los milisegundos en una cantidad de bytes de bandera según la velocidad actual, redondeando hacia arriba, así que cualquier valor distinto de cero envía al menos una bandera. 20 ms son tres banderas a 1200 Bd.

Cómo elegirlo.

20–30 ms sirve para la mayoría de los transceptores.
Súbalo a 50–100 ms si estaciones lejanas oyen sus tramas pero decodifican solo algunas y un preámbulo más largo no ayudó, o a través de un repetidor cuyo camino de audio añade retardo.
0 libera el PTT en el último bit de la bandera de cierre. Úselo solo con una radio cuyo camino de audio se sepa que no añade retardo.

Intervalo de tiempo TX (ms)#

Qué es. Pese al nombre, este campo fija el tiempo de silencio del módem: Ax25TimeSlot() lo escribe en Ax25Config.quietTime, el periodo de asentamiento obligatorio que el planificador de transmisión observa después de una transmisión (y al arrancar el módem) antes de considerar volver a activar el PTT. Cuando se fija un valor distinto de cero, se añade una fluctuación aleatoria de 100–1000 ms al primer plazo, para que dos estaciones configuradas igual que arranquen a la vez no queden sincronizadas.

Rango 0–10000 ms, por omisión 2000 ms. Ponerlo a 0 elimina por completo el tiempo de silencio, tanto el plazo pendiente como el de cada trama posterior, incluidas las digipetidas: el módem transmitirá en cuanto oiga el canal libre y la tirada de persistencia tenga éxito.

Nota

El intervalo entre tiradas de persistencia — el clásico SlotTime de AX.25 — es un campo aparte, Ranura de tiempo CSMA, descrito más abajo. Este campo es el tiempo de silencio que precede a la primera de esas ranuras.

Ejemplos.

Canal APRS metropolitano concurrido, estación que además digipitea → mantenga 2000 ms o súbalo a 3000 ms. La estación seguirá respondiendo mensajes con prontitud, porque el tiempo de silencio sólo retrasa el inicio de un nuevo ciclo de activación.
Un canal rural tranquilo con un puñado de estaciones → 1000 ms resulta cómodo.
Un enlace punto a punto dedicado en una frecuencia privada con sólo dos estaciones → 0 es razonable; no hay contienda que repartir.

Advertencia

0 en un canal compartido elimina por completo el periodo de asentamiento y convierte a esta estación en la más agresiva de la frecuencia. Todas las demás se retiran después de transmitir; la suya no.

Advertencia

Los valores grandes retrasan todo, incluidos los acuses de recibo de mensajes y las repeticiones del digipeater, que el limitador de ciclo de trabajo de más abajo exime deliberadamente. Por encima de unos 5000 ms la estación empieza a parecer poco receptiva a quien intente enviarle mensajes.

Buffers de TX#

Qué es. Cuántas tramas pueden estar en el anillo de transmisión de RF — en cola esperando canal libre, o en el aire en ese momento — antes de que una trama recién ofrecida se descarte en lugar de encolarse.

Rango 1–11, por omisión 1. El techo es la profundidad útil real del anillo de transmisión (AX25_TX_FRAME_RING_MAX), de modo que el desplegable nunca puede ofrecer un valor que el anillo no pudiera contener.

De qué protege. Sin tope, una ráfaga — un IGate retransmitiendo APRS-IS a RF más rápido de lo que el canal se libera, o una pasada del planificador en la que varios informes periódicos vencen a la vez — encolaría tramas mucho más rápido de lo que un canal de 1200 Bd puede drenar. Esas tramas saldrían al aire minutos después, mucho más tarde de dejar de ser ciertas, o se descartarían igualmente al llenarse el anillo. Poner tope aquí descarta el exceso de inmediato y registra el motivo.

Ejemplos.

El valor 1 por omisión — la respuesta correcta para un tracker o una estación que sólo baliza. Los informes de posición sólo interesan cuando son actuales; uno rancio encolado detrás de otros tres es peor que ninguno.
2–3 — un digipeater concurrido o un IGate con pasarela INET→RF activa, en un canal que se libera a ráfagas. Absorbe una acumulación breve sin dejar que la cola envejezca.
8–11 — raramente apropiado. Sólo en un enlace dedicado donde el canal está esencialmente siempre libre y cada trama debe entregarse de verdad.

Advertencia

Subir esto no hace el canal más rápido. Una cola que está llena porque el canal está ocupado seguirá llena; las tramas simplemente serán más viejas cuando por fin se transmitan. Si se descartan tramas por acumulación, reduzca lo que la estación transmite (intervalos de baliza más largos, filtros de IGate más estrictos) en vez de profundizar la cola.

Nota

Esto afecta sólo al anillo de transmisión de RF. El socket de APRS-IS tiene su propio buffer independiente, así que una rama de RF congestionada nunca bloquea ni descarta la rama de internet del mismo paquete.

Limitador de ciclo de trabajo y Límite de ciclo de trabajo (%)#

Qué es. Un techo sobre el tiempo de transmisión acumulado propio de esta estación, medido en una ventana deslizante de 10 minutos (dividida internamente en cuarenta cubos de 15 segundos). Es totalmente independiente de CSMA: CSMA le impide transmitir encima de alguien y no recuerda lo que transmitió hace un minuto; esto tiene memoria y ninguna opinión sobre el canal.

Apagado por omisión. Rango del techo 1–100 %, por omisión 25 %.

Qué ocurre al alcanzar el techo. El tráfico se divide en dos:

Clase	Comportamiento una vez alcanzado el techo
Crítico — mensajes APRS y sus acuses de recibo, repeticiones del digipeater	Se transmiten igualmente. Su tiempo en el aire sigue contando para la ventana; sólo se omite la compuerta para ellos.
No crítico — balizas de posición propias, objetos e ítems, informes meteorológicos, telemetría, boletines, retransmisión masiva INET→RF del IGate	Se retienen. Cada uno de ellos es una tarea periódica que volverá a ofrecer el mismo informe en su siguiente intervalo, así que es un aplazamiento y no una pérdida, aunque se contabilice bajo `DROP_TX_DUTY_CYCLE` en el panel para que sea visible.

Usos.

Estaciones desatendidas. En varios planes de banda, un techo de ciclo de trabajo en una estación automática no es una cortesía sino una condición de licencia. Aquí es donde se impone.
Proteger el amplificador de potencia. Un portátil o un pequeño amplificador diseñado para uso intermitente de voz se sobrecalentará si un planificador mal configurado lo activa repetidamente. 20–25 % es una cifra segura habitual para ese hardware.
Emplazamientos solares o a batería. La corriente de transmisión domina el presupuesto de energía; un techo convierte «cuánta energía consumirá esta estación» en un número calculable.
Una red de seguridad frente a sus propios errores. Un intervalo de baliza puesto por accidente en 10 segundos, una tormenta de definiciones de telemetría o un filtro INET→RF desbocado no pueden monopolizar la frecuencia con el limitador activo.

Ejemplos.

Digipeater en cima de montaña con red eléctrica y amplificador adecuado → activado al 50 %: generoso, pero sigue siendo un tope duro contra un descontrol.
IGate doméstico sobre un portátil → activado al 20 %. Los finales del portátil se lo agradecerán.
Digipeater de relleno alimentado por energía solar → activado al 10 %, con intervalos de baliza lo bastante largos como para que el limitador sea un respaldo y no algo cotidiano.
Una estación en pruebas sobre carga artificial → apagado.

Advertencia

Como el tráfico de mensajes y las repeticiones del digipeater están exentos, el limitador no es una garantía de tiempo máximo en el aire. Un digipeater en mitad de una red de emergencia superará su techo configurado, por diseño. No trate el número como una garantía reglamentaria si las condiciones de su licencia son absolutas.

Advertencia

Un techo muy bajo combinado con balizas frecuentes significa que las balizas se aplazan en silencio, a veces durante mucho tiempo. Si aprs.fi muestra su estación actualizándose mucho menos a menudo que su intervalo configurado, revise el contador de descartes del panel antes de sospechar de la radio.

Tiempo mínimo de PTT liberado (ms)#

Qué es. Un hueco sin PTT garantizado adicional entre una transmisión y la siguiente, por encima del retardo fijo de liberación de un tick de servicio (unos 10 ms) que el módem aplica siempre.

Rango 0–5000 ms, por omisión 0 (sin retención adicional).

Por qué existe. El suelo propio del módem garantiza que el PTT se libera de forma visible entre tramas, pero cierto equipamiento necesita bastante más:

Un repetidor cuyo tono de cortesía y cola de squelch deben terminar antes de que el siguiente paquete active el PTT, o el comienzo de su trama caerá encima.
Un transceptor con conmutación T/R por relé que necesita tiempo de asentamiento, o recortará el comienzo de la siguiente transmisión.
Un amplificador lineal con secuenciador, donde volver a activar demasiado rápido conmuta el relé en caliente.
Una radio cuya propia lógica interna de temporización o «antirrebote de PTT» ignora una activación que llega demasiado pronto tras una liberación.

Ejemplos.

Conexión directa a un portátil o móvil moderno → 0.
Trabajando a través de un repetidor con pitido de cortesía → 500–1000 ms, lo bastante para que se despeje la cola.
Amplificador conmutado por relé en la cadena → 200–300 ms.

Advertencia

Este retardo se aplica entre todas las transmisiones consecutivas, incluidos los reintentos de un mensaje APRS sin acuse. Poner segundos aquí hace que un intercambio de varias tramas resulte notablemente lento.

Persistencia CSMA (p, 1–255)#

Qué es. El parámetro Persist estándar de AX.25/KISS. Una vez que se oye el canal libre, el módem transmite en esa ranura con probabilidad p/256; si falla, espera una ranura más y vuelve a tirar.

Rango 1–255, por omisión 63 (≈ 24,6 % por ranura libre, el valor convencional de AX.25).

Por qué la aleatoriedad. Si todas las estaciones activasen el PTT en el instante en que el canal queda en silencio, todas las que estuvieran esperando colisionarían exactamente en el mismo momento — y cuantas más esperasen, peor la colisión. Tirar los dados separa esas activaciones en el tiempo sin ninguna coordinación entre estaciones.

Valor	Comportamiento
255	Transmite en la primera ranura libre, siempre. Equivale al CSMA no persistente sencillo. Apropiado sólo donde uno es el único transmisor.
128	~50 % por ranura. Asertivo; sensato en un canal poco usado donde importa la latencia.
63	~25 % por ranura. El estándar. Correcto para prácticamente cualquier canal APRS compartido.
20–32	~8–12 %. Para un canal urbano muy congestionado, o para una estación que debe ceder ante las demás (una baliza de telemetría de baja prioridad, un digi de relleno en una zona saturada).
1	~0,4 %. La estación esperará muchísimo por cada transmisión.

Antiinanición. Una tirada fallida con el canal libre no dice nada del canal, así que el planificador no deja que retenga una trama para siempre: tras ocho ranuras libres consecutivas con la tirada fallida, transmite de todos modos. Así, incluso una persistencia muy baja tiene un retardo de peor caso acotado en vez de ilimitado. Una ranura ocupada reinicia la cuenta. Esperar a que se libere un canal ocupado es otra cosa — para eso existe el CSMA — y lo acota por separado Espera máx. con canal ocupado, más abajo.

Advertencia

El 0 se rechaza y se lleva a 1 en lugar de aceptarse, porque una persistencia de 0 significaría que la tirada nunca puede acertar y la estación no volvería a transmitir jamás: un modo de fallo que se parece exactamente a un hardware averiado.

Advertencia

Subir la persistencia no hace que sus paquetes atraviesen un canal ocupado; hace que colisionen en un canal ocupado, lo que cuesta tiempo de aire a todos y no entrega nada. Si sus paquetes no llegan a un digipeater, la respuesta es más preámbulo, mejores niveles de audio o mejor antena, no una p más alta.

Ranura de tiempo CSMA (ms)#

Qué es. El SlotTime estándar de AX.25/KISS: el intervalo entre una tirada de persistencia y la siguiente con el canal libre, y entre una comprobación de un canal ocupado y la siguiente. Empieza a contar una vez transcurrido el tiempo de silencio fijado en Intervalo de tiempo TX.

Rango 10–2550 ms, por omisión 100 ms. El rango es lo que puede expresar un byte de SlotTime de KISS. Con la persistencia por omisión de 63, un canal libre se toma en promedio tras unas cuatro ranuras; una ranura más larga separa más a las estaciones que compiten, a costa de latencia en cada trama.

Ejemplos.

Cualquier canal APRS compartido de 1200 Bd → mantenga 100 ms. Casi con seguridad todos los demás TNC del canal usan el mismo valor.
Enlace dedicado de 9600 Bd donde usted es el único transmisor → 10 ms junto con persistencia 255.

Espera máx. con canal ocupado (s, 0 = sin límite)#

Qué es. Cuánto espera una trama encolada a que se libere un canal ocupado antes de transmitirse igualmente por encima de la señal, contado desde la primera ranura que encontró la detección de portadora activa. 0 espera mientras el canal siga ocupado, que es lo que hace un TNC KISS estándar.

Rango 0–600 s, por omisión 30 s. Un paquete APRS junto con todos sus digipetidos mantiene el canal ocupado unos pocos segundos, así que el valor por omisión sólo actúa cuando el canal lleva ocupado mucho más de lo que explica el uso normal: una portadora trabada, una señal continua de voz o datos en la frecuencia. Cada vez que actúa sube la primera cifra de CSMA FORZADO (OCUP./PERSIST.) en el panel y se registra un aviso con el tiempo esperado.

Ejemplos.

IGate o digipetidor doméstico en la frecuencia APRS nacional → mantenga 30 s.
Frecuencia compartida con transmisiones largas de voz o datos sobre las que nunca debe hablar → 0. Una trama espera entonces lo que haga falta, y una portadora permanente retiene la cola de transmisión hasta que desaparezca.
Estación que debe sacar un mensaje incluso a través de interferencia → 10 s.

Nota

La detección de portadora se borra siempre que el receptor deja de demodular: al cerrarse el Umbral de recepción y, en half duplex, después de cada transmisión propia. Así un canal que quedó en silencio se ve siempre libre, y este límite sólo mide señal real en la frecuencia.

Demodulador de recepción#

Este grupo de campos configura la cadena de recepción: qué demoduladores trabajan sobre el audio, cómo se filtra su entrada, cuándo se los alimenta y cómo se fija la ganancia. Todos los campos se aplican en vivo al Guardar. Cuando cambia algo de aquí distinto de la Reparación de bits, la modulación o la Entrada de audio plana / de discriminador, los demoduladores se reconstruyen con la tarea de recepción detenida — una trama que llegue en ese instante se pierde — y las estadísticas de recepción que muestra NIVEL RX vuelven a cero; guardar la página sin cambiar esos ajustes no toca la recepción. La reconstrucción también reinicia la cola de transmisión: una trama que ya esté en el aire puede terminar primero (hasta seis segundos; después se corta), las tramas que aún esperaban salir se descartan y el registro informa cuántas, y no se encola ni se recibe nada nuevo hasta que termina. La PRUEBA DE LAZO reconstruye dos veces, al pasar a dúplex completo y al volver.

Juego de demoduladores#

Qué es. Cuántos demoduladores de 1200 Bd trabajan en paralelo y qué prefiltro pasabanda recibe cada uno. Todos ven las mismas muestras; entrega la trama el primero que la completa, y las copias de los demás se descartan comparando su FCS.

Cada prefiltro diseñado tiene una inclinación: su ganancia en el tono de espacio (2200 Hz en Bell 202) menos su ganancia en el tono de marca (1200 Hz). Las estaciones en el aire difieren mucho en cuánto más fuerte llega un tono que el otro — preénfasis en el transmisor, salida deenfatizada del receptor, cadenas de audio con su propia pendiente — y un solo prefiltro sólo absorbe parte de ese rango. Un juego de prefiltros con inclinaciones distintas lo cubre entre todos.

Preajuste	Demoduladores	Inclinaciones, entrada plana	Inclinaciones, entrada de altavoz
Clásico (2, filtros fijos)	2	pasabanda fijo plano de 8 coeficientes + sin filtro	pasabanda fijo de 8 coeficientes (+9,5 dB) + sin filtro
1 filtro	1	0 dB	+3 dB
2 filtros	2	0, −5 dB	0, +5 dB
3 filtros	3	+4, 0, −5 dB	0, +3, +6 dB
Multicomparador (por omisión)	12	prefiltros +13, +4, −5, −13 dB; compensación +16,5 … −16,5 dB	igual que la entrada plana
Multicomparador, 2 filtros (comparación)	12	prefiltros +9, −9 dB; compensación +16,5 … −16,5 dB	igual que la entrada plana
Personalizado	Personalizado: demoduladores	campos Personalizado: inclinación	campos Personalizado: inclinación

Cómo elegir. Mantenga Multicomparador. Usa cuatro prefiltros, con inclinaciones de +13, +4, −5 y −13 dB, cada uno leído por tres umbrales de decisión. Cada umbral (peso del comparador) se calcula a partir de la inclinación que su prefiltro alcanzó de verdad, así que los doce demoduladores juntos compensan el desbalance en pasos parejos de 3 dB desde +16,5 hasta −16,5 dB — la columna de compensación de arriba, inclinación del prefiltro más peso del comparador — cualquiera sea la Longitud del pasabanda. Ese rango abarca el desbalance del audio de discriminador (hasta unos 12 dB de tono de 2200 Hz de más por un transmisor con preénfasis) y el del audio de altavoz (el tono de 2200 Hz hasta unos 15 dB por debajo) por igual, de modo que los multicomparadores usan las mismas tablas diga lo que diga Entrada de audio plana / discriminador, y una estación oye igual de bien una mezcla de ambos tipos de señal. Los prefiltros inclinados impiden que un tono fuerte se filtre en el correlador del otro tono, algo que ningún umbral puede deshacer, y mantienen cada umbral a menos de unos 3,5 dB del neutro, más allá de lo cual un umbral pierde sensibilidad con señales débiles. Corre doce decodificadores HDLC; las cifras DSP de NIVEL RX muestran la carga que ponen sobre la tarea de recepción.

En una simulación en PC de la propia cadena de recepción del firmware (audio_test/rx_replay) sobre un canal con ruido, el juego decodifica casi todas las tramas desde −18 dB (tono de espacio por debajo del de marca) hasta +12 dB de desbalance con 12 dB de SNR en banda, y con 9 dB sigue decodificando la mayoría de las tramas entre −15 y +12 dB de desbalance, sea cual sea el tipo de audio que las trae. Las estadísticas de NIVEL RX muestran lo que aporta cada demodulador en su propio canal, y el registro lista la compensación efectiva de cada uno cada vez que se reconstruye el juego.

Multicomparador, 2 filtros corre los mismos doce comparadores sobre el mismo rango con dos prefiltros, seis comparadores cada uno. Sus comparadores de los extremos llevan pesos de hasta unos ±8 dB, así que en simulación queda detrás del juego de cuatro prefiltros con señales débiles. Está para comparar las dos disposiciones en su propia estación sin volver a grabar el firmware — cambie, guarde y compare las estadísticas de NIVEL RX — y es lo que audio_test/rx_diag.py alterna en el equipo.

Personalizado: demoduladores y Personalizado: inclinación, demodulador 1–3 (dB) sólo se aplican al preajuste Personalizado: el número de demoduladores (1–3) y la inclinación de cada uno, de −9 a +9 dB.

Borde inferior, borde superior y longitud del pasabanda#

Los prefiltros diseñados dejan pasar la banda entre el Borde inferior del pasabanda (600–1100 Hz, por omisión 900 Hz) y el Borde superior del pasabanda (2300–3000 Hz, por omisión 2600 Hz). Un borde inferior más bajo deja pasar más CTCSS y zumbido; un borde superior más alto deja pasar más del ruido que una salida de discriminador lleva por encima de los tonos.

La Longitud del pasabanda (9–31 coeficientes, por omisión 31, siempre impar) fija lo nítidos que son los bordes y cuánta de la inclinación pedida se alcanza de verdad: 21 coeficientes dan unas tres cuartas partes, 31 casi toda, y 31 coeficientes rechazan el zumbido y el CTCSS unos 30 dB más. El juego Multicomparador compensa un prefiltro más corto con los pesos de sus comparadores, pero los extremos de su rango dependen de que la inclinación esté. La inclinación real de cada prefiltro se escribe en el registro cada vez que se reconstruyen los demoduladores.

Nota

Una configuración guardada antes de que 31 fuera el valor por omisión conserva el suyo. Ponga 31 aquí y guarde.

Umbral de recepción (mV RMS, 0 = apagado)#

Qué es. Un umbral de nivel delante de los demoduladores, comparado con el nivel de la banda de tonos — los 900–2600 Hz que ocupan los tonos, la cifra tonos de NIVEL RX —, así que el zumbido, el CTCSS o los graves de una salida de altavoz no lo abren ni lo mantienen abierto. Se alimenta a los demoduladores mientras ese nivel se ha mantenido por encima del umbral durante unos cuantos bloques de 20 ms y hasta que cae por debajo de la mitad. Los bloques recibidos mientras el umbral decidía abrirse se guardan y se demodulan primero, así que el comienzo de una transmisión sigue llegando a los demoduladores. Rango 0–50 mV, por omisión 0 (apagado).

Al cerrarse el umbral se borra la detección de portadora de todos los demoduladores, porque ya no les llega audio que la deje decaer; un falso enganche sobre el ruido del final de una transmisión nunca sobrevive al cierre.

Cómo elegir. Déjelo en 0. Cualquier umbral descarta también las estaciones cuyo nivel en la banda de tonos queda por debajo de él, y esas suelen seguir siendo decodificables: reproduciendo en una PC la pista de 40 minutos con deénfasis de WA8LMF a través de los propios demoduladores del firmware (audio_test/rx_replay), un umbral de 10 mV pierde alrededor de un quinto de las tramas que se decodifican con el umbral apagado. Si el squelch de la radio corta el audio entre transmisiones, tampoco hay nada que filtrar. Fije un umbral, un poco por encima de la cifra tonos de NIVEL RX en reposo, solo cuando la entrada trae ruido en reposo que mantiene el canal ocupado entre transmisiones.

Nota

Una configuración guardada con un umbral de recepción conserva su valor. Ponga 0 aquí y guarde.

Pasa-altos (rechazo de CTCSS)#

Un pasa-altos Butterworth de cuarto orden a 150, 300, 400, 600 u 800 Hz delante de los demoduladores de los perfiles AFSK, 300 Hz por omisión; cae 24 dB por octava por debajo de su frecuencia de corte, así que a 300 Hz un tono CTCSS de 100 Hz queda 38 dB abajo mientras los tonos pierden menos de 0,1 dB. Una salida de discriminador lleva el tono CTCSS a nivel completo, y una salida de altavoz deenfatizada lleva graves muy por encima del nivel de los tonos — el deénfasis levanta todo lo que está por debajo de los tonos 6 dB por octava. Los prefiltros diseñados rechazan ambos dentro de los demoduladores, pero el pasa-altos va antes de la ganancia automática, así que la ganancia sigue a los tonos y no a los graves, y cubre el juego Clásico, cuyo segundo demodulador no tiene prefiltro. 600 y 800 Hz cortan además los graves de 400–800 Hz de una salida de altavoz que el borde inferior de los prefiltros deja pasar; se llevan parte de la energía del tono de marca, y en simulación 800 Hz cuesta alrededor de una quinta parte de las tramas débiles con audio plano, así que resérvelos para audio de altavoz. Apague el pasa-altos solo con un receptor cuyo audio esté limpio por debajo de 300 Hz y un juego que no necesite quitar nada ahí.

Nota

Una configuración guardada cuando el pasa-altos venía apagado por omisión conserva Apagado. Elija 300 Hz aquí y guarde.

Ganancia de recepción y Ganancia fija de recepción (dB)#

Automática (por omisión) sigue el nivel de cada transmisión sobre la señal dentro de banda: baja la ganancia rápido ante una fuerte y la sube despacio ante una débil, entre −20 y +18 dB. Mide toda la banda diezmada, graves incluidos, así que una salida de parlante con muchos graves mantiene la ganancia lo bastante baja como para no llevar la entrada del demodulador a su recorte. Solo una entrada por debajo de unos 3,3 mV RMS en el pin — el propio ruido del conversor — deja la ganancia donde está; cualquier cosa por encima se lleva al nivel de trabajo sea cual sea la ganancia, porque los demoduladores pierden precisión con una entrada de apenas unas cuentas. Con Umbral de recepción en 0 la ganancia sube despacio en un canal libre y vuelve a bajar en pocos bloques cuando empieza una transmisión. Fija aplica en su lugar la Ganancia fija de recepción (−12 a +18 dB).

Un puerto de datos o de discriminador entrega un nivel fijado por la desviación del transmisor, no por la intensidad de la señal recibida, así que le conviene una ganancia fija: ajuste primero el potenciómetro de recepción con NIVEL RX y después elija la ganancia que mantenga la cifra del AGC cerca de la que alcanza el modo automático.

Reparación de bits#

Qué es. Una segunda oportunidad para una trama cuyo FCS no coincide. Un símbolo corrige un símbolo dañado — dos bits de datos contiguos tras el decodificado NRZI, que es lo que produce una sola decisión de símbolo errónea; Un símbolo o un bit corrige además un bit aislado. La corrección trabaja sobre el síndrome del CRC, cuesta una pasada por la trama y sólo se acepta cuando exactamente un candidato explica el error y la trama reparada supera una comprobación APRS estricta: caracteres de indicativo válidos en cada dirección, campo de control UI, PID sin capa 3 y ningún carácter de control distinto de CR y LF en el campo de información. No se intenta ninguna reparación mientras otro demodulador acaba de entregar la misma trama intacta.

Cómo elegir. Apagado por omisión. Todo método de reparación acepta una pequeña proporción de tramas mal corregidas, y una trama mal corregida se entrega igualmente: un IGate la reenvía a APRS-IS y un digipetidor la retransmite. Actívelo en un monitor sólo de recepción, o para medir lo que aportaría; las estadísticas de NIVEL RX cuentan aparte las tramas reparadas.

Supresor de impulsos#

Qué es. Un filtro sobre las muestras crudas del ADC de los perfiles AFSK, antes que todo lo demás en la cadena de recepción. Mientras su radio Wi-Fi está activa, el ADC del ESP32 capta picos breves, en ráfagas que se repiten con el intervalo de balizas Wi-Fi (cada 102,4 ms), tanto si la placa funciona como punto de acceso como si funciona como estación. Cada pico dura una o dos conversiones, pero el filtro de diezmado lo reparte por toda la banda de tonos, donde tiene fuerza suficiente para corromper los bits que caen debajo; como cada paquete recibe varias ráfagas, sin él las señales débiles y medias se perderían casi por completo. El supresor compara cada muestra con la mediana de las dos muestras a cada lado. A 76,8 kHz el audio real apenas cambia entre conversiones, así que una muestra lejos de esa mediana es un pico; se reemplaza por una interpolación a partir de las vecinas limpias.

Cómo elegir. Activado por omisión; déjelo activado. Con una entrada limpia no reemplaza nada, y las estadísticas de NIVEL RX cuentan las muestras que reemplazó, así que su trabajo queda a la vista. Desactivarlo sólo sirve para medir lo que recupera.

Interfaz de audio#

Este conjunto describe lo que hay eléctricamente entre los pines del ESP32 y el transceptor. Los valores por omisión corresponden a una placa de interfaz que lleva su propia red de polarización, atenuadores y filtro de reconstrucción — el diseño que muestran los esquemáticos del proyecto. Los ajustes de aquí son lo que necesita, en cambio, una interfaz reducida a un condensador de acoplo y un ajuste de nivel por sentido.

Polarización interna de la entrada del ADC#

Qué es. El ADC del ESP32 mide una tensión entre 0 V y unos 3,1 V. El audio es una señal que oscila en positivo y en negativo alrededor de cero, así que debe elevarse hasta el centro de ese rango antes de poder muestrearse; de lo contrario, la mitad negativa se pierde sin más. Esa elevación se llama polarización.

Apagado (por omisión) — la placa de interfaz proporciona la polarización, normalmente con dos resistencias formando un divisor en el pin del ADC. Es lo que muestran los esquemáticos del proyecto.
Activado — el firmware habilita las resistencias internas de pull-up y pull-down del pad del ADC, que juntas llevan el pin a aproximadamente la mitad de la alimentación. Es lo que necesita una entrada acoplada únicamente a través de un condensador.

Cuándo activarlo. Ha construido una interfaz mínima: un condensador desde la salida de altavoz de la radio (a través de un ajuste de nivel) directamente al pin del ADC, sin resistencias de polarización propias. Ejecute NIVEL RX: si el DC informado está cerca de 0 mV o cerca del raíl de alimentación en vez de alrededor de 1500–1600 mV, la entrada no está polarizada y este es el interruptor que lo arregla.

Advertencia

Limitación de hardware. Las resistencias internas sólo existen en GPIO32 y GPIO33. Si el firmware se compiló con el ADC en GPIO34–GPIO39 — que son pads sólo de entrada sin resistencia de pull alguna — activar esto registra un error y no cambia nada. Una entrada así sólo puede polarizarse externamente.

Advertencia

No lo active cuando la placa de interfaz ya fija la polarización. Las resistencias internas son débiles pero no despreciables, y cargan el divisor externo, desplazando el punto de trabajo y reduciendo la excursión útil. Si usa la placa de interfaz del proyecto, deje esto apagado.

Avisar cuando el audio recibido se sale de rango#

Qué es. Un diagnóstico. Con él activo, el firmware registra un aviso siempre que los resultados de conversión en bruto de un bloque procesado alcanzan alguno de los extremos del rango del conversor (muestra mínima en o por debajo del código 15, o máxima en o por encima del 4080, sobre 0–4095), como mucho una vez cada cinco segundos para que un problema sostenido no inunde la consola. El aviso cita el mínimo y el máximo en bruto del bloque.

Apagado por omisión, porque en una interfaz bien construida no debería dispararse nunca y la comprobación no cuesta nada cuando está deshabilitada.

Cuándo activarlo.

Mientras ajusta por primera vez el nivel de recepción — combínelo con la página Registros para ver los avisos según ocurren.
De forma permanente, en una interfaz sin diodos de recorte en la entrada. Allí, una lectura fuera de rango no significa sólo «demasiado fuerte»: significa que el pin se está excitando más allá de los raíles de alimentación, lo que es un camino para dañar el ESP32.
Cuando una estación decodifica bien a volumen moderado y deja de decodificar al subir el volumen de la radio — la firma clásica del recorte.

Advertencia

El audio recortado no suena roto al oído humano, pero una forma de onda AFSK recortada pierde la relación de amplitud de la que depende el demodulador. Una estación con este problema suele decodificar peor a las estaciones fuertes que a las débiles, algo tan contraintuitivo que hay quien cambia de antena por ello.

Amplitud de salida de transmisión (%)#

Qué es. La amplitud pico a pico del audio de transmisión, como porcentaje del rango completo de 0–3,3 V del DAC. Internamente, cada muestra se escala alrededor del código medio del DAC antes de escribirse, de modo que el tono sigue centrado sea cual sea el porcentaje.

Rango 20–100 %, por omisión 60 %. Se aplica en vivo, y en la siguiente muestra: no hay que detener el modulador.

Por qué el suelo es el 20 %. El DAC del ESP32 es de 8 bits. El porcentaje decide con cuántos de sus 256 códigos se dibuja realmente un periodo de la senoide: al 20 % un periodo completo abarca unos 50 códigos, y por debajo de eso la cuantización convierte el tono en una escalera visible cuyos armónicos caen dentro de la banda de audio y degradan la desviación que ve el receptor. Los 30–40 dB de atenuación que necesita una entrada de micrófono corresponden a un atenuador resistivo externo, no a este campo.

Cómo ajustarlo. Use el botón PRUEBA TX con un medidor de desviación, otro receptor o un SDR sobre la señal transmitida, y ajuste para 2,5–3,5 kHz de desviación en un canal de FM de 5 kHz de desviación. Si no consigue bajar lo suficiente al 20 %, añada o aumente el atenuador externo. Si no consigue subir lo suficiente al 100 %, el atenuador es demasiado agresivo.

Advertencia

La sobredesviación es el fallo de transmisión más común en APRS. Salpica al canal adyacente y —porque el discriminador del receptor recorta— el paquete a menudo decodifica peor en el extremo lejano de lo que lo habría hecho con la desviación correcta. Más fuerte no es mejor.

Advertencia

La subdesviación es un fallo igual de real: la trama queda enterrada en el suelo de ruido del receptor y sólo la decodifican estaciones muy cercanas. Si le oye el digipeater de enfrente y nadie más, mida su desviación antes de culpar a la propagación.

Frecuencia de muestreo de transmisión#

Qué es. La frecuencia a la que el DAC genera la forma de onda de transmisión: 38400 Hz (por omisión) o 76800 Hz.

Ambas son múltiplos exactos de 1200 y 9600, lo cual es un requisito estricto: el modulador deriva su temporización de símbolo por división entera, así que una frecuencia que no sea múltiplo de ambas desincroniza una velocidad u otra. Un valor fuera de estas dos recae en la frecuencia estándar en lugar de guardarse y ser rechazado más tarde.

Qué aporta la frecuencia más alta. Cualquier salida muestreada arrastra imágenes de reconstrucción: copias de la señal deseada reflejadas alrededor de los múltiplos de la frecuencia de muestreo. Duplicar la frecuencia aleja esas imágenes una octava más, donde un filtro mucho más suave — o el propio ancho de banda de audio del transmisor — puede eliminarlas.

Cuándo elegir 76800 Hz.

La placa de interfaz no lleva filtro de reconstrucción: el pin del DAC va por un condensador y un ajuste directamente a la radio.
Observa audio espurio inexplicable, un tono transmitido de sonido áspero o un receptor descontento en un montaje por lo demás correcto.

Cuándo quedarse en 38400 Hz.

La interfaz tiene un filtro paso bajo adecuado después del DAC, que es lo que muestran los esquemáticos del proyecto.
El margen de CPU es escaso: la frecuencia más alta duplica la carga de interrupciones del DAC, y en una estación que además ejecuta el IGate, la administración web, Telegram y el sondeo de sensores esa carga no es gratis.

Advertencia

Este ajuste surte efecto sólo tras un reinicio. El formulario muestra el valor guardado, que es el que usará el próximo arranque; hasta entonces el módem sigue transmitiendo a la frecuencia con la que se inició.

Tiempo máximo de transmisión (ms)#

Qué es. Un perro guardián de seguridad sobre una única activación. Si el transmisor lleva activado de forma continua más tiempo que este, el firmware libera el PTT, aborta la trama en curso, vacía el FIFO del modulador y registra un error.

Rango 0–60000 ms. 0 deshabilita el límite — y 0 es el valor por omisión.

Por qué existe. No es un planificador ni un control de ciclo de trabajo. Existe para el caso en que el camino de transmisión se ha atascado: una tarea que nunca termina, una máquina de estados del módem encallada a mitad de trama, un fallo que de otro modo dejaría una portadora en el aire hasta que alguien se dé cuenta. En una estación desatendida en la cima de una montaña, esa es la diferencia entre una mala hora y una frecuencia bloqueada más un coordinador enfadado.

Cómo elegir un valor. Calcule la activación más larga que esta estación puede producir legítimamente y deje un margen generoso por encima. Ese peor caso es el preámbulo máximo más una trama de longitud máxima a la velocidad más lenta en uso: unos segundos a 1200 Bd, más con la redundancia de FX.25. Ajustes prácticos:

5000–10000 ms para una estación de 1200 Bd con preámbulo de 300 ms. Muy por encima de cualquier transmisión real y muy por debajo de lo que alguien llamaría una portadora atascada.
15000–20000 ms para una estación de HF a 300 Bd, donde las tramas son realmente largas.
0 en un montaje de banco de pruebas donde prefiera ver ocurrir un fallo antes que verlo limpiado a sus espaldas.

Advertencia

Ajustarlo cerca de la duración de una transmisión real corta tramas reales. La estación parecerá transmitir basura que nadie decodifica, y el registro mostrará el límite disparándose repetidamente. Si ve ese mensaje, el ajuste es demasiado bajo, no la radio está rota.

Truco

Activar esto es muy recomendable en cualquier estación que se deje desatendida, especialmente con amplificador. No cuesta nada cuando nada va mal.

Los tres botones de diagnóstico#

Los tres están junto a la casilla Activar módem ADC/DAC de audio. Los tres guardan primero el formulario, así que lo que se prueba es siempre lo que hay en pantalla. Los tres son rutas POST, deliberadamente: dos de ellos activan el transmisor, y la comprobación de mismo origen que protege esta administración se aplica sólo a POST — una ruta GET aquí podría dispararse desde cualquier otra página que un operador autenticado tuviera abierta, sin más que apuntarle una etiqueta de imagen.

Sólo uno de los tres puede ejecutarse a la vez; una segunda petición se rechaza con un mensaje claro en lugar de encolarse.

PRUEBA DE BUCLE#

Qué hace. Construye una pequeña trama de estado APRS con un testigo aleatorio de un solo uso y el indicativo propio de la estación como origen (<indicativo>>APLT1T:>LOOPTEST <testigo>), desvía las tramas decodificadas a un gancho privado propio para que la trama de prueba no se digipitee ni se suba nunca a APRS-IS, conmuta el módem a dúplex completo mientras dura, modula la trama en la salida del DAC y espera hasta 4 segundos a que la cadena ADC / demodulador / decodificador le devuelva la misma trama. El gancho real y el modo dúplex configurado se restauran sea cual sea el resultado.

El origen es el indicativo y SSID del IGate, o el del digipetidor si el del IGate no está configurado. Si no hay ninguno (NOCALL o vacío), la prueba se niega a ejecutarse y lo indica.

El transmisor nunca se activa. Durante toda la prueba la línea PTT se mantiene en su nivel de reposo: la trama se modula y se emite igual que siempre, pero un transceptor que siga conectado a la salida PTT permanece en recepción. La prueba además toma el transmisor para sí: lo que ya estuviera en cola antes de empezar sale primero con normalidad, en semidúplex y con PTT (si eso tarda más de 5 segundos la prueba desiste con un mensaje), y mientras dura se rechaza cualquier otra transmisión — balizas, mensajes, retransmisiones del IGate —, contabilizada como RF TX held off by LOOP TEST en el Drop Breakdown del panel. Los informes periódicos vuelven a salir en su siguiente intervalo y los mensajes en su siguiente reintento.

Antes de emitir espera hasta 3 segundos a que el canal quede en silencio, para que una estación real que se oiga en la entrada de audio no cause un fallo espurio. Si el canal no se libera nunca, emite igualmente en vez de quedarse colgado.

Qué requiere. Un bucle de audio físico: el pin del DAC cableado al pin del ADC (a través de los atenuadores de la propia placa de interfaz, o directamente), con masa común. También puede ejecutarse a través de un transceptor en dúplex completo real, o mediante una radio que se escuche a sí misma en otra radio, pero en su forma normal es una prueba de banco de la placa, no de la radio.

Advertencia

El dúplex completo se fuerza durante la prueba porque un bucle de cable hace que el módem oiga permanentemente su propia portadora, y CSMA no encontraría nunca un canal libre. Es una anulación deliberada y temporal, y es la razón por la que el PTT queda inhibido y toda otra transmisión se retiene mientras dura. El audio sigue apareciendo en la salida del DAC, así que un transceptor que se active solo con el audio (VOX) lo transmitiría igualmente: desactive el VOX, o desconecte la radio, antes de ejecutar la prueba.

Cómo leer un PASS. Un resultado correcto informa del nivel de RX en mV RMS, de la excursión del ADC en bruto con los raíles del conversor (0/4095) como referencia, y de la ganancia de pico del AGC. Esos números importan tanto como la palabra PASS: una excursión sana y centrada debería quedarse bastante lejos de cualquiera de los raíles. Un PASS con la excursión casi tocando 0 o 4095 significa que está decodificando y recortando, y dejará de decodificar en cuanto algo suba de nivel.

Una coincidencia de testigo por sí sola no se acepta como PASS. La ejecución debe haber capturado además al menos 50 cuentas de excursión real del ADC y un nivel de RX no nulo, de modo que nunca pueda informarse un PASS sobre un bucle abierto, una entrada flotante o una decodificación rancia de otra procedencia.

Cómo leer un FAIL. Los mensajes de fallo están graduados y cada uno apunta a una parte distinta de la cadena:

Qué informa	Qué significa
El ADC no entregó ni una sola muestra	El driver continuo del ADC o su temporizador no están funcionando. Un fallo de inicialización, no un problema de cableado ni de nivel. Reinicie; si persiste, la compilación o la asignación de pines es incorrecta.
Muestrea, pero el código en bruto apenas se movió	El ADC está vivo pero no ve ningún tono. El cable de bucle falta, está roto, o las masas no son comunes. El desplazamiento de continua informado dice más: una línea clavada cerca del raíl apunta a un cortocircuito o a un cableado equivocado.
Llegó una señal real, pero ningún demodulador se enganchó	El tono llega al ADC pero el correlador/PLL no logra interpretarlo. Compruebe que Modulación coincide con lo transmitido y pruebe el juego de demoduladores Multicomparador — un bucle directo DAC-a-ADC nunca pasa por la red de deénfasis de una radio real, así que sus tonos llegan sin desbalance. El informe indica el número de demoduladores y la inclinación de cada prefiltro. Si la ganancia del AGC nunca subió por encima de la unidad, el problema está en el camino del AGC y no en la velocidad en baudios.
El PLL se enganchó, pero no volvió ninguna trama válida	El mensaje informa de hasta dónde llegó la máquina de estados HDLC: no empezar nunca una trama apunta a la recuperación de bits; empezar tramas que fallan el CRC apunta a un nivel o una SNR marginales antes que a un desajuste de modulación.
Volvió una trama, pero no coincidía	Distorsión de audio, recorte, o un bucle que está captando algo distinto de la propia transmisión de esta estación.

NIVEL RX#

Qué hace. Observa la etapa de entrada de recepción durante un segundo aproximadamente e informa de lo que vio. No transmite nada y no toca ningún estado del módem, de modo que —al contrario que la prueba de bucle— puede ejecutarse con el transceptor conectado, la antena arriba y tráfico real decodificándose. La página se guarda antes sólo cuando algún campo difiere de lo último cargado o guardado, así que pulsarlo varias veces no escribe en la flash ni perturba la recepción.

Esta es la medida contra la que se ajusta el lado de recepción de la interfaz de audio.

Campo	Cómo leerlo
`nivel`	Veredicto en una palabra. saturado (rojo): los extremos en bruto llegaron a los límites del conversor — baje el nivel de recepción. sin señal: ningún demodulador detectó portadora durante la ventana, así que no hay nada que juzgar; púlselo de nuevo mientras llega un paquete. bajo (naranja): hubo portadora pero los tonos no pasaron de 20 mV RMS, demasiado cerca del ruido propio del ADC del ESP32 — suba el nivel de recepción. bueno (verde): tonos de 20 mV RMS o más sin salirse de rango.
`tonos`	Nivel RMS medio y de pico de la banda de tonos, 900–2600 Hz, en el pin del ADC. Es con lo que trabajan de verdad los demoduladores, y la cifra con la que ajustar el nivel de recepción.
`mVrms` / `peak`	Nivel de audio de banda ancha medio y de pico en la ventana. Con la radio sin squelch en un canal inactivo está leyendo ruido; con un paquete llegando está leyendo señal. Mucho más alto que `tonos` significa que la mayor parte de la entrada está fuera de los tonos — zumbido, CTCSS o los graves de una salida de altavoz deenfatizada.
`DC`	Dónde está polarizada la entrada. Debería situarse cerca del centro del rango del conversor, alrededor de 1500–1600 mV. Cerca de 0 mV o del raíl significa que la entrada no está polarizada — véase Polarización interna de la entrada del ADC.
`AGC`	La ganancia automática que aplica el módem. Una ganancia que se queda en 1,00x con señal real significa que la entrada ya está en el objetivo o por encima. Una ganancia muy grande significa que la señal es demasiado floja y el módem está amplificando ruido junto con ella.
`raw`	Los extremos de conversión en bruto en toda la ventana, frente a raíles de 0 y 4095. Este es su margen de recorte: llegar a 0 o a 4095 es salirse de rango.
`DCD`	Si algún demodulador estuvo enganchado durante la ventana. `sí` mientras llega un paquete es exactamente lo correcto; `sí` en un canal en silencio apunta a una entrada ruidosa o a un enganche falso.

La lectura incluye además las estadísticas de recepción, reunidas desde el último cambio del juego de demoduladores:

Campo	Cómo leerlo
`decodificados`	Tramas con FCS válido producidas por cada demodulador, duplicados incluidos. Cifras parecidas indican que los demoduladores coinciden.
`exclusivos`	Tramas que produjo un solo demodulador. Es lo que cada prefiltro aporta al juego; un demodulador que se queda en 0 durante mucho tráfico real no aporta nada en este canal.
`entregados`	Tramas entregadas tras la supresión de duplicados.
`reparados`	Tramas entregadas que necesitaron Reparación de bits.
`muestras perdidas`	Muestras descartadas porque la FIFO de recepción estaba llena, y desbordamientos del búfer del controlador del ADC. Ambas deben quedar en 0; cualquier otro valor indica que la tarea de recepción no da abasto (reloj de CPU por debajo de 240 MHz, u otra tarea que la acapara). Cada pérdida se informa además en la consola, como mucho una vez por minuto, como `RX samples lost`.
`DSP`	Carga del DSP de recepción: el tiempo que la tarea de recepción dedica a cada bloque de 20 ms de audio, como fracción de esos 20 ms. Media y pico en la ventana de medida, y el bloque más alto desde el último reinicio de las estadísticas. Incluye el tiempo que otras tareas del mismo núcleo ocupan mientras se procesa un bloque, así que es la cifra que decide si el receptor da abasto: un pico cerca del 100 % significa que se están por perder muestras.
`impulsos eliminados`	Muestras crudas del ADC que el Supresor de impulsos reemplazó desde el último reinicio de las estadísticas. Sube a saltos mientras la radio Wi-Fi está activa y queda cerca de cero con una entrada limpia.

Procedimiento típico. Quite el squelch de la radio, pulse NIVEL RX y compruebe que el desplazamiento de continua está centrado. Después púlselo mientras llegan paquetes y ajuste el volumen de la radio y el potenciómetro de recepción hasta que el veredicto diga bueno — tonos de al menos 20 mV RMS — sin llegar nunca a saturado. Con una salida de altavoz, guíese por la cifra de tonos y no por la de banda ancha: sus tonos quedan muy por debajo de su nivel total. Después ponga el squelch normal, espere tráfico real y confirme que aparece DCD sí y que el panel muestra decodificaciones.

Truco

Es también la forma más rápida de responder a «¿está siquiera conectada la radio?». Una lectura plana con el contador de muestras atascado dice que el audio no está llegando en absoluto, y ningún ajuste en otro sitio cambiará eso.

PRUEBA TX#

Qué hace. Activa el transmisor, modula una trama corta de estado APRS identificada con el indicativo de la estación (<indicativo>>APLT1T:>TXTEST, el mismo origen que usa el LOOP TEST) y libera el PTT, sin esperar nada de vuelta. Es la contrapartida de transmisión de NIVEL RX: aquello contra lo que se ajusta el nivel de transmisión cuando hay un transceptor conectado en lugar de un bucle de cable.

La ráfaga pasa por el camino normal de acceso al canal: espera canal libre como cualquier otra trama y la retiene el techo de ciclo de trabajo si está activo y ya alcanzado. La página espera a que la ráfaga termine, con un límite de unos tres segundos, para que el resultado signifique algo cuando se lee.

Si tiene éxito, informa de la longitud de preámbulo y de la amplitud de salida usadas, y recuerda el objetivo: mida la desviación con otro equipo y ajuste el potenciómetro de nivel de transmisión para 2,5–3,5 kHz.

Advertencia

Esto pone una señal real en el aire. Antes de pulsarlo, confirme la frecuencia, confirme la antena o la carga artificial y confirme que tiene licencia para transmitir ahí. En un canal APRS compartido, no lo pulse repetidamente mientras ajusta un potenciómetro: use una carga artificial para el ajuste y una única ráfaga en el aire para confirmar.

Si se niega, el mensaje dice por qué: el módem no está activado, no hay indicativo configurado, hay otro diagnóstico en curso, o el camino de acceso al canal descartó la trama — lo que en la práctica significa un techo de ciclo de trabajo ya alcanzado o una cola de transmisión llena. El registro de eventos indica cuál.

Puesta en marcha de una estación nueva, en orden#

Los campos de esta página interactúan, así que hay una secuencia que evita perseguirse la cola.

#	Paso	Notas
1	Marque Activar módem ADC/DAC de audio, Guardar, reinicie.	Nada más de esta página puede probarse hasta que el hardware del módem esté levantado.
2	Ponga Modulación para que coincida con el canal.	1200 Bd Bell 202 para APRS estándar. Si se equivoca aquí, todos los pasos posteriores carecen de sentido.
3	Con los pines del DAC y del ADC unidos en bucle, ejecute PRUEBA DE BUCLE.	Demuestra que la placa funciona de extremo a extremo antes de implicar a una radio. Anote las cifras de excursión, no sólo el PASS.
4	Conecte la radio. Ajuste Entrada de audio plana / de discriminador según el conector que haya usado.	Conector de altavoz → apagado. Puerto de datos/discriminador → activado.
5	Ejecute NIVEL RX y ajuste el potenciómetro de recepción.	Revise primero el desplazamiento de continua; active Polarización interna de la entrada del ADC si la entrada no está polarizada. Después ajuste el nivel para buena excursión con margen.
6	Active Avisar cuando el audio recibido se sale de rango y vigile la página Registros mientras llega tráfico real.	Confirma que no está recortando con las estaciones locales fuertes.
7	Sobre carga artificial, ejecute PRUEBA TX y ajuste Amplitud de salida de transmisión para 2,5–3,5 kHz de desviación.	Añada un atenuador externo si el 20 % sigue siendo demasiado fuerte.
8	Ajuste Preámbulo al comportamiento de PTT de su radio.	300 ms salvo que tenga un motivo. Confirme con un vecino que le están digipiteando.
9	Ajuste Persistencia CSMA e Intervalo de tiempo TX según la congestión del canal.	Los valores por omisión (63 / 2000 ms) son correctos para un canal compartido normal.
10	Active el limitador de ciclo de trabajo y fije el Tiempo máximo de transmisión.	Haga esto antes de dejar la estación desatendida, no después.

Perfiles sugeridos#

Estación	Modulación	Preámbulo	Silencio	Persist.	Buffers	Ciclo	Máx. TX
IGate doméstico, radio portátil, canal compartido	1200 Bell 202	300 ms	2000 ms	63	1	sí, 20 %	8000 ms
Digipeater en cima, red eléctrica + amplificador	1200 Bell 202	400 ms	2000 ms	63	2	sí, 50 %	10000 ms
Digipeater de relleno, canal urbano saturado	1200 Bell 202	300 ms	3000 ms	32	1	sí, 15 %	8000 ms
Tracker / baliza solar	1200 Bell 202	300 ms	2000 ms	63	1	sí, 10 %	8000 ms
Enlace punto a punto dedicado de 9600 Bd	9600 G3RUH	150 ms	0 ms	255	3	no	5000 ms
Pasarela de HF, 300 Bd	300 AFSK	500 ms	3000 ms	63	1	sí, 25 %	20000 ms

Son puntos de partida, no prescripciones. Las cifras de ciclo de trabajo en particular deben conciliarse con las condiciones de su propia licencia.

Referencia de campos#

Campo	Rango	Por omisión	Se aplica
FX.25	apagado / solo recepción / recepción y transmisión	apagado	En vivo
Activar módem ADC/DAC de audio	sí / no	sí	Siguiente reinicio
Modulación	0–3	1 (Bell 202)	En vivo
Entrada de audio plana / de discriminador	sí / no	sí	En vivo
Preámbulo	50–2000 ms	300 ms	En vivo
Intervalo de tiempo TX	0–10000 ms	2000 ms	En vivo
Buffers de TX	1–11	1	En vivo (se lee en cada transmisión)
Limitador de ciclo de trabajo	sí / no	no	En vivo (se lee en cada transmisión)
Límite de ciclo de trabajo	1–100 %	25 %	En vivo (se lee en cada transmisión)
Tiempo mínimo de PTT liberado	0–5000 ms	0	En vivo
Persistencia CSMA	1–255	63	En vivo
Ranura de tiempo CSMA	10–2550 ms	100 ms	En vivo
Espera máx. con canal ocupado	0–600 s (0 = sin límite)	30 s	En vivo
Polarización interna de la entrada del ADC	sí / no	no	En vivo
Avisar cuando el audio recibido se sale de rango	sí / no	no	En vivo
Amplitud de salida de transmisión	20–100 %	60 %	En vivo (siguiente muestra)
Frecuencia de muestreo de transmisión	38400 / 76800 Hz	38400 Hz	Siguiente reinicio
Tiempo máximo de transmisión	0–60000 ms	0 (desactivado)	En vivo
Juego de demoduladores	Clásico / 1 / 2 / 3 filtros / Multicomparador / Multicomparador, 2 filtros / Personalizado	Multicomparador	En vivo
Personalizado: demoduladores	1–3	3	En vivo
Personalizado: inclinación, demodulador 1–3	−9 a +9 dB	+4 / 0 / −5 dB	En vivo
Borde inferior / superior del pasabanda	600–1100 / 2300–3000 Hz	900 / 2600 Hz	En vivo
Longitud del pasabanda	9–31 coeficientes (impar)	31	En vivo
Umbral de recepción	0–50 mV (0 = apagado)	0 (apagado)	En vivo
Pasa-altos (rechazo de CTCSS)	apagado / 150 / 300 / 400 / 600 / 800 Hz	300 Hz	En vivo
Ganancia de recepción	automática / fija	automática	En vivo
Ganancia fija de recepción	−12 a +18 dB	0 dB	En vivo
Reparación de bits	apagado / un símbolo / un símbolo o un bit	apagado	En vivo
Supresor de impulsos	activado / desactivado	activado	En vivo

Cada campo numérico se acota en tres sitios contra las mismas constantes de main/include/aprs_service.h (los campos de Demodulador de recepción contra los límites MODEM_RX_* del componente del módem, mediante modem_rx_tuning_sanitize()): los atributos min/max del propio campo, el manejador que analiza el formulario enviado y el cargador que lee radio.json desde la flash. Un archivo de configuración editado a mano o un POST malformado no pueden, por tanto, poner en servicio un valor fuera de rango.

Lo que deliberadamente no está en esta página#

Varios ajustes que un operador podría esperar aquí no existen, porque el firmware no tiene equivalente en tiempo de ejecución para ellos. Se muestran de sólo lectura, o no se muestran, en lugar de ofrecerse como controles que guardarían en flash sin cambiar nada.

Ajuste ausente	Por qué
Línea de squelch	El firmware no lee ninguna línea de squelch. Su umbral de recepción es un umbral de nivel por software, fijado en Demodulador de recepción; se puede usar además el squelch de la radio, o dejarlo abierto, lo que encaja con el umbral en 0.
Ajuste de volumen de recepción	No hay control de volumen. Fije el nivel con el potenciómetro de la interfaz, guiado por NIVEL RX; hay una ganancia fija de recepción en Demodulador de recepción.
Ganancia máxima del AGC	El AGC se acota a sí mismo; no hay nada que configurar.
Atenuación del ADC	Una constante de compilación (`MODEM_ADC_ATTEN`). Se muestra de sólo lectura.
Pines de audio (ADC/DAC)	Cableado de placa fijado en compilación (`MODEM_ADC_GPIO` / `MODEM_DAC_GPIO`). Se muestra de sólo lectura.
Pin y polaridad de PTT	Cableado de placa fijado en compilación (`MODEM_PTT_GPIO` / `MODEM_PTT_ACTIVE_HIGH`). Se muestra de sólo lectura; el pin está registrado en la tabla de propiedad de GPIO para que ninguna otra función pueda reclamarlo.
Supresión de duplicados	Un único interruptor y un único par de controles para todo el firmware, en la página IGate.

Resolución de problemas#

Síntoma	Dónde mirar
No se decodifica nada, en ninguna dirección	Modulación primero. Después ejecute PRUEBA DE BUCLE sobre un bucle de cable para separar un problema de placa de uno de radio.
PRUEBA DE BUCLE dice que el módem no está activado	Activar módem ADC/DAC de audio está apagado, o se activó sin reiniciar.
Las estaciones locales fuertes decodifican, las débiles nunca	Nivel de recepción demasiado bajo, o Entrada de audio plana / de discriminador puesta al revés. Ejecute NIVEL RX.
Algunas estaciones decodifican siempre y otras con señal parecida nunca	Su desbalance de tonos queda fuera de lo que cubre el juego de demoduladores. Use el juego Multicomparador, o uno Personalizado con inclinaciones más separadas, y compare las cifras por demodulador en NIVEL RX.
A menudo se pierde el primer paquete tras un rato de silencio	El umbral de recepción. Ponga Umbral de recepción en 0, el valor por omisión.
Las estaciones fuertes decodifican, otras más débiles con señal limpia nunca	El umbral de recepción las deja afuera. Ponga Umbral de recepción en 0.
Las estaciones débiles decodifican, las fuertes no	Recorte. Active Avisar cuando el audio recibido se sale de rango, ejecute NIVEL RX y baje el potenciómetro de recepción.
Otras estaciones oyen mi portadora pero sólo decodifican algunas tramas	Preámbulo demasiado corto, o desviación incorrecta. Suba el preámbulo y después mida la desviación con PRUEBA TX.
Nadie me oye en absoluto, pero la radio transmite	Desviación demasiado baja, o el audio de transmisión no llega a la entrada de micrófono. Fije la Amplitud de salida de transmisión contra una medida de desviación.
Las balizas aparecen mucho menos a menudo de lo configurado	El limitador de ciclo de trabajo las está aplazando. Revise el contador de descartes del panel y suba el techo o alargue los intervalos.
Se descartan tramas por acumulación	La estación ofrece más tráfico del que el canal puede transportar. Reduzca lo que transmite antes de subir Buffers de TX.
El registro informa de que se dispara el tiempo máximo de transmisión	Tiempo máximo de transmisión está por debajo de la duración de una transmisión real. Súbalo muy por encima del peor caso.
La frecuencia de muestreo de transmisión guardada no parece aplicarse	Necesita un reinicio. El formulario muestra el valor guardado, no el que está en marcha.

Ver también

El módem por software para los perfiles del módem y la API del componente, La cadena de señal DSP para los caminos de señal de recepción y transmisión, Administración web para la administración en su conjunto, y el capítulo Hardware para los esquemáticos de interfaz que asumen los valores por omisión de esta página.