OCPP

Riferimento del driver OCPP - il sistema centrale integrato, i certificati dei punti di ricarica, i tag dei connettori e la regola di denominazione Meter, Status e Transaction.

Il driver OCPP fa di Ganter Lab il sistema centrale per i punti di ricarica di veicoli elettrici che parlano Open Charge Point Protocol. Come per LoRaWAN, la direzione è rovesciata: la stazione non si collega al caricatore, è il punto di ricarica a collegarsi a Ganter Lab su un WebSocket, a registrarsi e a spingere dentro la propria telemetria.

Il sistema centrale integrato parte quando il primo dispositivo OCPP abilitato viene caricato nel connector in funzione, e si ferma quando l'ultimo viene rimosso o disabilitato: senza alcun punto di ricarica configurato, sulla porta non ascolta proprio nulla. Aggiungerne uno lo fa tornare, senza riavviare l'applicazione. Ogni dispositivo che configuri rappresenta un punto di ricarica, identificato dall'id con cui si collega.

Preparare il punto di ricarica

È il punto di ricarica a chiamare questa stazione e, di fabbrica, non sa dove si trovi. La pagina di ogni dispositivo OCPP porta la scheda Preparare il punto di ricarica, con quello che va inserito nelle impostazioni OCPP del punto di ricarica, scritto per questa stazione:

La scheda è aperta finché il punto di ricarica non si è collegato dall'apertura della stazione, e si richiude una volta collegato: resta nella pagina per la prossima volta che il punto di ricarica verrà configurato. Un punto di ricarica il cui certificato non è garantito da nessuna radice installata in Windows viene rifiutato alla prima connessione e attende in Accesso delle apparecchiature.

Il file viene scritto al primo avvio del sistema centrale, appena un punto di ricarica è registrato, e fino ad allora la scheda lo dice. È lo stesso file per tutti i punti di ricarica di questa stazione, e non cambia quando cambiano il nome o gli indirizzi della stazione (vedere Il certificato radice della stazione).

Ogni punto di ricarica che ha ricevuto un file da una versione precedente ha bisogno di questo, installato una volta. Al primo avvio di questa versione, una stazione i cui punti di ricarica possono avere un file precedente mostra sulla scheda un avviso, Il file di questa stazione è cambiato, solo in quell'esecuzione. L'avviso è un promemoria, non l'istruzione: installare il nuovo file una volta su ogni punto di ricarica di una stazione che aveva già punti di ricarica, che la scheda mostri l'avviso o no. Da allora un punto di ricarica che verifica il nome del server accetta la stazione.

Sistema centrale e porte

L'ascolto è sempre in TLS; un ascolto in HTTP semplice viene rifiutato ovunque tranne che in loopback, che esiste solo per le prove interne al processo. Un punto di ricarica si registra con la sua BootNotification (a cui si risponde con un intervallo di heartbeat di 60 secondi), e ogni badge presentato per l'autorizzazione viene accettato: Ganter Lab osserva la ricarica, non gestisce tariffe né accessi.

Certificati

Il lato server dell'handshake TLS presenta un certificato firmato dalla radice propria di questa stazione (vedere Il certificato radice della stazione). Ogni punto di ricarica deve presentare un certificato client:

1. Deve essere attendibile in uno di due modi: costruisce una catena valida su questa macchina Windows, fino a una radice installata lì, senza errori di politica TLS; oppure proprio questo certificato è stato approvato in Accesso delle apparecchiature sulla pagina di questo driver (più sotto). In entrambi i casi deve essere entro le sue date di validità. Un controllo fallito rifiuta la connessione e il diario registra quale controllo è fallito.
2. Il suo common name di soggetto oppure un nome alternativo di soggetto DNS deve nominare l'id del punto di ricarica con cui si collega. Un certificato che nomina un punto di ricarica diverso da quello del percorso di connessione viene rifiutato, anche se approvato.

