Repository files navigation

Keywords: indoor GPS, WiFi positioning, indoor mapping, indoor navigation, indoor positioning

The Framework for Internal Navigation and Discovery (FIND) allows you to use your (Android) smartphone or WiFi-enabled computer (laptop or Raspberry Pi or etc.) to determine your position within your home or office. You can easily use this system in place of motion sensors as its resolution will allow your phone to distinguish whether you are in the living room, the kitchen or the bedroom, etc. The position information can then be used in a variety of ways including home automation, way-finding, or tracking!

Simply put, FIND will allow you to replacetons of motion sensors with asingle smartphone!

The system is built on two main components -a server and a fingerprinting device. The fingerprinting device (computer program orandroid app) sends the specified data to the machine learning server which stores the fingerprints and analyzes them. It then returns the result to the device and stores the result on the server for accessing via a web browser or triggering via hooks.

FAQ (abbreviated):

• How does it work? It uses already available WiFi information to classify locations.See here for more detailed information.
• Doesn't this already exist?Yes, kinda.
• What's the point? This short piece of code can dohome automation andreplace motion sensors andmore.
• Can I use an iPhone?Sorry, no.
• Does it work on a Raspberry Pi?Yes.
• Does it work withhome-assistant.io?Yes.
• Can I help?Yes, please.
• How do I try it? It's easy. Justdownload and run.

More questions? See theunabbreviated FAQ.

If you'd like to install things yourself, seethe documentation. You don't need to do this to try it though. Follow the 3 steps below to get started quickly.

Android users:download the current version of the app.Sorry iPhone users butthe Apple store prevents apps that access WiFi information, so I will be unable to release a iPhone version.

OR

Computer users: you candownload the current version of the fingerprinting program, available for Rasbperry Pi, OSX, Linux, and Windows.

First, to get started usingFIND you will need to gather fingerprint data in your locations.

Android users: When you start up the app you will be asked for a username (enter whatever you want) and you'll be assigned a unique group name. Simply click "Learn" and you'll be prompted for a location name. After you enter a location, the app will connect to the server and then submit fingerprints.

Computer users: To start learning locations simply use./fingerprint -e.

Once you've collected data in a few locations, you can track yourself.

Android users: Just press the "Track" button when you're ready to track.

Computer users: Type in./fingerprint to start tracking yourself.

See the documentation athttps://www.internalpositioning.com.

Funding fromDuke University Colab

Thanks totscholl2,sjsafranek, andjschools for their help in guiding the development ofFIND and creating the early versions of FIND with me! Thanks to Rishabh Rajgarhia andCanvasJS for help implementing a nice graph. Thanksarafsheikh for adding interface selection,Pugio andScottSWu for adding OS X/Windows support for the fingerprint program, including a betterWindows scanning utility! ThanksThom-x for the Dockerfile. Thankscertifiedloud for implementing the change toDELETE requests and implementing sockets for unix. Thanksbebus77 for making a awesome generic struct for OS support on the fingerprinting program! Thankschristoph-wagner for help with polling interval on app. Thanks topatorjk andasciiworld for the ASCII art. Thanks toImgur forhosting images.

Like this? Help me keep it aliveby donating $5 topay for server costs.