Account Setup
The instructions below setup your Linux account for EE 7700-X, Graphics
Processors.
If one of the steps below does not work as described it's possible that the step was performed correctly but the machine does not have the necessary software or is otherwise misconfigured. Please report this problem but also try another machine.
If one of the steps below does not work as described it's possible that the step was performed correctly but the machine does not have the necessary software or is otherwise misconfigured. Please report this problem but also try another machine.
- Locate a Linux machine in the ECE workstation laboratory, Room
126 EE Building.
It's possible to perform some or all steps remotely if you have an X-server on your machine. If you have no idea what an X-server is, just find the lab.
- Log into a Linux machine with your class account.
A Gnome graphical desktop should appear.
- Start a shell (command-line interpretor). One way to do
this is to right-click the desktop and select "Open Terminal".
A window with "Terminal" in the title should appear with a Unix prompt.
- Test for availability of the SVN client
The output should look something like sample shown below. Make sure the output includes "handles 'https' scheme.
svn --version
svn, version 1.4.2 (r22196) compiled Nov 20 2006, 07:17:37 Copyright (C) 2000-2006 CollabNet. Subversion is open source software, see http://subversion.tigris.org/ This product includes software developed by CollabNet (http://www.Collab.Net/). The following repository access (RA) modules are available: * ra_dav : Module for accessing a repository via WebDAV (DeltaV) protocol. - handles 'http' scheme - handles 'https' scheme * ra_svn : Module for accessing a repository using the svn network protocol. - handles 'svn' scheme * ra_local : Module for accessing a repository on local disk. - handles 'file' scheme
For background on svn, which is used in these instructions, see this ECE Wiki page. - Check out the Emacs files from the class SVN repository.
cd ~ svn co https://svn.ece.lsu.edu/svn/gp/lisp
.emacs asm-class.el gpu-settings.el popular-settings.el
The svn "co" (checkout) command copied files from the svn server to your account in a directory named "~/lisp". SVN will also be used to check out files for homework assignments. - Link the .emacs file, or update your own.
cd ~ ln -s ./lisp/.emacs
The ".emacs" file contains preferences for the Emacs text editor and also settings needed to complete some of the assignments. If you have your own .emacs file or want to start adding stuff to the one provided see the .emacs file in the lisp directory for instructions and if necessary, find and read documentation on the symbolic link command "ln -s". - Check out the classroom examples code and test.
cd ~ svn co https://svn.ece.lsu.edu/svn/gp/cpu-only
Makefile coord.h demo-1-one-triangle.cc demo-2-many-triangles.cc demo-3-color-and-z-buffering.cc demo-4-lighting.cc frame_buffer.h simple.cc
The cpu-only examples should be copied to your account in directory ~/cpu-only.cd ~/cpu-only demo-3-color-and-z-buffering
The commands above run demo-3-color-and-z-buffering. If successful, a window should appear showing something like the image to the right.
There is no exit command, use the
Close Window control (the button on the upper right on most themes) to
end the program. - Make sure graphics code can compile. First, delete
demo-3-color-and-z-buffering and try to run it (just to make sure it
was deleted.)
cd ~/cpu-only rm demo-3-color-and-z-buffering demo-3-color-and-z-buffering
demo-3-color-and-z-buffering: Command not found.
After issuing the "rm" command above the system might ask for confirmation, if so respond yes. Note that in the step above demo-3-color-and-z-buffering is not supposed to run. - Next, build (using the make program) and see whether
demo-3-color-and-z-buffering has been re-created and works.
Part of the output is shown below. Make sure there are no errors; one or two warnings are okay.
make demo-3-color-and-z-buffering
g++ -Wall -g -O3 -fverbose-asm -S demo-1-one-triangle.cc g++ -Wall -g -O3 -c demo-1-one-triangle.s g++ -Wall -g -O3 -o demo-1-one-triangle demo-1-one-triangle.o -lX11 -lXi -lglut -lGL -lGLU -lm -lpthread -lrt
Possible errors (which indicate a problem with the account setup) include things like "error: GL/freeglut.h: No such file or directory" and "/usr/bin/ld: cannot find -lglut". - If the step above worked then skip this step. Otherwise, let Dr. Koppelman know which machine encountered the problem and what when wrong. If the problem is with the machine then the name of the machine (something like crash.ece.lsu.edu) should be sufficient. If the cause is specific to the account then note the error message and if possible E-mail the output of make. One easy way to do this is to start a browser and use it to send mail (via Pawse or your favorite Web mail).
- If the build seems to have worked, try running the program again.
demo-3-color-and-z-buffering
Once again a window showing the road should pop up. - At this point the account has been setup. The next step is probably to checkout the homework assignment and follow its instructions.
