it's been a while

.gitignore

@@ -1,2 +1,19 @@
 *.vcd
 *.so
+
+# bluespec files
+*.bo
+*.ba
+
+# files generated from building/simulating core
+compile.log
+build_v
+verilog_RTL
+
+# generated experiment outputs
+experiments/bram/*.cxx
+experiments/bram/*.h
+experiments/bram/simBRAM
+
+*.o
+.vscode

Makefile

@@ -140,7 +140,7 @@ v_compile:
 	@echo Compiling for Verilog finished
 
 .PHONY: v_link
-v_link:
+v_link: $(BDPI_OBJ)
 	@echo Linking for Verilog sim ...
 	bsc -e $(TOPMODULE) -verilog -o ./$(V_SIM_EXE) $(V_DIRS) -vsim $(V_SIM)  verilog_RTL/$(TOPMODULE).v 
 	@echo Linking for Verilog sim finished

README.md

@@ -8,8 +8,18 @@ Just as "man does not live by bread alone, but by every word that proceeds from
 ``TOPMODULE=mkTop make v_compile`` to generate verilog. The generated verilog can
 be found in the ``verilog_RTL/`` folder.
 
+# Status
+Admittedly, not very far. Perhaps one could say we've got the beginnings 
+of what would make for LED and UART controllers.
+
 # Dependencies
-You'll need to install:
+## Linux
+Running `nix-shell` should *just work* on Linux. To be fair, haven't
+tested this yet.
+
+## MacOS
+Upstream nix recipes need to be adjusted a bit to work on MacOS, so
+for now do:
 1. [Yosys](https://github.com/YosysHQ/yosys) at git commit: 7ce5011c24b
 2. [nextpnr-0.4-36-gc8406b71](https://github.com/YosysHQ/nextpnr)
 3. [PrjTrellis](https://github.com/YosysHQ/prjtrellis) at git commit: 1.2.1-22-g35f5aff
@@ -26,16 +36,20 @@ screen /dev/tty.usbserial-K00027 9600
 ```
 
 # Simulation
+## Main Chip Core
 TODO
 
-# Generating Verilog
+## Experiments
+See experiments README.
 
+# Generating Verilog
 ```bash
 TOPMODULE=mkTop make v_compile
 ```
 
 # TODO
  - [ ] debug UART accuracy
+       - clk divider should be frequency matched
 
 # Notable Reference Files
 ``/Users/yehowshuaimmanuel/git/bsc/testsuite/bsc.bsv_examples/cpu/FiveStageCPUQ3sol.bsv``

experiments/bram/sim_inspect.tcl

@@ -0,0 +1,14 @@
+# bluetcl sim_inspect.tcl
+namespace import ::Bluetcl::*
+package require Bluesim
+
+sim load simBRAM.so mkTestbench
+set count_hdl [sim lookup count]
+set bram [sim lookup dut1_memory]
+
+sim step
+sim step
+sim step
+
+puts "Value of count: [sim get $count_hdl]"
+puts "Value of bram\[0:3\]: [sim getrange $bram 0 3]"

shell.nix

@@ -0,0 +1,14 @@
+{ pkgs ? import (fetchTarball "https://github.com/NixOS/nixpkgs/archive/d34a98666913267786d9ab4aa803a1fc75f81f4d.tar.gz") {} }:
+
+pkgs.mkShell {
+  buildInputs = [
+    pkgs.yosys
+    pkgs.nextpnr
+    pkgs.bluespec
+    pkgs.yosys-bluespec
+  ];
+
+  shellHook = ''
+    echo "Dev environment for Manna Chip."
+  '';
+}

sim_inspect.tcl

@@ -0,0 +1,15 @@
+# bluetcl sim_inspect.tcl
+namespace import ::Bluetcl::*
+package require Bluesim
+
+cd bram_tests
+sim load simBRAM.so mkTestbench
+set count_hdl [sim lookup count]
+set bram [sim lookup dut1_memory]
+
+sim step
+sim step
+sim step
+
+puts "Value of count: [sim get $count_hdl]"
+puts "Value of bram\[0:3\]: [sim getrange $bram 0 3]"