Makefile

Make Arguments

<texit>\index{Make}</texit> Whenever you are in a sub-directory of the software-radio, you can give some arguments to the make command. There are arguments that may be used everywhere in the tree, some that are only valid in the Radios/* subdirectories and some arguments that are only valid in the subdirectories that contain code.

Common

These arguments may be used anywhere in the tree (except the Tools-directory):

clean: Remove all object-files in all sub-trees <texit>\index{Make!whole}</texit>
whole: Re-compile the whole tree <texit>\index{Make!base}</texit>
base: Re-compile base only <texit>\index{Make!tools}</texit>
tools: Re-compile tools only <texit>\index{Make!modules}</texit>
modules: Re-compile modules only, additionally mod_coding, mod_data, mod_general, mod_macro, mod_signal re-compile only this special modules-directory <texit>\index{Make!show}</texit>
show: Starts the visualisation-tool <texit>\index{Make!server}</texit>
server: Start the channel-server <texit>\index{Make!kill}</texit>
kill: End all simulations as well as the channel-server <texit>\index{Make!cleanproc}</texit>
cleanproc: Remove all simulation-directories from /tmp <texit>\index{Make!rmall}</texit>
rmall: Unloads all real-time modules and stops RTLinux <texit>\index{Make!cvs_up}</texit>
cvs_up: Updates the whole SRadio/*-tree using CVS <texit>\index{Make!cvs_commit}</texit>
cvs_commit: Commits all changes to the SRadio/*-tree

Radios

Arguments that can be used in the subdirectories of Radios/

bsms: Starts channel-server and both BS and MS part. To stop, run make kill <texit>\index{Make!show_bsms}</texit>
show_bsms: Like bsms, but also runs the visualisation-tool <texit>\index{Make!wait_bsms}</texit>
wait_bsms: Like bsms, but stops the MS after 20 seconds and the BS after 30 seconds. Most useful to check whether a radio exits nicely, before trying it in real-time <texit>\index{Make!short_wait_bsms}</texit>
short_wait_bsms: Like wait_bsms but for the impatient: BS waits for 10 seconds, MS for 5 seconds. Attention: things might not be correctly initialised after 5 seconds! <texit>\index{Make!mc}</texit>
mc: Starts channel-server and both Server and Client part. To stop, run make kill <texit>\index{Make!show_mc}</texit>
show_mc: Like mc, but also runs the visualisation-tool <texit>\index{Make!wait_mc}</texit>
wait_mc: Like mc, but stops the Client after 20 seconds and the Server after 30 seconds. Most useful to check whether a radio exits nicely, before trying it in real-time <texit>\index{Make!short_wait_mc}</texit>
short_wait_mc: Like wait_mc but for the impatient: Server waits for 10 seconds, Client for 5 seconds. Attention: things might not be correctly initialised after 5 seconds!

Code

Useful arguments when you are developing code

user: Loads the modules defined in the Makefile for simulation and unloads them <texit>\index{Make!user_show}</texit>
user_show: Like user, but also starts the visualisation-tool <texit>\index{Make!user_wait}</texit>
user_wait: Like user, but doesn't unload the modules <texit>\index{Make!user_wait_5}</texit>
user_wait_5: Like user, but waits for 5 seconds before unloading <texit>\index{Make!user_wait_10}</texit>
user_wait_10: waits for 10 seconds before unloading <texit>\index{Make!user_wait_20}</texit>
user_wait_20: waits for 20 seconds before unloading <texit>\index{Make!user_wait_30}</texit>
user_wait_30: waits for 30 seconds before unloading <texit>\index{Make!user_wait_60}</texit>
user_wait_60: waits for 60 seconds before unloading <texit>\index{Make!ddd}</texit>
ddd: Start the graphical debugger in simulation-mode <texit>\index{Make!debug}</texit>
debug: Start gdb in simulation-mode <texit>\index{Make!rf}</texit>
rf: Starts the radio in real-time mode <texit>\index{Make!rf_tail}</texit>
rf_tail: Like rf but also tails /var/log/messages where PR_DBGs will be written to <texit>\index{Make!rf_show}</texit>
rf_show: Like rf_tail but launches the visualisation-tool <texit>\index{Make!rmall}</texit>
rmall: Unloads all modules from real-time mode