OCPP 1.6J -protokollaviite.

Mitä latausasema ja sen taustajärjestelmä sanovat toisilleen: kaikki 28 viestiä kenttineen ja esimerkkeineen, 43 määritysavainta, mitä latausasema voi mitata ja mikä menee käytännössä pieleen.

Hae viitteestä Aloita ilmaiseksi

Viestit Määritysavaimet Mittaussuureet Kysymykset

LatausasemaCharge point TaustajärjestelmäCentral system Yksi WebSocket, JSON

Mikä on OCPP 1.6J?

OCPP eli Open Charge Point Protocol on Open Charge Alliancen ilmainen ja avoin standardi. Se määrää, miten latausasema keskustelee sitä hallitsevan ohjelmiston kanssa: spesifikaatiossa se on Central System, markkinoilla taustajärjestelmä.

Versiossa 1.6J latausasema avaa WebSocket-yhteyden taustajärjestelmään, ja molemmat osapuolet lähettävät sen kautta JSON-viestejä. Latausasema raportoi tilansa, mittariarvonsa ja latausistuntonsa. Taustajärjestelmä käynnistää ja pysäyttää latausistuntoja, muuttaa asetuksia ja asettaa latausrajoja.

Koska standardi on avoin, sitä puhuva latausasema voi yhdistyä myös muihin sitä puhuviin taustajärjestelmiin mallista, laiteohjelmistosta ja asetuksista riippuen. Siksi voit yhdistellä merkkejä samassa kohteessa ja siirtää latausaseman toiseen taustajärjestelmään. Jos haluat käyttää yhtä latausasemaa usean taustajärjestelmän kanssa samaan aikaan, käytä OCPP-välityspalvelinta.

Avoin standardiVapaasti toteutettavissa, Open Charge Alliancen ylläpitämä.
WebSocket ja JSONYksi auki pysyvä yhteys ja rakenteiset viestit.
28 viestiäKuudessa ominaisuusprofiilissa, Coresta Remote Triggeriin.
Molempiin suuntiinLatausasema ja taustajärjestelmä aloittavat kumpikin omat viestinsä.

Kaikki 28 OCPP 1.6 -viestiä

Jokainen viesti on yhden osapuolen pyyntö ja toisen vastaus, jotka yhdistetään toisiinsa yksilöllisellä viestitunnuksella.

Core

Pakollinen. Latausaseman perustoiminnot: valtuutus, lataustapahtumat, tilaraportointi, määritys ja perusetäohjaus.

Pyytää idTagille valtuutuksen ennen kuin lataus sallitaan.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
idTag	string	Pakollinen	Valtuutettava tunniste. Enintään 20 merkkiä.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
idTagInfo	object	Pakollinen	idTagin valtuutustiedot.
status	string	Pakollinen	Valtuutuksen tila. Yksi seuraavista: Accepted, Blocked, Expired, Invalid, ConcurrentTx.
expiryDate	string	Valinnainen	Ajankohta, jonka jälkeen idTag katsotaan vanhentuneeksi. Päivämäärä ja kellonaika.
parentIdTag	string	Valinnainen	Ryhmävaltuutuksen ylätason idTag. Enintään 20 merkkiä.

Esimerkki

Latausasema lähettää

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

Taustajärjestelmä vastaa

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

OCPP 2.0.1 -versiossa: Authorize

Lähetetään käynnistyksen jälkeen, jotta latausasema rekisteröityy taustajärjestelmään.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
chargePointVendor	string	Pakollinen	Latausaseman valmistaja. Enintään 20 merkkiä.
chargePointModel	string	Pakollinen	Latausaseman malli. Enintään 20 merkkiä.
chargePointSerialNumber	string	Valinnainen	Latausaseman sarjanumero. Enintään 25 merkkiä.
chargeBoxSerialNumber	string	Valinnainen	Latauskotelon sarjanumero. Enintään 25 merkkiä.
firmwareVersion	string	Valinnainen	Latausaseman laiteohjelmistoversio. Enintään 50 merkkiä.
iccid	string	Valinnainen	SIM-kortin ICCID. Enintään 20 merkkiä.
imsi	string	Valinnainen	SIM-kortin IMSI. Enintään 20 merkkiä.
meterType	string	Valinnainen	Energiamittarin tyyppi. Enintään 25 merkkiä.
meterSerialNumber	string	Valinnainen	Energiamittarin sarjanumero. Enintään 25 merkkiä.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Rekisteröinnin tila. Yksi seuraavista: Accepted, Pending, Rejected.
currentTime	string	Pakollinen	Central Systemin nykyinen aika. Päivämäärä ja kellonaika.
interval	integer	Pakollinen	Heartbeat-väli sekunteina.

Esimerkki

Latausasema lähettää

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

Taustajärjestelmä vastaa

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

OCPP 2.0.1 -versiossa: BootNotification

Muuttaa latauspisteen käytettävyyttä.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
connectorId	integer	Pakollinen	Latauspisteen ID (0 = koko latausasema).
type	string	Pakollinen	Pyydetty käytettävyyden muutos. Yksi seuraavista: Inoperative, Operative.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Käytettävyyden muutospyynnön tulos. Yksi seuraavista: Accepted, Rejected, Scheduled.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: ChangeAvailability

Muuttaa latausaseman määritysavainta.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
key	string	Pakollinen	Muutettava määritysavain. Enintään 50 merkkiä.
value	string	Pakollinen	Määritysavaimen uusi arvo. Enintään 500 merkkiä.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Määrityksen muutoksen tulos. Yksi seuraavista: Accepted, Rejected, RebootRequired, NotSupported.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: SetVariables

Tyhjentää latausaseman valtuutusvälimuistin.

Pyyntö

Ei kenttiä: pyyntö on tyhjä.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Välimuistin tyhjennyspyynnön tulos. Yksi seuraavista: Accepted, Rejected.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: ClearCache

Valmistajakohtainen tiedonvaihto.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
vendorId	string	Pakollinen	Valmistajan tunniste. Enintään 255 merkkiä.
messageId	string	Valinnainen	Viestin lisätunniste. Enintään 50 merkkiä.
data	string	Valinnainen	Valmistajakohtaiset tiedot.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Tiedonsiirron tulos. Yksi seuraavista: Accepted, Rejected, UnknownMessageId, UnknownVendorId.
data	string	Valinnainen	Valmistajakohtaiset vastaustiedot.

Esimerkki

Yksi osapuoli lähettää

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

Toinen osapuoli vastaa

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

OCPP 2.0.1 -versiossa: DataTransfer

Hakee määritysavaimet latausasemalta.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
key	array	Valinnainen	Lista haettavista määritysavaimista. Kukin enintään 50 merkkiä.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
configurationKey	array	Valinnainen	Lista tunnetuista määritysavaimista.
key	string	Pakollinen	Määritysavaimen nimi. Enintään 50 merkkiä.
readonly	boolean	Pakollinen	Onko avain vain luku -tilassa.
value	string	Valinnainen	Avaimen nykyinen arvo. Enintään 500 merkkiä.
unknownKey	array	Valinnainen	Lista pyydetyistä avaimista, joita ei tunneta. Kukin enintään 50 merkkiä.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: GetBaseReport ja GetVariables

Säännöllinen elossaoloviesti, josta taustajärjestelmä tietää latausaseman olevan online-tilassa.

Pyyntö

