blob: f7e18d2ca06f62b7bf7111f1b4a2f5c9cb6e7332 [file] [log] [blame]
manarabdelatyb41301c2021-04-19 23:30:35 +02001# SPDX-FileCopyrightText: 2020 Efabless Corporation
2#
3# Licensed under the Apache License, Version 2.0 (the "License");
4# you may not use this file except in compliance with the License.
5# You may obtain a copy of the License at
6#
7# http://www.apache.org/licenses/LICENSE-2.0
8#
9# Unless required by applicable law or agreed to in writing, software
10# distributed under the License is distributed on an "AS IS" BASIS,
11# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12# See the License for the specific language governing permissions and
13# limitations under the License.
14#
15# SPDX-License-Identifier: Apache-2.0
kareem76e8a0f2022-02-25 10:13:53 -080016MAKEFLAGS+=--warn-undefined-variables
manarabdelatyb41301c2021-04-19 23:30:35 +020017
kareemd637b3e2022-07-06 08:19:47 -070018export CARAVEL_ROOT?=$(PWD)/caravel
manarabdelaty26323152021-09-16 23:11:34 +020019PRECHECK_ROOT?=${HOME}/mpw_precheck
jeffdi585ad262022-10-24 21:50:35 -070020export MCW_ROOT?=$(PWD)/mgmt_core_wrapper
kareem76e8a0f2022-02-25 10:13:53 -080021SIM?=RTL
22
manarabdelatyb41301c2021-04-19 23:30:35 +020023# Install lite version of caravel, (1): caravel-lite, (0): caravel
24CARAVEL_LITE?=1
25
Marwan Abbas0a55a1c2022-03-01 03:39:19 -080026# PDK switch varient
Marwan Abbas1b16eff2022-03-02 09:21:34 -080027export PDK?=sky130B
jeffdif7a3d572022-10-12 08:45:05 -070028#export PDK?=gf180mcu
Marwan Abbas45f97202022-07-01 16:26:21 +020029export PDKPATH?=$(PDK_ROOT)/$(PDK)
Marwan Abbas0a55a1c2022-03-01 03:39:19 -080030
jeffdif7a3d572022-10-12 08:45:05 -070031
Jeff DiCorpo5c041f12022-02-25 17:56:06 -080032
jeffdif7a3d572022-10-12 08:45:05 -070033ifeq ($(PDK),sky130B)
34 SKYWATER_COMMIT=f70d8ca46961ff92719d8870a18a076370b85f6c
jeffdi2af30e62022-10-24 21:13:50 -070035 export OPEN_PDKS_COMMIT?=0059588eebfc704681dc2368bd1d33d96281d10f
36 export OPENLANE_TAG?=2022.10.20
jeffdie308dde2022-10-24 19:21:52 -070037 MPW_TAG ?= mpw-7d
manarabdelatyb41301c2021-04-19 23:30:35 +020038
kareem76e8a0f2022-02-25 10:13:53 -080039ifeq ($(CARAVEL_LITE),1)
manarabdelatyb41301c2021-04-19 23:30:35 +020040 CARAVEL_NAME := caravel-lite
kareem76e8a0f2022-02-25 10:13:53 -080041 CARAVEL_REPO := https://github.com/efabless/caravel-lite
Jeff DiCorpo5c041f12022-02-25 17:56:06 -080042 CARAVEL_TAG := $(MPW_TAG)
manarabdelatyb41301c2021-04-19 23:30:35 +020043else
44 CARAVEL_NAME := caravel
kareem76e8a0f2022-02-25 10:13:53 -080045 CARAVEL_REPO := https://github.com/efabless/caravel
Jeff DiCorpo5c041f12022-02-25 17:56:06 -080046 CARAVEL_TAG := $(MPW_TAG)
manarabdelatyb41301c2021-04-19 23:30:35 +020047endif
48
jeffdi2d83d672022-10-12 13:45:59 -070049else
50
jeffdi465b6eb2022-10-24 21:47:37 -070051 MPW_TAG ?= gfmpw-0a
jeffdie308dde2022-10-24 19:21:52 -070052 CARAVEL_NAME := caravel
53 CARAVEL_REPO := https://github.com/efabless/caravel-gf180mcu
54 CARAVEL_TAG := $(MPW_TAG)
55 #OPENLANE_TAG=ddfeab57e3e8769ea3d40dda12be0460e09bb6d9
jeffdi2af30e62022-10-24 21:13:50 -070056 export OPEN_PDKS_COMMIT?=0059588eebfc704681dc2368bd1d33d96281d10f
57 export OPENLANE_TAG?=2022.10.20
jeffdi2d83d672022-10-12 13:45:59 -070058
jeffdif7a3d572022-10-12 08:45:05 -070059endif
60
manarabdelatyb41301c2021-04-19 23:30:35 +020061# Include Caravel Makefile Targets
manarabdelaty26323152021-09-16 23:11:34 +020062.PHONY: % : check-caravel
kareem76e8a0f2022-02-25 10:13:53 -080063%:
manarabdelaty26323152021-09-16 23:11:34 +020064 export CARAVEL_ROOT=$(CARAVEL_ROOT) && $(MAKE) -f $(CARAVEL_ROOT)/Makefile $@
manarabdelatyb41301c2021-04-19 23:30:35 +020065
kareem76e8a0f2022-02-25 10:13:53 -080066.PHONY: install
67install:
68 if [ -d "$(CARAVEL_ROOT)" ]; then\
69 echo "Deleting exisiting $(CARAVEL_ROOT)" && \
70 rm -rf $(CARAVEL_ROOT) && sleep 2;\
71 fi
72 echo "Installing $(CARAVEL_NAME).."
73 git clone -b $(CARAVEL_TAG) $(CARAVEL_REPO) $(CARAVEL_ROOT) --depth=1
manarabdelatyb41301c2021-04-19 23:30:35 +020074
manarabdelaty340cc4a2021-04-20 18:28:22 +020075# Install DV setup
76.PHONY: simenv
77simenv:
Marwan Abbasbb250682022-07-06 09:43:59 +020078 docker pull efabless/dv:latest
manarabdelaty340cc4a2021-04-20 18:28:22 +020079
kareem76e8a0f2022-02-25 10:13:53 -080080.PHONY: setup
kareemd637b3e2022-07-06 08:19:47 -070081setup: install check-env install_mcw openlane pdk-with-volare
kareem76e8a0f2022-02-25 10:13:53 -080082
83# Openlane
84blocks=$(shell cd openlane && find * -maxdepth 0 -type d)
85.PHONY: $(blocks)
Kareem Farid0eb93ef2022-03-02 13:25:37 +020086$(blocks): % :
kareemd637b3e2022-07-06 08:19:47 -070087 $(MAKE) -C openlane $*
kareem76e8a0f2022-02-25 10:13:53 -080088
89dv_patterns=$(shell cd verilog/dv && find * -maxdepth 0 -type d)
90dv-targets-rtl=$(dv_patterns:%=verify-%-rtl)
91dv-targets-gl=$(dv_patterns:%=verify-%-gl)
92dv-targets-gl-sdf=$(dv_patterns:%=verify-%-gl-sdf)
93
manarabdelaty340cc4a2021-04-20 18:28:22 +020094TARGET_PATH=$(shell pwd)
Marwan Abbas1105cc72022-03-17 10:01:30 -070095verify_command="source ~/.bashrc && cd ${TARGET_PATH}/verilog/dv/$* && export SIM=${SIM} && make"
kareem76e8a0f2022-02-25 10:13:53 -080096dv_base_dependencies=simenv
97docker_run_verify=\
manarabdelatyb6ce4422021-09-16 22:09:24 +020098 docker run -v ${TARGET_PATH}:${TARGET_PATH} -v ${PDK_ROOT}:${PDK_ROOT} \
kareemab6cfe12022-02-15 05:36:48 -080099 -v ${CARAVEL_ROOT}:${CARAVEL_ROOT} \
100 -e TARGET_PATH=${TARGET_PATH} -e PDK_ROOT=${PDK_ROOT} \
101 -e CARAVEL_ROOT=${CARAVEL_ROOT} \
Marwan Abbas1105cc72022-03-17 10:01:30 -0700102 -e TOOLS=/foss/tools/riscv-gnu-toolchain-rv32i/217e7f3debe424d61374d31e33a091a630535937 \
kareemab6cfe12022-02-15 05:36:48 -0800103 -e DESIGNS=$(TARGET_PATH) \
Marwan Abbas1b16eff2022-03-02 09:21:34 -0800104 -e PDK=$(PDK) \
Marwan Abbas68788702022-02-15 16:49:02 +0200105 -e CORE_VERILOG_PATH=$(TARGET_PATH)/mgmt_core_wrapper/verilog \
kareemab6cfe12022-02-15 05:36:48 -0800106 -e MCW_ROOT=$(MCW_ROOT) \
Marwan Abbas1105cc72022-03-17 10:01:30 -0700107 -u $$(id -u $$USER):$$(id -g $$USER) efabless/dv:latest \
kareem76e8a0f2022-02-25 10:13:53 -0800108 sh -c $(verify_command)
manarabdelatyb41301c2021-04-19 23:30:35 +0200109
kareem76e8a0f2022-02-25 10:13:53 -0800110.PHONY: harden
111harden: $(blocks)
112
113.PHONY: verify
Jeff DiCorpo76e88e12022-03-19 14:12:29 -0700114verify: $(dv-targets-rtl)
115
Marwan Abbaseda60992022-03-03 19:53:27 +0200116.PHONY: verify-all-rtl
117verify-all-rtl: $(dv-targets-rtl)
118
119.PHONY: verify-all-gl
120verify-all-gl: $(dv-targets-gl)
121
122.PHONY: verify-all-gl-sdf
Marwan Abbas17c43a62022-03-03 21:11:51 +0200123verify-all-gl-sdf: $(dv-targets-gl-sdf)
kareem76e8a0f2022-02-25 10:13:53 -0800124
125$(dv-targets-rtl): SIM=RTL
126$(dv-targets-rtl): verify-%-rtl: $(dv_base_dependencies)
127 $(docker_run_verify)
128
129$(dv-targets-gl): SIM=GL
130$(dv-targets-gl): verify-%-gl: $(dv_base_dependencies)
131 $(docker_run_verify)
132
133$(dv-targets-gl-sdf): SIM=GL_SDF
134$(dv-targets-gl-sdf): verify-%-gl-sdf: $(dv_base_dependencies)
135 $(docker_run_verify)
136
137clean-targets=$(blocks:%=clean-%)
138.PHONY: $(clean-targets)
139$(clean-targets): clean-% :
140 rm -f ./verilog/gl/$*.v
141 rm -f ./spef/$*.spef
142 rm -f ./sdc/$*.sdc
143 rm -f ./sdf/$*.sdf
144 rm -f ./gds/$*.gds
145 rm -f ./mag/$*.mag
146 rm -f ./lef/$*.lef
147 rm -f ./maglef/*.maglef
148
149make_what=setup $(blocks) $(dv-targets-rtl) $(dv-targets-gl) $(dv-targets-gl-sdf) $(clean-targets)
150.PHONY: what
151what:
152 # $(make_what)
153
154# Install Openlane
155.PHONY: openlane
156openlane:
Kareem Farid13edb812022-06-08 13:03:08 +0200157 @if [ "$$(realpath $${OPENLANE_ROOT})" = "$$(realpath $$(pwd)/openlane)" ]; then\
158 echo "OPENLANE_ROOT is set to '$$(pwd)/openlane' which contains openlane config files"; \
159 echo "Please set it to a different directory"; \
160 exit 1; \
161 fi
kareem76e8a0f2022-02-25 10:13:53 -0800162 cd openlane && $(MAKE) openlane
163
164#### Not sure if the targets following are of any use
manarabdelatyb41301c2021-04-19 23:30:35 +0200165
166# Create symbolic links to caravel's main files
167.PHONY: simlink
168simlink: check-caravel
kareem76e8a0f2022-02-25 10:13:53 -0800169### Symbolic links relative path to $CARAVEL_ROOT
manarabdelaty78c1b012021-04-23 17:12:54 +0200170 $(eval MAKEFILE_PATH := $(shell realpath --relative-to=openlane $(CARAVEL_ROOT)/openlane/Makefile))
171 $(eval PIN_CFG_PATH := $(shell realpath --relative-to=openlane/user_project_wrapper $(CARAVEL_ROOT)/openlane/user_project_wrapper_empty/pin_order.cfg))
manarabdelatye542bdf2021-04-20 11:15:40 +0200172 mkdir -p openlane
173 mkdir -p openlane/user_project_wrapper
174 cd openlane &&\
manarabdelaty78c1b012021-04-23 17:12:54 +0200175 ln -sf $(MAKEFILE_PATH) Makefile
manarabdelatye542bdf2021-04-20 11:15:40 +0200176 cd openlane/user_project_wrapper &&\
manarabdelaty78c1b012021-04-23 17:12:54 +0200177 ln -sf $(PIN_CFG_PATH) pin_order.cfg
manarabdelatyb41301c2021-04-19 23:30:35 +0200178
179# Update Caravel
180.PHONY: update_caravel
181update_caravel: check-caravel
jeffdi298918f2021-12-16 11:15:44 -0800182 cd $(CARAVEL_ROOT)/ && git checkout $(CARAVEL_TAG) && git pull
manarabdelatyb41301c2021-04-19 23:30:35 +0200183
184# Uninstall Caravel
185.PHONY: uninstall
kareem76e8a0f2022-02-25 10:13:53 -0800186uninstall:
manarabdelaty78c1b012021-04-23 17:12:54 +0200187 rm -rf $(CARAVEL_ROOT)
manarabdelatyb41301c2021-04-19 23:30:35 +0200188
manarabdelaty340cc4a2021-04-20 18:28:22 +0200189
manarabdelaty78c1b012021-04-23 17:12:54 +0200190# Install Pre-check
191# Default installs to the user home directory, override by "export PRECHECK_ROOT=<precheck-installation-path>"
192.PHONY: precheck
193precheck:
Jeff DiCorpo9d5fd022022-03-19 11:01:27 -0700194 @git clone --depth=1 --branch $(MPW_TAG) https://github.com/efabless/mpw_precheck.git $(PRECHECK_ROOT)
manarabdelatyb6ce4422021-09-16 22:09:24 +0200195 @docker pull efabless/mpw_precheck:latest
manarabdelaty78c1b012021-04-23 17:12:54 +0200196
197.PHONY: run-precheck
Ahmed El Omla0abd1612022-02-08 19:12:27 +0200198run-precheck: check-pdk check-precheck
manarabdelatyb6ce4422021-09-16 22:09:24 +0200199 $(eval INPUT_DIRECTORY := $(shell pwd))
manarabdelaty78c1b012021-04-23 17:12:54 +0200200 cd $(PRECHECK_ROOT) && \
Marwan Abbasd9bdb822022-04-16 10:34:40 -0700201 docker run -v $(PRECHECK_ROOT):$(PRECHECK_ROOT) \
202 -v $(INPUT_DIRECTORY):$(INPUT_DIRECTORY) \
203 -v $(PDK_ROOT):$(PDK_ROOT) \
204 -e INPUT_DIRECTORY=$(INPUT_DIRECTORY) \
Ahmed El Omla31cccd52022-07-01 12:35:45 +0200205 -e PDK_PATH=$(PDK_ROOT)/$(PDK) \
Jeff DiCorpoc0695642022-07-08 06:41:16 -0700206 -e PDK_ROOT=$(PDK_ROOT) \
Marwan Abbasd9bdb822022-04-16 10:34:40 -0700207 -e PDKPATH=$(PDKPATH) \
208 -u $(shell id -u $(USER)):$(shell id -g $(USER)) \
Ahmed El Omla42a15462022-07-07 17:01:55 +0200209 efabless/mpw_precheck:latest bash -c "cd $(PRECHECK_ROOT) ; python3 mpw_precheck.py --input_directory $(INPUT_DIRECTORY) --pdk_path $(PDK_ROOT)/$(PDK)"
manarabdelatyd8dd0102021-04-30 08:40:52 +0200210
manarabdelatyb41301c2021-04-19 23:30:35 +0200211
kareem76e8a0f2022-02-25 10:13:53 -0800212
kareem035ac3d2022-02-25 10:34:26 -0800213.PHONY: clean
214clean:
215 cd ./verilog/dv/ && \
216 $(MAKE) -j$(THREADS) clean
217
manarabdelatyb41301c2021-04-19 23:30:35 +0200218check-caravel:
219 @if [ ! -d "$(CARAVEL_ROOT)" ]; then \
220 echo "Caravel Root: "$(CARAVEL_ROOT)" doesn't exists, please export the correct path before running make. "; \
221 exit 1; \
Jeff DiCorpofb944f92021-04-20 00:40:50 +0000222 fi
manarabdelaty78c1b012021-04-23 17:12:54 +0200223
224check-precheck:
225 @if [ ! -d "$(PRECHECK_ROOT)" ]; then \
226 echo "Pre-check Root: "$(PRECHECK_ROOT)" doesn't exists, please export the correct path before running make. "; \
227 exit 1; \
228 fi
229
230check-pdk:
231 @if [ ! -d "$(PDK_ROOT)" ]; then \
232 echo "PDK Root: "$(PDK_ROOT)" doesn't exists, please export the correct path before running make. "; \
233 exit 1; \
manarabdelatyd8dd0102021-04-30 08:40:52 +0200234 fi
235
236.PHONY: help
237help:
kareem76e8a0f2022-02-25 10:13:53 -0800238 cd $(CARAVEL_ROOT) && $(MAKE) help
manarabdelatyd8dd0102021-04-30 08:40:52 +0200239 @$(MAKE) -pRrq -f $(lastword $(MAKEFILE_LIST)) : 2>/dev/null | awk -v RS= -F: '/^# File/,/^# Finished Make data base/ {if ($$1 !~ "^[#.]") {print $$1}}' | sort | egrep -v -e '^[^[:alnum:]]' -e '^$@$$'
kareem76e8a0f2022-02-25 10:13:53 -0800240
241