Skip to content

Swiftui App that connects to ELM OBD2 scanners and reads available pids, this is a work is progress as I am learning as I go and will be making changes.

License

Notifications You must be signed in to change notification settings

kkonteh97/SwiftOBD2App

Repository files navigation

OBD2 Swift App

Welcome to the OBD2 Swift App! This app will allow you to read error codes and view Parameter IDs (PIDs) from your vehicle's OBD2 system using Swift and CoreBluetooth.

RPReplay_Final1697402664.mov

Getting Started

  1. Clone this repository to your local machine.
  2. Navigate to project directory on the terminal
cd SwiftOBD2App
  1. Run command xcodegen
xcodegen
  1. Open the Xcode project file (SwiftOBD2App.xcodeproj).
  2. Build and run the app on a compatible iOS device.

MileStones

  • Connect to an OBD2 adapter via Bluetooth Low Energy (BLE) (completed)
  • Retrieve error codes (DTCs) stored in the vehicle's OBD2 system (completed)
  • View various OBD2 Parameter IDs (PIDs) for monitoring vehicle parameters (completed)
  • Clean and intuitive user interface (in progress...)

Current Requirements

  • iOS 16.0+
  • Xcode 15.0+
  • Swift 5.5+

Usage

  1. Launch the app on your iOS device.
  2. Make sure your OBD2 adapter is powered on and discoverable.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

About

Swiftui App that connects to ELM OBD2 scanners and reads available pids, this is a work is progress as I am learning as I go and will be making changes.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages