RealTime suite‎ > ‎

Machine setup

Step 1 - Prepare your machine
  • Perform a clean installation of Ubuntu 10.04 x86 and apply all available updates.
  • From now on, all commands that follow a white dot have to be typed in a terminal window (follow the rule that for each dot corresponds one command on a single line).
  • Get the following packages:
    • sudo apt-get install cvs subversion build-essential libtool automake libncurses5-dev bison flex libboost-dev libboost-program-options-dev libgsl0-dev gfortran sablotron tcl8.5-dev tk8.5-dev xaw3dg-dev libpvm3 pvm-dev libgtkhtml2-dev libvte-dev ocaml-native-compilers libqt4-dev libqwt5-qt4-dev xfonts-100dpi xfonts-75dpi ssh
  • If you don’t already have it get realtimesuite archive, then extract it:
    • sudo wget
    • sudo mv download /usr/src/realtimesuite-1.2.tar.gz
    • cd /usr/src
    • sudo tar -xvzf realtimesuite-1.2.tar.gz
  • Ensure that /usr/src folder contains at least the following subfolders: ‘boot’, ‘comedi’, ‘comedi_calibrate’, ‘comedilib’, ‘comedi-nonfree-firmware’, ‘ede’, ‘efltk’, ‘jrtailab’, ‘kernel’  ‘qrtailab’, ‘rtai’, ‘rtaixml’, ‘scicoslab’.
  • Install EFLTK library:
    • cd /usr/src/efltk
    • sudo autoconf
    • sudo ./configure --disable-mysql --disable-unixODBC
    • sudo ./emake
    • sudo ./emake install
    • sudo gedit /etc/

Add a line with the path /usr/local/lib and save.

    • sudo /sbin/ldconfig

Step 2 - RTAI Patched Kernel
  • Install patched kernel:
    • cd /usr/src/kernel
    • sudo gdebi linux-headers-rtai_all.deb
    • sudo gdebi linux-image-rtai.deb
    • ls
  • Check for any other .deb in the folder and install it.
  • Check contents of src folder:
    • cd /usr/src
    • ls
  • Find version of rtai kernel folder in the form
    linux-headers-x.x.x-x-rtai (e.g. linux-headers-2.6.32-122-rtai)
    and make symbolic link (remember to replace version number):
    • sudo ln -s linux-headers-2.6.32-122-rtai linux
  • Reboot in the new Kernel:
    • sudo reboot
  • After reboot, check if patched kernel is running:
    • uname -r

Step 3 - First RTAI Installation
  • Install Comedilib:
    • cd /usr/src/comedilib
    • sudo sh
    • sudo ./configure --sysconfdir=/etc
    • sudo make
    • sudo make install
    • sudo make dev
  • Check the number of CPUs available on your machine:
    • cat /proc/cpuinfo | grep processor | wc -l
  • Enter RTAI compiling options:
    • cd /usr/src/rtai
    • sudo make menuconfig
  • Under Machine, set the number of CPUs that you previously found.
  • Exit Configuration, choosing ‘Yes’ when prompted to apply changes.
  • Compile and install RTAI:
    • sudo make
    • sudo make install
    • sudo sed -i 's/\(PATH=\"\)/\1\/usr\/realtime\/bin:/' /etc/environment
  • Edit grub:
    • sudo gedit /etc/default/grub
  • Change GRUB_CMDLINE_LINUX_DEFAULT="quiet splash" to GRUB_CMDLINE_LINUX_DEFAULT="quiet splash lapic"
  • Update grub:
    • sudo update-grub
  • Reboot the system.
  • After reboot, set RTAI kernel modules to be loaded at system startup:
    • cd /usr/src/boot
    • sudo cp rtailab /etc/init.d/
    • sudo chmod a+x /etc/init.d/rtailab
    • sudo update-rc.d rtailab defaults
  • Now load RTAI kernel modules without Comedi:
    • sudo /etc/init.d/rtailab preload

