Quando una colonnina smette di funzionare, il primo indizio arriva di solito sotto forma di messaggio OCPP. La colonnina comunica uno stato come Faulted insieme a un codice di errore e, talvolta, a un codice specifico del produttore con maggiori dettagli. Leggere correttamente questi messaggi evita sopralluoghi inutili e aiuta a risolvere i problemi più rapidamente.
Questa guida spiega gli stati dei connettori di OCPP 1.6 e tutti i codici di errore standard, con la causa tipica e un primo intervento sensato per ciascuno. Descrive poi una procedura di diagnosi, le buone pratiche per reset e sblocchi remoti, come impostare log e avvisi e quando è il momento di inviare un tecnico.
- In OCPP 1.6 le colonnine comunicano stato ed errori nel messaggio
StatusNotification. - L'errorCode standard indica la categoria del problema; i campi facoltativi
vendorErrorCodeeinfospesso ne indicano la causa esatta. - Controllate prima log e storico, poi provate l'azione remota meno invasiva.
- Inviate un tecnico per errori legati alla sicurezza, guasti ripetuti o problemi che i comandi remoti non riescono a risolvere.
Da dove arrivano i codici di errore OCPP
In OCPP 1.6 una colonnina invia una StatusNotification al CSMS ogni volta che lo stato di un connettore cambia o quando si verifica un errore. Il messaggio contiene l'ID del connettore, lo stato, un errorCode e, facoltativamente, un vendorErrorCode, un ID del produttore e un testo info. L'ID connettore 0 si riferisce alla colonnina nel suo insieme.
Un codice di errore diverso da NoError è di solito accompagnato dallo stato Faulted, ma non sempre. Una colonnina può segnalare un errore, ad esempio WeakSignal o HighTemperature, continuando a funzionare in un altro stato. Considerate la combinazione di stato e codice di errore come il quadro completo.
In OCPP 2.0.1 il messaggio StatusNotification è più semplice e comunica solo lo stato del connettore. I problemi dettagliati vengono segnalati come eventi tramite il modello dei dispositivi (ad esempio con NotifyEvent). I concetti di questo articolo restano validi, ma i nomi dei campi sono diversi.
Gli stati dei connettori in OCPP 1.6
| Stato | Significato |
|---|---|
Available | Il connettore è libero e pronto per una nuova sessione. |
Preparing | Un utente ha avviato un'azione, come collegare il cavo o presentare una tessera, ma la ricarica non è ancora iniziata. |
Charging | L'energia viene erogata al veicolo. |
SuspendedEVSE | La colonnina non sta erogando energia, ad esempio per un limite di potenza o per una decisione locale. |
SuspendedEV | Il veicolo non sta accettando energia, ad esempio perché la batteria è carica o perché sta programmando la ricarica. |
Finishing | La transazione è terminata, ma il connettore non è ancora libero, ad esempio perché il cavo è ancora collegato. |
Reserved | Il connettore è riservato a un utente specifico. |
Unavailable | Il connettore è stato disattivato, ad esempio con un comando ChangeAvailability. |
Faulted | Un errore impedisce l'uso del connettore. |
Due stati causano molti falsi allarmi. SuspendedEV è normale quando un veicolo è carico o attende un avvio programmato. Finishing è normale finché il conducente non scollega il cavo. Nessuno dei due è di per sé un guasto.
I codici di errore di OCPP 1.6 spiegati
La tabella elenca tutti i codici di errore standard di OCPP 1.6. Cause e primi interventi sono esempi tipici; consultate sempre il manuale della colonnina, perché i produttori usano i codici in modi leggermente diversi.
| errorCode | Significato | Causa tipica | Primo intervento |
|---|---|---|---|
ConnectorLockFailure | Il blocco del cavo non si è inserito o rilasciato | Problema meccanico del blocco, cavo non inserito completamente | Chiedete al conducente di reinserire il cavo; provate lo sblocco del connettore |
EVCommunicationError | La comunicazione con il veicolo non è riuscita | Problema lato veicolo, cavo o contatti della spina danneggiati | Provate con un altro veicolo prima di sospettare della colonnina |
GroundFailure | Rilevato guasto verso terra o corrente differenziale | Guasto di isolamento, umidità, veicolo o cavo difettoso | Non eseguite reset ripetuti; trattatelo come un problema di sicurezza |
HighTemperature | Temperatura troppo elevata | Sole diretto, ventilazione ostruita, morsetti sovraccarichi | Verificate ventilazione e condizioni ambientali |
InternalError | Errore nell'hardware o nel software della colonnina | Problema firmware o guasto di un componente interno | Leggete il vendorErrorCode; provate un soft reset |
LocalListConflict | Conflitto tra la lista locale e il CSMS | La risposta del CSMS differisce dalla lista di autorizzazione locale | Inviate di nuovo la lista locale dal CSMS |
NoError | Nessun errore | Normale comunicazione di stato | Nessun intervento necessario |
OtherError | Un errore non coperto dagli altri codici | Condizione specifica del produttore | Leggete vendorErrorCode e info, poi consultate il manuale |
OverCurrentFailure | Rilevata sovracorrente | Il veicolo assorbe troppa corrente, problema di cablaggio | Verificate il veicolo e l'impianto |
OverVoltage | Tensione oltre l'intervallo consentito | Disturbo di rete o problema di alimentazione | Verificate l'alimentazione; coinvolgete un elettricista se si ripete |
PowerMeterFailure | Il contatore di energia non può essere letto | Guasto del contatore o problema di cablaggio interno | Controllate i valori del contatore nei log; pianificate un intervento di assistenza |
PowerSwitchFailure | Il contattore o il relè non ha commutato | Contattore usurato o bloccato | Mettete il connettore fuori servizio; inviate un tecnico |
ReaderFailure | Il lettore di identificazione si è guastato | Guasto o danneggiamento del lettore RFID | Provate con una tessera registrata nota; pianificate una riparazione |
ResetFailure | Non è stato possibile eseguire il reset | Problema firmware o hardware | Provate un hard reset o un riavvio con interruzione dell'alimentazione sul posto |
UnderVoltage | Tensione al di sotto dell'intervallo consentito | Alimentazione debole, collegamento allentato, problema di rete | Verificate alimentazione e morsetti |
WeakSignal | Segnale wireless debole | Copertura mobile o Wi-Fi insufficiente | Migliorate la posizione dell'antenna o la rete |
Una procedura di diagnosi pratica
- Leggete il messaggio completo. Esaminate insieme stato, errorCode, vendorErrorCode e info, e annotate l'orario.
- Controllate lo storico. È la prima volta o si tratta di un problema ricorrente? È iniziato dopo un aggiornamento firmware, un'interruzione di corrente o un evento meteorologico?
- Verificate la connettività. Se gli heartbeat si sono interrotti, il problema potrebbe essere la rete e non la colonnina. Consultate la nostra guida al collegamento di una colonnina a un server OCPP per i problemi di connessione più comuni.
- Aggiornate lo stato. Usate
TriggerMessageper richiedere una nuovaStatusNotificatione verificare che l'errore sia ancora attivo. - Provate la soluzione meno invasiva. Sbloccate il connettore, modificate la disponibilità o eseguite un soft reset, in quest'ordine quando ha senso.
- Passate al livello successivo. Se l'errore si ripresenta o riguarda la sicurezza, mettete il connettore fuori servizio e programmate l'intervento di un tecnico.
Regole di buon uso per reset e sblocchi remoti
Un uso poco accorto dei comandi remoti può infastidire i conducenti o nascondere problemi reali.
- Verificate prima le sessioni attive. Un reset interrompe le transazioni in corso. Non riavviate una colonnina mentre qualcuno sta ricaricando, a meno che non sia già inutilizzabile.
- Preferite il soft reset. Un soft reset riavvia il software in modo controllato. Usate l'hard reset solo quando il soft reset non funziona.
- Sbloccate solo su richiesta. Sbloccate un connettore quando un conducente segnala un cavo bloccato, idealmente mentre siete in contatto con lui.
- Non nascondete i guasti di sicurezza. Riavviare ripetutamente dopo un errore
GroundFailureo di sovracorrente può mettere a rischio le persone. - Disattivate i connettori guasti. Impostare un connettore come non disponibile evita che i conducenti perdano tempo finché non viene riparato.
- Registrate cosa avete fatto. Un log dei comandi e dei relativi esiti aiuta chi interviene dopo di voi a capire lo storico.
Il software OCPP di Üreticy supporta dalla dashboard soft reset e hard reset, arresto remoto, sblocco del connettore, modifica della disponibilità, modifica della configurazione e TriggerMessage, e l'esito di ogni comando viene registrato.
Log e avvisi
Un CSMS dovrebbe conservare i messaggi OCPP grezzi, renderli consultabili e avvisare le persone giuste quando qualcosa va storto.
- Log dei messaggi grezzi: il payload esatto della StatusNotification, compresi i campi del produttore, è spesso la via più rapida per una diagnosi.
- Avvisi: notificano al team guasti, disconnessioni e comandi rimasti senza risposta.
- Storico degli stati: una cronologia per connettore mostra se un guasto è nuovo o ricorrente.
Üreticy offre log dei messaggi OCPP consultabili e avvisi per guasti, disconnessioni, timeout dei comandi e superamento dei limiti, insieme a una dashboard in tempo reale dello stato dei connettori. Consultate l'elenco completo delle funzionalità.
Quando inviare un tecnico
- Errori legati alla sicurezza come
GroundFailure,OverCurrentFailureo errori di tensione ripetuti. - Guasti hardware come
PowerSwitchFailure,PowerMeterFailureoReaderFailure. - Qualsiasi guasto che si ripresenta dopo un reset, o una colonnina che resta offline dopo le verifiche di rete.
- Danni visibili segnalati dai conducenti, come cavi, spine o involucri rotti.
- Guasti del lettore di tessere che impediscono l'accesso; consultate la nostra guida all'autorizzazione con tessere RFID per escludere prima problemi legati alle tessere.
Fornite al tecnico i codici di errore, i codici del produttore, gli orari e le azioni remote già tentate.
Domande frequenti
Qual è la differenza tra status ed errorCode in OCPP?
Lo status descrive lo stato del connettore, come Available, Charging o Faulted. L'errorCode descrive un problema, come GroundFailure o InternalError. In OCPP 1.6 entrambi vengono inviati insieme nel messaggio StatusNotification.
Cosa significa vendorErrorCode?
Il vendorErrorCode è un campo facoltativo in cui il produttore della colonnina comunica un proprio codice di errore più dettagliato. Il suo significato è definito nella documentazione del produttore, non in OCPP. Per la diagnosi è spesso più utile dell'errorCode standard.
SuspendedEV è un errore?
No. SuspendedEV significa che il veicolo al momento non accetta energia, ad esempio perché la batteria è carica o perché attende un orario di ricarica programmato. Vale la pena indagare solo se un veicolo che ha bisogno di energia resta in questo stato.
Devo riavviare una colonnina che segnala Faulted?
Un soft reset è un primo passo ragionevole per errori di natura software come InternalError, purché non ci siano sessioni attive. Per errori legati alla sicurezza come GroundFailure non eseguite reset ripetuti: mettete il connettore fuori servizio e coinvolgete un tecnico.
I codici di errore di OCPP 2.0.1 sono gli stessi della 1.6?
No. In OCPP 2.0.1 la StatusNotification comunica solo lo stato del connettore e i problemi dettagliati vengono segnalati come eventi tramite il modello dei dispositivi. L'approccio alla diagnosi è lo stesso, ma messaggi e campi sono diversi.
Visualizzate in un unico posto ogni stato dei connettori, codice di errore e messaggio OCPP, e intervenite sui guasti con comandi remoti registrati. Scoprite il software OCPP di Üreticy oppure contattateci per una presentazione guidata.