OCPP 1.6J protokolli teatmik.

Mida laadija ja selle taustasüsteem teineteisele ütlevad: kõik 28 sõnumit koos väljade ja näitega, 43 konfiguratsioonivõtit, mida laadija mõõta saab ja mis praktikas valesti läheb.

Otsi teatmikust Alusta tasuta

Sõnumid Konfiguratsioonivõtmed Mõõdetavad suurused Küsimused

LaadijaCharge point TaustasüsteemCentral system Üks WebSocket, JSON

Mis on OCPP 1.6J?

OCPP ehk Open Charge Point Protocol on Open Charge Alliance'i tasuta ja avatud standard. See määrab, kuidas laadija suhtleb tarkvaraga, mis seda haldab: spetsifikatsioonis on see Central System, turul taustasüsteem.

Versioonis 1.6J avab laadija taustasüsteemiga WebSocket-ühenduse ja mõlemad pooled saadavad selle kaudu JSON-sõnumeid. Laadija teatab oma oleku, arvestinäidud ja laadimissessioonid. Taustasüsteem alustab ja lõpetab laadimissessioone, muudab seadeid ja seab laadimispiiranguid.

Kuna standard on avatud, saab seda kõnelev laadija ühenduda ka teiste taustasüsteemidega, mis seda toetavad, sõltuvalt mudelist, püsivarast ja konfiguratsioonist. Just see võimaldab ühel asukohal eri kaubamärke kombineerida ja laadija teise taustasüsteemi üle viia. Kui soovite ühte laadijat korraga mitmes taustasüsteemis kasutada, kasutage OCPP-proksit.

Avatud standardTasuta rakendatav, haldab Open Charge Alliance.
WebSocket ja JSONÜks püsivalt avatud ühendus struktureeritud sõnumitega.
28 sõnumitKuues funktsiooniprofiilis, alates Core'ist kuni Remote Triggerini.
Mõlemas suunasLaadija ja taustasüsteem algatavad kumbki oma sõnumeid.

Kõik 28 OCPP 1.6 sõnumit

Iga sõnum on ühe poole päring ja teise poole vastus, mida seob unikaalne sõnumi ID.

Core

Kohustuslik. Laadija põhitoimingud: autoriseerimine, laadimissessioonid, olekuteated, konfiguratsioon ja lihtne kaugjuhtimine.

Küsib idTagi autoriseerimist enne laadimise lubamist.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
idTag	string	Kohustuslik	Autoriseeritav identifikaator. Kõige rohkem 20 märki.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
idTagInfo	object	Kohustuslik	idTagi autoriseerimisteave.
status	string	Kohustuslik	Autoriseerimise olek. Üks järgmistest: Accepted, Blocked, Expired, Invalid, ConcurrentTx.
expiryDate	string	Valikuline	Kuupäev ja kellaaeg, millest alates idTagi loetakse aegunuks. Kuupäev ja kellaaeg.
parentIdTag	string	Valikuline	Ülem-idTag grupi autoriseerimiseks. Kõige rohkem 20 märki.

Näide

Laadija saadab

[2, "7f83df9c", "Authorize", {
  "idTag": "04A2B3C4D5E6F7"
}]

Taustasüsteem vastab

[3, "7f83df9c", {
  "idTagInfo": {
    "status": "Accepted"
  }
}]

OCPP 2.0.1-s: Authorize

Saadetakse pärast käivitumist, et taustasüsteemis registreeruda.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
chargePointVendor	string	Kohustuslik	Laadija tootja. Kõige rohkem 20 märki.
chargePointModel	string	Kohustuslik	Laadija mudel. Kõige rohkem 20 märki.
chargePointSerialNumber	string	Valikuline	Laadija seerianumber. Kõige rohkem 25 märki.
chargeBoxSerialNumber	string	Valikuline	Laadija korpuse (charge box) seerianumber. Kõige rohkem 25 märki.
firmwareVersion	string	Valikuline	Laadija püsivara versioon. Kõige rohkem 50 märki.
iccid	string	Valikuline	SIM-kaardi ICCID. Kõige rohkem 20 märki.
imsi	string	Valikuline	SIM-kaardi IMSI. Kõige rohkem 20 märki.
meterType	string	Valikuline	Energiaarvesti tüüp. Kõige rohkem 25 märki.
meterSerialNumber	string	Valikuline	Energiaarvesti seerianumber. Kõige rohkem 25 märki.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Registreerimise olek. Üks järgmistest: Accepted, Pending, Rejected.
currentTime	string	Kohustuslik	Central Systemi praegune kellaaeg. Kuupäev ja kellaaeg.
interval	integer	Kohustuslik	Heartbeat-intervall sekundites.

Näide

Laadija saadab

[2, "392b5b40", "BootNotification", {
  "chargePointVendor": "ExampleVendor",
  "chargePointModel": "ExampleModel",
  "firmwareVersion": "1.4.2"
}]

Taustasüsteem vastab

[3, "392b5b40", {
  "status": "Accepted",
  "currentTime": "2026-10-06T09:30:00Z",
  "interval": 300
}]

OCPP 2.0.1-s: BootNotification

Muudab pistiku kättesaadavust.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
connectorId	integer	Kohustuslik	Pistiku ID (0 = kogu laadija).
type	string	Kohustuslik	Soovitud kättesaadavuse muudatus. Üks järgmistest: Inoperative, Operative.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Kättesaadavuse muutmise päringu tulemus. Üks järgmistest: Accepted, Rejected, Scheduled.

Näide

Taustasüsteem saadab

[2, "be3dcf2e", "ChangeAvailability", {
  "connectorId": 1,
  "type": "Operative"
}]

Laadija vastab

