From e6da8de64ecfd56cfc3642e36dfe33ae046a4af8 Mon Sep 17 00:00:00 2001 From: rcardoso Date: Mon, 2 Oct 2023 14:02:14 +0100 Subject: removed outdated quickstart --- QUICKSTART.md | 102 ---------------------------------------------------------- 1 file changed, 102 deletions(-) delete mode 100644 QUICKSTART.md diff --git a/QUICKSTART.md b/QUICKSTART.md deleted file mode 100644 index 70509ec..0000000 --- a/QUICKSTART.md +++ /dev/null @@ -1,102 +0,0 @@ -# Quickstart guide {#quickstart} - -[TOC] - -# Dependencies - -## Building toolchain - -* `git` -* `bash` -* `find` -* `make` -* a c++ compiler that supports c++14 or c++17 (`g++` or `clang++`) -* GNU `flex` (`lex` is untested) -* GNU `bison` (`yacc` is untested) - -Optional: - -* `python3` for generating the sources using the module definitions -* ... - -## External build dependencies - -* `systemc` (v2.3.3) - -## Documentation generation - -* `doxygen` -* `dot` (via `graphviz` for example) - -## Traces visualization - -* GTKWave -* `python3` -* `python3-matplotlib` -* ... - -# Building - -* First, make sure to install all the dependencies on your system, either locally or globally. -* Then, fetch the code: - - % git clone git@gitlab.inl90.ec-lyon.fr:czrounba/systemc-pcm-matrix-multiplication-simulator.git - % git submodule update --init --recursive - -* Copy `config.mk` to `config.local.mk` and update the compiler/library information there -* If you installed systemc in a non-default path, you might need to update the -`INCLUDES` and `LD_FLAGS` make variables in `config.mk`. -* Finally, build `specs` - % make -j$(nproc) -* Run a test circuits - % ./sim -t {waveguide,splitter,pcm,...} - -# Running - -Simulating a circuit from a netlist is straightforward: - - % ./sim -f .cir - -Look at the [cheatsheet](doc/resources/cheatsheet.pdf) for more information on the syntax to use. -[](TODO: add a page for info on syntax of circuit files) - -After running, you can find results in the VCD tracefile (the file name can be specified in the circuit file with option `-o`). - -# Generating documentation (OUTDATED) - -First make sure `doxygen` and `graphviz` are installed, then: - -* To generate the doc, run: - - % make doc - -* To open it in your default browser, run: - - % make view-doc - -The generated documentation is available as HTML under `doc/html/` and compressed -into a `tar.xz` archive under `doc/`. Other ouput formats are supported by `doxygen`. - -# Troubleshooting - - -- cgit v1.2.3