Author: Ben Congleton <bcx@umich.edu> - http://be-n.com/portfolio - University of Michigan School of Information

SimpleBluetooth Scanner


This is a VERY simple example of basic fast bluetooth scanner
that uses 2 physical bluetooth dongles to detech nearby users at a rapid rate

It is adapted from the bluetooth module in SSAPP (Simple Sensor Architecture for Pervasive Prototyping),
but designed to be even easier to use.  It is designed for use with an Ubuntu computer, and D-link DBT-120 bluetooth dongles, though anything that supports standard RSSI will work.


You will need a few libraries to make this work:

sudo apt-get install bluetooth bluez libbluetooth-dev python-setuptools python-bluez curl

sudo easy_install simplejson 

To use jabber you will need to install twisted

sudo easy_install twisted

To use Nokoscope you will need a copy of the Nokia eb2lib from nokia.


Caveats:
	This scanner assumes that your servers will be up, and not slow.  If they are down, or really slow
	it will still work, but it won't be quite as synchronous.


Quickstart:

1) install above modules:

2) make

3) cd examples/location_server

4) python start_with_fake_data.py

5) python start.py # to run with real data.


Usage:
	python bluetooth_scanner.py --help
	
	# Run with a sample data set:
	python bluetooth_scanner.py -v --input examples/example_files/input.txt --names_file examples/example_files/names.txt 
								
	# post to a URL:
	python bluetooth_scanner.py  --url http://localhost:8000/process.php
	
	# send over jabber (data embedded into presence packets)
	python bluetooth_scanner.py -v --input examples/example_files/input.txt \
								   --names_file examples/example_files/names.txt \
								   --jabber_user=ben@localhost --jabber_password=test 
	
	
	# post to Nokoscope (Alpha Nokia Product)
	python bluetooth_scanner.py -v --input examples/example_files/input.txt \
								   --names_file examples/example_files/names.txt \
								   --nokoscope_user=umich.003 --nokoscope_token=489655ace0c49574025373f59aa8f26b92138cce
	
	# publish over XMPP using pub subscribe
	python bluetooth_scanner.py -v --input examples/example_files/input.txt --names_file examples/example_files/names.txt --jabber_user=test@pubjab.be-n.com --jabber_password=test --jabber_pubsub