Skip to content
This repository has been archived by the owner on Sep 21, 2022. It is now read-only.

Handbook

MrMarvin edited this page Feb 14, 2013 · 3 revisions

How to add your experiment to IoTHub

To publish your experiment for the world to see, simply apply the following 3 steps and start sharing the given link.

1 - Create a config.js file

To make IoTHub understand your experiment, you will need to create a very simply configuration file. This file shows the relationship between your executables and the nodes that will be flashed with each blob.

For each binary image specify a link to a list of nodes that you wish to run the program on. You can use the WiseGUI to create such a link (NOT TRUE! Not yet implemented in wisegui).

The location of the image file can be a absolute url (reachable via HTTP), or a path relative to the location of the config file.

Example: { "configurations" : [ { "nodeUrnsJsonFileUrl" : "http://wisebed.itm.uni-luebeck.de/rest/2.3/uzl/experiments/nodes?capability=pir&filter=0x21", "binaryProgramUrl" : "image_pir.bin" }, { "nodeUrnsJsonFileUrl" : "http://wisebed.itm.uni-luebeck.de/rest/2.3/uzl/experiments/nodes?capability=temperature&filter=0x21", "binaryProgramUrl" : "image_gw.bin" } ] } (taken from packet-tracking)

2 - make your experiment available via http

The most convenient solution is to use a github.com repository for your files, however, any other http server might work just as well.

3 - Create an experiment on IoTHub

You can sign in to IoTHub using your github.com account. Navigate to /experiments/new and enter your experiments name, the link to the config.json file and a description what your experiment is about. If your using github, please make sure to use the "raw" url of the config file! To let others see your experiment, make sure to check the "public visible?" checkbox.