OCPP TriggerMessage Command

The OCPP TriggerMessage command enables external systems to actively request specific messages from a charging station. This provides powerful tools for diagnostics, operational oversight, and data analysis.

Key Functionalities

1. Remote Diagnostics

  • Request Specific DataExternal systems can trigger messages such as StatusNotification or MeterValues to retrieve real-time information from the charging station.

  • TroubleshootingFacilitate issue resolution by requesting detailed data about the charger’s status and operations.


2. Operational Control

  • Monitor Charging SessionsActively track ongoing sessions by triggering relevant messages, enabling timely intervention when needed.

  • Configuration VerificationConfirm current settings and operational state by triggering messages that report back charger configurations and statuses.


3. Data Collection and Analysis

  • Enhanced ReportingRetrieve specific data on demand to support detailed reporting and performance analysis.

  • Custom AlertsEnable external systems to trigger alerts based on received messages, allowing proactive responses to certain states or events.


Examples

1. Triggering a StatusNotification

StatusNotification sent by charging station:

{
  "messageTypeId": 3,
  "uniqueId": "12345",
  "action": "StatusNotification",
  "payload": {
    "connectorId": 1,
    "status": "Available",
    "errorCode": "NoError",
    "timestamp": "2023-08-05T12:34:56Z"
  }
}

TriggerMessage sent by central system:

{
  "messageTypeId": 2,
  "uniqueId": "67890",
  "action": "TriggerMessage",
  "payload": {
    "requestedMessage": "StatusNotification",
    "connectorId": 1
  }
}

StatusNotification triggered in response:

{
  "messageTypeId": 3,
  "uniqueId": "67890",
  "action": "StatusNotification",
  "payload": {
    "connectorId": 1,
    "status": "Available",
    "errorCode": "NoError",
    "timestamp": "2023-08-05T12:36:00Z"
  }
}

2. Triggering a MeterValues Message

MeterValues sent by charging station:

{
  "messageTypeId": 3,
  "uniqueId": "22334",
  "action": "MeterValues",
  "payload": {
    "connectorId": 1,
    "meterValue": [
      {
        "timestamp": "2023-08-05T12:34:56Z",
        "sampledValue": [
          {
            "value": "20.5",
            "measurand": "Energy.Active.Import.Register"
          }
        ]
      }
    ]
  }
}

TriggerMessage sent by central system:

{
  "messageTypeId": 2,
  "uniqueId": "98765",
  "action": "TriggerMessage",
  "payload": {
    "requestedMessage": "MeterValues",
    "connectorId": 1
  }
}

MeterValues triggered in response:

{
  "messageTypeId": 3,
  "uniqueId": "98765",
  "action": "MeterValues",
  "payload": {
    "connectorId": 1,
    "meterValue": [
      {
        "timestamp": "2023-08-05T12:36:00Z",
        "sampledValue": [
          {
            "value": "21.0",
            "measurand": "Energy.Active.Import.Register"
          }
        ]
      }
    ]
  }
}