Campaignr

From UrbanWiki

Jump to: navigation, search
CampaignrWM start screen
CampaignrWM start screen

Campaignr allows for people who are familiar with only XML to create and run data collecting campaigns. Using a simple XML file to describe which sensors to use, where to upload the collected data, and how often to collect the data, one can run many different types of collection campaigns.

We currently support both Symbian S60 as CampaignrS60 and Windows Mobile as CampaignrWM. All XML configuration settings are intended to be supported by both platforms but there are exceptions (see documentation).

Visit www.campaignr.com for the official distributions, source code, and documentation. You can also view the latest Campaignr Progress Reports from the developers.

Contents

[edit] How-to use

[edit] Symbian S60

Campaigns need to go into Data\Campaignr on either internal (C:) or external (E:) memory. Both are read by the application.

Campaignr starts with displaying the list of campaigns it has found. It displays the name of the XML file along with the name of the campaign for easy discernment of campaigns.

The campaign is started by either clicking the OK button (the center of the directional pad), or by selecting Open from the Options menu.

Once a campaign is chosen and initialized, a mostly blank screen with the name of the campaign as its title is shown. From here the user can select Start Campaign from the Options menu to start the data collection process. The Settings option shows a placeholder view for options that could be changed. It will be implemented in a later version. Upon starting the campaign the upload manager will automatically start.

  1. If there was any previous data it will automatically connect to the internet to upload a chunk of data and every 10 minutes thereafter it will check again.
  2. If the collection interval is a number then the collection process will begin immediately.
  3. If it is instead, triggered, then, when the user presses the OK button the collection process will go through one repetition.
  4. If the viewfinder option is specified to the camera then when the it's the camera's turn to collect data it will display a viewfinder so that the user can frame the shot. The picture is captured by pressing the OK button. The picture is then saved and stored and the viewfinder is closed. To stop running a campaign the user selects the Stop Campaign option from the menu and the campaign will stop collecting data and will stop uploading data. To start collecting data again, the user just has to select Start Campaign once again.

[edit] Data-collection Configuration

  1. Campaign
  2. Sensors
  3. Upload
  4. On-device Processing

[edit] Download Campaignr

  1. Stable builds
  2. Experimental builds
  3. Legacy builds

[edit] Installation

[edit] Symbian S60

To install the application download the .sisx file to your computer and transfer it to the phone via bluetooth or if you use windows via usb using the sync software that came with your phone. Alternatively navigate to this page with your mobile phone and clicking on the download link should start the installation process automatically. It can be installed on either external or internal memory.

[edit] Windows Mobile

Download the cab file or exe file to your computer. If you have downloaded the cab file either copy the file to the phone or use ActiveSync for manual deployment. If you have downloaded the complete exe installation file run the file in your desktop computer. Connect your device before starting the installation process for the best result.

[edit] Debug

  • Campaignr can be configured to write a log file to the external memory card by creating the folder E:/Logs/Campaignr where e: is the memory card.
  • Numeric mapping of system-wide error codes for Symbian can be found here.
  • For debug purposes it can be helpful to setup a dummy service as the Campaignr end-point. CampaignrLogger.py is a Python 2.5 script that accepts Campaignr data (either Sensorbase.org or PERFF/JSON format) and stores it to disk as plain text. The file can be downloaded here: CampaignrLogger.zip

[edit] Designated Developers

Encryption and Authentication Platform

Adaptive Sampling, Upload, Power Management, and On-device Processing

Core Framework and Extensions

Human Computer Interface (UI, feedback modules)

Retrieved from "http://wiki.urban.cens.ucla.edu/index.php/Campaignr"