Skip to content
ocpp logo

OCPP — AI Agent Reference

ocpp

OCPP protocol reference for EV charging infrastructure development. Covers OCPP 2.0.1 and OCPP 1.6J. Use when working with OCPP messages, charging station code, CSMS/Central System backends, smart charging, transaction handling, or EV charging protocols. Activates on keywords: OCPP, charging stat...

NeverSight/skills_feed0installs215stars

SKILL.md

Full skill instructions

OCPP — AI Agent Reference

You are assisting a developer working on EV charging infrastructure using OCPP. This skill covers both OCPP 2.0.1 and OCPP 1.6J. Use it to provide accurate schema references, implementation guidance, and to flag areas where the spec is silent.

Version Detection

Detect the OCPP version from the developer's code:

  • 1.6J indicators: StartTransaction, StopTransaction, RemoteStartTransaction, RemoteStopTransaction, Charge Point, Central System, idTag (string), connectorId without evseId, .req / .conf naming
  • 2.0.1 indicators: TransactionEvent, RequestStartTransaction, RequestStopTransaction, Charging Station, CSMS, IdTokenType (object), evseId, Request / Response naming

If unclear, ask the developer which version they're using.

Quick Reference

What is OCPP: Open Charge Point Protocol — communication between EV Charging Stations and a management backend over WebSocket + JSON. The station initiates the connection. Both sides can send messages.

OCPP 2.0.1

  • Roles: Charging Station (CS) ↔ CSMS
  • Device Model: Charging Station → EVSE(s) → Connector(s). evseId and connectorId are 1-indexed. evseId=0 means the whole station.
  • 64 messages, organized by Functional Block

OCPP 1.6J

  • Roles: Charge Point (CP) ↔ Central System (CS)
  • Device Model: Charge Point → Connector(s). connectorId is 1-indexed. connectorId=0 means the whole Charge Point. No EVSE concept.
  • 28 messages, organized by Feature Profile (Core, Smart Charging, Firmware, Local Auth List, Reservation, Remote Trigger)

Message Frame (both versions): JSON-RPC-like. Three types:

  • CALL — [2, messageId, action, payload]
  • CALLRESULT — [3, messageId, payload]
  • CALLERROR — [4, messageId, errorCode, errorDescription, errorDetails]

All 64 OCPP 2.0.1 Messages

Provisioning & Lifecycle

  • BootNotification (CS→CSMS) — Station registers on connect
  • Heartbeat (CS→CSMS) — Keepalive
  • StatusNotification (CS→CSMS) — Connector/​EVSE status changes
  • GetVariables (CSMS→CS) — Read configuration
  • SetVariables (CSMS→CS) — Write configuration
  • GetBaseReport (CSMS→CS) — Request full variable inventory
  • NotifyReport (CS→CSMS) — Variable inventory response (paginated)
  • SetNetworkProfile (CSMS→CS) — Configure network connection profiles
  • Reset (CSMS→CS) — Reboot station

Authorization

  • Authorize (CS→CSMS) — Validate ID token
  • ClearCache (CSMS→CS) — Clear authorization cache
  • SendLocalList (CSMS→CS) — Push local auth list
  • GetLocalListVersion (CSMS→CS) — Query local auth list version

Transactions

  • TransactionEvent (CS→CSMS) — Started/​Updated/​Ended events
  • RequestStartTransaction (CSMS→CS) — Remote start
  • RequestStopTransaction (CSMS→CS) — Remote stop
  • GetTransactionStatus (CSMS→CS) — Query outstanding transaction messages
  • MeterValues (CS→CSMS) — Send meter values outside transaction context

Remote Control

  • TriggerMessage (CSMS→CS) — Request CS to send a specific message
  • UnlockConnector (CSMS→CS) — Physically unlock connector
  • ChangeAvailability (CSMS→CS) — Set EVSE operative/​inoperative

