Skip to content

malvira/bramble

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BRamble

BRamble is a web-based administration system for 6LoWPAN border-routers. It provides setup and diagnostic tools to easily deploy 6LoWPAN networks.

Features

  • RPL network visualization

    • queries routing information from nodes implmenting rplinfo CoAP resources
  • Automatic IPv6 network configuration

  • Radio managment

    • automatic firmware loading

Screenshots

Getting Help and Contibuting

Please see the wiki for detailed development details. If you need help, please ask questions in the issue tracker.

Installation

Get BRamble

git clone https://github.com/malvira/bramble.git

Install dependencies

On a debian/ubuntu machine, the following should get you pretty close:

apt-get update 
apt-get install cython libjs-jquery python-flask python-pip python-dev ipv6calc
pip install Flask-OpenID Flask-Login Flask-Principal Flask-Bcrypt Flask-Mako IPy gevent-socketio

See also the advanced scripts in:

bramble/files/debian/install-debian.sh bramble/files/arch/install-arch.sh

These scripts will setup nginx and automatically start BRamble etc... READ THROUGH THEM BEFORE RUNNING ON YOUR SYSTEM

Install gevent from source

git clone https://github.com/SiteSupport/gevent.git
cd gevent
python setup.py build
python setup.py install

Install libcoap and coap-client

BRabmle currently uses coap-client from libcoap.

Currently mainline contiki implements coap-08 in erbium (used by erbr and rplinfo). To get the latest version of libcoap that works with with this version of erbium:

git clone git://libcoap.git.sourceforge.net/gitroot/libcoap/libcoap
cd libcoap
git checkout a662f73
autoconf
./configure
make
cp examples/coap-client /usr/local/bin

Econotag tools

If you are using econotags or mc13224vs with bramble you will need mc1322x-load (the C version and not the perl script):

/contiki/cpu/mc1322x/tools$ gcc mc1322x-load.c -o mc1322x-load
sudo cp mc1322x-load /usr/local/bin

and probably bbmc (esp. if you are using PC w/econotag):

sudo apt-get install libftdi-dev
/contiki/cpu/mc1322x/tools/ftditools$ make
sudo cp bbmc /usr/local/bin

Contiki stuff

You should just need tunslip6 in a executable place.

Distribution files

See the files directory for details on how to configure your particular distribution.

In particular,

Gogoc template

only necessary if you are using a TSP tunnel

A suitable gogoc template must be present in the BRamble search path (default: ['/etc/gogoc', '/var/cache/bradmin', '/etc/lowpan', '/usr/local/etc/lowpan', '.']

getbripv6.sh

This script needs to be in your path somewhere. E.g.:

cp ./files/debian/bin/getbripv6.sh /usr/local/bin

Running Bramble

cd bramble/web
python runserver.py

This will print initalization information to the screen while the border-router is loaded with firmware, tunslip is connected, and gogoc aquires a tunnel. It will also start the BRamble webserver.

If all goes well, point your browser to localhost the default password is default.

License

BRamble is released under GPLv3.

About

6LowPAN border-router administration system

Resources

Stars

Watchers

Forks

Packages

No packages published