+3
日增长
4,892
stars
1,206
forks
124
watchers
3,938
prs
2,254
issues
72
releases
README
yosys – Yosys Open SYnthesis Suite =================================== This is a framework for RTL synthesis tools. It currently has extensive Verilog-2005 support and provides a basic set of synthesis algorithms for various application domains. Yosys is using sv-elab and slang libraries to provide comprehensive SystemVerilog support. It supports an (informally defined) synthesizable subset of SystemVerilog in version IEEE 1800-2017 or IEEE 1800-2023. Yosys can be adapted to perform any synthesis job by combining the existing passes (algorithms) using synthesis scripts and adding additional passes as needed by extending the yosys C++ code base. Yosys is free software licensed under the ISC license (a GPL compatible license that is similar in terms to the MIT license or the 2-clause BSD license). Third-party software distributed alongside this software is licensed under compatible licenses. Please refer to abc and libs subdirectories for their license terms. Web Site and Other Resources ============================ More information and documentation can be found on the Yosys web site: - https://yosyshq.net/yosys/ If you have any Yosys-related questions, please post them on the Discourse group: - https://yosyshq.discourse.group Documentation from this repository is automatically built and available on Read the Docs: - https://yosyshq.readthedocs.io/projects/yosys Users interested in formal verification might want to use the formal verification front-end for Yosys, SBY: - https://yosyshq.readthedocs.io/projects/sby/ - https://github.com/YosysHQ/sby The Yosys blog has news and articles from users: - https://blog.yosyshq.com Installation ============ Yosys is part of the Tabby CAD Suite and the OSS CAD Suite! The easiest way to use yosys is to install the binary software suite, which contains all required dependencies and related tools. Contact YosysHQ for a Tabby CAD Suite Evaluation License and download link OR go to https://github.com/YosysHQ/oss-cad-suite-build/releases to download the free OSS CAD Suite Follow the Install Instructions on GitHub Make sure to get a Tabby CAD Suite Evaluation License if you need features such as industry-grade SystemVerilog and VHDL parsers! For more information about the difference between Tabby CAD Suite and the OSS CAD Suite, please visit https://www.yosyshq.com/tabby-cad-datasheet Many Linux distributions also provide Yosys binaries, some more up to date than others. Check with your package manager! Building from Source ==================== TL;DR The following libraries are required, this command will install them on Ubuntu Linux 22.04 LTS based systems: $ sudo apt-get install gawk git make python3 lld bison clang flex \ libffi-dev libfl-dev libreadline-dev pkg-config tcl-dev zlib1g-dev \ graphviz xdot This sequence of commands will build Yosys from source using the default preset: $ git clone --recurse-submodules https://github.com/YosysHQ/yosys.git $ cd yosys $ cmake --pr
Top issues
#2165Properly specify and reimplement opt_clean/clean16 comments · 2020-06-17#2809cxxrtl: Verilog frontend's handling of `$meminit` breaks a lot of assumptions15 comments · 2021-05-31#6165Fails to substitute module code for instance in particular situations14 comments · 2026-09-01#4236Please add a flag to generate a simplified graphviz diagram.14 comments · 2024-02-25#647Internal module wires are not accessible using dot notation14 comments · 2018-10-02#4601Importing init of memory is extremely slow13 comments · 2024-09-17#3426opt_clean reverses some connections13 comments · 2022-07-28#3442How to identify bit-level dffsr ?12 comments · 2022-08-09
Discussions
#6335The semantics of $pmux1 comments · 2026-10-13#6248Unofficial portable AppImage packaging for Yosys1 comments · 2026-09-26#6203Attempts at better mapping of multiplexers for Gowin FPGA using modified `synth_gowin`/`abc9` scripts2 comments · 2026-09-15#6099Why am I getting an asynchronous read here (thus LUT RAM instead of Block RAM)1 comments · 2026-08-09#6097ATPG plugin for yosys1 comments · 2026-08-08#5908What If YosysHQ yosys Had Actual Physics?1 comments · 2026-05-26#5899ABC gate delay handling1 comments · 2026-05-19#5783I open-sourced an ML model that predicts chip design outcomes — 92% accuracy on real OpenLane runs0 comments · 2026-03-27
Latest release
Yosys 0.71 v0.71 2026-11-12Yosys 0.70 .. Yosys 0.71
--------------------------
Commands and options
- Added "-readable" and "-small" to "dump" and "write_rtlil" passes
for convenience with the new string implementation.
- Added "shuffle" pass to deterministically reorder design objects.
- Added "-target" and "-family" to "verific" and "read_slang" passes
as experimental feature to specify FPGA synthesis target.
- Added "-nodec_attr" and "-dec_param" to "write_verilog" pass for
compatibility with other tools.
Various
- Strings have been reimplemented with prefix dedu