From 92d7da762b63af1f2fdd8687608b59763c0b2a8b Mon Sep 17 00:00:00 2001 From: sovanna Date: Fri, 19 Jul 2019 15:29:19 +0200 Subject: [PATCH] refactor(Migen): Reviews layout and md file --- content/gateware/migen.md | 109 ++++++++---------- .../shortcodes/layout_centered_content.html | 10 +- 2 files changed, 55 insertions(+), 64 deletions(-) diff --git a/content/gateware/migen.md b/content/gateware/migen.md index a80bcc9..80c013a 100644 --- a/content/gateware/migen.md +++ b/content/gateware/migen.md @@ -9,89 +9,74 @@ logo_size = 125 title = "Migen" +++ -{% centerp(safe=true) %} -
Migen is a Python-based tool that automates further the VLSI design process.
+ +{% layout_centered_content() %} +##### Migen is a Python-based tool that automates further the VLSI design process. {% end %} -{% layoutlr1() %} +
+ +{% layout_div(css="col-12 col-md-6") %} + +Despite being faster than schematics entry, hardware design with Verilog and VHDL remains tedious and inefficient for several reasons. The event-driven model introduces issues and manual coding that are unnecessary for synchronous circuits, which represent the lion's share of today's logic designs. Counter-intuitive arithmetic rules result in steeper learning curves and provide a fertile ground for subtle bugs in designs. Finally, support for procedural generation of logic (metaprogramming) through "generate" statements is very limited and restricts the ways code can be made generic, reused and organized. + +{% end %} + +{% layout_div(css="col-12 col-md-6") %} + +To address those issues, we have developed the Migen FHDL library that replaces the event-driven paradigm with the notions of combinatorial and synchronous statements, has arithmetic rules that make integers always behave like mathematical integers, and most importantly allows the design's logic to be constructed by a Python program. This last point enables hardware designers to take advantage of the richness of the Python language - object oriented programming, function parameters, generators, operator overloading, libraries, etc. - to build well organized, reusable and elegant designs. + +{% end %} -
-

- Despite being faster than schematics entry, hardware design with Verilog and VHDL remains tedious and inefficient for several reasons. The event-driven model introduces issues and manual coding that are unnecessary for synchronous circuits, which represent the lion's share of today's logic designs. Counter-intuitive arithmetic rules result in steeper learning curves and provide a fertile ground for subtle bugs in designs. Finally, support for procedural generation of logic (metaprogramming) through "generate" statements is very limited and restricts the ways code can be made generic, reused and organized. -

-
-

- To address those issues, we have developed the Migen FHDL library that replaces the event-driven paradigm with the notions of combinatorial and synchronous statements, has arithmetic rules that make integers always behave like mathematical integers, and most importantly allows the design's logic to be constructed by a Python program. This last point enables hardware designers to take advantage of the richness of the Python language - object oriented programming, function parameters, generators, operator overloading, libraries, etc. - to build well organized, reusable and elegant designs. -

-
+ +{% layout_centered_content(min_width=true) %} + +Other Migen libraries are built on FHDL and provide various tools such as a system-on-chip interconnect infrastructure, a dataflow programming system, a more traditional high-level synthesizer that compiles Python routines into state machines with datapaths, and a simulator that allows test benches to be written in Python. + +Migen is the foundation for MiSoC. {% end %} -{% layoutlr1() %} -
+{% layout_centered_content(min_width=true, force_left=true, card=true) %} -

Other Migen libraries are built on FHDL and provide various tools such as a system-on-chip interconnect infrastructure, a dataflow programming system, a more traditional high-level synthesizer that compiles Python routines into state machines with datapaths, and a simulator that allows test benches to be written in Python.

+##### More... -

Migen is the foundation for MiSoC.

+You can find the Migen source here, released under the permissive BSD license. -
+**Documentation** (note: sometimes out of date - please help!) -
+- User guide +- Tutorial: An introduction to Migen +- Lecture slides +- Tutorial "Porting a New Board To Migen" by cr1901 +- "Implementing a UART in Verilog and Migen" by whitequark +- "Implementing a simple SoC in Migen" by whitequark +- Migen Step by Step Tutorial by LambdaConcept -
-
More...
-

You can find the Migen source here, released under the permissive BSD license.

-

Documentation (note: sometimes out of date - please help!)

- -
- -
{% end %} -{% layoutlr1() %} -
-
MiSoC
+{% layout_text_img(src="images/side-graphic-min.png", alt="", textleft=true, shadow=false) %} -

Built on Migen, MiSoC provides a high performance, flexible and lightweight solution to build system-on-chips for various applications.

+##### MiSoC -
    -
  • - CPU options: -
      -
    • LatticeMico32, modified to include an optional MMU (experimental).
      • -
    • mor1kx, a better OpenRISC implementation.
      • -
    -
    • -
  • Memory controller supports SDR, DDR, LPDDR, DDR2 and DDR3.
    • -
  • Provided peripherals: UART, GPIO, timer, GPIO, NOR flash controller, SPI flash controller, Ethernet MAC, and more.
    • -
  • High performance: on Spartan-6, 83MHz system clock frequencies, 10+Gbps DDR SDRAM bandwidth, 1080p 32bpp framebuffer, etc.
    • -
  • Low resource usage: basic implementation fits easily in Spartan-6 LX9.
    • -
  • Portable and easy to customize thanks to Python- and Migen-based architecture.
    • -
  • Design new peripherals using Migen and benefit from automatic CSR maps and logic, simplified DMAs, etc.
    • -
  • Possibility to encapsulate legacy Verilog/VHDL code.
    • -
- -

The MiSoC source is here, mostly covered by the permissive BSD license.

- -
+Built on Migen, MiSoC provides a high performance, flexible and lightweight solution to build system-on-chips for various applications. -
- -
+- CPU options: + - LatticeMico32, modified to include an optional MMU (experimental). + - mor1kx, a better OpenRISC implementation. +- Memory controller supports SDR, DDR, LPDDR, DDR2 and DDR3. +- Provided peripherals: UART, GPIO, timer, GPIO, NOR flash controller, SPI flash controller, Ethernet MAC, and more. +- High performance: on Spartan-6, 83MHz system clock frequencies, 10+Gbps DDR SDRAM bandwidth, 1080p 32bpp framebuffer, etc. +- Low resource usage: basic implementation fits easily in Spartan-6 LX9. +- Portable and easy to customize thanks to Python- and Migen-based architecture. +- Design new peripherals using Migen and benefit from automatic CSR maps and logic, simplified DMAs, etc. +- Possibility to encapsulate legacy Verilog/VHDL code. -{% end %} \ No newline at end of file +{% end %} diff --git a/templates/shortcodes/layout_centered_content.html b/templates/shortcodes/layout_centered_content.html index dd495e7..2342325 100644 --- a/templates/shortcodes/layout_centered_content.html +++ b/templates/shortcodes/layout_centered_content.html @@ -1,8 +1,14 @@
-
+
- {{ body | markdown | safe }} + {% if card %} +
+ {{ body | markdown | safe }} +
+ {% else %} + {{ body | markdown | safe }} + {% endif %}