In this chapter you'll learn how to set-up your computer so as to be able to run the MSR in simulation mode. If you want to work with the MSR, you should read this chapter. First you have to make sure that all necessary software is installed on your system, then you have to download the necessary package, compile it, and finally you can run the example.
The MSR runs without problems on a linux-system. For the simulation-part, an installation of the RTLinux is not necessary. The MSR relies on some new packages, like a new linker and a QT-package. These should be available with RH7.3 and newer, Mandrake 8.2 and newer as well as Debian 3/testing and newer. The most common missing programs are:
It is possible to use the MSR without the proper RF-hardware. For this you will use a channel-simulation. In this section you learn how to download and compile the MSR.
From http://lcmpc10.epfl.ch/Menu/Download you can download the latest version of the MSR, which has a name like msr-*.tgz Once it is on your computer, you can place it in a convenient directory and untar it using tar xzf msr-*tgz This will create a directory named Main and a lots of subdirectories and files in there. Generally you will find README files in most of the directories. They are useful if you need to know what goes on in this special place. Do not hesitate to read them.
The software consists of two parts: the graphic display and the signal-processing modules. For the graphical part, you have to change into Main/Tools/Visualize and run qmake visualize.pro followed by a make. If everything goes well, you should have an executable called visualize.
After this you can change in the Main directory and run make there. Supposing that everything goes well, you're ready to run the examples.
Make sure that libqwt is installed and check eventually the path in visualize.pro.
There are a couple of pre-defined radios in the subdirectory Radios/. The most simple is in Radios/Simple/. Using the following commands, you can display both the BS and the MS of this simple example:
You can also run the other examples that you find in this directory, namely Multiuser and LDPC just to get an idea what the software-radio is all about. And remember: the same c-code also runs in real-time on RF-hardware!
Linus Gasser 2004-04-14