Smart Charging

  • SetChargingProfile (CSMS→CS) — Install charging profile
  • GetChargingProfiles (CSMS→CS) — Query installed profiles
  • ClearChargingProfile (CSMS→CS) — Remove profiles
  • ClearedChargingLimit (CS→CSMS) — External limit cleared
  • NotifyChargingLimit (CS→CSMS) — External limit notification
  • ReportChargingProfiles (CS→CSMS) — Profile query response
  • GetCompositeSchedule (CSMS→CS) — Calculate effective schedule
  • NotifyEVChargingSchedule (CS→CSMS) — EV-proposed schedule (ISO 15118)
  • NotifyEVChargingNeeds (CS→CSMS) — Report EV charging needs (ISO 15118)

Firmware

  • UpdateFirmware (CSMS→CS) — Trigger firmware update
  • FirmwareStatusNotification (CS→CSMS) — Update progress
  • PublishFirmware (CSMS→CS) — Make firmware available to local network
  • PublishFirmwareStatusNotification (CS→CSMS) — Publish progress
  • UnpublishFirmware (CSMS→CS) — Remove published firmware

Security & Certificates

  • Get15118EVCertificate (CS→CSMS) — EV certificate request
  • GetCertificateStatus (CS→CSMS) — OCSP status check
  • SignCertificate (CS→CSMS) — CSR for station certificate
  • CertificateSigned (CSMS→CS) — Signed certificate delivery
  • InstallCertificate (CSMS→CS) — Install CA certificate
  • DeleteCertificate (CSMS→CS) — Remove certificate
  • GetInstalledCertificateIds (CSMS→CS) — List installed certs
  • SecurityEventNotification (CS→CSMS) — Report security-related event

Diagnostics & Monitoring

  • GetLog (CSMS→CS) — Request log upload
  • LogStatusNotification (CS→CSMS) — Log upload progress
  • NotifyEvent (CS→CSMS) — Component/​variable events
  • SetMonitoringBase (CSMS→CS) — Set monitoring baseline
  • SetVariableMonitoring (CSMS→CS) — Configure variable monitors
  • SetMonitoringLevel (CSMS→CS) — Set monitoring severity level
  • GetMonitoringReport (CSMS→CS) — Query active monitors
  • ClearVariableMonitoring (CSMS→CS) — Remove monitors
  • NotifyMonitoringReport (CS→CSMS) — Monitor query response
  • CustomerInformation (CSMS→CS) — Request customer data
  • NotifyCustomerInformation (CS→CSMS) — Customer data response

Display Messages

  • CostUpdated (CSMS→CS) — Update displayed cost
  • SetDisplayMessage (CSMS→CS) — Show message on display
  • GetDisplayMessages (CSMS→CS) — Query displayed messages
  • ClearDisplayMessage (CSMS→CS) — Remove displayed message
  • NotifyDisplayMessages (CS→CSMS) — Display message query response

Reservation

  • ReserveNow (CSMS→CS) — Create reservation
  • CancelReservation (CSMS→CS) — Cancel reservation
  • ReservationStatusUpdate (CS→CSMS) — Reservation expired/​removed

Data Transfer

  • DataTransfer (CS↔CSMS) — Bidirectional vendor extension

All 28 OCPP 1.6J Messages

Core (required profile)

  • Authorize (CP→CS) — Validate idTag
  • BootNotification (CP→CS) — Charge Point registers after (re)boot
  • ChangeAvailability (CS→CP) — Set connector operative/​inoperative
  • ChangeConfiguration (CS→CP) — Set a configuration key
  • ClearCache (CS→CP) — Clear authorization cache
  • DataTransfer (CP↔CS) — Vendor-specific data exchange
  • GetConfiguration (CS→CP) — Read configuration keys
  • Heartbeat (CP→CS) — Keepalive
  • MeterValues (CP→CS) — Periodic meter readings
  • RemoteStartTransaction (CS→CP) — Remote start
  • RemoteStopTransaction (CS→CP) — Remote stop
  • Reset (CS→CP) — Reboot Charge Point
  • StartTransaction (CP→CS) — Transaction started
  • StatusNotification (CP→CS) — Connector status/​error change
  • StopTransaction (CP→CS) — Transaction ended
  • UnlockConnector (CS→CP) — Physically unlock connector

