layered-firrtl

License	Apache-2.0
GroupId	org.easysoc
ArtifactId	layered-firrtl
Last Version	1.0.0
Release Date	Feb 23, 2021
Type	jar
Description	layered-firrtl layered-firrtl
Project URL	https://www.easysoc.org/
Project Organization	EasySoC
Source Code Management	https://github.com/easysoc/layered-firrtl

Download layered-firrtl

Filename	Size
layered-firrtl-1.0.0.pom
layered-firrtl-1.0.0.jar	141 KB
layered-firrtl-1.0.0-sources.jar	17 KB
layered-firrtl-1.0.0-javadoc.jar	1 MB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.easysoc/layered-firrtl/ -->
<dependency>
    <groupId>org.easysoc</groupId>
    <artifactId>layered-firrtl</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.easysoc/layered-firrtl/
implementation 'org.easysoc:layered-firrtl:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.easysoc/layered-firrtl/
implementation ("org.easysoc:layered-firrtl:1.0.0")

Apache Buildr

'org.easysoc:layered-firrtl:jar:1.0.0'

Apache Ivy

<dependency org="org.easysoc" name="layered-firrtl" rev="1.0.0">
  <artifact name="layered-firrtl" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.easysoc', module='layered-firrtl', version='1.0.0')
)

Scala SBT

libraryDependencies += "org.easysoc" % "layered-firrtl" % "1.0.0"

Leiningen

[org.easysoc/layered-firrtl "1.0.0"]

Dependencies

compile (2)

Group / Artifact	Type	Version
org.scala-lang : scala-library	jar	2.12.13
edu.berkeley.cs : chisel3_2.12	jar	[3.4,3.5)

Project Modules

There are no modules declared in this project.

Chisel / Firrtl to ELK Graph

This project can generate ELK Graph files, which can be layout by ELK and rendered by icviewer as an interactive diagram to represent Chisel generated Firrtl circuits.

If you want to see the ELK Graph directly, you can use this online service, it's open source https://github.com/kieler/elk-live . But there may be some bugs, which are not suitable for circuit diagrams.

It is highly recommended to using the IntelliJ plugin to view your circuit. It supports interactive viewing of the sub-modules by double-click. In addition, it supports back navigation, zoom view, export SVG format and other functions.

The main idea is that the layout of graph use a layer-based algorithm provided by the Eclipse Layout Kernel, and the graph rendering is implemented by Sprotty diagramming framework. The combination of the two gives us a very intuitive circuit schematics.

The logic of circuit format conversion comes from diagrammer project and adapted to elk data generation with some optimizations.

Example

Purple Theme View this example interactively Solid Theme(--flatten 2)

Using

Install

Maven

https://search.maven.org/artifact/org.easysoc/layered-firrtl_2.12

for SBT

// "org.easysoc" %% "layered-firrtl" % "1.1-SNAPSHOT"
"org.easysoc" %% "layered-firrtl" % "1.1.+"

Source

git clone https://github.com/easysoc/layered-firrtl
cd layered-firrtl

Creating graph from Chisel code

  val targetDir = "test_run_dir/gcd"
  (new ElkStage).execute(
    Array("-td", targetDir),
    Seq(ChiselGeneratorAnnotation(() => new GCD))
  )

Creating graph from Firrtl file

To create a set of graphs of a Firrtl Circuit all you need is this project and a Firrtl file (typically a file generated by Chisel with a .fir extension). Let's say you have a Firrtl file ~/projects/output/circuit.fir. From the command line you while in this directory for this project

./elk.sh -i ~/projects/output/circuit.fir

or run through fat jar

sbt assembly
./utils/bin/elk -i ~/projects/output/circuit.fir

This will create a number of files in the test_run_dir/${circuit.main} directory that representing the firrtl circuit. Each file will be a ELK Graph for each module contained in the firrtl file.

Options

• -i, set the source firrtl to work on
• -td,--target-dir work directory (default: "./test_run_dir")
• --top the module in the hierarchy to start, default is the circuit top
• --flatten the maxDepth of the flatten levels
  • It is not recommended to exceed 2, otherwise the generated graph is too complicated
• --lowFir generate the corresponding lo.fir file

EasySoC

Bringing Agile Hardware Development to the Masses.

Versions

Version
1.0.0 Feb 23, 2021