Simulate Amber on Mac OS

The Amber processor core is an ARM-compatible 32-bit RISC processor. The Amber core is fully compatible with the ARM® v2a instruction set architecture (ISA) and is therefore supported by the GNU toolset.
I would like to try run on my Mac Mini, so, I install Armber, tools and do some modification…

1. Download the Amber project from the Opencores Subversion server

$ mkdir ~/AmberInstallPath
$ cd ~/AmberInstallPath
$ svn --username YOUR_NAME -password PASSWORD co http://opencores.org/ocsvn/amber/amber/trunk

2. Install the GNU cross compiler

$ sudo port install arm-none-linux-gnueabi-gcc
$ sudo port install gawk
$ cd /opt/local/bin
$ sudo ln -s gawk awk
$ sudo ln -s arm-none-linux-gnueabi-gcc-2005q3 arm-none-linux-gnueabi-gcc

3. Install Icarus Verilog Simulator

$ sudo port install iverilog

4. Edit ~/.profile and add the following

$ export AMBER_BASE=~/AmberInstallPath/trunk
$ export AMBER_CROSSTOOL=arm-none-linux-gnueabi

5. Make scripts executable and create a run link

$ cd $AMBER_BASE
$ chmod +x hw/tools/*.sh sw/tools/*.sh
$ ln -s ../tools/run.sh hw/sim/run

6. Create $AMBER_BASE/hw/tools/runIV.patch by following

--- run.sh	2011-04-29 08:47:23.000000000 +0800
+++ runIV.sh	2011-04-29 09:14:21.000000000 +0800
@@ -46,12 +46,9 @@
 AMBER_LOAD_MAIN_MEM=" "
 AMBER_TIMEOUT=0
 AMBER_LOG_FILE="tests.log"
-SET_G=0
 SET_M=0
 SET_D=0
 SET_T=0
-SET_S=0
-SET_V=0
 SET_A=0
 SET_5=0

@@ -59,14 +56,11 @@ SET_5=0
 # show program usage
 show_usage() {
     echo "Usage:"
-    echo "run  [-a] [-g] [-d] [-t] [-s] [-v]"
+    echo "run  [-a] [-d] [-t]"
     echo " -h : Help"
     echo " -a : Run hardware tests (all tests in $AMBER_BASE/hw/tests)"
-    echo " -g : Use Modelsim GUI"
     echo " -d : Create vcd file"
     echo " -t : Create vcd file and terminate"
-    echo " -s : Use Xilinx Spatran6 Libraries (slower sim)"
-    echo " -v : Use Xilinx Virtex6 Libraries (slower sim)"
     echo " -5 : Use Amber25 core instead of Amber23 core"
     echo ""
     exit
@@ -103,14 +97,8 @@ do
             case $1 in
                 -a)     SET_A=1   # all tests
                         shift ;;
-                -s)     SET_S=1   # Xilinx libs
-                        shift ;;
-                -v)     SET_V=1   # Xilinx libs
-                        shift ;;
                 -5)     SET_5=1   # Xilinx libs
                         shift ;;
-                -g)     SET_G=1   # Bring up GUI
-                        shift ;;
                 -d)     SET_D=1
                         DUMP_START=$2
                         shift 2;;
@@ -135,24 +123,7 @@ done
 # Set comfiguration based on command-line options
 #--------------------------------------------------------

-if [ $SET_G == 1 ]; then
-    RUN_OPTIONS="-do cmd.do"
-else    
-    RUN_OPTIONS="${RUN_OPTIONS} -c -do run.do"
-fi
-
-if [ $SET_S == 1 ]; then
-    FPGA="+define+XILINX_SPARTAN6_FPGA +define+XILINX_FPGA"
-    RUN_OPTIONS="${RUN_OPTIONS} -t ps  +notimingchecks -L unisims_ver -L secureip"
-else    
-    if [ $SET_V == 1 ]; then
-        FPGA="+define+XILINX_VIRTEX6_FPGA +define+XILINX_FPGA"
-        RUN_OPTIONS="${RUN_OPTIONS} -t ps  +notimingchecks"
-    else    
-        FPGA=" "
-    fi
-fi
-
+RUN_OPTIONS="-f iverilog.f"

 if [ $SET_D == 1 ]; then
     AMBER_DUMP_VCD="+define+AMBER_DUMP_VCD +define+AMBER_DUMP_START=$DUMP_START"
@@ -173,13 +144,8 @@ else    
 fi

 if [ $SET_A == 1 ]; then
-    if [ $SET_S == 1 ]; then
-        TECH="-s"
-    elif [ $SET_V == 1 ]; then
-        TECH="-v"
-    else    
-        TECH=" "
-    fi        
+
+    TECH=" "

     if [ $SET_5 == 1 ]; then
         CORE="-5"
@@ -273,54 +239,42 @@ fi

 #--------------------------------------------------------
-# Modelsim
+# iVerilog
 #--------------------------------------------------------
-if [ $MAKE_STATUS == 0 ]; then
-   if [ ! -d work ]; then
-       vlib work
-   fi
-
-   if [ $? == 0 ]; then
-       vlog +libext+.v 
-            +incdir+../vlog/amber23+../vlog/amber25+../vlog/system+../vlog/tb+../vlog/ethmac 
-            +incdir+../vlog/lib+../vlog/xs6_ddr3+../vlog/xv6_ddr3 
-            -y ../vlog/amber23 -y ../vlog/amber25 -y ../vlog/system  -y ../vlog/tb -y ../vlog/ethmac 
-            -y ../vlog/lib   -y ../vlog/xs6_ddr3 -y ../vlog/xv6_ddr3  
-            -y $XILINX/verilog/src/unisims 
-            -y $XILINX/verilog/src 
-            ../vlog/tb/tb.v 
-            $XILINX/verilog/src/glbl.v 
-            +define+BOOT_MEM_FILE="$BOOT_MEM_FILE" 
-            +define+BOOT_MEM_PARAMS_FILE="$BOOT_MEM_PARAMS_FILE" 
-            +define+MAIN_MEM_FILE="$MAIN_MEM_FILE" 
-            +define+AMBER_LOG_FILE="$AMBER_LOG_FILE" 
-            +define+AMBER_TEST_NAME="$AMBER_TEST_NAME" 
-            +define+AMBER_SIM_CTRL=$TEST_TYPE 
-            +define+AMBER_TIMEOUT=$AMBER_TIMEOUT 
-            ${FPGA} 
-            $AMBER_CORE 
-            $AMBER_DUMP_VCD 
-            $AMBER_TERMINATE 
-            $AMBER_LOAD_MAIN_MEM
-                  
-        if [ $? == 0 ]; then
-            vsim -voptargs="+acc=rnpc" tb ${RUN_OPTIONS}
-            
-            # Set a timeout value for the test if it passed
-            if [ $TEST_TYPE == 1 ]; then
-                tail -1  /dev/null
-                if  [ $? == 0 ]; then
-                    TICKS=`tail -1 > $AMBER_LOG_FILE
-fi
+      echo "+libext+.v"                > iverilog.f
+      echo "+incdir+../vlog/amber23"  >> iverilog.f
+      echo "+incdir+../vlog/amber25"  >> iverilog.f
+      echo "+incdir+../vlog/system"   >> iverilog.f
+      echo "+incdir+../vlog/tb"       >> iverilog.f
+      echo "+incdir+../vlog/ethmac"   >> iverilog.f
+      echo "+incdir+../vlog/lib"      >> iverilog.f
+      echo "+incdir+../vlog/xs6_ddr3" >> iverilog.f
+      echo "+incdir+../vlog/xv6_ddr3" >> iverilog.f
+      echo "-y../vlog/amber23"        >> iverilog.f
+      echo "-y../vlog/amber25"        >> iverilog.f
+      echo "-y../vlog/system"         >> iverilog.f
+      echo "-y../vlog/tb"             >> iverilog.f
+      echo "-y../vlog/ethmac"         >> iverilog.f
+      echo "-y../vlog/lib"            >> iverilog.f
+      echo "-y../vlog/xs6_ddr3"       >> iverilog.f
+      echo "-y../vlog/xv6_ddr"        >> iverilog.f
+      echo "+define+BOOT_MEM_FILE="$BOOT_MEM_FILE""               >> iverilog.f
+      echo "+define+BOOT_MEM_PARAMS_FILE="$BOOT_MEM_PARAMS_FILE"" >> iverilog.f
+      echo "+define+MAIN_MEM_FILE="$MAIN_MEM_FILE""               >> iverilog.f
+      echo "+define+AMBER_LOG_FILE="$AMBER_LOG_FILE""             >> iverilog.f
+      echo "+define+AMBER_TEST_NAME="$AMBER_TEST_NAME""           >> iverilog.f
+      echo "+define+AMBER_SIM_CTRL=$TEST_TYPE"                      >> iverilog.f
+      echo "+define+AMBER_TIMEOUT=$AMBER_TIMEOUT"                   >> iverilog.f
+      echo "$AMBER_CORE"          >> iverilog.f
+      echo "$AMBER_DUMP_VCD"      >> iverilog.f
+      echo "$AMBER_TERMINATE"     >> iverilog.f
+      echo "$AMBER_LOAD_MAIN_MEM" >> iverilog.f
+      echo "../vlog/tb/tb.v"      >> iverilog.f
+
+      rm -rf ./armber
+      iverilog -f iverilog.f -o armber
+      ./armber

7. Create runIV script for iverilog simulator

$ cd $AMBER_BASE/hw/tools
$ patch -o runIV.sh -i runIV.patch
$ chmod +x runIV.sh
$ cd $AMBER_BASE/hw/sim
$ ln -s ../tools/runIV.sh runIV

8. If you see the iverilog compile error message for log2 function in next step, you could replace log2 by $clog2 to solve the problem.

9. Run a Hello-World Test with Amber 25

$ cd $AMBER_BASE/hw/sim
$ runIV -5 hello-world

10. Hello-World simulation Result

Amber Boot Loader v20110202130047
Hello, World!

----------------------------------------------------------------------------
Amber Core
       > User         FIRQ         IRQ          SVC
r0       0x00000010
r1       0x16000000
r2       0x00000000
r3       0x00000000
r4       0x0c80e403
r5       0x00000000
r6       0x00000000
r7       0x00000000
r8       0xdeadbeef   0xdeadbeef 
r9       0xdeadbeef   0xdeadbeef 
r10      0x00000011   0xdeadbeef 
r11      0xf0000000   0xdeadbeef 
r12      0x00000000   0xdeadbeef 
r13      0x08000000   0xdeadbeef   0xdeadbeef   0x01ffffb8
r14 (lr) 0x0080e420   0xdeadbeef   0xdeadbeef   0x20000787
r15 (pc) 0x0080e960

Status Bits: N=0, Z=1, C=1, V=0, IRQ Mask 0, FIRQ Mask 0, Mode = User          
----------------------------------------------------------------------------

++++++++++++++++++++
Passed hello-world 29320 ticks
++++++++++++++++++++