Ei kenttiä: pyyntö on tyhjä.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
currentTime	string	Pakollinen	Central Systemin nykyinen aika. Päivämäärä ja kellonaika.

Esimerkki

Latausasema lähettää

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

Taustajärjestelmä vastaa

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

OCPP 2.0.1 -versiossa: Heartbeat

Lähettää säännöllisiä tai pyydettyjä mittarilukemia.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
connectorId	integer	Pakollinen	Latauspisteen ID (0 = päämittari).
meterValue	array	Pakollinen	Yksi tai useampi mittariarvo aikaleimoineen.
timestamp	string	Pakollinen	Mittariarvon aikaleima. Päivämäärä ja kellonaika.
sampledValue	array	Pakollinen	Yksi tai useampi mitattu arvo.
value	string	Pakollinen	Mitattu arvo.
context	string	Valinnainen	Lukeman konteksti. Yksi seuraavista: Interruption.Begin, Interruption.End, Sample.Clock, Sample.Periodic, Transaction.Begin, Transaction.End, Trigger, Other.
format	string	Valinnainen	Arvon muoto. Yksi seuraavista: Raw, SignedData.
measurand	string	Valinnainen	Mittauksen tyyppi. Yksi seuraavista: 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	Valinnainen	Vaihe, jota mittaus koskee. Yksi seuraavista: L1, L2, L3, N, L1-N, L2-N, L3-N, L1-L2, L2-L3, L3-L1.
location	string	Valinnainen	Mittauskohta. Yksi seuraavista: Cable, EV, Inlet, Outlet, Body.
unit	string	Valinnainen	Mittayksikkö. Yksi seuraavista: Wh, kWh, varh, kvarh, W, kW, VA, kVA, var, kvar, A, V, K, Celcius, Celsius, Fahrenheit, Percent.
transactionId	integer	Valinnainen	Lataustapahtuma, jota nämä mittariarvot koskevat.

Vastaus

Ei kenttiä: vastaus on tyhjä.

Esimerkki

Latausasema lähettää

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

Taustajärjestelmä vastaa

[3, "80a15023", {}]

OCPP 2.0.1 -versiossa: MeterValues

Käynnistää latausistunnon etänä.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
idTag	string	Pakollinen	Tässä latausistunnossa käytettävä tunniste. Enintään 20 merkkiä.
connectorId	integer	Valinnainen	Latauspiste, jossa lataus käynnistetään.
chargingProfile	object	Valinnainen	Tähän latausistuntoon sovellettava latausprofiili.
chargingProfileId	integer	Pakollinen	Tämän latausprofiilin yksilöllinen tunniste.
stackLevel	integer	Pakollinen	Profiilin prioriteettitaso (suurempi = korkeampi prioriteetti).
chargingProfilePurpose	string	Pakollinen	Latausprofiilin käyttötarkoitus. Yksi seuraavista: ChargePointMaxProfile, TxDefaultProfile, TxProfile.
chargingProfileKind	string	Pakollinen	Aikataulun laji. Yksi seuraavista: Absolute, Recurring, Relative.
chargingSchedule	object	Pakollinen	Latausaikataulu.
chargingRateUnit	string	Pakollinen	Lataustehon yksikkö (ampeerit tai watit). Yksi seuraavista: A, W.
chargingSchedulePeriod	array	Pakollinen	Lista aikataulun jaksoista.
startPeriod	integer	Pakollinen	Jakson alku sekunteina aikataulun alusta.
limit	number	Pakollinen	Teho- tai virtaraja tämän jakson aikana. 0,1:n tarkkuudella.
numberPhases	integer	Valinnainen	Lataukseen käytettävien vaiheiden määrä.
duration	integer	Valinnainen	Aikataulun kesto sekunteina.
startSchedule	string	Valinnainen	Aikataulun alkamisajankohta. Päivämäärä ja kellonaika.
minChargingRate	number	Valinnainen	Pienin tuettu latausteho. 0,1:n tarkkuudella.
transactionId	integer	Valinnainen	Lataustapahtuma, jota tämä profiili koskee.
recurrencyKind	string	Valinnainen	Toistuvien profiilien toistuvuus. Yksi seuraavista: Daily, Weekly.
validFrom	string	Valinnainen	Ajankohta, josta alkaen profiili on voimassa. Päivämäärä ja kellonaika.
validTo	string	Valinnainen	Ajankohta, jonka jälkeen profiili ei ole enää voimassa. Päivämäärä ja kellonaika.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Hyväksyikö latausasema pyynnön. Yksi seuraavista: Accepted, Rejected.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: RequestStartTransaction

Pysäyttää latausistunnon etänä.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
transactionId	integer	Pakollinen	Pysäytettävän lataustapahtuman ID.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Hyväksyikö latausasema pyynnön. Yksi seuraavista: Accepted, Rejected.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: RequestStopTransaction

Käynnistää latausaseman uudelleen (Hard tai Soft).

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
type	string	Pakollinen	Suoritettavan uudelleenkäynnistyksen tyyppi. Yksi seuraavista: Hard, Soft.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Hyväksyikö latausasema uudelleenkäynnistyksen. Yksi seuraavista: Accepted, Rejected.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: Reset

Ilmoittaa taustajärjestelmälle, että latausistunto on alkanut.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
connectorId	integer	Pakollinen	Latauspiste, jossa lataustapahtuma alkoi.
idTag	string	Pakollinen	Tunniste, jolla lataustapahtuma aloitettiin. Enintään 20 merkkiä.
meterStart	integer	Pakollinen	Mittarilukema lataustapahtuman alussa (Wh).
timestamp	string	Pakollinen	Lataustapahtuman alkamisen aikaleima. Päivämäärä ja kellonaika.
reservationId	integer	Valinnainen	Käytetyn varauksen ID.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
idTagInfo	object	Pakollinen	idTagin valtuutustiedot.
status	string	Pakollinen	Valtuutuksen tila. Yksi seuraavista: Accepted, Blocked, Expired, Invalid, ConcurrentTx.
expiryDate	string	Valinnainen	Ajankohta, jonka jälkeen idTag katsotaan vanhentuneeksi. Päivämäärä ja kellonaika.
parentIdTag	string	Valinnainen	Ryhmävaltuutuksen ylätason idTag. Enintään 20 merkkiä.
transactionId	integer	Pakollinen	Central Systemin antama lataustapahtuman ID.

Esimerkki

Latausasema lähettää

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

Taustajärjestelmä vastaa

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

OCPP 2.0.1 -versiossa: TransactionEvent

Raportoi latauspisteen nykyisen tilan ja mahdolliset virheet.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
connectorId	integer	Pakollinen	Latauspiste, jonka tila raportoidaan.
errorCode	string	Pakollinen	Virhekoodi (NoError, jos virhettä ei ole). Yksi seuraavista: ConnectorLockFailure, EVCommunicationError, GroundFailure, HighTemperature, InternalError, LocalListConflict, NoError, OtherError, OverCurrentFailure, PowerMeterFailure, PowerSwitchFailure, ReaderFailure, ResetFailure, UnderVoltage, OverVoltage, WeakSignal.
status	string	Pakollinen	Latauspisteen nykyinen tila. Yksi seuraavista: Available, Preparing, Charging, SuspendedEVSE, SuspendedEV, Finishing, Reserved, Unavailable, Faulted.
info	string	Valinnainen	Vapaamuotoinen lisätieto tilasta. Enintään 50 merkkiä.
timestamp	string	Valinnainen	Tilan muutoksen aikaleima. Päivämäärä ja kellonaika.
vendorId	string	Valinnainen	Valmistajakohtainen tunniste. Enintään 255 merkkiä.
vendorErrorCode	string	Valinnainen	Valmistajakohtainen virhekoodi. Enintään 50 merkkiä.

