Skip to main content

GPS Device Configuration

Configurazione dei dispositivi GPS per lavorare con 1NCE VPN.

Configurazione Base​

Tutti i dispositivi GPS richiedono solo la configurazione dell'APN 1NCE. Non è necessario configurare IP o porta del server.

APN Configuration​

APN: iot.1nce.net
Username: (vuoto)
Password: (vuoto)

Protocolli Supportati​

Il decoder supporta i seguenti protocolli GPS:

ProtocolloPortaDispositivi
H025013Tracker H02
Huabao5015Serie Huabao
GT065023Serie GT06
V6C5050V6C (H02-based)
C0035051C003 (Huabao-based)
S21L5052S21L series ⭐
R12L5053R12L (GT06-based)
P55054P5 series
OsmAnd5055OsmAnd tracker
S26L5056S26L series
GX025057GX02 series
W185058W18 series
C0095059C009 series
Seeworld5078Seeworld
Watch5093Smart watches
Startek5222Startek

Configurazione per Protocollo​

S21L (Principale)​

Via SMS​

Invia questi comandi SMS al numero della SIM 1NCE nel dispositivo:

# Configura APN
APN,iot.1nce.net#

# Verifica configurazione
APN#
tip

Con 1NCE VPN, non devi configurare SERVER/IP! Il routing è automatico tramite la rete 1NCE.

Via Configuratore​

Se usi il software configuratore S21L:

  1. Connection Settings

    • Protocol: TCP
    • APN: iot.1nce.net
    • Server IP: (lascia vuoto)
    • Server Port: (lascia vuoto)

  2. Upload Time

    • Normal: 60 secondi
    • Emergency: 10 secondi

  3. GPRS Settings

    • Auto-connect: Enabled
    • Reconnect interval: 30 secondi

GT06 / R12L​

# APN
APN,iot.1nce.net#

# Intervallo upload
TIMER,60#

# Verifica IMEI
IMEI#

Huabao / P5 / S26L​

# APN
apn,iot.1nce.net#

# Verifica APN
param#

Verifica Connessione​

1. Controlla SIM Attiva​

Nel 1NCE Portal:

  1. Vai su My SIMs
  2. Trova la SIM (cerca per ICCID)
  3. Verifica stato: Active ✅
  4. Controlla data ultimo utilizzo

2. Monitora Log Decoder​

# Sul server Google Cloud
docker logs decoder -f | grep --line-buffered connection_open

Quando il GPS si connette, dovresti vedere:

{
  "event": "connection_open",
  "conn_id": "abc123",
  "remote": "100.64.25.10:54321",
  "protocol": "s21l",
  "timestamp": "2024-12-15T18:30:00Z"
}

3. Verifica IP Assegnato​

Ogni GPS riceverà un IP statico dal range 100.64.0.0/10:

# Lista connessioni attive
docker exec decoder netstat -tn | grep :5052

# Output esempio:
# tcp  0  0  10.66.5.20:5052  100.64.25.10:54321  ESTABLISHED
# tcp  0  0  10.66.5.20:5052  100.64.25.11:49876  ESTABLISHED

Mapping Device ID ↔ IP​

Identificazione Dispositivo​

Il decoder identifica ogni GPS tramite:

  1. IMEI (preferito)
  2. Device ID (dal protocollo)
  3. IP Address (come fallback)

Associazione nel Database​

Quando un GPS si connette per la prima volta:

-- Il decoder crea/aggiorna automaticamente
UPDATE devices 
SET 
  last_connection_ip = '100.64.25.10',
  last_seen = NOW(),
  status = 'online'
WHERE imei = '123456789012345';

Query IP → Device​

-- Trova device per IP VPN
SELECT id, name, imei, last_connection_ip
FROM devices
WHERE last_connection_ip = '100.64.25.10';

Troubleshooting​

GPS non si connette​

1. Verifica SIM​

# Sul GPS, invia SMS
STATUS#

# Risposta attesa:
# Signal: 25
# Network: 1NCE
# APN: iot.1nce.net

2. Verifica APN​

# Rileggi APN configurato
APN#

# Se errato, riconfigura
APN,iot.1nce.net#

3. Reset Connessione​

# Reset completo
RESET#

# Oppure solo connessione GPRS
GPRS,0#
GPRS,1#

GPS si connette ma non invia dati​

1. Controlla Log Decoder​

docker logs decoder -f | grep IMEI_DEL_GPS

2. Verifica Protocoll​

Assicurati che il GPS sia configurato per il protocollo corretto:

# Log decoder mostra il protocollo rilevato
docker logs decoder | grep protocol

# Output:
# "protocol": "s21l"  ← Deve corrispondere al tuo GPS

3. Test Manuale​

# Ping IP GPS (se connesso)
docker exec openvpn-client ping -c 3 100.64.25.10

# Dovrebbe rispondere se connesso

Dati GPS non arrivano al database​

Pipeline di processing:

GPS → Decoder → Redis Stream → position-filter → 
position-enricher → db-persister → PostgreSQL

Verifica ogni step:

# 1. Decoder pubblica su Redis?
docker exec redis redis-cli XLEN positions:123

# 2. Filter sta processando?
docker logs position-filter

# 3. Enricher sta processando?
docker logs position-enricher

# 4. DB persister salva?
docker logs db-persister

Comandi Utili​

Reset GPS​

RESET#

Riavvio GPS​

REBOOT#

Factory Reset​

FACTORY#

Verifica Configurazione​

# Leggi tutti i parametri
PARAM#

# Leggi APN
APN#

# Leggi IMEI
IMEI#

# Leggi versione firmware
VERSION#

Best Practices​

1. Documentare IP Assegnati​

Mantieni un registro degli IP assegnati:

Device Name,IMEI,VPN IP,First Seen,Last Seen
GPS-001,123456789012345,100.64.25.10,2024-12-01,2024-12-15
GPS-002,123456789012346,100.64.25.11,2024-12-01,2024-12-15

2. Monitoring Connessioni​

Implementa alert per disconnessioni:

// Event detector
if (device.last_seen < now() - 5 minutes) {
  sendAlert(`GPS ${device.name} offline`);
}

3. Test Prima del Deploy​

Prima di installare su veicolo:

  1. Accendi GPS in ufficio
  2. Verifica connessione VPN
  3. Controlla dati in arrivo
  4. Testa invio comandi
  5. Spegni e riaccendi (test auto-reconnect)

Riferimenti​