Smart Charging

  • SetChargingProfile (CS→CP) — Install charging profile
  • ClearChargingProfile (CS→CP) — Remove profiles
  • GetCompositeSchedule (CS→CP) — Get effective schedule

Firmware Management

  • GetDiagnostics (CS→CP) — Request diagnostic log upload
  • DiagnosticsStatusNotification (CP→CS) — Upload progress
  • UpdateFirmware (CS→CP) — Trigger firmware update
  • FirmwareStatusNotification (CP→CS) — Update progress

Local Auth List Management

  • SendLocalList (CS→CP) — Push local authorization list
  • GetLocalListVersion (CS→CP) — Query list version

Reservation

  • ReserveNow (CS→CP) — Reserve a connector
  • CancelReservation (CS→CP) — Cancel reservation

Remote Trigger

  • TriggerMessage (CS→CP) — Request CP to send a specific message

Key Data Types (OCPP 2.0.1)

  • IdTokenType — User identification (eMAID, RFID, etc.) with optional groupIdToken
  • ChargingProfileType — Charging limits: id, stackLevel, purpose, kind, chargingSchedule
  • MeterValueType — Timestamped array of SampledValue (energy, power, current, voltage, SoC)
  • EVSEType — EVSE identifier (id + optional connectorId)
  • StatusInfoType — Reason code + additional info for status responses
  • TransactionType — Transaction state: transactionId, chargingState, stoppedReason
  • ChargingScheduleType — Time-based power/​current limits with periods
  • IdTokenInfoType — Authorization result: status, cacheExpiryDateTime, groupIdToken

Escalation Model

When implementing OCPP behavior, you will encounter areas where the specification does not fully define what to do. These are categorized as:

SPEC-SILENT

The OCPP specification does not define behavior for this case. You MUST flag this to the developer. Do NOT silently pick a default.

VENDOR-DEPENDENT

Behavior depends on the Charging Station hardware or firmware. Ask which hardware/​firmware is targeted.

POLICY-DEPENDENT

Behavior depends on business rules, site configuration, or grid operator requirements. Ask about the business/​operational context.

Escalation Strictness

Check the developer's project CLAUDE.md for escalation preferences. They may write something like:

For OCPP: use pragmatic escalation mode.

or:

OCPP escalation: strict — always ask before assuming spec-silent behavior.

Two modes:

  • strict (default): Stop and ask the developer before proceeding. Present specific options. Do not write code for the ambiguous area until answered.
  • pragmatic: Flag the ambiguity but pick a reasonable default. Leave a visible annotation:
    // OCPP SPEC-SILENT: [description of assumption]. Verify this matches your requirements.
    

If no escalation preference is found in CLAUDE.md, default to strict.

Documentation File Map

When you need detailed field-level schemas, sequence diagrams, or worked examples, read the relevant file from the plugin's docs/ directory. Use ${CLAUDE_PLUGIN_ROOT} to resolve the path.

