Python library for parsing, validating, and verifying OCMF (Open Charge Metering Format) signatures from electric vehicle charging stations.
Note: This is an unofficial library that implements parts of the OCMF specification. It is not affiliated with or endorsed by S.A.F.E. e.V.. For official verification of charging session data, please use the Transparenzsoftware provided by S.A.F.E. e.V. This library may be incomplete or contain discrepancies from the official specification.
Try PyOCMF in your browser - No installation required! Parse and validate OCMF data locally and directly in your web browser using Pyodide.
- Parse OCMF strings into validated Python objects
- Verify cryptographic signatures for data integrity
- Support for ECDSA with multiple curves (secp192r1, secp256r1, secp384r1, secp521r1, brainpool variants)
- Type-safe validation using Pydantic
- Eichrecht compliance validation for German calibration law requirements
pip install pyocmf[all]This installs the complete package with CLI tools and cryptographic signature verification.
Alternative installation options
# Minimal (parsing only, no CLI or crypto)
pip install pyocmf
# With CLI only
pip install pyocmf[cli]
# With crypto only
pip install pyocmf[crypto]from pyocmf import OCMF
# Parse an OCMF string
ocmf_string = 'OCMF|{"FV":"1.0","GI":"KEBA_KCP30",...}|{"SD":"3045..."}'
ocmf = OCMF.from_string(ocmf_string)
# Access payload data
print(ocmf.payload.GI) # Gateway ID: "KEBA_KCP30"
print(ocmf.payload.GS) # Gateway serial number
print(ocmf.payload.RD) # List of meter readings
# Verify signature (requires pyocmf[crypto])
is_valid = ocmf.verify_signature(public_key_hex)# Validate an OCMF string
ocmf 'OCMF|{"FV":"1.0",...}|{"SD":"3045..."}'
# Validate and verify signature
ocmf 'OCMF|{...}|{...}' --public-key 3059301306072A8648CE3D...
# Validate from XML file (extracts public key automatically)
ocmf charging_session.xmlWorking with XML files
OCMF data is often distributed in XML format from CPO backends.
from pyocmf import OcmfContainer
container = OcmfContainer.from_xml("charging_session.xml")
for entry in container:
print(f"Gateway: {entry.ocmf.payload.GI}")
if entry.public_key:
is_valid = entry.verify_signature()
print(f"Signature: {'Valid' if is_valid else 'Invalid'}")Eichrecht compliance checking
Validate German calibration law requirements for charging transactions.
from pyocmf import OCMF, check_eichrecht_transaction
ocmf_begin = OCMF.from_string(begin_string)
ocmf_end = OCMF.from_string(end_string)
issues = check_eichrecht_transaction(ocmf_begin, ocmf_end)
if not issues:
print("Transaction is Eichrecht compliant")Checks include meter status, error flags, time sync, cable loss compensation, transaction consistency, and user identification.
Public key metadata
Extract structured metadata from public keys per OCMF spec Table 23.
from pyocmf import PublicKey
public_key = PublicKey.from_string(public_key_hex)
print(f"Curve: {public_key.curve}")
print(f"Key Size: {public_key.key_size} bits")
# Check if key matches signature algorithm
matches = public_key.matches_signature_algorithm(ocmf.signature.SA)PyOCMF supports all ECDSA signature algorithms defined in the OCMF specification:
- secp192k1, secp256k1 - Koblitz curves
- secp192r1, secp256r1, secp384r1, secp521r1 - NIST curves
- brainpool256r1, brainpoolP256r1, brainpool384r1 - Brainpool curves
- SHA256 and SHA512 hash functions
from pyocmf import OCMF, SignatureVerificationError, OcmfFormatError
try:
ocmf = OCMF.from_string(ocmf_string)
is_valid = ocmf.verify_signature(public_key)
except OcmfFormatError as e:
print(f"Invalid OCMF format: {e}")
except SignatureVerificationError as e:
print(f"Signature verification error: {e}")# Clone the repository
git clone https://github.com/paul-ww/pyocmf.git
cd pyocmf
# Install dependencies with uv
uv sync
# Run tests
uv run pytest
# Run type checking
uv run ty check src test
# Run linting
uv run ruff check .Full documentation including API reference is available at paul-ww.github.io/pyocmf.
See LICENSE file for details.
OCMF (Open Charge Metering Format) is a standardized format for metering data from electric vehicle charging stations. It ensures transparency and tamper-proof documentation of charging sessions, complying with legal requirements such as the EU Measuring Instruments Directive (MID) and German Eichrecht.
For more information about OCMF, visit safe-ev.de.
Vibe-engineered with Claude Code 🤖