Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/master'
Browse files Browse the repository at this point in the history
# Conflicts:
#	run_mac_docker.sh
  • Loading branch information
yuqisun committed Oct 26, 2024
2 parents 56d0f10 + 3bb01a7 commit c91a3bc
Show file tree
Hide file tree
Showing 3 changed files with 11 additions and 38 deletions.
40 changes: 7 additions & 33 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ CGRA-Flow is an integrated framework for CGRA compilation, exploration, synthesi

User Interface Snapshot/Demo
--------------------------------------------------------------------------
![Capture](https://user-images.githubusercontent.com/6756658/213010564-fa74b34e-218f-435e-9e8e-ef5a40f8899d.PNG)
![1016](https://github.com/user-attachments/assets/b15313ba-3c46-4b5b-b333-bdff61990ced)

A demo at repl.it (https://repl.it/@ChengTan/cgra-flow) shows some features of CGRA-Flow (the verilog generation and evaluation are not available due to *repl.it*'s limited support of python environment). To explore all the features, please setup CGRA-Flow locally or leverage the docker image.

Expand All @@ -30,33 +30,17 @@ As CGRA-Flow requires GUI, a script is provided for setting up the display:
```sh
docker pull cgra/cgra-flow:20241025

# For Mac users like me:
# For Mac users:
sh ./run_mac_docker.sh

# Otherwise, if this is your first time establishing a container for CGRA-Flow:
# sh ./run_docker.sh
# Else, use the following command to reopen the same container:
# sh ./start_docker.sh
# Or try to setup GUI (X-11) by yourself.
# Windows Docker customtkinter style UI (Please setup GUI (X-11) first)
# In WSL, execute below script, it will enter container and config x11 DISPLAY automatically
sh ./run_linux_docker.sh

# Don't forget to activate the python virtual environment once you are in the container:
source /WORK_REPO/venv/bin/activate
```

```shell
# Windows Docker customtkinter style UI (Please setup GUI (X-11) first)
# In WSL, execute below script, it will enter container and config x11 DISPLAY automatically
sh ./run_linux_docker.sh

# In container
root@1627139489b9 WORK_REPO# source venv/bin/activate
(venv) root@1627139489b9 WORK_REPO# cd /WORK_REPO/CGRA-Flow

# Startup theme mode selector UI
(venv) root@1627139489b9 CGRA-Flow# python launch.py
# Three themes are available: dark, light, and classic
```

Otherwise, if you don't need the GUI, development can be performed in the container with the environment well set up:
```sh
docker pull cgra/cgra-flow:20241025
Expand All @@ -67,8 +51,8 @@ Otherwise, if you don't need the GUI, development can be performed in the contai
Execution
--------------------------------------------------------
```sh
mkdir build && cd build
python ../mode_dark_light.py
# Startup theme mode selector UI
python launch.py
```

Installation
Expand All @@ -92,16 +76,6 @@ Citation
}
```

Publications leveraging (parts of) CGRA-Flow toolchain
--------------------------------------------------------------------------
- _"MESA: Microarchitecture Extensions for Spatial Architecture Generation."_ ISCA'23.
- _"An Architecture Interface and Offload Model for Low-Overhead, Near-Data, Distributed Accelerators."_ MICRO'22.
- _"MATCHA: A Fast and Energy-Efficient Accelerator for Fully Homomorphic Encryption over the Torus."_ DAC'22.
- _"DRIPS: Dynamic Rebalancing of Pipelined Streaming Applications on CGRAs."_ HPCA'22.
- _"ARENA: Asynchronous Reconfigurable Accelerator Ring to Enable Data-Centric Parallel Computing."_ TPDS'21.
- _"Ultra-Elastic CGRAs for Irregular Loop Specialization."_ HPCA'21.



License
--------------------------------------------------------------------------
Expand Down
6 changes: 3 additions & 3 deletions launch.py
Original file line number Diff line number Diff line change
Expand Up @@ -17,13 +17,13 @@ def launchUI(theme_radio_var):
print(f'Get theme radio var: {theme_radio_var.get()}')
if theme_radio_var.get() == 1:
print('Activate light mode.')
os.system("./launchUI.bash light &")
os.system("sh ./launchUI.bash light &")
elif theme_radio_var.get() == 2:
print('Activate classic mode.')
os.system("./launchUI.bash classic &")
os.system("sh ./launchUI.bash classic &")
else:
print('Activate dark mode.')
os.system("./launchUI.bash &")
os.system("sh ./launchUI.bash &")
master.destroy()


Expand Down
3 changes: 1 addition & 2 deletions run_mac_docker.sh
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
#!/usr/bin/env bash

CONTAINER=cgra/cgra-flow:20241025
COMMAND=/bin/bash
CONTAINER=yuqisun/cgra-flow-openroad:latest # cgra/cgra-flow:demo
NIC=en0

# Grab the ip address of this box
Expand Down

0 comments on commit c91a3bc

Please sign in to comment.