Raspberry Pi Tally Screen guide

These instructions were written for a Raspberry Pi (Pi 3 or 4 recommended) with a touchscreen connected. You may have to deviate from the instructions to get it to work for another device.

1. OS Installation
2. Device Configuration

OS Installation

Instructions based on this kiosk guide.

Prepare your MicroSD card with a clean installation of the latest version of Raspberry Pi OS Lite (without desktop environment). Connect an ethernet cable and boot the device.

$ sudo apt-get update && sudo apt-get dist-upgrade -y

$ sudo apt-get install --no-install-recommends xserver-xorg-video-all xserver-xorg-input-all xserver-xorg-core xinit x11-xserver-utils chromium-browser unclutter

$ sudo raspi-config
# go to: Boot Options > Console Autologin
# also go to: System Options > Password, set a password here (and store it somewhere)

$ nano /home/pi/.bash_profile

Then paste in the following:

if [ -z $DISPLAY ] && [ $(tty) = /dev/tty1 ]
then
  pause 10
  startx -- -nocursor
fi

Next edit another file:

$ nano /home/pi/.xinitrc

And paste in these contents:

#!/usr/bin/env sh
xset -dpms
xset s off
xset s noblank

unclutter &
chromium-browser https://jeat.nl/login?type=house \
  --window-size=800,480 \
  --window-position=0,0 \
  --start-fullscreen \
  --kiosk \
  --noerrdialogs \
  --disable-translate \
  --no-first-run \
  --fast \
  --fast-start \
  --disable-infobars \
  --disable-features=Translate \
  --overscroll-history-navigation=0 \
  --disable-pinch \
  --pull-to-refresh=2 \
  --disable-hang-monitor

Some handy commands

Alt+F4 to exit kiosk mode, startx -- -nocursor to start chromium manually

Device Configuration

After you've installed the OS you can start connecting the device to the internet.

1. Boot the Pi.
2. If the pi does not have an internet connection yet:
   1. Let the pi boot
   2. Connect a keyboard
   3. Press ALT+F4. The terminal should appear
   4. Configure internet access:
      • Wi-fi (make sure a dongle is connected if Pi <4):
        • Simple SSID + password:
          1. sudo raspi-config, Network Options, Wi-fi
          2. Follow the steps
          3. Once done, press the right arrow to select the Back button, and then Finish.
        • Eduroam (PEAP):
          1. sudo ifconfig wlan0 down
          2. sudo killall wpa_supplicant
          3. sudo nano /etc/wpa_supplicant/wpa_supplicant.conf
          4. Make sure the following lines are in the file:

          update_config=1
          country=NL
          
          network={
            ssid="eduroam"
            eap=PEAP
            key_mgmt=WPA-EAP
            phase2="auth=MSCHAPV2"
            anonymous_identity="anonymous@<domain>.nl" # check your school's instructions
            identity="<eduroam login email>"
            password="<eduroam login password>"
          }
          

          CTRL + X, Y, Enter to save. 5. sudo ifconfig wlan0 up 6. You can run sudo wpa_supplicant -i wlan0 -c /etc/wpa_supplicant/wpa_supplicant.conf to test the connection. It should say "Authentication successful"
      • Ethernet (only required if your network requires registering mac-addresses):
        1. sudo ifconfig eth0
        2. Note down the mac-address
        3. Register the mac-address with your network's portal
   5. sudo reboot