Preskočiť na obsah
Začať zadarmo

Referenčná príručka protokolu OCPP 1.6J.

Čo si nabíjacia stanica a jej backoffice hovoria: všetkých 28 správ s ich poľami a príkladom, 43 konfiguračných kľúčov, čo dokáže nabíjacia stanica merať a čo sa v praxi pokazí.

Prehľadať príručku Začať zadarmo

SprávyKonfiguračné kľúčeMeracie veličinyOtázky

Čo je OCPP 1.6J?

OCPP, Open Charge Point Protocol, je bezplatný a otvorený štandard organizácie Open Charge Alliance. Určuje, ako nabíjacia stanica komunikuje so softvérom, ktorý ju spravuje: v špecifikácii je to Central System, na trhu backoffice.

Vo verzii 1.6J nabíjacia stanica otvorí WebSocket do backofficu a obe strany cez neho posielajú JSON správy. Nabíjacia stanica hlási svoj stav, namerané hodnoty a nabíjania. Backoffice spúšťa a zastavuje nabíjania, mení nastavenia a nastavuje limity nabíjania.

Keďže je štandard otvorený, nabíjacia stanica, ktorá ním hovorí, sa môže pripojiť aj k iným backoffice systémom, ktoré ho podporujú, v závislosti od modelu, firmvéru a konfigurácie. Vďaka tomu môžete na jednej lokalite kombinovať značky a presunúť nabíjaciu stanicu do iného backofficu. Ak chcete jednu nabíjaciu stanicu prevádzkovať na viacerých backoffice systémoch naraz, použite OCPP proxy.

  • Otvorený štandardImplementácia je bezplatná, štandard spravuje Open Charge Alliance.
  • WebSocket a JSONJedno spojenie, ktoré zostáva otvorené, so štruktúrovanými správami.
  • 28 správV šiestich profiloch funkcií, od Core po Remote Trigger.
  • Oba smeryNabíjacia stanica aj backoffice začínajú vlastné správy.

Všetkých 28 správ OCPP 1.6

Každá správa je požiadavka jednej strany a odpoveď druhej, spárované jedinečným ID správy.

Core

Povinný. Základné operácie nabíjacieho bodu: autorizácia, nabíjania, hlásenie stavu, konfigurácia a základné diaľkové ovládanie.

Žiada o autorizáciu idTagu pred povolením nabíjania.

Request
PoleTypPoužitieČo obsahuje
idTagstringPovinnéIdentifikátor na autorizáciu. Najviac 20 znakov.
Response
PoleTypPoužitieČo obsahuje
idTagInfoobjectPovinnéInformácie o autorizácii idTagu.
statusstringPovinnéStav autorizácie. Jedna z hodnôt Accepted, Blocked, Expired, Invalid, ConcurrentTx.
expiryDatestringVoliteľnéDátum a čas, po ktorom sa idTag považuje za neplatný. Dátum a čas.
parentIdTagstringVoliteľnéNadradený idTag pre skupinovú autorizáciu. Najviac 20 znakov.
Príklad
Nabíjacia stanica posiela
[2, "7f83df9c", "Authorize", {
  "idTag": "04A2B3C4D5E6F7"
}]
Backoffice odpovedá
[3, "7f83df9c", {
  "idTagInfo": {
    "status": "Accepted"
  }
}]

V OCPP 2.0.1: Authorize

Posiela sa po spustení na registráciu v backoffice systéme.

Request
PoleTypPoužitieČo obsahuje
chargePointVendorstringPovinnéVýrobca nabíjacieho bodu. Najviac 20 znakov.
chargePointModelstringPovinnéModel nabíjacieho bodu. Najviac 20 znakov.
chargePointSerialNumberstringVoliteľnéSériové číslo nabíjacieho bodu. Najviac 25 znakov.
chargeBoxSerialNumberstringVoliteľnéSériové číslo charge boxu. Najviac 25 znakov.
firmwareVersionstringVoliteľnéVerzia firmvéru nabíjacieho bodu. Najviac 50 znakov.
iccidstringVoliteľnéICCID SIM karty. Najviac 20 znakov.
imsistringVoliteľnéIMSI SIM karty. Najviac 20 znakov.
meterTypestringVoliteľnéTyp elektromera. Najviac 25 znakov.
meterSerialNumberstringVoliteľnéSériové číslo elektromera. Najviac 25 znakov.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéStav registrácie. Jedna z hodnôt Accepted, Pending, Rejected.
currentTimestringPovinnéAktuálny čas Central System. Dátum a čas.
intervalintegerPovinnéInterval heartbeatu v sekundách.
Príklad
Nabíjacia stanica posiela
[2, "392b5b40", "BootNotification", {
  "chargePointVendor": "ExampleVendor",
  "chargePointModel": "ExampleModel",
  "firmwareVersion": "1.4.2"
}]
Backoffice odpovedá
[3, "392b5b40", {
  "status": "Accepted",
  "currentTime": "2026-10-06T09:30:00Z",
  "interval": 300
}]

V OCPP 2.0.1: BootNotification

Mení dostupnosť konektora.

Request
PoleTypPoužitieČo obsahuje
connectorIdintegerPovinnéID konektora (0 = celý nabíjací bod).
typestringPovinnéPožadovaná zmena dostupnosti. Jedna z hodnôt Inoperative, Operative.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéVýsledok požiadavky na zmenu dostupnosti. Jedna z hodnôt Accepted, Rejected, Scheduled.
Príklad
Backoffice posiela
[2, "be3dcf2e", "ChangeAvailability", {
  "connectorId": 1,
  "type": "Operative"
}]
Nabíjacia stanica odpovedá
[3, "be3dcf2e", {
  "status": "Accepted"
}]

V OCPP 2.0.1: ChangeAvailability

Mení konfiguračný kľúč na nabíjacej stanici.

Request
PoleTypPoužitieČo obsahuje
keystringPovinnéKonfiguračný kľúč, ktorý sa má zmeniť. Najviac 50 znakov.
valuestringPovinnéNová hodnota konfiguračného kľúča. Najviac 500 znakov.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéVýsledok zmeny konfigurácie. Jedna z hodnôt Accepted, Rejected, RebootRequired, NotSupported.
Príklad
Backoffice posiela
[2, "6fdf2255", "ChangeConfiguration", {
  "key": "MeterValueSampleInterval",
  "value": "60"
}]
Nabíjacia stanica odpovedá
[3, "6fdf2255", {
  "status": "Accepted"
}]

V OCPP 2.0.1: SetVariables

Vymaže autorizačnú cache na nabíjacej stanici.

Request

Žiadne polia: požiadavka je prázdna.

Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéVýsledok požiadavky na vymazanie cache. Jedna z hodnôt Accepted, Rejected.
Príklad
Backoffice posiela
[2, "e993e844", "ClearCache", {}]
Nabíjacia stanica odpovedá
[3, "e993e844", {
  "status": "Accepted"
}]

V OCPP 2.0.1: ClearCache

Výmena údajov špecifických pre výrobcu.

Request
PoleTypPoužitieČo obsahuje
vendorIdstringPovinnéIdentifikuje výrobcu. Najviac 255 znakov.
messageIdstringVoliteľnéDoplnková identifikácia správy. Najviac 50 znakov.
datastringVoliteľnéÚdaje špecifické pre výrobcu.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéVýsledok prenosu údajov. Jedna z hodnôt Accepted, Rejected, UnknownMessageId, UnknownVendorId.
datastringVoliteľnéÚdaje odpovede špecifické pre výrobcu.
Príklad
Jedna strana posiela
[2, "e1a403d5", "DataTransfer", {
  "vendorId": "com.example"
}]
Druhá strana odpovedá
[3, "e1a403d5", {
  "status": "Accepted"
}]

V OCPP 2.0.1: DataTransfer

Načíta konfiguračné kľúče z nabíjacej stanice.

