Two apps are prepared for the IPIN2014 competitors: one is a logging app to collect the estimated location information from positioning systems, and the other one is a dummy app to send an empty location data to the logging app via bluetooth communications. Here, the dummy app(dummy localizer) generates empty locations just for test and to be refered by competitors own positioning systems. The competitors positioning systems are supposed to send their estimated location information to the logging app in the same way as the dummy app does. The IPIN2014 common library have been prepared to support this.

Major features

• IPIN'14 competition common library : libs/ipin2014_common.jar
• 1:1 Bluetooth data communication
• Empty location output generation
• Sending the output to the logging app

The connections between the apps and a positioning system

Demos

This is a sample sequence of location logging:

1. (Logging App) Select a competitor ID from the list. Initially, dummy list of competitors is provided.
2. (Dummy App) Click the “listen” button.
3. (Logging App) Click the “scan” button to find the measurement device to be paired.
4. (Logging App) Select the device and click the “connect” button to pair with the device. The mac address of the selected device is presented on the top of the app.
5. (Logging App) After the pairing is made, a button represents current key point is activated. Initially, dummy list of key point is provided.

(Dummy App) When you click “send location” button, dummy app send location (.0, .0, 0) to logging app. However, the implemented measurement app should send an estimated location periodically at highest frequency. The most recent location log is presented on the top of the application.

Files

• Logging App. : IPIN2014_Logger.apk
• Dummy App. : bin/IPIN2014_DummyLocalizer.apk
• IPIN Common Lib. : libs/ipin2014_common.jar

Download

Download this repository. Copy the apk file to an Android that can run 4.x or greater.

IPIN'14 competition common library

LocationSender class

LocationSender(Context context)

Class which has the bluetooth connectivity and pairing information.

LocationSender.listen()

Keep listening until a socket is connected.

After this method is called, you can make a connection by pushing "Connect" button on logging app. Note that when this method is called, the bluetooth adapter should be discoverable by logging app to make a connection.

sendLocation(double lat, double lng, int level)

Send estimated location with timestamp to the connected logging app.

The coordinate of the location should be presented in latitude and longitude. You have to refer and calculate latitude and longitude of the map which been provided. It also should contain the information of floor level. This method should be called whenever you have a new positioning result, while the bluetooth connection is maintained.

Sample code review

private View.OnClickListener mBtnListener = new View.OnClickListener() {

    @Override
    public void onClick(View v) {
        switch ( v.getId() ) {
        case R.id.btn_listen:
            Intent discoverableIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);
            discoverableIntent.putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300);
            startActivity(discoverableIntent);

            mSender.listen();

            break;
        case R.id.btn_sendLocation:
            mSender.sendLocation(.0, .0, 0);
            break;
        }
    }
};

comments:

1. When listen button clicked, make bluetooth discoverable and listen
2. When send button clicked, send the location (lat, lng, level) to logging application
3. 2nd process must be done after connect with logging application

Logging application output

• Output files are located in /sdcard/ipin2014/ folder and two text files will be create and the format like this:
  • <id>_keypoint.txt: < id >, timestamp, keypoint numbering(eg, 0,1,2,3,...)
  • <id>_location.txt: < id >, timestamp(recv), timestampe(send), lat, lng, floor level

Guide for other platforms(updated Oct 20,2014)

We suggest to use the bluecove library to connect other platforms like Windows. Here a sample code which tested at Windows 7 to connect competition logging app. As you can see, only uuid fix into following example. (uuid = "0000110100001000800000805F9B34FB")

import ipin2014.competition.common.protocol.Location;

import java.io.IOException;
import java.io.ObjectOutputStream;
import javax.bluetooth.*;
import javax.microedition.io.Connector;
import javax.microedition.io.StreamConnection;
import javax.microedition.io.StreamConnectionNotifier;


public class Test {

	private static String uuid = "0000110100001000800000805F9B34FB";

    public static void main(String[] args) throws IOException, InterruptedException {
    	LocalDevice localDevice = LocalDevice.getLocalDevice();
    	localDevice.setDiscoverable(DiscoveryAgent.GIAC);

    	String url = "btspp://localhost:" + uuid + ";name=BlueToothServer";
    	StreamConnectionNotifier server = (StreamConnectionNotifier) Connector.open(url);

    	StreamConnection connection = server.acceptAndOpen(); // Wait until client connects

    	//=== At this point, two devices should be connected ===//
    	ObjectOutputStream oos = new ObjectOutputStream(connection.openOutputStream());
    	
    	for(int i=0; i<100; i++){
			long temp = System.currentTimeMillis();
			while(temp + 1000 > System.currentTimeMillis());
    	
    		oos.writeObject(new Location(.1*i, .1*i, i, System.currentTimeMillis()));
            /* Create a new Location class(ipin'14 common library) and send the object
            	input param: lng,lat, level, currentTime
            */
    	}

    	connection.close();
    }
}

The object that is passed to the server side is Location which class is contained IPIN'14 common library.

Map coordinates changed (IMPORTANT UPDATED Oct, 28, 2014)

| Map point| lat (old) | lng (old) |lat (new) | lng (new) | | :------------ |:---------------:||:---------------:||:---------------:||:---------------:| | A2F A | 35.167759|129.134113|35.1677877|129.1340732| | A2F B | 35.165378|129.135841|35.1653866|129.1358354|

Support

This work was contributed by Intelligent Service Integration Laboratory(ISILAB) at KAIST. If you need help using the Dummy Localizer, or have found bugs, please create an issue on the GitHub repo