#Description rpi_wallboard is a collection of script and instructions intended to build a wallboard on a RaspberryPi micro computer. The Wallboard is nothing else than a full-screen browser in kiosk-mode that will automatically load a webpage showing the desired content, withut any user interatction after turning on the RPi.

In this specific case, for Inviqa, the Wallboard is preconfigured to login and show the Builds Wallboard provided by Jenkins Wall Display plugin.

#Features

• Chromium in full screenmode (allowing the automatic login via Google federated login).
• Jenkings Builds wallboard.
• The RPi is reacheable via Bonjour (ZeroConf) protocol naming (.local)
• Remote SSH connection
• Multi (shared) VNC screen sharing
• Automatic Shutdown (best accompanied by a mains timer socket to turn it on periodically)

#VNC connection By defaul the RPi Wallboard is accessible via VNC in Multi/Shared ViewOnly mode, with NO PASSWORD at the address 'wallboard.local' or 'vnc://wallboard01.local' (for Safari)

#SSH connection By defaul the RPi Wallboard is accessible via SSH on the local network using the addressl 'wallboard.local' user: pi password: raspberry

#How-To build a Raspberry Pi Wall board Gold-Image This instructions are for Mac OSX but can be easily adapted to be run on a Linux host.

##Install the latest Raspbian

# Download the official latest installation image
http://downloads.raspberrypi.org/raspbian/images/

i.e.
curl --progress-bar -o 2014-09-09-wheezy-raspbian.zip http://downloads.raspberrypi.org/raspbian/images/raspbian-2014-09-12/2014-09-09-wheezy-raspbian.zip
# unzip the raspbian image in your working directory
unzip  2014-09-09-wheezy-raspbian.zip

Insert the SD card in the SD read of your computer.

# Run ‘diskutil’ from command-line to learn what is the device name of the SD card (which we assume is ‘/dev/disk1’) and it’s partitions.
diskutil list

# Unmount all the possibly mounted partitions of /dev/disk# (mind that the disk won’t be ejected)
diskutil unmountDisk /dev/disk1

# Dump the raspbian image into the SD card which for which we will use the RAW interface ‘/dev/rdisk1’ so that the dump will be quite fast

sudo dd if=2014-01-07-wheezy-raspbian.img of=/dev/rdisk1 bs=1m

You can monitor the dumping progress via Activity Monitor (on a Mac), filtering for the dd process.

• Copy the wallboard_setup.sh script in the SD card BOOT partition.
• Copy the config.txt in the SD card BOOT partition.
• Copy the xinitrc in the SD card BOOT partition. -not mandatory-
• Copy the rc_local.patch in the SD card BOOT partition. -not mandatory-

Edit the config.txt and modify these parameters according to your specific needs: hostname, ssid, ssid_password (in clear)

Gacefully unmount the SD card, then plug it into the RPi and turn the RPi on with a keyboard, mouse and screen connected (we need the keyboard & mouse just for the first run).

##First Run: Log into the Jenkins Wallboard Log into the RPi with the user ‘pi' and the password ‘raspberry’ and run the /boot/wallboard_setup.sh script 'root' or with sudo.

After running the /wallboard_setup.sh you need to restart the RPi. Use a USB mouse and a keyboard connected to the RPI to operate it. When restarted, if all went through without issues, it will appear the Federated Login page, at this stage:

1. Press the 'F1' stroke in the keyboard to show a fully framed window of Chromium.
2. Click on the menu button (top right of the screen)
3. Click the 'Sign in to Chromium...' option
4. Enter the 'robot' user credentials (DON'T USE YOUR PERSONAL CREDENTIALS)

#Backup: Create a restorable image ##Deduce the total size of backupimage Mount the the SD card on the computer (in our case a Mac)

Get the size of the boot partiotn in bytes

# get Gthe size of the boot partiotn in bytes
diskutil info /dev/disk1s1|grep "Total Size"|cut -f2 -d'(' |cut -f1 -d")"
# i.e. 58720256 Bytes

# get Gthe size of the root partiotn in bytes
diskutil info /dev/disk1s2|grep "Total Size"|cut -f2 -d'(' |cut -f1 -d")"
# i.e. 2899312640 Bytes

Sum these two value and divide it by 1048576 (1024 * 1024) to know how many MB of space they are using:

**58720256 + 2899312640 = 2958032896 Bytes / 1024 / 1024 = 2821 MB**

##Create the backup image - Used as Gold-Image Unmount the all the SD partition without ejecting the device

diskutil unmountDisk /dev/disk1

Start the dumping with 'dd'

# bs=1m define the blocksize of 1MB
# count=2900 defines the number of blocks to copy
# to avoid corrupting the filesystem it's better to round up the count so 2821MB is rounded to 2900 blocks

sudo dd of=rpi_wallboard.img if=/dev/rdisk1 bs=1m count=2900

#Restore from a backup image - Using the Gold-Image

sudo dd if=rpi_wallboard.img of=/dev/rdisk1 bs=1m

Mount the /boot partition in your host computer Edit the /boot/config.txt file Set the following paramenters:

• hostname=
• ssid=
• ssid_password=

#TODO

1. Specify the robot's login details in the config.txt file ...so that the password is blanked after the first use and that if we update the login details these are refreshed in Chromium as well
2. Find a way to inject these in Chromium so that we automate that initial setup as well
3. Then we also find a way to aumate the 30-day relogin in Chromium steps 2 and 3 could be automated with behat

#License and Author Copyright (C) 2012 - 2013 Inviqa UK Ltd

Author: Marco Massari Calderone ([email protected]) Other author may be collaborating at the development of the various scripsts and tools.