From 113708c68f0b1ed408fd0f41c0b7365c9f943057 Mon Sep 17 00:00:00 2001 From: tangxifan Date: Tue, 6 Oct 2020 11:56:10 -0600 Subject: [PATCH] [Documentation] Reorganization the overview part by adding technical highlights --- docs/source/index.rst | 5 +- docs/source/manual/fpga_verilog/testbench.rst | 10 ++ .../openfpga_shell/launch_openfpga_shell.rst | 2 - .../{ => overview}/figures/OpenFPGA_logo.pdf | Bin .../{ => overview}/figures/OpenFPGA_logo.png | Bin .../figures/fpga_sdc_motivation.png | Bin .../figures/fpga_verilog_motivation.png | Bin .../figures/openfpga_arch_lang_coverage.png | Bin .../{ => overview}/figures/openfpga_flow.png | Bin .../figures/openfpga_motivation.png | Bin docs/source/overview/index.rst | 9 ++ docs/source/{ => overview}/motivation.rst | 0 docs/source/overview/tech_highlights.rst | 90 ++++++++++++++++++ 13 files changed, 112 insertions(+), 4 deletions(-) rename docs/source/{ => overview}/figures/OpenFPGA_logo.pdf (100%) rename docs/source/{ => overview}/figures/OpenFPGA_logo.png (100%) rename docs/source/{ => overview}/figures/fpga_sdc_motivation.png (100%) rename docs/source/{ => overview}/figures/fpga_verilog_motivation.png (100%) rename docs/source/{ => overview}/figures/openfpga_arch_lang_coverage.png (100%) rename docs/source/{ => overview}/figures/openfpga_flow.png (100%) rename docs/source/{ => overview}/figures/openfpga_motivation.png (100%) create mode 100644 docs/source/overview/index.rst rename docs/source/{ => overview}/motivation.rst (100%) create mode 100644 docs/source/overview/tech_highlights.rst diff --git a/docs/source/index.rst b/docs/source/index.rst index 9a317c924..f507a8c54 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -7,9 +7,10 @@ Welcome to OpenFPGA's documentation! ==================================== .. toctree:: - :caption: Motivation + :maxdepth: 2 + :caption: Overview - motivation + overview/index .. toctree:: :maxdepth: 2 diff --git a/docs/source/manual/fpga_verilog/testbench.rst b/docs/source/manual/fpga_verilog/testbench.rst index 1be9ec688..dfdb22e8e 100644 --- a/docs/source/manual/fpga_verilog/testbench.rst +++ b/docs/source/manual/fpga_verilog/testbench.rst @@ -5,6 +5,16 @@ Testbench In this part, we will introduce the hierarchy, dependency and functionality of each Verilog testbench, which are generated to verify a FPGA fabric implemented with an application. ++-----------------+---------+----------------+---------------+ +| Testbench Type | Runtime | Test Vector | Test Coverage | ++=================+=========+================+===============+ +| Full | Long | Random Stimuli | Full fabric | ++-----------------+---------+----------------+---------------+ +| Formal-oriented | Short | Random Stimuli | Programmable | +| | | or | fabric only | +| | | Formal Method | | ++-----------------+---------+----------------+---------------+ + OpenFPGA can auto-generate two types of Verilog testbenches to validate the correctness of the fabric: full and formal-oriented. Both testbenches share the same organization, as depicted in :numref:`fig_verilog_testbench_organization` (a). To enable self-testing, the FPGA and user's RTL design (simulate using an HDL simulator) are driven by the same input stimuli, and any mismatch on their outputs will raise an error flag. diff --git a/docs/source/manual/openfpga_shell/launch_openfpga_shell.rst b/docs/source/manual/openfpga_shell/launch_openfpga_shell.rst index 8ef7e3858..3ef6e9fb5 100644 --- a/docs/source/manual/openfpga_shell/launch_openfpga_shell.rst +++ b/docs/source/manual/openfpga_shell/launch_openfpga_shell.rst @@ -11,8 +11,6 @@ To launch OpenFPGA shell, users can choose two modes. Launch OpenFPGA in interactive mode where users type-in command by command and get runtime results - .. warning:: Currently OpenFPGA does not support continued lines and comments - .. option:: --file or -f Launch OpenFPGA in script mode where users write commands in scripts and FPGA will execute them diff --git a/docs/source/figures/OpenFPGA_logo.pdf b/docs/source/overview/figures/OpenFPGA_logo.pdf similarity index 100% rename from docs/source/figures/OpenFPGA_logo.pdf rename to docs/source/overview/figures/OpenFPGA_logo.pdf diff --git a/docs/source/figures/OpenFPGA_logo.png b/docs/source/overview/figures/OpenFPGA_logo.png similarity index 100% rename from docs/source/figures/OpenFPGA_logo.png rename to docs/source/overview/figures/OpenFPGA_logo.png diff --git a/docs/source/figures/fpga_sdc_motivation.png b/docs/source/overview/figures/fpga_sdc_motivation.png similarity index 100% rename from docs/source/figures/fpga_sdc_motivation.png rename to docs/source/overview/figures/fpga_sdc_motivation.png diff --git a/docs/source/figures/fpga_verilog_motivation.png b/docs/source/overview/figures/fpga_verilog_motivation.png similarity index 100% rename from docs/source/figures/fpga_verilog_motivation.png rename to docs/source/overview/figures/fpga_verilog_motivation.png diff --git a/docs/source/figures/openfpga_arch_lang_coverage.png b/docs/source/overview/figures/openfpga_arch_lang_coverage.png similarity index 100% rename from docs/source/figures/openfpga_arch_lang_coverage.png rename to docs/source/overview/figures/openfpga_arch_lang_coverage.png diff --git a/docs/source/figures/openfpga_flow.png b/docs/source/overview/figures/openfpga_flow.png similarity index 100% rename from docs/source/figures/openfpga_flow.png rename to docs/source/overview/figures/openfpga_flow.png diff --git a/docs/source/figures/openfpga_motivation.png b/docs/source/overview/figures/openfpga_motivation.png similarity index 100% rename from docs/source/figures/openfpga_motivation.png rename to docs/source/overview/figures/openfpga_motivation.png diff --git a/docs/source/overview/index.rst b/docs/source/overview/index.rst new file mode 100644 index 000000000..32b8fa75f --- /dev/null +++ b/docs/source/overview/index.rst @@ -0,0 +1,9 @@ +.. _overview: + Overview + +.. toctree:: + :maxdepth: 2 + + motivation + + tech_highlights diff --git a/docs/source/motivation.rst b/docs/source/overview/motivation.rst similarity index 100% rename from docs/source/motivation.rst rename to docs/source/overview/motivation.rst diff --git a/docs/source/overview/tech_highlights.rst b/docs/source/overview/tech_highlights.rst new file mode 100644 index 000000000..8ec322b67 --- /dev/null +++ b/docs/source/overview/tech_highlights.rst @@ -0,0 +1,90 @@ +Technical Highlights +-------------------- + +The follow lists of technical features are created to help users spot their needs in customizing FPGA fabrics.(**as of October 2020**) + +Supported Circuit Designs +~~~~~~~~~~~~~~~~~~~~~~~~~ + ++---------------+-----------------+--------------+-------------------------+ +| Circuit Types | Auto-generation | User-Defined | Design Topologies | ++===============+=================+==============+=========================+ +| Inverter | Yes | Yes | - Power-gating | ++---------------+-----------------+--------------+-------------------------+ +| Buffer | Yes | Yes | - Tapered buffers | +| | | | - Power-gating | ++---------------+-----------------+--------------+-------------------------+ +| AND gate | Yes | Yes | - 2-input | ++---------------+-----------------+--------------+-------------------------+ +| OR gate | Yes | Yes | - 2-input | ++---------------+-----------------+--------------+-------------------------+ +| MUX2 gate | Yes | Yes | - 2-input | ++---------------+-----------------+--------------+-------------------------+ +| Pass gate | Yes | Yes | - Transmission gate | +| | | | - Pass transistor | ++---------------+-----------------+--------------+-------------------------+ +| Look-Up Table | Yes | Yes | - **Any size** | +| | | | - Single-output LUT | +| | | | - Fracturable LUT | +| | | | - Buffer location | ++---------------+-----------------+--------------+-------------------------+ +| Routing | Yes | No | - **Any size** | +| Multiplexer | | | - Buffer location | +| | | | - One-level structure | +| | | | - Treee structure | +| | | | - Multi-level structure | +| | | | - Local encoders | +| | | | - Constant inputs | ++---------------+-----------------+--------------+-------------------------+ +| Configurable | No | Yes | - Latch | +| Memory | | | - SRAM | +| | | | - D-type flip-flop | ++---------------+-----------------+--------------+-------------------------+ +| Block RAM | No | Yes | - Single-port | +| | | | - Dual-port | +| | | | - Fracturable | +| | | | - **Any size** | ++---------------+-----------------+--------------+-------------------------+ +| Arithmetic | No | Yes | - **Any size** | +| Units | | | - Multiplier | +| | | | - Adder | ++---------------+-----------------+--------------+-------------------------+ +| I/O | No | Yes | - General purpose I/O | +| | | | - Bi-directional buffer | +| | | | - AIB | ++---------------+-----------------+--------------+-------------------------+ + + +* The user defined netlist could come from a standard cell + +Supported FPGA Architectures +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +We support most FPGA architectures that VPR can support! +The following are most commonly seen architectural features: + ++--------------------+----------------------------------------------+ +| Block Type | Architecture features | ++====================+==============================================+ +| Programmable Block | - Single-mode Configurable Logic Block (CLB) | +| | - Multi-mode Configurable Logic Block (CLB) | +| | - Single-mode heterogeneous blocks | +| | - Multi-mode heterogeneous blocks | +| | - Flexible local routing architecture | ++--------------------+----------------------------------------------+ +| Routing Block | - Tileable routing architecture | +| | - Flexible connectivity | +| | - Flexible Switch Block Patterns | ++--------------------+----------------------------------------------+ + +Supported Verilog Modeling +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +OpenFPGA supports the following Verilog features in auto-generated netlists for circuit designs + +- Synthesizable Behavioral Verilog + +- Structural Verilog + +- Implicit/Explicit port mapping +