enviroCar

An Android App for collecting car sensor data for the enviroCar platform.
https://github.com/enviroCar/enviroCar-app

Category: Consumption
Sub Category: Mobility and Transportation

Keywords from Contributors

sensors arctic-sea bjornoya faroe iceland janmayen ogc ogc-services shetland svalbard

Last synced: about 10 hours ago
JSON representation

Repository metadata

enviroCar Android Application

Host: GitHub
URL: https://github.com/enviroCar/enviroCar-app
Owner: enviroCar
License: gpl-3.0
Created: 2013-04-17T14:19:21.000Z (about 12 years ago)
Default Branch: master
Last Pushed: 2025-01-06T12:09:27.000Z (4 months ago)
Last Synced: 2025-04-10T06:41:17.851Z (18 days ago)
Language: Java
Homepage: https://envirocar.org
Size: 177 MB
Stars: 89
Watchers: 13
Forks: 159
Open Issues: 81
Releases: 29
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

enviroCar Android App

This is the app for the enviroCar platform. (www.envirocar.org)

Description

XFCD Mobile Data Collection and Analysis

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

Quick Start

Installation

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.

Development

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.

Setting up the mapbox SDK

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

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:Read scope.
Make sure you copy your token and save it somehwere as you will not be able to see the token again.

Configure your secret token

This is a secret token, and we will use it in gradle.properties file. You should not expose the token in public, that's why add gradle.properties in .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.properties file and add this line MAPBOX_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

License

The enviroCar App is licensed under the GNU General Public License, Version 3.

Recorded Parameters

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	%

Changelog

Check out the Changelog for current changes.

OBD simulator

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.

References

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.

How to Contribute

For contributing to the enviroCar Android App, please, have a look at our Contributor Guidelines.

Contributors

Here is the list of contributors to this project

Owner metadata

Name: enviroCar
Login: enviroCar
Email: [email protected]
Kind: organization
Description:
Website: https://envirocar.org/
Location: Münster
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/4232323?v=4
Repositories: 37
Last ynced at: 2024-04-16T05:52:20.707Z
Profile URL: https://github.com/enviroCar

GitHub Events

Total

Issues event: 6
Watch event: 1
Issue comment event: 9
Push event: 4
Pull request review comment event: 2
Pull request review event: 3
Pull request event: 3
Fork event: 2

Last Year

Issues event: 6
Watch event: 1
Issue comment event: 9
Push event: 4
Pull request review comment event: 2
Pull request review event: 3
Pull request event: 3
Fork event: 2

Committers metadata

Last synced: 8 days ago

Total Commits: 2,139
Total Committers: 23
Avg Commits per committer: 93.0
Development Distribution Score (DDS): 0.747

Commits in past year: 29
Committers in past year: 4
Avg Commits per committer in past year: 7.25
Development Distribution Score (DDS) in past year: 0.379

Name	Email	Commits
Wall, Arne de (52-North)	a**l@5**g	541
matthesrieke	m**e@5**g	540
asaikarthikeya	a**a@g**m	187
ubergesundheit	u**t@g**m	171
ARVIND NEGI	n**3@g**m	163
Jakob Moellers	j**s@g**m	137
Shiva Kanth	s**t@g**m	84
Sebastian Drost	s**t@5**g	80
dewall	a**l@u**e	65
Benjamin Pross	b**s@5**g	38
LAPTOP-TNA5QQH9\FabianWessel	f**l@s**e	33
janschulte	j**e@5**g	28
SaiKrishna	c**5@g**m	25
ChristopherStephan	c**n@w**e	20
martin	m**n@g**m	8
ahitch	a**k@5**g	7
Dhiraj Chauhan	1**9@t**n	6
Akash-Ramjyothi	a**i@g**m	1
Anam Ansari	a**2@g**m	1
Jaypalsinh Barad	9****d	1
Martin Pontius	m**s@5**g	1
Sanjay Sargam	s**r@g**m	1
asaikarthikeya	a**a@g**m	1

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 433
Total pull requests: 519
Average time to close issues: 11 months
Average time to close pull requests: 3 months
Total issue authors: 64
Total pull request authors: 59
Average comments per issue: 2.62
Average comments per pull request: 0.95
Merged pull request: 266
Bot issues: 0
Bot pull requests: 0

Past year issues: 1
Past year pull requests: 13
Past year average time to close issues: N/A
Past year average time to close pull requests: 12 days
Past year issue authors: 1
Past year pull request authors: 2
Past year average comments per issue: 3.0
Past year average comments per pull request: 0.77
Past year merged pull request: 10
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/enviroCar/enviroCar-app

Top Issue Authors

matthesrieke (55)
arvindnegi1 (52)
asaikarthikeya (47)
Akash-Ramjyothi (29)
arne-broering (27)
jakobmoellers (24)
Bhavya-22 (20)
cdhiraj40 (16)
AlbertRemke (12)
neel1998 (12)
SebaDro (10)
ritish099 (9)
bpross-52n (8)
nuest (8)
csk1827 (7)

Top Pull Request Authors

matthesrieke (80)
asaikarthikeya (63)
dewall (57)
Akash-Ramjyothi (55)
arvindnegi1 (47)
cdhiraj40 (26)
FabianWessel (21)
Jdbarad (19)
shivakanthsujit (13)
alexmercerind (12)
csk1827 (12)
Bhavya-22 (11)
bpross-52n (9)
ojasjain24 (8)
devAyushDubey (7)

Top Issue Labels

enhancement (162)
Priority - 3 - Low (88)
bug (86)
3 - Done (65)
Priority - 1 - High (65)
1 - Ready (49)
Priority - 2 - Medium (48)
0 - Backlog (23)
User Story (20)
GSoC (17)
Needs discussion (17)
2 - Working (12)
Device specific (2)
beginner friendly (2)

Top Pull Request Labels

enhancement (27)
GSoC (26)
Needs discussion (6)
Priority - 3 - Low (5)
0 - Backlog (3)
bug (1)
1 - Ready (1)

Dependencies

org.envirocar.app/build.gradle maven

androidx.legacy:legacy-support-v4 1.0.0 implementation
com.andkulikov:transitionseverywhere 2.1.0 implementation
com.github.enviroCar:enviroCar-aidl d67cfa49f3 implementation
de.hdodenhof:circleimageview 3.1.0 implementation
pub.devrel:easypermissions 3.0.0 implementation
junit:junit 4.13.2 testImplementation
org.mockito:mockito-core 3.11.0 testImplementation
org.powermock:powermock-api-mockito 1.7.4 testImplementation
org.powermock:powermock-module-junit4 2.0.9 testImplementation

.github/workflows/android_ci.yml actions

actions/checkout v2 composite
actions/setup-java v2 composite
actions/upload-artifact v1 composite

.github/workflows/build.yml actions

actions/checkout v2 composite
actions/setup-java v2 composite

android-obd-simulator/build.gradle maven

build.gradle maven

org.envirocar.algorithm/build.gradle maven

org.envirocar.core/build.gradle maven

org.envirocar.obd/build.gradle maven

org.envirocar.remote/build.gradle maven

org.envirocar.storage/build.gradle maven

Score: 8.271292652979412

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology