La aplicación ASHAB-Telemetry, es el nodo principal del seguimiento de las misiones a partir de la NS2.

Es una aplicación multiplataforma, desarrollada en C++ con las librerias Qt, y que se encarga de mostrar al usuario la telemetría de un vistazo, guardarla para su posterior análisis en un log local, y de subirla a una base de datos al servidor de ASHAB para su almacenaje o visualización en el tracker online.

Además incorpora utilidades como un visor del log local con opción de copia formateada del contenido para ser tratado por ejemplo en una hoja de cálculo, o un visor de la posición en un mapa si se dispone de conectividad a internet.

La aplicación está disponible en https://github.com/ladecadence/ASHAB-Telemetry

Compilación

Para compilar la aplicación, hace falta disponer de las librerias Qt 5.8. Ayuda hacerlo directamente desde el IDE de Qt, Qt Creator.

Linux

Instalar Qt 5.8 y Qt Creator desde los repositorios oficiales (o no oficiales en caso de no estar disponible esta versión) de la distribución. Además harán falta los paquetes extra de Qt: qt5-charts, qt5-serialport y qt5-svg.

Seguir los mismos pasos en Qt Creator que para la compilación en windows.

Windows

Desargar el instalador de las librerías Qt desde https://www.qt.io/download-open-source/

En el instalador, después de crear la cuenta de Qt y seleccionar el directorio de destino, instalar sólo la versión Qt 5.8 y dentro de esta, asegurarnos que esté seleccionada la versión “MinGW” y las extensiones de Qt Charts, WebEngine, etc. Además en tools, instalar misma la versión de MinGW que la de la librería Qt 5.8 (en mi caso la 5.3.0).

Descargar el softare ASHAB-Telemetry desde https://github.com/ladecadence/ASHAB-Telemetry, con git o en el botón de “Clone or download”, en el caso de usar el download, extraer el zip en una carpeta.

Abrir Qt creator y abrir el proyecto ASHABTelemetry.pro desde la carpeta de git o del zip descomprimido.

Al abrir el proyecto nos debería encontrar la versión de Qt Desktop 5.8 con el compilador MinGW, aceptar con “configure project”.

En el menú “Build” ejecutar “Build All”. Podeis ver el progreso de la compilación en la pestaña inferior “compile output”.

Si todo va bien, la aplicación podrá ejecutarse desde el menú “Build” → “Run” o presionando Ctrl-R. La aplicación también estará disponible ya compilada dentro de /debug/ en una carpeta del tipo “build-ASHABTelemetry….” al lado de la carpeta del código fuente.

MacOS

TODO

Ventana Principal

En la ventana principal se pueden visualizar los últimos datos recibidos desde la telemetría de la misión, separados por interés en datos de posición actual, dirección, y datos de los sensores de misión y ambientales, asi como el tiempo transcurrido desde el último paquete recibido correctamente. Las posiciones de latitud y longitud incluyen enlaces a su posición en Google Maps

Configuración

Archivo → Configuración

En la ventana de configuración, podremos configurar los parámetros de funcionamiento de la aplicación.

  • Direwolf: Post y puerto donde tenemos corriendo el TNC direwolf, necesario para el funcionamiento de la aplicación.
  • Tracking server: Parámetros de configuración para subir los paquetes a una base de datos remota del tracker ASHAB. Si algino de estos campos está vacío, no se intentará subirlos.
  • Log: Archivo de log local. Si está vacio no se guardará log.

Log

Ver → Log

Visualiza en log en una tabla con los campos separados en columnas. Si se selecciona una o varias filas, sus contenidos son automáticamente copiados al portapapeles en formato CSV para poder ser integrados en una hoja de cáculo o similar.

Mapas

Para ver la última posición recibida sobre un mapa, se puede usar el enlace que se crea sobre las etiquetas de latitud y longitud. Clickando en él, nos abrirá el navegador web predeterminado del sistema con la posición marcada en OpenStreetMap. Además, abriendo el menú contextual con el segundo botón del ratón, podremos abrir también la posición sobre Google Maps, o copiar los enlaces al portapapeles.