Referencia práctica para configurar y comprender los tres protocolos de exportación por Socket disponibles en TsConnector para dispositivos de cronometraje.
Contenido
Descripción general
TsConnector permite emitir lecturas de cronometraje en tiempo real utilizando diferentes protocolos de exportación por Socket.
Cada protocolo está orientado a un tipo concreto de software de scoring o análisis. Es importante seleccionar el protocolo que espera el sistema de destino.
Todos los protocolos se configuran desde la ventana de Socket Export. El campo Protocol determina qué opciones estarán disponibles.
Este es el protocolo que se utilizará:
TsV1
Utilízalo si ya has migrado de TSConnector 1 a TSConnector 2. Esta versión es retrocompatible con el TSConnector anterior.
TsV2
Recomendado para nuevas integraciones. Es el protocolo preferido para desarrollos desde cero.
CTP01
Selecciónalo si vas a trabajar con Runscore o RaceDay.
Protocolos disponibles
| Protocolo | TsV1 | TsV2 | CTP01 |
|---|---|---|---|
| Rol | Servidor (fijo) | Servidor o Cliente | Cliente (fijo) |
| Formato | JSON, chip numérico | JSON enriquecido | Texto ompatible raceday o runscore |
| Uso habitual | Integraciones heredadas | Integraciones modernas | Software compatible raceday o runscore |
| Gestión de conexión | Servidor siempre a la escucha | Reconexión automática en modo Cliente | Reconexión con reanudación |
Tipos de lectura
| Tipo | Nombre | Descripción |
|---|---|---|
| 0 | Salida / tiempo de referencia | Eventos como disparo de salida o inicio de oleada |
| 1 | First-seen | Lectura inmediata, baja latencia, no recomendada para resultados oficiales |
| 2 | Best-seen | Lectura optimizada; recomendada para cronometraje oficial |
Campos de configuración comunes
| Campo | Descripción | Aplica a |
|---|---|---|
| Protocol | Selecciona TsV1, TsV2 o CTP01 | Todos |
| Role | Servidor o Cliente | TsV2 |
| Host | IP o nombre del host de destino | TsV2 Cliente, CTP01 |
| Port | Puerto TCP | Todos |
| Filter read type 1 | Excluye lecturas First-seen | Todos |
| Use UTC time | Emite timestamps en UTC | CTP01 |
TsV1 – JSON legacy
TsV1 es el formato histórico de exportación por Socket. Está pensado para sistemas que requieren chips numéricos.
Rol
- Servidor únicamente
- TsConnector escucha en el puerto configurado
- El software de scoring se conecta como cliente TCP
Formato de mensaje
Array JSON finalizado por retorno de carro (\r).
[{"Chip":123456,"Moment":"2026-04-22T10:15:42.1234567Z","TimingPoint":"Finish","Type":2,"Antenna":2,"Source":"Reader-01"}]
TsV2 – JSON enriquecido
TsV2 es el formato recomendado actualmente. Soporta chips alfanuméricos y añade información extendida.
- Timestamp local y UTC
- RSSI (nivel de señal)
- EPC completo del chip
- Modo Servidor y Cliente
CTP01 – Protocolo compatible raceday o runscore
CTP01 es un protocolo de texto, orientado a software de scoring compatible raceday o runscore.
- Protocolo basado en comandos
- Modos push y pull
- Reconexión automática con reanudación
Resiliencia y reconexión
- Reconexión TCP automática
- Buffer interno limitado
- Identidad persistente de conexión (CTP01)
Resolución de problemas
No se reciben datos
- Verifique Host y Port
- Compruebe reglas de firewall
- Revise el rol Servidor / Cliente
Timestamps incorrectos
- TsV1 y TsV2 usan hora local por defecto
- En TsV2 utilice UtcMoment si necesita UTC
- En CTP01 revise la opción Use UTC time
``
Comentarios
El artículo está cerrado para comentarios.