GetVariables

{
  "getVariableData": [
    {
      "component": {
        "name": "SmartChargingCtrlr"
      },
      "variable": {
        "name": "Enabled"
      }
    },
    {
      "component": {
        "name": "HeartbeatCtrlr"
      },
      "variable": {
        "name": "HeartbeatInterval"
      }
    }
  ]
}

[
  2,
  "msg-001",
  "GetVariables",
  {
    "getVariableData": [
      {
        "component": {
          "name": "SmartChargingCtrlr"
        },
        "variable": {
          "name": "Enabled"
        }
      },
      {
        "component": {
          "name": "HeartbeatCtrlr"
        },
        "variable": {
          "name": "HeartbeatInterval"
        }
      }
    ]
  }
]

Overview

GetVariables retrieves configuration values from the Charging Station using a structured Component/Variable model. It replaces GetConfiguration from OCPP 1.6J.

When to Send

• To read the current heartbeat interval or other configuration values
• To audit Charging Station settings during commissioning
• To verify a variable value after setting it with SetVariables

Expected Response

The Charging Station responds with:

• getVariableResult: Array of results, one per requested variable
  • attributeStatus: Accepted, Rejected, UnknownComponent, UnknownVariable, or NotSupportedAttributeType
  • attributeValue: The current value (if Accepted)

Key Differences from OCPP 1.6J

OCPP 1.6J	OCPP 2.0.1
GetConfiguration	GetVariables
key: ["HeartbeatInterval"]	getVariableData: [{ component: { name: "..." }, variable: { name: "..." } }]
Returns all keys if empty	Must specify each variable explicitly

Usage Notes

• Common component names: HeartbeatCtrlr, SmartChargingCtrlr, AuthCacheCtrlr, OCPPCommCtrlr
• attributeType: "Actual" returns the current operating value (default)
• Use GetBaseReport to discover all available variables on a station

Testing Tips

• Request HeartbeatCtrlr/HeartbeatInterval and verify the returned value matches behavior
• Test with an unknown component name and verify UnknownComponent response
• Test attributeType: "Target" vs "Actual" for variables with pending changes