SDK de telemetría SDRX
Versión 1.0.0 · para integrar estados autorizados de tus receptores modificados.
Descargar biblioteca y ejemplo
Python sin dependencias externas. El paquete contiene código, README, ejemplo y pruebas locales.
Descargar SDK · 9922 bytesSHA-256: cd8191226cb761b82018f423662ac12e3d4a008b4c853bfa35eac6f1b6709060
Verificado en Linux con Python 3.11 y 3.14. No instala agentes ni conecta automáticamente a receptores.
Configurar tu estación
- Crea la contribución y declara sus bandas. Sus nombres deben coincidir exactamente.
- Desde la ficha, emite una clave de telemetría como responsable u owner y guárdala en tu equipo en un archivo privado con permisos 0600.
- Tu software produce un archivo con
observed_atISO8601 con zona ybands, una lista de objetos connameyavailablebooleano. El ejemplo exige una observación menor de 60 s. - Prueba primero
python3 examples/send_from_snapshot.py --snapshot /ruta/estado.json --dry-run. Esta opción no lee claves ni realiza envíos. - Para el envío usa tu UUID real y el archivo privado:
python3 examples/send_from_snapshot.py --snapshot /ruta/estado.json --station UUID_DE_TU_ESTACION --token-file /ruta/privada/telemetry.token.
La clave de estación es distinta del token Cloudflare. No se incluye en el ZIP, la URL ni los argumentos; el ejemplo la lee del archivo privado. No publiques ese archivo.
Contrato de envío
HTTPS verificado · POST /api/station/UUID/telemetry/ · JSON de hasta 16 KiB · tiempo total predeterminado de 8 s. Solo se envían nombres y booleanos de bandas; la respuesta indica observación y caducidad de 300 s.
El SDK no sigue redirecciones ni repite automáticamente un POST incierto. Ante 429, respeta retry_after antes de enviar un snapshot nuevo. Una actualización por minuto queda bajo la cuota individual inicial; se aplica además el límite agregado por red.
401 requiere revisar la clave; 409 indica retirada; 400, bandas o datos inválidos; 413, tamaño; 415, tipo JSON. Los errores no imprimen la clave o el cuerpo remoto.
Esta biblioteca no certifica recepción RF ni configura bandas aprobadas. Los adaptadores nativos OpenWebRX/OpenWebRX+/KiwiSDR se incorporan por separado; este ejemplo parte de estados que produce tu software.