Setup: Boot to Browser (OctoPi or Jessie Light)

This is a guide for Jessie Lite or OctoPi (0.13 and higher)

Follow this guide for Jessie Full.

There is currently an issue with the Official Raspberry Pi Touchscreen device and OctoPi. This guide will be updated, for more information about the issue see issues/98 <-- help wanted/needed!!!

---

Before starting with this guide, make sure you've installed OctoPrint and installed TouchUI from the 'Plugins Manager'.

---

1. Make sure you've expanded your file system

2. Make sure you've your touchscreen working by installing the required drivers.

3. Make sure all packages are up-to-date:

   sudo apt-get update
   

4. Install all required packages:

   sudo apt-get install --no-install-recommends xinit xinput xserver-xorg xserver-xorg-video-fbdev x11-xserver-utils matchbox unclutter chromium-browser
   

5. Register your touchscreen to X11 by creating a new config:

   sudo nano /usr/share/X11/xorg.conf.d/99-fbdev.conf
   

   • If your touchscreen is connected with HDMI, paste the following code:
     Use this if you're using the Official Pi Touchscreen

     Section "Device"
       Identifier "touchscreen"
       Driver "fbdev"
       Option "fbdev" "/dev/fb0"
     EndSection
     

   • Otherwise, paste the following code:

     Section "Device"
       Identifier "touchscreen"
       Driver "fbdev"
       Option "fbdev" "/dev/fb1"
     EndSection
     

   Save and exit (CTR-O, enter and CTR-X)

6. Allow X11 to run as anybody by running the following command:

   sudo sed -i 's/allowed_users=console/allowed_users=anybody/' /etc/X11/Xwrapper.config
   

7. Get the TouchUI boot files:

   git clone https://github.com/BillyBlaze/OctoPrint-TouchUI-autostart.git ~/TouchUI-autostart/		
   

8. Copy service file and register it as auto boot:

   sudo cp ~/TouchUI-autostart/touchui.init /etc/init.d/touchui
   sudo chmod +x /etc/init.d/touchui
   sudo cp ~/TouchUI-autostart/touchui.default /etc/default/touchui
   sudo update-rc.d touchui defaults
   

9. Test if your kernel can run Chromium by running the following command:

   chromium-browser
   

   • If you get the following error, you need to upgrade your kernel to the latest version, follow these extra steps.

     /usr/lib/chromium-browser/chromium-browser: symbol lookup error: /usr/lib/chromium-browser/chromium-browser: undefined symbol: mmal_vc_init_fd
     

   • If you get the following error, you can proceed to step 10:

     [..] Gtk: cannot open display:
     

10. Reboot

• Do not remove the directory ~/TouchUI-autostart and if you change the path of this directory then edit the file /etc/default/touchui with the new path.

• Troubleshooting:

  • Calibration
  • Inverted Axis
  • Webcam image not working

---

Upgrading your kernel:

1. Run:

   sudo apt-get upgrade
   sudo apt-get install rpi-update
   

2. Run:

   sudo rpi-update
   

3. Reboot:

   sudo reboot