1. Objetivo
Al terminar esta lección podrás comprobar los últimos tres eslabones de la cadena: que el equipo apunta al destino correcto (IP o dominio, puerto y transporte TCP o UDP), que el servidor entiende el protocolo que el equipo habla, y que la plataforma tiene el equipo dado de alta con el identificador exacto y muestra la posición con la hora correcta.
2. Introducción
Llegar hasta aquí significa que el equipo tiene alimentación, posición y datos. Si aun así no aparece en la plataforma, el problema casi nunca está en el vehículo: está en un número. Un dígito cambiado en el puerto, un IMEI copiado con un error o una hora mal configurada bastan para que los datos lleguen al servidor y nadie los vea. Estas fallas no se arreglan con herramientas: se arreglan comparando, con calma, lo que tiene el equipo contra lo que espera el servidor.
3. Explicación
El destino: IP o dominio
El equipo necesita saber a dónde mandar los datos. Se le configura de una de dos formas:
- Dirección IP, por ejemplo cuatro números separados por puntos. Va directo, no depende de nada más.
- Dominio, un nombre como los de las páginas web. Antes de conectar, el equipo pregunta a un servidor de nombres (DNS) qué IP corresponde a ese nombre. Ventaja: si el servidor cambia de IP, no hay que reconfigurar los equipos. Riesgo: si el DNS de la red no responde, o el nombre tiene una letra mal, el equipo no sabe a dónde ir.
Si tu plataforma te da un dominio, úsalo: es lo que te protege de un cambio de servidor. Escríbelo
exacto, sin http://, sin barras al final y sin espacios, salvo que el manual del equipo pida otra
cosa.
El puerto y el transporte
Un servidor recibe muchos tipos de equipos. Para separarlos, cada protocolo suele escuchar en su propio puerto, que es un número. Si el equipo manda al puerto de otro protocolo, el servidor recibe datos que no sabe leer.
El transporte es la forma de enviar:
- TCP: primero se abre una conexión y cada envío se confirma. Si se pierde algo, se reenvía. Es el más usado en rastreo.
- UDP: se envían paquetes sueltos, sin conexión y sin confirmación del transporte. Gasta menos datos, pero un paquete perdido se pierde, salvo que el protocolo del equipo tenga su propia confirmación.
El equipo y el servidor tienen que usar el mismo transporte en ese puerto. Un equipo en UDP contra un puerto que solo espera TCP no se conecta.
Puedes comprobar desde tu computador que un puerto TCP del servidor está abierto, por ejemplo con el
comando nc -vz <servidor> <puerto> en Linux o macOS. Si responde que conectó, el puerto escucha.
Eso no prueba que el equipo llegue (puede estar en otra red), pero descarta que el servidor esté
cerrado. Con UDP esta prueba no sirve, porque no hay conexión que abrir.
El protocolo
El protocolo es el idioma del equipo: en qué orden van la posición, la hora, la velocidad, las entradas y las alarmas. Cada fabricante suele tener el suyo, y hay protocolos estándar, como el JT/T 808, muy usado en equipos para flotas y cámaras. El servidor tiene un decodificador para cada protocolo. Si el equipo habla un idioma que el servidor no tiene, o lo manda al puerto de otro idioma, los datos llegan y se descartan.
Por eso, al dar de alta un modelo nuevo, la pregunta correcta a la plataforma es: «¿qué protocolo y qué puerto uso para este modelo?», y no solo «¿cuál es la IP?».
El identificador
Cuando el decodificador entiende el mensaje, saca de él un identificador del equipo y busca en la plataforma a qué vehículo pertenece. Lo más común es el IMEI, de 15 dígitos, que viene en la etiqueta del equipo y en la caja. Pero no siempre:
- Algunos protocolos mandan otro número, por ejemplo un número de serie o un identificador que tú configuras.
- En el protocolo JT/T 808, el equipo se identifica con un número de terminal (en muchos equipos, el número de teléfono configurado), no con el IMEI.
Si el identificador que llega no está dado de alta, la plataforma no sabe de quién es el dato. Según el sistema, lo descarta o lo deja en una lista de «equipos desconocidos». Un solo dígito distinto basta. Copia el IMEI desde la etiqueta del equipo o leyéndolo con un comando, nunca de memoria ni de una foto borrosa.
La hora
Cada mensaje trae la hora en que se tomó la posición, que normalmente viene de los satélites en hora universal (UTC). La plataforma la convierte a la zona horaria del usuario. Si el equipo manda una hora equivocada (zona horaria configurada en el equipo cuando la plataforma espera UTC, o al revés), los puntos quedan horas en el pasado o en el futuro, y la plataforma puede mostrar el vehículo como «desconectado» aunque esté llegando todo.
Intervalos y latido
El equipo no manda todo el tiempo: manda según su configuración. Es normal que reporte cada pocos segundos con el motor encendido y muy de vez en cuando con el motor apagado. Algunos equipos mandan además un latido (heartbeat) para avisar que siguen vivos aunque no haya posición nueva. Si con el motor apagado el equipo reporta, por ejemplo, cada varias horas, y la plataforma marca desconectado a los 30 minutos sin datos, el vehículo aparecerá «caído» cada noche sin ninguna falla. Ajusta el intervalo en reposo o el tiempo de aviso de la plataforma para que coincidan.
4. Imagen
Foto propia en preparación. la etiqueta de un equipo GPS con el IMEI resaltado (con los dígitos difuminados salvo los cuatro últimos, para no publicar un IMEI real), al lado de la pantalla de alta de equipo de una plataforma con el campo del identificador marcado.
5. Diagrama
6. Ejemplo real
Un técnico instala diez equipos nuevos del mismo modelo. Nueve aparecen en la plataforma en minutos; uno no. El que falla tiene alimentación, posición válida y el comando de estado dice que tiene datos y conexión con el servidor.
El técnico compara la configuración del equipo con la de uno de los que funcionan: IP, puerto y protocolo iguales. Pide al administrador de la plataforma que busque el IMEI en la lista de equipos desconocidos: ahí está, enviando cada 30 segundos. En la plataforma lo habían dado de alta con dos dígitos invertidos. Al corregir el número, el vehículo aparece con todo su recorrido desde que se instaló, porque ese servidor guardaba los mensajes de los equipos desconocidos. No todos los sistemas lo hacen: en muchos, lo que llegó antes del alta se pierde.
7. Error frecuente
Revisar solo la IP. El técnico confirma que la IP está bien y concluye que «el servidor está caído». Pero la IP es solo una de cinco piezas: dominio o IP, puerto, transporte, protocolo e identificador. Antes de culpar al servidor, compara las cinco contra un equipo del mismo modelo que sí funcione en esa misma plataforma.
8. Recomendación del instructor
Arma una ficha por modelo con los datos que espera tu plataforma: dominio, puerto, transporte, protocolo, qué identificador usa y qué intervalo dejas en marcha y en reposo. Configura siempre desde esa ficha, no de memoria. Cuando un equipo falle, compara contra la ficha campo por campo. La mayoría de los casos de este eslabón se resuelven ahí.
9. Práctica
En banco o con un equipo instalado (25 minutos).
- Consulta la configuración del equipo con su comando o su programa: destino, puerto, transporte y el identificador que manda. Anótalos.
- Compáralos con la ficha que te da tu plataforma para ese modelo. Marca cualquier diferencia.
- Desde tu computador, comprueba que el puerto TCP del servidor responde con
nc -vz. - En la plataforma (la cuenta de práctica de Appogio sirve para esto), da de alta el equipo con su identificador copiado desde la etiqueta y comprueba que aparece con la hora correcta.
- Cambia un dígito del puerto en el equipo, espera un ciclo de reporte y comprueba que deja de aparecer. Devuelve el valor correcto y comprueba que vuelve.
Caso escrito. Un vehículo aparece en la plataforma con su recorrido de hoy, pero siempre cinco horas atrasado, y figura como desconectado. ¿Qué revisas? (Respuesta: la zona horaria configurada en el equipo frente a la que espera la plataforma; el equipo debe mandar la hora en el formato que la plataforma espera, normalmente UTC.)
10. Preguntas
- ¿Qué ventaja tiene configurar un dominio en lugar de una IP, y qué riesgo trae?
- ¿Qué pasa si el equipo manda sus datos al puerto de otro protocolo?
- ¿Por qué un equipo puede llegar al servidor y aun así no aparecer en la plataforma?
- ¿Qué identificador usa el protocolo JT/T 808 en muchos equipos?
- ¿Por qué un vehículo estacionado puede aparecer desconectado sin tener ninguna falla?
11. Resumen
- El destino tiene cinco piezas: IP o dominio, puerto, transporte (TCP o UDP), protocolo e identificador.
- Cada puerto espera un protocolo; el equipo y el servidor deben hablar el mismo idioma por el mismo transporte.
- El identificador tiene que estar dado de alta exacto; si no, el dato llega y nadie lo ve.
- La hora mal configurada hace que el vehículo parezca desconectado.
- El intervalo en reposo y el aviso de desconexión de la plataforma deben coincidir.
12. Evaluación
Responde las 5 preguntas de abajo. Se aprueba con 4 de 5.
Guion del video de esta lección
Duración: 3 minutos. Plano: pantalla dividida: a la izquierda la configuración del equipo, a la derecha la ficha de la plataforma; luego la etiqueta del equipo en primer plano.
Narración: «Si el equipo tiene alimentación, posición y datos, y aun así no aparece, el problema casi nunca está en el vehículo. Está en un número.
El destino tiene cinco piezas, no una. Primera: la IP o el dominio. Si te dan un dominio, úsalo: si el servidor cambia de IP, tus equipos siguen llegando.
Segunda: el puerto. Cada protocolo escucha en su propio puerto. Si mandas al puerto de otro, el servidor recibe datos que no sabe leer.
Tercera: TCP o UDP. El equipo y el servidor tienen que usar el mismo.
Cuarta: el protocolo, el idioma del equipo. Pregunta siempre qué protocolo y qué puerto lleva ese modelo.
Y quinta: el identificador. Casi siempre el IMEI, de quince dígitos. Un dígito cambiado y la plataforma no sabe de quién es el dato. Cópialo de la etiqueta, nunca de memoria.
Y si el vehículo aparece, pero horas atrasado y como desconectado, mira la hora. El equipo debe mandarla como la espera la plataforma.
Mi consejo: una ficha por modelo, y compara campo por campo contra un equipo que sí funcione.»
Texto en pantalla al final: «Destino · puerto · TCP/UDP · protocolo · identificador».