[QuickStart] Yosys/Parmys Update #2776
Conversation
There was a problem hiding this comment.
Thanks @ZohairZaidi !
I have some comments about the parmys flow (I think we've listed some unnecessary steps for it) that you should take a look at closely. Adding @amirarjmand93 and @KennethKent to review; in case @AlexandreSinger has time to review I've tagged him too
|
|
||
| Hierarchy reader converted 6 instances of blackboxes. | ||
| The network was strashed and balanced before FPGA mapping. | ||
| Hierarchy writer reintroduced 6 instances of blackboxes. | ||
|
|
||
| If we now inspect the produced BLIF file (``blink.abc_no_clock.blif``) we see that ABC was able to significantly simplify and optimize the circuit's logic (compared to ``blink.odin.blif``): | ||
| If we now inspect the produced BLIF file (``blink.abc_no_clock.blif``) we see that ABC was able to significantly simplify and optimize the circuit's logic (compared to ``blink.parmys.blif``): |
There was a problem hiding this comment.
Take a look at the two files and see if this is true. Are the number of .names significantly different? Confirm they are different a bit at least. We shouldn't say it is significantly simpler / optimized unless it is.
There was a problem hiding this comment.
just double checked and that seems to be an error on my part as the number of .names are the same. Thanks for catching that.
There was a problem hiding this comment.
Thanks. I think we should just simplify then to show running parmys in this section, without abc or the clock relabelling (we can leave those in the Odin-II section). If you can confirm the clock relabeling is not called for the parmys flow in run_vtr_flow that would be ideal -- then we can confidently remove it from this section.
There was a problem hiding this comment.
sure thing. It does not appear to be called in run_vtr_flow.
My initial confusion stemmed from reading the Parmys paper, which states, "the Parmys pass is called to perform partial mapping according to the target architecture, and then a series of optimization and logic mappings are performed to convert all the remaining Yosys internal types to primitives. Next, the output is passed to ABC and VPR stages."
This led me to believe that running only the Parmys part of the flow would require a separate invocation of ABC since we are executing the command with both -start parmys and -end parmys, it explicitly skips the ABC.
I will update the PR and also wait for final confirmation by the added members
There was a problem hiding this comment.
I think you were right and I was wrong @ZohairZaidi ! After talking to Ken Kent at UNB, it does seem we need to run ABC and the clock add/removal script after Parmys. So I think your original edits were right. Can you run the flow to check exactly what happens in run_vtr_flow with parmys? I think it runs ABC and the clock recovery script after all, so we should document them again.
I also think we should change the order of the text. After saying how to run vpr, I think we should say how to use run_vtr_flow with parmys to synthesize, place and route a circuit. Then we can have a "running manually" section to dig more into how to run each tool. Finally we can have the existing Odin II section.
|
Thanks @vaughnbetz!, I have addressed your suggestions. Will wait for the added members to review as well. |
There was a problem hiding this comment.
@ZohairZaidi Thank you for these changes! I like how you are running Yosys. I think using the vtr_flow script just on the Yosys step is perfectly fine since running Yosys directly is such a pain. The main goal is to know how to make the .blif file.
I have left some comments below, but overall the documentation is very good.
|
Adding @soheilshahrouz in case he can help figure out the required flow ... we need to document this well in the quickstart as Mohamed and I were confused about it. |
|
I agree @vaughnbetz, I plan to work on it this reading week. Please let me know what you were confused about. |
doc/src/quickstart/index.rst
Outdated
| .. code-block:: bash | ||
|
|
||
| > mkdir -p ~/vtr_work/quickstart/blink_manual | ||
| > cd ~/vtr_work/quickstart/blink_manual |
There was a problem hiding this comment.
I was wondering if this is necessary. I would assume that if they opt with ODIN they would skip the synthesizing with Parmys section so I left it here.
|
Hi @vaughnbetz, let me know how this is. I changed the order and made it smoother for the user to follow. |
Description
This pull request updates the VTR Quick Start Guide by replacing Odin II as the primary synthesis tool with the Yosys/Parmys flow. I have also updated the graphic images
Related Issue
closes #2739
Checklist: