In order to make use of the CS 273 software, you need to make some changes to your environment. Here's what you have to do, and what software is available.
First, some background. On Unix systems, the way to make a file
"hidden" is to use a period as the first character of the file
name. The ls
command won't list such a file (this can be
overridden with the -a
option, as in
ls -a
). The purpose of this is so you can have
configuration files in your home directory, and not clutter up your
directory listings with them. Traditionally, these files are called
"dot files" since a period looks like a dot.
The most important dot file is .cshrc
. This is a shell
script that is executed whenever you do anything that creates a new
command interpreter (Unix terminology for a command interpreter is a
shell), like logging in or opening a new window. It is in
your home directory, so, if your login name is "rpetty" it'll be
called /user/rpetty/.cshrc
In the cs.nmsu.edu domain, most installed software is divided into
packages in a directory called /local
. The way you get
access to these packages is by putting lines in your
.cshrc
file of the form
source /local/cshrc.packagename
.
As an example, here's a portion of my .cshrc
file:
source /local/config/cshrc.acroread source /local/config/cshrc.cvs source /local/config/cshrc.emacs source /local/config/cshrc.gcc
These lines give me access to the Adobe acrobat reader, to the CVS
revision control system, to Gnu emacs, and to the Gnu Compiler
Collection (incidentally, my .cshrc
isn't read-protected,
so you can go ahead and look at it if you're curious).
In order to get access to the CS273 software, you need to add the
following line to your .cshrc
file:
source /home/CS273/cshrc.273
(notice that this isn't in /local
!) The changes will
take effect the next time you login.
This will give you access to three pieces of software needed for the class:
as11
tksim11
gdl
This document describes how to obtain, compile, and install the
as11
assembler and sim6811
and
tksim11
simulators. It does not include the
gdl
downloader, since (1) gdl
requires a
pretty complete Gnome development environment including gnomemm and
gtkextramm, and (2) comparitively few students will need it, as you
won't ordinarily be debugging software for the board itself at home.
However, the current version of gdl
is available at
http://www.cs.nmsu.edu/~pfeiffer/gdl-0.7.1.tar.gz
These tools are only available as source code. You'll need to download the "tarball," compile it, and install it, as follows.
Unpack configure, compile, and install the software.
% tar xvzf cs273tools-1.1.0.tar.gz
% cd cs273tools-1.1.0
% ./configure
% make
# make install
Notes on the commands:
tar xvzf cs273tools-1.0.2.tar.gz
cs273tools
cd cs273tools-1.0.2
cs273tools-1.0.2
./configure
./configure --help
will tell you about them);
probably the most important one is that if you don't want to
install the software in the default location you should run
it as
./configure --prefix=somedirectory
As the command inspects your system, it will print a large
number of messages describing what it's found. If it needs
something on your system that turns out not to be there, it
will stop, and you'll need to install the missing software.
If you let me know about problems, I'll do what I can to try
to help you track it down.
make
make install