Manual de usuario de Utilidades Guifi.net
De Guifi.net - Wiki Hispano
Utilidades Guifi.net se trata de una aplicación multilingüe que proporciona un conjunto de herramientas para los instaladores de Guifi.net. La aplicación busca aprovechar las capacidades de los teléfonos de nueva generación (smartphone) para asistir a los usuarios de la red durante el proceso de planificación e instalación de nodos proporcionando herramientas específicas.
Menú principal
El menú principal de la aplicación está compuesto por los botones Brújula nodo, Nuevo nodo aquí, Realidad aumentada, Código de buenas prácticas, Licencia de interconexión de Guifi.net.
Brújula nodo
Solicitud del id de un nodo
Al seleccionar la función Brújula nodo lo primero que hará la aplicación es solicitarnos el id del nodo al que queremos que apunte la brújula. Permitiéndonos también seleccionar el servidor de guifi.net que queremos usar, el que está en producción (guifi.net) o el de test (test.guifi.net). Mientras la aplicación realiza la solicitud al servidor nos mostrara el mensaje Obteniendo la ubicación. En caso de que el id sea erróneo mostrará un popup con el mensaje El id es incorrecto. Si el servidor de guifi.net ha respondido adecuadamente la aplicación mostrará la brújula.
Brújula
La brújula muestra la dirección en la que se encuentra el nodo indicado. En la parte superior izquierda también muestra la distancia entre la ubicación del dispositivo y el nodo. En la parte inferior izquierda nos muestra la ubicación del dispositivo. En la parte inferior derecha se puede encontrar el botón del mapa.
Mapa
En la funcionalidad mapa de la brújula nodo se muestra un mapa proporcionado por Google Maps en el que también se muestra el nodo indicado con una flecha roja, la ubicación del dispositivo con una flecha verde y una línea del posible enlace marcada en azul.
Nuevo nodo aquí
Autenticación a través los servidores de Guifi.net
Al seleccionar la función Nuevo nodo aquí lo primero que hará la aplicación es solicitar los credenciales de autenticación a través los servidores de guifi.net. Estos credenciales son los de la web, bien del servidor de producción o del servidor de test. Una vez introducidos, mientras se lleva a cabo la comunicación con los servidores de Guifi.net nos mostrará un símbolo de carga. Una vez finalizado el proceso mostrará el formulario para crear un nuevo nodo.
Proceso para crear un nodo
Formulario
El formulario nos pide la aceptación de la licencia de interconexión de Guifi.net XOLN. El propio programa incluye una copia para no tener que aceptarla sin leerla. A continuación también nos pide el título del nodo. Una vez rellenado el formulario, al apretar el botón Crear un nodo aquí! se iniciará el proceso de creación.
Obtención de la ubicación
El primer paso del proceso es obtener nuestra ubicación actual. Pero en caso de que el dispositivo no sea capaz de obtener nuestra ubicación la aplicación no continuará el proceso ni lo detendrá, seguirá a la espera hasta obtener esa información. Debe tenerse en cuenta que algunos sistemas de localización, como el GPS, tienen un consumo energético considerable. Por este motivo se recomienda cancelar la operación si el proceso no continua en un tiempo razonable.
Por otro lado, para que la ubicación obtenida sea lo más precisa posible es recomendable realizar este paso en un lugar despejado, bien en la azotea de un edificio o en campo abierto. Pero claro está, debe hacerse en el lugar donde se vaya a realizar la instalación del nodo.
Nótese que la versión actual de la aplicación no tiene en cuenta la altura del dispositivo.
Confirmación de precisión
Una vez la aplicación ha obtenido la ubicación muestra un popup solicitando al usuario que confirme la precisión de los datos obtenidos. El número dado corresponde, en metros, al radio de una circunferencia con centro en la ubicación real del dispositivo. La ubicación obtenida por el dispositivo puede encontrarse en cualquier punto de dicha circunferencia. Cuanto más cercana a 0 sea ese número más preciso será la ubicación obtenida.
En la versión actual de la aplicación hay un error que provoca que, en determinadas circunstancias, se habrán varios popups. En ese caso puede aceptarse el último abierto y cancelar el resto.
Creando el nuevo nodo
Una vez la precisión ha sido confirmada la aplicación envía a los servidores de guifi.net los datos del nuevo nodo. La velocidad de este paso dependerá del acceso a internet que disponga el dispositivo.
Proceso finalizado
Una vez el nodo se ha creado la aplicación muestra su id.
