Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README.md #17

Merged
merged 2 commits into from
Aug 25, 2024
Merged

Update README.md #17

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
449d982
Update Doc
IveanEx Aug 25, 2024
a51dc5d
Bug Fix
IveanEx Aug 25, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 26 additions & 22 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,45 +36,49 @@ The following files are released under Solderpad v0.51 (`SHL-0.51`) see `hw/LICE

### **⚠️Tips**: All commands is made at the root dir of the Occamy repo.

## Prototype the minimal system on VCU128:
## Prototype the system on FPGA:
### Option 1: Occamy configuration on VCU128 (Bootrom and DRAM from Xilinx IP)

```makefile
@ Occamy Docker: make bootrom
@ Occamy Docker: make sw
@ Occamy Docker: make -C target/fpga/sw [APP=???] (Which binary file you want to use)
@ SNAX Docker: make rtl CFG=snax_minimal.hjson
@ SNAX Docker: make occamy_system_vivado_preparation SNAX_MINIMAL=1
@ SNAX Docker: make rtl CFG=target/rtl/cfg/occamy_cfg/snax_two_clusters.hjson (Can be modified to other configurations)
@ SNAX Docker: make occamy_system_vivado_preparation
@ Barnard3: make occamy_system_vcu128
@ Barnard3: make occamy_system_vcu128_gui
```

## Prototype the typical system on VCU128:
### Option 2: HeMAiA configuration on VPK180 (Tapeout configuration, everything is internal)

```makefile
@ Occamy Docker: make bootrom
@ Occamy Docker: make sw
@ Occamy Docker: make -C target/fpga/sw [APP=???] (Which binary file you want to use)
@ SNAX Docker: make rtl CFG=snax_two_clusters.hjson
@ SNAX Docker: make occamy_system_vivado_preparation SNAX=1 or make hemaia_system_vivado_preparation SNAX=1
@ Barnard3: make occamy_system_vcu128 or make hemaia_system_vcu128
@ Barnard3: make occamy_system_vcu128_gui or make hemaia_system_vcu128_gui
@ Barnard3: make -C target/fpga/sw download_sw
@ SNAX Docker: make rtl CFG=target/rtl/cfg/occamy_cfg/snax_two_clusters.hjson (Can be modified to other configurations)
@ SNAX Docker: make hemaia_system_vivado_preparation
@ Barnard3: make hemaia_system_vivado TARGET_PLATFORM={vpk180, vcu128}
@ Barnard3: make hemaia_system_vivado_gui
```

## Simulate the system:
### Option 1: Simulate with Verilator

## Simulate the minimal system:
```makefile
make bootrom
make sw
make rtl CFG=snax_minimal.hjson
make occamy_system_vsim_preparation SNAX_MINIMAL=1
make occamy_system_vsim
@ Occamy Docker: make bootrom
@ Occamy Docker: make sw
@ SNAX Docker: make rtl CFG=target/rtl/cfg/occamy_cfg/snax_two_clusters.hjson (Can be modified to other configurations)
@ SNAX Docker: make occamy_system_vlt
@ SNAX Docker: target/sim/bin/occamy_top.vlt [Elf location] [--vcd]
```

## Simulate the typical system:
### Option 2: Simulate with Questasim

```makefile
make bootrom
make sw
make rtl CFG=snax_two_clusters.hjson
make occamy_system_vsim_preparation SNAX=1
make occamy_system_vsim
```
@ Occamy Docker: make bootrom
@ Occamy Docker: make sw
@ SNAX Docker: make rtl CFG=target/rtl/cfg/occamy_cfg/snax_two_clusters.hjson (Can be modified to other configurations)
@ SNAX Docker: make occamy_system_vsim_preparation
@ Barnard3: make occamy_system_vsim
@ Barnard3: target/sim/bin/occamy_top.vsim[.gui] [Elf location]
```
Loading