The open community for ECU resources: adapters, protocols, and 3D models.
The OpenECU Alliance is a community-driven initiative providing free, open resources for the automotive ECU enthusiast community. We share three types of standardized content:
| Content | Description | Use Case |
|---|---|---|
| Adapters | Log file format definitions | Parse ECU logs in any application |
| Protocols | CAN Bus message definitions | Real-time ECU communication |
| 3D Models | Printable hardware designs | Mounts, enclosures, brackets |
Every ECU manufacturer does things differently:
- Haltech calls it "Engine RPM", Link calls it "Engine Speed", AiM calls it "RPM"
- CAN message structures vary between vendors
- There's no central place to find printable ECU accessories
The OpenECU Alliance solves this with standardized definitions that any application can use.
OECUASpecs/
├── adapters/ # Log file format adapters
│ ├── haltech/
│ ├── link/
│ ├── aim/
│ └── ...
├── protocols/ # CAN Bus protocol definitions
│ ├── haltech/
│ ├── link/
│ └── ...
├── models/ # 3D printable models
│ ├── mounts/
│ ├── enclosures/
│ ├── brackets/
│ └── ...
├── schema/ # JSON Schemas for validation
│ ├── adapter.schema.json
│ ├── protocol.schema.json
│ └── model.schema.json
├── assets/ # Logos and branding
└── scripts/ # Utility scripts
Adapters define how to parse ECU log files and map vendor-specific channel names to standardized identifiers.
| Vendor | Adapter | Format | Channels |
|---|---|---|---|
| Haltech | haltech-nsp | CSV | 62 |
| ECUMaster | ecumaster-emu-csv | CSV | 54 |
| RomRaider | romraider-csv | CSV | 47 |
| Link ECU | link-llg | Binary | 73 |
| AiM | aim-xrk | Binary | 65 |
| Speeduino | speeduino-mlg | Binary | 36 |
| rusEFI | rusefi-mlg | Binary | 58 |
| Emerald | emerald-lg | Binary | 42 |
Protocols define CAN Bus message structures for real-time ECU data streaming. Each protocol can be exported to industry-standard DBC format.
| Vendor | Protocol | Baud Rate | Messages |
|---|---|---|---|
| Haltech | haltech-elite-broadcast | 1 Mbps | 11 |
Coming Soon: Link, ECUMaster, AiM, Speeduino
Protocol definitions can be exported to DBC format for use with CANalyzer, PCAN-View, SavvyCAN, and other CAN analysis tools.
Printable hardware designs for ECU-related accessories with full print settings and assembly instructions.
| Category | Description |
|---|---|
| Mounts | ECU mounting brackets |
| Enclosures | ECU cases and housings |
| Brackets | Sensor and component brackets |
| Adapters | Physical connector adapters |
| Accessories | Misc accessories |
| Model | Category | Material | Print Time |
|---|---|---|---|
| speeduino-v04-mount | Mounts | PETG | 3.5 hrs |
Want to contribute? See CONTRIBUTING.md
Full documentation is available at openecualliance.org/docs
| Topic | Link |
|---|---|
| Getting Started | /docs/getting-started |
| Full Specification | /spec |
| Creating Adapters | /docs/creating-adapters |
| Creating Protocols | /docs/creating-protocols |
| Creating Models | /docs/creating-models |
All content can be validated against JSON schemas:
# Install validator
npm install -g ajv-cli
# Validate adapters
ajv validate -s schema/adapter.schema.json -d "adapters/**/*.adapter.yaml"
# Validate protocols
ajv validate -s schema/protocol.schema.json -d "protocols/**/*.protocol.yaml"
# Validate models
ajv validate -s schema/model.schema.json -d "models/**/*.model.yaml"Applications that support OpenECU Alliance content:
| Application | Adapters | Protocols | Models |
|---|---|---|---|
| UltraLog | Yes | - | - |
Building an app? Visit openecualliance.org/ecosystem
We welcome contributions! See CONTRIBUTING.md for:
- How to create adapters, protocols, and models
- Quality guidelines and checklists
- Submission process
- Schemas: MIT License
- Adapters & Protocols: CC BY 4.0
- 3D Models: As specified in each model (typically CC BY-SA 4.0)
OpenECU Alliance - One community. Shared standards. Free resources.
Website | GitHub | Discussions