NotifyEvent

Monitoring CS->CSMS OCPP 2.0.1

Sent by the Charging Station to report monitoring events triggered by variable monitors previously configured via SetVariableMonitoring.

Quick Reference

Required Fields

generatedAt string (date-time)

Timestamp when the event data was generated

seqNo integer

Sequence number for ordering, starts at 0

eventData array[EventDataType]

List of triggered monitoring events

Optional Fields

tbc boolean

To Be Continued - true if more NotifyEvent messages follow

Example Payload

{
  "generatedAt": "2024-01-15T10:00:00Z",
  "seqNo": 0,
  "tbc": false,
  "eventData": [
    {
      "eventId": 1,
      "timestamp": "2024-01-15T09:59:00Z",
      "trigger": "Delta",
      "actualValue": "42",
      "eventNotificationType": "HardWiredNotification",
      "component": {
        "name": "Connector",
        "evse": {
          "id": 1,
          "connectorId": 1
        }
      },
      "variable": {
        "name": "ConnectorType"
      }
    }
  ]
}

Example Full Frame

[
  2,
  "msg-001",
  "NotifyEvent",
  {
    "generatedAt": "2024-01-15T10:00:00Z",
    "seqNo": 0,
    "tbc": false,
    "eventData": [
      {
        "eventId": 1,
        "timestamp": "2024-01-15T09:59:00Z",
        "trigger": "Delta",
        "actualValue": "42",
        "eventNotificationType": "HardWiredNotification",
        "component": {
          "name": "Connector",
          "evse": {
            "id": 1,
            "connectorId": 1
          }
        },
        "variable": {
          "name": "ConnectorType"
        }
      }
    ]
  }
]

Format: [MessageType, MessageId, Action, Payload]

Open in Builder Go to Validator

Overview

NotifyEvent delivers monitoring events that were triggered by monitors set up via SetVariableMonitoring. This enables threshold-based alerting directly from the Charging Station.

When to Send

When a monitored variable crosses a threshold (UpperThreshold/LowerThreshold)
When a monitored variable changes by a specified delta (Delta trigger)
Periodically for a periodically-monitored variable

Expected Response

Empty response {}.

Usage Notes

Use SetVariableMonitoring to configure which variables to watch and at what thresholds
eventId is unique per event per station
Large event batches use tbc: true for pagination

Testing Tips

Configure a threshold monitor on a variable, trigger a crossing, verify NotifyEvent arrives
Test delta monitoring by changing a variable value

Common Errors

`TypeConstraintViolation`

Cause: trigger uses an unsupported value

Solution: trigger must be one of: Delta, Periodic, UpperThreshold, LowerThreshold