ESP32 LoRa for dummys - TinyGS: Application Programming Interface (API)

Para probar las API de TinyGs puede usar su navegador, pero encontrará que es mas práctico usar cURL un navegador orientado a linea de comandos  (terminal), versiones compiladas apra la mayoria de sistemas operativos las encontrará en static-curl

Para probar la instalación de cURL puede ejecutar curl --help' o 'curl --manual'


Vamos a ver unos cuantos comandos del API de TinyGS (hasta el momento no he localizado el manual):

https://api.tinygs.com/v1/statistics

Lista las estadísticas del sistema

{"members":5919,"packets":16714523,"stations":1677}

https://api.tinygs.com/v1/stations?

Lista todas las estaciones TinyGS  con el siguiente formato (observe que el userID no tiene nada que ver con su usuario de acceso a TinyGS

{
    "name": "MalvaRosa",
    "userId": 5343680049,
    "autoTune": 433,
    "confirmedPackets": 953,
    "lastSeen": 1730394223267,
    "location": [39.48, -0.33],
    "satellite": "Tianqi",
    "status": 1,
    "telemetryPackets": 808,
    "test": false,
    "version": 2403242,
    "lastPacketTime": 1730387686501
  }, 

https://api.tinygs.com/v1/stations?userId=5343680049

Devuelve todas las estaciones de un usuario

[
  {
    "name": "MalvaRosa",
    "userId": 5343680049,
    "autoTune": 433,
    "confirmedPackets": 953,
    "lastSeen": 1730395183291,
    "location": [39.48, -0.33],
    "satellite": "Tianqi",
    "status": 1,
    "telemetryPackets": 808,
    "test": false,
    "version": 2403242,
    "cnt_pckt_conf_433_LoRa": 718,
    "cnt_pckt_tele_433_LoRa": 691,
    "lastPacketTime": 1730387686501,
    "cnt_pckt_conf_137_LoRa": 235,
    "cnt_pckt_tele_137_LoRa": 117
  },
  {
    "name": "MalvaRosa_Test",
    "userId": 5343680049,
    "autoTune": 900,
    "confirmedPackets": 0,
    "lastSeen": 1730395141293,
    "location": [39.48, -0.33],
    "satellite": "PY4-Unknown",
    "status": 1,
    "telemetryPackets": 0,
    "test": false,
    "version": 2403242
  }
] 

https://api.tinygs.com/v1/station/MalvaRosa@5343680049

{
  "name": "MalvaRosa",
  "userId": 5343680049,
  "antennaBand": [90, 2500],
  "autoTune": 433,
  "autoUpdate": true,
  "beta": true,
  "confirmedPackets": 4083,
  "creationDate": 1728812735116,
  "elevation": 11,
  "lastSeen": 1731686791360,
  "local_ip": "192.168.1.47",
  "location": [39.48, -0.33],
  "modem_conf": "",
  "radioStatus": 0,
  "satellite": "ONDOSAT-OWL-1",
  "status": 1,
  "telemetryPackets": 3593,
  "test": false,
  "tx": true,
  "version": 2403242,
  "wifiRssi": -65,
  "recordDistance": 2955.53036241728,
  "frames": 4234,
  "lastPacketTime": 1731682167081,
  "antenna": "Yagi-Uda",
  "description": "137Band: Lilygo ESP32 LoRa433 autotuning  137 & Turnstile\n433Band: Lilygo ESP32 LoRa 433 autotuning  433 & logperiode vertical",
  "pictures": [
    {
      "src": "https://static.tinygs.com/stationImages/TinyGS_MalvaRosa_c89fe.jpg",
      "status": 1,
      "type": "image/jpeg",
      "size": 159128,
      "origName": "20241028_112548.jpg",
      "shortId": "c89fe1d31328cdc7"
    }
  ]
} 

 

https://api.tinygs.com/v1/station/MalvaRosa@5343680049/statistics

Devuelve las estadísticas de un estación concreta TinyGS, en este caso Malvarosa@5343680049(da error)

https://api.tinygs.com/v1/tinygs_supported.txt

Lista lo satélites soportados que pueden ser cargados en aplicaciones como gpredict or Look4Sat 

Norby

1 46494U 20068J   24318.83421293  .00019065  00000-0  81076-3 0  9999

2 46494  97.8346 285.6840 0013552 145.1692 215.0433 15.22993847227170 

https://api.tinygs.com/v1/packets

https://api.tinygs.com/v2/packets

 "packets": [
    {
      "raw": "6/iADOxwPBr4BAzscDoAAEreHhw67t9kQjOPXUOgFAdCgXGNQpZWk+A2QAYAL7cVARgJGgEmDxGMoCsk3gldAABLRgKqBAEAsAEBACQAoUQeAAAAAAAAAAAAAAAAAAAAAAAAAA==",
      "serverTime": 1731586620341,
      "mode": "LoRa",
      "freq": 400.45,
      "sf": 9,
      "bw": 500,
      "cr": 5,
      "bitrate": null,
      "freqDev": null,
      "rxBw": null,
      "satellite": "Tianqi-26",
      "norad": 99999,
      "id": "3fb42333-6387-426b-ab8b-ee52c40a14aa",
      "satDisplayName": "Tianqi-26",
      "parsed": {
        "header": {
          "netId": 235,
          "msgTypeId": 248,
          "headUnk": 128,
          "msgTypeId1n": 15,
          "msgTypeId2n": 8,
          "headUnk1n": 2
        },
        "payload": {
          "timestamp": 216821820,
          "satId": 26,
          "unk248xF8": 248,
          "unk24x18": 4,
          "unk81x51": 12,
          "unk121x79": 236,
          "unk81xx51": 112,
          "unk121xx79": 58,
          "unk71x47": 0,
          "unk206CEx3": [0, 74, 222],
          "unkx211x110x172x142x150x38": [30, 28, 58, 238, 223, 100],
          "unkx150x37x150x20": [66, 51, 143, 93],
          "lastRXtime": 1134564359,
          "unkx00x00": [66, 129],
          "unkValue": 1.3989722830040528e+30,
          "eccentricity": 81295593963520,
          "inclination": 2.09376120567322,
          "ascending": -0.000008881346730049,
          "angleX": 1.85376157074446e-33,
          "angleY": 7.17613534340837e-30,
          "unkValue2": 5.85726400107595e-13,
          "eccentricity2": 576465906264178700,
          "inclination2": 8362.50390625,
          "ascending2": 2.36361636262599e-38,
          "angleX2": 2.35357157497402e-38,
          "angleY2": -6.64470877341397e-19,
          "tinygsTxPower": 9000,
          "satId1b": 1,
          "satId2n": 10,
          "tinygsSatellite": "Tianqi-26"
        },
        "telemetry": true,
        "type": "Beacon",
        "object": 0
      },
      "satPos": {
        "lat": 27.0680430552991,
        "lng": -128.527143810243,
        "alt": 901.236724880711
      },
      "stationNumber": 4
    },

Vamos a ver ahora algunos programas 

Crear un archivo de log o registro

El programa, escrito en Python (Necesitará tener instalado Python y un usar su IDE o un editor de progrmas para ponerlo a punto),  crea un archivo de registro para registrar los datos a intervalos regulares (Estoy probandolo)

#!/usr/bin/env python3
import requests 
import os
import time
__author__ = "Diarmuid O'Briain"
__copyright__ = "Copyright 2023, Limerick Clare Amateur Radio Club"
__licence__ = "European Union Public Licence v1.2"
__version__ = "1.0"
telegram_id = "<Telegram-ID>"
API = f"https://api.tinygs.com/v1/stations?userId={telegram_id}"
LOG = "/path/to/lora_station.log"
TIME=5 # espera 5 minutos
def access_api():
    """Acceso a la API de TinyGS"""
    # Descargando los datos de la URL
    response = requests.get(API)
    # Comprobando que la descarga ha ido bien
    if response.status_code == 200:
        # Append the data to the file
        with open(LOG, mode="a") as fh:
            fh.write(response.text)
            fh.write("\n\n")
    else:
        print(f"Error en la descarga de datos: {response.status_code}")

if __name__ == "__main__":
    while True:
        access_api()
        time.sleep(TIME*60)  # Time in seconds

 

Hay que reemplazar

      • /path/to/lora_station.log  por el directorio correcto
      •  <Telegram-ID> por el usuario correcto


Referencia:

Prohibida la reproducción parcial o total de este artículo sin permiso previo del autor

Comentarios

Publicar un comentario

Entradas populares de este blog

SDR - Software Defined Radio - IIIb: Receptores RSP o MSI (MSI3001: MSI2500 + MSI001)

Imagen
Los receptores SDR del tipo RSP (por la denominación de los modelos originales) o MSI  por el empleo de los circuitos integrados MSI2500 (procesador de señal) y MSI001 (sintonizador) son menos populares que los basados en los receptores RTL-SDR (RD828D/R860/R820T2 y RTL2832U) . Sin embargo presentan varias características que los hacen muy atractivos: Trabajan a partir de los  1-10 kHz de forma nativa, los RTL-SDR lo hacen a partir de los 300 - 500 kHz y además hasta los 20-30 MHz de forma directa (canal Q). En algunos modelos disponen de entradas diferenciadas de RF según la banda de frecuencia a sintonizar (1, 2, 3 ó 5) con conmutación interna automatica o externa manual. Disponen de un ancho de banda de IF de hasta 10 MHz (Los RTL-SDR hasta los 2,4 MHz) Digitaliza las señales con hasta 14b  (Los RTL-SDR hasta 12b) Por contra presentan dos inconvenientes: Menor software disponible (SDRuno / SDRConnect y SDRAngel) Mayor precio de los modelos originales  MSI (SDRPla...
Leer más

Antena exterior logarítmica UHF/VHF : Metronic 425010 - Ia Características

Imagen
  Caracteristicas teóricas Marca: Metronic  Modelo: 425010  Tipo: LPDA -  Array de Dipolos Logaritmicos Periódicos Numero de elementos: 32 MateriaL: acero Largo: 1.160 mm Elemento mas largo: 435 mm => 172,413 MHz Elemento más corto: 65 mm => 1.153 MHz Peso 0.8 kg Ancho de banda:  170-860 MHz 170-230 MHz 470-862 MHz  Ganancia  UHF 9/10dB VHF 8dB Disponible en mano a mano por 25 €  y en  Amazon por 25€ Especificaciones Descripción En las antenas LPDA hay un elemento activo y por delante del mismo todos lo están y por detrás del mismo hay uno o dos pero en menor medida. Como en todas las antenas logaritmo periódicas en el extremo de los radiadores mas cortos (punta) se une uno de los soportes con la malla del coaxial y el otro con el vivo, y en el extremo trasero se unen ambos soporte. Detalle del extremo de los radiadores. Se tratan de varillas de 4mm de acero tratado ¿? con la  arandela de resorte que se traba con una muesca del rad...
Leer más

ESP32 LoRa for dummys - Inicio

Imagen
Un ESP32 - LoRa no es un electrodoméstico que se enchufa y funciona, al contrario es un dispositivo que para que funcione se tiene que configurar y programar,  a través de ordenador y un software específico como un IDE (entorno integrado de desarrollo). Pero en elloe stá la gracia, pues resolviendo los problemas que se vayan planteando a lo largo de este proceso aprenderá de hardware, de software, de progrmación, ..., que es lo que en el fondo pretende esta guía, aprender de forma divertida.  1- ADQUIRIR EL HARDWARE     Lo primero que se necesita es comprar una placa de desarrollo ESP32-LoRa.      Una placa de desarrollo contienen además del microprocesador ESP32 diversos elementos que permiten que trabaje de forma autónoma, lo cual le evita muchos quebraderos de cabeza. Al procesador (ESP32) y a los de protocolos de comunicación que suele llevar la placa por defecto (USB-SERIE, BLUETOOTH y Wi-Fi) le añadimos LoRa) aunque también hay la opción de incor...
Leer más