Step 4 - Comedi Installation
  • Create directory:
    • sudo mkdir /usr/local/include/linux
  • Install Comedi:
    • cd /usr/src/comedi
    • sudo sh
    • sudo ./configure --with-linuxdir=/usr/src/linux --with-rtaidir=/usr/realtime
    • sudo make
    • sudo make install
    • sudo depmod -a
    • sudo make dev
    • sudo ldconfig
  • Install Comedi Calibrate:
    • cd /usr/src/comedi_calibrate
    • sudo autoreconf -i -B m4
    • sudo ./configure
    • sudo make
    • sudo make install

Step 5 - Second RTAI Installation
  • Copy and link the following files:
    • sudo cp /usr/src/comedi/include/linux/comedi.h /usr/local/include/
    • sudo cp /usr/src/comedi/include/linux/comedilib.h /usr/local/include/
    • sudo ln -s /usr/local/include/comedi.h /usr/local/include/linux/comedi.h
    • sudo ln -s /usr/local/include/comedilib.h /usr/local/include/linux/comedilib.h
  • Enter RTAI compiling options:
    • cd /usr/src/rtai
    • sudo make menuconfig
  • Under Addons, select ‘Real Time COMEDI support in user space’ (by pressing spacebar).
  • Under RTAI Lab, select ‘RTAI Lab’.
  • Exit and save configuration.
  • Install RTAI:
    • sudo make
    • sudo make install
    • sudo cp /usr/src/comedilib/include/comedilib.h /usr/local/include/
  • Navigate with your web browser to and find your DAQ hardware in the list; take note of name under “Driver” column.
  • Edit rtailab startup file with driver for your DAQ board:
    • sudo gedit /etc/init.d/rtailab
  • Replace driver on lines 33 and 55 with the one you found on Comedi website. Save and close.
  • Reboot system.

Step 6 - Scicoslab Installation
  • Navigate with File Browser to /usr/src/scicoslab
  • Right-click on ‘scicoslab.deb’ and select ‘Open with GDebi’.
  • Install package.
  • Repeat for ‘tkdnd1_1.0-1_i386.lucid.deb’.
  • Add RTAI toolbox and palette to Scicoslab:
    • sudo ln -s /usr/realtime/bin/rtai-config /usr/local/bin
    • cd /usr/src/rtai/rtai-lab/scicoslab/macros/
    • sudo make install
    • make user
  • Navigate with File browser to /usr/lib and check scicoslab-gtk folder name. Then make symbolic link accordingly:
    • cd /usr/local/bin
    • sudo ln -s /usr/lib/scicoslab-gtk-4.x/bin/scilab scilab
  • Start Scicoslab as root and check the presence of toolboxes->RTAI in the upper menu:
    • sudo scicoslab

Step 7 - QRTAILab Installation
  • Install QRTAILab:
    • cd /usr/src/qrtailab/qrtailab
    • sudo qmake-qt4
    • sudo make
    • sudo make install

Step 8 - RTAI-XML Installation
  • Install RTAI-XML (pay attention to terminal outputs, you’ll get useful informations on how to use it):
    • cd /usr/src/rtaixml
    • sudo make all
    • sudo make install
  • Set RTAI-XML modules to be loaded at system startup:
    • sudo cp /usr/src/boot/rtaixml /etc/init.d/
    • sudo chmod a+x /etc/init.d/rtaixml
    • sudo update-rc.d rtaixml defaults
  • Start RTAI-XML modules:
    • sudo /etc/init.d/rtaixml start

Step 9 - Set up jRTAI-Lab for remote control
  • The following instructions are for Ubuntu 10.04, though you can easily run jRTAI-Lab on any OS that supports Sun Java Virtual Machine 6.
  • Install JVM6:
    • sudo add-apt-repository "deb lucid partner"
    • sudo apt-get update
    • sudo apt-get install sun-java6-jre
  • Allow execution of jRTAI-Lab and run it:
    • sudo chmod a+x /usr/src/jrtailab/jRtaiLab.jar
    • java -jar /usr/src/jrtailab/jRtaiLab.jar

Congratulations, you’re done!