If you are reading this in plain text, head over to https://github.com/Kingdread/dc-reloaded for a rendered version
dc-reloaded is a rewrite of the microprocessor simulation (german site) by Horst Gierhardt, written in Python and open source. It (should) support everything the original DC.EXE supports.
DC is a little processor simulation with a small assembler instruction set, designed as a teaching/learning tool to show the internal processes of a CPU. You can use DC to show how simple loops are implemented with conditional jumps, but also to demonstrate more complex procedures like subprograms with parameters and return values or recursion.
Why not?
You can find the documentation here. Alternatively you can
build your local copy using sphinx. Just cd into doc/ and run
make html
to generate the html documentation in doc/build/html/.
- Python 3
- PyQt 5
Refer to the documentation for detailed installation instructions.
tl;dr:
sudo python3 setup.py install
This will install dc-reloaded system-wide. The documentation contains a tutorial to install it in a python virtual environment. If the command finishes, you can run
dc-reloaded
to start DC reloaded. If you get an error à la
Traceback (most recent call last):
...
ImportError: No module named 'PyQt5'
then you need to install PyQt5.
Windows installers can be found here.
Examples can be found in doc/source/examples/ or in the
documentation.
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, or
(at your option) any later version.
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.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
The font (resource-files/DejaVuSansMono.ttf) is part of the DejaVu font
family, whose license can be seen here
Feel free to wreak havoc in the source and change whatever you want.
If you would like to see your changes pulled into the repository, you should
adhere to some basic style guidelines as PEP 8. The Makefile contains
a lint target to run pylint and flake8. You should try to not introduce
any lint failures.
If you modify anything in resource-files/, such as the background image or
the UI layout, you need to regenerate the relevant Python files. The Makefile
has targets window, resources and all as a shorthand for both. Thus, if
you modify resources, always run
make all
Have fun!