GetDisplayMessages

DisplayManagement CSMS->CS OCPP 2.0.1

Sent by the CSMS to retrieve all display messages currently stored on the Charging Station.

Quick Reference

Required Fields

requestId integer

Request ID to correlate NotifyDisplayMessages responses

Optional Fields

id array[integer]

Filter by specific message IDs

priority MessagePriorityEnumType

Filter by priority: AlwaysFront, InFront, or NormalCycle

state MessageStateEnumType

Filter by state: Charging, Faulted, Idle, or Unavailable

Example Payload

{
  "requestId": 1
}

Example Full Frame

[
  2,
  "msg-001",
  "GetDisplayMessages",
  {
    "requestId": 1
  }
]

Format: [MessageType, MessageId, Action, Payload]

Open in Builder Go to Validator

Overview

GetDisplayMessages requests the Charging Station to report all currently stored display messages. Results are delivered via NotifyDisplayMessages.

Expected Response

Initial: status: Accepted or Unknown (no messages)

Then, NotifyDisplayMessages messages deliver the actual content.

Testing Tips

Set several messages and verify all appear in the report
Filter by priority and verify only matching messages are returned