Installation

Just use pip to install CANberry and all its dependencies:

pip install canberry

Configuration

Create a configuration file .canrc with following content in your home directory:

[default]
interface = socketcan
channel = can0

[canberry]
identifier = 16
# Is server externally visible? 'true' or 'false'
external = true
# Run the server in debug mode? 'true' or 'false'
debug = false

The identifier is the default target address. You should note that running an externally visible server in debug mode is not recommended!

Development

Installation:

• Create a virtual environment virtualenv venv and activate it with source venv/bin/activate.

• Install all dependencies with pip install -r requirements.txt.

• Run python setup.py develop to install CANberry in your virtual environment.

• Run canberry from the command line to start the web application. Try canberry -h for help on more options.

In order to update the Javascript components shipped with CANberry with:

• Install npm with sudo apt-get install nodejs.

• Install bower with sudo npm install -g bower.

• Use bower install -S to install and update js dependencies like concise, ractive, jquery, flotcharts.

Credits

This project uses following libraries:

• jQuery

• Concise CSS

• Ractive.js

• Flot

• python-can

Note

This project has been set up using PyScaffold. For details and usage information on PyScaffold see http://pyscaffold.readthedocs.org/.