Vai al contenuto principale
I limiti di location e charger sono controllati tramite profili con finestre di priorità, condivisi tra gli endpoint di location, charger e cluster.

​
Livelli di priorità

  • Le priorità vanno da 0 (più bassa) a 10 (più alta), seguendo la stessa convenzione dei livelli di stack dei profili di ricarica OCPP.
  • Ogni target (una location o un connettore di un charger) può avere fino a 11 profili — uno per livello di priorità — ciascuno con la propria finestra [startTime, endTime).
  • L’invio di un nuovo profilo a una priorità già esistente per quel target sostituisce quello esistente.

​
Limite effettivo

In ogni momento, il limite effettivo è il limitKw del profilo con priorità più alta la cui finestra è attualmente attiva (startTime <= now < endTime). Se nessun profilo è attualmente attivo:
  • Le location ricadono sul permanentLimitKw (impostato tramite PUT /locations/{locationId}/limit).
  • I charger non hanno un fallback — al di fuori di una finestra attiva, il connettore non è bloccato per priorità ed è gestito dalla normale gestione del carico.

​
Applicazione/ripristino automatico

I profili vengono applicati o ripristinati automaticamente ai rispettivi startTime/endTime — non sono necessarie ulteriori chiamate API una volta creato un profilo. I record dei profili non vengono mai eliminati alla scadenza, quindi la cronologia completa dei profili rimane interrogabile tramite GET /locations/{locationId}/limits e GET /organizations/limits.

​
Valori di stato

Ogni profilo riporta uno status calcolato:
StatusSignificato
SCHEDULEDnow < startTime — non ancora attivo
ACTIVEstartTime <= now < endTime
EXPIREDnow >= endTime

​
Blocchi a livello di charger

POST /chargers/{controllerUuid}/connectors/{connectorId}/schedules crea un profilo per un singolo connettore. Mentre è ACTIVE, il connettore è priority-locked: viene escluso dalla normale gestione del carico e funziona senza limitazioni fino a limitKw — viene limitato (mai sotto la sua soglia minima di 6A) solo come ultima risorsa, se la location nel suo complesso supera il proprio limite di rete.

​
Cluster

Un cluster raggruppa più location sotto un unico tetto massimo opzionale in kW. Quando l’assorbimento combinato del cluster supererebbe limitKw, il limite effettivo di ciascuna location membro viene ridotto proporzionalmente: 
scale = min(1, clusterLimitKw / sum(memberLocationLimits))
locationEffectiveLimit = locationSetLimitKw * scale
POST /clusters/{clusterId}/schedules applica un singolo LimitProfileRequest a tutte le location del cluster contemporaneamente.