Vastaus

Ei kenttiä: vastaus on tyhjä.

Esimerkki

Latausasema lähettää

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

Taustajärjestelmä vastaa

[3, "d9b0420e", {}]

OCPP 2.0.1 -versiossa: StatusNotification

Ilmoittaa taustajärjestelmälle, että latausistunto on päättynyt.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
transactionId	integer	Pakollinen	Päättyvän lataustapahtuman ID.
timestamp	string	Pakollinen	Lataustapahtuman päättymisen aikaleima. Päivämäärä ja kellonaika.
meterStop	integer	Pakollinen	Mittarilukema lataustapahtuman lopussa (Wh).
idTag	string	Valinnainen	Tunniste, joka pyysi pysäytystä. Enintään 20 merkkiä.
reason	string	Valinnainen	Lataustapahtuman pysäytyksen syy. Yksi seuraavista: EmergencyStop, EVDisconnected, HardReset, Local, Other, PowerLoss, Reboot, Remote, SoftReset, UnlockCommand, DeAuthorized.
transactionData	array	Valinnainen	Taulukko MeterValue-olioita (sama rakenne kuin MeterValues.meterValue).
timestamp	string	Pakollinen	Mittariarvon aikaleima. Päivämäärä ja kellonaika.
sampledValue	array	Pakollinen	Yksi tai useampi mitattu arvo.
value	string	Pakollinen	Mitattu arvo.
context	string	Valinnainen	Lukeman konteksti. Yksi seuraavista: Interruption.Begin, Interruption.End, Sample.Clock, Sample.Periodic, Transaction.Begin, Transaction.End, Trigger, Other.
format	string	Valinnainen	Arvon muoto. Yksi seuraavista: Raw, SignedData.
measurand	string	Valinnainen	Mittauksen tyyppi. Yksi seuraavista: 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	Valinnainen	Vaihe, jota mittaus koskee. Yksi seuraavista: L1, L2, L3, N, L1-N, L2-N, L3-N, L1-L2, L2-L3, L3-L1.
location	string	Valinnainen	Mittauskohta. Yksi seuraavista: Cable, EV, Inlet, Outlet, Body.
unit	string	Valinnainen	Mittayksikkö. Yksi seuraavista: Wh, kWh, varh, kvarh, W, kW, VA, kVA, var, kvar, A, V, K, Celcius, Celsius, Fahrenheit, Percent.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
idTagInfo	object	Valinnainen	idTagin valtuutustiedot.
status	string	Pakollinen	Valtuutuksen tila. Yksi seuraavista: Accepted, Blocked, Expired, Invalid, ConcurrentTx.
expiryDate	string	Valinnainen	Ajankohta, jonka jälkeen idTag katsotaan vanhentuneeksi. Päivämäärä ja kellonaika.
parentIdTag	string	Valinnainen	Ryhmävaltuutuksen ylätason idTag. Enintään 20 merkkiä.

Esimerkki

Latausasema lähettää

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

Taustajärjestelmä vastaa

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

OCPP 2.0.1 -versiossa: TransactionEvent

Vapauttaa latauspisteen lukituksen etänä.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
connectorId	integer	Pakollinen	Latauspiste, jonka lukitus vapautetaan.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Lukituksen vapautuspyynnön tulos. Yksi seuraavista: Unlocked, UnlockFailed, NotSupported.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: UnlockConnector

Laiteohjelmiston hallinta

Laiteohjelmistopäivitykset ja diagnostiikkatietojen lähetys latausasemien etähuoltoa varten.

Pyytää latausasemaa lähettämään diagnostiikkalokit.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
location	string	Pakollinen	URI, johon diagnostiikkatiedot lähetetään. Osoite (URI).
retries	integer	Valinnainen	Lähetyksen uusintayritysten määrä.
retryInterval	integer	Valinnainen	Uusintayritysten väli sekunteina.
startTime	string	Valinnainen	Lokien keruun aikavälin alku. Päivämäärä ja kellonaika.
stopTime	string	Valinnainen	Lokien keruun aikavälin loppu. Päivämäärä ja kellonaika.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
fileName	string	Valinnainen	Diagnostiikkatiedoston nimi. Enintään 255 merkkiä.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

[3, "da7920cd", {}]

OCPP 2.0.1 -versiossa: GetLog

Raportoi diagnostiikkalokien lähetyksen tilan.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Diagnostiikkalähetyksen nykyinen tila. Yksi seuraavista: Idle, Uploaded, UploadFailed, Uploading.

Vastaus

Ei kenttiä: vastaus on tyhjä.

Esimerkki

Latausasema lähettää

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

Taustajärjestelmä vastaa

[3, "d1c853b4", {}]

OCPP 2.0.1 -versiossa: LogStatusNotification

Raportoi laiteohjelmistopäivityksen tilan.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Laiteohjelmistopäivityksen nykyinen tila. Yksi seuraavista: Downloaded, DownloadFailed, Downloading, Idle, InstallationFailed, Installing, Installed.

Vastaus

Ei kenttiä: vastaus on tyhjä.

Esimerkki

Latausasema lähettää

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

Taustajärjestelmä vastaa

[3, "dc9afcb2", {}]

OCPP 2.0.1 -versiossa: FirmwareStatusNotification

Käskee latausasemaa noutamaan ja asentamaan uuden laiteohjelmiston.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
location	string	Pakollinen	URI, josta laiteohjelmiston voi noutaa. Osoite (URI).
retrieveDate	string	Pakollinen	Ajankohta, jonka jälkeen latausaseman tulee noutaa laiteohjelmisto. Päivämäärä ja kellonaika.
retries	integer	Valinnainen	Noudon uusintayritysten määrä.
retryInterval	integer	Valinnainen	Uusintayritysten väli sekunteina.

Vastaus

Ei kenttiä: vastaus on tyhjä.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

[3, "a57cc6a2", {}]

OCPP 2.0.1 -versiossa: UpdateFirmware

Paikallinen valtuutuslista

Hallitse latausaseman paikallista valtuutuslistaa offline-tunnistautumista varten.

Hakee paikallisen valtuutuslistan versionumeron.

Pyyntö

Ei kenttiä: pyyntö on tyhjä.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
listVersion	integer	Pakollinen	Paikallisen valtuutuslistan nykyinen versionumero.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: GetLocalListVersion

Lähettää paikalliseen valtuutuslistaan täyden tai osittaisen päivityksen.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
listVersion	integer	Pakollinen	Tämän listapäivityksen versionumero.
updateType	string	Pakollinen	Onko kyseessä täysi korvaus vai erotuspäivitys. Yksi seuraavista: Differential, Full.
localAuthorizationList	array	Valinnainen	Lista valtuutusmerkinnöistä.
idTag	string	Pakollinen	Valtuutettava tunniste. Enintään 20 merkkiä.
idTagInfo	object	Valinnainen	idTagin valtuutustiedot.
status	string	Pakollinen	Valtuutuksen tila. Yksi seuraavista: Accepted, Blocked, Expired, Invalid, ConcurrentTx.
expiryDate	string	Valinnainen	Ajankohta, jonka jälkeen idTag katsotaan vanhentuneeksi. Päivämäärä ja kellonaika.
parentIdTag	string	Valinnainen	Ryhmävaltuutuksen ylätason idTag. Enintään 20 merkkiä.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Paikallisen listan päivityksen tulos. Yksi seuraavista: Accepted, Failed, NotSupported, VersionMismatch.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: SendLocalList

