A MVP android application which is able to estimate the position of a user within a building using WiFi technology. For better understanding this project, we recommend you to go through the docs folder of this repository.

Setting up

Install Android Studio
Clone or Download project from this url http://github.com/ajnas/wifips
From Android Studio, click on Open project and select the android-client folder inside the downloaded project.

Testing the App

Download Demo App to your android phone or run the imported code from Android Studio to your device.
Turn on WiFi
Go to some building were at least 3 wifi access points are available.

Learn/Calibrate

Choose the 'Learn' option from the first screen.
Enter a name for the new building and press Add
Select wifi access points that are permanent inside the building using the 'Friendly Wifis' button. Do not forget to save changes after adding all such access points.
Now you need to find different distinguishable positions inside the building. For better results, choose different rooms inside the building as different positions.
Name the position and press calibrate button.
The scanning starts after you press start button. Time for scanning is set as 30 seconds.
Once the scanning of one position is complete, go to another position and repeat the procedure
Swipe left/right on a position name to remove a position from the list.
You can re-calibrate a position by clicking on a position again.
Once you have added enough positions inside the building, press the update button to sync this readings to server, so that this data can be used from other devices as well.

Locate

Choose the 'Locate' option from the first screen.
Choose the building where you want to locate your position.
Press start button and complete the scanning process.
Your position obtained from the calculations are displayed in the screen.

Syncing data to server [OPTIONAL]

Create MYSQL database with tables to store readings and list of access points. Please refer this file for necessary schema details
Setup a php server with backend code included in this project and host it on your own server. It uses Slim framework.
Change the BASE_URL in android code to your server url in Config.java file
Run app to your Android device from Android Studio
Use the 'Sync' button in the first screen to load the buildings from the server. The readings taken from other devices are also displayed.

How to Contribute

Fork the repo
Commit changes to a branch in your fork
Pull request with your changes

Developers

Ajnas and Jazeem. Feel free to contact us in case of any issue while setting up/testing.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

ajnas / WiFiPS

Programming Languages

Labels

Projects that are alternatives of or similar to WiFiPS