Request
PoleTypPoužitieČo obsahuje
keyarrayVoliteľnéZoznam konfiguračných kľúčov na načítanie. Položky: najviac 50 znakov.
Response
PoleTypPoužitieČo obsahuje
configurationKeyarrayVoliteľnéZoznam známych konfiguračných kľúčov.
keystringPovinnéNázov konfiguračného kľúča. Najviac 50 znakov.
readonlybooleanPovinnéČi je kľúč iba na čítanie.
valuestringVoliteľnéAktuálna hodnota kľúča. Najviac 500 znakov.
unknownKeyarrayVoliteľnéZoznam požadovaných kľúčov, ktoré sú neznáme. Položky: najviac 50 znakov.
Príklad
Backoffice posiela
[2, "02bd00f5", "GetConfiguration", {
  "key": [
    "MeterValueSampleInterval"
  ]
}]
Nabíjacia stanica odpovedá
[3, "02bd00f5", {
  "configurationKey": [
    {
      "key": "MeterValueSampleInterval",
      "readonly": false,
      "value": "60"
    }
  ]
}]

V OCPP 2.0.1: GetBaseReport a GetVariables

Pravidelný keep-alive, ktorým backoffice vie, že nabíjacia stanica je online.

Request

Žiadne polia: požiadavka je prázdna.

Response
PoleTypPoužitieČo obsahuje
currentTimestringPovinnéAktuálny čas Central System. Dátum a čas.
Príklad
Nabíjacia stanica posiela
[2, "83622997", "Heartbeat", {}]
Backoffice odpovedá
[3, "83622997", {
  "currentTime": "2026-10-06T09:30:00Z"
}]

V OCPP 2.0.1: Heartbeat

Posiela pravidelné alebo vyžiadané odpočty elektromera.

Request
PoleTypPoužitieČo obsahuje
connectorIdintegerPovinnéID konektora (0 = hlavný elektromer).
meterValuearrayPovinnéJedna alebo viac nameraných hodnôt s časovými značkami.
timestampstringPovinnéČasová značka nameranej hodnoty. Dátum a čas.
sampledValuearrayPovinnéJedna alebo viac vzorkovaných hodnôt.
valuestringPovinnéNameraná hodnota.
contextstringVoliteľnéKontext odpočtu. Jedna z hodnôt Interruption.Begin, Interruption.End, Sample.Clock, Sample.Periodic, Transaction.Begin, Transaction.End, Trigger, Other.
formatstringVoliteľnéFormát hodnoty. Jedna z hodnôt Raw, SignedData.
measurandstringVoliteľnéTyp merania. Jedna z hodnôt Energy.Active.Export.Register, Energy.Active.Import.Register, Energy.Reactive.Export.Register, Energy.Reactive.Import.Register, Energy.Active.Export.Interval, Energy.Active.Import.Interval, Energy.Reactive.Export.Interval, Energy.Reactive.Import.Interval, Power.Active.Export, Power.Active.Import, Power.Offered, Power.Reactive.Export, Power.Reactive.Import, Power.Factor, Current.Import, Current.Export, Current.Offered, Voltage, Frequency, Temperature, SoC, RPM.
phasestringVoliteľnéFáza, na ktorú sa meranie vzťahuje. Jedna z hodnôt L1, L2, L3, N, L1-N, L2-N, L3-N, L1-L2, L2-L3, L3-L1.
locationstringVoliteľnéMiesto merania. Jedna z hodnôt Cable, EV, Inlet, Outlet, Body.
unitstringVoliteľnéJednotka merania. Jedna z hodnôt Wh, kWh, varh, kvarh, W, kW, VA, kVA, var, kvar, A, V, K, Celcius, Celsius, Fahrenheit, Percent.
transactionIdintegerVoliteľnéNabíjanie, ku ktorému tieto namerané hodnoty patria.
Response

Žiadne polia: odpoveď je prázdna.

Príklad
Nabíjacia stanica posiela
[2, "80a15023", "MeterValues", {
  "connectorId": 1,
  "meterValue": [
    {
      "timestamp": "2026-10-06T09:30:00Z",
      "sampledValue": [
        {
          "value": "19840",
          "measurand": "Energy.Active.Import.Register",
          "unit": "Wh"
        }
      ]
    }
  ],
  "transactionId": 4521
}]
Backoffice odpovedá
[3, "80a15023", {}]

V OCPP 2.0.1: MeterValues

Na diaľku spustí nabíjanie.

Request
PoleTypPoužitieČo obsahuje
idTagstringPovinnéIdentifikátor, ktorý sa použije pre toto nabíjanie. Najviac 20 znakov.
connectorIdintegerVoliteľnéKonektor, na ktorom sa má začať.
chargingProfileobjectVoliteľnéNabíjací profil, ktorý sa použije pre toto nabíjanie.
chargingProfileIdintegerPovinnéJedinečný identifikátor tohto nabíjacieho profilu.
stackLevelintegerPovinnéÚroveň priority profilu (vyššia = vyššia priorita).
chargingProfilePurposestringPovinnéÚčel nabíjacieho profilu. Jedna z hodnôt ChargePointMaxProfile, TxDefaultProfile, TxProfile.
chargingProfileKindstringPovinnéDruh rozvrhu. Jedna z hodnôt Absolute, Recurring, Relative.
chargingScheduleobjectPovinnéRozvrh nabíjania.
chargingRateUnitstringPovinnéJednotka nabíjacieho výkonu (ampéry alebo watty). Jedna z hodnôt A, W.
chargingSchedulePeriodarrayPovinnéZoznam období rozvrhu.
startPeriodintegerPovinnéZačiatok obdobia v sekundách od začiatku rozvrhu.
limitnumberPovinnéLimit výkonu alebo prúdu počas tohto obdobia. V krokoch po 0,1.
numberPhasesintegerVoliteľnéPočet fáz, ktoré sa majú použiť na nabíjanie.
durationintegerVoliteľnéTrvanie rozvrhu v sekundách.
startSchedulestringVoliteľnéDátum a čas začiatku rozvrhu. Dátum a čas.
minChargingRatenumberVoliteľnéNajnižší podporovaný nabíjací výkon. V krokoch po 0,1.
transactionIdintegerVoliteľnéNabíjanie, na ktoré sa tento profil vzťahuje.
recurrencyKindstringVoliteľnéFrekvencia opakovania pri opakujúcich sa profiloch. Jedna z hodnôt Daily, Weekly.
validFromstringVoliteľnéDátum a čas, od ktorého profil platí. Dátum a čas.
validTostringVoliteľnéDátum a čas, po ktorom profil už neplatí. Dátum a čas.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéČi nabíjací bod požiadavku prijal. Jedna z hodnôt Accepted, Rejected.
Príklad
Backoffice posiela
[2, "b7e2ef8a", "RemoteStartTransaction", {
  "idTag": "04A2B3C4D5E6F7",
  "connectorId": 1
}]
Nabíjacia stanica odpovedá
[3, "b7e2ef8a", {
  "status": "Accepted"
}]

V OCPP 2.0.1: RequestStartTransaction

Na diaľku zastaví nabíjanie.

Request
PoleTypPoužitieČo obsahuje
transactionIdintegerPovinnéID nabíjania, ktoré sa má zastaviť.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéČi nabíjací bod požiadavku prijal. Jedna z hodnôt Accepted, Rejected.
Príklad
Backoffice posiela
[2, "7fb0afb2", "RemoteStopTransaction", {
  "transactionId": 4521
}]
Nabíjacia stanica odpovedá
[3, "7fb0afb2", {
  "status": "Accepted"
}]

V OCPP 2.0.1: RequestStopTransaction

Reštartuje nabíjací bod (tvrdo alebo mäkko).

Request
PoleTypPoužitieČo obsahuje
typestringPovinnéTyp reštartu. Jedna z hodnôt Hard, Soft.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéČi nabíjací bod reštart prijal. Jedna z hodnôt Accepted, Rejected.
Príklad
Backoffice posiela
[2, "526d688f", "Reset", {
  "type": "Soft"
}]
Nabíjacia stanica odpovedá
[3, "526d688f", {
  "status": "Accepted"
}]

V OCPP 2.0.1: Reset

Oznamuje backofficu, že sa nabíjanie začalo.

Request
PoleTypPoužitieČo obsahuje
connectorIdintegerPovinnéKonektor, na ktorom sa nabíjanie začalo.
idTagstringPovinnéIdentifikátor použitý na spustenie nabíjania. Najviac 20 znakov.
meterStartintegerPovinnéStav elektromera na začiatku nabíjania (Wh).
timestampstringPovinnéČasová značka začiatku nabíjania. Dátum a čas.
reservationIdintegerVoliteľnéID použitej rezervácie.
Response
PoleTypPoužitieČo obsahuje
idTagInfoobjectPovinnéInformácie o autorizácii idTagu.
statusstringPovinnéStav autorizácie. Jedna z hodnôt Accepted, Blocked, Expired, Invalid, ConcurrentTx.
expiryDatestringVoliteľnéDátum a čas, po ktorom sa idTag považuje za neplatný. Dátum a čas.
parentIdTagstringVoliteľnéNadradený idTag pre skupinovú autorizáciu. Najviac 20 znakov.
transactionIdintegerPovinnéID nabíjania, ktoré pridelil Central System.
Príklad
Nabíjacia stanica posiela
[2, "2410a6a5", "StartTransaction", {
  "connectorId": 1,
  "idTag": "04A2B3C4D5E6F7",
  "meterStart": 12500,
  "timestamp": "2026-10-06T09:30:00Z"
}]
Backoffice odpovedá
[3, "2410a6a5", {
  "idTagInfo": {
    "status": "Accepted"
  },
  "transactionId": 4521
}]

V OCPP 2.0.1: TransactionEvent

Hlási aktuálny stav a prípadné chyby konektora.

Request
PoleTypPoužitieČo obsahuje
connectorIdintegerPovinnéKonektor, pre ktorý sa hlási stav.
errorCodestringPovinnéKód chyby (NoError, ak chyba nie je). Jedna z hodnôt ConnectorLockFailure, EVCommunicationError, GroundFailure, HighTemperature, InternalError, LocalListConflict, NoError, OtherError, OverCurrentFailure, PowerMeterFailure, PowerSwitchFailure, ReaderFailure, ResetFailure, UnderVoltage, OverVoltage, WeakSignal.
statusstringPovinnéAktuálny stav konektora. Jedna z hodnôt Available, Preparing, Charging, SuspendedEVSE, SuspendedEV, Finishing, Reserved, Unavailable, Faulted.
infostringVoliteľnéDoplňujúce informácie o stave vo voľnom texte. Najviac 50 znakov.
timestampstringVoliteľnéČasová značka zmeny stavu. Dátum a čas.
vendorIdstringVoliteľnéIdentifikátor špecifický pre výrobcu. Najviac 255 znakov.
vendorErrorCodestringVoliteľnéKód chyby špecifický pre výrobcu. Najviac 50 znakov.
Response

Žiadne polia: odpoveď je prázdna.

Príklad
Nabíjacia stanica posiela
[2, "d9b0420e", "StatusNotification", {
  "connectorId": 1,
  "errorCode": "NoError",
  "status": "Available"
}]
Backoffice odpovedá
[3, "d9b0420e", {}]

V OCPP 2.0.1: StatusNotification

Oznamuje backofficu, že sa nabíjanie skončilo.

Request
PoleTypPoužitieČo obsahuje
transactionIdintegerPovinnéID nabíjania, ktoré sa zastavuje.
timestampstringPovinnéČasová značka ukončenia nabíjania. Dátum a čas.
meterStopintegerPovinnéStav elektromera na konci nabíjania (Wh).
idTagstringVoliteľnéIdentifikátor, ktorý požiadal o zastavenie. Najviac 20 znakov.
reasonstringVoliteľnéDôvod zastavenia nabíjania. Jedna z hodnôt EmergencyStop, EVDisconnected, HardReset, Local, Other, PowerLoss, Reboot, Remote, SoftReset, UnlockCommand, DeAuthorized.
transactionDataarrayVoliteľnéPole objektov MeterValue (rovnaká štruktúra ako MeterValues.meterValue).
timestampstringPovinnéČasová značka nameranej hodnoty. Dátum a čas.
sampledValuearrayPovinnéJedna alebo viac vzorkovaných hodnôt.
valuestringPovinnéNameraná hodnota.
contextstringVoliteľnéKontext odpočtu. Jedna z hodnôt Interruption.Begin, Interruption.End, Sample.Clock, Sample.Periodic, Transaction.Begin, Transaction.End, Trigger, Other.
formatstringVoliteľnéFormát hodnoty. Jedna z hodnôt Raw, SignedData.
measurandstringVoliteľnéTyp merania. Jedna z hodnôt Energy.Active.Export.Register, Energy.Active.Import.Register, Energy.Reactive.Export.Register, Energy.Reactive.Import.Register, Energy.Active.Export.Interval, Energy.Active.Import.Interval, Energy.Reactive.Export.Interval, Energy.Reactive.Import.Interval, Power.Active.Export, Power.Active.Import, Power.Offered, Power.Reactive.Export, Power.Reactive.Import, Power.Factor, Current.Import, Current.Export, Current.Offered, Voltage, Frequency, Temperature, SoC, RPM.
phasestringVoliteľnéFáza, na ktorú sa meranie vzťahuje. Jedna z hodnôt L1, L2, L3, N, L1-N, L2-N, L3-N, L1-L2, L2-L3, L3-L1.
locationstringVoliteľnéMiesto merania. Jedna z hodnôt Cable, EV, Inlet, Outlet, Body.
unitstringVoliteľnéJednotka merania. Jedna z hodnôt Wh, kWh, varh, kvarh, W, kW, VA, kVA, var, kvar, A, V, K, Celcius, Celsius, Fahrenheit, Percent.
Response
PoleTypPoužitieČo obsahuje
idTagInfoobjectVoliteľnéInformácie o autorizácii idTagu.
statusstringPovinnéStav autorizácie. Jedna z hodnôt Accepted, Blocked, Expired, Invalid, ConcurrentTx.
expiryDatestringVoliteľnéDátum a čas, po ktorom sa idTag považuje za neplatný. Dátum a čas.
parentIdTagstringVoliteľnéNadradený idTag pre skupinovú autorizáciu. Najviac 20 znakov.
Príklad
Nabíjacia stanica posiela
[2, "b380dc07", "StopTransaction", {
  "transactionId": 4521,
  "timestamp": "2026-10-06T09:30:00Z",
  "meterStop": 19840,
  "idTag": "04A2B3C4D5E6F7"
}]
Backoffice odpovedá
[3, "b380dc07", {
  "idTagInfo": {
    "status": "Accepted"
  }
}]

V OCPP 2.0.1: TransactionEvent

Na diaľku odomkne konektor.

Request
PoleTypPoužitieČo obsahuje
connectorIdintegerPovinnéKonektor, ktorý sa má odomknúť.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéVýsledok požiadavky na odomknutie. Jedna z hodnôt Unlocked, UnlockFailed, NotSupported.
Príklad
Backoffice posiela
[2, "882ccab0", "UnlockConnector", {
  "connectorId": 1
}]
Nabíjacia stanica odpovedá
[3, "882ccab0", {
  "status": "Unlocked"
}]

V OCPP 2.0.1: UnlockConnector

Správa firmvéru

Aktualizácie firmvéru a nahrávanie diagnostiky na vzdialenú údržbu nabíjacích bodov.

Žiada nabíjaciu stanicu, aby nahrala diagnostické logy.

Request
PoleTypPoužitieČo obsahuje
locationstringPovinnéURI, kam sa má diagnostika nahrať. Adresa (URI).
retriesintegerVoliteľnéPočet opakovaní nahrávania.
retryIntervalintegerVoliteľnéSekundy medzi pokusmi.
startTimestringVoliteľnéZačiatok časového rozsahu na zber logov. Dátum a čas.
stopTimestringVoliteľnéKoniec časového rozsahu na zber logov. Dátum a čas.
Response
PoleTypPoužitieČo obsahuje
fileNamestringVoliteľnéNázov súboru s diagnostikou. Najviac 255 znakov.
Príklad
Backoffice posiela
[2, "da7920cd", "GetDiagnostics", {
  "location": "ftp://files.example.com/diagnostics/"
}]
Nabíjacia stanica odpovedá
[3, "da7920cd", {}]

V OCPP 2.0.1: GetLog

Hlási stav nahrávania diagnostiky.

Request
PoleTypPoužitieČo obsahuje
statusstringPovinnéAktuálny stav nahrávania diagnostiky. Jedna z hodnôt Idle, Uploaded, UploadFailed, Uploading.
Response

Žiadne polia: odpoveď je prázdna.

Príklad
Nabíjacia stanica posiela
[2, "d1c853b4", "DiagnosticsStatusNotification", {
  "status": "Uploaded"
}]
Backoffice odpovedá
[3, "d1c853b4", {}]

V OCPP 2.0.1: LogStatusNotification

Hlási stav aktualizácie firmvéru.

Request
PoleTypPoužitieČo obsahuje
statusstringPovinnéAktuálny stav aktualizácie firmvéru. Jedna z hodnôt Downloaded, DownloadFailed, Downloading, Idle, InstallationFailed, Installing, Installed.
Response

Žiadne polia: odpoveď je prázdna.

Príklad
Nabíjacia stanica posiela
[2, "dc9afcb2", "FirmwareStatusNotification", {
  "status": "Installed"
}]
Backoffice odpovedá
[3, "dc9afcb2", {}]

V OCPP 2.0.1: FirmwareStatusNotification

Prikáže nabíjacej stanici stiahnuť a nainštalovať nový firmvér.

Request
PoleTypPoužitieČo obsahuje
locationstringPovinnéURI, odkiaľ sa dá firmvér stiahnuť. Adresa (URI).
retrieveDatestringPovinnéDátum a čas, po ktorom má nabíjacia stanica firmvér stiahnuť. Dátum a čas.
retriesintegerVoliteľnéPočet opakovaní sťahovania.
retryIntervalintegerVoliteľnéSekundy medzi pokusmi.
Response

Žiadne polia: odpoveď je prázdna.

Príklad
Backoffice posiela
[2, "a57cc6a2", "UpdateFirmware", {
  "location": "ftp://files.example.com/fw-1.4.3.bin",
  "retrieveDate": "2026-10-07T02:00:00Z"
}]
Nabíjacia stanica odpovedá
[3, "a57cc6a2", {}]

V OCPP 2.0.1: UpdateFirmware

Lokálny autorizačný zoznam

Správa lokálneho autorizačného zoznamu na nabíjacom bode na autentifikáciu offline.

Načíta číslo verzie lokálneho autorizačného zoznamu.

Request

Žiadne polia: požiadavka je prázdna.

Response
PoleTypPoužitieČo obsahuje
listVersionintegerPovinnéAktuálne číslo verzie lokálneho autorizačného zoznamu.
Príklad
Backoffice posiela
[2, "ccf23a29", "GetLocalListVersion", {}]
Nabíjacia stanica odpovedá
[3, "ccf23a29", {
  "listVersion": 1
}]

V OCPP 2.0.1: GetLocalListVersion

Posiela úplnú alebo čiastočnú aktualizáciu lokálneho autorizačného zoznamu.

Request
PoleTypPoužitieČo obsahuje
listVersionintegerPovinnéČíslo verzie tejto aktualizácie zoznamu.
updateTypestringPovinnéČi ide o úplnú náhradu alebo rozdielovú aktualizáciu. Jedna z hodnôt Differential, Full.
localAuthorizationListarrayVoliteľnéZoznam autorizačných záznamov.
idTagstringPovinnéIdentifikátor na autorizáciu. Najviac 20 znakov.
idTagInfoobjectVoliteľnéInformácie o autorizácii idTagu.
statusstringPovinnéStav autorizácie. Jedna z hodnôt Accepted, Blocked, Expired, Invalid, ConcurrentTx.
expiryDatestringVoliteľnéDátum a čas, po ktorom sa idTag považuje za neplatný. Dátum a čas.
parentIdTagstringVoliteľnéNadradený idTag pre skupinovú autorizáciu. Najviac 20 znakov.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéVýsledok aktualizácie lokálneho zoznamu. Jedna z hodnôt Accepted, Failed, NotSupported, VersionMismatch.
Príklad
Backoffice posiela
[2, "a23c9563", "SendLocalList", {
  "listVersion": 1,
  "updateType": "Full",
  "localAuthorizationList": [
    {
      "idTag": "04A2B3C4D5E6F7",
      "idTagInfo": {
        "status": "Accepted"
      }
    }
  ]
}]
Nabíjacia stanica odpovedá
[3, "a23c9563", {
  "status": "Accepted"
}]

V OCPP 2.0.1: SendLocalList

Rezervácia

Rezervácia konektora pre konkrétneho používateľa vopred.

Zruší existujúcu rezerváciu.

Request
PoleTypPoužitieČo obsahuje
reservationIdintegerPovinnéID rezervácie, ktorá sa má zrušiť.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéČi bola rezervácia zrušená. Jedna z hodnôt Accepted, Rejected.
Príklad
Backoffice posiela
[2, "63258356", "CancelReservation", {
  "reservationId": 7
}]
Nabíjacia stanica odpovedá
[3, "63258356", {
  "status": "Accepted"
}]

V OCPP 2.0.1: CancelReservation

Vytvorí rezerváciu na konkrétnom konektore.

Request
PoleTypPoužitieČo obsahuje
connectorIdintegerPovinnéKonektor na rezerváciu (0 = žiadny konkrétny konektor).
expiryDatestringPovinnéDátum a čas, kedy rezervácia vyprší. Dátum a čas.
idTagstringPovinnéIdentifikátor, pre ktorý sa rezervácia vytvára. Najviac 20 znakov.
reservationIdintegerPovinnéJedinečné ID tejto rezervácie.
parentIdTagstringVoliteľnéNadradený idTag pre skupinovú rezerváciu. Najviac 20 znakov.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéVýsledok požiadavky na rezerváciu. Jedna z hodnôt Accepted, Faulted, Occupied, Rejected, Unavailable.
Príklad
Backoffice posiela
[2, "62a25d78", "ReserveNow", {
  "connectorId": 1,
  "expiryDate": "2026-10-06T10:00:00Z",
  "idTag": "04A2B3C4D5E6F7",
  "reservationId": 7
}]
Nabíjacia stanica odpovedá
[3, "62a25d78", {
  "status": "Accepted"
}]

V OCPP 2.0.1: ReserveNow

Inteligentné nabíjanie

Nastavenie a správa nabíjacích profilov na vyvažovanie zaťaženia, integráciu fotovoltiky a plánované nabíjanie.

Odstráni jeden alebo viac nabíjacích profilov z nabíjacej stanice.

Request
PoleTypPoužitieČo obsahuje
idintegerVoliteľnéID nabíjacieho profilu, ktorý sa má odstrániť.
connectorIdintegerVoliteľnéKonektor, z ktorého sa majú profily odstrániť.
chargingProfilePurposestringVoliteľnéÚčel profilov, ktoré sa majú odstrániť. Jedna z hodnôt ChargePointMaxProfile, TxDefaultProfile, TxProfile.
stackLevelintegerVoliteľnéÚroveň zásobníka (stack level) profilov, ktoré sa majú odstrániť.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéČi sa nejaké profily odstránili. Jedna z hodnôt Accepted, Unknown.
Príklad
Backoffice posiela
[2, "2c436739", "ClearChargingProfile", {}]
Nabíjacia stanica odpovedá
[3, "2c436739", {
  "status": "Accepted"
}]

V OCPP 2.0.1: ClearChargingProfile

Žiada kombinovaný rozvrh nabíjania pre konektor.

Request
PoleTypPoužitieČo obsahuje
connectorIdintegerPovinnéKonektor, pre ktorý sa má rozvrh získať.
durationintegerPovinnéTrvanie požadovaného rozvrhu v sekundách.
chargingRateUnitstringVoliteľnéPreferovaná jednotka rozvrhu. Jedna z hodnôt A, W.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéČi nabíjací bod dokáže rozvrh poskytnúť. Jedna z hodnôt Accepted, Rejected.
connectorIdintegerVoliteľnéKonektor, na ktorý sa rozvrh vzťahuje.
scheduleStartstringVoliteľnéDátum a čas začiatku kombinovaného rozvrhu. Dátum a čas.
chargingScheduleobjectVoliteľnéKombinovaný rozvrh nabíjania.
chargingRateUnitstringPovinnéJednotka nabíjacieho výkonu (ampéry alebo watty). Jedna z hodnôt A, W.
chargingSchedulePeriodarrayPovinnéZoznam období rozvrhu.
startPeriodintegerPovinnéZačiatok obdobia v sekundách od začiatku rozvrhu.
limitnumberPovinnéLimit výkonu alebo prúdu počas tohto obdobia. V krokoch po 0,1.
numberPhasesintegerVoliteľnéPočet fáz, ktoré sa majú použiť na nabíjanie.
durationintegerVoliteľnéTrvanie rozvrhu v sekundách.
startSchedulestringVoliteľnéDátum a čas začiatku rozvrhu. Dátum a čas.
minChargingRatenumberVoliteľnéNajnižší podporovaný nabíjací výkon. V krokoch po 0,1.
Príklad
Backoffice posiela
[2, "50bc203f", "GetCompositeSchedule", {
  "connectorId": 1,
  "duration": 3600
}]
Nabíjacia stanica odpovedá
[3, "50bc203f", {
  "status": "Accepted"
}]

V OCPP 2.0.1: GetCompositeSchedule

Pošle nabíjací profil do nabíjacej stanice.

Request
PoleTypPoužitieČo obsahuje
connectorIdintegerPovinnéKonektor, na ktorý sa profil vzťahuje.
csChargingProfilesobjectPovinnéNabíjací profil na inštaláciu.
chargingProfileIdintegerPovinnéJedinečný identifikátor tohto nabíjacieho profilu.
stackLevelintegerPovinnéÚroveň priority profilu (vyššia = vyššia priorita).
chargingProfilePurposestringPovinnéÚčel nabíjacieho profilu. Jedna z hodnôt ChargePointMaxProfile, TxDefaultProfile, TxProfile.
chargingProfileKindstringPovinnéDruh rozvrhu. Jedna z hodnôt Absolute, Recurring, Relative.
chargingScheduleobjectPovinnéRozvrh nabíjania.
chargingRateUnitstringPovinnéJednotka nabíjacieho výkonu (ampéry alebo watty). Jedna z hodnôt A, W.
chargingSchedulePeriodarrayPovinnéZoznam období rozvrhu.
startPeriodintegerPovinnéZačiatok obdobia v sekundách od začiatku rozvrhu.
limitnumberPovinnéLimit výkonu alebo prúdu počas tohto obdobia. V krokoch po 0,1.
numberPhasesintegerVoliteľnéPočet fáz, ktoré sa majú použiť na nabíjanie.
durationintegerVoliteľnéTrvanie rozvrhu v sekundách.
startSchedulestringVoliteľnéDátum a čas začiatku rozvrhu. Dátum a čas.
minChargingRatenumberVoliteľnéNajnižší podporovaný nabíjací výkon. V krokoch po 0,1.
transactionIdintegerVoliteľnéNabíjanie, na ktoré sa tento profil vzťahuje.
recurrencyKindstringVoliteľnéFrekvencia opakovania pri opakujúcich sa profiloch. Jedna z hodnôt Daily, Weekly.
validFromstringVoliteľnéDátum a čas, od ktorého profil platí. Dátum a čas.
validTostringVoliteľnéDátum a čas, po ktorom profil už neplatí. Dátum a čas.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéČi bol profil prijatý. Jedna z hodnôt Accepted, Rejected, NotSupported.
Príklad
Backoffice posiela
[2, "01be9b20", "SetChargingProfile", {
  "connectorId": 1,
  "csChargingProfiles": {
    "chargingProfileId": 10,
    "stackLevel": 0,
    "chargingProfilePurpose": "TxDefaultProfile",
    "chargingProfileKind": "Relative",
    "chargingSchedule": {
      "chargingRateUnit": "A",
      "chargingSchedulePeriod": [
        {
          "startPeriod": 0,
          "limit": 16.0
        }
      ]
    }
  }
}]
Nabíjacia stanica odpovedá
[3, "01be9b20", {
  "status": "Accepted"
}]

V OCPP 2.0.1: SetChargingProfile

Vzdialené spustenie správ

Vyžiadanie konkrétnej správy od nabíjacieho bodu na požiadanie.

Žiada nabíjací bod, aby okamžite poslal konkrétnu správu.

Request
PoleTypPoužitieČo obsahuje
requestedMessagestringPovinnéSpráva, ktorú má nabíjací bod poslať. Jedna z hodnôt BootNotification, DiagnosticsStatusNotification, FirmwareStatusNotification, Heartbeat, MeterValues, StatusNotification.
connectorIdintegerVoliteľnéKonektor, pre ktorý sa má správa poslať.
Response
PoleTypPoužitieČo obsahuje
statusstringPovinnéČi nabíjací bod správu pošle. Jedna z hodnôt Accepted, Rejected, NotImplemented.
Príklad
Backoffice posiela
[2, "4c736efd", "TriggerMessage", {
  "requestedMessage": "StatusNotification"
}]
Nabíjacia stanica odpovedá
[3, "4c736efd", {
  "status": "Accepted"
}]

V OCPP 2.0.1: TriggerMessage

Konfiguračné kľúče OCPP 1.6

ChangeConfiguration nastavuje na nabíjacej stanici jeden kľúč naraz a GetConfiguration ich načíta späť. Tu sa rozhoduje o väčšine správania nabíjacej stanice v praxi: ako často prichádzajú namerané hodnoty, čo obsahujú, či nabíjanie prežije výpadok siete, ako sa odomkne kábel.

Ako sa volanie správa

  • Každá hodnota je reťazecAj čísla a booleovské hodnoty: "60", "true". Číslo v JSON poruší schému správy a nabíjacia stanica, ktorá schému kontroluje, odpovie chybou CallError.
  • Píšte názvy kľúčov tak, ako ich uvádza špecifikáciaŠpecifikácia nerozlišuje v názvoch kľúčov veľké a malé písmená, no nie každá nabíjacia stanica to dodržiava, preto píšte MeterValuesSampledData, nie metervaluessampleddata.
  • Niektoré kľúče vyžadujú reštartNabíjacia stanica odpovie RebootRequired a poslať Reset je na Vás.
  • Výrobcovia pridávajú vlastné kľúčeGetConfiguration s prázdnym zoznamom kľúčov vráti každý kľúč, ktorý nabíjacia stanica podporuje, vrátane vlastných kľúčov výrobcu. Kľúče, o ktoré požiadate menom a ktoré nepozná, sa vrátia v unknownKey.

