An implementation-independent, versioned JSON/JSONL format for recording OCPP message exchanges — a shared contract between tools that produce OCPP traffic (simulators, proxies, charging stations, CSMS implementations) and tools that consume it (analyzers, debuggers, CI pipelines, reproducible bug reports).
This repository is neutral ground: the format lives here so that no single project's release cadence or roadmap governs it.
| Path | Contents |
|---|---|
schema/ |
The machine-readable record schema (major version 1, currently v1.1). |
fixtures/ |
Reference traces, each with the consumer view a conformant implementation derives from it. |
conformance/ |
What conformance means for producers and consumers, and the corpus self-check. |
npm ci
npm test
The self-check validates every fixture record against the schema, verifies
raw fidelity, and recomputes each fixture's expected consumer view. CI runs
it on every push and pull request.
The format's current definition (v1.1) was designed in
shiv3/ocpp-cp-simulator#188;
its prose specification lives in that repository's docs/trace-format.md
until it migrates here.
- Specification text (this README and the prose in
docs/) is licensed under CC-BY-4.0 (LICENSE-docs). - The schema, fixtures, and conformance tests are licensed under Apache-2.0
(
LICENSE).
Contributions are accepted under the Developer Certificate of Origin; see
CONTRIBUTING.md. The rationale for this split is recorded
in ADR-0001.