TriggerMessage

Asks the station to send a specific message now rather than on its own schedule.

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

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

Same idea as 1.6, with a longer list of triggerable messages reflecting 2.0.1's larger message set.

Request

FieldTypeRequiredDescription
requestedMessageMessageTriggerEnumTypeRequiredWhich message to request.
evseEVSETypeOptionalWhich EVSE and connector, for per-EVSE messages.
json
[2, "19223201", "TriggerMessage", {
  "requestedMessage": "StatusNotification",
  "evse": { "id": 1, "connectorId": 1 }
}]

Response

FieldTypeRequiredDescription
statusTriggerMessageStatusEnumTypeRequiredWhether the station will send it.
statusInfoStatusInfoTypeOptionalReason code.
json
[3, "19223201", {
  "status": "Accepted"
}]

Values

MessageTriggerEnumType

ValueMeaning
BootNotificationSent with reason: "Triggered".
HeartbeatA heartbeat.
StatusNotificationConnector status.
MeterValuesA meter sample.
TransactionEventA transaction event.
LogStatusNotificationLog upload status.
FirmwareStatusNotificationFirmware update status.
SignChargingStationCertificateTrigger a SignCertificate for the station certificate.
SignV2GCertificateTrigger a SignCertificate for the V2G certificate.
PublishFirmwareStatusNotificationLocal firmware publishing status.

TriggerMessageStatusEnumType

ValueMeaning
AcceptedThe station will send it.
RejectedIt will not.
NotImplementedThis particular message cannot be triggered on this station.

Implementation notes

The triggered message arrives as a separate request. Accepted only means it is coming.

Triggering StatusNotification on every connector is the standard way to resynchronise after a CSMS restart.