****************************************************************************
 * Port of OpenIntents simulator to Android 2.1, extension to multi *
 * emulator support, and GPS and battery simulation is developed as a *
 * diploma thesis of Josip Balic at the University of Zagreb, Faculty of *
 * Electrical Engineering and Computing. *
 * *
 * Copyright (C) 2008-2011 OpenIntents.org *
 * *
 * Licensed under the Apache License, Version 2.0 (the "License"); *
 * you may not use this file except in compliance with the License. *
 * You may obtain a copy of the License at *
 * *
 * http://www.apache.org/licenses/LICENSE-2.0 *
 * *
 * Unless required by applicable law or agreed to in writing, software *
 * distributed under the License is distributed on an "AS IS" BASIS, *
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. *
 * See the License for the specific language governing permissions and *
 * limitations under the License. *
 ****************************************************************************
SensorSimulator lets you simulate sensor events from 
accelerometer, compass, orientation, temperature, light, proximity,
pressure, linear acceleration, gravity, gyroscope and rotation vector
sensors.
It transmits the simulated sensor data to an Android emulator.
Also, it can record sensor data from an real Android device.
-------------------------------------------------------------
INSTRUCTIONS:
1) Launch bin/sensorsimulator.jar
2) Install bin/SensorSimulatorSettings.apk on your Android
 emulator
3) Connect from your Android emulator to the SensorSimulator
 by entering the IP address that is shown in the
 SensorSimulator (if there are several possibilities,
 try which works)
4) These IP settings are stored on your device.
5) Build one of the sample applications, for example
 samples/SensorDemo in Eclipse. Further instructions can be
 found in the source code.
6) To include the sensor simulator in your existing application
 include the lib/sensorsimulator-lib.jar and follow the
 instructions that can be found in the samples source codes.
7) To record from the real device you need internet connection on the
 Android device and on the pc/laptop on which the simulator is
 running. The ip address of the simulator must be reachable from
 your Android device (a local wireless network will do the trick).
-------------------------------------------------------------
Directory structure:
- bin (*): contains the executables SensorSimulator.jar,
 SensorSimulatorSettings.apk and SensorRecordFromDevice.apk
- lib (*): contains the library sensorsimulator-lib.jar
- release: contains the build script to assemble the release
- samples: contains examples how to include the sensor simulator
 in your Android applications.
- SensorSimulator: contains the source code for the
 sensor simulator.
- SensorSimulatorSettings: contains the source code for
 sensor simulator settings.
- SensorRecordFromDevice: contains the source code for
 recording sensors from device.
(*) The directories "bin" and "lib" are only available in the
 downloadable release zip file.