Varaus

Varaa latauspiste tietylle käyttäjälle etukäteen.

Peruu olemassa olevan varauksen.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
reservationId	integer	Pakollinen	Peruttavan varauksen ID.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Peruttiinko varaus. Yksi seuraavista: Accepted, Rejected.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: CancelReservation

Tekee varauksen tiettyyn latauspisteeseen.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
connectorId	integer	Pakollinen	Varattava latauspiste (0 = ei tiettyä latauspistettä).
expiryDate	string	Pakollinen	Ajankohta, jolloin varaus päättyy. Päivämäärä ja kellonaika.
idTag	string	Pakollinen	Tunniste, jolle varaus tehdään. Enintään 20 merkkiä.
reservationId	integer	Pakollinen	Tämän varauksen yksilöllinen ID.
parentIdTag	string	Valinnainen	Ryhmävarauksen ylätason idTag. Enintään 20 merkkiä.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Varauspyynnön tulos. Yksi seuraavista: Accepted, Faulted, Occupied, Rejected, Unavailable.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: ReserveNow

Älylataus

Aseta ja hallitse latausprofiileja kuormanhallintaa, aurinkosähköä ja ajastettua latausta varten.

Poistaa latausasemalta yhden tai useamman latausprofiilin.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
id	integer	Valinnainen	Poistettavan latausprofiilin ID.
connectorId	integer	Valinnainen	Latauspiste, jonka profiilit poistetaan.
chargingProfilePurpose	string	Valinnainen	Poistettavien profiilien käyttötarkoitus. Yksi seuraavista: ChargePointMaxProfile, TxDefaultProfile, TxProfile.
stackLevel	integer	Valinnainen	Poistettavien profiilien pinotaso.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Poistettiinko profiileja. Yksi seuraavista: Accepted, Unknown.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: ClearChargingProfile

Pyytää latauspisteen yhdistetyn latausaikataulun.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
connectorId	integer	Pakollinen	Latauspiste, jonka aikataulu haetaan.
duration	integer	Pakollinen	Pyydetyn aikataulun kesto sekunteina.
chargingRateUnit	string	Valinnainen	Aikataulun ensisijainen yksikkö. Yksi seuraavista: A, W.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Pystyykö latausasema antamaan aikataulun. Yksi seuraavista: Accepted, Rejected.
connectorId	integer	Valinnainen	Latauspiste, jota aikataulu koskee.
scheduleStart	string	Valinnainen	Yhdistetyn aikataulun alkamisajankohta. Päivämäärä ja kellonaika.
chargingSchedule	object	Valinnainen	Yhdistetty latausaikataulu.
chargingRateUnit	string	Pakollinen	Lataustehon yksikkö (ampeerit tai watit). Yksi seuraavista: A, W.
chargingSchedulePeriod	array	Pakollinen	Lista aikataulun jaksoista.
startPeriod	integer	Pakollinen	Jakson alku sekunteina aikataulun alusta.
limit	number	Pakollinen	Teho- tai virtaraja tämän jakson aikana. 0,1:n tarkkuudella.
numberPhases	integer	Valinnainen	Lataukseen käytettävien vaiheiden määrä.
duration	integer	Valinnainen	Aikataulun kesto sekunteina.
startSchedule	string	Valinnainen	Aikataulun alkamisajankohta. Päivämäärä ja kellonaika.
minChargingRate	number	Valinnainen	Pienin tuettu latausteho. 0,1:n tarkkuudella.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: GetCompositeSchedule

Lähettää latausprofiilin latausasemalle.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
connectorId	integer	Pakollinen	Latauspiste, jota profiili koskee.
csChargingProfiles	object	Pakollinen	Asennettava latausprofiili.
chargingProfileId	integer	Pakollinen	Tämän latausprofiilin yksilöllinen tunniste.
stackLevel	integer	Pakollinen	Profiilin prioriteettitaso (suurempi = korkeampi prioriteetti).
chargingProfilePurpose	string	Pakollinen	Latausprofiilin käyttötarkoitus. Yksi seuraavista: ChargePointMaxProfile, TxDefaultProfile, TxProfile.
chargingProfileKind	string	Pakollinen	Aikataulun laji. Yksi seuraavista: Absolute, Recurring, Relative.
chargingSchedule	object	Pakollinen	Latausaikataulu.
chargingRateUnit	string	Pakollinen	Lataustehon yksikkö (ampeerit tai watit). Yksi seuraavista: A, W.
chargingSchedulePeriod	array	Pakollinen	Lista aikataulun jaksoista.
startPeriod	integer	Pakollinen	Jakson alku sekunteina aikataulun alusta.
limit	number	Pakollinen	Teho- tai virtaraja tämän jakson aikana. 0,1:n tarkkuudella.
numberPhases	integer	Valinnainen	Lataukseen käytettävien vaiheiden määrä.
duration	integer	Valinnainen	Aikataulun kesto sekunteina.
startSchedule	string	Valinnainen	Aikataulun alkamisajankohta. Päivämäärä ja kellonaika.
minChargingRate	number	Valinnainen	Pienin tuettu latausteho. 0,1:n tarkkuudella.
transactionId	integer	Valinnainen	Lataustapahtuma, jota tämä profiili koskee.
recurrencyKind	string	Valinnainen	Toistuvien profiilien toistuvuus. Yksi seuraavista: Daily, Weekly.
validFrom	string	Valinnainen	Ajankohta, josta alkaen profiili on voimassa. Päivämäärä ja kellonaika.
validTo	string	Valinnainen	Ajankohta, jonka jälkeen profiili ei ole enää voimassa. Päivämäärä ja kellonaika.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Hyväksyttiinkö profiili. Yksi seuraavista: Accepted, Rejected, NotSupported.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: SetChargingProfile

Etälaukaisu

Pyydä latausasemaa lähettämään tietty viesti tarvittaessa.

Pyytää latausasemaa lähettämään tietyn viestin heti.

Pyyntö

Kenttä	Tyyppi	Käyttö	Sisältö
requestedMessage	string	Pakollinen	Viesti, joka latausaseman tulee lähettää. Yksi seuraavista: BootNotification, DiagnosticsStatusNotification, FirmwareStatusNotification, Heartbeat, MeterValues, StatusNotification.
connectorId	integer	Valinnainen	Latauspiste, jota viesti koskee.

Vastaus

Kenttä	Tyyppi	Käyttö	Sisältö
status	string	Pakollinen	Lähettääkö latausasema viestin. Yksi seuraavista: Accepted, Rejected, NotImplemented.

Esimerkki

Taustajärjestelmä lähettää

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

Latausasema vastaa

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

OCPP 2.0.1 -versiossa: TriggerMessage

OCPP 1.6:n määritysavaimet

ChangeConfiguration asettaa latausasemaan yhden avaimen kerrallaan, ja GetConfiguration lukee ne takaisin. Näillä avaimilla ratkaistaan suurin osa latausaseman käytännön toiminnasta: kuinka usein mittariarvot saapuvat, mitä niissä on, selviääkö latausistunto verkkokatkosta ja miten kaapeli vapautuu.

