3 .PHONY
: help Makefile gitupdate
install run_sim
test htmlupload
7 git submodule update
--init
--recursive
--remote
11 cp pinmux
/ls180
/ls180_pins.py src
/soc
/debug
12 cp pinmux
/ls180
/ls180_pins.py src
/soc
/litex
/florent
/libresoc
14 install: gitupdate develop mkpinmux
16 # this is now actually part of openpower-isa repository
18 echo
"pywriter is part of openpower-isa, run that instead"
20 # this is now actually part of openpower-isa repository
22 echo
"sv_analysis is part of openpower-isa, run that instead"
25 python3 setup.py develop
# yes, develop, not install
27 # build and run libresoc litex simulation
29 python3 src
/soc
/simple
/issuer_verilog.py
--disable-svp64 \
30 src
/soc
/litex
/florent
/libresoc
/libresoc.v
31 python3 src
/soc
/litex
/florent
/sim.py
--cpu
=libresoc
33 # and with test gpio (useful for XICS IRC testing)
35 python3 src
/soc
/simple
/issuer_verilog.py \
36 src
/soc
/litex
/florent
/libresoc
/libresoc.v \
38 python3 src
/soc
/litex
/florent
/sim.py
--cpu
=libresoc \
39 --variant
=standardjtagtestgpio
42 python3 src
/soc
/simple
/issuer_verilog.py \
43 --debug
=jtag
--enable-core
--disable-pll \
44 --enable-xics
--disable-svp64 \
45 src
/soc
/litex
/florent
/libresoc
/libresoc.v
48 python3 src
/soc
/simple
/issuer_verilog.py \
49 --debug
=jtag
--enable-core
--enable-pll \
50 --enable-xics
--disable-svp64 \
51 src
/soc
/litex
/florent
/libresoc
/libresoc.v
54 python3 src
/soc
/simple
/issuer_verilog.py \
55 --debug
=jtag
--enable-core
--enable-pll \
56 --enable-xics
--enable-sram4x4kblock
--disable-svp64 \
57 src
/soc
/litex
/florent
/libresoc
/libresoc.v
59 # build microwatt "external core", note that the TLB set size is set to 16
60 # for I/D-Cache which needs a corresponding alteration of the device-tree
62 microwatt_external_core
:
63 python3 src
/soc
/simple
/issuer_verilog.py
--microwatt-compat
--enable-mmu \
66 # build microwatt "external core" with fixed 64-bit width SVP64
67 # note that the TLB set size is set to 16
68 # for I/D-Cache which needs a corresponding alteration of the device-tree
70 microwatt_external_core_svp64
:
71 python3 src
/soc
/simple
/issuer_verilog.py
--microwatt-compat-svp64
--enable-mmu \
74 microwatt_external_core_spi
:
75 python3 src
/soc
/simple
/issuer_verilog.py
--microwatt-compat \
78 --pc-reset
0x10000000 \
81 # microwatt-compatible core with smaller cache size (quick. VERSA_ECP5. just)
82 microwatt_external_core_bram
:
83 python3 src
/soc
/simple
/issuer_verilog.py
--microwatt-compat \
86 --pc-reset
0xFF000000 \
89 # microwatt-compatible core with larger cache size (experiment on arty)
90 microwatt_external_core_bram_arty
:
91 python3 src
/soc
/simple
/issuer_verilog.py
--microwatt-compat \
93 --pc-reset
0xFF000000 \
96 # build the litex libresoc SoC without 4k SRAMs
97 ls180_verilog_build
: ls180_verilog
98 make
-C soc
/soc
/litex
/florent ls180
100 # build the litex libresoc SoC with 4k SRAMs
101 ls180_4ksram_verilog_build
: ls180_4k_verilog
102 make
-C soc
/soc
/litex
/florent ls1804k
104 # testing (usually done at install time)
106 python3 setup.py
test # could just run nosetest3...
109 $(PYTHON3
) setup.py sdist upload
111 # Minimal makefile for Sphinx documentation
114 # You can set these variables from the command line.
116 SPHINXBUILD
= sphinx-build
117 SPHINXPROJ
= Libre-SOC
121 # Put it first so that "make" without argument is like "make help".
123 @
$(SPHINXBUILD
) -M help
"$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS
) $(O
)
125 # copies all documentation to libre-soc (libre-soc admins only)
126 htmlupload
: clean html
127 rsync
-HPavz
--delete build
/html
/* \
128 libre-soc.org
:/var
/www
/libre-soc.org
/docs
/soc
/
130 # Catch-all target: route all unknown targets to Sphinx using the new
131 # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
133 echo
"catch-all falling through to sphinx for document building"
134 mkdir
-p
"$(SOURCEDIR)"/src
/gen
135 sphinx-apidoc
--ext-autodoc
-o
"$(SOURCEDIR)"/src
/gen .
/src
/soc
136 @
$(SPHINXBUILD
) -M
$@
"$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS
) $(O
)