odse 0.1.0

Open Data Schema for Energy - validation and transformation library

ODS-E: Open Data Schema for Energy

ODS-E is an open specification for standardizing energy asset data from IoT devices, enabling interoperability across the renewable energy ecosystem.

Why ODS-E?

• No Vendor Lock-in: Your data works with any ODS-E compatible system
• Faster Integrations: Pre-built transforms for common OEMs (Huawei, Enphase, Solarman)
• Analytics-Ready: Standardized error taxonomy and semantic validation
• Future-Proof: CC-BY-SA licensed specification ensures extensions stay open

Quick Start

pip install odse

from ods_e import validate, transform

# Validate ODS-E data
result = validate("production_data.json")

# Transform from OEM format
ods_data = transform("huawei_export.csv", source="huawei")

Repository Structure

ona-protocol/
├── LICENSE-SPEC.md       # CC-BY-SA 4.0 (specification, schemas, transforms)
├── LICENSE-CODE.md       # Apache 2.0 (reference implementation, tools)
├── spec/                 # Specification documents
├── schemas/              # JSON Schema definitions
├── transforms/           # OEM transform specifications
├── src/                  # Reference implementation
└── tools/                # CLI tools

Core Schema

{
  "timestamp": "2026-02-05T14:00:00Z",
  "kWh": 847.5,
  "error_type": "normal",
  "PF": 0.98
}

Required fields:

• timestamp - ISO 8601 with timezone
• kWh - Active energy (≥ 0)
• error_type - One of: normal, warning, critical, fault, offline, standby, unknown

Supported OEMs

OEM	Format	Status
Huawei FusionSolar	CSV, API	✅ Included
Enphase Envoy	JSON, API	✅ Included
Solarman Logger	CSV	✅ Included
SolarEdge	JSON API	✅ Included
Fronius	JSON API	✅ Included
Switch Energy	CSV	✅ Included

License

• Specification, Schemas, Transforms: CC-BY-SA 4.0
• Reference Implementation, Tools: Apache 2.0

Documentation

• Full Documentation
• Schema Reference
• Transform Guide

Contributing

Contributions are welcome. Schema and transform contributions must be licensed under CC-BY-SA 4.0.

---

Maintained by Asoba Corporation