![[LWN Logo]](/images/lwn.banner.gif)
Date: Thu, 11 Nov 1999 16:16:57 -0800
From: Phil Wilshire <philwil@on-ramp.ior.com>
To: "rtl@rtlinux.cs.nmt.edu" <rtl@rtlinux.cs.nmt.edu>
Subject: [rtl] Version RTL 2.0 Install guide
PLease use / read / comment
Installing RT Linux...
NMT RTLinux
This guide is free; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
(C) Phil Wilshire 1999
The steps are...
============================================================================
1 ... unpack the kit
============================================================================
The steps I use are :
1.1 get a clean kernel from ftp.us.kernel.org
1.2 get the patch file FOR THAT KERNEL.
1.3 move your current copy of /usr/src/linux ( if it is not a link ) to
/usr/src/oldlinux
check with
ls -l /usr/src
links look like this
ls -l /usr/src/linux
lrwxrwxrwx 1 root root 17 Aug 17 1998 /usr/src/linux ->
va-linux-2.0.34-1
( in this case just delete the link and do the untar )
If you have to move a tree do
cd /usr/src
mv linux oldlinux
1.4 Create a working directory .. I use /opt/rtl
mkdir /opt/rtl
You may need to do this as root .
loosen up restrictions on the new directory
chmod a+rw /opt/rtl
This will allow you as a user to access this.
NOTE: do most of your work as a regular user .. it's safer.
1.5 Untar the RTLinux tarball into /opt/rtl
ie if the tarball is in /home/wilshire/download/rtl/rtlinux-2.0.tgz
cd /opt/rtl
tar xvzf /home/wilshire/download/rtl/rtlinux-2.0.tgz
This will create
/opt/rtl/rtlinux-2.0
1.6 Look in the INSTALL file and follow the instructions.
for example
********************INSTALL******************************
1. put a fresh copy of Linux 2.2.13 in this directory under the name
"linux.
2. cd linux
patch -p1 < ../kernel_patch
***********************************************************
This means take the linux-2.2.13.tar.gz tarball and put it where the
install guide suggests.
ie if the tarball is in
/home/wilshire/download/linux/linux-2.2.13.tar.gz
cd /opt/rtl/rtlinux-2.0
tar xvzf /home/wilshire/download/linux/linux-2.2.13.tar.gz
============================================================================
2.0 Patch the Kernel
============================================================================
2.1 Run the patch
Now you can patch.
cd /opt/rtl/rtlinux-2.0/linux
patch -p1 < ../kernel_patch
2.2 Check for Rejects
There should be no none nada rejects.
Here is an example of a reject ...
--------------------------
Patching file arch/i386/kernel/irq.c using Plan A...
Hunk #1 failed at 39.
Hunk #2 succeeded at 236.
Hunk #3 succeeded at 280.
Hunk #21 succeeded at 1324.
1 out of 21 hunks failed--saving rejects to arch/i386/kernel/irq.c.rej
----------------------------------
You find any rejects like this
cd /opt/rtl/rtlinux-2.0/linux
find ./ -name *.rej
./arch/i386/kernel/irq.c.rej
You can only patch once ( well sort of ) so start again if you trip up.
cleanup
cd /opt/rtl/rtlinux-2.0/
rm -rf linux
tar xvzf /home/wilshire/download/linux/linux-2.2.13.tar.gz
============================================================================
3.0 Configure and compile the Kernel
============================================================================
3.1 look at what's running
Now we need to configure and compile the patched kernel.
First we need to look at what's running.
[wilshire@pasrack3 linux]$ /sbin/lsmod
Module Size Used by
3c59x 18952 1
Then we need to configure our new kernel.
We see the modules used and make sure that we
configure the new kernel for the same ones.
now type
3.2 Configure the kernel
cd /opt/rtl/rtlinux-2.0/linux
make menuconfig
and check options as required
Code maturity level options ---> yes
Processor type and features --->
(PPro/6x86MX) Processor family
[*] Symmetric multi-processing support
[*] Hard realtime support
Loadable module support --->
[*] Enable loadable module support
[ ] Set version information on all symbols for modules
[ ] Kernel module loader
General setup ---> accept defaults
Plug and Play support ---> accept defaults
Plug and Play support ---> accept defaults
Networking options ---> accept defaults
SCSI support ---> accept defaults
Network device support --->
Ethernet (10 or 100Mbit) --->
[*] 3COM cards
<M> 3c590/3c900 series (592/595/597) "Vortex/Boomerang" support
( in this case )
and finally
Kernel hacking --->
[*] Magic SysRq key
( this may come in handy )
Right having done all this ...
save the configuration
build the kernel
3.4 Compile the kernel
[wilshire@pasrack3 linux]$ make dep; make clean; make bzImage
go for a cup of tea , read your mail, write a manual ....10 minutes or
so.
You will end up with a new Kernel a new Symbol.map etc.
BEFORE you do anything else... set your system up to use this new kernel
go to root
su
3.5 Make/ Install the modules
make the modules
make modules; make modules_install
watch the result here
[root@pasrack3 linux]# make modules_install
Installing modules under /lib/modules/2.2.13-RTL2.0/net
Installing modules under /lib/modules/2.2.13-RTL2.0/misc
the
/lib/modules/2.2.13-RTL2.0
shows you that just about every thing is well.
============================================================================
4.0 Set up boot / Lilo
============================================================================
copy the boot image to the right place
cp arch/i386/boot/bzImage /boot/bzImageRTL20
copy the Symbol.map to the right place
cp Symbol.map /boot/Symbol.mapRTL20
make the new symbol.map " active"
rm /boot/Symbol.map
ln -s /boot/Symbol.mapRTL20 /boot/Symbol.map
edit /etc/lilo.conf
It should look like ...
=======================================================
boot=/dev/hda
map=/boot/map
install=/boot/boot.b
prompt
timeout=50
image=/boot/bzImageRTL20
label=linuxRTL20
root=/dev/hda1
append="mem=126M"
read-only
image=/boot/bzImage
label=linux
root=/dev/hda1
append="mem=126M"
read-only
======================================================
#<keep another around just in case >
Run Lilo
[root@pasrack3 linux]# /sbin/lilo
Added linuxRTL20 *
Added linux
============================================================================
5.0 Boot
============================================================================
Now is the time to reboot
Having rebooted we need to move the linux source link to our new source
tree.
rm /usr/src/linux
ln -s /opt/rtl/rtlinux-2.0/linux /usr/src/linux
============================================================================
6.0 Make the Modules
============================================================================
Now we can make the rtl modules
Check and adjust the date
[root@pasrack3 rtl]# date
Wed Nov 10 23:14:18 PST 1999
[root@pasrack3 rtl]# date 11111452
Thu Nov 11 14:52:00 PST 1999
cd /opt/rtl/rtlinux-2.0/rtl
make
....
Now you need to become root and do "make install"
[root@pasrack3 rtl]# make install
Testing for the mbuff device... mknod /dev/mbuff c 10 254
Testing for FIFOs... already existent.
Instaling modules in /lib/modules/2.2.13-RTL2.0/misc
/sbin/depmod -a
Installing man pages to /usr/local/man
Installing header /usr/include/rtlinux
install -c -m 644 rtl.mk /usr/include/rtlinux;
=======================set up your path============================
try lsmod
if you get
[root@pasrack3 fp]# lsmod
bash: lsmod: command not found
do this
export PATH=/sbin:/$PATH
then try again
[root@pasrack3 fp]# lsmod
Module Size Used by
3c59x 19176 1
=====================================================================
That's it for the main install..
============================================================================
7.0 Run the examples
============================================================================
Now for the examples
Grrrh I sent a load of patches to RTL they did not all make the cut..
=========================fp=====================================
cd examples
cd fp
make
mv rt_process.o fp_tasks.o
cd ../../; ./insrtl
cd examples/fp
make test
[root@pasrack3 fp]# make test
insmod fp_tasks.o
./fptest
[root@pasrack3 fp]# lsmod
Module Size Used by
fp_tasks 892 0 (unused)
rtl_fifo 5944 0 (unused)
rtl_posixio 6952 0 [rtl_fifo]
rtl_sched 35364 0 [fp_tasks rtl_posixio]
rtl_time 8424 0 [fp_tasks rtl_sched]
3c59x 19176 1
[root@pasrack3 fp]# rmmod fp_tasks
=====================================================================
[root@pasrack3 examples]# cd ../frank
[root@pasrack3 frank]# make
[root@pasrack3 frank]# make test
.....
FIFO 2: Zappa
FIFO 1: Frank
FIFO 2: Zappa
FIFO 2: Zappa
FIFO 2: Zappa
FIFO 1: Frank
frank_app: now sending commands to stop RT-tasks
This all works
=============================================================================
[root@pasrack3 frank]# cd ../hello
[root@pasrack3 hello]# make
[root@pasrack3 hello]# make test
This is the simplest RTL program
First we remove any existing rtl-modules
You may see error warnings from "make" - ignore them
Type <return> to continue
rmmod sound
rmmod: module sound not loaded
make: [test] Error 1 (ignored)
rmmod rt_process
rmmod: module rt_process not loaded
make: [test] Error 1 (ignored)
rmmod frank_module
rmmod: module frank_module not loaded
make: [test] Error 1 (ignored)
(cd ../../; ./rmrtl)
Now insert the fifo and scheduler
Type <return> to continue
(cd ../../; ./insrtl)
Now start the real-time tasks module
Type <return> to continue
Now let's stop the application
Type <return> to finish
[root@pasrack3 hello]#
=========================look on the console to see any
messages=========
cd ../measurements
make
make test
^C
min: 9152, max: 17632
make: *** [test] Interrupt
[root@pasrack3 measurements]#
to look at some stuff try this
./monitor > m.out&
sleep(25)
./histplot m.out m.res
cat m.res
=====================================================================
That's enough for the examples....
=====================================================================
Example Reboot Problem.
I'm running RedHat and my ehternet card
doesn't work now...
Solution #1
something to do with
cat /proc/version >/lib/modules/2.2.13-RTL2.0/.rhkmvtag
but this still does not work. I am working on it.
So
Solution #2
add
# load up eth0
/sbin/modprobe eth0
to /etc/rc.d/rc.sysinit
near the end
Hope this helps
Phil Wilshire
--- [rtl] ---
To unsubscribe:
echo "unsubscribe rtl" | mail majordomo@rtlinux.cs.nmt.edu OR
echo "unsubscribe rtl <Your_email>" | mail majordomo@rtlinux.cs.nmt.edu
----
For more information on Real-Time Linux see:
http://www.rtlinux.org/~rtlinux/