Miten kutsu toimii

Jokainen arvo on merkkijonoMyös numerot ja totuusarvot: "60", "true". JSON-numero rikkoo viestin skeeman, ja skeeman tarkistava latausasema vastaa CallError-viestillä.
Kirjoita avainten nimet kuten spesifikaatiossaSpesifikaation mukaan avainten nimissä kirjainkoolla ei ole merkitystä, mutta kaikki latausasemat eivät noudata tätä, joten kirjoita MeterValuesSampledData eikä metervaluessampleddata.
Osa avaimista vaatii uudelleenkäynnistyksenLatausasema vastaa RebootRequired, ja Reset-viestin lähettäminen jää sinulle.
Valmistajat lisäävät omiaanGetConfiguration tyhjällä avainlistalla palauttaa jokaisen avaimen, jota latausasema tukee, myös valmistajan omat. Avaimet, jotka pyydät nimeltä ja joita latausasema ei tunne, palautuvat unknownKey-kentässä.

Neljä vastausta

Accepted: Avain on asetettu ja käytössä nyt.
Rejected: Avain on olemassa, mutta arvo hylättiin: se on sallitun alueen ulkopuolella, väärässä muodossa tai tässä latausasemassa vain luku -tilassa.
RebootRequired: Arvo on tallennettu, mutta se tulee voimaan vasta, kun latausasema käynnistyy uudelleen.
NotSupported: Latausasema ei toteuta tätä avainta lainkaan.

Kaikki 43 avainta ominaisuusprofiileittain

Avain	Tyyppi	Oikeudet	Mitä se tekee
Core34
AllowOfflineTxForUnknownIdValinnainen spesifikaatiossa	boolean	Luku ja kirjoitus	Aloittaako latausasema lataustapahtuman tuntemattomalle idTagille, kun se on offline-tilassa.Arvolla true kohde jatkaa latausta verkkokatkon ajan, mutta osaa latausistunnoista ei ehkä voi laskuttaa keneltäkään.
AuthorizationCacheEnabledValinnainen spesifikaatiossa	boolean	Luku ja kirjoitus	Tallentaako latausasema aiempien Authorize-kutsujen tulokset välimuistiin.Eri asia kuin Local Auth List: välimuisti täyttyy itsestään todellisista valtuutuksista, lista tulee taustajärjestelmästä.
AuthorizeRemoteTxRequests	boolean	Vain luku	Valtuuttaako latausasema RemoteStartTransaction-viestin idTagin ennen aloitusta.Arvolla true myös sovelluksesta tehty etäkäynnistys vaatii Authorize-kierroksen, joten virheellinen idTag kaataa käynnistyksen.
BlinkRepeatValinnainen spesifikaatiossa	integer	Luku ja kirjoitus	Kuinka monta kertaa latausasema vilkuttaa valoa vilkutusjakson aikana.
ClockAlignedDataInterval	integer	Luku ja kirjoitus	Kelloon tahdistettujen mittariarvojen väli keskiyöstä laskien. 0 poistaa ne käytöstä.900 antaa lukeman joka vartti. Tämä avain syöttää MeterValuesAlignedDataa, ja se toimii riippumatta siitä, onko auto kytkettynä.
ConnectionTimeOut	integer	Luku ja kirjoitus	Kuinka kauan latausasema odottaa valtuutuksen jälkeen, että kuljettaja kytkee auton, ennen kuin se vapauttaa latauspisteen.
ConnectorPhaseRotation	CSL	Luku ja kirjoitus	Vaihejärjestys latauspisteittäin merkintätavalla connectorId.RST, esimerkiksi 0.RST, 1.RST, 2.RTS.Virhe tässä tarkoittaa vääriä vaihekohtaisia mittariarvoja ja väärää yksivaiheista kuormanhallintaa. Kannattaa tarkistaa jokaisessa kolmivaiheisessa kohteessa.
ConnectorPhaseRotationMaxLengthValinnainen spesifikaatiossa	integer	Vain luku	ConnectorPhaseRotationin kohtien enimmäismäärä.
GetConfigurationMaxKeys	integer	Vain luku	Avainten enimmäismäärä, jonka yksi GetConfiguration-pyyntö voi pyytää.Jos pyydät enemmän, latausasema voi vastata virheellä. Lähetä GetConfiguration ilman avaimia, niin saat kaikki sen tukemat avaimet.
HeartbeatInterval	integer	Luku ja kirjoitus	Kuinka usein latausasema lähettää Heartbeat-viestin, kun muuta ei tapahdu.BootNotification-vastaus voi ohittaa tämän. Käytön mukaan laskutettavalla SIM-kortilla lyhyt heartbeat-väli on huomaamaton datakulu, joka kertyy.
LightIntensityValinnainen spesifikaatiossa	integer	Luku ja kirjoitus	Latausaseman valaistuksen kirkkaus prosentteina.
LocalAuthorizeOffline	boolean	Luku ja kirjoitus	Valtuuttaako latausasema paikallisesta listastaan tai välimuististaan, kun se on offline-tilassa.
LocalPreAuthorize	boolean	Luku ja kirjoitus	Aloittaako latausasema lataustapahtuman paikallisen listan tai välimuistin perusteella online-tilassa odottamatta taustajärjestelmää.Lyhentää odotusta latausasemalla, mutta taustajärjestelmä ei saa viimeistä sanaa jokaisesta aloituksesta.
MaxEnergyOnInvalidIdValinnainen spesifikaatiossa	integer	Luku ja kirjoitus	Energia, jonka latausasema vielä toimittaa sen jälkeen, kun valtuutus osoittautuu virheelliseksi.
MeterValuesAlignedData	CSL	Luku ja kirjoitus	Mittaussuureet, jotka lähetetään kelloon tahdistetuissa MeterValues-viesteissä ClockAlignedDataInterval-välein.Sama mittaussuureiden sanasto kuin MeterValuesSampledDatassa, mutta laukaisijana on kello eikä latausistunto.
MeterValuesAlignedDataMaxLengthValinnainen spesifikaatiossa	integer	Vain luku	MeterValuesAlignedDatan mittaussuureiden enimmäismäärä.
MeterValuesSampledData	CSL	Luku ja kirjoitus	Mittaussuureet, jotka mitataan lataustapahtuman aikana ja lähetetään MeterValues-viesteissä MeterValueSampleInterval-välein.Tämän sivun hyödyllisin avain. Katso perusteellinen katsaus alempana.
MeterValuesSampledDataMaxLengthValinnainen spesifikaatiossa	integer	Vain luku	MeterValuesSampledDatan mittaussuureiden enimmäismäärä.Lue tämä ennen kuin kokoat pitkän listan: jos ylität sen, latausasema hylkää koko listan.
MeterValueSampleInterval	integer	Luku ja kirjoitus	Kuinka usein latausasema mittaa MeterValuesSampledDatan lataustapahtuman aikana. 0 poistaa mittauksen käytöstä.60 on järkevä oletus. Alle 30 sekunnin välillä ja pitkällä mittaussuurelistalla tuotat paljon liikennettä ja saat hyvin vähän lisätietoa.
MinimumStatusDurationValinnainen spesifikaatiossa	integer	Luku ja kirjoitus	Vähimmäisaika, jonka latausasema pysyy tilassa ennen kuin se raportoi seuraavan.Hyödyllinen tilan edestakaista vaihtelua vastaan latausasemissa, jotka pomppivat tilojen Preparing ja Available välillä.
NumberOfConnectors	integer	Vain luku	Tämän latausaseman fyysisten latauspisteiden määrä.
ResetRetries	integer	Luku ja kirjoitus	Kuinka monta uusintayritystä latausasema tekee, kun uudelleenkäynnistys epäonnistuu.
StopTransactionOnEVSideDisconnect	boolean	Luku ja kirjoitus	Pysäyttääkö kaapelin irrottaminen auton päästä käynnissä olevan lataustapahtuman.Arvolla false latausistunto jää auki kaapelin irrottamisen jälkeen, ja niin syntyy latausistuntoja, jotka eivät koskaan pääty.
StopTransactionOnInvalidId	boolean	Luku ja kirjoitus	Pysäyttääkö latausasema lataustapahtuman, kun taustajärjestelmä hylkää idTagin.
StopTxnAlignedData	CSL	Luku ja kirjoitus	Kelloon tahdistetut mittaussuureet, jotka lisätään StopTransaction-viestin transactionDataan.
StopTxnAlignedDataMaxLengthValinnainen spesifikaatiossa	integer	Vain luku	StopTxnAlignedDatan mittaussuureiden enimmäismäärä.
StopTxnSampledData	CSL	Luku ja kirjoitus	Mitatut mittaussuureet, jotka lisätään StopTransaction-viestin transactionDataan.Pidä tämä lyhyenä. Kaikki siinä oleva toistetaan koko latausistunnon jokaisen mittauksen osalta yhdessä StopTransaction-viestissä, ja niin latausasemat tuottavat megatavun kokoisia lopetusviestejä, jotka taustajärjestelmät hylkäävät.
StopTxnSampledDataMaxLengthValinnainen spesifikaatiossa	integer	Vain luku	StopTxnSampledDatan mittaussuureiden enimmäismäärä.
SupportedFeatureProfiles	CSL	Vain luku	Ominaisuusprofiilit, jotka tämä latausasema toteuttaa, esimerkiksi Core, FirmwareManagement, SmartCharging.Rehellinen vastaus siihen, mitä latausasema osaa. Lue se ennen kuin lupaat asiakkaalle älylatauksen.
SupportedFeatureProfilesMaxLengthValinnainen spesifikaatiossa	integer	Vain luku	SupportedFeatureProfilesin kohtien enimmäismäärä.
TransactionMessageAttempts	integer	Luku ja kirjoitus	Kuinka monta kertaa latausasema yrittää lähettää uudelleen lataustapahtumaviestin, jota taustajärjestelmä ei kuitannut.
TransactionMessageRetryInterval	integer	Luku ja kirjoitus	Perusodotusaika näiden uusintayritysten välillä. Latausasema kertoo sen yrityksen järjestysnumerolla.
UnlockConnectorOnEVSideDisconnect	boolean	Luku ja kirjoitus	Vapautuuko kaapelin lukitus latausasemalla, kun kaapeli irrotetaan autosta.
WebSocketPingIntervalValinnainen spesifikaatiossa	integer	Luku ja kirjoitus	WebSocket-ping-kehysten väli OCPP-J-yhteydellä.Huomaamaton korjaus latausasemille, jotka putoavat jatkuvasti offline-tilaan NATin tai palomuurin takana, joka sulkee käyttämättömät yhteydet.
Paikallinen valtuutuslista3
LocalAuthListEnabled	boolean	Luku ja kirjoitus	Onko paikallinen valtuutuslista käytössä.
LocalAuthListMaxLength	integer	Vain luku	Kuinka monta merkintää paikalliseen valtuutuslistaan mahtuu.
SendLocalListMaxLength	integer	Vain luku	Kuinka monta merkintää mahtuu yhteen SendLocalList-viestiin.Tätä suurempi lista on lähetettävä useana erotuspäivityksenä.
Varaus1
ReserveConnectorZeroSupportedValinnainen spesifikaatiossa	boolean	Vain luku	Hyväksyykö latausasema varauksen latauspisteeseen 0 eli mihin tahansa latauspisteeseen.
Älylataus5
ChargeProfileMaxStackLevel	integer	Vain luku	Korkein pinotaso, jonka latausasema hyväksyy latausprofiilille. Korkeampi taso voittaa.
ChargingScheduleAllowedChargingRateUnit	CSL	Vain luku	Mitkä yksiköt latausasema hyväksyy latausaikataulussa: Current (A), Power (W) vai molemmat.Jos lähetät watteina ilmoitetun profiilin latausasemalle, joka hyväksyy vain ampeerit, se hylätään. Tämä avain kertoo, kumpaa käyttää.
ChargingScheduleMaxPeriods	integer	Vain luku	Yhden latausaikataulun jaksojen enimmäismäärä.
ConnectorSwitch3to1PhaseSupportedValinnainen spesifikaatiossa	boolean	Vain luku	Voiko latausasema vaihtaa kolmivaiheisen ja yksivaiheisen latauksen välillä.Ratkaisee, voitko rajoittaa latausta kolmivaiheisen minimin alle sen sijaan, että lataus keskeytetään kokonaan.
MaxChargingProfilesInstalled	integer	Vain luku	Kuinka monta latausprofiilia voi olla asennettuna samanaikaisesti.

