AMD SimNow

These are the steps I use to download, install, and use the AMD SimNow simulator. You may not want to do exactly what I did, but it should get you started. There is PDF documentation that you can download on the same page as the simulator.

Build a ROM image for SimNow (Skip this step if you have your own Bios you want to use)

1. install Intel's ASL iasl tool
2. svn co svn://coreboot.org/buildrom/
3. cd buildrom/buildrom-devel/
4. make menuconfig
   1. Choose Platform Configuration
      1. Vendor AMD
      2. Platform Target AMD Serengeti-Cheetah
      3. Select Build for SimNow emulator
   2. Choose Payload Configuration
      1. Desired Payload Linux-As-Bootloader
      2. Desired Target Architecture 64-bit
      3. LAB Configuration
         1. Select Busybox but not reduced-size kexec tools
   3. Save and Exit
5. make
6. Enjoy your amd_serengeti_cheetah.rom file

Download SimNow

1. Download SimNow from AMD's website
   1. Create an account
   2. Accept the license agreement
   3. Log in.
2. Untar the .tar.gz file you download in a convenient place (You'll now have a directory called simnow-linux64-4.4.1pub)

Run SimNow

1. Run ./simnow from the simnow-linux64-4.4.1pub directory
2. Inside the SimNow Main Window do File->Open BSD, browse to the simnow-linux64-4.4.1pub/bsds directory and load either cheetah_1p.bsd or cheetah_1pjh.bsd (jh is dual-core)

   Now you have a single Opteron socket motherboard with an AMD-8132 PCI-X controller, an AMD-8111 I/O hub, and a Winbond W83627HF SuperIO.

3. Copy your coreboot ROM image to simnow-linux64-4.4.1pub/Images for convenience.
4. Open the SimNow Device Window (View->Show Devices)
5. Double click on Memory Device #5 (Your BIOS chip)
6. Click on the Memory Configuration Tab, and change the Base Address, Size, and File (I use Base Address = fff00000 and Size = 32 because I use a 1 MB image)
7. Go to the main simulator window and hit Run Simulation (Play button)
   1. You will get this error:

"BIOS ROM file is the wrong size for this BSD.  Please either point the memdevice to the correct BIOS ROM file, or configure the memdevice to be the correct size." 

Repeat the last few steps to set the size and try again. This happens whenever you increase the BIOS size.

Serial Port Configuration

In order to see the console output, go to the terminal you are running ./simnow in. Hit enter. You'll see a simnow> prompt.

1. Type serial.SetCommPort pipe and hit enter.
2. Type serial.GetCommPort and hit enter.

On my machine this returns path (/home/myles/.simnow/com1), mode (PIPE)

Open a new terminal and type cat /home/myles/.simnow/com1/simnow_out If you need to send input to the serial port, echo to /home/myles/.simnow/com1/simnow_in

Using the snserial tool

Alternatively, you can use a tool called 'snserial' to interact with the serial ports. snserial will combine the input and output, and provide access to the combined stream through either a psuedo tty, or a telenet port.

1. Download the snserial tool from http://coreboot.org/~jcrouse/snserial-1.0.tar.gz.
2. Extract it: tar -zxvf snserial-1.0.tar.gz
3. Build it: cd snserial/; make

Before running the tool, make sure that you have enabled the serial pipes as detailed above.

To enable serial through a pseudo TTY, start your simulation and type ./snserial comX in another Linux terminal window (where X is 1 or 2). The program will respond with:

SimNow Serial pipe Muxer

Connection established.
Type 'target remote /dev/pts/2' in GDB to connect.
(Press CTRL-C to exit)

You can now connect your serial application (minicom, or GDB for debugging) to the specified pseudo-tty.

To enable serial interaction through telnet, start the simulation and type ./snserial -t comX. The program will respond with:

SimNow Serial pipe Muxer

COM 1: Listening on port 9000
(Press CTRL-C to exit)

You can now connect to the serial stream by typing 'telnet localhost 9000' in a Linux terminal window.

Note: It is a quirk of SimNow that the pipes are not created until the simulation for the BSD is started for the first time. Make sure you start the simulation before running snserial, otherwise you will see this: Couldn't stat /home/<user>/.simnow/com1/simnow_out: No such file or directory. The best course of action is to start the simulation quickly, attach the snserial program, and then restart the simulation to see the early serial output.

Add disks

1. Hit the Stop Simulation button if the simulation is running
   1. File->Set IDE Primary Master Image
      1. Browse to your hard drive image
   2. File->Set IDE Secondary Master Image
      1. Browse to a CD .iso
2. Hit Run Simulation again

You should get output from the serial port scrolling in one terminal, and be able to watch the VGA output in the main window.

If you used buildrom to get a BIOS image with coreboot + LAB, you'll end up at a linux prompt where you can mount the disks, etc.