Un handshake senza certificato client viene lasciato cadere prima che passi alcun dato.

Il certificato radice della stazione

Una radice memorizzata che non si può più aprire, per esempio perché è stata scritta da un altro account Windows, viene sostituita da una nuova. Ogni punto di ricarica ha allora bisogno del nuovo file, una volta, e la scheda lo dice.

Accesso delle apparecchiature

Un punto di ricarica il cui certificato non è garantito da nessuna radice installata in Windows, perché è autofirmato o emesso dall'autorità del produttore stesso, non ha bisogno che quella radice sia installata su questo computer. La sua prima connessione viene rifiutata, e il suo certificato attende in Accesso delle apparecchiature, in fondo alla pagina del driver OCPP, la stessa scheda della pagina del driver OPC UA, fino a una decisione:

Ogni certificato viene approvato a sé, mai l'autorità che lo ha firmato: un secondo punto di ricarica dello stesso produttore attende quindi la propria approvazione. Confrontare l'impronta con quella indicata dal punto di ricarica prima di approvarlo. L'approvazione non cambia quale punto di ricarica sia il certificato: resta ammesso solo sotto l'id del punto di ricarica che nomina, e solo entro le sue date di validità. Un certificato che Windows considera già attendibile viene ammesso come prima e non compare mai qui; nulla viene approvato automaticamente.

Le decisioni sono conservate nella cartella dei dati della stazione, in ua\pki\ocpp, e sopravvivono a un riavvio. I comandi vengono disegnati solo per un ruolo che può configurare il Connector, e agiscono solo nella finestra della stazione stessa: un browser su un altro dispositivo legge la scheda senza modificarla, e nessuno strumento di un agente approva un certificato. L'elenco tiene fino a 100 certificati in attesa di approvazione; quando è pieno, uno nuovo resta rifiutato ma non viene elencato, e la scheda lo dice.

Campi di connessione

Non ci sono campi per host, porta o credenziali: è il caricatore a tenere i dettagli della connessione, e a questa stazione serve solo sapere quale punto di ricarica il dispositivo intende. Non ci sono nemmeno campi per l'intervallo di interrogazione. OCPP funziona a spinta, cioè è il punto di ricarica a inviare i messaggi MeterValues e StatusNotification secondo la propria cadenza, e i tag si aggiornano dagli ultimi dati ricevuti su un ciclo fisso di un secondo.

Un punto di ricarica che non si è ancora collegato, o un connettore che non ha ancora riferito nulla, non ha quindi alcuna lettura, non una lettura fallita. I suoi tag restano vuoti e nel diario non viene registrato alcun fallimento: un valore che il punto di ricarica non ha ancora inviato è il protocollo che funziona.

Lo stato di salute del punto di ricarica

Poiché un punto di ricarica invia i suoi valori quando li ha, il silenzio dei suoi tag non può distinguere uno che non ha ancora riferito da uno che non c'è più. Il suo stato di salute, il punto sulla sua riga nell'albero e la colonna Stato di salute nella pagina del driver, segue invece il suo collegamento al sistema centrale di questa stazione:

Finché il punto di ricarica è collegato, un connettore che non ha ancora riferito nulla non conta contro di lui. Per al massimo dieci secondi dopo che una modifica al punto di ricarica viene salvata, o che il Connector si avvia, si legge Non ancora noto: rimettere al suo posto il dispositivo può riavviare il sistema centrale, e il punto di ricarica impiega un momento a ricollegarsi.

Tag

Un tag OCPP legge un connettore del punto di ricarica (connettore nel senso di OCPP: una posizione di presa, numerata da 1). In OCPP 2.0, 2.0.1 e 2.1 il numero è quello dell'EVSE, perché lì i connettori ripartono da 1 dentro ogni EVSE. Esistono tre generi di tag, distinti dal suffisso del nome del tag, che viene convalidato:

