This is the app for the enviroCar platform. (www.envirocar.org)
Collecting and analyzing vehicle sensor data
enviroCar Mobile is an Android application for smartphones that can be used to collect Extended Floating Car Data (XFCD). The app communicates with an OBD2 Bluetooth adapter while the user drives. This enables read access to data from the vehicle’s engine control. The data is recorded along with the smartphone’s GPS position data.The driver can view statistics about his drives and publish his data as open data. The latter happens by uploading tracks to the enviroCar server, where the data is available under the ODbL license for further analysis and use. The data can also be viewed and analyzed via the enviroCar website. enviroCar Mobile is one of the enviroCar Citizen Science Platform’s components (www.envirocar.org).
Key Technologies
- Android
- Java
Benefits
- Easy collection of Extended Floating Car Data
- Optional automation of data collection and upload
- Estimation of fuel consumption and CO2 emissions
- Publishing anonymized track data as Open Data
- Map based visualization of track data and track statistics
Use the Google Play Store to install the app on your device.
We are planning to include the project into F-Droid in the near future.
This software uses the gradle build system and is optimized to work within Android Studio 1.3+. The setup of the source code should be straightforward. Just follow the Android Studio guidelines for existing projects.
The enviroCar App project uses the Mapbox Maven repository. Mapbox is a mapping and location cloud platform for developers.
To build the project you need the mapbox account, you can create an account for free from here.
Once you have created an account, you will need to configure credentials
- From your account's tokens page, click the Create a token button.
- Give your token a name and do check that you have checked
Downloads:Readscope. - Make sure you copy your token and save it somehwere as you will not be able to see the token again.
- This is a secret token, and we will use it in
gradle.propertiesfile. You should not expose the token in public, that's why addgradle.propertiesin.gitignore. It's also possible to store the sercret token in your local user's gradle.properties file, usually stored at «USER_HOME»/.gradle/gradle.properties. - Now open the
gradle.propertiesfile and add this lineMAPBOX_DOWNLOADS_TOKEN = <your-secret-token>. The secret token has to be pasted without any quote marks.MAPBOX_DOWNLOADS_TOKEN=sk.dutaksgjdvlsayVDSADUTLASDs@!ahsvdaslud*JVAS@%DLUTSVgdJLA&&>Hdval.sujdvadvasuydgalisy(this is just a random string, not a real token) - That't it. You are good to go!
If you are still facing any problem, checkout the Mapbox guide or feel free to create an issue
The enviroCar App is licensed under the GNU General Public License, Version 3.
| Parametername | Unit | |||
|---|---|---|---|---|
| Speed | km/h | |||
| Mass-Air-Flow (MAF) | l/s | |||
| Calculated (MAF) | g/s | |||
| RPM | u/min | |||
| Intake Temperature | c | |||
| Intake Pressure | kPa | |||
| CO2 | kg/h | |||
| CO2 (GPS-based) | kg/h | |||
| Consumption | l/h | |||
| Consumption (GPS-based) | l/h | |||
| Throttle Position | % | |||
| Engine Load | % | |||
| GPS Accuracy | % | |||
| GPS Speed | km/h | |||
| GPS Bearing | deg | |||
| GPS Altitude | m | |||
| GPS PDOP | precision | |||
| GPS HDOP | precision | |||
| GPS VDOP | precision | |||
| Lambda Voltage | V | |||
| Lambda Voltage ER | ratio | |||
| Lambda Current | A | |||
| Lambda Current ER | ratio | |||
| Fuel System Loop | boolean | |||
| Fuel System Status Code | category | |||
| Long Term Trim 1 | % | |||
| Short Term Trim 1 | % |
Check out the Changelog for current changes.
The repository also contains a simple OBD simulator (dumb, nothing fancy) that can be used on another Android device and mock the actual car adapter.
This app is in operational use in the CITRAM - Citizen Science for Traffic Management project. Check out the enviroCar website for more information about the enviroCar project.
For contributing to the enviroCar Android App, please, have a look at our Contributor Guidelines.
Here is the list of contributors to this project