| # SPDX-FileCopyrightText: 2020 Efabless Corporation |
| # |
| # Licensed under the Apache License, Version 2.0 (the "License"); |
| # you may not use this file except in compliance with the License. |
| # You may obtain a copy of the License at |
| # |
| # http://www.apache.org/licenses/LICENSE-2.0 |
| # |
| # Unless required by applicable law or agreed to in writing, software |
| # distributed under the License is distributed on an "AS IS" BASIS, |
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| # See the License for the specific language governing permissions and |
| # limitations under the License. |
| # |
| # SPDX-License-Identifier: Apache-2.0 |
| MAKEFLAGS+=--warn-undefined-variables |
| |
| export CARAVEL_ROOT?=$(PWD)/caravel |
| PRECHECK_ROOT?=${HOME}/mpw_precheck |
| export MCW_ROOT?=$(PWD)/mgmt_core_wrapper |
| SIM?=RTL |
| |
| # Install lite version of caravel, (1): caravel-lite, (0): caravel |
| CARAVEL_LITE?=1 |
| |
| # PDK switch varient |
| export PDK?=sky130A |
| #export PDK?=gf180mcuC |
| export PDKPATH?=$(PDK_ROOT)/$(PDK) |
| |
| |
| |
| ifeq ($(PDK),sky130A) |
| SKYWATER_COMMIT=f70d8ca46961ff92719d8870a18a076370b85f6c |
| export OPEN_PDKS_COMMIT?=0059588eebfc704681dc2368bd1d33d96281d10f |
| export OPENLANE_TAG?=2022.11.19 |
| MPW_TAG ?= mpw-8a |
| |
| ifeq ($(CARAVEL_LITE),1) |
| CARAVEL_NAME := caravel-lite |
| CARAVEL_REPO := https://github.com/efabless/caravel-lite |
| CARAVEL_TAG := $(MPW_TAG) |
| else |
| CARAVEL_NAME := caravel |
| CARAVEL_REPO := https://github.com/efabless/caravel |
| CARAVEL_TAG := $(MPW_TAG) |
| endif |
| |
| endif |
| |
| ifeq ($(PDK),sky130B) |
| SKYWATER_COMMIT=f70d8ca46961ff92719d8870a18a076370b85f6c |
| export OPEN_PDKS_COMMIT?=0059588eebfc704681dc2368bd1d33d96281d10f |
| export OPENLANE_TAG?=2022.11.19 |
| MPW_TAG ?= mpw-8a |
| |
| ifeq ($(CARAVEL_LITE),1) |
| CARAVEL_NAME := caravel-lite |
| CARAVEL_REPO := https://github.com/efabless/caravel-lite |
| CARAVEL_TAG := $(MPW_TAG) |
| else |
| CARAVEL_NAME := caravel |
| CARAVEL_REPO := https://github.com/efabless/caravel |
| CARAVEL_TAG := $(MPW_TAG) |
| endif |
| |
| endif |
| |
| ifeq ($(PDK),gf180mcuC) |
| |
| MPW_TAG ?= gfmpw-0a |
| CARAVEL_NAME := caravel |
| CARAVEL_REPO := https://github.com/efabless/caravel-gf180mcu |
| CARAVEL_TAG := $(MPW_TAG) |
| #OPENLANE_TAG=ddfeab57e3e8769ea3d40dda12be0460e09bb6d9 |
| export OPEN_PDKS_COMMIT?=0059588eebfc704681dc2368bd1d33d96281d10f |
| export OPENLANE_TAG?=2022.11.19 |
| |
| endif |
| |
| # Include Caravel Makefile Targets |
| .PHONY: % : check-caravel |
| %: |
| export CARAVEL_ROOT=$(CARAVEL_ROOT) && $(MAKE) -f $(CARAVEL_ROOT)/Makefile $@ |
| |
| .PHONY: install |
| install: |
| if [ -d "$(CARAVEL_ROOT)" ]; then\ |
| echo "Deleting exisiting $(CARAVEL_ROOT)" && \ |
| rm -rf $(CARAVEL_ROOT) && sleep 2;\ |
| fi |
| echo "Installing $(CARAVEL_NAME).." |
| git clone -b $(CARAVEL_TAG) $(CARAVEL_REPO) $(CARAVEL_ROOT) --depth=1 |
| |
| # Install DV setup |
| .PHONY: simenv |
| simenv: |
| docker pull efabless/dv:latest |
| |
| .PHONY: setup |
| setup: install check-env install_mcw openlane pdk-with-volare setup-timing-scripts |
| |
| # Openlane |
| blocks=$(shell cd openlane && find * -maxdepth 0 -type d) |
| .PHONY: $(blocks) |
| $(blocks): % : |
| $(MAKE) -C openlane $* |
| |
| dv_patterns=$(shell cd verilog/dv && find * -maxdepth 0 -type d) |
| dv-targets-rtl=$(dv_patterns:%=verify-%-rtl) |
| dv-targets-gl=$(dv_patterns:%=verify-%-gl) |
| dv-targets-gl-sdf=$(dv_patterns:%=verify-%-gl-sdf) |
| |
| TARGET_PATH=$(shell pwd) |
| verify_command="source ~/.bashrc && cd ${TARGET_PATH}/verilog/dv/$* && export SIM=${SIM} && make" |
| dv_base_dependencies=simenv |
| docker_run_verify=\ |
| docker run -v ${TARGET_PATH}:${TARGET_PATH} -v ${PDK_ROOT}:${PDK_ROOT} \ |
| -v ${CARAVEL_ROOT}:${CARAVEL_ROOT} \ |
| -e TARGET_PATH=${TARGET_PATH} -e PDK_ROOT=${PDK_ROOT} \ |
| -e CARAVEL_ROOT=${CARAVEL_ROOT} \ |
| -e TOOLS=/foss/tools/riscv-gnu-toolchain-rv32i/217e7f3debe424d61374d31e33a091a630535937 \ |
| -e DESIGNS=$(TARGET_PATH) \ |
| -e USER_PROJECT_VERILOG=$(TARGET_PATH)/verilog \ |
| -e PDK=$(PDK) \ |
| -e CORE_VERILOG_PATH=$(TARGET_PATH)/mgmt_core_wrapper/verilog \ |
| -e CARAVEL_VERILOG_PATH=$(TARGET_PATH)/caravel/verilog \ |
| -e MCW_ROOT=$(MCW_ROOT) \ |
| -u $$(id -u $$USER):$$(id -g $$USER) efabless/dv:latest \ |
| sh -c $(verify_command) |
| |
| .PHONY: harden |
| harden: $(blocks) |
| |
| .PHONY: verify |
| verify: $(dv-targets-rtl) |
| |
| .PHONY: verify-all-rtl |
| verify-all-rtl: $(dv-targets-rtl) |
| |
| .PHONY: verify-all-gl |
| verify-all-gl: $(dv-targets-gl) |
| |
| .PHONY: verify-all-gl-sdf |
| verify-all-gl-sdf: $(dv-targets-gl-sdf) |
| |
| $(dv-targets-rtl): SIM=RTL |
| $(dv-targets-rtl): verify-%-rtl: $(dv_base_dependencies) |
| $(docker_run_verify) |
| |
| $(dv-targets-gl): SIM=GL |
| $(dv-targets-gl): verify-%-gl: $(dv_base_dependencies) |
| $(docker_run_verify) |
| |
| $(dv-targets-gl-sdf): SIM=GL_SDF |
| $(dv-targets-gl-sdf): verify-%-gl-sdf: $(dv_base_dependencies) |
| $(docker_run_verify) |
| |
| clean-targets=$(blocks:%=clean-%) |
| .PHONY: $(clean-targets) |
| $(clean-targets): clean-% : |
| rm -f ./verilog/gl/$*.v |
| rm -f ./spef/$*.spef |
| rm -f ./sdc/$*.sdc |
| rm -f ./sdf/$*.sdf |
| rm -f ./gds/$*.gds |
| rm -f ./mag/$*.mag |
| rm -f ./lef/$*.lef |
| rm -f ./maglef/*.maglef |
| |
| make_what=setup $(blocks) $(dv-targets-rtl) $(dv-targets-gl) $(dv-targets-gl-sdf) $(clean-targets) |
| .PHONY: what |
| what: |
| # $(make_what) |
| |
| # Install Openlane |
| .PHONY: openlane |
| openlane: |
| @if [ "$$(realpath $${OPENLANE_ROOT})" = "$$(realpath $$(pwd)/openlane)" ]; then\ |
| echo "OPENLANE_ROOT is set to '$$(pwd)/openlane' which contains openlane config files"; \ |
| echo "Please set it to a different directory"; \ |
| exit 1; \ |
| fi |
| cd openlane && $(MAKE) openlane |
| |
| #### Not sure if the targets following are of any use |
| |
| # Create symbolic links to caravel's main files |
| .PHONY: simlink |
| simlink: check-caravel |
| ### Symbolic links relative path to $CARAVEL_ROOT |
| $(eval MAKEFILE_PATH := $(shell realpath --relative-to=openlane $(CARAVEL_ROOT)/openlane/Makefile)) |
| $(eval PIN_CFG_PATH := $(shell realpath --relative-to=openlane/user_project_wrapper $(CARAVEL_ROOT)/openlane/user_project_wrapper_empty/pin_order.cfg)) |
| mkdir -p openlane |
| mkdir -p openlane/user_project_wrapper |
| cd openlane &&\ |
| ln -sf $(MAKEFILE_PATH) Makefile |
| cd openlane/user_project_wrapper &&\ |
| ln -sf $(PIN_CFG_PATH) pin_order.cfg |
| |
| # Update Caravel |
| .PHONY: update_caravel |
| update_caravel: check-caravel |
| cd $(CARAVEL_ROOT)/ && git checkout $(CARAVEL_TAG) && git pull |
| |
| # Uninstall Caravel |
| .PHONY: uninstall |
| uninstall: |
| rm -rf $(CARAVEL_ROOT) |
| |
| |
| # Install Pre-check |
| # Default installs to the user home directory, override by "export PRECHECK_ROOT=<precheck-installation-path>" |
| .PHONY: precheck |
| precheck: |
| @git clone --depth=1 --branch $(MPW_TAG) https://github.com/efabless/mpw_precheck.git $(PRECHECK_ROOT) |
| @docker pull efabless/mpw_precheck:latest |
| |
| .PHONY: run-precheck |
| run-precheck: check-pdk check-precheck |
| $(eval INPUT_DIRECTORY := $(shell pwd)) |
| cd $(PRECHECK_ROOT) && \ |
| docker run -v $(PRECHECK_ROOT):$(PRECHECK_ROOT) \ |
| -v $(INPUT_DIRECTORY):$(INPUT_DIRECTORY) \ |
| -v $(PDK_ROOT):$(PDK_ROOT) \ |
| -e INPUT_DIRECTORY=$(INPUT_DIRECTORY) \ |
| -e PDK_PATH=$(PDK_ROOT)/$(PDK) \ |
| -e PDK_ROOT=$(PDK_ROOT) \ |
| -e PDKPATH=$(PDKPATH) \ |
| -u $(shell id -u $(USER)):$(shell id -g $(USER)) \ |
| efabless/mpw_precheck:latest bash -c "cd $(PRECHECK_ROOT) ; python3 mpw_precheck.py --input_directory $(INPUT_DIRECTORY) --pdk_path $(PDK_ROOT)/$(PDK)" |
| |
| |
| |
| .PHONY: clean |
| clean: |
| cd ./verilog/dv/ && \ |
| $(MAKE) -j$(THREADS) clean |
| |
| check-caravel: |
| @if [ ! -d "$(CARAVEL_ROOT)" ]; then \ |
| echo "Caravel Root: "$(CARAVEL_ROOT)" doesn't exists, please export the correct path before running make. "; \ |
| exit 1; \ |
| fi |
| |
| check-precheck: |
| @if [ ! -d "$(PRECHECK_ROOT)" ]; then \ |
| echo "Pre-check Root: "$(PRECHECK_ROOT)" doesn't exists, please export the correct path before running make. "; \ |
| exit 1; \ |
| fi |
| |
| check-pdk: |
| @if [ ! -d "$(PDK_ROOT)" ]; then \ |
| echo "PDK Root: "$(PDK_ROOT)" doesn't exists, please export the correct path before running make. "; \ |
| exit 1; \ |
| fi |
| |
| .PHONY: help |
| help: |
| cd $(CARAVEL_ROOT) && $(MAKE) help |
| @$(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 '^$@$$' |
| |
| |
| export CUP_ROOT=$(shell pwd) |
| export TIMING_ROOT?=$(shell pwd)/deps/timing-scripts |
| export PROJECT_ROOT=$(CUP_ROOT) |
| timing-scripts-repo=https://github.com/efabless/timing-scripts.git |
| |
| $(TIMING_ROOT): |
| @mkdir -p $(CUP_ROOT)/deps |
| @git clone $(timing-scripts-repo) $(TIMING_ROOT) |
| |
| .PHONY: setup-timing-scripts |
| setup-timing-scripts: $(TIMING_ROOT) |
| @( cd $(TIMING_ROOT) && git pull ) |
| @#( cd $(TIMING_ROOT) && git fetch && git checkout $(MPW_TAG); ) |
| @python3 -m venv ./venv |
| . ./venv/bin/activate && \ |
| python3 -m pip install --upgrade pip && \ |
| python3 -m pip install -r $(TIMING_ROOT)/requirements.txt && \ |
| deactivate |
| |
| ./verilog/gl/user_project_wrapper.v: |
| $(error you don't have $@) |
| |
| ./env/spef-mapping.tcl: |
| @echo "run the following:" |
| @echo "make extract-parasitics" |
| @echo "make create-spef-mapping" |
| exit 1 |
| |
| .PHONY: create-spef-mapping |
| create-spef-mapping: ./verilog/gl/user_project_wrapper.v |
| @. ./venv/bin/activate && \ |
| python3 $(TIMING_ROOT)/scripts/generate_spef_mapping.py \ |
| -i ./verilog/gl/user_project_wrapper.v \ |
| -o ./env/spef-mapping.tcl \ |
| --pdk-path $(PDK_ROOT)/$(PDK) \ |
| --macro-parent mprj \ |
| --project-root "$(CUP_ROOT)" && \ |
| deactivate |
| |
| .PHONY: extract-parasitics |
| extract-parasitics: ./verilog/gl/user_project_wrapper.v |
| @. ./venv/bin/activate && \ |
| python3 $(TIMING_ROOT)/scripts/get_macros.py \ |
| -i ./verilog/gl/user_project_wrapper.v \ |
| -o ./tmp-macros-list \ |
| --project-root "$(CUP_ROOT)" \ |
| --pdk-path $(PDK_ROOT)/$(PDK) && \ |
| deactivate |
| @cat ./tmp-macros-list | cut -d " " -f2 \ |
| | xargs -I % bash -c "$(MAKE) -C $(TIMING_ROOT) \ |
| -f $(TIMING_ROOT)/timing.mk rcx-% || echo 'Cannot extract %. Probably no def for this macro'" |
| @$(MAKE) -C $(TIMING_ROOT) -f $(TIMING_ROOT)/timing.mk rcx-user_project_wrapper |
| @cat ./tmp-macros-list |
| @rm ./tmp-macros-list |
| |
| .PHONY: caravel-sta |
| caravel-sta: ./env/spef-mapping.tcl |
| @$(MAKE) -C $(TIMING_ROOT) -f $(TIMING_ROOT)/timing.mk caravel-timing-typ |
| @$(MAKE) -C $(TIMING_ROOT) -f $(TIMING_ROOT)/timing.mk caravel-timing-fast |
| @$(MAKE) -C $(TIMING_ROOT) -f $(TIMING_ROOT)/timing.mk caravel-timing-slow |
| @echo "You can find results for all corners in $(CUP_ROOT)/signoff/caravel/openlane-signoff/timing/" |
| |
| my_rtl_sim: |
| touch verilog/dv/io_ports/io_ports.c |
| make verify-io_ports-rtl |
| |
| gtk_rtl_sim: my_rtl_sim |
| gtkwave verilog/dv/io_ports/gtkwave_config.sav |
| |