Compliance Levels
Understanding what it means to be "OpenECU Spec-Compatible".
Overview
The OpenECU Spec defines a standard format for describing ECU log file formats. Applications that implement this specification can advertise their compliance level, helping users understand what to expect.
Share adapters across compatible apps
Compliance indicates completeness
Clear standards encourage development
The Three Levels
Level 1: Adapter Reader
BronzeMinimum viable implementation
Use Case: Simple log viewers that use adapters to identify channels.
Requirements:
- Parse adapter files (.adapter.yaml)
- Extract channel mappings using source_names
- Display canonical IDs to users
- Schema validation (recommended)
Level 2: Full Reader
SilverComplete read-side implementation
Use Case: Full-featured log analysis tools.
Requirements:
- All Level 1 requirements
- Apply unit conversions when source_unit differs
- Organize channels by category
- Show adapter name, version, description
- Support multiple adapters
- Auto-detect correct adapter from file format
Level 3: Full Implementation
GoldComplete implementation including write capabilities
Use Case: ECU software, adapter development tools.
Requirements:
- All Level 2 requirements
- UI or API to create new adapters
- Validate adapters against schema before saving
- Export adapters in valid .adapter.yaml format
- Suggest canonical IDs when creating adapters
- Fetch adapters from OpenECU Alliance registry
Compliance Matrix
| Feature | Level 1 | Level 2 | Level 3 |
|---|---|---|---|
| Parse adapter YAML | |||
| Map source_names to channels | |||
| Display canonical IDs | |||
| Schema validation | Rec | ||
| Unit conversion | |||
| Category grouping | |||
| Metadata display | |||
| Multi-adapter support | |||
| Auto-detection | |||
| Adapter creation | |||
| Adapter export | |||
| Registry integration |
Certification Process
Self-Certification (Levels 1-2)
- Implement all requirements for claimed level
- Test against reference adapters
- Document compliance in application materials
- Use appropriate compliance badge
Formal Certification (Level 3)
- Submit application for review
- Demonstrate compliance via test suite
- Receive certification letter
- Be listed on OpenECU Alliance website
FAQ
Can I claim partial compliance?
No. You must meet ALL requirements for a level to claim it.
What if I exceed Level 2 but don't have all Level 3 features?
Claim Level 2. Partial Level 3 is still Level 2.
Is certification required to use "OpenECU Spec Compatible"?
Self-certification is acceptable for Levels 1-2. Level 3 and "Certified" require formal review.