# About the program Logisim-evolution

Logisim Logisim is an educational tool for designing and simulating digital logic circuits. It has been originally created by Dr. Carl Burch and actively developed until 2011. After this date the author focused on other projects, and recently the development has been officially stopped (see his message here).

In the meantime, people from a group of swiss institutes (Haute École Spécialisée Bernoise,Haute École du paysage, d'ingénierie et d'architecture de Genève,Haute École d'Ingénierie et de Gestion du Canton de Vaud) started developing a version of Logisim that fitted their courses, integrating several tools -- for instance a chronogram, the possibility to test the schematics directly on an electronic board, TCL/TK consoles, ...

We have decided to release this new Logisim version under the name Logisim-evolution, to highlight the large number of changes that occurred in these years, and we actively seek the contribution of the community.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. (see below license)

## Languages

Logisim supports many languages. Many of them were automatically translated using DeepL. If you should find bizarre translations, please do not hesitate to correct them in the corresponding property files and to make a pull request!

## What's new in logisim-evolution

- Chronogram -- to see the evolution of signals in your circuit
- Electronic board integration -- schematics can now be simulated on real hardware!
- Board editor -- to add new electronic boards
- VHDL component -- a new component type whose behavior is specified in VHDL le comportement est spécifié dans VHDL
- TCL/TK console -- interfaces between the circuit and the user
- DIP switches
- RGB LEDs
- Large number of bug-fixes
- GUI improvements
- Automatic updates
- Code refactoring
- ...

## Retro-compatibility

We cannot assure retro-compatibility of logisim-evolution with files created with the original Logisim. We have incorporated a parser that alters the name of the components to satisfy VHDL requirements for variable names, but components evolved in shape since then (think, for instance, to RAM and counters). You might need to rework a bit your circuits when opening them with logisim-evolution -- but the changes will be stored in the new format, therefore you have to do your work only once.

## Wish-list

Logisim-evolution is a continuously-growing software, and we have several ideas we would like to implement. In particular, we would like to have:

unit tests for the code

- extensive documentation
- test circuits
- ... If you are willing to contribute with any of these, please feel free to contact us!

## How to get support for logisim-evolution

Unfortunately, we do not have enough resources to provide direct support for logisim-evolution. We will, however, try to deal with the raised issues in a best-effort way.

If you find a bug or have an idea for an interesting feature, please do not hesitate to open a ticket!

Logisim-evolution

## License

The code is licensed under the GNU GENERAL PUBLIC LICENSE, version 3.
local version GPL

## Credits

The Logisim-evolution project is based on Logisim software by:

- Carl Burch, Hendrix College, USA

The following people and institutions actively contributed to further development of `Logisim-evolution`:

- Moshe Berman, Brooklyn College, USA
- Theldo Cruz Franqueira, Pontifícia Universidade Católica de Minas Gerais, Brazil
- Zhao Hanyuan, Tsinghua University, China
- David H. Hutchens, Millersville University, Pennsylvania, USA
- Theo Kluter, Berner Fachhochschule | Haute école spécialisée bernoise, Switzerland.
- Torsten Maehne, Berner Fachhochschule | Haute école spécialisée bernoise, Switzerland.
- Tom Niget, LEAT, Polytech Nice-Sophia, France
- Marcin Orłowski, Poland
- Kevin Walsh, College of the Holy Cross, USA
- Liu Yuchen, University of Technology, China
- Berner Fachhochschule | Haute école spécialisée bernoise, Switzerland
- College of the Holy Cross, USA
- Haute École d'Ingénierie et de Gestion du Canton de Vaud, Switzerland
- Haute école du paysage, d'ingénierie et d'architecture de Genève, Switzerland

If you feel that your name should be in this list, please feel free to open a ticket.

Next: User Guide.