Un nome senza nessuno di questi suffissi viene rifiutato dalla convalida: chiama i tag come Connector1Meter, Connector1Status e Connector1Transaction.

I tag OCPP sono di sola lettura: il campo dell'accesso non offre alcuna scelta scrivibile, e una scrittura viene rifiutata invece che simulata. Comandare un punto di ricarica è un comando a sé, descritto qui sotto, non un valore scritto su un tag.

Comandi

Un punto di ricarica si comanda oltre che leggere. Ogni dispositivo OCPP porta i comandi qui sotto come metodi sul dispositivo nello spazio degli indirizzi OPC UA proprio di questa stazione, così un client OPC UA connesso a questa stazione emette un comando chiamando il metodo.

Ogni comando prende l'id del punto di ricarica come primo argomento e restituisce come risultato la risposta propria del punto di ricarica.

AttributeType è uno tra Actual, Target, MinSet, MaxSet.

Da dove viene il TransactionId. RemoteStopTransaction e GetTransactionStatus agiscono su una transazione, indicata dal suo numero. Leggilo nel tag Transaction del connettore su cui la sessione ricarica (l'EVSE in OCPP 2.x), per esempio Connector1Transaction, e passalo così come si legge. Un testo vuoto lì significa che su quel connettore non è in corso nessuna transazione.

Un catalogo per ogni versione. I comandi mantengono i nomi qui sopra qualunque versione parli il punto di ricarica, e la stazione invia ciascuno nella forma che quella versione definisce. In OCPP 2.0, 2.0.1 e 2.1 i connettori sono raggruppati sotto degli EVSE, e il numero passato come ConnectorId indica l'EVSE.

Aspettare la risposta. Un comando non è finito quando la stazione lo ha inviato. La stazione tiene aperta la chiamata finché il punto di ricarica non risponde proprio all'ordine che ha inviato, riconosciuto dall'identificatore di correlazione che viaggia con esso, e solo allora riferisce che è riuscito e restituisce la risposta. Tre cose lo chiudono altrimenti, ciascuna riferita come fallimento con il suo motivo:

• Il punto di ricarica non è collegato, oppure la sua connessione non è aperta. Non viene inviato nulla.
• Il punto di ricarica risponde con un errore OCPP, per esempio per un comando che non implementa. Il codice di errore è il motivo.
• Passano 30 secondi senza alcuna risposta. Un comando a cui nessuno ha risposto è un fallimento, mai un successo.

Un comando emesso per un punto di ricarica che nessun dispositivo porta, oppure che non è collegato, viene rifiutato subito invece di essere messo in coda.

Rilevamento

Rileva sul driver OCPP elenca i punti di ricarica attualmente collegati al sistema centrale, e leggere i canali di un candidato propone un tag Meter, un tag Status e un tag Transaction per ogni connettore che il punto di ricarica ha riferito finora.

Il primo punto di ricarica si configura sempre a mano. Nulla si può collegare prima che il sistema centrale ascolti, e lui ascolta solo quando qui esiste un dispositivo OCPP, quindi una scansione di un'installazione senza alcun punto di ricarica configurato non trova nulla e lo dice. Aggiungi quel primo dispositivo con l'id con cui il caricatore si collegherà; dopo di che, un caricatore che si è collegato si può rilevare. Il flusso generale del rilevamento è descritto nella pagina Connector.

L'id viene confrontato senza distinguere maiuscole e minuscole, nel certificato, nel percorso di connessione e rispetto al dispositivo: un caricatore che si collega come cp-a con un certificato che nomina CP-A è lo stesso punto di ricarica di un dispositivo il cui Identificativo si legge CP-A.

Un punto di ricarica che c'è già rilegge i suoi connettori dalla sua stessa pagina: Rileva tag, nell'intestazione della sua scheda Tag, offre i tag Meter, Status e Transaction di ogni connettore che ha riferito mentre era collegato e per cui il dispositivo non ha ancora un tag (vedere Rilevare i tag di un dispositivo).