TopicFile to read
All shared data types (enums + composites)${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-DataTypes.md
Authorization schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-Schemas/​OCPP-2.0.1-Schemas-Authorization.md
Availability schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-Schemas/​OCPP-2.0.1-Schemas-Availability.md
Diagnostics schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-Schemas/​OCPP-2.0.1-Schemas-Diagnostics.md
Display schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-Schemas/​OCPP-2.0.1-Schemas-Display.md
Firmware schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-Schemas/​OCPP-2.0.1-Schemas-Firmware.md
Provisioning schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-Schemas/​OCPP-2.0.1-Schemas-Provisioning.md
Reservation schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-Schemas/​OCPP-2.0.1-Schemas-Reservation.md
Security schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-Schemas/​OCPP-2.0.1-Schemas-Security.md
Smart Charging schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-Schemas/​OCPP-2.0.1-Schemas-SmartCharging.md
Transaction schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-Schemas/​OCPP-2.0.1-Schemas-Transactions.md
Boot, auth, transaction sequences${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-Sequences/​OCPP-2.0.1-Sequences.md
Offline, firmware, diagnostics sequences${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-Sequences/​OCPP-2.0.1-Sequences-Operational.md
Smart Charging deep-dive${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-SmartCharging/​OCPP-2.0.1-SmartCharging.md
Smart Charging worked examples${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-SmartCharging/​OCPP-2.0.1-SmartCharging-Examples.md
ISO 15118 + Smart Charging${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1-SmartCharging/​OCPP-2.0.1-SmartCharging-ISO15118.md
OCPP 2.0.1 overview + migration guide${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-2.0.1.md
Documentation methodology + trust model${CLAUDE_PLUGIN_ROOT}/​docs/​METHODOLOGY.md
OCPP 1.6J overview + config keys${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-1.6J.md
1.6J Core schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-1.6J-Schemas/​OCPP-1.6J-Schemas-Core.md
1.6J Smart Charging schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-1.6J-Schemas/​OCPP-1.6J-Schemas-SmartCharging.md
1.6J Firmware schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-1.6J-Schemas/​OCPP-1.6J-Schemas-Firmware.md
1.6J Local Auth List schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-1.6J-Schemas/​OCPP-1.6J-Schemas-LocalAuthList.md
1.6J Reservation schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-1.6J-Schemas/​OCPP-1.6J-Schemas-Reservation.md
1.6J Remote Trigger schemas${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-1.6J-Schemas/​OCPP-1.6J-Schemas-RemoteTrigger.md
1.6J Message sequences${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-1.6J-Sequences/​OCPP-1.6J-Sequences.md
1.6J Smart Charging deep-dive${CLAUDE_PLUGIN_ROOT}/​docs/​OCPP-1.6J-SmartCharging/​OCPP-1.6J-SmartCharging.md

How to use the file map

  1. Identify the topic from the developer's question
  2. Read the relevant file(s) using the Read tool
  3. Cite specific fields, constraints, and enum values from the docs
  4. Flag any ESCALATE markers you encounter in the docs

Topic argument routing

If invoked with /​ocpp <topic>, immediately read the relevant files:

OCPP 1.6J topics:

  • /​ocpp 1.6 or /​ocpp 1.6j → read OCPP-1.6J.md overview
  • /​ocpp 1.6 smart-charging → read 1.6J SmartCharging schemas + deep-dive
  • /​ocpp 1.6 schemas → read all 1.6J Schema files
  • /​ocpp 1.6 sequences → read 1.6J Sequences file
  • /​ocpp 1.6 core → read 1.6J Core schemas
  • /​ocpp 1.6 firmware → read 1.6J Firmware schemas
  • /​ocpp 1.6 auth-list → read 1.6J LocalAuthList schemas
  • /​ocpp 1.6 reservation → read 1.6J Reservation schemas

OCPP 2.0.1 topics (default):

  • /​ocpp smart-charging → read all 3 SmartCharging files
  • /​ocpp authorize or /​ocpp authorization → read Authorization schemas
  • /​ocpp transactions → read Transaction schemas + Sequences
  • /​ocpp provisioning or /​ocpp boot → read Provisioning schemas + Sequences
  • /​ocpp schemas → read all Schema files
  • /​ocpp sequences → read both Sequence files
  • /​ocpp types or /​ocpp data-types → read DataTypes
  • /​ocpp firmware → read Firmware schemas + Operational sequences
  • /​ocpp diagnostics → read Diagnostics schemas + Operational sequences
  • /​ocpp reservation → read Reservation schemas
  • /​ocpp display → read Display schemas
  • /​ocpp security or /​ocpp certificates → read Security schemas
  • /​ocpp availability → read Availability schemas
  • Any other topic → search across all docs using grep

Behavioral Guidelines

  1. Always cite the source. When referencing a field, type, or constraint, mention which doc it comes from. Distinguish schema-derived facts (high confidence) from AI interpretation (lower confidence).

  2. Respect the escalation model. When you encounter an > **ESCALATE:** marker in the docs, follow the escalation strictness rules above.

  3. Detect version from context. Use the version detection rules above. If the code uses StartTransaction/StopTransaction, it's 1.6J — read 1.6J docs. If it uses TransactionEvent, it's 2.0.1. If no version indicators are present, assume 2.0.1 and mention the assumption.

  4. Don't invent protocol behavior. If you're unsure whether something is spec-defined, check the docs first. If the docs don't cover it, say so explicitly rather than guessing.

  5. Use the schemas for validation. When the developer writes OCPP message payloads, validate field names, types, required/​optional status, and constraints against the schema docs.

More skills from NeverSight

devops-deployer logo
NeverSight/skills_feed

devops-deployer

Comprehensive DevOps and deployment workflow that orchestrates infrastructure automation, CI/CD pipelines, container orchestration, and cloud deployment. Handles everything from infrastructure as code and pipeline setup to monitoring, scaling, and disaster recovery.

215 1
View
avnu logo
NeverSight/skills_feed

avnu

Integrate avnu SDK for Starknet DeFi: token swaps with best-price routing, DCA recurring buys, native staking, gasless transactions via paymaster, and market data. Use when building Starknet trading, DEX aggregation, or DeFi automation features.

215 0
View
post-to-x logo
NeverSight/skills_feed

post-to-x

发布内容和文章到 X (Twitter)。支持带图片的普通推文和 X Articles(长文)。使用真实的 Chrome 和 CDP 来绕过自动化检测。

215 0
View
ralph-prompt-builder logo
NeverSight/skills_feed

ralph-prompt-builder

Master orchestrator for generating Ralph Wiggum-compatible prompts. Analyzes task requirements and routes to appropriate generator (single-task, multi-task, project, or research). Use when you need to create any Ralph loop prompt and want automatic selection of the right generator.

215 0
View
branch-comparison logo
NeverSight/skills_feed

branch-comparison

Use when the user asks to compare branches, analyze git diffs, review changes between branches, update specifications based on code changes, or analyze what changed. Triggers on keywords like "compare branches", "git diff", "what changed", "branch comparison", "code changes", "spec update".

215 0
View
fastapi-development logo
NeverSight/skills_feed

fastapi-development

Build high-performance FastAPI applications with async routes, validation, dependency injection, security, and automatic API documentation. Use when developing modern Python APIs with async support, automatic OpenAPI documentation, and high performance requirements.

215 0
View
zendesk-chat logo
NeverSight/skills_feed

zendesk-chat

Enables Claude to manage Zendesk Chat conversations, support tickets, and customer service operations

215 0
View
forge logo
NeverSight/skills_feed

forge

Mine transcripts for knowledge - decisions, learnings, failures, patterns. Triggers: "forge insights", "mine transcripts", "extract knowledge".

215 0
View
mixpanel logo
NeverSight/skills_feed

mixpanel

Track product analytics and user behavior with Mixpanel's event-based platform.

215 0
View
bee-collect logo
NeverSight/skills_feed

bee-collect

Gather scattered ideas into organized GitHub issues. The bee collects pollen from every flower, checks if the hive already has it, and carefully deposits new work in the comb for later. Never edits code—only organizes the work ahead. Use when creating issues from TODOs or planning work.

215 0
View
vercel-react-native-skills logo
NeverSight/skills_feed

vercel-react-native-skills

Comprehensive best practices for React Native and Expo applications. Contains rules across multiple categories covering performance, animations, UI patterns, and platform-specific optimizations.

215 0
View
agent-builder logo
NeverSight/skills_feed

agent-builder

Provides guidance for building and deploying Claude Agent SDK agents and Claude Code Skills. Use when designing agents (dev or non-dev), choosing architectures/tools, or deploying to a VPS.

215 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View