Degate is a multi-platform software for semi-automatic VLSI reverse engineering of digital logic in chips. This project is a fork of the initial Degate project, the final goal is to replace it. For more please visit our wiki page and, if you want to chat, visit our Gitter. The current project maintainer is Dorian Bachelot.

• The project
  • Little history
  • Current status
  • Future
  • Documentation
  • Screenshots
• Build
  • Dependencies
  • Dependencies version
  • Quick start
    • For Linux (debian-like)
    • For Windows
    • For MacOS
• Demo projects
• Contributing
• Localization
  • Help us
• License

The project

Little history

Degate was actively developed by Martin Schobert, during his thesis, from 2008 to 2011. For now, the project is inactive and only get some small fixes since 2011. The project is composed of a library (libGate) and a GUI interface (Degate).

Degate has definitely a great potential, mainly because it is the only free and open-source software for hardware reverse engineering of chips, but never knew how to impose itself in the community. One possible reason for that is because Degate was known to be unstable and have impacting bugs in a first place.

You can visit the initial project website to learn more:

http://degate.org

Current status

This project aims to totally replace the old Degate, with a focus on Windows, Linux and MacOS support, getting better stability and general modernization. To achieve this the aim was to drop GTK and move to Qt and merge the lib and the GUI part of the project. Another objective was to minimize the number of dependencies, for now it uses only Boost and Qt and the mid-term objective is to only keep Qt and remove Boost.

The stability was the main problem of the old Degate and the main reason why the community hadn't already united around it. Regarding that, we want to have fewer bugs as possible, even if some functionality needs to be dropped (for the moment).

For the moment we have (as functionalities):

• OpenGL 3 support (better performances and evolutive),
• Qt (bunch of tools, open-source and easy cross-platform),
• Multi-platform support (official support for Linux, Windows and MacOS),
• Multi-language support (for now only English and French are implemented),
• UTF-8 support for the workspace (the main area of the software, where you can work on high-definition chips images),
• Backward compatibility of old Degate project format,
• Project configuration (elements color, project name, size...),
• Layers configuration (type, position, background image...),
• Gate and gate configuration (gate template, gate instance, behavior with VHDL and Verilog support and debugging),
• Via and via configuration,
• EMarker (Electric Marker) and emarker configuration,
• Interconnection (electric connection between electric objects),
• Template matching (for gates),
• Grid,
• Via matching (can be tricky),
• Wire matching (need a rework),
• Sub-projects,
• Annotation and annotation configuration,
• Light and dark theme support,
• Rule checks,
• Modules,
• Connection inspector,
• And much more...

We dropped those functionalities from old Degate:

• Collaborative tracking of wires and vias.

A lot of bugs were fixed in this newer version, and it should be a better base to improve Degate even more in the future.

Future

There is still a lot to do in this new version, but all core functionalities (and even more) are implemented.

Future functionalities remaining to implement (not limited):

• Explicit full netlist exporter (new feature),
• More languages (new feature),
• Integrated gate analyzer (new feature).

For a more precise roadmap see the ROADMAP.md file.

Documentation

The official Degate documentation is available here. It is still under construction.

Also, you can find here the official Degate wiki. For example, you can find on it a list of tutorials for Degate and for IC Reverse-Engineering.

Screenshots

Build

Dependencies

Degate has only 2 dependencies: Boost and Qt5.

For Boost, you can specify to CMake a custom path with: -DBOOST_ROOT="custom_path_to_boost". Prebuilt versions for Windows are available here: https://sourceforge.net/projects/boost/files/boost-binaries/.

For Qt5, you can specify to CMake a custom path with: -DCMAKE_PREFIX_PATH="custom_path_to_qt". For example, on Windows: Qt/VERSION/COMPILER/lib/cmake/Qt5. You can download Qt5 here: https://www.qt.io/download.

For Linux, don't forget to install the Qt5 add-on module: ImageFormats (you just need to have the package installed, it will be embedded in the Qt5::Core module after). See https://doc.qt.io/qt-5/qtimageformats-index.html. For example, on debian, the package is: qt5-image-formats-plugins. Same problem with linguist tools, for example for debian you need the package: qttools5-dev.

Dependencies version

• CMake 3.12.0 or newer,
• Boost 1.70.0 or newer,
• Qt 5.14.0 or newer.

Quick start

Firstly, clone this repository (help here).

For Linux (debian-like)

Install dependencies:

> sudo apt-get install cmake g++ qt5-default qt5-image-formats-plugins qttools5-dev libboost-all-dev

Build (in the 'build' folder, for example):

> cmake ..
> make

Binaries are in the 'build/out/bin' folder.

For Windows

Install dependencies:

• CMake: https://cmake.org/download/
• A compiler (for example MSVC): https://visualstudio.microsoft.com/
• Qt: https://www.qt.io/download-qt-installer
• Boost: https://sourceforge.net/projects/boost/files/boost-binaries/

Build (in the 'build' folder, for example):

> cmake .. -DBOOST_ROOT="path_to_boost" -DCMAKE_PREFIX_PATH="path_to_qt"
> cmake --build .

Binaries are in the 'build/out/bin' folder.

For MacOS

Install dependencies (we will use Homebrew here) :

• XCode: https://apps.apple.com/app/xcode/id497799835

> brew install boost
> brew install qt

Build (in the 'build' folder, for example):

> cmake ..
> cmake --build .

Binaries are in the 'build/out/bin' folder in the bundle ".app" format.

Demo projects

You can find demo projects here.

Contributing

Read the "CONTRIBUTING.md" file.

Localization

Help us

For now only English and French are supported, but if you wish you can help easily. Degate use Qt Linguist for translation, you can learn more here: https://doc.qt.io/qt-5/linguist-translators.html. You can find .ts files (to use with Qt Linguist) in 'res/languages'.

Languages:

• English (100%),
• French (100%).
• German (80%),
• Russian (0%),
• Spanish (0%),
• Italian (0%),
• Korean (0%).

To add a new language opens a new issue.

License

Degate is released under the GNU General Public License Version 3. See LICENSE.TXT for details.

Degate is currently administered by Dorian Bachelot [email protected] and originally developed by Martin Schobert [email protected].