The OBD database is an open source community effort to document the diagnostic parameters and codes (DTCs) that can be used to talk to cars.
Pelican is an official partner of the OBDb and hosts its visual frontend: browse every make and model in the database at https://pelican.clutch.engineering/cars.
Browsing the database doesn't require any kind of account, but if you want to contribute then you'll need a GitHub account (signing up is easy!).
The OBDb is organized around vehicle makes and models. If there isn't yet a repository for your vehicle's make and model, please request it.
Each vehicle repo's directory is organized as follows:
signalsets/
└── v3/
├── default.json # Default configuration
└── 2012-2020.json # Example override configuration for specific years
-
default.json: Acts as the primary configuration file. This file is the default fallback for any years not specified by an override file.
-
2012-2020.json: A specific configuration override for model years 2012-2020, differentiating these years from the baseline configuration in
default.json.
If a new generation is introduced in the future, a new JSON file (e.g., 2021-2027.json) can be created to lock in the second-generation configuration, allowing default.json to reflect the latest specifications.
The text of the OBDb is copyrighted (automatically, under the Berne Convention) by OBDb editors and contributors and is formally licensed to the public under one or several liberal licenses. Most of OBDb's text is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License (CC BY-SA).
If your app, site or tool uses OBDb data, CC BY-SA 4.0 asks you to credit the OBDb wherever you credit other open source work, such as an About or Open Source Licenses screen. The credit names the OBDb and its contributors, links to the database, and names and links the license.
Copy this text:
Vehicle signal definitions from the OBDb (https://github.com/OBDb),
by OBDb contributors, licensed under CC BY-SA 4.0
(https://creativecommons.org/licenses/by-sa/4.0/).
Or this HTML:
Vehicle signal definitions from the <a href="https://github.com/OBDb">OBDb</a>,
by OBDb contributors, licensed under
<a href="https://creativecommons.org/licenses/by-sa/4.0/">CC BY-SA 4.0</a>.If you changed the signal definitions, say so, for example "Vehicle signal definitions adapted from the OBDb…". Signal definitions you change and share must also be shared under CC BY-SA 4.0. The rest of your app's code is not affected.