| # 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 | 
 |  | 
 | # cannot commit files larger than 100 MB to GitHub | 
 | FILE_SIZE_LIMIT_MB = 100 | 
 |  | 
 | # Commands to be used to compress/uncompress files | 
 | # they must operate **in place** (otherwise, modify the target to delete the | 
 | # intermediate file/archive) | 
 | COMPRESS ?= gzip -n --best | 
 | UNCOMPRESS ?= gzip -d | 
 | ARCHIVE_EXT ?= gz | 
 |  | 
 | # The following variables are to build static pattern rules | 
 |  | 
 | # Needed to rebuild archives that were previously split | 
 | SPLIT_FILES := $(shell find . -type f -name "*.$(ARCHIVE_EXT).00.split") | 
 | SPLIT_FILES_SOURCES := $(basename $(basename $(basename $(SPLIT_FILES)))) | 
 |  | 
 | # Needed to uncompress the existing archives | 
 | ARCHIVES := $(shell find . -type f -name "*.$(ARCHIVE_EXT)") | 
 | ARCHIVE_SOURCES := $(basename $(ARCHIVES)) | 
 |  | 
 | # Needed to compress and split files/archives that are too large | 
 | LARGE_FILES := $(shell find ./gds -type f -name "*.gds") | 
 | LARGE_FILES += $(shell find . -type f -size +$(FILE_SIZE_LIMIT_MB)M -not -path "./.git/*" -not -path "./gds/*" -not -path "./openlane/*") | 
 | LARGE_FILES_GZ := $(addsuffix .$(ARCHIVE_EXT), $(LARGE_FILES)) | 
 | LARGE_FILES_GZ_SPLIT := $(addsuffix .$(ARCHIVE_EXT).00.split, $(LARGE_FILES)) | 
 | # consider splitting existing archives | 
 | LARGE_FILES_GZ_SPLIT += $(addsuffix .00.split, $(ARCHIVES)) | 
 |  | 
 | # PDK setup configs | 
 | THREADS ?= $(shell nproc) | 
 | STD_CELL_LIBRARY ?= sky130_fd_sc_hd | 
 | SPECIAL_VOLTAGE_LIBRARY ?= sky130_fd_sc_hvl | 
 | IO_LIBRARY ?= sky130_fd_io | 
 | SKYWATER_COMMIT ?= 3d7617a1acb92ea883539bcf22a632d6361a5de4 | 
 | OPEN_PDKS_COMMIT ?= 49fc7125db927de199d1f69e002beadc0a29881b | 
 |  | 
 | .DEFAULT_GOAL := ship | 
 | # We need portable GDS_FILE pointers... | 
 | .PHONY: ship | 
 | ship: check-env uncompress | 
 | 	@echo "###############################################" | 
 | 	@echo "Generating Caravel GDS (sources are in the 'gds' directory)" | 
 | 	@sleep 1 | 
 | 	@echo "\ | 
 | 		gds readonly true; \ | 
 | 		gds rescale false; \ | 
 | 		gds read ../gds/user_project_wrapper.gds; \ | 
 | 		load caravel -dereference;\ | 
 | 		select top cell;\ | 
 | 		gds write caravel.gds; \ | 
 | 		exit;" > ./mag/mag2gds_caravel.tcl | 
 | 	@cd mag && PDKPATH=${PDK_ROOT}/sky130A magic -noc -dnull mag2gds_caravel.tcl < /dev/null | 
 | 	@rm ./mag/mag2gds_caravel.tcl | 
 | 	@mv -f ./gds/caravel.gds ./gds/caravel.old.gds | 
 | 	mv ./mag/caravel.gds ./gds | 
 |  | 
 |  | 
 |  | 
 | .PHONY: clean | 
 | clean: | 
 | 	cd ./verilog/dv/caravel/mgmt_soc/ && \ | 
 | 		$(MAKE) -j$(THREADS) clean | 
 | 	cd ./verilog/dv/caravel/user_proj_example/ && \ | 
 | 		$(MAKE) -j$(THREADS) clean | 
 |  | 
 |  | 
 | .PHONY: verify | 
 | verify: | 
 | 	cd ./verilog/dv/caravel/mgmt_soc/ && \ | 
 | 		$(MAKE) -j$(THREADS) all | 
 | 	cd ./verilog/dv/caravel/user_proj_example/ && \ | 
 | 		$(MAKE) -j$(THREADS) all | 
 |  | 
 |  | 
 |  | 
 | ##### | 
 | $(LARGE_FILES_GZ): %.$(ARCHIVE_EXT): % | 
 | 	@if ! [ $(suffix $<) == ".$(ARCHIVE_EXT)" ]; then\ | 
 | 		$(COMPRESS) $< > /dev/null &&\ | 
 | 		echo "$< -> $@";\ | 
 | 	fi | 
 |  | 
 | $(LARGE_FILES_GZ_SPLIT): %.$(ARCHIVE_EXT).00.split: %.$(ARCHIVE_EXT) | 
 | 	@if [ -n "$$(find "$<" -prune -size +$(FILE_SIZE_LIMIT_MB)M)" ]; then\ | 
 | 		split $< -b $(FILE_SIZE_LIMIT_MB)M $<. -d --additional-suffix=.split &&\ | 
 | 		rm $< &&\ | 
 | 		echo -n "$< -> $$(ls $<.*.split)" | tr '\n' ' ' && echo "";\ | 
 | 	fi | 
 |  | 
 | # This target compresses all files larger than $(FILE_SIZE_LIMIT_MB) MB | 
 | .PHONY: compress | 
 | compress: $(LARGE_FILES_GZ) $(LARGE_FILES_GZ_SPLIT) | 
 | 	@echo "Files larger than $(FILE_SIZE_LIMIT_MB) MBytes are compressed!" | 
 |  | 
 |  | 
 |  | 
 | ##### | 
 | $(ARCHIVE_SOURCES): %: %.$(ARCHIVE_EXT) | 
 | 	@$(UNCOMPRESS) $< | 
 | 	@echo "$< -> $@" | 
 |  | 
 | .SECONDEXPANSION: | 
 | $(SPLIT_FILES_SOURCES): %: $$(sort $$(wildcard %.$(ARCHIVE_EXT).*.split)) | 
 | 	@cat $? > $@.$(ARCHIVE_EXT) | 
 | 	@rm $? | 
 | 	@echo "$? -> $@.$(ARCHIVE_EXT)" | 
 | 	@$(UNCOMPRESS) $@.$(ARCHIVE_EXT) | 
 | 	@echo "$@.$(ARCHIVE_EXT) -> $@" | 
 |  | 
 |  | 
 | .PHONY: uncompress | 
 | uncompress: $(SPLIT_FILES_SOURCES) $(ARCHIVE_SOURCES) | 
 | 	@echo "All files are uncompressed!" | 
 |  | 
 |  | 
 | # LVS | 
 | BLOCKS = $(shell cd openlane && find * -maxdepth 0 -type d) | 
 | LVS_BLOCKS = $(foreach block, $(BLOCKS), lvs-$(block)) | 
 | $(LVS_BLOCKS): lvs-% : ./mag/%.mag ./verilog/gl/%.v | 
 | 	echo "Extracting $*" | 
 | 	mkdir -p ./mag/tmp | 
 | 	echo "load $* -dereference;\ | 
 | 		select top cell;\ | 
 | 		foreach cell [cellname list children] {\ | 
 | 			load \$$cell -dereference;\ | 
 | 			property LEFview TRUE;\ | 
 | 		};\ | 
 | 		load $* -dereference;\ | 
 | 		select top cell;\ | 
 | 		extract no all;\ | 
 | 		extract do local;\ | 
 | 		extract unique;\ | 
 | 		extract;\ | 
 | 		ext2spice lvs;\ | 
 | 		ext2spice $*.ext;\ | 
 | 		feedback save extract_$*.log;\ | 
 | 		exit;" > ./mag/extract_$*.tcl | 
 | 	cd mag && export MAGTYPE=maglef; magic -rcfile ${PDK_ROOT}/sky130A/libs.tech/magic/current/sky130A.magicrc -noc -dnull extract_$*.tcl < /dev/null | 
 | 	mv ./mag/$*.spice ./spi/lvs | 
 | 	rm ./mag/*.ext | 
 | 	mv -f ./mag/extract_$*.{tcl,log} ./mag/tmp | 
 | 	#### | 
 | 	mkdir -p ./spi/lvs/tmp | 
 | 	sh ./spi/lvs/run_lvs.sh ./spi/lvs/$*.spice ./verilog/gl/$*.v $* | 
 | 	@echo "" | 
 | 	python3 ./scripts/count_lvs.py -f ./verilog/gl/$*.v_comp.json | tee ./spi/lvs/tmp/$*.lvs.summary.log | 
 | 	mv -f ./verilog/gl/*{.out,.json,.log} ./spi/lvs/tmp 2> /dev/null || true | 
 | 	@echo "" | 
 | 	@echo "LVS: ./spi/lvs/$*.spice vs. ./verilog/gl/$*.v" | 
 | 	@echo "Comparison result: ./spi/lvs/tmp/$*.v_comp.out" | 
 |  | 
 | # connect-by-label is enabled here! | 
 | LVS_MAGLEF_BLOCKS = $(foreach block, $(BLOCKS), lvs-maglef-$(block)) | 
 | $(LVS_MAGLEF_BLOCKS): lvs-maglef-% : ./mag/%.mag ./verilog/gl/%.v | 
 | 	echo "Extracting $*" | 
 | 	mkdir -p ./maglef/tmp | 
 | 	echo "load $* -dereference;\ | 
 | 		select top cell;\ | 
 | 		foreach cell [cellname list children] {\ | 
 | 			load \$$cell -dereference;\ | 
 | 			property LEFview TRUE;\ | 
 | 		};\ | 
 | 		load $* -dereference;\ | 
 | 		select top cell;\ | 
 | 		extract no all;\ | 
 | 		extract do local;\ | 
 | 		extract;\ | 
 | 		ext2spice lvs;\ | 
 | 		ext2spice $*.ext;\ | 
 | 		feedback save extract_$*.log;\ | 
 | 		exit;" > ./mag/extract_$*.tcl | 
 | 	cd mag && export MAGTYPE=maglef; magic -noc -dnull extract_$*.tcl < /dev/null | 
 | 	mv ./mag/$*.spice ./spi/lvs | 
 | 	rm ./maglef/*.ext | 
 | 	mv -f ./mag/extract_$*.{tcl,log} ./maglef/tmp | 
 | 	#### | 
 | 	mkdir -p ./spi/lvs/tmp | 
 | 	sh ./spi/lvs/run_lvs.sh ./spi/lvs/$*.spice ./verilog/gl/$*.v $* | 
 | 	@echo "" | 
 | 	python3 ./scripts/count_lvs.py -f ./verilog/gl/$*.v_comp.json | tee ./spi/lvs/tmp/$*.maglef.lvs.summary.log | 
 | 	mv -f ./verilog/gl/*{.out,.json,.log} ./spi/lvs/tmp 2> /dev/null || true | 
 | 	@echo "" | 
 | 	@echo "LVS: ./spi/lvs/$*.spice vs. ./verilog/gl/$*.v" | 
 | 	@echo "Comparison result: ./spi/lvs/tmp/$*.v_comp.out" | 
 |  | 
 | # DRC | 
 | BLOCKS = $(shell cd openlane && find * -maxdepth 0 -type d) | 
 | DRC_BLOCKS = $(foreach block, $(BLOCKS), drc-$(block)) | 
 | $(DRC_BLOCKS): drc-% : ./gds/%.gds | 
 | 	echo "Running DRC on $*" | 
 | 	mkdir -p ./gds/tmp | 
 | 	cd gds && export DESIGN_IN_DRC=$* && export MAGTYPE=mag; magic -rcfile ${PDK_ROOT}/sky130A/libs.tech/magic/current/sky130A.magicrc -noc -dnull drc_on_gds.tcl < /dev/null | 
 | 	@echo "DRC result: ./gds/tmp/$*.drc" | 
 |  | 
 | # Antenna | 
 | BLOCKS = $(shell cd openlane && find * -maxdepth 0 -type d) | 
 | ANTENNA_BLOCKS = $(foreach block, $(BLOCKS), antenna-$(block)) | 
 | $(ANTENNA_BLOCKS): antenna-% : ./gds/%.gds | 
 | 	echo "Running Antenna Checks on $*" | 
 | 	mkdir -p ./gds/tmp | 
 | 	cd gds && export DESIGN_IN_ANTENNA=$* && export MAGTYPE=mag; magic -rcfile ${PDK_ROOT}/sky130A/libs.tech/magic/current/sky130A.magicrc -noc -dnull antenna_on_gds.tcl < /dev/null 2>&1 | tee ./tmp/$*.antenna | 
 | 	mv -f ./gds/*.ext ./gds/tmp/ | 
 | 	@echo "Antenna result: ./gds/tmp/$*.antenna" | 
 |  | 
 | .PHONY: help | 
 | 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 '^$@$$' | 
 |  | 
 |  | 
 | ########################################################################### | 
 | .PHONY: pdk | 
 | pdk: skywater-pdk skywater-library skywater-timing open_pdks build-pdk | 
 |  | 
 | $(PDK_ROOT)/skywater-pdk: | 
 | 	git clone https://github.com/google/skywater-pdk.git $(PDK_ROOT)/skywater-pdk | 
 |  | 
 | .PHONY: skywater-pdk | 
 | skywater-pdk: check-env $(PDK_ROOT)/skywater-pdk | 
 | 	cd $(PDK_ROOT)/skywater-pdk && \ | 
 | 		git checkout master && git pull && \ | 
 | 		git checkout -qf $(SKYWATER_COMMIT) | 
 |  | 
 | .PHONY: skywater-library | 
 | skywater-library: check-env $(PDK_ROOT)/skywater-pdk | 
 | 	cd $(PDK_ROOT)/skywater-pdk && \ | 
 | 		git submodule update --init libraries/$(STD_CELL_LIBRARY)/latest && \ | 
 | 		git submodule update --init libraries/$(IO_LIBRARY)/latest && \ | 
 | 		git submodule update --init libraries/$(SPECIAL_VOLTAGE_LIBRARY)/latest | 
 |  | 
 | skywater-timing: check-env $(PDK_ROOT)/skywater-pdk | 
 | 	cd $(PDK_ROOT)/skywater-pdk && \ | 
 | 		$(MAKE) -j$(THREADS) timing | 
 | ### OPEN_PDKS | 
 | $(PDK_ROOT)/open_pdks: | 
 | 	git clone git://opencircuitdesign.com/open_pdks $(PDK_ROOT)/open_pdks | 
 |  | 
 | .PHONY: open_pdks | 
 | open_pdks: check-env $(PDK_ROOT)/open_pdks | 
 | 	cd $(PDK_ROOT)/open_pdks && \ | 
 | 		git checkout master && git pull && \ | 
 | 		git checkout -qf $(OPEN_PDKS_COMMIT) | 
 |  | 
 | .PHONY: build-pdk | 
 | build-pdk: check-env $(PDK_ROOT)/open_pdks $(PDK_ROOT)/skywater-pdk | 
 | 	[ -d $(PDK_ROOT)/sky130A ] && \ | 
 | 		(echo "Warning: A sky130A build already exists under $(PDK_ROOT). It will be deleted first!" && \ | 
 | 		sleep 5 && \ | 
 | 		rm -rf $(PDK_ROOT)/sky130A) || \ | 
 | 		true | 
 | 	cd $(PDK_ROOT)/open_pdks && \ | 
 | 		./configure --enable-sky130-pdk=$(PDK_ROOT)/skywater-pdk/libraries --with-sky130-local-path=$(PDK_ROOT) && \ | 
 | 		cd sky130 && \ | 
 | 		$(MAKE) veryclean && \ | 
 | 		$(MAKE) && \ | 
 | 		$(MAKE) install-local | 
 |  | 
 | .RECIPE: manifest | 
 | manifest: mag/ maglef/ verilog/rtl/ scripts/ Makefile | 
 | 	touch manifest && \ | 
 | 	find verilog/rtl/* -type f ! -name "user_*.v" ! -name "manifest" ! -name "README" ! -name "defines.v" -exec shasum {} \; > manifest && \ | 
 | 	find maglef/*.mag -type f ! -name "user_project_wrapper.mag" -exec shasum {} \; >> manifest && \ | 
 | 	shasum mag/caravel.mag mag/.magicrc >> manifest | 
 | 	shasum scripts/set_user_id.py scripts/generate_fill.py scripts/compositor.py >> manifest | 
 |  | 
 |  | 
 | check-env: | 
 | ifndef PDK_ROOT | 
 | 	$(error PDK_ROOT is undefined, please export it before running make) | 
 | endif | 
 |  | 
 | # Make README.rst | 
 | README.rst: README.src.rst docs/source/getting-started.rst docs/source/tool-versioning.rst openlane/README.src.rst docs/source/caravel-with-openlane.rst Makefile | 
 | 	pip -q install rst_include && \ | 
 | 	rm -f README.rst && \ | 
 | 		rst_include include README.src.rst - | \ | 
 | 			sed \ | 
 | 				-e's@\.\/\_static@\/docs\/source\/\_static@g' \ | 
 | 				-e's@:doc:`tool-versioning`@`tool-versioning.rst <./docs/source/tool-versioning.rst>`__@g' \ | 
 | 				-e's@.. note::@**NOTE:**@g' \ | 
 | 				-e's@.. warning::@**WARNING:**@g' \ | 
 | 				> README.rst && \ | 
 | 		rst_include include openlane/README.src.rst - | \ | 
 | 			sed \ | 
 | 				-e's@https://github.com/efabless/caravel/blob/master/verilog@../verilog@g' \ | 
 | 				-e's@:ref:`getting-started`@`README.rst <../README.rst>`__@g' \ | 
 | 				-e's@https://github.com/efabless/caravel/blob/master/openlane/@./@g' \ | 
 | 				-e's@.. note::@**NOTE:**@g' \ | 
 | 				-e's@.. warning::@**WARNING:**@g' \ | 
 | 				> openlane/README.rst |