AIRcable (c)

Navigation

Recent site activity

Home‎ > ‎OpenProximity™ 2.0‎ > ‎

Quick Start Guide

OpenProximity 2.0 allows remote web access. It starts a web server which you can access it over the network.


Accessing the web interface

you're running the Slax Live version of OpenProximity 2.0 then you can access the main interface by just clicking an icon on your desktop:


If you're using OpenProximity 2.0 on your ServerXR, then you will need to point your favorite web browser and point it to your server ip. Like in this example:


In any case you will get to the main interface


Creating a campaign

Campaign creation is quite easy to achieve, even though it might look like it's not.

We start by clicking on "Admin Site" in the tool bar: 


Sometimes the system will show you the login screen, by default user name is admin and password is aircable

Adding a campaign

Once logged in you will be shown with standard Django Admin Interface, in order to create a new campaign you need to click on the add link next to Marketing Campaigns

Editing Campaign Details


A campaign is composed of a Friendly name which allows to distinguish between campaigns and one campaign rule. You can set the name, and choose/create new rules from this screen. By cliking on the green cross next to rules to create new rules.

Note: Next versions of OpenProximity 2.0 will make this process even easier, so please stay tunned with updates.

Campaign Rules

A campaign rule is composed of several files a profile and some optional filters. Profile is related to which Bluetooth Profile to use during upload opp is standard OBEX Push Profile which we recommend for marketing campaigns as it does not require PIN code pairing, but you can also use ftp over OBEX (more profiles might be added in the future).

Existing files can be easily added to this marketing rule just by selecting them. Or new files can be uploaded just by clicking on the green cross next to the selection box. To choose multiple files follow the rules that are stated under the files selector.

Filters are easy to understand, all this filters are optional, and can be setup at any time:
  • Start: start date for campaign.
  • End: end date for campaign.
  • Name Filter: only upload to devices whoes name starts with this filter.
  • Address filter: only upload to devices whoes bluetooth address starts with this filter (don't forget the dots in the bluetooth address).
  • Devclass filter: only upload to devices whoes devclass and devclass filter gives a logic TRUE value (device_devclass & filter_devclass > 0).

Uploading Files

File uploading is pretty easy, just click on the green cross next to files in the campaign rules screen.
Campaings are way easier to setup than rules, just one input box and a upload box.
Chance is used when you want files to be uploaded once in a while, if chance is 1 then this file will be uploaded to all found devices (that matches the rules off course), if it's lower 1 then a number will be randomically generated for each found device and only when the random number is bigger chance the file will be uploaded. This is useful when you want to send prizes on your campaign.
File is the most important field it allows you to upload files just by clicking on Upload... (in this picture Examinar...) , your browser upload file screen will came up and you can upload any file from your server.

Final steps!

Now to complete the process you need to click on save (blue button on the bottom right) on the 3 forms you completed: marketing campaign, campaign rule and campaing file. Next point your browser back to the index page (just delete everything after your server ip) and then click on Restart RCP Server to tell the server to start running the new campaign.

If this is the first time you are setting up OpenProximity 2.0 or if you just added more dongles to your server please continue reading dongles configuration.