Author: Birchy (support@bespokebots.com)

Thanks:
    Arceye (http://linuxcnc.org/index.php/english/my-profile-usermenu-17/userprofile/ArcEye)
    Sebastian Kuzminsky: seb@highlab.com

Kernel Sources: http://highlab.com/~seb/linuxcnc/rtai-for-3.4-prerelease/


*** INSTALLATION GUIDE ***

The parent folder of this file contains automated Bash scripts to install an RTAI kernel and LinuxCNC.
All dependecies should be auto installed.

NOTE:
    Tested on a clean install of Debian Wheezy with XFCE desktop.
    Should work fine on any Debian 7.x based OS, including Ubuntu (UNTESTED!)

*** Pre-requisites ***
1. A clean install of a Debian based OS
2. An up-to-date /etc/apt/sources.list with deb URLS
    NOTE: the only source will be CDROM if you installed offline.
    Online sources can be generated here: http://debgen.simplylinux.ch/
3. A working internet connection
4. A basic understanding of using the Terminal commands
5. You have unzipped the files to /home/YOUR_USERNAME/setup-cnc (the default)
6. The 'setup-cnc' folder contains a sub-folder called 'kernel'
7. The 'kernel' folder contains the following debs from the url at the top of this page:
    linux-headers-<whatever version>.deb
    linux-image-<whatever version>.deb
    rtai-modules-<whatever version>.deb
    NOTE: kernel.png shows the files used for developing these scripts

*** Install RTAI Kernel ***
1. Launch terminal and run the following commands:
    cd setup-cnc
    chmod 777 *.sh
    su [enter root password]
    ./install-kernel.sh
2. Reboot into RTAI kernel if installation completed successfully

*** Install LinuxCNC from git Master ***
1. Launch terminal and run the following commands:
    cd setup-cnc
    ./build-linuxcnc.sh

*** Running LinuxCNC ***
1. Start the Run In Place Environment from a terminal:
    cd linuxcnc-dev
    . scripts/rip-environment
2. From the same terminal you can now run any of the following:
    latency-test
    stepconf
    linuxcnc
    <whatever else linuxcnc has to offer...>