MySmartGrid Developer Wiki

You need a recent version of the Chumby Software Image, as described here: ChumbyImageHowto. The image contains various Ruby scripts to retrieve data from external sources and exposes it to Flash frontends. All software is installed to /mnt/storage so that it runs from the internal SD card. By convention, this is the filesystem layout for our components:

/mnt/storage/usr                     # where all mysmartgrid components live
/mnt/storage/usr/etc                 # configuration files
/mnt/storage/usr/{bin|lib|...}       # the obvious unix filesystem layout

Some special files for initializing the environment:

/mnt/storage/environment.sh          # shellscript to set up the environment for interactive use
/mnt/storage/usr/etc/msg-init.rc     # init script to hook into userhook2

If you log into the Chumby via SSH, run

$ /mnt/storage/environment.sh

to get an interactive shell with an updated environment.

The Ruby daemon “msg-chumby-daemon” retrieves the current power consumption from your Flukso. It depends on an configuration file which you need to adjust. A template can be found in ”/mnt/storage/usr/lib/ruby/gems/1.8/gems/msg-chumby-display-0.2.0/etc/msgchumbydaemonrc” (depending on the version of the gem). Copy it to ”/mnt/storage/usr/etc” and edit it to reflect your local Flukso settings. For example:

# These are the access parameters of the CC-HPC demo flukso - replace
# with your own parameters!
ACCESS_TOKEN: "bb8640e074de14b9d444be7b1359707f"
SENSOR_ID: "67e9fa794684e4902730be208e9d734e"
FLUKSO_LOCATION_METHOD: "static"
FLUKSO_HOST: "192.168.1.102"
FLUKSO_PORT: "80"
FLUKSO_LOCAL_ID: "d69779ec53a9323b695ee86b5328dd28"

Access token and sensor id are needed to retrieve longterm values from the website. The FLUKSO_* variables describe where the Flukso lives on the local LAN, and what sensor ID should be queried. Copy this template to ”/mnt/storage/usr/etc” and edit it.

For interactive use, you can start the daemon like this:

# /mnt/storage/environment.sh
# msg-chumby-daemon -c /mnt/storage/usr/etc/msgchumbydaemonrc

The widgets for presenting the current power consumption are distributed as a part of the Ruby gem. You can find them in ”/mnt/storage/usr/lib/ruby/gems/1.8/gems/msg-chumby-display-0.2.0/widget”. To run a widget manually, follow these steps:

# Kill the running control panel
/usr/chumby/scripts/stop_control_panel
# Run the desired widget
/usr/bin/chumbyflashplayer.x -i <path/to/widget>

For demos I configure the Chumby so that the standard control panel is not started. Instead, before the control panel ist started, I run the widgets manually. You can adjust the userhook2 to do this, see http://wiki.chumby.com/mediawiki/index.php/Chumby_Rootdisk_-_RFS1_(analyzed):