1.StartTransaction開始交易
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "urn:OCPP:1.6:2019:12:StartTransactionRequest",
"title": "StartTransactionRequest",
"type": "object",
"properties": {
"connectorId": {
"type": "integer"
},
"idTag": { //充電樁必須用于啟動充電事務(wù)的標(biāo)識符idtag。
"type": "string",
"maxLength": 20
},
"meterStart": { //這包含充電事務(wù)開始時槍口的計量值(以Wh 為單位)。
"type": "integer"
},
"reservationId": { //此預(yù)約的唯一ID。
"type": "integer"
},
"timestamp": { //時間戳
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false,
"required": [
"connectorId",
"idTag",
"meterStart",
"timestamp"
]
}
2.StartTransactionResponse
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "urn:OCPP:1.6:2019:12:StartTransactionResponse",
"title": "StartTransactionResponse",
"type": "object",
"properties": {
"idTagInfo": {
"type": "object",
"properties": {
"expiryDate": {
"type": "string",
"format": "date-time"
},
"parentIdTag": {
"type": "string",
"maxLength": 20
},
"status": {
"type": "string",
"additionalProperties": false,
"enum": [
"Accepted",
"Blocked", //以阻止
"Expired", //已過期。不允許充電
"Invalid",
"ConcurrentTx"
]
}
},
"additionalProperties": false,
"required": [
"status"
]
},
"transactionId": { //請求停止充電樁事務(wù)的標(biāo)識符。
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"idTagInfo",
"transactionId"
]
3.StatusNotification狀態(tài)通知
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "urn:OCPP:1.6:2019:12:StatusNotificationRequest",
"title": "StatusNotificationRequest",
"type": "object",
"properties": {
"connectorId": {
"type": "integer"
},
"errorCode": { //這包含充電樁報告的錯誤代碼。
"type": "string",
"additionalProperties": false,
"enum": [
"ConnectorLockFailure",
"EVCommunicationError",
"GroundFailure",
"HighTemperature",
"InternalError",
"LocalListConflict",
"NoError",
"OtherError",
"OverCurrentFailure",
"PowerMeterFailure",
"PowerSwitchFailure",
"ReaderFailure",
"ResetFailure",
"UnderVoltage",
"OverVoltage",
"WeakSignal"
]
},
"info": { //與錯誤相關(guān)的其他自由格式的信息
"type": "string",
"maxLength": 50
},
"status": { //這包含充電樁的當(dāng)前狀態(tài)
"type": "string",
"additionalProperties": false,
"enum": [
"Available",
"Preparing",
"Charging",
"SuspendedEVSE",
"SuspendedEV",
"Finishing",
"Reserved",
"Unavailable",
"Faulted"
]
},
"timestamp": { //報告狀態(tài)的時間。
"type": "string",
"format": "date-time"
},
"vendorId": { //這標(biāo)識了特定供應(yīng)商的ID
"type": "string",
"maxLength": 255
},
"vendorErrorCode": { //這包含特定供應(yīng)商的錯誤代碼。
"type": "string",
"maxLength": 50
}
},
"additionalProperties": false,
"required": [
"connectorId",
"errorCode",
"status"
]
}
4.StatusNotificationResponse
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "urn:OCPP:1.6:2019:12:StatusNotificationResponse",
"title": "StatusNotificationResponse",
"type": "object",
"properties": {},
"additionalProperties": false
}
5.StopTransaction停止交易
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "urn:OCPP:1.6:2019:12:StopTransactionRequest",
"title": "StopTransactionRequest",
"type": "object",
"properties": {
"idTag": {
"type": "string",
"maxLength": 20
},
"meterStop": { //這包含充電事務(wù)結(jié)束時槍口的電表計量值(以 Wh 為單位)。
"type": "integer"
},
"timestamp": { //這包含停止充電事務(wù)的日期和時間。
"type": "string",
"format": "date-time"
},
"transactionId": { //這包含StartTransaction.conf 收到的transaction ID。
"type": "integer"
},
"reason": { //這包含充電事務(wù)停止的原因。僅當(dāng)Reason為“local”時,才可以省略
"type": "string",
"additionalProperties": false,
"enum": [
"EmergencyStop",
"EVDisconnected",
"HardReset",
"Local",
"Other",
"PowerLoss",
"Reboot",
"Remote",
"SoftReset",
"UnlockCommand",
"DeAuthorized" //充電事物停止
]
},
"transactionData": { //這包含與計費目的相關(guān)的充電事務(wù)使用情況詳細(xì)信息。
"type": "array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"type": "string",
"format": "date-time"
},
"sampledValue": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"context": {
"type": "string",
"additionalProperties": false,
"enum": [
"Interruption.Begin",
"Interruption.End",
"Sample.Clock",
"Sample.Periodic",
"Transaction.Begin",
"Transaction.End",
"Trigger",
"Other"
]
},
"format": {
"type": "string",
"additionalProperties": false,
"enum": [
"Raw",
"SignedData"
]
},
"measurand": {
"type": "string",
"additionalProperties": false,
"enum": [
"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": {
"type": "string",
"additionalProperties": false,
"enum": [
"L1",
"L2",
"L3",
"N",
"L1-N",
"L2-N",
"L3-N",
"L1-L2",
"L2-L3",
"L3-L1"
]
},
"location": {
"type": "string",
"additionalProperties": false,
"enum": [
"Cable",
"EV",
"Inlet",
"Outlet",
"Body"
]
},
"unit": {
"type": "string",
"additionalProperties": false,
"enum": [
"Wh",
"kWh",
"varh",
"kvarh",
"W",
"kW",
"VA",
"kVA",
"var",
"kvar",
"A",
"V",
"K",
"Celcius",
"Fahrenheit",
"Percent"
]
}
},
"additionalProperties": false,
"required": [
"value"
]
}
}
},
"additionalProperties": false,
"required": [
"timestamp",
"sampledValue"
]
}
}
},
"additionalProperties": false,
"required": [
"transactionId",
"timestamp",
"meterStop"
]
}
6.StopTransactionResponse
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "urn:OCPP:1.6:2019:12:StopTransactionResponse",
"title": "StopTransactionResponse",
"type": "object",
"properties": {
"idTagInfo": {
"type": "object",
"properties": {
"expiryDate": { //充電預(yù)約結(jié)束時間
"type": "string",
"format": "date-time"
},
"parentIdTag": {
"type": "string",
"maxLength": 20
},
"status": {
"type": "string",
"additionalProperties": false,
"enum": [
"Accepted",
"Blocked",
"Expired",
"Invalid",
"ConcurrentTx"
]
}
},
"additionalProperties": false,
"required": [
"status"
]
}
},
"additionalProperties": false
}
7.TriggerMessage觸發(fā)器消息
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "urn:OCPP:1.6:2019:12:TriggerMessageRequest",
"title": "TriggerMessageRequest",
"type": "object",
"properties": {
"requestedMessage": {
"type": "string",
"additionalProperties": false,
"enum": [
"BootNotification", //啟動通知
"DiagnosticsStatusNotification", //診斷狀態(tài)通知
"FirmwareStatusNotification", //固件狀態(tài)通知
"Heartbeat", //心跳
"MeterValues", //電表值
"StatusNotification" //狀態(tài)通知
]
},
"connectorId": { //僅當(dāng)請求應(yīng)用于特定槍口時才填寫。
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"requestedMessage"
]
}
8.TriggerMessageResponse
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "urn:OCPP:1.6:2019:12:TriggerMessageResponse",
"title": "TriggerMessageResponse",
"type": "object",
"properties": {
"status": {
"type": "string",
"additionalProperties": false,
"enum": [
"Accepted",
"Rejected",
"NotImplemented" //無法發(fā)送的請求通知
]
}
},
"additionalProperties": false,
"required": [
"status"
]
}
9.UnlockConnector解鎖槍口
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "urn:OCPP:1.6:2019:12:UnlockConnectorRequest",
"title": "UnlockConnectorRequest",
"type": "object",
"properties": {
"connectorId": { //槍口ID
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"connectorId"
]
}
10.UnlockConnectorResponse
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "urn:OCPP:1.6:2019:12:UnlockConnectorResponse",
"title": "UnlockConnectorResponse",
"type": "object",
"properties": {
"status": {
"type": "string",
"additionalProperties": false,
"enum": [
"Unlocked", //槍口以成功解鎖
"UnlockFailed", //無法解鎖槍口
"NotSupported" //充電點指示請求不受支持。
]
}
},
"additionalProperties": false,
"required": [
"status"
]
}
11.UpdateFirmware升級固件
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "urn:OCPP:1.6:2019:12:UpdateFirmwareRequest",
"title": "UpdateFirmwareRequest",
"type": "object",
"properties": {
"location": { //它包含一個字符串,其中包含指向從中檢索軟件位置的URI
"type": "string",
"format": "uri"
},
"retries": { //指定了充電樁在放棄之前必須嘗試下載固件的次數(shù)。如果此字段不存 在,則由充電樁決定要重試多少次。
"type": "integer"
},
"retrieveDate": { //這包含充電樁必須檢索(新)軟件的日期和時間。
"type": "string",
"format": "date-time"
},
"retryInterval": { //可以嘗試重試的時間間隔(以秒為單位)。如果此字段不存在,則由充電樁決定在兩次嘗試之間等待多長時間。
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"location",
"retrieveDate"
]
}
12.UpdateFirmwareResponse
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "urn:OCPP:1.6:2019:12:UpdateFirmwareResponse",
"title": "UpdateFirmwareResponse",
"type": "object",
"properties": {},
"additionalProperties": false
}