GSoC enviroCar App project - User Documentation


This page contains instruction on how to test the updated enviroCar app in the 2014 GSoC project, see GSoC2014EnviroCarApp.

Final Demo

enviroCar Installation and Testing Instructions for the final result of the project.

Original app

If you are unfamiliar with the original app, you can download it from Google Play (https://play.google.com/store/apps/details?id=org.envirocar.app). Check the app’s ‘Help’ section for instructions on how to use it. Test this app first. Then you are ready to try out the new version. It is great if you have a chance to test this app first and then compare the new app with it. Once you’ve done this, you are then ready to try out the new version.

The app usually runs by connecting it to a car through an OBD II adapter, but it can also be tested using an OBD simulator app.

New app

A Little Caution

If you are already using the original enviroCar app in your phone, it is advisable to upload all local track data to a server before proceeding with the installation of the new app. If you install the new app over the original enviroCar app, you will lose your track data, if you haven’t uploaded it in advance.

Installation

If you are new to installing apps that are not from Google Play, please follow this concise guide on StackOverFlow, or these more detailed instructions.

The required files can be found on the GSoC demo server: http://gsoc.dev.52north.org/2014.html#2014ecapp.

Then you can plug-in your OBD-II adapter into your car and use the app as usual.

Simulator

The steps for using the app with a simulator are as follows:
  • Please make sure that you have two Android phones running (Android 2.3 or higher).
  • Install the OBD Simulator app in your android device (device 1).
  • Install the enviroCar app in the other android 2.3+ device (device 2).
  • Turn on the bluetooth for device 1, make it discoverable. Open this installed app and press the ‘Enable’ button. It will then act as an OBD-II Adapter.
  • Now to start the enviroCar app (installed on device 2)
  • Click on the car icon at the bottom of the dashboard to select the car.
  • Click on the bluetooth icon at the bottom of the dashboard to select the OBD-II adapter.
  • Press ‘Start’ from the slider menu.
  • Please make sure that your phone (device 2) is connected to the internet while testing the app. If the bluetooth connections turns off on any device or if one phone can’t find the other device, the app will stop working. In such a case, just turn on the bluetooth again, connect the app with the simulator and it will work again.
Detailed info regarding how to use the app is provided in the app’s ‘Help’ section. If you have tried the original enviroCar app before testing this, you shouldn’t face any problem in using this.

Changes In The App

I have worked on the dashboard, localizing the app (option is available to change the app’s language in ‘Settings’ and also various units are available in each language), and the Profile Page, which you can see after you Log-In to the app. But you can give feedback about any feature or screen you like.

Mid-term Demo

This project an extension of the enviroCar app (https://play.google.com/store/apps/details?id=org.envirocar.app) for Android. The app records sensoric data from your car, such as CO2 emission and fuel consumption, via an OBD-II Adapter. More details about the project are available in this blog post: http://blog.52north.org/2014/05/30/envirocar-ux-design/.

Installation and Testing Instructions

Original app

If you are unfamiliar with the original app you can download it from Google Play (https://play.google.com/store/apps/details?id=org.envirocar.app). Check the app’s ‘Help’ section for the instructions on how to use the app. It will be better to test this app first to compare the newly developed app with this one.Once you try this,then you're ready to try out the new version.

In case you are new to installing apps that are not from Google Play, then you can follow this concise guide on StackOverFlow(http://stackoverflow.com/a/9718239/3292108) and these are another detailed instructions regarding the same. (http://www.mytechupdate.com/how-to/how-to-manually-install-applications-on-android-smartphones/) This will help you to install the new app as described below.

A Little Caution

If you were already using the original enviroCar app in your phone to record your car's data, then it is advisable to upload all the local track data to server before proceeding with the installation of the new app. Because your track data will be lost if you install the new app in your phone with the original enviroCar app already present there

New app

The required files can be found on the GSoC demo server: http://gsoc.dev.52north.org/2014.html#2014ecapp.

  1. Install the OBD Simulator app in your android device (device 1).
  2. Install the enviroCar app in another android 2.3+ device (device 2).
  3. Turn on the bluetooth for device 1, make it discoverable. Then open the installed app and press the ‘Enable’ button. It will then act as an OBD-II Adapter
  4. Now to start the enviroCar app ( installed on device 2)
    • Click on the car icon at the bottom of the dashboard to select the car
    • Click on bluetooth icon on same place to select the OBD-II adapter.
    • Press ‘Start’ from the slider menu
Please make sure that your phone( device 2) is connected to internet while testing the app.Detailed info regarding how to use the app is provided in the app’s ‘Help’ section, so please try to go through it once.If you have tried the original enviroCar app before testing this, then you wont face any problem in using thia.

Changes in the app

The following parts of the app have been changed. Please let me know your feedback and comment on my blog post, which includes screenshots of the changes, or email me at rahul.110392@gmail.com

Dashboard

Until now, I have worked on including more parameters on the dashboard fuel consumption, engine load and CO2 emission for Gasoline cars speed, CO2 emission and engine load for diesel cars (fuel consumption for diesel cars is not yet supported) help text for each parameter on the dashboard.

Bottom icons

Navigation through the icons at the bottom of the dashboard and also using the ‘Start’ icon in the slider menu - It's improved in the sense that clicking on them will take the user to the respective pages (means if bluetooth is not turned on, then clicking on its icon will take you to adapter page where you can directly turn on the bluetooth and select adapter without navigating away from the app.) Same is the case with the ‘Start’ button in slider menu. It just improves the workflow and makes it easier for user to select various options before running the app.

Localization

The app has been localized so that it will be available in different languages (urrently I have used English and German). Users will also be given an option to choose the units of measurement among an array of values.

Topic revision: r6 - 27 Jun 2016, UnknownUser
Legal Notice | Privacy Statement


This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Wiki? Send feedback