Štyri odpovede

Prijaté
Kľúč je nastavený a hneď platí.
Rejected
Kľúč existuje, ale hodnota bola odmietnutá: mimo rozsahu, nesprávny formát alebo na tejto nabíjacej stanici iba na čítanie.
RebootRequired
Hodnota je uložená, ale platí až po reštarte nabíjacej stanice.
NotSupported
Nabíjacia stanica tento kľúč vôbec neimplementuje.

Všetkých 43 kľúčov podľa profilu funkcií

KľúčTypPrístupČo robí
Core34
AllowOfflineTxForUnknownIdV špecifikácii voliteľnýbooleanČítanie a zápisČi nabíjacia stanica v režime offline spustí nabíjanie pre neznámy idTag.Hodnota true udrží lokalitu v nabíjaní aj počas výpadku siete, za cenu nabíjaní, ktoré možno nebudete môcť nikomu vyfakturovať.
AuthorizationCacheEnabledV špecifikácii voliteľnýbooleanČítanie a zápisČi si nabíjacia stanica ukladá výsledok predchádzajúcich volaní Authorize do cache.Rozdiel oproti Local Auth List: cache sa plní sama zo skutočných autorizácií, zoznam posiela backend.
AuthorizeRemoteTxRequestsbooleanČítanieČi nabíjacia stanica pred spustením autorizuje idTag z RemoteStartTransaction.Ak je true, aj vzdialené spustenie z aplikácie potrebuje kolo Authorize, takže chybný idTag spustenie zmarí.
BlinkRepeatV špecifikácii voliteľnýintegerČítanie a zápisKoľkokrát nabíjacia stanica počas blikania blikne svetlom.
ClockAlignedDataIntervalintegerČítanie a zápisInterval nameraných hodnôt zarovnaných na hodiny, meraný od polnoci. 0 ich vypne.900 dá odpočet každú štvrťhodinu. Tento kľúč napája MeterValuesAlignedData a beží, či je auto pripojené, alebo nie.
ConnectionTimeOutintegerČítanie a zápisAko dlho nabíjacia stanica po autorizácii čaká, kým vodič pripojí auto, než konektor uvoľní.
ConnectorPhaseRotationCSLČítanie a zápisPoradie fáz pre každý konektor v zápise connectorId.RST, napríklad 0.RST, 1.RST, 2.RTS.Chyba tu znamená nesprávne namerané hodnoty po fázach a nesprávne jednofázové vyvažovanie zaťaženia. Oplatí sa skontrolovať na každej trojfázovej lokalite.
ConnectorPhaseRotationMaxLengthV špecifikácii voliteľnýintegerČítanieNajvyšší počet položiek v ConnectorPhaseRotation.
GetConfigurationMaxKeysintegerČítanieNajvyšší počet kľúčov, o ktoré môže požiadať jedna požiadavka GetConfiguration.Ak požiadate o viac, nabíjacia stanica môže odpovedať chybou. Pošlite GetConfiguration úplne bez kľúčov a dostanete všetko, čo podporuje.
HeartbeatIntervalintegerČítanie a zápisAko často nabíjacia stanica posiela Heartbeat, keď sa nič iné nedeje.Odpoveď na BootNotification to môže prepísať. Na SIM karte s platbou za dáta je krátky heartbeat tichý náklad, ktorý sa nasčítava.
LightIntensityV špecifikácii voliteľnýintegerČítanie a zápisJas osvetlenia nabíjacej stanice v percentách.
LocalAuthorizeOfflinebooleanČítanie a zápisČi nabíjacia stanica v režime offline autorizuje zo svojho lokálneho zoznamu alebo cache.
LocalPreAuthorizebooleanČítanie a zápisČi nabíjacia stanica v režime online spustí nabíjanie z lokálneho zoznamu alebo cache bez čakania na backend.Skráti čakanie pri nabíjacej stanici, za cenu toho, že backend nemá posledné slovo pri každom spustení.
MaxEnergyOnInvalidIdV špecifikácii voliteľnýintegerČítanie a zápisEnergia, ktorú nabíjacia stanica ešte dodá po tom, čo sa autorizácia ukáže ako neplatná.
MeterValuesAlignedDataCSLČítanie a zápisMeracie veličiny posielané v MeterValues zarovnaných na hodiny, v intervale ClockAlignedDataInterval.Rovnaký slovník meracích veličín ako MeterValuesSampledData, iný spúšťač: hodiny, nie nabíjanie.
MeterValuesAlignedDataMaxLengthV špecifikácii voliteľnýintegerČítanieNajvyšší počet meracích veličín v MeterValuesAlignedData.
MeterValuesSampledDataCSLČítanie a zápisMeracie veličiny vzorkované počas nabíjania a posielané v MeterValues, v intervale MeterValueSampleInterval.Najužitočnejší kľúč na tejto stránke. Podrobnosti nájdete nižšie.
MeterValuesSampledDataMaxLengthV špecifikácii voliteľnýintegerČítanieNajvyšší počet meracích veličín v MeterValuesSampledData.Prečítajte si ho skôr, než zostavíte dlhý zoznam: ak ho prekročíte, nabíjacia stanica odmietne celý zoznam.
MeterValueSampleIntervalintegerČítanie a zápisAko často nabíjacia stanica počas nabíjania vzorkuje MeterValuesSampledData. 0 vzorkovanie vypne.60 je rozumná predvolená hodnota. Pod 30 s dlhým zoznamom meracích veličín vytvárate veľa prevádzky za veľmi málo informácií navyše.
MinimumStatusDurationV špecifikácii voliteľnýintegerČítanie a zápisNajkratší čas, ktorý nabíjacia stanica zostane v jednom stave, než nahlási ďalší.Pomáha proti preblikávaniu stavov na nabíjacích staniciach, ktoré skáču medzi Preparing a Available.
NumberOfConnectorsintegerČítaniePočet fyzických konektorov na tejto nabíjacej stanici.
ResetRetriesintegerČítanie a zápisKoľkokrát nabíjacia stanica zopakuje neúspešný reštart.
StopTransactionOnEVSideDisconnectbooleanČítanie a zápisČi odpojenie na strane auta zastaví prebiehajúce nabíjanie.False znamená, že nabíjanie zostane otvorené aj po vytiahnutí kábla, a tak vznikajú nabíjania, ktoré nikdy neskončia.
StopTransactionOnInvalidIdbooleanČítanie a zápisČi nabíjacia stanica zastaví nabíjanie, keď backend idTag odmietne.
StopTxnAlignedDataCSLČítanie a zápisMeracie veličiny zarovnané na hodiny, ktoré sa pridajú do transactionData v StopTransaction.
StopTxnAlignedDataMaxLengthV špecifikácii voliteľnýintegerČítanieNajvyšší počet meracích veličín v StopTxnAlignedData.
StopTxnSampledDataCSLČítanie a zápisVzorkované meracie veličiny, ktoré sa pridajú do transactionData v StopTransaction.Držte tento zoznam krátky. Všetko v ňom sa opakuje pre každú vzorku celého nabíjania v jednom payloade StopTransaction, a tak nabíjacie stanice vyrábajú megabajtové správy o ukončení, ktoré backendy odmietnu.
StopTxnSampledDataMaxLengthV špecifikácii voliteľnýintegerČítanieNajvyšší počet meracích veličín v StopTxnSampledData.
SupportedFeatureProfilesCSLČítanieProfily funkcií, ktoré táto nabíjacia stanica implementuje, napríklad Core, FirmwareManagement, SmartCharging.Úprimná odpoveď na to, čo nabíjacia stanica dokáže. Prečítajte si ju skôr, než zákazníkovi sľúbite inteligentné nabíjanie.
SupportedFeatureProfilesMaxLengthV špecifikácii voliteľnýintegerČítanieNajvyšší počet položiek v SupportedFeatureProfiles.
TransactionMessageAttemptsintegerČítanie a zápisKoľkokrát nabíjacia stanica zopakuje odoslanie správy o nabíjaní, ktorú backend nepotvrdil.
TransactionMessageRetryIntervalintegerČítanie a zápisZákladné čakanie medzi týmito pokusmi. Nabíjacia stanica ho násobí poradovým číslom pokusu.
UnlockConnectorOnEVSideDisconnectbooleanČítanie a zápisČi sa kábel na nabíjacej stanici odomkne, keď sa odpojí na strane auta.
WebSocketPingIntervalV špecifikácii voliteľnýintegerČítanie a zápisInterval WebSocket ping rámcov na spojení OCPP-J.Nenápadná oprava pre nabíjacie stanice, ktoré opakovane padajú do offline za NAT-om alebo firewallom, ktorý zatvára nečinné spojenia.
Lokálny autorizačný zoznam3
LocalAuthListEnabledbooleanČítanie a zápisČi sa lokálny autorizačný zoznam používa.
LocalAuthListMaxLengthintegerČítanieKoľko záznamov lokálny autorizačný zoznam pojme.
SendLocalListMaxLengthintegerČítanieKoľko záznamov sa zmestí do jednej správy SendLocalList.Väčší zoznam treba poslať v niekoľkých rozdielových aktualizáciách.
Rezervácia1
ReserveConnectorZeroSupportedV špecifikácii voliteľnýbooleanČítanieČi nabíjacia stanica prijme rezerváciu na konektor 0, teda na ľubovoľný konektor.
Inteligentné nabíjanie5
ChargeProfileMaxStackLevelintegerČítanieNajvyššia úroveň zásobníka (stack level), ktorú nabíjacia stanica prijme v nabíjacom profile. Vyššie úrovne majú prednosť.
ChargingScheduleAllowedChargingRateUnitCSLČítanieKtoré jednotky nabíjacia stanica prijme v rozvrhu nabíjania: prúd (A), výkon (W) alebo oboje.Ak pošlete profil vo wattoch nabíjacej stanici, ktorá berie iba ampéry, bude odmietnutý. Tento kľúč Vám povie, ktorú jednotku použiť.
ChargingScheduleMaxPeriodsintegerČítanieNajvyšší počet období v jednom rozvrhu nabíjania.
ConnectorSwitch3to1PhaseSupportedV špecifikácii voliteľnýbooleanČítanieČi nabíjacia stanica dokáže prepínať medzi trojfázovým a jednofázovým nabíjaním.Rozhoduje, či môžete obmedziť výkon pod trojfázové minimum namiesto úplného pozastavenia.
MaxChargingProfilesInstalledintegerČítanieKoľko nabíjacích profilov môže byť nainštalovaných naraz.

