tinytapeout/tt03-submission-template

Submission template for Tiny Tapeout 03

What is Tiny Tapeout?

TinyTapeout is an educational project that aims to make it easier and cheaper than ever to get your digital designs manufactured on a real chip!

Go to https://tinytapeout.com for instructions!

How to change the Wokwi project

Edit the info.yaml and change the wokwi_id to match your project.

How to enable the GitHub actions to build the ASIC files

Please see the instructions for:

• Enabling GitHub Actions
• Enabling GitHub Pages

How does it work?

When you edit the info.yaml to choose a different ID, the GitHub Action will fetch the digital netlist of your design from Wokwi.

After that, the action uses the open source ASIC tool called OpenLane to build the files needed to fabricate an ASIC.

Resources

• FAQ
• Digital design lessons
• Learn how semiconductors work
• Join the community

What next?

• Share your GDS on Twitter, tag it #tinytapeout and link me!

tt03-submission-template's Issues

Design is being optimised out

@13arn
your design is being optimised out because you are not connecting anything to the output board in wokwi.
Please connect your indicator LEDs to the output board and reharden your design. To reharden see here: https://tinytapeout.com/faq/#i-updated-and-saved-my-wokwi-design-how-do-i-re-run-the-github-action-to-update-the-gds-files

fix picture please

@bat52, the picture isn't working for the datasheet or website. Only pngs are supported. Can you update please?

Design optimised out?

@bleuintegral please check your design. The final GDS only has 8 cells that do any work:

might be worth adding a test.
See https://github.com/TinyTapeout/tt03-verilog-demo for an example

TT04 github action feature requests

GDS

• Ability to retain logs on failure for download. They can be quite big 50 to 250Mb so maybe like now they should not be the default but use an option. This option would be a tick box to the manual 'workflow_dispatch' configuration.
• Ability to select ALL files for download (as in src/** run/**) again via tick box to 'workflow_dispatch' tick box.
• Maybe include in the file name the action run job ID which is usually a small integer like 1234. So help file management and ambiguity of which sequence when you have downloaded to inspect as those logs are handled/downloaded/stored..
• Maybe use the naming "GDS-failure-logs-job1234" to clearly indicate the data set is for a failure scenario.

yosys warnings

• Ability to have the tt-support-tools/project.py --print-warnings be performed on success and failure, to attempt to post-process the data. Maybe it should print a BLOCK CAPITAL WARNING AT THE TOP AND BOTTOM OF THE OUTPUT that indicate the run did not complete and the log data will be partial and best effort to collate.
• So the project.py need to detect the run did not complete to print warnings, also be coded maybe as a best effort to print what it can or print a message indicating a log file was missing, not failing on missing files when it is a failure GDS run, exit status working as now for a success GDS run, etc...

gatelevel

• Use *.vcd and maybe *.fst wildcards for all files that match in download artifact, not the single specific file. This might encourage multiple tests generating multiple VCDs.
• Emit VCD artifacts on GL test failure (so the VCD can be compared) to local testing.

sby / formal

• Provide a skeleton example for formal to add to workflow.
• Allow easy way to disable it, maybe by renaming of removing the configuration file, and having the action print out a message explaining why it was skipped (and what action the user needs to take to get it working again).

wavedrom support

• Consider hooking wavedrom support into the cocotb example for 'test' and 'gatelevel'.
• Export the *.json output with VCD data in artifact.
• Publish the wavedrom/*.json on the gh-pages to allow browsing wave.
• Might need to use wavedrom plugin to handle really large data sources files to scroll more elegantly the timeline.

Fix end quote on title

@robbertvanginkel - pls fix the non-matched end quote here:

https://github.com/robbertvanginkel/tt03-hamming74/blob/2260c198b9cd8159b224e12fc017a5bc32ece6c7/info.yaml#L23

Tiny Tapeout submission help?

Hi, your project is nearly ready to submit!

How can we help you over the line? If you're stuck please ask on the looking for help channel on the discord.

We also have a Hackathon this Friday at 18:00 CEST. Register here if you want to join.

Thanks,
Matt

@Ale-ZJ
@BenAtUvu
@Brent1810
@britovski
@ChristopherPorco
@croenkie
@DavidFaraday95
@dr-welt
@EldritchIHC
@Ender2004RM
@francisrstokes
@hosein-mokarian
@JBlocklove
@JMW95
@JorenHeyvaert
@JorgeMarinN
@Lucaz97
@marcusmichaely
@maxluppe
@Microsparky
@moloned
@mxhil
@Rathioz
@ravencarcass
@SchreinerCarin
@sellicott
@senne21
@slimmsehli
@Syndace
@The-Game-Breaker
@theunamedcreator
@darkfsegura
@grant-h
@HiddenRoom
@JuanMoya
@kevinwguan
@kiwih
@Korstek
@lild4d4
@abdelazeem201
@miket6000
@mnasser431998
@kha1-ed
@MohammedS2lah
@staydh
@tmbinc
@tommythorn
@vonkonow
@woutervhoof
@zaidben32

Error with make GDS when running IO Placement.

(https://github.com/BenAtUvu/tt03-ComboLock/actions/runs/4507289039/jobs/7934932859#step:8:62)

error message reads:
Error: : during executing: "openroad -exit -no_init -python /openlane/scripts/odbpy/io_place.py --config /work/src/pin_order.cfg --hor-layer met3 --ver-layer met2 --ver-width-mult 2 --hor-width-mult 2 --hor-extension 0 --ver-extension 0 --length 2 --unmatched-error --input-lef /work/runs/wokwi/tmp/merged.nom.lef --output-def /work/runs/wokwi/tmp/floorplan/4-io.def --output /work/runs/wokwi/tmp/floorplan/4-io.odb /work/runs/wokwi/tmp/floorplan/3-initial_fp.odb |& tee /dev/null /work/runs/wokwi/logs/floorplan/4-place_io.log"