Awesome

Degate is a multi-platform software for semi-automatic VLSI reverse engineering of digital logic in chips. This repository is a continuation of the original Degate project, with major changes and a new maintainer. For more please visit our wiki page and, if you want to chat, visit our Gitter. The current main maintainer of Degate 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
  • Troubleshooting
• 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. From 2013 to 2018, the project was mainly inactive and only got some small fixes over the years. At this time, the project was 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 that Degate was known to be unstable and have impacting bugs in a first place.

You can browse the old Degate code here and the old repository here:

https://github.com/nitram2342/degate

Current status

This project replace the old Degate, with a focus on Windows, Linux and MacOS support, getting better stability and general modernization. To achieve this the first step was to drop GTK, 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.

Troubleshooting

• Could NOT find Boost (missing: filesystem system thread) (found version "1.71.0")

  This message may be caused by default options which force to use static and multithreaded version of the Boost library. For example, this is a problem when installing Boost with MacPorts on MacOS because the installed version does not provide a static version by default. To change these default options, you can use these two commands when calling cmake (ON/OFF):

  > cmake .. -DBoost_USE_STATIC_LIBS=OFF -DBoost_USE_MULTITHREADED=OFF
  

  On Windows this can also be caused by an installed version of Boost that does not match your installed compiler.

• /etc/cmake/ConfigureFiles.cmake:25 (file): file failed to open for reading (No such file or directory): .../VERSION

  This message can appear for MacOS users. The problem comes from spaces in directory names, this is a bug from CMake. Simply move your Degate folder to a file tree without spaces in directory names.

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, or use our Crowdin project: https://crowdin.com/project/degate.

License

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

The current main maintainer of Degate is Dorian Bachelot dev@dorianb.net and the original Degate maintainer is Martin Schobert martin@mailbeschleuniger.de.