[3, "be3dcf2e", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: ChangeAvailability

Muudab laadija konfiguratsioonivõtit.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
key	string	Kohustuslik	Muudetav konfiguratsioonivõti. Kõige rohkem 50 märki.
value	string	Kohustuslik	Konfiguratsioonivõtme uus väärtus. Kõige rohkem 500 märki.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Konfiguratsiooni muutmise tulemus. Üks järgmistest: Accepted, Rejected, RebootRequired, NotSupported.

Näide

Taustasüsteem saadab

[2, "6fdf2255", "ChangeConfiguration", {
  "key": "MeterValueSampleInterval",
  "value": "60"
}]

Laadija vastab

[3, "6fdf2255", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: SetVariables

Tühjendab laadija autoriseerimisvahemälu.

Päring

Välju pole: päring on tühi.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Vahemälu tühjendamise päringu tulemus. Üks järgmistest: Accepted, Rejected.

Näide

Taustasüsteem saadab

[2, "e993e844", "ClearCache", {}]

Laadija vastab

[3, "e993e844", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: ClearCache

Tootjapõhine andmevahetus.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
vendorId	string	Kohustuslik	Tuvastab tootja. Kõige rohkem 255 märki.
messageId	string	Valikuline	Sõnumi täiendav tunnus. Kõige rohkem 50 märki.
data	string	Valikuline	Tootjapõhised andmed.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Andmeedastuse tulemus. Üks järgmistest: Accepted, Rejected, UnknownMessageId, UnknownVendorId.
data	string	Valikuline	Tootjapõhised vastuseandmed.

Näide

Üks pool saadab

[2, "e1a403d5", "DataTransfer", {
  "vendorId": "com.example"
}]

Teine pool vastab

[3, "e1a403d5", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: DataTransfer

Loeb laadijalt konfiguratsioonivõtmed.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
key	array	Valikuline	Loetavate konfiguratsioonivõtmete loend. Iga element kõige rohkem 50 märki.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
configurationKey	array	Valikuline	Teadaolevate konfiguratsioonivõtmete loend.
key	string	Kohustuslik	Konfiguratsioonivõtme nimi. Kõige rohkem 50 märki.
readonly	boolean	Kohustuslik	Kas võti on kirjutuskaitstud.
value	string	Valikuline	Võtme praegune väärtus. Kõige rohkem 500 märki.
unknownKey	array	Valikuline	Küsitud võtmete loend, mis on tundmatud. Iga element kõige rohkem 50 märki.

Näide

Taustasüsteem saadab

[2, "02bd00f5", "GetConfiguration", {
  "key": [
    "MeterValueSampleInterval"
  ]
}]

Laadija vastab

[3, "02bd00f5", {
  "configurationKey": [
    {
      "key": "MeterValueSampleInterval",
      "readonly": false,
      "value": "60"
    }
  ]
}]

OCPP 2.0.1-s: GetBaseReport ja GetVariables

Perioodiline elumärk, millega taustasüsteem teab, et laadija on võrgus.

Päring

Välju pole: päring on tühi.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
currentTime	string	Kohustuslik	Central Systemi praegune kellaaeg. Kuupäev ja kellaaeg.

Näide

Laadija saadab

[2, "83622997", "Heartbeat", {}]

Taustasüsteem vastab

[3, "83622997", {
  "currentTime": "2026-10-06T09:30:00Z"
}]

OCPP 2.0.1-s: Heartbeat

Saadab perioodilisi või käivitatud arvestinäite.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
connectorId	integer	Kohustuslik	Pistiku ID (0 = peaarvesti).
meterValue	array	Kohustuslik	Üks või mitu ajatempliga arvestinäitu.
timestamp	string	Kohustuslik	Arvestinäidu ajatempel. Kuupäev ja kellaaeg.
sampledValue	array	Kohustuslik	Üks või mitu mõõdetud väärtust.
value	string	Kohustuslik	Mõõdetud väärtus.
context	string	Valikuline	Näidu kontekst. Üks järgmistest: Interruption.Begin, Interruption.End, Sample.Clock, Sample.Periodic, Transaction.Begin, Transaction.End, Trigger, Other.
format	string	Valikuline	Väärtuse vorming. Üks järgmistest: Raw, SignedData.
measurand	string	Valikuline	Mõõtmise tüüp. Üks järgmistest: 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.
phase	string	Valikuline	Faas, mille kohta mõõtmine käib. Üks järgmistest: L1, L2, L3, N, L1-N, L2-N, L3-N, L1-L2, L2-L3, L3-L1.
location	string	Valikuline	Mõõtmise koht. Üks järgmistest: Cable, EV, Inlet, Outlet, Body.
unit	string	Valikuline	Mõõtühik. Üks järgmistest: Wh, kWh, varh, kvarh, W, kW, VA, kVA, var, kvar, A, V, K, Celcius, Celsius, Fahrenheit, Percent.
transactionId	integer	Valikuline	Laadimissessioon, mille kohta need arvestinäidud käivad.

Vastus

Välju pole: vastus on tühi.

Näide

Laadija saadab

[2, "80a15023", "MeterValues", {
  "connectorId": 1,
  "meterValue": [
    {
      "timestamp": "2026-10-06T09:30:00Z",
      "sampledValue": [
        {
          "value": "19840",
          "measurand": "Energy.Active.Import.Register",
          "unit": "Wh"
        }
      ]
    }
  ],
  "transactionId": 4521
}]

Taustasüsteem vastab

[3, "80a15023", {}]

OCPP 2.0.1-s: MeterValues

Alustab laadimissessiooni kaugelt.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
idTag	string	Kohustuslik	Selle laadimissessiooni jaoks kasutatav identifikaator. Kõige rohkem 20 märki.
connectorId	integer	Valikuline	Pistik, millel alustada.
chargingProfile	object	Valikuline	Sellele laadimissessioonile rakendatav laadimisprofiil.
chargingProfileId	integer	Kohustuslik	Selle laadimisprofiili unikaalne identifikaator.
stackLevel	integer	Kohustuslik	Profiili prioriteedi tase (suurem = kõrgem prioriteet).
chargingProfilePurpose	string	Kohustuslik	Laadimisprofiili eesmärk. Üks järgmistest: ChargePointMaxProfile, TxDefaultProfile, TxProfile.
chargingProfileKind	string	Kohustuslik	Ajakava liik. Üks järgmistest: Absolute, Recurring, Relative.
chargingSchedule	object	Kohustuslik	Laadimise ajakava.
chargingRateUnit	string	Kohustuslik	Laadimiskiiruse ühik (amprid või vatid). Üks järgmistest: A, W.
chargingSchedulePeriod	array	Kohustuslik	Ajakava perioodide loend.
startPeriod	integer	Kohustuslik	Perioodi algus sekundites ajakava algusest.
limit	number	Kohustuslik	Võimsuse või voolu piirang selle perioodi ajal. Sammuga 0,1.
numberPhases	integer	Valikuline	Laadimiseks kasutatavate faaside arv.
duration	integer	Valikuline	Ajakava kestus sekundites.
startSchedule	string	Valikuline	Ajakava alguse kuupäev ja kellaaeg. Kuupäev ja kellaaeg.
minChargingRate	number	Valikuline	Väikseim toetatud laadimiskiirus. Sammuga 0,1.
transactionId	integer	Valikuline	Laadimissessioon, millele see profiil kehtib.
recurrencyKind	string	Valikuline	Korduvate profiilide kordussagedus. Üks järgmistest: Daily, Weekly.
validFrom	string	Valikuline	Kuupäev ja kellaaeg, millest alates profiil kehtib. Kuupäev ja kellaaeg.
validTo	string	Valikuline	Kuupäev ja kellaaeg, mille järel profiil enam ei kehti. Kuupäev ja kellaaeg.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Kas laadija võttis päringu vastu. Üks järgmistest: Accepted, Rejected.

Näide

Taustasüsteem saadab

[2, "b7e2ef8a", "RemoteStartTransaction", {
  "idTag": "04A2B3C4D5E6F7",
  "connectorId": 1
}]

Laadija vastab

[3, "b7e2ef8a", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: RequestStartTransaction

Lõpetab laadimissessiooni kaugelt.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
transactionId	integer	Kohustuslik	Lõpetatava laadimissessiooni ID.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Kas laadija võttis päringu vastu. Üks järgmistest: Accepted, Rejected.

Näide

Taustasüsteem saadab

[2, "7fb0afb2", "RemoteStopTransaction", {
  "transactionId": 4521
}]

Laadija vastab

[3, "7fb0afb2", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: RequestStopTransaction

Lähtestab laadija (kõva või pehme lähtestus).

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
type	string	Kohustuslik	Tehtava lähtestuse tüüp. Üks järgmistest: Hard, Soft.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Kas laadija võttis lähtestuse vastu. Üks järgmistest: Accepted, Rejected.

Näide

Taustasüsteem saadab

[2, "526d688f", "Reset", {
  "type": "Soft"
}]

Laadija vastab

[3, "526d688f", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: Reset

Teatab taustasüsteemile, et laadimissessioon on alanud.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
connectorId	integer	Kohustuslik	Pistik, millel laadimissessioon algas.
idTag	string	Kohustuslik	Laadimissessiooni alustamiseks kasutatud identifikaator. Kõige rohkem 20 märki.
meterStart	integer	Kohustuslik	Arvestinäit laadimissessiooni alguses (Wh).
timestamp	string	Kohustuslik	Laadimissessiooni alguse ajatempel. Kuupäev ja kellaaeg.
reservationId	integer	Valikuline	Kasutatud broneeringu ID.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
idTagInfo	object	Kohustuslik	idTagi autoriseerimisteave.
status	string	Kohustuslik	Autoriseerimise olek. Üks järgmistest: Accepted, Blocked, Expired, Invalid, ConcurrentTx.
expiryDate	string	Valikuline	Kuupäev ja kellaaeg, millest alates idTagi loetakse aegunuks. Kuupäev ja kellaaeg.
parentIdTag	string	Valikuline	Ülem-idTag grupi autoriseerimiseks. Kõige rohkem 20 märki.
transactionId	integer	Kohustuslik	Central Systemi määratud laadimissessiooni ID.

Näide

Laadija saadab

[2, "2410a6a5", "StartTransaction", {
  "connectorId": 1,
  "idTag": "04A2B3C4D5E6F7",
  "meterStart": 12500,
  "timestamp": "2026-10-06T09:30:00Z"
}]

Taustasüsteem vastab

[3, "2410a6a5", {
  "idTagInfo": {
    "status": "Accepted"
  },
  "transactionId": 4521
}]

OCPP 2.0.1-s: TransactionEvent

Teatab pistiku praeguse oleku ja võimalikud vead.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
connectorId	integer	Kohustuslik	Pistik, mille olekut teatatakse.
errorCode	string	Kohustuslik	Veakood (NoError, kui viga pole). Üks järgmistest: ConnectorLockFailure, EVCommunicationError, GroundFailure, HighTemperature, InternalError, LocalListConflict, NoError, OtherError, OverCurrentFailure, PowerMeterFailure, PowerSwitchFailure, ReaderFailure, ResetFailure, UnderVoltage, OverVoltage, WeakSignal.
status	string	Kohustuslik	Pistiku praegune olek. Üks järgmistest: Available, Preparing, Charging, SuspendedEVSE, SuspendedEV, Finishing, Reserved, Unavailable, Faulted.
info	string	Valikuline	Täiendav vabatekstiline teave oleku kohta. Kõige rohkem 50 märki.
timestamp	string	Valikuline	Oleku muutumise ajatempel. Kuupäev ja kellaaeg.
vendorId	string	Valikuline	Tootjapõhine identifikaator. Kõige rohkem 255 märki.
vendorErrorCode	string	Valikuline	Tootjapõhine veakood. Kõige rohkem 50 märki.

Vastus

Välju pole: vastus on tühi.

Näide

Laadija saadab

[2, "d9b0420e", "StatusNotification", {
  "connectorId": 1,
  "errorCode": "NoError",
  "status": "Available"
}]

Taustasüsteem vastab

[3, "d9b0420e", {}]

OCPP 2.0.1-s: StatusNotification

Teatab taustasüsteemile, et laadimissessioon on lõppenud.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
transactionId	integer	Kohustuslik	Lõpetatava laadimissessiooni ID.
timestamp	string	Kohustuslik	Laadimissessiooni lõpu ajatempel. Kuupäev ja kellaaeg.
meterStop	integer	Kohustuslik	Arvestinäit laadimissessiooni lõpus (Wh).
idTag	string	Valikuline	Identifikaator, mis lõpetamist taotles. Kõige rohkem 20 märki.
reason	string	Valikuline	Laadimissessiooni lõpetamise põhjus. Üks järgmistest: EmergencyStop, EVDisconnected, HardReset, Local, Other, PowerLoss, Reboot, Remote, SoftReset, UnlockCommand, DeAuthorized.
transactionData	array	Valikuline	MeterValue-objektide massiiv (sama struktuur nagu MeterValues.meterValue).
timestamp	string	Kohustuslik	Arvestinäidu ajatempel. Kuupäev ja kellaaeg.
sampledValue	array	Kohustuslik	Üks või mitu mõõdetud väärtust.
value	string	Kohustuslik	Mõõdetud väärtus.
context	string	Valikuline	Näidu kontekst. Üks järgmistest: Interruption.Begin, Interruption.End, Sample.Clock, Sample.Periodic, Transaction.Begin, Transaction.End, Trigger, Other.
format	string	Valikuline	Väärtuse vorming. Üks järgmistest: Raw, SignedData.
measurand	string	Valikuline	Mõõtmise tüüp. Üks järgmistest: 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.
phase	string	Valikuline	Faas, mille kohta mõõtmine käib. Üks järgmistest: L1, L2, L3, N, L1-N, L2-N, L3-N, L1-L2, L2-L3, L3-L1.
location	string	Valikuline	Mõõtmise koht. Üks järgmistest: Cable, EV, Inlet, Outlet, Body.
unit	string	Valikuline	Mõõtühik. Üks järgmistest: Wh, kWh, varh, kvarh, W, kW, VA, kVA, var, kvar, A, V, K, Celcius, Celsius, Fahrenheit, Percent.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
idTagInfo	object	Valikuline	idTagi autoriseerimisteave.
status	string	Kohustuslik	Autoriseerimise olek. Üks järgmistest: Accepted, Blocked, Expired, Invalid, ConcurrentTx.
expiryDate	string	Valikuline	Kuupäev ja kellaaeg, millest alates idTagi loetakse aegunuks. Kuupäev ja kellaaeg.
parentIdTag	string	Valikuline	Ülem-idTag grupi autoriseerimiseks. Kõige rohkem 20 märki.

Näide

Laadija saadab

[2, "b380dc07", "StopTransaction", {
  "transactionId": 4521,
  "timestamp": "2026-10-06T09:30:00Z",
  "meterStop": 19840,
  "idTag": "04A2B3C4D5E6F7"
}]

Taustasüsteem vastab

[3, "b380dc07", {
  "idTagInfo": {
    "status": "Accepted"
  }
}]

OCPP 2.0.1-s: TransactionEvent

Vabastab pistiku kaugelt.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
connectorId	integer	Kohustuslik	Vabastatav pistik.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Vabastamispäringu tulemus. Üks järgmistest: Unlocked, UnlockFailed, NotSupported.

Näide

Taustasüsteem saadab

[2, "882ccab0", "UnlockConnector", {
  "connectorId": 1
}]

Laadija vastab

[3, "882ccab0", {
  "status": "Unlocked"
}]

OCPP 2.0.1-s: UnlockConnector

Püsivara haldus

Püsivara uuendused ja diagnostikaandmete üleslaadimine laadijate kaughoolduseks.

Palub laadijal diagnostikalogid üles laadida.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
location	string	Kohustuslik	URI, kuhu diagnostikaandmed üles laadida. Aadress (URI).
retries	integer	Valikuline	Üleslaadimise korduskatsete arv.
retryInterval	integer	Valikuline	Korduskatsete vahe sekundites.
startTime	string	Valikuline	Logide kogumise ajavahemiku algus. Kuupäev ja kellaaeg.
stopTime	string	Valikuline	Logide kogumise ajavahemiku lõpp. Kuupäev ja kellaaeg.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
fileName	string	Valikuline	Diagnostikafaili nimi. Kõige rohkem 255 märki.

Näide

Taustasüsteem saadab

[2, "da7920cd", "GetDiagnostics", {
  "location": "ftp://files.example.com/diagnostics/"
}]

Laadija vastab

[3, "da7920cd", {}]

OCPP 2.0.1-s: GetLog

Teatab diagnostikaandmete üleslaadimise oleku.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Diagnostikaandmete üleslaadimise praegune olek. Üks järgmistest: Idle, Uploaded, UploadFailed, Uploading.

Vastus

Välju pole: vastus on tühi.

Näide

Laadija saadab

[2, "d1c853b4", "DiagnosticsStatusNotification", {
  "status": "Uploaded"
}]

Taustasüsteem vastab

[3, "d1c853b4", {}]

OCPP 2.0.1-s: LogStatusNotification

Teatab püsivara uuenduse oleku.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Püsivara uuenduse praegune olek. Üks järgmistest: Downloaded, DownloadFailed, Downloading, Idle, InstallationFailed, Installing, Installed.

Vastus

Välju pole: vastus on tühi.

Näide

Laadija saadab

[2, "dc9afcb2", "FirmwareStatusNotification", {
  "status": "Installed"
}]

Taustasüsteem vastab

[3, "dc9afcb2", {}]

OCPP 2.0.1-s: FirmwareStatusNotification

Annab laadijale korralduse uus püsivara alla laadida ja paigaldada.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
location	string	Kohustuslik	URI, kust püsivara saab alla laadida. Aadress (URI).
retrieveDate	string	Kohustuslik	Kuupäev ja kellaaeg, mille järel laadija peaks püsivara alla laadima. Kuupäev ja kellaaeg.
retries	integer	Valikuline	Allalaadimise korduskatsete arv.
retryInterval	integer	Valikuline	Korduskatsete vahe sekundites.

Vastus

Välju pole: vastus on tühi.

Näide

Taustasüsteem saadab

[2, "a57cc6a2", "UpdateFirmware", {
  "location": "ftp://files.example.com/fw-1.4.3.bin",
  "retrieveDate": "2026-10-07T02:00:00Z"
}]

Laadija vastab

[3, "a57cc6a2", {}]

OCPP 2.0.1-s: UpdateFirmware

Kohalik autoriseerimisloend

Laadija kohaliku autoriseerimisloendi haldamine võrguühenduseta autentimiseks.

Loeb kohaliku autoriseerimisloendi versiooninumbri.

Päring

Välju pole: päring on tühi.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
listVersion	integer	Kohustuslik	Kohaliku autoriseerimisloendi praegune versiooninumber.

Näide

Taustasüsteem saadab

[2, "ccf23a29", "GetLocalListVersion", {}]

Laadija vastab

[3, "ccf23a29", {
  "listVersion": 1
}]

OCPP 2.0.1-s: GetLocalListVersion

Saadab kohalikule autoriseerimisloendile täieliku või osalise uuenduse.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
listVersion	integer	Kohustuslik	Selle loendiuuenduse versiooninumber.
updateType	string	Kohustuslik	Kas tegemist on täieliku asendusega või muudatuste uuendusega. Üks järgmistest: Differential, Full.
localAuthorizationList	array	Valikuline	Autoriseerimiskirjete loend.
idTag	string	Kohustuslik	Autoriseeritav identifikaator. Kõige rohkem 20 märki.
idTagInfo	object	Valikuline	idTagi autoriseerimisteave.
status	string	Kohustuslik	Autoriseerimise olek. Üks järgmistest: Accepted, Blocked, Expired, Invalid, ConcurrentTx.
expiryDate	string	Valikuline	Kuupäev ja kellaaeg, millest alates idTagi loetakse aegunuks. Kuupäev ja kellaaeg.
parentIdTag	string	Valikuline	Ülem-idTag grupi autoriseerimiseks. Kõige rohkem 20 märki.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Kohaliku loendi uuenduse tulemus. Üks järgmistest: Accepted, Failed, NotSupported, VersionMismatch.

Näide

Taustasüsteem saadab

[2, "a23c9563", "SendLocalList", {
  "listVersion": 1,
  "updateType": "Full",
  "localAuthorizationList": [
    {
      "idTag": "04A2B3C4D5E6F7",
      "idTagInfo": {
        "status": "Accepted"
      }
    }
  ]
}]

Laadija vastab

[3, "a23c9563", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: SendLocalList

Broneerimine

Pistiku broneerimine kindlale kasutajale ette.

Tühistab olemasoleva broneeringu.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
reservationId	integer	Kohustuslik	Tühistatava broneeringu ID.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Kas broneering tühistati. Üks järgmistest: Accepted, Rejected.

Näide

Taustasüsteem saadab

[2, "63258356", "CancelReservation", {
  "reservationId": 7
}]

Laadija vastab

[3, "63258356", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: CancelReservation

Loob broneeringu kindlale pistikule.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
connectorId	integer	Kohustuslik	Broneeritav pistik (0 = mitte kindel pistik).
expiryDate	string	Kohustuslik	Broneeringu aegumise kuupäev ja kellaaeg. Kuupäev ja kellaaeg.
idTag	string	Kohustuslik	Identifikaator, kelle jaoks broneering tehakse. Kõige rohkem 20 märki.
reservationId	integer	Kohustuslik	Selle broneeringu unikaalne ID.
parentIdTag	string	Valikuline	Ülem-idTag grupi broneeringuks. Kõige rohkem 20 märki.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Broneerimispäringu tulemus. Üks järgmistest: Accepted, Faulted, Occupied, Rejected, Unavailable.

Näide

Taustasüsteem saadab

[2, "62a25d78", "ReserveNow", {
  "connectorId": 1,
  "expiryDate": "2026-10-06T10:00:00Z",
  "idTag": "04A2B3C4D5E6F7",
  "reservationId": 7
}]

Laadija vastab

[3, "62a25d78", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: ReserveNow

Nutikas laadimine

Laadimisprofiilide seadmine ja haldamine koormuse tasakaalustamiseks, päikeseenergia kasutamiseks ja ajastatud laadimiseks.

Eemaldab laadijalt ühe või mitu laadimisprofiili.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
id	integer	Valikuline	Eemaldatava laadimisprofiili ID.
connectorId	integer	Valikuline	Pistik, mille profiilid eemaldada.
chargingProfilePurpose	string	Valikuline	Eemaldatavate profiilide eesmärk. Üks järgmistest: ChargePointMaxProfile, TxDefaultProfile, TxProfile.
stackLevel	integer	Valikuline	Eemaldatavate profiilide virnatase (stack level).

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Kas mõni profiil eemaldati. Üks järgmistest: Accepted, Unknown.

Näide

Taustasüsteem saadab

[2, "2c436739", "ClearChargingProfile", {}]

Laadija vastab

[3, "2c436739", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: ClearChargingProfile

Küsib pistiku koondatud laadimisajakava.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
connectorId	integer	Kohustuslik	Pistik, mille ajakava küsitakse.
duration	integer	Kohustuslik	Küsitud ajakava kestus sekundites.
chargingRateUnit	string	Valikuline	Ajakava eelistatud ühik. Üks järgmistest: A, W.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Kas laadija saab ajakava anda. Üks järgmistest: Accepted, Rejected.
connectorId	integer	Valikuline	Pistik, millele ajakava kehtib.
scheduleStart	string	Valikuline	Koondajakava alguse kuupäev ja kellaaeg. Kuupäev ja kellaaeg.
chargingSchedule	object	Valikuline	Koondatud laadimisajakava.
chargingRateUnit	string	Kohustuslik	Laadimiskiiruse ühik (amprid või vatid). Üks järgmistest: A, W.
chargingSchedulePeriod	array	Kohustuslik	Ajakava perioodide loend.
startPeriod	integer	Kohustuslik	Perioodi algus sekundites ajakava algusest.
limit	number	Kohustuslik	Võimsuse või voolu piirang selle perioodi ajal. Sammuga 0,1.
numberPhases	integer	Valikuline	Laadimiseks kasutatavate faaside arv.
duration	integer	Valikuline	Ajakava kestus sekundites.
startSchedule	string	Valikuline	Ajakava alguse kuupäev ja kellaaeg. Kuupäev ja kellaaeg.
minChargingRate	number	Valikuline	Väikseim toetatud laadimiskiirus. Sammuga 0,1.

Näide

Taustasüsteem saadab

[2, "50bc203f", "GetCompositeSchedule", {
  "connectorId": 1,
  "duration": 3600
}]

Laadija vastab

[3, "50bc203f", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: GetCompositeSchedule

Saadab laadijale laadimisprofiili.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
connectorId	integer	Kohustuslik	Pistik, millele profiil kehtib.
csChargingProfiles	object	Kohustuslik	Paigaldatav laadimisprofiil.
chargingProfileId	integer	Kohustuslik	Selle laadimisprofiili unikaalne identifikaator.
stackLevel	integer	Kohustuslik	Profiili prioriteedi tase (suurem = kõrgem prioriteet).
chargingProfilePurpose	string	Kohustuslik	Laadimisprofiili eesmärk. Üks järgmistest: ChargePointMaxProfile, TxDefaultProfile, TxProfile.
chargingProfileKind	string	Kohustuslik	Ajakava liik. Üks järgmistest: Absolute, Recurring, Relative.
chargingSchedule	object	Kohustuslik	Laadimise ajakava.
chargingRateUnit	string	Kohustuslik	Laadimiskiiruse ühik (amprid või vatid). Üks järgmistest: A, W.
chargingSchedulePeriod	array	Kohustuslik	Ajakava perioodide loend.
startPeriod	integer	Kohustuslik	Perioodi algus sekundites ajakava algusest.
limit	number	Kohustuslik	Võimsuse või voolu piirang selle perioodi ajal. Sammuga 0,1.
numberPhases	integer	Valikuline	Laadimiseks kasutatavate faaside arv.
duration	integer	Valikuline	Ajakava kestus sekundites.
startSchedule	string	Valikuline	Ajakava alguse kuupäev ja kellaaeg. Kuupäev ja kellaaeg.
minChargingRate	number	Valikuline	Väikseim toetatud laadimiskiirus. Sammuga 0,1.
transactionId	integer	Valikuline	Laadimissessioon, millele see profiil kehtib.
recurrencyKind	string	Valikuline	Korduvate profiilide kordussagedus. Üks järgmistest: Daily, Weekly.
validFrom	string	Valikuline	Kuupäev ja kellaaeg, millest alates profiil kehtib. Kuupäev ja kellaaeg.
validTo	string	Valikuline	Kuupäev ja kellaaeg, mille järel profiil enam ei kehti. Kuupäev ja kellaaeg.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Kas profiil võeti vastu. Üks järgmistest: Accepted, Rejected, NotSupported.

Näide

Taustasüsteem saadab

[2, "01be9b20", "SetChargingProfile", {
  "connectorId": 1,
  "csChargingProfiles": {
    "chargingProfileId": 10,
    "stackLevel": 0,
    "chargingProfilePurpose": "TxDefaultProfile",
    "chargingProfileKind": "Relative",
    "chargingSchedule": {
      "chargingRateUnit": "A",
      "chargingSchedulePeriod": [
        {
          "startPeriod": 0,
          "limit": 16.0
        }
      ]
    }
  }
}]

Laadija vastab

[3, "01be9b20", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: SetChargingProfile

Kaugkäivitus

Laadijalt kindla sõnumi küsimine nõudmisel.

Palub laadijal kohe kindla sõnumi saata.

Päring

Väli	Tüüp	Kasutus	Mida see sisaldab
requestedMessage	string	Kohustuslik	Sõnum, mille laadija peaks saatma. Üks järgmistest: BootNotification, DiagnosticsStatusNotification, FirmwareStatusNotification, Heartbeat, MeterValues, StatusNotification.
connectorId	integer	Valikuline	Pistik, mille kohta sõnum saata.

Vastus

Väli	Tüüp	Kasutus	Mida see sisaldab
status	string	Kohustuslik	Kas laadija saadab sõnumi. Üks järgmistest: Accepted, Rejected, NotImplemented.

Näide

Taustasüsteem saadab

[2, "4c736efd", "TriggerMessage", {
  "requestedMessage": "StatusNotification"
}]

Laadija vastab

[3, "4c736efd", {
  "status": "Accepted"
}]

OCPP 2.0.1-s: TriggerMessage

OCPP 1.6 konfiguratsioonivõtmed

ChangeConfiguration seab laadijal korraga ühe võtme ja GetConfiguration loeb need tagasi. Just siin otsustatakse suurem osa laadija tegelikust käitumisest: kui tihti arvestinäidud saabuvad, mis neis on, kas laadimissessioon elab võrgukatkestuse üle, kuidas kaabel vabaneb.

Kuidas päring käitub

Iga väärtus on stringKa numbrid ja tõeväärtused: "60", "true". JSON-number rikub sõnumi skeemi ja laadija, mis skeemi kontrollib, vastab CallErroriga.
Kirjutage võtmenimed nii nagu spetsifikatsioonisSpetsifikatsioon käsitleb võtmenimesid tõstutundetuna, kuid mitte iga laadija ei tee seda, nii et kirjutage MeterValuesSampledData, mitte metervaluessampleddata.
Mõni võti vajab taaskäivitustLaadija vastab RebootRequired ja Reseti saatmine on teie ülesanne.
Tootjad lisavad oma võtmeidTühja võtmeloendiga GetConfiguration tagastab kõik võtmed, mida laadija toetab, ka tootja enda omad. Nimepidi küsitud võtmed, mida laadija ei tunne, tulevad tagasi väljal unknownKey.

Neli vastust

Accepted: Võti on seatud ja kohe aktiivne.
Rejected: Võti on olemas, kuid väärtus lükati tagasi: lubatud vahemikust väljas, vale vorming või sellel laadijal kirjutuskaitstud.
RebootRequired: Väärtus on salvestatud, kuid hakkab kehtima alles pärast laadija taaskäivitust.
NotSupported: Laadija ei toeta seda võtit üldse.

Kõik 43 võtit funktsiooniprofiilide kaupa

Võti	Tüüp	Juurdepääs	Mida see teeb
Core34
AllowOfflineTxForUnknownIdSpetsifikatsioonis valikuline	boolean	Lugemine ja kirjutamine	Kas laadija alustab võrguühenduseta olles laadimissessiooni tundmatu idTagiga.True hoiab asukoha laadimas ka võrgukatkestuse ajal, kuid selle hinnaks võivad olla laadimissessioonid, mida te ei saa kellelegi arveldada.
AuthorizationCacheEnabledSpetsifikatsioonis valikuline	boolean	Lugemine ja kirjutamine	Kas laadija salvestab varasemate Authorize-päringute tulemuse vahemällu.See erineb kohalikust autoriseerimisloendist: vahemälu täitub ise tegelikest autoriseerimistest, loendi saadab taustasüsteem.
AuthorizeRemoteTxRequests	boolean	Lugemine	Kas laadija autoriseerib RemoteStartTransactioni idTagi enne alustamist.Kui true, vajab rakendusest kaugkäivitus ikkagi Authorize-ringi, nii et vigane idTag nurjab käivituse.
BlinkRepeatSpetsifikatsioonis valikuline	integer	Lugemine ja kirjutamine	Kui mitu korda laadija vilkumisjada ajal tuld vilgutab.
ClockAlignedDataInterval	integer	Lugemine ja kirjutamine	Kellaajaga joondatud arvestinäitude intervall, mõõdetuna keskööst. 0 lülitab need välja.900 annab näidu iga veerandtunni tagant. Just see toidab MeterValuesAlignedData väärtusi ja töötab olenemata sellest, kas auto on ühendatud.
ConnectionTimeOut	integer	Lugemine ja kirjutamine	Kui kaua laadija pärast autoriseerimist ootab, et juht kaabli ühendaks, enne kui pistiku vabastab.
ConnectorPhaseRotation	CSL	Lugemine ja kirjutamine	Faaside järjestus pistiku kaupa, kujul connectorId.RST, näiteks 0.RST, 1.RST, 2.RTS.Viga siin tähendab valesid faasipõhiseid arvestinäite ja valet ühefaasilist koormuse tasakaalustamist. Tasub kontrollida igal kolmefaasilisel asukohal.
ConnectorPhaseRotationMaxLengthSpetsifikatsioonis valikuline	integer	Lugemine	ConnectorPhaseRotationi elementide suurim arv.
GetConfigurationMaxKeys	integer	Lugemine	Suurim võtmete arv, mida üks GetConfiguration-päring küsida tohib.Küsige rohkem ja laadija võib vastata veaga. Saatke GetConfiguration üldse ilma võtmeteta, et saada kõik, mida laadija toetab.
HeartbeatInterval	integer	Lugemine ja kirjutamine	Kui tihti laadija saadab Heartbeati, kui midagi muud ei toimu.BootNotificationi vastus võib selle üle kirjutada. Mahupõhise SIM-kaardi puhul on lühike heartbeat vaikne andmekulu, mis koguneb.
LightIntensitySpetsifikatsioonis valikuline	integer	Lugemine ja kirjutamine	Laadija valgustuse heledus protsentides.
LocalAuthorizeOffline	boolean	Lugemine ja kirjutamine	Kas laadija autoriseerib võrguühenduseta olles kohaliku loendi või vahemälu põhjal.
LocalPreAuthorize	boolean	Lugemine ja kirjutamine	Kas laadija alustab võrgus olles laadimissessiooni kohaliku loendi või vahemälu põhjal, ootamata taustasüsteemi.Lühendab ootamist laadija juures, kuid siis ei ole taustasüsteemil iga käivituse üle viimast sõna.
MaxEnergyOnInvalidIdSpetsifikatsioonis valikuline	integer	Lugemine ja kirjutamine	Energia, mida laadija veel annab pärast seda, kui autoriseerimine osutub kehtetuks.
MeterValuesAlignedData	CSL	Lugemine ja kirjutamine	Mõõdetavad suurused, mis saadetakse kellaajaga joondatud MeterValues-sõnumites, intervalliga ClockAlignedDataInterval.Sama mõõdetavate suuruste sõnavara nagu MeterValuesSampledData puhul, kuid teine päästik: kell, mitte laadimissessioon.
MeterValuesAlignedDataMaxLengthSpetsifikatsioonis valikuline	integer	Lugemine	Mõõdetavate suuruste suurim arv MeterValuesAlignedData väärtuses.
MeterValuesSampledData	CSL	Lugemine ja kirjutamine	Mõõdetavad suurused, mida laadimissessiooni ajal mõõdetakse ja saadetakse MeterValues-sõnumites, intervalliga MeterValueSampleInterval.Kõige kasulikum võti sellel lehel. Vaadake allpool põhjalikumat käsitlust.
MeterValuesSampledDataMaxLengthSpetsifikatsioonis valikuline	integer	Lugemine	Mõõdetavate suuruste suurim arv MeterValuesSampledData väärtuses.Lugege seda enne pika loendi koostamist: ületage see ja laadija lükkab kogu loendi tagasi.
MeterValueSampleInterval	integer	Lugemine ja kirjutamine	Kui tihti laadija laadimissessiooni ajal MeterValuesSampledData väärtusi mõõdab. 0 lülitab mõõtmise välja.60 on mõistlik vaikeväärtus. Alla 30 ja pika mõõdetavate suuruste loendiga tekitate palju liiklust väga väikese lisateabe eest.
MinimumStatusDurationSpetsifikatsioonis valikuline	integer	Lugemine ja kirjutamine	Lühim aeg, mille laadija olekus püsib, enne kui järgmise oleku teatab.Kasulik oleku edasi-tagasi hüplemise vastu laadijatel, mis põrkavad Preparingu ja Availablei vahel.
NumberOfConnectors	integer	Lugemine	Füüsiliste pistikute arv sellel laadijal.
ResetRetries	integer	Lugemine ja kirjutamine	Kui mitu korda laadija ebaõnnestunud lähtestust uuesti proovib.
StopTransactionOnEVSideDisconnect	boolean	Lugemine ja kirjutamine	Kas kaabli eemaldamine auto poolelt lõpetab käimasoleva laadimissessiooni.False tähendab, et laadimissessioon jääb pärast kaabli eemaldamist avatuks, ja nii tekivadki laadimissessioonid, mis kunagi ei lõpe.
StopTransactionOnInvalidId	boolean	Lugemine ja kirjutamine	Kas laadija lõpetab laadimissessiooni, kui taustasüsteem idTagi tagasi lükkab.
StopTxnAlignedData	CSL	Lugemine ja kirjutamine	Kellaajaga joondatud mõõdetavad suurused, mis lisatakse StopTransactioni väljale transactionData.
StopTxnAlignedDataMaxLengthSpetsifikatsioonis valikuline	integer	Lugemine	Mõõdetavate suuruste suurim arv StopTxnAlignedData väärtuses.
StopTxnSampledData	CSL	Lugemine ja kirjutamine	Mõõdetud suurused, mis lisatakse StopTransactioni väljale transactionData.Hoidke see lühike. Kõik, mis siin on, korratakse kogu laadimissessiooni iga mõõtmise kohta ühes StopTransactioni sõnumis, ja nii tekitavad laadijad megabaidiseid lõpetussõnumeid, mille taustasüsteemid tagasi lükkavad.
StopTxnSampledDataMaxLengthSpetsifikatsioonis valikuline	integer	Lugemine	Mõõdetavate suuruste suurim arv StopTxnSampledData väärtuses.
SupportedFeatureProfiles	CSL	Lugemine	Funktsiooniprofiilid, mida see laadija toetab, näiteks Core, FirmwareManagement, SmartCharging.Aus vastus küsimusele, mida laadija suudab. Lugege see enne, kui kliendile nutikat laadimist lubate.
SupportedFeatureProfilesMaxLengthSpetsifikatsioonis valikuline	integer	Lugemine	SupportedFeatureProfilesi elementide suurim arv.
TransactionMessageAttempts	integer	Lugemine ja kirjutamine	Kui mitu korda laadija proovib uuesti saata laadimissessiooni sõnumit, mida taustasüsteem ei kinnitanud.
TransactionMessageRetryInterval	integer	Lugemine ja kirjutamine	Nende korduskatsete vaheline põhiooteaeg. Laadija korrutab selle katse järjekorranumbriga.
UnlockConnectorOnEVSideDisconnect	boolean	Lugemine ja kirjutamine	Kas kaabel vabaneb laadija juures, kui see auto poolelt lahti ühendatakse.
WebSocketPingIntervalSpetsifikatsioonis valikuline	integer	Lugemine ja kirjutamine	WebSocketi ping-kaadrite intervall OCPP-J ühendusel.Vaikne lahendus laadijatele, mis kaovad pidevalt võrgust NAT-i või tulemüüri taga, mis jõudeolevad ühendused sulgeb.
Kohalik autoriseerimisloend3
LocalAuthListEnabled	boolean	Lugemine ja kirjutamine	Kas kohalik autoriseerimisloend on kasutusel.
LocalAuthListMaxLength	integer	Lugemine	Mitu kirjet kohalik autoriseerimisloend mahutab.
SendLocalListMaxLength	integer	Lugemine	Mitu kirjet mahub ühte SendLocalList-sõnumisse.Sellest suurem loend tuleb saata mitme muudatuste uuendusena.
Broneerimine1
ReserveConnectorZeroSupportedSpetsifikatsioonis valikuline	boolean	Lugemine	Kas laadija võtab vastu broneeringu pistikule 0 ehk ükskõik millisele pistikule.
Nutikas laadimine5
ChargeProfileMaxStackLevel	integer	Lugemine	Kõrgeim virnatase (stack level), mida laadija laadimisprofiilil aktsepteerib. Kõrgem tase võidab.
ChargingScheduleAllowedChargingRateUnit	CSL	Lugemine	Milliseid ühikuid laadija laadimisajakavas aktsepteerib: vool (A), võimsus (W) või mõlemad.Saatke vattides profiil laadijale, mis võtab vastu ainult ampreid, ja see lükatakse tagasi. See võti ütleb, kumba kasutada.
ChargingScheduleMaxPeriods	integer	Lugemine	Perioodide suurim arv ühes laadimisajakavas.
ConnectorSwitch3to1PhaseSupportedSpetsifikatsioonis valikuline	boolean	Lugemine	Kas laadija saab lülituda kolmefaasilise ja ühefaasilise laadimise vahel.Otsustab, kas saate laadimist piirata alla kolmefaasilise miinimumi, selle asemel, et see täielikult peatada.
MaxChargingProfilesInstalled	integer	Lugemine	Mitu laadimisprofiili saab korraga paigaldada.

MeterValuesSampledData: mida laadija mõõdab

Üks võti, MeterValuesSampledData, otsustab, milliseid telemeetriaandmeid laadimissessioonist saate. See on komadega eraldatud mõõdetavate suuruste loend ja laadija mõõdab iga selle elementi MeterValueSampleIntervaliga määratud intervalliga ning saadab need MeterValues-sõnumis. Jätke see vaikeväärtusele ja saate ühe kumulatiivse energianäidu, millest piisab arveldamiseks, ja mitte midagi muud: ei võimsuskõverat, ei faasipõhist voolu, ei pinget ega võimalust näha, kas nutika laadimise piirang rakendus.

See ei tööta kunagi üksi. MeterValueSampleInterval määrab, kui tihti see käivitub, MeterValuesSampledDataMaxLength piirab, mitu mõõdetavat suurust võite loetleda, StopTxnSampledData otsustab, milliseid neist StopTransactionis korratakse, ja MeterValuesAlignedData on sama sõnavara kellaaja järgi, mitte laadimissessiooni järgi.

Mõõdetavad suurused

Loendis võib olla ükskõik milline neist. Milliseid laadija toetab, sõltub selle riistvarast: AC-seinalaadija ei teata tavaliselt laetuse taset ja lihtsal laadijal võib olla ainult energiaregister.

Mõõdetav suurus	Ühik	Tavaliselt olemas	Mida see annab
Energy.Active.Import.Register	Wh	AC ja DC	Võrgust tarbitud kumulatiivne energia, loetud otse arvesti registrist. Vaikeväärtus, kui MeterValuesSampledData on tühi, ja väärtus, millele peaaegu iga arveldusarvutus tugineb.
Energy.Active.Export.Register	Wh	V2G-võimekusega	Võrku tagasi antud kumulatiivne energia, kahesuunaliste lahenduste jaoks.
Energy.Active.Import.Interval	Wh	AC ja DC	Eelmisest mõõtmisest alates tarbitud energia, mitte jooksev kogusumma.
Energy.Reactive.Import.Register	varh	Sõltub arvestist	Tarbitud kumulatiivne reaktiivenergia.
Power.Active.Import	W	AC ja DC	Hetkeline aktiivvõimsus. Selle järgi joonistate laadimiskõvera ja sellele reageerib koormuse juhtimine.
Power.Offered	W	AC ja DC	Võimsus, mida laadija parajasti autole pakub. Võrrelge seda väärtusega Power.Active.Import, et näha, kas piirangut tegelikult rakendatakse.
Power.Reactive.Import	var	Sõltub arvestist	Hetkeline reaktiivvõimsus.
Power.Factor	suhe	Sõltub arvestist	Aktiivvõimsuse ja näivvõimsuse suhe.
Current.Import	A	AC ja DC	Tarbitud vool. Tavaliselt teatatakse faaside kaupa, nii et see üks mõõdetav suurus võib anda ühe mõõtmise kohta kolm väärtust.
Current.Offered	A	AC ja DC	Voolupiirang, mida laadija autole signaliseerib. Otsene näit selle kohta, kas teie nutika laadimise profiil rakendus.
Current.Export	A	V2G-võimekusega	Võrku tagasi antud vool, kahesuunaliste lahenduste jaoks.
Voltage	V	AC ja DC	Toitepinge, kolmefaasilistel laadijatel faaside kaupa. Kasulik kadunud faasi või nõrga ühenduse märkamiseks.
Frequency	Hz	Sõltub arvestist	Võrgusagedus. Pange tähele, et spetsifikatsioon ei anna sellele ühikuvälja.
Temperature	Celsius	Sõltub laadijast	Temperatuur laadijas või pistikus. Selgitab võimsuse vähendamist kuumal päeval enne, kui keegi seda rikkeks nimetab.
SoC	%	DC või AC puhul ISO 15118	Auto aku laetuse tase. Olemas ainult siis, kui auto seda tegelikult teatab, mida tavalise AC-laadimise puhul see enamasti ei tee.
RPM	rpm	Harva	Ventilaatori kiirus laadijatel, mis seda teatavad.

Toimivad loendid

Kopeerige üks neist ChangeConfiguration-päringu väärtuseks. Alustage kitsalt ja lisage mõõdetavaid suurusi, kui laadija need vastu võtab.

Ainult arveldamine
Miinimum, millega saab ikka õige arve. Vaikeväärtus enamikul laadijatel.
Energy.Active.Import.Register
Standardne telemeetria
Mõistlik vaikeväärtus hallatud AC-asukohale: võimsuskõver, faasipõhine vool ja pinge diagnostikaks.
Energy.Active.Import.Register, Power.Active.Import, Current.Import, Voltage
Nutikas laadimine
Lisab pakutud väärtused, et näeksite, kas profiili tegelikult rakendatakse, selle asemel, et seda eeldada.
Energy.Active.Import.Register, Power.Active.Import, Power.Offered, Current.Import, Current.Offered, Voltage
DC-kiirlaadimine
Lisab laetuse taseme ja temperatuuri, mida DC-laadijad teatavad ja mis selgitavad enamikku võimsuse vähendamisi.
Energy.Active.Import.Register, Power.Active.Import, Current.Import, Voltage, SoC, Temperature

Mis läheb valesti

Üks vigane mõõdetav suurus lükkab kogu loendi tagasi
Laadijad kontrollivad loendit tervikuna. Kui üks element pole toetatud, saate kõige kohta Rejected või NotSupported, ilma vihjeta, milline ebaõnnestus. Seadke loend ühe mõõdetava suuruse kaupa, et süüdlane leida, või lugege enne MeterValuesSampledDataMaxLength ja tootja dokumentatsioon.
Üks mõõdetav suurus võib olla kolm väärtust
Current.Import ja Voltage teatatakse faaside kaupa, nii et kolmefaasilisel laadijal saabuvad need kumbki kolme sampledValue-kirjena, märgistusega L1, L2, L3 või L1-N jne. Kuue mõõdetava suurusega loend võib ühe mõõtmise kohta kergesti olla tosin väärtust. Sõnumi maht kasvab kiiremini, kui loendi pikkus arvata laseb.
Wh või kWh
Energiaregister on vaikimisi Wh, kuid ühikuväli võib öelda kWh ja mõni püsivara teebki nii. Lugege ühikut, mitte ärge eeldage, muidu saate arve, mis on tuhandekordselt vale.
Lühike intervall pole tasuta
MeterValueSampleInterval 10 sekundit koos pika loendiga tähendab laadimissessiooni kohta sadu sõnumeid. Mahupõhise SIM-kaardi puhul on see päris raha ja suurel asukohal päris koormus taustasüsteemile. 60 sekundit on hea vaikeväärtus, 300 asukohtadele, kus vajate ainult kõvera kuju.
StopTxnSampledData on sõnumimahu lõks
Kõik, mis seal on loetletud, korratakse kogu laadimissessiooni iga mõõtmise kohta ühes StopTransactioni sõnumis. Pikk loend pikal laadimissessioonil annab nii suure sõnumi, et taustasüsteemid lükkavad selle tagasi või kärbivad seda, ja siis ei sulgu laadimissessioon korrektselt. Piirduge energiaregistriga, kui teil pole konkreetset põhjust.
Jätke energiaregister välja ja arveldamine läheb katki
Kui Energy.Active.Import.Register pole loendis, ei sisalda perioodilised arvestinäidud kumulatiivset kogusummat. Enamik taustasüsteeme kasutab siis laadimissessiooni sõnumitest meterStart ja meterStop väärtusi ning iga laadimissessioon, mille StopTransaction kaduma läheb, muutub arveldamatuks. Hoidke see alati loendis.
AC puhul pole SoC tavaliselt saadaval
Laetuse tase tuleb autolt, ISO 15118 või DC-laadimisprotokolli kaudu. Tavalise AC-seinalaadija puhul ilma Plug and Charge'ita auto seda ei teata, nii et SoC küsimine kas lükatakse tagasi või ei anna midagi kasulikku.
Lugege konteksti välja
Igal sampledValue-kirjel on kontekst: Sample.Periodic, Transaction.Begin, Transaction.End, Sample.Clock või Trigger. Väärtus kontekstiga Transaction.Begin on algne registrinäit, mitte tarbimine. Kui käsitlete iga mõõtmist perioodilisena, loetakse laadimissessioone topelt.

Küsimused OCPP 1.6J kohta

OCPP 1.6J on Open Charge Point Protocoli versioon 1.6 JSON-kujul. Laadija avab oma taustasüsteemiga WebSocket-ühenduse ja mõlemad pooled saadavad selle kaudu JSON-sõnumeid. Open Charge Alliance avaldas versiooni 1.6 2015. aastal ja enamik laadijaid toetab seda endiselt: meie laadijate andmebaasis toetab 495 teadaoleva OCPP versiooniga laadijast 1.6 versiooni 483.

Need edastavad samu sõnumeid erineval viisil. 1.6J saadab JSON-i WebSocketi kaudu, mida laadija hoiab avatuna, nii et laadija vajab ainult väljuvat ühendust. 1.6S saadab SOAP-i HTTP kaudu ja siis peab ka taustasüsteem laadijani jõudma.

2.0.1 on uuem versioon oma sõnumite komplektiga. See kirjeldab laadija seadeid seadmemudelis, sisaldab turbeprofiile, asendab StartTransactioni ja StopTransactioni sõnumiga TransactionEvent ning lisab sõnumid Plug and Charge'i (ISO 15118) jaoks. Need kaks ei segune: laadija ja selle taustasüsteem lepivad ühenduse avamisel kokku ühes versioonis. Meie laadijate andmebaasis on 102 laadijal märgitud 2.0.1 kas lisaks 1.6-le või selle asemel. Kõik 2.0.1 ja 2.1 sõnumid on OCPP 2.0.1 ja 2.1 teatmikus.

Open Charge Alliance avaldab selle tasuta oma veebilehel koos iga sõnumi JSON-skeemiga. See teatmik järgib seda spetsifikatsiooni. Kui need kaks erinevad, on õigus spetsifikatsioonil.

Smart Charging profiili kaudu. Taustasüsteem saadab SetChargingProfile-sõnumi piirangute ajakavaga amprites või vattides. ChargePointMaxProfile piirab kogu laadijat, TxDefaultProfile kehtib igale uuele laadimissessioonile ja TxProfile ühele käimasolevale laadimissessioonile. Kui kaks sama eesmärgiga profiili kattuvad, võidab see, mille stackLevel on kõrgem. Kuidas Plugchoice seda kasutab, on kirjas nutika laadimise lehel.

Vaadake laadijate andmebaasist: 775 laadijat koos meile teadaolevate OCPP versioonidega ja sellega, kust iga teave pärineb. Tavaliselt ütleb seda ka laadija andmeleht, sageli kujul OCPP 1.6J või OCPP 1.6 JSON.

Sisestage laadija seadetes, sageli paigaldaja rakenduses või laadija kohalikul veebilehel, taustasüsteemi WebSocketi URL (algab ws:// või wss://) ja laadija ID ehk charge point identity. Laadija avab ühenduse ja saadab BootNotificationi. Kui taustasüsteem vastab Accepted, on laadija võrgus ja saadab iga pistiku kohta StatusNotificationi.

Plugchoice ja OCPP

Tasuta taustasüsteemÜhendage OCPP 1.6J laadija ja hallake seda veebiportaalis.
RakendusOmanikud ja paigaldajad juhivad sama laadijat oma telefonist.
OCPP-proksiÜks laadija mitmes taustasüsteemis korraga.
TaustasüsteemidTaustasüsteemid, mille valite laadija ühendamisel loendist.

Lisalugemist

16. mai 2024
Mis on OCPP?
Blogi | 3 min lugemist
16. mai 2024
Mis on OCPP taustasüsteem?
Blogi | 2 min lugemist
8. juuli 2026
Mis on OCPP-proksi ja miks panna see laadija ja taustasüsteemi vahele?
Blogi | 5 min lugemist
12. september 2024
Kuidas OCPP nutika laadimise profiilid töötavad ja miks Plugchoice kasutab TxProfile'i
Blogi | 5 min lugemist

See leht tehisintellekti assistentidele

Kogu teatmik, iga sõnum ja iga konfiguratsioonivõti, ühe lihttekstifailina, mille assistent saab korraga läbi lugeda.

Teatmik lihttekstina

Kasutage oma OCPP laadijaid Plugchoice'is

Ühendage oma OCPP 1.6J laadijad tasuta Plugchoice'iga ja hallake neid veebiportaalis, rakenduses ja API kaudu.

Alusta tasuta Vaata OCPP-proksit

OCPP 1.6J protokolli teatmik.

Mis on OCPP 1.6J?

Kõik 28 OCPP 1.6 sõnumit

Core

AuthorizeKüsib idTagi autoriseerimist enne laadimise lubamistLaadijalt taustasüsteemile

Päring

Vastus

Näide

BootNotificationSaadetakse pärast käivitumist, et taustasüsteemis registreerudaLaadijalt taustasüsteemile

Päring

Vastus

Näide

ChangeAvailabilityMuudab pistiku kättesaadavustTaustasüsteemilt laadijale

Päring

Vastus

Näide

ChangeConfigurationMuudab laadija konfiguratsioonivõtitTaustasüsteemilt laadijale

Päring

Vastus

Näide

ClearCacheTühjendab laadija autoriseerimisvahemäluTaustasüsteemilt laadijale

Päring

Vastus

Näide

DataTransferTootjapõhine andmevahetusMõlemas suunas

Päring

Vastus

Näide

GetConfigurationLoeb laadijalt konfiguratsioonivõtmedTaustasüsteemilt laadijale

Päring

Vastus

Näide

HeartbeatPerioodiline elumärk, millega taustasüsteem teab, et laadija on võrgusLaadijalt taustasüsteemile

Päring

Vastus

Näide

MeterValuesSaadab perioodilisi või käivitatud arvestinäiteLaadijalt taustasüsteemile

Päring

Vastus

Näide

RemoteStartTransactionAlustab laadimissessiooni kaugeltTaustasüsteemilt laadijale

Päring

Vastus

Näide

RemoteStopTransactionLõpetab laadimissessiooni kaugeltTaustasüsteemilt laadijale

Päring

Vastus

Näide

ResetLähtestab laadija (kõva või pehme lähtestus)Taustasüsteemilt laadijale

Päring

Vastus

Näide

StartTransactionTeatab taustasüsteemile, et laadimissessioon on alanudLaadijalt taustasüsteemile

Päring

Vastus

Näide

StatusNotificationTeatab pistiku praeguse oleku ja võimalikud veadLaadijalt taustasüsteemile

Päring

Vastus

Näide

StopTransactionTeatab taustasüsteemile, et laadimissessioon on lõppenudLaadijalt taustasüsteemile

Päring

Vastus

Näide

UnlockConnectorVabastab pistiku kaugeltTaustasüsteemilt laadijale

Päring

Vastus

Näide

Püsivara haldus

GetDiagnosticsPalub laadijal diagnostikalogid üles laadidaTaustasüsteemilt laadijale

Päring

Vastus

Näide

DiagnosticsStatusNotificationTeatab diagnostikaandmete üleslaadimise olekuLaadijalt taustasüsteemile

Päring

Vastus

Näide

FirmwareStatusNotificationTeatab püsivara uuenduse olekuLaadijalt taustasüsteemile

Päring

Vastus