Skip to main content

Protocollo G11L-SE (GT06 Extended)

Documentazione completa del protocollo G11L-SE basata sulla specifica ufficiale V3.3 (2023-12-08).

Panoramica​

Il G11L-SE è un protocollo binario su TCP derivato dal GT06, utilizzato dai tracker GPS Seeworld.

ParametroValore
Porta5010
Header0x7878 (standard) / 0x7979 (esteso)
Terminatore0x0D 0x0A
CRCCRC16-X25

Messaggi Supportati​

Device → Server​

TipoNomeDescrizione
0x01LoginRegistrazione con IMEI
0x12GPS+LBSPosizione GPS + celle GSM
0x13HeartbeatStatus, batteria, voltaggio auto
0x15Command ResponseRisposta a comandi
0x16AlarmAllarme con GPS+LBS+Status
0x1AQuery AddressGPS + numero telefono
0x23Heartbeat ExtHeartbeat esteso
0x2CLBS+WiFiPosizionamento indoor
0x8ATime RequestSincronizzazione orario
0x90IMSINumero IMSI SIM
0x94InfoVoltaggio, ICCID, porta, satelliti

Server → Device​

TipoNomeDescrizione
0x80CommandInvio comandi

Struttura Frame​

Frame Standard (0x7878)​

[78 78] [Length] [Type] [Content...] [Serial] [CRC16] [0D 0A]
CampoBytesDescrizione
Header20x78 0x78
Length1Lunghezza (Type → CRC)
Type1Tipo messaggio
ContentNDati
Serial2Numero sequenza
CRC2CRC16-X25
End20x0D 0x0A

Frame Esteso (0x7979)​

[79 79] [Length 2B] [Type] [Content...] [Serial] [CRC16] [0D 0A]

Dati Telemetria Estratti​

CampoKey JSONFonte
LatitudinelatitudeGPS
LongitudinelongitudeGPS
VelocitàspeedGPS (knots)
DirezionecourseGPS (gradi)
SatellitisatellitesGPS
ValiditàvalidGPS
Voltaggio autopowerHeartbeat, Info
Batteria devicebatteryLevelHeartbeat (0-100%)
Segnale GSMrssiHeartbeat (0-100)
AccensioneignitionStatus byte
In caricachargeStatus byte
BloccatoblockedStatus byte
ArmatoarmedStatus byte
LingualanguageHeartbeat ("zh"/"en")
IMSIimsiMSG_IMSI
ICCIDiccidInfo packet
Stato portadoorInfo packet
WiFi APwifiAccessPointsLBS+WiFi

Status Byte (Terminal Information)​

Il byte di status nel heartbeat contiene:

BitNomeValore
0Armed1=Armato, 0=Disarmato
1ACC/Ignition1=ON, 0=OFF
2Charge1=In carica, 0=No
3-5Alarm TypeVedi tabella allarmi
6GPS Positioned1=Fix, 0=No fix
7Blocked1=Relay aperto, 0=Chiuso

Allarmi Supportati​

Da Status Byte (Bit 3-5)​

ValoreAllarme
0Normale
1Vibrazione
2Power Cut
3Low Battery
4SOS
5Door Close
6Geofence
7Door Open

Da Alarm Packet (0x16)​

CodiceAllarmeCodiceAllarme
0x01SOS0x13Tampering
0x02Power Cut0x26Hard Acceleration
0x03Vibration0x27Hard Braking
0x04Geofence Enter0x28Sharp Turn
0x05Geofence Exit0x29Collision
0x06Overspeed0xFADoor Closed
0x07High Temperature0xFBDoor Open
0x08Low Temperature0xFCAC Off
0x09TOW/Displacement0xFDAC On
0x0ELow Battery0xFEACC On
0x0FLow Battery0xFFACC Off

Info Packet (0x94) Subtypes​

Messaggi con header esteso 0x7979:

TipoDescrizione
0x00Voltaggio esterno
0x04Sync stato terminale
0x05Stato porta
0x08Self-test
0x09Info satelliti
0x0AICCID
0xAADati CANBUS

Comandi Server​

Blocco Motore (Engine Stop)​

Comando SMS: RELAY,1#
Payload: Relay,1#

Sblocco Motore (Engine Resume)​

Comando SMS: RELAY,0#
Payload: Relay,0#

Richiesta Posizione​

Comando SMS: DWXX,000000#

Flusso di Comunicazione​

Configurazione​

Environment Variables​

DECODER_G11LSE_PORT=5010
DECODER_TIMEOUT=100

Docker Compose​

decoder:
  ports:
    - "5010:5010"  # G11LSE

Esempio Log​

{
  "@timestamp": "2026-01-03T11:22:29Z",
  "message": "G11lse GPS: lat=42.717, lon=12.108, speed=0, sats=15",
  "type": "POSITION",
  "deviceId": 351840620257810,
  "protocol": "g11lse",
  "latitude": 42.717429,
  "longitude": 12.107880,
  "valid": true
}