Collegare una colonnina a un server OCPP è di solito un'operazione rapida, ma piccoli errori possono costare ore: un carattere sbagliato nel charge point ID, ws al posto di wss o una porta bloccata. La maggior parte dei problemi di connessione deriva da poche cause tipiche, facili da evitare una volta conosciute.
Questa guida passo passo spiega come collegare una colonnina a un server OCPP (CSMS). Illustra i prerequisiti, dove trovare le impostazioni, il significato di ogni campo, come testare la connessione e come risolvere i problemi più comuni. In fondo trovate un esempio con il formato URL di Üreticy.
- Servono quattro elementi: una connessione internet funzionante, un firmware con supporto OCPP, l'URL del server e un charge point ID univoco.
- Il charge point ID è normalmente l'ultima parte del percorso dell'URL e deve corrispondere esattamente, maiuscole e minuscole comprese.
- Usate
wss://(TLS) ogni volta che la colonnina lo supporta e verificate che l'orologio della colonnina sia corretto. - Una connessione riuscita mostra tre segnali: BootNotification accettata, heartbeat regolari e stato del connettore corretto.
Prerequisiti prima di iniziare
Verificate questi punti prima di aprire le impostazioni della colonnina:
- Connessione internet: Ethernet, Wi-Fi o SIM mobile. Per le connessioni tramite SIM, verificate che il piano dati sia attivo e che le impostazioni APN siano corrette.
- Accesso in uscita: la rete deve consentire connessioni in uscita verso il server, di solito sulla porta 443 per
wss://. È la colonnina ad aprire la connessione, quindi non servono porte in ingresso. - Firmware: la colonnina deve avere un firmware con supporto OCPP. Verificate quale versione supporta (1.6J, 2.0.1 o 2.1) e, se necessario, aggiornate all'ultimo firmware stabile del produttore.
- Dati di connessione dal CSMS: l'URL del server, la versione del protocollo e, se prevista, una password.
- Accesso da installatore: le credenziali per l'interfaccia web della colonnina, l'app dell'installatore o lo strumento di configurazione.
Dove si trovano le impostazioni OCPP
Ogni produttore colloca le impostazioni in un punto diverso, ma le opzioni più comuni sono tre:
- Interfaccia web: collegate un portatile alla colonnina tramite cavo o al suo hotspot Wi-Fi e aprite un indirizzo IP locale nel browser.
- App dell'installatore: un'app mobile che si collega alla colonnina via Bluetooth o Wi-Fi.
- Strumento di configurazione: un software desktop, a volte collegato tramite USB o cavo seriale. Alcuni produttori consentono la configurazione anche dal proprio portale cloud.
Cercate voci di menu come "Backend", "OCPP", "Central System" o "Network". Il manuale di installazione di solito dedica una sezione specifica a questo argomento.
I campi da compilare
| Campo (nomi comuni) | Cosa inserire | Note |
|---|---|---|
| Central System URL, CSMS URL, OCPP server URL | L'indirizzo WebSocket fornito dal CSMS | Inizia con ws:// o wss:// |
| Charge Point ID, ChargeBoxIdentity, Station ID | Un nome univoco per questa colonnina | Di solito aggiunto al percorso dell'URL; distingue tra maiuscole e minuscole |
| Versione del protocollo | OCPP 1.6J, 2.0.1 o 2.1 | Deve corrispondere a quanto il CSMS si aspetta per questa colonnina |
| Password, chiave di autorizzazione | La password di autenticazione HTTP Basic | Facoltativa; usata con i profili di sicurezza 1 e 2 |
| Certificato TLS | Certificato root o certificato client | Necessario per wss:// se la colonnina non considera attendibile il certificato del server per impostazione predefinita, e per il profilo 3 |
Come lavorano insieme URL e ID
In OCPP la colonnina si collega all'URL del server aggiungendo il proprio charge point ID alla fine del percorso. Ad esempio, con l'URL del server wss://csms.example.com/ocpp e l'ID CP001, la colonnina si collega a wss://csms.example.com/ocpp/CP001.
Alcune colonnine aggiungono l'ID automaticamente, quindi va inserito solo l'URL di base. Altre si aspettano l'URL completo, ID compreso. Leggete attentamente il manuale: se l'ID viene aggiunto due volte o non viene aggiunto affatto, il CSMS non riconoscerà la colonnina.
Passo dopo passo: collegare la colonnina
- Create o riservate la colonnina nel CSMS, oppure annotate il charge point ID che intendete usare. Adottate uno schema di denominazione chiaro, ad esempio codice del sito più numero.
- Aprite le impostazioni della colonnina tramite interfaccia web, app o strumento di configurazione.
- Impostate la connessione di rete e verificate che la colonnina abbia accesso a internet.
- Inserite l'URL del server e il charge point ID esattamente come descritto sopra.
- Selezionate la versione del protocollo corrispondente alla configurazione del CSMS.
- Inserite password e certificato se la vostra configurazione di sicurezza li prevede.
- Controllate le impostazioni dell'ora. Attivate l'NTP se la colonnina lo supporta e impostate il fuso orario corretto.
- Salvate e riavviate la colonnina o il modulo di comunicazione.
Come testare la connessione
Dopo il riavvio, verificate questi segnali nel CSMS e nei log dei messaggi OCPP:
- BootNotification accettata: la colonnina invia produttore, modello e firmware e il CSMS risponde con Accepted. Una risposta Pending o Rejected significa che la colonnina è nota ma non ancora approvata.
- Heartbeat: gli heartbeat arrivano all'intervallo impostato nella risposta alla BootNotification, in genere ogni 60–300 secondi.
- StatusNotification: ogni connettore comunica uno stato, normalmente Available quando nessun veicolo è collegato.
- Comando remoto: inviate un TriggerMessage o modificate la disponibilità e verificate che la colonnina risponda.
- Sessione di prova: avvicinate una tessera RFID, ricaricate un veicolo per qualche minuto e verificate che compaiano la sessione e i valori del contatore.
Per approfondire questi messaggi, leggete Cos'è OCPP?
Problemi comuni e come risolverli
| Sintomo | Causa probabile | Cosa fare |
|---|---|---|
| La colonnina non compare mai nel CSMS | Nessuna connessione internet, URL errato o porta in uscita bloccata | Verificate lo stato della rete sulla colonnina; testate l'URL; chiedete all'IT di consentire il traffico in uscita sulla porta 443 |
| La connessione viene rifiutata subito | Charge point ID errato o sconosciuto | Confrontate l'ID carattere per carattere, comprese maiuscole, spazi e trattini |
La connessione funziona con ws:// ma non con wss:// | Certificato non attendibile o TLS non supportato | Installate il certificato root corretto o aggiornate il firmware |
| Il TLS fallisce anche se il certificato è corretto | Orologio della colonnina errato | Attivate l'NTP o impostate l'ora manualmente; la validazione del certificato dipende dalla data |
| Errore di autenticazione | Password errata o profilo di sicurezza sbagliato | Reinserite la password e verificate l'impostazione del profilo su entrambi i lati |
| La connessione cade ripetutamente | Segnale mobile debole o rete instabile | Verificate intensità del segnale, posizione dell'antenna e impostazioni di heartbeat e ping |
| La colonnina si collega ma i messaggi falliscono | Versioni del protocollo non corrispondenti | Assicuratevi che colonnina e CSMS usino la stessa versione OCPP |
Esempio: collegare una colonnina a Üreticy
In Üreticy ogni cliente riceve un URL OCPP personale in questo formato:
wss://ocpp.ureticy.com/URT{customer-no}/{charge-point-id}Ad esempio, se il vostro numero cliente fosse 1001 e l'ID della colonnina fosse HOTEL-01, l'indirizzo completo sarebbe wss://ocpp.ureticy.com/URT1001/HOTEL-01. Se la colonnina aggiunge l'ID automaticamente, inserite solo wss://ocpp.ureticy.com/URT1001 come URL di base e HOTEL-01 come charge point ID.
Quando la colonnina si connette con un ID non ancora presente nel vostro account, compare automaticamente nella dashboard come "in attesa". La aggiungete con un clic e da quel momento la colonnina mostra stato, potenza ed energia in tempo reale. Una configurazione tipica richiede circa dieci minuti. Le colonnine OCPP 1.6J, 2.0.1 e 2.1 usano lo stesso formato di URL, su WS o WSS. Se qualcosa non funziona, i log dei messaggi OCPP consultabili mostrano esattamente quali messaggi sono stati scambiati. Maggiori dettagli nella pagina del software OCPP.
Dopo la connessione: i passi successivi
- Date a ogni connettore un nome chiaro e stampate etichette con codice QR, così conducenti e tecnici possono identificarlo.
- Aggiungete tessere RFID e conducenti e stabilite quali stazioni può usare ciascun conducente.
- Impostate avvisi per guasti, disconnessioni e timeout dei comandi.
- Se usate quote di energia, configurate regole di limite in kWh per conducente o per veicolo. La pagina su limiti kWh e smart charging spiega come funzionano.
Domande frequenti
Serve un indirizzo IP statico per collegare una colonnina a un server OCPP?
Di solito no. In OCPP-J è la colonnina ad aprire una connessione WebSocket in uscita verso il server, quindi non ha bisogno di un indirizzo IP pubblico o statico. La rete deve solo consentire le connessioni in uscita verso l'indirizzo e la porta del server.
Qual è la differenza tra ws:// e wss://?
Entrambi sono indirizzi WebSocket. ws:// invia i dati senza crittografia, mentre wss:// cifra la connessione con TLS. Usate wss:// ogni volta che la colonnina lo supporta, perché protegge ID delle tessere, valori del contatore e password.
Posso cambiare il charge point ID in seguito?
Tecnicamente sì, ma il CSMS tratterà il nuovo ID come una nuova colonnina. Storico delle sessioni e impostazioni restano associati al vecchio ID, a meno che il software non consenta di migrarli. Conviene scegliere fin dall'inizio uno schema di denominazione chiaro e definitivo.
Perché la mia colonnina risulta Pending dopo la BootNotification?
Pending significa che il CSMS ha ricevuto la colonnina ma non l'ha ancora accettata del tutto, ad esempio perché non è ancora assegnata a un account. Approvate o aggiungete la colonnina nel CSMS e verrà accettata al successivo avvio o tentativo.
Come sposto una colonnina da un server OCPP a un altro?
Modificate nelle impostazioni della colonnina l'URL del server e, se necessario, il charge point ID e la password, quindi riavviatela. Prima esportate lo storico delle sessioni dal vecchio sistema. Poiché OCPP è aperto, non è necessario sostituire l'hardware.
Pronti a collegare la vostra prima colonnina? Ottenete il vostro URL OCPP personale con il software OCPP di Üreticy, oppure contattateci se vi serve aiuto con un modello specifico di colonnina.