Merge pull request #527 from antmicro/umarcor/merge-f4pga-readme

merge readme from f4pga and update references

README.md

@@ -1,7 +1,49 @@
-# F4PGA
+# FOSS Flow For FPGA (F4PGA) project
 
-This is the entrypoint to the documentation of F4PGA.
+This is the top-level repository for the [F4PGA](https://f4pga.org/) project, which is a Workgroup under the [CHIPS Alliance](https://chipsalliance.org).
+The elements of the project include (but are not limited to):
 
-- [f4pga.readthedocs.io](https://f4pga.readthedocs.io)
-- [f4pga.readthedocs.io/projects/arch-defs](https://f4pga.readthedocs.io/projects/arch-defs)
-- [f4pga-examples.readthedocs.io](https://f4pga-examples.readthedocs.io)
+* The F4PGA open source FPGA toolchains for programming FPGAs (formerly known as [SymbiFlow](https://github.com/SymbiFlow)).
+  This includes:
+
+  * F4PGA documentation: [f4pga.readthedocs.io](https://f4pga.readthedocs.io) (knowledge base)
+  * F4PGA Architecture Definitions: [f4pga.readthedocs.io/projects/arch-defs](https://f4pga.readthedocs.io/projects/arch-defs)
+  * F4PGA examples: [f4pga-examples.readthedocs.io](https://f4pga-examples.readthedocs.io)
+  * [F4PGA Yosys plugins](https://github.com/f4pga/yosys-f4pga-plugins)
+
+* The FPGA interchange format (an interchange format defined by CHIPS Alliance to enable interoperability between
+  different FPGA tools) adopted by the F4PGA toolchain:
+
+  * [FPGA Interchange schema](https://github.com/chipsalliance/fpga-interchange-schema)
+  * [FPGA Interchange Python utilities](https://github.com/chipsalliance/python-fpga-interchange)
+  * [FPGA Interchange Test suite](https://github.com/SymbiFlow/fpga-interchange-tests)
+
+* The [FPGA tool performance framework](https://github.com/chipsalliance/fpga-tool-perf) framework for benchmarking
+  designs against various FPGA tools, and vice versa, over time.
+
+* FPGA Database visualisation tools for visual exploration of FPGA bitstream and databases:
+
+  * [F4PGA bitstream viewer](https://github.com/SymbiFlow/f4pga-bitstream-viewer)
+  * [F4PGA database visualizer](https://github.com/chipsalliance/f4pga-database-visualizer)
+
+* Other utilities (FPGA assembly format, documentation and other):
+
+  * [F4PGA Assembly (FASM)](https://github.com/chipsalliance/fasm)
+  * [Xilinx bitstream generation library](https://github.com/SymbiFlow/f4pga-xc-fasm)
+  * [Verilog-to-routing XML utilities](https://github.com/SymbiFlow/vtr-xml-utils)
+  * [SDF format utilities](https://github.com/chipsalliance/python-sdf-timing)
+  * [F4PGA tools data manager](https://github.com/SymbiFlow/symbiflow-tools-data-manager)
+  * [F4PGA Sphinx Theme](https://github.com/SymbiFlow/sphinx_symbiflow_theme)
+  * [F4PGA Sphinx HDL diagrams](https://github.com/SymbiFlow/sphinxcontrib-hdl-diagrams)
+  * [F4PGA Sphinx Verilog domain](https://github.com/SymbiFlow/sphinx-verilog-domain)
+
+## F4PGA Workgroup
+
+The F4PGA Workgroup consists of members from different backgrounds, including FPGA vendors
+([Xilinx](https://www.xilinx.com/) and [QuickLogic](https://www.quicklogic.com/)),
+industrial users
+([Google](https://www.google.com/), [Antmicro](https://antmicro.com/))
+and academia
+([University of Toronto](https://www.utoronto.ca/)),
+who collaborate to build a more open source and software-driven FPGA ecosystem (IP, tools and workflows) to drive the
+adoption of FPGAs in existing and new use cases, and eliminate barriers of entry.