Google Git
Sign in
foss-eda-tools / third_party / shuttle / sky130 / mpw-001 / slot-012 / 609cc3520db4d57d5e05b6a1a2bcf3fd2b804f6b / . / README.md
blob: ec0cec24544bc9c8e17f078c53e22830bed6c217 [file] [log] [blame] [view]
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]1# Multi Project Harness - mpw-one-b
shalan0d14e6e2020-08-31 16:50:48 +0200[diff] [blame]2
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]3* This is a proposal for handling multiple projects in the user project area of the [Caravel harness](https://github.com/efabless/caravel)
4* This is a fork of caravel with https://github.com/mattvenn/multi-project-harness/tree/separate-macro added to /verilog/rtl/
5* user_project_wrapper is then adjusted to instantiate all the submodules.
shalan0d14e6e2020-08-31 16:50:48 +0200[diff] [blame]6
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]7![multi project harness](doc/multi-project-harness.png)
shalan0d14e6e2020-08-31 16:50:48 +0200[diff] [blame]8
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]9# Important!
Ahmed Ghazy0893d012020-12-05 23:30:25 +0200[diff] [blame]10
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]11* If you want to actually build the wrapper, you need to checkout the release branch.
12* This branch is just used to rebuild caravel.gds with 'make ship'
agorararmard7d6fadb2020-11-25 20:23:20 +0200[diff] [blame]13
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]14# Tests
Ahmed Ghazy0893d012020-12-05 23:30:25 +0200[diff] [blame]15
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]16* Full system tests for each sub project: verilog/dv/caravel/user_proj_example
17* Separate projects: run make sim in root directory of multi_project_harness: https://github.com/mattvenn/multi-project-harness/blob/separate-macro/test_harness.py
agorararmard7d6fadb2020-11-25 20:23:20 +0200[diff] [blame]18
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]19# OpenLane Configs
agorararmardd4a2d6f2020-12-01 19:21:51 +0200[diff] [blame]20
Matt Venn85fd5282021-01-29 14:17:38 +0100[diff] [blame]21All the OpenLane configs for each project are here: https://github.com/mattvenn/multi-project-harness/tree/separate-macro/openlane
22
23The multi project harness turned out to be more of a MUX, and was hardened separately. Make sure you are on the 'separate-macro' branch of the repo.
agorararmardd4a2d6f2020-12-01 19:21:51 +0200[diff] [blame]24
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]25# Submodules
agorararmard212cd822020-11-26 22:40:17 +0200[diff] [blame]26
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]27## seven-segment-seconds
agorararmard212cd822020-11-26 22:40:17 +0200[diff] [blame]28
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]29description: shows seconds on a seven segment LED display.
agorararmarddc723a62020-11-26 20:00:29 +0200[diff] [blame]30
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]31author: Matt Venn
agorararmarddc723a62020-11-26 20:00:29 +0200[diff] [blame]32
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]33url: https://github.com/mattvenn/seven-segment-seconds
agorararmarddc723a62020-11-26 20:00:29 +0200[diff] [blame]34
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]35## ws2812
agorararmard0cd21c92020-12-09 17:02:18 +0200[diff] [blame]36
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]37description: ws2812 LED interface for 8 addressable LEDs
agorararmard0cd21c92020-12-09 17:02:18 +0200[diff] [blame]38
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]39author: Matt Venn
agorararmarddc723a62020-11-26 20:00:29 +0200[diff] [blame]40
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]41url: https://github.com/mattvenn/ws2812-core.git
agorararmarddc723a62020-11-26 20:00:29 +0200[diff] [blame]42
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]43## vga-clock
agorararmard3741dfc2020-12-01 18:04:37 +0200[diff] [blame]44
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]45description: show the time on a VGA panel
agorararmarddc723a62020-11-26 20:00:29 +0200[diff] [blame]46
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]47author: Matt Venn
agorararmarddc723a62020-11-26 20:00:29 +0200[diff] [blame]48
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]49url: https://github.com/mattvenn/vga-clock.git
agorararmarddc723a62020-11-26 20:00:29 +0200[diff] [blame]50
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]51## spinet
agorararmard3741dfc2020-12-01 18:04:37 +0200[diff] [blame]52
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]53description: multi node computer controller
agorararmard3741dfc2020-12-01 18:04:37 +0200[diff] [blame]54
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]55author: Richard Miller
agorararmard3741dfc2020-12-01 18:04:37 +0200[diff] [blame]56
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]57url: https://github.com/millerresearch/spinet
agorararmard3741dfc2020-12-01 18:04:37 +0200[diff] [blame]58
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]59## asicfreq
agorararmard3741dfc2020-12-01 18:04:37 +0200[diff] [blame]60
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]61description: Frequency counter
agorararmard3741dfc2020-12-01 18:04:37 +0200[diff] [blame]62
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]63author: Michael Betz & Vamsi Vytla
agorararmard3741dfc2020-12-01 18:04:37 +0200[diff] [blame]64
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]65url: https://git.sr.ht/~jersey99/asicfreq
agorararmard8e874782020-12-15 23:10:59 +0200[diff] [blame]66
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]67## ASIC_watch
agorararmard8e874782020-12-15 23:10:59 +0200[diff] [blame]68
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]69description: 4 digit 7 segment clock
agorararmard8e874782020-12-15 23:10:59 +0200[diff] [blame]70
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]71author: Guillem Cabo
agorararmardda92aef2020-12-04 23:56:37 +0200[diff] [blame]72
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]73url: https://github.com/GuillemCabo/ASIC_watch.git
agorararmardda92aef2020-12-04 23:56:37 +0200[diff] [blame]74
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]75## TPM2137
shalan0d14e6e2020-08-31 16:50:48 +0200[diff] [blame]76
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]77description: Reverse Engineering challenge
shalan0d14e6e2020-08-31 16:50:48 +0200[diff] [blame]78
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]79author: Q3K
shalan0d14e6e2020-08-31 16:50:48 +0200[diff] [blame]80
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]81url: https://github.com/mattvenn/TPM2137
shalan0d14e6e2020-08-31 16:50:48 +0200[diff] [blame]82
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]83## mm2hdmi
agorararmarddc723a62020-11-26 20:00:29 +0200[diff] [blame]84
matt venn26d18912020-12-16 20:52:29 +0100[diff] [blame]85description: HDMI driver
86
87author: Aleksandar Pajkanovic
88
89url: https://github.com/nanoluka/mm2hdmi.git