MeterValuesSampledData: čo nabíjacia stanica meria

Jeden kľúč, MeterValuesSampledData, rozhoduje, akú telemetriu z nabíjania dostanete. Je to zoznam meracích veličín oddelených čiarkou a nabíjacia stanica vzorkuje každú položku v intervale nastavenom v MeterValueSampleInterval a potom ich pošle v správe MeterValues. Ak ho necháte na predvolenej hodnote, dostanete jeden kumulatívny odpočet energie, ktorý stačí na fakturáciu, a nič iné: žiadnu krivku výkonu, žiadny prúd po fázach, žiadne napätie, žiadnu možnosť zistiť, či sa limit inteligentného nabíjania uplatnil.

Nikdy nefunguje sám. MeterValueSampleInterval určuje, ako často sa spúšťa, MeterValuesSampledDataMaxLength obmedzuje, koľko meracích veličín môžete uviesť, StopTxnSampledData rozhoduje, ktoré z nich sa zopakujú v StopTransaction, a MeterValuesAlignedData je rovnaký slovník podľa hodín namiesto nabíjania.

Meracie veličiny

V zozname sa môže objaviť ktorákoľvek z nich. Ktoré nabíjacia stanica podporuje, závisí od jej hardvéru: AC wallbox zvyčajne nehlási stav nabitia a základná nabíjacia stanica môže mať iba register energie.

Meracia veličinaJednotkaZvyčajne priČo Vám dá
Energy.Active.Import.RegisterWhAC aj DCKumulatívna energia odobratá zo siete, prečítaná priamo z registra elektromera. Predvolená hodnota, keď je MeterValuesSampledData prázdny, a hodnota, na ktorej stojí takmer každý výpočet fakturácie.
Energy.Active.Export.RegisterWhS podporou V2GKumulatívna energia dodaná späť, pri obojsmerných zostavách.
Energy.Active.Import.IntervalWhAC aj DCEnergia odobratá od predchádzajúcej vzorky, nie priebežný súčet.
Energy.Reactive.Import.RegistervarhZávisí od elektromeraKumulatívna odobratá jalová energia.
Power.Active.ImportWAC aj DCOkamžitý činný výkon. To, čo vynesiete do grafu, aby ste videli krivku nabíjania, a na čo reaguje riadenie zaťaženia.
Power.OfferedWAC aj DCVýkon, ktorý nabíjacia stanica práve ponúka autu. Porovnajte ho s Power.Active.Import a uvidíte, či sa limit naozaj uplatňuje.
Power.Reactive.ImportvarZávisí od elektromeraOkamžitý jalový výkon.
Power.FactorpomerZávisí od elektromeraPomer činného a zdanlivého výkonu.
Current.ImportAAC aj DCOdoberaný prúd. Zvyčajne sa hlási po fázach, takže z tejto jednej meracej veličiny môžu byť tri hodnoty na vzorku.
Current.OfferedAAC aj DCPrúdový limit, ktorý nabíjacia stanica signalizuje autu. Priamy údaj o tom, či sa Váš profil inteligentného nabíjania uplatnil.
Current.ExportAS podporou V2GPrúd dodávaný späť, pri obojsmerných zostavách.
VoltageVAC aj DCNapájacie napätie, na trojfázových nabíjacích staniciach po fázach. Pomôže odhaliť výpadok fázy alebo slabý spoj.
FrequencyHzZávisí od elektromeraFrekvencia siete. Špecifikácia jej nedáva pole jednotky.
TemperatureCelsiusZávisí od nabíjacej staniceTeplota na nabíjacej stanici alebo konektore. Vysvetlí zníženie výkonu v horúcom dni skôr, než to niekto nazve poruchou.
SoC%DC, alebo ISO 15118 pri ACStav nabitia batérie auta. Je k dispozícii, len keď ho auto naozaj hlási, a pri bežnom AC nabíjaní ho zvyčajne nehlási.
RPMrpmZriedkaOtáčky ventilátora, na nabíjacích staniciach, ktoré ich hlásia.

Zoznamy, ktoré fungujú

Skopírujte jeden do hodnoty volania ChangeConfiguration. Začnite úzko a meracie veličiny pridávajte, keď ich nabíjacia stanica prijme.

  • Iba fakturácia

    Minimum, ktoré ešte vytvorí správnu faktúru. Predvolená hodnota na väčšine nabíjacích staníc.

    Energy.Active.Import.Register
  • Štandardná telemetria

    Rozumná predvolená hodnota pre spravovanú AC lokalitu: krivka výkonu, prúd po fázach a napätie na diagnostiku.

    Energy.Active.Import.Register, Power.Active.Import, Current.Import, Voltage
  • Inteligentné nabíjanie

    Pridáva ponúkané hodnoty, takže vidíte, či sa profil naozaj uplatňuje, a nemusíte to predpokladať.

    Energy.Active.Import.Register, Power.Active.Import, Power.Offered, Current.Import, Current.Offered, Voltage
  • DC rýchlonabíjanie

    Pridáva stav nabitia a teplotu, ktoré DC nabíjacie stanice hlásia a ktoré vysvetľujú väčšinu znížení výkonu.

    Energy.Active.Import.Register, Power.Active.Import, Current.Import, Voltage, SoC, Temperature