MeterValuesSampledData: mitä latausasema mittaa

Yksi avain, MeterValuesSampledData, ratkaisee, mitä telemetriaa saat latausistunnosta. Se on pilkuilla eroteltu lista mittaussuureita, ja latausasema mittaa jokaisen listan kohdan MeterValueSampleIntervalin määräämin välein ja lähettää ne MeterValues-viestissä. Jos jätät oletusarvon, saat yhden kumulatiivisen energialukeman, joka riittää laskutukseen, etkä mitään muuta: ei tehokäyrää, ei vaihekohtaista virtaa, ei jännitettä eikä tapaa nähdä, toteutuiko älylatauksen raja.

Se ei koskaan toimi yksin. MeterValueSampleInterval määrää, kuinka usein mittaus tehdään, MeterValuesSampledDataMaxLength rajaa, kuinka monta mittaussuuretta saat listata, StopTxnSampledData ratkaisee, mitkä niistä toistetaan StopTransaction-viestissä, ja MeterValuesAlignedData käyttää samaa sanastoa kellon aikataulun mukaan latausistunnon sijaan.

Mittaussuureet

Mikä tahansa näistä voi olla listalla. Se, mitä latausasema tukee, riippuu sen laitteistosta: AC-seinälatausasema ei yleensä raportoi varaustilaa, ja yksinkertaisessa latausasemassa voi olla vain energiarekisteri.

