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
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.
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
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:
Type in the address that the databox is running on. Once successful you should see the following screen:
On the top right-hand of the screen is the menu. Click on it and you should see the following:
“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:
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 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:
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:
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.
You’ll be presented with an install dialogue:
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):
You will be prompted to agree to give access to all of them, and once done you should have:
Now click on INSTALL, and after a short delay, you should see osmonitor listed in the running apps:
Click on it and you should see a several plots, which are reading live os system data from the databox:
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:
Once you see sensingkit is running, you can enable various sensors. Go back to the menu and click on “Mobile Sensor Data”.
Click on “Enable Mobile Sensor Data” and this should open up a list of sensors supported by the phone.
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).