Protocollo C059
Il protocollo C059 è una variante della famiglia JT708/Huabao, ottimizzata per dispositivi di tracciamento veicolare con supporto per comandi bidirezionali. Utilizza la porta 5059 sulla piattaforma Visla.
Struttura del Frame
Il protocollo supporta due formati: binario (principale) e ASCII (per risposte testuali).
Frame Binario
| Delimitatore | Tipo | Attributo | Device ID | Index | Dati | Checksum | Delimitatore |
|---|---|---|---|---|---|---|---|
0x7E | 2 bytes | 2 bytes | 6-7 bytes | 1-2 bytes | N bytes | 1 byte (XOR) | 0x7E |
- Delimitatore Standard:
0x7E - Delimitatore Alternativo:
0xE7(per alcune varianti hardware) - Escape Sequences:
0x7D 0x01→0x7D0x7D 0x02→0x7E
Frame ASCII
Formato testuale delimitato da parentesi: (contenuto)
Utilizzato principalmente per sincronizzazione orario (BASE,2) e risposte a comandi.
Tipi di Messaggi
| ID (Hex) | Nome | Descrizione |
|---|---|---|
0x0100 | Register | Registrazione iniziale dispositivo |
0x0102 | Auth | Autenticazione sessione |
0x0002 | Heartbeat | Keep-alive |
0x0200 | Location | Report posizione singola |
0x5501 | Location 2 | Formato posizione alternativo (JT600) |
0x5502 | Location Blind | Posizione senza fix GPS valido |
0x0704 | Location Batch | Invio massivo posizioni storiche |
0x0210 | Location Batch 2 | Batch formato alternativo |
0x0109 | Time Sync Request | Richiesta sincronizzazione orario |
0x0900 | Transparent | Dati passthrough / Risposte comandi |
0x6006 | Text Message | Messaggio testuale dal dispositivo |
0x0FA0 | Diagnostic | Dati diagnostici custom |
🚨 Gestione Allarmi
Gli allarmi vengono trasmessi tramite una bitmask a 32 bit nel pacchetto di posizione.
| Bit | Allarme |
|---|---|
| 0 | sos - Pulsante panico |
| 1 | overspeed - Eccesso velocità |
| 5 | gpsAntennaCut - Antenna GPS tagliata |
| 7 | lowBattery - Batteria scarica |
| 8 | powerOff - Alimentazione staccata |
| 15 | vibration - Vibrazione rilevata |
| 16 | tampering - Manomissione case |
| 20 | geofence - Violazione area virtuale |
| 28 | movement - Movimento non autorizzato |
| 29 | accident - Rilevamento impatto |
📊 Telemetria Decodificata
Dati Base (sempre presenti)
- Coordinate: Latitudine, Longitudine (microgradi).
- Altitudine: Metri sul livello del mare.
- Velocità: km/h (convertita internamente in nodi).
- Direzione: 0-360°.
- Data/Ora: Formato BCD (AA-MM-GG HH:MM:SS).
Stato Dispositivo
- Ignition: Bit 0 dello status (Quadro acceso/spento).
- Valid: Bit 1 dello status (Fix GPS valido).
- Charging: Bit 26 dello status (Dispositivo in carica).
Estensioni TLV
Il pacchetto posizione può includere dati aggiuntivi in formato Tag-Length-Value:
| Tag (Hex) | Campo | Descrizione |
|---|---|---|
0x01 | Odometer | Chilometri percorsi (x100m) |
0x02 | Fuel Level | Livello carburante (x0.1 L) |
0x30 | RSSI | Potenza segnale GSM (0-31) |
0x31 | Satellites | Numero satelliti in vista |
0x69 | Battery | Voltaggio batteria (x0.01 V) |
0x91 | OBD Info | Batteria + RPM + altri dati OBD |
Comandi Supportati
Il protocollo C059 supporta la comunicazione bidirezionale. Il server può inviare comandi al dispositivo tramite il microservizio commands:
| Comando | Descrizione |
|---|---|
c059Interval | Imposta intervallo report (secondi) |
c059Freq | Imposta frequenza GPS |
c059Zone | Configura timezone dispositivo |
c059Sleep | Attiva/Disattiva sleep mode |
c059Reboot | Riavvia dispositivo |
c059SoundOn | Attiva audio |
c059SoundOff | Disattiva audio |
Le risposte ai comandi arrivano tramite il messaggio MSG_TRANSPARENT (0x0900).
Note Tecniche
- Timezone: Configurabile, default UTC+8 (come da standard JT708).
- Checksum: XOR di tutti i byte tra i delimitatori.
- Session Management: L'IMEI viene estratto al primo messaggio e associato al canale TCP.
- Batch Mode: I messaggi
0x0704e0x0210permettono l'invio di posizioni accumulate durante periodi offline.
Porta: Il decoder C059 ascolta sulla porta 5059 (TCP).