NexBlue Guida all'integrazione di AutoCharge

Implementa la registrazione dei veicoli, l’autorizzazione automatica e l’associazione delle transazioni nel tuo CPMS utilizzando i caricatori NexBlue .

ProtocolloOCPP 1.6
Identità del veicoloIndirizzo MAC
Chiave di configurazioneAutoCharge abilitato
Modelli compatibili
SDU

Edge 2 · Edge Max · Point 2

MDU

Delta · Delta Max

1. Compatibilità

1.1 Supporto per caricabatterie

Prima di attivare la funzione AutoCharge su un caricabatterie, inviare GetConfiguration per recuperare le chiavi di configurazione supportate. Un chiave L'array richiede tutte le chiavi supportate.

CPMS → Caricatore · GetConfiguration.req
[
  2,
  "ac-config-001",
  "GetConfiguration",
  {
    "key": []
  }
]

Verifica se AutoCharge abilitato è presente in configurationKey.

Caricatore → CPMS · GetConfiguration.conf · estratto della risposta
[
  3,
  "ac-config-001",
  {
    "configurationKey": [
      {
        "key": "AutoChargeEnabled",
        "readonly": false,
        "value": "false"
      }
    ],
    "unknownKey": []
  }
]
Risultato della ricerca Interpretazione
Key è tornato con value = "true" La funzione AutoCharge è supportata e attivata.
Key è tornato con value = "false" La funzione AutoCharge è supportata ma disattivata.
Chiave assente dall'elenco completo, oppure elencata in unknownKey La funzione AutoCharge non è supportata dall'attuale firmware del caricabatterie.

È inoltre possibile interrogare direttamente la chiave con {"key":["AutoChargeEnabled"]}. Una query fallita o scaduta non costituisce un elemento a sostegno.

1.2 Compatibilità con i veicoli

La funzionalità del caricabatterie e la compatibilità del veicolo sono verifiche distinte. Un veicolo compatibile deve fornire un indirizzo MAC leggibile, stabile e univoco.

Durante i test di integrazione:

  • Verifica che il tuo CPMS riceva Autorizza con idTag = VID:<MAC> quando il veicolo è collegato.
  • Completare la registrazione e ripetere le sessioni del plug-in. Verificare che il VID rimanga costante e che l'autorizzazione automatica vada a buon fine.
  • Annotare il modello del veicolo e la versione del software insieme ai risultati dei test. Escludere i veicoli per i quali è noto che utilizzano identificatori casuali o condivisi.

Gli elenchi di veicoli di terze parti costituiscono solo riferimenti indicativi. Il supporto offerto da un’altra rete di ricarica non garantisce la compatibilità con i caricatori CA di NexBlue . Verificare nuovamente i veicoli interessati qualora un aggiornamento software modifichi l’identificazione o il comportamento di ricarica.

Per i veicoli senza identificazione verificata, assicurati di avere a disposizione i metodi di autorizzazione già in uso.

2. Configurazione

Chiave di configurazione OCPP Tipo Valore
AutoCharge abilitato Booleano vero: attiva la ricarica automatica.
false: disattiva la ricarica automatica.

Dopo aver verificato la compatibilità del caricabatterie, inviare Modifica configurazione con AutoCharge abilitato impostare su "vero" per attivare la funzione, oppure "false" per disattivarlo. I valori di configurazione vengono trasmessi come stringhe.

Riconoscere gli identificativi dei veicoli in arrivo Authorize.req.idTag valori nel seguente formato:

VID:<MAC>

L'esempio MAC 00155D0665D6 diventa VID:00155D0665D6.

3. Immatricolazione dei veicoli

Implementa nel tuo CPMS l'interfaccia di registrazione, la conferma da parte dell'utente e l'associazione tra VID e account. L'identificatore del veicolo viene fornito dal caricatore.

  1. Fornire una procedura di registrazione per un utente autenticato e richiedere all'utente di collegare il veicolo.
  2. Quando il caricabatterie si accende Preparazione, aspettatevi un Autorizza richiesta contenente il VID del veicolo.
Caricatore → CPMS · Authorize.req
[
  2,
  "ac-auth-001",
  "Authorize",
  {
    "idTag": "VID:00155D0665D6"
  }
]
  1. Cerca il numero di identificazione del veicolo (VID). Se il veicolo non è immatricolato, torna indietro Non valido o Bloccato.
  2. Dopo che l'utente ha confermato la registrazione, associa il VID all'account e invia AvviaTransazioneDaRemoto.
  3. Elaborare i dati del caricabatterie Avvia transazione richiedere e restituire il ID transazione in StartTransaction.conf.
  4. Gestire quanto segue Trasferimento dati messaggio per associare il veicolo alla transazione, come definito nella sezione 5.

4. Autorizzazione automatica

Per le successive sessioni del plug-in, gestire i dati in entrata Autorizza richiede quanto segue:

01

Leggi il codice identificativo del veicolo da idTag = VID:<MAC>.

02

Verifica il collegamento dell'account del veicolo e controlla lo stato dell'autorizzazione.

03

Torna indietro Accettato per un veicolo autorizzato. Restituzione Non valido per un VID sconosciuto oppure Bloccato in caso di registrazione bloccata.

04

Quando il caricabatterie invia Avvia transazione, elaborare la richiesta e restituire l'identificativo della transazione.

Tenere separata l’identificazione del veicolo dall’autorizzazione. Il ricevimento di un VID non autorizza il veicolo; è il CPMS a decidere se l’account associato possa effettuare addebiti.

5. Metadati delle transazioni

Dopo la restituzione del CPMS StartTransaction.conf, aspettatevi quanto segue NexBlue Trasferimento dati messaggio che associa l'indirizzo MAC del veicolo alla transazione.

Caricabatterie → CPMS · DataTransfer.req
[
  2,
  "ac-data-001",
  "DataTransfer",
  {
    "vendorId": "com.nexblue.autocharge/v1",
    "messageId": "VID",
    "data": "{\"VID\":\"00155D0665D6\",\"TransactionID\":\"111111111\"}"
  }
]
Campo Valore / formato
vendorId com.nexblue.autocharge/v1
messageId VID
dati Stringa codificata in formato JSON contenente VID e ID transazione.
data.VID Indirizzo MAC del veicolo senza il VIDEO: prefisso.
data.IDTransazione Identificatore della transazione restituito in StartTransaction.conf, rappresentato come stringa.

Decodifica dati in formato JSON, individuare la transazione utilizzando ID transazione, e associarlo a VID. I nomi dei campi distinguono tra maiuscole e minuscole; VID contiene l'indirizzo MAC senza il VIDEO: prefisso.