LEER ANTES DE CORRER.

Guía de instalación

Primero necesitas ya tener instalado VSCode, aquí es donde vamos a trabajar con el proyecto. Recuerda hacer un clon del directorio a tu computadora.

1. Build Tools for Visual Studio Se necesitan descargar las Build Tools for Visual Studio, aquí te dejo el enlace, solo dale clic y instálalo. https://visualstudio.microsoft.com/es/visual-cpp-build-tools/

2. Seleccionar Workload Al momento de instalar se abrirá una pestaña después de un rato de la instalación, donde te pide elegir qué ocupas descargar. En Workloads, selecciona la que dice Desktop development with C++.

3. Instalar Rust Ahora necesitas descargar Rust, en el siguiente enlace lo encuentras, debes dar clic al que dice rustup-init.exe. https://rustup.rs/

4. Ejecutar el instalador de Rust Cuando abras el .exe del Rust, se abrirá una terminal, debes de escribir 1 que es la instalación estándar. Al finalizar la instalación te pide que des Enter.

5. Instalar Node.js Ahora necesitas instalar Node.js, ve al siguiente enlace: https://nodejs.org/es/download Ahí debes de dar clic a la instalación de Windows Installer (.msi), confirma que arriba diga versión LTS.

6. Reiniciar la computadora Por último reinicia la computadora, esto para evitar errores y que todo se haya instalado correctamente.

7. Instalar dependencias del proyecto Al entrar al VSCode, en el proyecto, en la terminal escribe:

   npm install

Esto es para que se instalen todas las herramientas que el proyecto necesita para funcionar.

8. Primera ejecución Si corres por primera vez la interfaz, es decir, con:

   npm run dev

es normal que tarde un poco la primera vez ya que instalará muchas herramientas.

9. Si seguiste todos los pasos correctamente, ya deberías de ser capaz de poder utilizar la estación terrena, ahora sigue los pasos del GitHub, para poder utilizar la interfaz correctamente.

Extra: en caso de haber tratado de correr la interfaz, y te marque un error de no tener permisos, cierra VSCode, abre Windows PowerShell como administrador y escribe lo siguiente:

Set-ExecutionPolicy RemoteSigned

Te pedirá que aceptes, por lo que escribes la letra Y.

Ejecución del Proyecto

Sigue estos pasos para iniciar la aplicación desde la terminal:

1. Acceder al directorio del proyecto Para poder ejectuar correctamente el programa, en terminal escribe lo siguiente para ubicarte en el directorio correcto:

   cd Estacion-terrena

2. Iniciar el entorno de desarrollo Ejecuta el siguiente comando para lanzar la aplicación con Tauri:

   npm run dev

Datos.

Para una correcta visualizacion de los datos, es necesario enviarlos de la sigueinte manera:

ID,Tiempo,Paquete,Evento,RSSI,Bat,Sat,Lat,Lon,Alt,Vel,Pres,Temp,GX,GY,GZ,AX,AY,AZ\n

Por ejemplo si nos basamos en el código de recepción de la estación terrena utilizado para IREC 2026 (https://github.com/CIUDSE/IREC-2026/tree/main/Estaci%C3%B3n%20terrena/Recepcion%20Bahias), podemos observar como se imprimen los datos en serial:

        sprintf(datosCSV,
           "%c,%u,%u,%u,%d,%d,%u,%.6f,%.6f,%.2f,%.2f,%.2f,%.2f,%.2f,%.2f,%.2f,%.2f,%.2f,%.2f\n",
           telemetryData.id,
           telemetryData.tiempoRecibido,
           telemetryData.numPaquete,
           telemetryData.indicadorEstadoVuelo,
           rssi,
           0,//voltaje de la bateria (no tenemos el dato)
           telemetryData.satellites,
           lat,
           lon,
           alt,
           velocidad,
           pres,
           temp,
           vel_ang_x_16,
           vel_ang_y_16,
           vel_ang_z_16,
           accel_x_32,
           accel_y_32,
           accel_z_32
           );
           
   Serial.print(datosCSV);

De esta manera nos aseguramos que el orden este bien estructurado, en caso de no tener un dato no te preocupes, puedes crear una variable y mandarla en 0 por ejemplo, esto para que tengas el orden que recibe la interfaz y se puedan interpretar los datos de manera correcta.

Si quieres hacer una prueba de la interfaz pero no cuentas con las aviónicas, no hay problema, busca en el repositorio IREC 2026 -> 'IREC-2026/Estación terrena/Pruebas datos Simulados Serial/', una vez que entres a esas carpetas puedes ver pruebas de datos para cada una de las etapas, utiliza los LILYGo ESP32 LoRa que tenemos en el salón, recuerda conectar las antenas antes de conectarlos, al igual si no cuentas con ellos con cualquier microcontrolador funciona, solo modifica el código para que se adapte en dicho caso, lo que realmente ocupas que se imprima es el serial con los datos en orden, por lo que no será tan complicado modificarlo.

Mapas.

Los mapas no están subidos al repositorio debido a que son muy pesados, por ende tienen un .gitignore, se deberán de descargar manual y agregarlos tú mismo a tu carpeta src. Si intentas hacer algún cambio, jamás subas los mapas ya que, primero no te dejará ya que casi es un 1GB y puede lagear mucho el repositorio.

1. Es importante tener descargados los mapas y ponerlos en la carpeta que corresponde, ya que si no, no se podrá visualizar en el mapa bien la posición. Para ello entra al siguiente enlace y descarga el zip: https://drive.google.com/drive/folders/1zq2AA79Xx9HxRyiDcc5PMX6ew2UEB-iL?usp=drive_link Una vez descargados mete el zip dentro de la carpeta src, OJO existe otra carpeta llamada src-tauri, esta ignórala.

Descomprime el archivo y ya estara listo para su uso. Te dara la carpeta principal mapas y dentro tiene una que dice ciudad y otra la_salada.

3. Para poner tu ubicacion actual y seleccionar el mapa que deseas ve al main.js, lo encontrarás dentro de la carpeta src. Dentro del main al inicio encontrarás el siguiente codigo:

        const CONFIG_MAPA = {
         // Coordenadas de tu teléfono 
         latRespaldo: 32.5337045, 
         lonRespaldo: -115.7261352,
     
         // Ruta de tus carpetas de mapas offline
         rutaOffline: './mapas/la_salada/{z}/{x}/{y}.jpg',
         //rutaOffline: './mapas/ciudad/{z}/{x}/{y}.jpg',
         
         zoomInicial: 17,
         minZoom: 13,
         maxZoom: 17,
     
         // Tiempo máximo de espera para el GPS de la PC (en milisegundos)
         timeoutGPS: 0
   
     };

Si deseas agregar tus coordenadas, te recomiendo sacarlas de tu teléfono, ve al google maps y ahí saca las coordenadas y las pones en latRespaldo y lonRespaldo.

Posteriormente, si te encuentras en la ciudad, utiliza el que dice mapas/ciudad, quita el comentario de esa linea y comenta el que dice mapas/la_salada, con esto estaras cargando los mapas de la zona donde te encuentres.

Si te encuentras en otra zona que no sea mexicali, no va a funcionar el de la ciudad, ya que este corresponde a parte de la ciudad de Mexicali, en ese caso deberás de descargar tus propios mapas y ponerlos en el mismo formato. Está hecho de esta manera para que funcione totalmente sin internet, ya que si importamos directamente un mapa en línea será difícil usarlo en la competencia.