On-board diagnostics swift library.
OBD or On-board diagnostics is a vehicle's self-diagnostic and reporting capability. OBD systems give access to the status of the various vehicle subsystems. Simply saying, OBD-II is a sort of computer which monitors emissions, mileage, speed, and other useful data.
More details you can get here.
This is a library which can communicate with vehicles using OBD-II adapters. It is providing you with an opportunity for real-time vehicles diagnostics with several lines of code and without being nervous. The library will help you to connect with adapter and handle it's behaviour, like reconnect when something went wrong. And! You don't need to parse bytes response returned from adapter by yourself because OBD2 Swift will do it for your project.
- iOS 9.0+
- Swift 3.0+
- Xcode 8.0+
- Mac OS X 10.0+
- Supporting next Modes with almost all their PIDs:
| Mode | Description |
|---|---|
| Mode 01(02) | Sensors / Freeze Frame |
| Mode 03 | Trouble Codes (DTC) |
| Mode 04 | Reset Trouble Codes |
| Mode 09 | Information |
- Real-time connection with OBD-II
- OBD-II full described diagnostic sensors list
- Observer of connection and other metrics
- Several types of returning & requesting diagnostic response
- Logger, which can save your logs into a file and share it
First of all, create an OBD2 object for requesting vehicles metrics.
let obd = OBD2()Create a connection between your application and adapter.
❗ Remember that all callbacks return not in the main thread.
obd.connect { [weak self] (success, error) in
if let error = error {
print("OBD connection failed with \(error)")
} else {
//perform something
}
}Method connect would return you a response with an error if something went wrong and you can simply handle it, for example, show a message with reconnecting opportunity.
If all goes okay, you have a connection! 😎
Class
OBD2contain another methods for work with connection likepauseScan(),resumeScan()andstopScan()as well.
There is a simple way to get data from vehicle subsystems - to use requests. You can send it using request(_:) method of OBD2 object. Use struct Command for choosing what you want to request.
obd.request(command: Command.Mode09.vin) { (descriptor) in
let respStr = descriptor?.VIN()
print(respStr ?? "No value")
}You can use request(_:) method with emun Custom: CommandType. It helps you to send and get data in digit and string format.
obd.request(command: Command.Custom.digit(mode: 09, pid: 02)) { (descr) in
if let response = descr?.response {
print(response)
}
}You can still use requests for doing this. There is a method request(repeat:) wich will send a request to OBD repeatedly.
obd.request(repeat: Command.Mode01.pid(number: 12))Response from this method will be returned to Observer. Choose Mode type and create an Observer object.
let observer = Observer<Command.Mode01>()Tell him to observe with specific PID number and enjoy responses. :]
observer.observe(command: .pid(number: 12)) { (descriptor) in
let respStr = descriptor?.shortDescription
print("Observer : \(respStr)")
}❗ To bring
Observeralive you must register it inObserverQueue. It is needed for returning diagnostics responses.ObserverQueue.shared.register(observer: observer)Don't forget to do
unregister(_:)when you don't needObserveranymore.
OBD2 object has method isRepeating(repeat:) wich takes Command as a parameter. Using it you can check if the specific command is repeating now and stop it.
if obd.isRepeating(repeat: Command.Mode01.pid(number: 12)) {
obd.stop(repeat: command)
} Yep! Single request method can take Bool parameter notifyObservers wich is true by default. Using it you can manage which requests will return response not only in completion block but in observer block too.
- Go to your project root git folder and clone OBD2 Swift as a git submodule by running the following command from the terminal.
$ git submodule add https://github.com/lemberg/obd2-swift-lib.git-
Open obd2-swift-lib folder which was created. In the OBD2-Swift folder, you will found OBD2Swift.xcodeproj. Drag it into the Project Navigator of your project.
-
Select your project in the Xcode Navigation and then select your application target from the sidebar. After this, select the "General" tab and click on the + button under the "Embedded Binaries" section.
-
Select OBD2 Swift.framework from dialogue and that's all! 🎉
Don't forget to do
import OBD2Swiftin classes where you want to use this framework
To install it, simply add this line to your Podfile:
pod "OBD2-Swift"If you'll need, there is still a version written on Swift 3 named
swift3.
Now you need to run pod update command from you project folder and that's it!
OBD2 Swift is available under the MTI license. See the LICENSE file for more info.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent