UnlockConnector

Releases the cable lock on a connector, for a driver whose cable is stuck.

Version
OCPP 2.0.1
Direction
CSMS → Charge Point
Functional block
Remote Control

UnlockConnector also exists in OCPP 1.6, with a different payload. See the OCPP 1.6 version.

Same support scenario as 1.6, addressed by EVSE and connector. Still explicitly not a way to stop charging.

Request

FieldTypeRequiredDescription
evseIdintegerRequiredThe EVSE.
connectorIdintegerRequiredThe connector within that EVSE.
json
[2, "19223201", "UnlockConnector", {
  "evseId": 1,
  "connectorId": 1
}]

Response

FieldTypeRequiredDescription
statusUnlockStatusEnumTypeRequiredResult of the unlock attempt.
statusInfoStatusInfoTypeOptionalReason code.
json
[3, "19223201", {
  "status": "Unlocked"
}]

Values

UnlockStatusEnumType

ValueMeaning
UnlockedThe connector is unlocked.
UnlockFailedThe attempt failed, usually a mechanical fault.
OngoingAuthorizedTransactionRefused: an authorized transaction is running.
UnknownConnectorNo such connector on this station.

Implementation notes

`NotSupported` is gone; two new statuses replace it. OngoingAuthorizedTransaction is a refusal rather than a failure — stop the transaction first. UnknownConnector means your EVSE/connector addressing is wrong.

Tethered stations have nothing to unlock, and answer UnlockFailed rather than the 1.6 NotSupported.