Help for CS 2340 (Computer Organization) tools

• Lyle Genuse Unix/Linux Account
• Introduction to Unix
• Verilog - Cadence Xcelium Tutorial

Lyle Genuse Unix/Linux Account

Many of the software tools used in this course will be run on the Lyle servers. Therefore, in order to use these tools, you will need to set up a Lyle Genuse account. Note that it may take up to 48 hours for a new account to be activated, so plan accordingly.

Information on how to set up a new account can be found at https://www.smu.edu/OIT/Services/genuse.

Please note: effective Summer 2024, if you are using an off-campus network (e.g., home network), you will need to use a VPN connection to access your Genuse account. Please see the main Genuse web page for details.

The servers are called "genuse" (General Use) machines. The list of machines can be found at https://www.smu.edu/oit/services/genuse/computers.

Console Window to Access Your Lyle Genuse Account

The PuTTY terminal program will give you a console window so that you can access your Lyle Genuse account. Please see the link PuTTY Home

• For Windows, please see the link PuTTY - Secure Download
• For MacOS, please see the link PuTTY client for MAC OSX

Using PuTTY to log into your Lyle Genuse account

• For Windows, please see the link Running PuTTY and connecting to a server
• For MacOS, please see the link Running SSH with a graphical user interface

For either case, you will be asked for a host name to connect to the server. Since you will be connecting to a Genuse server, you will want to enter a server name from the list of Genuse machines (e.g., genuse50.smu.edu ).

When the console window appears, you will be prompted for your Genuse username (login as) and password. If entered correctly, you will now be in your Lyle Genuse account.

Transferring files between your Lyle Genuse account and your PC

There are programs to securely transfer your files between your Genuse account and your PC.

• For Windows, a recommended file transfer program is WinSCP. Help for using this program can be found at Guides to Using WinSCP
• For MacOS, a recommended file transfer program is Cyberduck. Help for using this program can be found at Connecting and Transferring Files with Cyberduck

For either program, you will want to connect to a Genuse server (same as for PuTTY)

Introduction to Unix

Your Genuse account uses the Unix operating system. The following link provides a good introduction to Unix: UNIX Tutorial for Beginners.

Editing files in Unix: Nano editor

A simple Unix text editor is nano. Please see the following link: Introduction to the nano Text Editor

Java Code: Compiling and Running in Unix

Java programs can be compiled and run in Unix. Please see the simple "Hello, world" Java code example hello.java. Note that this program contains the class "HelloWorld".

• To compile this code, use the command javac hello.java. This will create the file "HelloWorld.class".
• To run this program after it has been compiled, use the command java HelloWorld. Note that you are running the compiled "class" file.

Verilog - Cadence Xcelium Tutorial

Verilog is a hardware description language (HDL) for developing and modeling digital logic circuits. The Cadence Xcelium tool will help you simulate circuits that have been developed in Verilog. The Xcelium tool is available in Genuse, so you will login to your Genuse account to use this tool.

For most digital logic circuits, there are two main Verilog files that are needed:

1. Verilog module that contains your digital logic circuit
2. Verilog test bench that tests the digital logic circuit in your Verilog module (to verify correct operation)

For our tutorial, we have a Verilog module and test bench for the following digital logic circuit:

Use the following files for this tutorial:

• Logic1.v Verilog file that implements the digital logic circuit shown in the figure above
• Logic1_tb.v Testbench file to test the digital logic circuit

To run the Verilog program using these files, use the command: xmverilog Logic1.v Logic1_tb.v

The program will print the results on the console. The results will also be written to the xmverilog.log file.

For more details on the Verilog language, please see the following tutorial