Mittaussuure	Yksikkö	Yleensä saatavilla	Mitä se kertoo
Energy.Active.Import.Register	Wh	AC ja DC	Verkosta otettu kumulatiivinen energia suoraan mittarin rekisteristä luettuna. Oletus, kun MeterValuesSampledData on tyhjä, ja arvo, jonka varaan lähes jokainen laskutuslaskelma rakentuu.
Energy.Active.Export.Register	Wh	V2G-kykyiset	Takaisin syötetty kumulatiivinen energia kaksisuuntaisissa kokoonpanoissa.
Energy.Active.Import.Interval	Wh	AC ja DC	Edellisen mittauksen jälkeen otettu energia juoksevan kokonaismäärän sijaan.
Energy.Reactive.Import.Register	varh	Mittarista riippuen	Otettu kumulatiivinen loisenergia.
Power.Active.Import	W	AC ja DC	Hetkellinen pätöteho. Tästä piirrät latauskäyrän, ja tähän kuormanhallinta reagoi.
Power.Offered	W	AC ja DC	Teho, jota latausasema tarjoaa autolle juuri nyt. Vertaa sitä Power.Active.Importiin, niin näet, onko raja oikeasti käytössä.
Power.Reactive.Import	var	Mittarista riippuen	Hetkellinen loisteho.
Power.Factor	suhdeluku	Mittarista riippuen	Pätötehon ja näennäistehon suhde.
Current.Import	A	AC ja DC	Otettu virta. Raportoidaan yleensä vaiheittain, joten tästä yhdestä mittaussuureesta voi tulla kolme arvoa mittausta kohden.
Current.Offered	A	AC ja DC	Virtaraja, jonka latausasema ilmoittaa autolle. Suora lukema siitä, toteutuiko älylatausprofiilisi.
Current.Export	A	V2G-kykyiset	Takaisin syötetty virta kaksisuuntaisissa kokoonpanoissa.
Voltage	V	AC ja DC	Syöttöjännite, kolmivaiheisissa latausasemissa vaiheittain. Hyödyllinen puuttuvan vaiheen tai heikon liitoksen havaitsemiseen.
Frequency	Hz	Mittarista riippuen	Verkon taajuus. Spesifikaatio ei anna sille yksikkökenttää.
Temperature	Celsius	Latausasemasta riippuen	Lämpötila latausasemassa tai latauspisteessä. Selittää tehon alennuksen kuumana päivänä ennen kuin kukaan ehtii pitää sitä vikana.
SoC	%	DC tai AC ISO 15118:lla	Auton akun varaustila. Mukana vain, kun auto oikeasti raportoi sen, mitä se tavallisessa AC-latauksessa ei yleensä tee.
RPM	rpm	Harvinainen	Tuulettimen nopeus latausasemissa, jotka raportoivat sen.

Toimivat listat

Kopioi jokin näistä ChangeConfiguration-kutsun arvoksi. Aloita suppealla listalla ja lisää mittaussuureita, kun latausasema hyväksyy ne.

Vain laskutus
Vähimmäismäärä, josta syntyy vielä oikea lasku. Oletus useimmissa latausasemissa.
Energy.Active.Import.Register
Perustelemetria
Järkevä oletus hallitulle AC-kohteelle: tehokäyrä sekä vaihekohtainen virta ja jännite vianmääritystä varten.
Energy.Active.Import.Register, Power.Active.Import, Current.Import, Voltage
Älylataus
Lisää tarjotut arvot, joten näet, onko profiili oikeasti käytössä, eikä sitä tarvitse olettaa.
Energy.Active.Import.Register, Power.Active.Import, Power.Offered, Current.Import, Current.Offered, Voltage
DC-pikalataus
Lisää varaustilan ja lämpötilan, jotka DC-latausasemat raportoivat ja jotka selittävät useimmat tehon alennukset.
Energy.Active.Import.Register, Power.Active.Import, Current.Import, Voltage, SoC, Temperature

Mikä menee pieleen

Yksi virheellinen mittaussuure hylkää koko listan
Latausasemat tarkistavat listan kokonaisuutena. Jos yksikin kohta ei ole tuettu, saat koko listasta vastauksen Rejected tai NotSupported, eikä mikään kerro, mikä kohta epäonnistui. Aseta lista yksi mittaussuure kerrallaan löytääksesi syyllisen, tai lue ensin MeterValuesSampledDataMaxLength ja valmistajan dokumentaatio.
Yksi mittaussuure voi olla kolme arvoa
Current.Import ja Voltage raportoidaan vaiheittain, joten kolmivaiheisessa latausasemassa kumpikin saapuu kolmena sampledValue-merkintänä, joiden tunnisteena on L1, L2, L3 tai L1-N ja niin edelleen. Kuuden mittaussuureen lista voi helposti olla tusina arvoa mittausta kohden. Viestin koko kasvaa nopeammin kuin listan pituus antaa ymmärtää.
Wh vai kWh
Energiarekisteri on oletuksena Wh, mutta yksikkökentässä voi lukea kWh, ja osa laiteohjelmistoista tekee niin. Lue yksikkö äläkä oleta sitä, tai lasku menee pieleen tuhatkertaisesti.
Lyhyt väli ei ole ilmainen
MeterValueSampleInterval 10 sekunnissa ja pitkä lista tarkoittavat satoja viestejä latausistuntoa kohden. Käytön mukaan laskutettavalla SIM-kortilla se on oikeaa rahaa, ja suuressa kohteessa se on oikeaa kuormaa taustajärjestelmälle. 60 sekuntia on hyvä oletus, 300 kohteisiin, joissa tarvitset vain käyrän muodon.
StopTxnSampledData on viestikoon ansa
Kaikki siihen listattu toistetaan koko latausistunnon jokaisen mittauksen osalta yhdessä StopTransaction-viestissä. Pitkä lista pitkässä latausistunnossa tuottaa niin suuren viestin, että taustajärjestelmät voivat hylätä tai katkaista sen, eikä lataustapahtuma silloin sulkeudu siististi. Pidä siinä vain energiarekisteri, ellei sinulla ole erityistä syytä.
Ilman energiarekisteriä laskutus hajoaa
Jos Energy.Active.Import.Register ei ole listalla, jaksottaisissa mittariarvoissa ei ole kumulatiivista kokonaismäärää. Useimmat taustajärjestelmät käyttävät silloin lataustapahtuman viestien meterStart- ja meterStop-arvoja, ja jokaisesta latausistunnosta, jonka StopTransaction katoaa, tulee laskuttamaton. Pidä se listalla aina.
SoC ei yleensä ole saatavilla AC-latauksessa
Varaustila tulee autosta ISO 15118:n tai DC-latausprotokollan kautta. Tavallisessa AC-seinälatausasemassa ilman Plug and Chargea auto ei raportoi sitä, joten SoC-pyyntö joko hylätään tai se ei palauta mitään hyödyllistä.
Lue context-kenttä
Jokaisella sampledValue-arvolla on context: Sample.Periodic, Transaction.Begin, Transaction.End, Sample.Clock tai Trigger. Transaction.Begin-arvo on rekisterin alkulukema, ei kulutusta. Kun jokaista mittausta käsitellään jaksottaisena, latausistunnot lasketaan kahteen kertaan.

Kysymyksiä OCPP 1.6J:stä

OCPP 1.6J on Open Charge Point Protocolin versio 1.6 JSON-muodossa. Latausasema avaa WebSocket-yhteyden taustajärjestelmäänsä, ja molemmat osapuolet lähettävät sen kautta JSON-viestejä. Open Charge Alliance julkaisi version 1.6 vuonna 2015, ja useimmat latausasemat tukevat sitä yhä: latausasematietokannassamme 483 niistä 495 latausasemasta, joiden OCPP-versio tunnetaan, tukee versiota 1.6.

Ne välittävät samat viestit eri tavalla. 1.6J lähettää JSONia WebSocket-yhteyden kautta, jota latausasema pitää auki, joten latausasema tarvitsee vain lähtevän yhteyden. 1.6S lähettää SOAPia HTTP:n kautta, ja silloin myös taustajärjestelmän on saatava yhteys latausasemaan.

2.0.1 on uudempi versio, jolla on omat viestinsä. Se kuvaa latausaseman asetukset laitemallissa, määrittelee tietoturvaprofiilit, korvaa StartTransactionin ja StopTransactionin TransactionEventillä ja lisää viestit Plug and Chargea (ISO 15118) varten. Versioita ei voi sekoittaa: latausasema ja sen taustajärjestelmä sopivat yhdestä versiosta, kun yhteys avataan. Latausasematietokannassamme 102 latausaseman tiedoissa mainitaan 2.0.1 joko 1.6:n lisäksi tai sen sijaan. Jokainen 2.0.1:n ja 2.1:n viesti on OCPP 2.0.1:n ja 2.1:n viitteessä.

Open Charge Alliance julkaisee sen maksutta verkkosivuillaan, ja jokaiselle viestille on JSON-skeema. Tämä viite noudattaa tätä spesifikaatiota. Jos ne eroavat, spesifikaatio on oikeassa.

Smart Charging -profiilin kautta. Taustajärjestelmä lähettää SetChargingProfile-viestin, jossa on rajojen aikataulu ampeereina tai watteina. ChargePointMaxProfile rajoittaa koko latausasemaa, TxDefaultProfile koskee jokaista uutta latausistuntoa ja TxProfile yhtä käynnissä olevaa latausistuntoa. Kun kaksi saman käyttötarkoituksen profiilia on päällekkäin, korkeamman stackLevelin profiili voittaa. Miten Plugchoice käyttää tätä, kerrotaan älylataussivulla.

Tarkista se latausasematietokannasta: 775 latausasemaa, niiden tiedossamme olevat OCPP-versiot ja kunkin tiedon lähde. Latausaseman datalehdessä se yleensä myös mainitaan, usein muodossa OCPP 1.6J tai OCPP 1.6 JSON.

Syötä latausaseman asetuksiin, usein asentajasovelluksessa tai latausaseman paikallisella verkkosivulla, taustajärjestelmän WebSocket-URL (se alkaa ws:// tai wss://) ja latausaseman ID eli charge point identity. Latausasema avaa yhteyden ja lähettää BootNotification-viestin. Kun taustajärjestelmä vastaa Accepted, latausasema on online-tilassa ja lähettää StatusNotification-viestin jokaisesta latauspisteestä.

Plugchoice ja OCPP

Ilmainen taustajärjestelmäYhdistä OCPP 1.6J -latausasema ja hallitse sitä verkkoportaalissa.
SovellusOmistajat ja asentajat ohjaavat samaa latausasemaa puhelimellaan.
OCPP-välityspalvelinYksi latausasema usealla taustajärjestelmällä samaan aikaan.
TaustajärjestelmätTaustajärjestelmät, jotka valitset listalta, kun yhdistät latausaseman.

Lisälukemista

16. toukokuuta 2024
Mikä on OCPP?
Blogi | 3 min lukuaika
16. toukokuuta 2024
Mikä on OCPP-taustajärjestelmä?
Blogi | 2 min lukuaika
8. heinäkuuta 2026
Mikä on OCPP-välityspalvelin, ja miksi asentaisit sellaisen latausasemasi ja taustajärjestelmäsi väliin?
Blogi | 5 min lukuaika
12. syyskuuta 2024
Miten OCPP:n älylatausprofiilit toimivat ja miksi Plugchoice käyttää TxProfilea
Blogi | 5 min lukuaika

Tämä sivu tekoälyavustajille

Koko viite, jokainen viesti ja jokainen määritysavain, yhtenä tekstitiedostona, jonka avustaja voi lukea kerralla.

Viite pelkkänä tekstinä

Käytä OCPP-latausasemiasi Plugchoicessa

Yhdistä OCPP 1.6J -latausasemasi Plugchoiceen maksutta ja hallitse niitä verkkoportaalissa, sovelluksessa ja API:n kautta.

Aloita ilmaiseksi Katso OCPP-välityspalvelin

OCPP 1.6J -protokollaviite.

Mikä on OCPP 1.6J?

Kaikki 28 OCPP 1.6 -viestiä

Core

AuthorizePyytää idTagille valtuutuksen ennen kuin lataus sallitaanLatausasemalta taustajärjestelmälle

Pyyntö

Vastaus

Esimerkki

BootNotificationLähetetään käynnistyksen jälkeen, jotta latausasema rekisteröityy taustajärjestelmäänLatausasemalta taustajärjestelmälle

Pyyntö

Vastaus

Esimerkki

ChangeAvailabilityMuuttaa latauspisteen käytettävyyttäTaustajärjestelmältä latausasemalle

Pyyntö

Vastaus

Esimerkki

ChangeConfigurationMuuttaa latausaseman määritysavaintaTaustajärjestelmältä latausasemalle

Pyyntö

Vastaus

Esimerkki

ClearCacheTyhjentää latausaseman valtuutusvälimuistinTaustajärjestelmältä latausasemalle

Pyyntö

Vastaus

Esimerkki

DataTransferValmistajakohtainen tiedonvaihtoMolempiin suuntiin

Pyyntö

Vastaus

Esimerkki

GetConfigurationHakee määritysavaimet latausasemaltaTaustajärjestelmältä latausasemalle

Pyyntö

Vastaus

Esimerkki

HeartbeatSäännöllinen elossaoloviesti, josta taustajärjestelmä tietää latausaseman olevan online-tilassaLatausasemalta taustajärjestelmälle

Pyyntö

Vastaus

Esimerkki

MeterValuesLähettää säännöllisiä tai pyydettyjä mittarilukemiaLatausasemalta taustajärjestelmälle

Pyyntö

Vastaus

Esimerkki

RemoteStartTransactionKäynnistää latausistunnon etänäTaustajärjestelmältä latausasemalle

Pyyntö

Vastaus

Esimerkki

RemoteStopTransactionPysäyttää latausistunnon etänäTaustajärjestelmältä latausasemalle

Pyyntö

Vastaus

Esimerkki

ResetKäynnistää latausaseman uudelleen (Hard tai Soft)Taustajärjestelmältä latausasemalle

Pyyntö

Vastaus

Esimerkki

StartTransactionIlmoittaa taustajärjestelmälle, että latausistunto on alkanutLatausasemalta taustajärjestelmälle

Pyyntö

Vastaus

Esimerkki

StatusNotificationRaportoi latauspisteen nykyisen tilan ja mahdolliset virheetLatausasemalta taustajärjestelmälle

Pyyntö

Vastaus

Esimerkki

StopTransactionIlmoittaa taustajärjestelmälle, että latausistunto on päättynytLatausasemalta taustajärjestelmälle

Pyyntö

Vastaus

Esimerkki

UnlockConnectorVapauttaa latauspisteen lukituksen etänäTaustajärjestelmältä latausasemalle

Pyyntö

Vastaus

Esimerkki

Laiteohjelmiston hallinta

GetDiagnosticsPyytää latausasemaa lähettämään diagnostiikkalokitTaustajärjestelmältä latausasemalle

Pyyntö

Vastaus

Esimerkki

DiagnosticsStatusNotificationRaportoi diagnostiikkalokien lähetyksen tilanLatausasemalta taustajärjestelmälle

Pyyntö

Vastaus

Esimerkki

FirmwareStatusNotificationRaportoi laiteohjelmistopäivityksen tilanLatausasemalta taustajärjestelmälle

Pyyntö

Vastaus