Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UGscan

UGscan es una aplicación Android para diagnosticar la red Wi‑Fi conectada y tomar mediciones puntuales sobre una superficie mediante ARCore.

La interfaz tiene solo dos pestañas:

  • Red: ficha completa de la conexión Wi‑Fi y prueba de velocidad de Internet.
  • Punto AR: cámara despejada, mirilla central, resultado puntual y guardado de etiquetas.

Pestaña Red

La pantalla se actualiza en directo y muestra, cuando Android lo expone:

  • SSID y BSSID;
  • RSSI en dBm, porcentaje y estado de señal;
  • banda, frecuencia y canal;
  • estándar Wi‑Fi 4/5/6/7;
  • velocidad de enlace, TX, RX y máximo TX anunciado;
  • IP del teléfono, gateway, máscara y DNS;
  • descarga, subida y latencia de una prueba real de Internet.

La velocidad de enlace es la capacidad negociada entre teléfono y punto de acceso; la prueba de Internet es el rendimiento medido hacia un servidor externo. Se muestran separadas para no confundir ambas magnitudes.

Flujo Punto AR

La cámara no queda tapada por un formulario al iniciar:

  1. concede el permiso de cámara y, si quieres, ubicación;
  2. apunta a una superficie y espera el estado Cámara lista;
  3. la mirilla cambia al color de la señal cuando ARCore encuentra el punto central;
  4. aparece Resultado listo · toca para guardar;
  5. toca el resultado, escribe una etiqueta y confirma;
  6. usa el botón de puntos guardados para consultar la lista persistente.

Cada punto guarda etiqueta, RSSI, SSID, banda, frecuencia, coordenadas AR relativas, fecha y la última posición GPS disponible como referencia exterior cuando se concedió el permiso.

Colores de RSSI

Color Estado Umbral
Verde lima Señal buena ≥ −55 dBm
Naranja Señal media −70 a −56 dBm
Rojo Señal baja −82 a −71 dBm
Negro Sin señal < −82 dBm o sin conexión

El RSSI es una lectura instantánea del teléfono. ARCore aporta la posición relativa de la superficie; no sustituye un plano arquitectónico ni permite inferir por sí solo la posición exacta del router.

Criterios técnicos incorporados

La organización de los datos sigue patrones observables en proyectos abiertos de análisis Wi‑Fi: ficha detallada por punto de acceso, bandas y canales, lectura temporal de RSSI y separación entre velocidad de enlace y rendimiento de Internet. Se revisaron WiFiAnalyzer y Wi‑Fi Info. No se ha copiado código GPL; los criterios se han implementado de forma independiente para mantener la licencia de UGscan.

Requisitos

  • Android 8.0 o superior.
  • Cámara trasera y ARCore compatible para la pestaña Punto AR.
  • Permiso de cámara para AR.
  • Permisos de Wi‑Fi/ubicación para que Android permita exponer SSID, BSSID y mediciones de radio.
  • Internet solo para la prueba externa de velocidad.

Si ARCore no está instalado o el dispositivo no es compatible, la app muestra un estado explicativo y no intenta abrir una sesión AR inválida. La pestaña Red permanece disponible.

Compilar

Abre el proyecto en Android Studio y ejecuta la variante debug:

gradle assembleDebug

El APK se genera en app/build/outputs/apk/debug/app-debug.apk.

Privacidad y almacenamiento

Las mediciones etiquetadas se guardan localmente en las preferencias privadas de la aplicación. No se suben automáticamente. El tráfico de velocidad solo comienza al pulsar Medir velocidad.

Licencia y atribución

El código se distribuye bajo la UGscan Non‑Commercial Attribution License. El uso comercial requiere autorización escrita. Cualquier copia, adaptación o distribución debe mencionar a EMoyaP / UGscan y enlazar este repositorio:

UGscan by EMoyaP — https://github.com/EMoyaP/UGscan

About

Android Wi-Fi diagnostics and ARCore measurement tool with live network metrics and locally tagged points.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages