klipper/docs/beaglebone.md

This document describes the process of running Klipper on a Beaglebone PRU. The PRU support is experimental.

Building an OS image

Start by installing the latest Jessie IoT image (2017-03-19 or later). One may run the image from either a micro-SD card or from builtin eMMC. If using the eMMC, install it to eMMC now by following the instructions from the above link.

Then ssh into the beaglebone machine (ssh debian@beaglebone -- password is "temppwd") and install Klipper by running the following commands:

git clone https://github.com/KevinOConnor/klipper
./klipper/scripts/install-beaglebone.sh

Install Octoprint

One may then install Octoprint:

git clone https://github.com/foosel/OctoPrint.git
cd OctoPrint/
virtualenv venv
./venv/bin/python setup.py install

And setup OctoPrint to start at bootup:

sudo cp ~/OctoPrint/scripts/octoprint.init /etc/init.d/octoprint
sudo chmod +x /etc/init.d/octoprint
sudo cp ~/OctoPrint/scripts/octoprint.default /etc/default/octoprint
sudo update-rc.d octoprint defaults

It is necessary to modify OctoPrint's /etc/default/octoprint configuration file. One must change the OCTOPRINT_USER user to "debian", uncomment the BASEDIR, CONFIGFILE, and DAEMON settings and change the references from "/home/pi/" to "/home/debian/":

sudo nano /etc/default/octoprint

Then start the Octoprint service:

sudo systemctl start octoprint

Make sure the octoprint web server is accessible - it should be at: http://beaglebone:5000/

Building the micro-controller code

To compile the Klipper micro-controller code, start by configuring it for the "Beaglebone PRU":

cd ~/klipper/
make menuconfig

To build and install the new micro-controller code, run:

sudo service klipper stop
make flash
sudo service klipper start

For the Replicape, it is also necessary to compile and install the micro-controller code for a Linux host process. Run "make menuconfig" a second time and configure it for a "Linux process":

make menuconfig

Then install this micro-controller code as well:

sudo service klipper stop
make flash
sudo service klipper start

Remaining configuration

Complete the installation by configuring Klipper and Octoprint following the instructions in the main installation document.