Čo sa pokazí

  • Jedna zlá meracia veličina zmarí celý zoznam

    Nabíjacie stanice overujú zoznam ako celok. Ak jedna položka nie je podporovaná, dostanete Rejected alebo NotSupported pre všetko, bez náznaku, ktorá zlyhala. Nastavujte zoznam po jednej meracej veličine, aby ste vinníka našli, alebo si najprv prečítajte MeterValuesSampledDataMaxLength a dokumentáciu výrobcu.

  • Z jednej meracej veličiny môžu byť tri hodnoty

    Current.Import a Voltage sa hlásia po fázach, takže na trojfázovej nabíjacej stanici prídu každá ako tri záznamy sampledValue, označené L1, L2, L3 alebo L1-N a podobne. Zoznam šiestich meracích veličín môže ľahko znamenať tucet hodnôt na vzorku. Veľkosť payloadu rastie rýchlejšie, než by naznačovala dĺžka zoznamu.

  • Wh verzus kWh

    Register energie je predvolene vo Wh, ale pole jednotky môže uvádzať kWh a niektoré firmvéry to robia. Čítajte jednotku, nepredpokladajte ju, inak dostanete faktúru, ktorá je mimo o faktor tisíc.

  • Krátky interval nie je zadarmo

    MeterValueSampleInterval na 10 sekúnd s dlhým zoznamom znamená stovky správ na jedno nabíjanie. Na SIM karte s platbou za dáta sú to skutočné peniaze a na veľkej lokalite skutočná záťaž backendu. 60 sekúnd je dobrá predvolená hodnota, 300 pre lokality, kde Vám stačí tvar krivky.

  • StopTxnSampledData je pasca na payload

    Všetko, čo je tam uvedené, sa zopakuje pre každú vzorku celého nabíjania v jedinej správe StopTransaction. Dlhý zoznam pri dlhom nabíjaní vytvorí payload taký veľký, že ho backendy odmietnu alebo skrátia, a nabíjanie sa potom neuzavrie čisto. Nechajte tam iba register energie, ak nemáte konkrétny dôvod.

  • Bez registra energie sa fakturácia pokazí

    Ak Energy.Active.Import.Register v zozname nie je, pravidelné namerané hodnoty neobsahujú kumulatívny súčet. Väčšina backendov sa potom spolieha na meterStart a meterStop zo správ o nabíjaní a každé nabíjanie, pri ktorom sa StopTransaction stratí, sa nedá vyfakturovať. Nechajte ho v zozname, vždy.

  • SoC pri AC zvyčajne nie je k dispozícii

    Stav nabitia pochádza z auta, cez ISO 15118 alebo protokol DC nabíjania. Na bežnom AC wallboxe bez Plug and Charge ho auto nehlási, takže požiadavka na SoC je buď odmietnutá, alebo nevráti nič užitočné.

  • Čítajte pole context

    Každý sampledValue nesie context: Sample.Periodic, Transaction.Begin, Transaction.End, Sample.Clock alebo Trigger. Hodnota pri Transaction.Begin je počiatočný stav registra, nie spotreba. Ak každú vzorku považujete za pravidelnú, nabíjania sa započítajú dvakrát.

Otázky o OCPP 1.6J

OCPP 1.6J je verzia 1.6 protokolu Open Charge Point Protocol vo forme JSON. Nabíjacia stanica otvorí WebSocket do svojho backofficu a obe strany cez neho posielajú JSON správy. Open Charge Alliance vydala verziu 1.6 v roku 2015 a väčšina nabíjacích staníc ju stále podporuje: v našej databáze nabíjacích staníc podporuje verziu 1.6 483 z 495 nabíjacích staníc so známou verziou OCPP.

Prenášajú rovnaké správy iným spôsobom. 1.6J posiela JSON cez WebSocket, ktorý nabíjacia stanica drží otvorený, takže nabíjacia stanica potrebuje iba odchádzajúce spojenie. 1.6S posiela SOAP cez HTTP a vtedy sa aj backoffice musí vedieť k nabíjacej stanici pripojiť.

2.0.1 je novšia verzia s vlastnou sadou správ. Nastavenia nabíjacej stanice opisuje v device modeli, má zabudované bezpečnostné profily, nahrádza StartTransaction a StopTransaction správou TransactionEvent a pridáva správy pre Plug and Charge (ISO 15118). Tieto dve verzie sa nemiešajú: nabíjacia stanica a jej backoffice sa pri otvorení spojenia dohodnú na jednej verzii. V našej databáze nabíjacích staníc uvádza 102 nabíjacích staníc verziu 2.0.1 popri 1.6 alebo namiesto nej. Každá správa 2.0.1 a 2.1 je v referenčnej príručke OCPP 2.0.1 a 2.1.

Open Charge Alliance ju bezplatne zverejňuje na svojom webe, s JSON schémou pre každú správu. Táto príručka sa riadi touto špecifikáciou. Kde sa líšia, platí špecifikácia.

Cez profil Smart Charging. Backoffice pošle SetChargingProfile s rozvrhom limitov v ampéroch alebo wattoch. ChargePointMaxProfile obmedzuje celú nabíjaciu stanicu, TxDefaultProfile platí pre každé nové nabíjanie a TxProfile pre jedno prebiehajúce nabíjanie. Keď sa prekrývajú dva profily s rovnakým účelom, vyhráva ten s vyšším stackLevel. Ako to využíva Plugchoice, nájdete na stránke o inteligentnom nabíjaní.

Pozrite sa do databázy nabíjacích staníc: 775 nabíjacích staníc s verziami OCPP, o ktorých vieme, a odkiaľ každý údaj pochádza. Zvyčajne to uvádza aj technický list nabíjacej stanice, často ako OCPP 1.6J alebo OCPP 1.6 JSON.

V nastaveniach nabíjacej stanice, často v aplikácii pre elektroinštalatérov alebo na jej lokálnej webovej stránke, zadajte WebSocket URL backofficu (začína sa ws:// alebo wss://) a ID nabíjacej stanice, teda charge point identity. Nabíjacia stanica otvorí spojenie a pošle BootNotification. Keď backoffice odpovie Accepted, nabíjacia stanica je online a pošle StatusNotification pre každý konektor.

Plugchoice a OCPP

  • Bezplatný backofficePripojte nabíjaciu stanicu s OCPP 1.6J a spravujte ju vo webovom portáli.
  • AplikáciaVlastníci a elektroinštalatéri ovládajú tú istú nabíjaciu stanicu z telefónu.
  • OCPP proxyJedna nabíjacia stanica na viacerých backoffice systémoch naraz.
  • Backoffice systémyBackoffice systémy, ktoré si pri pripájaní nabíjacej stanice vyberiete zo zoznamu.

Ďalšie čítanie

  1. Čo je OCPP?

    Blog | 3 min čítania

  2. Čo je OCPP backoffice?

    Blog | 2 min čítania

  3. Čo je OCPP proxy a prečo ho dať medzi nabíjaciu stanicu a backend?

    Blog | 5 min čítania

  4. Ako fungujú profily inteligentného nabíjania v OCPP a prečo Plugchoice používa TxProfile

    Blog | 5 min čítania

Táto stránka pre AI asistentov

Celá príručka, každá správa a každý konfiguračný kľúč, ako jeden textový súbor, ktorý asistent prečíta naraz.

Príručka ako obyčajný text

Prevádzkujte svoje OCPP nabíjacie stanice na Plugchoice

Pripojte svoje nabíjacie stanice s OCPP 1.6J k Plugchoice zadarmo a spravujte ich vo webovom portáli, v aplikácii a cez API.

Začať zadarmo Pozrieť OCPP proxy