Codename:Garbo Quick Start Guide

From TechnologicalWiki

Installation

There are two ways to run this application:

• Download and install the Windows msi or linux deb file or,
• Install Python interpreter and dependencies and execute the original python script.

Configuration

After starting the application, double click or right button click - config over the system tray icon. Fulfill the information fields with:

• Name field: A given name for that particular installation of the Bluetooth Localization Agent. The application will propose the system hostname. This field is mandatory.
• Place field: The name of the location where the agent is searching for devices. This name will be reported together with those devices detected. This field is optional.
• Coords field: Latitude and longitude coordinates where this agent is located. To specify the detection range as a radius, provide a third value after the coordinates. To easily find out what coordinates define certain location, an easy way is to search the place on Google Maps, then right click on the tag result and select option "What here?", and copy the coordinates from Google Map search box. Also another services, such as http://www.getlatlon.com are useful to find geographical coordinates. This field is optional, but unless valid coordinates are not provided it won't be reported.
• Address field: Any valid Jabber address to be used by this agent. You have to provide a different address for each agent installation. It could be an address from the official OSAmI server (osami.tid.es) or any other, such as jabber.org. This field is mandatory.
• Password field: Password for the previous Jabber account. This field is mandatory.
• Server field: Jabber address of the Localization Server. After the installation, the application comes with the official OSAmI server address (locserver@osami.tid.es), but it can be changed to another server. This field is mandatory.

Operation

Agent tab:

Show me a Map button: When valid coordinates are provided this button becomes enabled, and it can be used to see the coordinates on Google Maps.

Jabber tab:

Connect / Disconnect button: When valid addresses and password are configured, the agent connects to the Jabber service at application start. Use this button to disconnect and change this configuration fields.

Scan tab:

Bluetooth checkbox: Enable and disable bluetooth detection with this control.

Fake phone checkbox: Define a fake mobile device that can come into or leave detection range. This fake phone can be used with or without bluetooth checkbox checked. Use this option to easily test and debug localization based services, or when bluetooth interface is not available.

MAC: The MAC address of the fake phone. See XML config file below to change it.

Name: The reported name of the fake phone. This field is optional, but it is quite convenient to identify this fake phone.

Go into range! button: Press this button to simulate that the fake phone goes into, or leaves agent's detection range. As soon as the agent starts another broadcasting process to find devices, it will be reported. Take into account that the fake phone activity will be reported despite of bluetooth disabled.

XML config file

All configurations are inmediatelly taken into account, but they will be written to the XML config file only pressing the Save or Exit buttons. All these configurations and other are stored into the garbo.xml file. You can manually edit this file to change some parameters that are not available trough the GUI.

Time: Time period in seconds between bluetooth detection broadcasting.

MAC: Fake phone's MAC address. Take into account that this MAC address will be used to identify this device, and MAC's format won't be checked. Thus, any string is valid, but to be consistent with real bluetooth devices, it is advisable to write such as a real bluetooth MAC address.

Return to OSAmI-ES Developments