-
EGTAPI is
the acronym for
Emory's Graphical Tool for
Assembler Programming Instruction.
This graphical application was
specifically designed to
make learning assembler programming as
easy as
possible.
EGTAPI
is a graphical environment built on top of
gdb,
that incorporates features specially aimed to illustrate assembler
program execution.
EGTAPI is specially developed to run and debug ARM assembler programs in CS255.
EGTAPI that was originally created by the Graduate Student Bo Yang as his Master thesis project in 2002 under the direction of Professor Cheung. The original version works with Emacsim on the Solaris platform. In 2014, the tool was re-implemented to work with the new Emacsim on the Linux platform --- this 2014 version of EGTAPI can only run on the workstations in the MathCS lab.
In 2017, the MS student Bashan Zuo implemented a new EGTAPI as his MS project under direction of Prof. Cheung. The newest EGTAPI can run on any laptop (PC, Mac, Linux) and uses Java SSH tunnels to communicate with Emacsim (before this version, Emacsim must be run on a lab machine)
In summer of 2019, Bashan Zuo (who has graduated and become a technical staff in the CS department) worked with Prof. Cheung and implemented a new version of EGTAPI to support ARM assembler programming in the first offering of CS255 using ARM assembler code.
Obtaining a copy of EGTAPI for yourself:
-
You can download a copy of EGTAPI for your PC from this
website:
click here
Compiling your assembler program:
- You create an
assembler program using
a editor
(after you login to a lab machine using
MobaXterm (on Windows) or
ssh (on Mac)):
E.g.:
gedit fac.s
- A program that
consists of a single file
(e.g.: fac.s) can be
compiled with
EGTAPI
(by clicking on the
Compile button
in the "File Browser" menu).
You can also compile your program with this command through MobaXterm (on Windows) or ssh (on Mac):
as255 ProgName e.g.: as255 fac
- A program that
consists of
multiple program files
(e.g.: your projects such as pj3.s) can
be
compiled with
the as255 command
Example project 3:
as255 pj3 recursion (See project descriptions on how to compile each project)On EGTAPI, you must press the control-key while selecting the files. The first file you select will be used as the program for the output of the compilation.
Compiling your assembler program:
|
|
Starting the EGTAPI application:
-
To start
the EGTAPI
when you are working on a lab machine,
execute the following command:
/home/cs255001/bin/egtapi
-
If you run EGTAPI
on your PC,
just click on the
EGTAPI icon
on your PC
(but you will need to
download and install
EGTAPI on your PC from this
website first:
click here )
- In both cases, you will see the following
startup window:
