Implement OpenADR 2.0b EiReport telemetry reporting from a VEN to a VTN, including baseline and actual consumption reports

domain: openadr.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. After event registration, the VTN may send an oadrRegisterReport request listing its expected report capabilities (reportSpecifier entries with reportRequestID, reportSpecifierID, specifierPayloads, and granularity); respond with oadrRegisteredReport confirming which reports your VEN can supply.
  2. When the VTN sends oadrCreateReport with a specific reportRequestID and reportSpecifier, parse the requested reportType (e.g., 'READING', 'BASELINE', 'OPERATING_STATE') and the requested granularity (e.g., PT15M for 15-minute intervals).
  3. Collect telemetry at the requested granularity from your meter or DER controller; package it into an oadrUpdateReport request with an eiReport containing reportRequestID, reportSpecifierID, dtstart, and an array of intervals each with UID, dtstart, duration, and eiReportPayload.
  4. Send oadrUpdateReport to the VTN's report endpoint; the VTN responds with oadrUpdatedReport acknowledging receipt — log the response and check for eiResponse responseCode '200' (success) before clearing the local buffer.
  5. Honor the reportBackDuration window: if a requested report interval is missed (e.g., due to meter outage), backfill the interval in the next oadrUpdateReport with the historical data within the allowed lookback period specified by the VTN.
  6. On program end or event cancellation, send oadrCancelReport with the reportRequestID to stop ongoing report submissions; confirm with oadrCanceledReport from the VTN before releasing report state.

Known gotchas

Related routes

register a Virtual End Node (VEN) and subscribe to reports from a Virtual Top Node (VTN) using the OpenADR 3.0/3.1 REST API
openadr.org · 6 steps · unrated
Submit VEN-side telemetry required by an OpenADR 3.x event using the report resource
openadr.org · 5 steps · unrated
Receive demand-response events as an OpenADR 2.0b Virtual End Node (VEN)
openadr.org · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans