a first look at the dashboard

The databox dashboard is the interface that you use to install apps and drivers. A quick recap: a driver is software that communicates with datasources, and apps are databox applications that process your personal data on the box. This section assumes that you have installed databox on a machine; if you have not, please go through these instructions.

Although you do not have to install the databox dashboard on your phone, we’d recommend it as it’ll give you access to some of your phone’s sensors, which will expand the number of apps that you can run. Before you get started, you’ll need the IP address of the computer that you are running your databox on. If you do not know it, the simplest way is to use an online service such as what is my browser

installing on a phone

First, ensure that you are on the same network as the machine that is running databox.

To install the app on a phone, go to the Google Play store or Apple App store and look for the databox app . Once started, if the app does not automatically discover your databox, give it the IP address of the databox machine.

running in a web browser

To run in a web browser, if you are on the same machine as your databox, go to http://127.0.0.1:8989 (opens in new tab). Else, enter the IP address of the machine running databox, i.e. http://[databoxipaddress]:8989

the dashboard interface.

When you first load up, the app will attempt to find your databox. If it fails, you will be prompted to enter the databox address:

dashboard connection error
dashboard connection error

Type in the address that the databox is running on. Once successful you should see the following screen:

dashboard home screen
dashboard home screen

On the top right-hand of the screen is the menu. Click on it and you should see the following:

dashboard menu
dashboard menu

running apps, drivers and stores

“Out of the box” the databox has no apps or drivers running on it. If you click on Apps or Drivers you’ll simply see an empty list for each as follows:

running apps
running apps,drivers,stores

You should rarely need to click on the “Stores” menu item, as stores are automatically loaded up as required when a new driver/app is installed.

the app store

The default app store has several simple sample apps, which you can use to ‘smoke test’ the databox. Click on “App Store” to take a look:

app store
app store

If you have already published an app (by following the sdk walkthrough) then you should see it in the list here. The simplest possible app is os monitor. Before we install it, we need to install the osmonitor driver, by going to the Driver Store:

driver store
driver store

Click on osmonitor and follow the install instructions. Once installed, after a short wait you should see it listed on the Drivers page. Now you are ready to install the os monitor app. Go back to Apps, and click on os monitor.

driver store
driver store, osmonitor

You’ll be presented with an install dialogue:

app store, install osmonitor
app store, install osmonitor

The osmonitor app requires access to all of the osmonitor’s datasources (each of the 1,5 and 15 minute load averages are a datasource, as is the total freememory):

app store, select datasources
app store, select datasources

You will be prompted to agree to give access to all of them, and once done you should have:

app store, selected datasources
app store, selected datasources

Now click on INSTALL, and after a short delay, you should see osmonitor listed in the running apps:

driver store
driver store, osmonitor

Click on it and you should see a several plots, which are reading live os system data from the databox:

osmonitor output
osmonitor output

installing sensingkit

To get access to a few more sensors and apps that make use of them, you can enable access to your phone’s sensors by installing the sensingkit driver. Go to the Driver Store page and select sensingkit. Follow the install instructions:

install sensingkit driver
install sensingkit driver
sensingkit running
sensingkit running

Once you see sensingkit is running, you can enable various sensors. Go back to the menu and click on “Mobile Sensor Data”.

sensingkit running
sensingkit - install mobile sensors

Click on “Enable Mobile Sensor Data” and this should open up a list of sensors supported by the phone.

sensingkit sensors
enabled sensingkit sensors

Select light and accelerometer. Now you can go back to the App Store and test an app that makes use of these sensors. Try installing and running the light graph app. Once installed, if you click on it, it should bring up a graph showing the current light reading in lux (from your phone’s camera).