Tools

This page describes how to use the different tools needed to work with entropy.

Requirements

To be able to build entropy, python 3 is required. You can get it here.
To use run.py, python 3 is also required, but entropy can be run without using run.py, see below.

Building and running

Everytime you make changes to entropy, you need to build again. This can be done by running build.py.
When you want to run entropy, use run.py. When you want to do both at the same time, use buildrun.py.
After that, double-click an m35fd, add entropy.img and insert it and close the m35fd popup window.
Then check the running checkbox and entropy will be booted.
Note that at this time, entropy is still in development and will likely fail to boot.

Customization

The python scripts include mechanics to customize what ends up in the entropy disk.
This is done by editing /build/buildlist.txt and /build/includelist/txt. In both cases, one file per line is expected.
For /build/buildlist.txt, the filepaths are relative to /src. All files in there will be built before being included.
For /build/includelist.txt, the filepaths are relative to /bin. All files in there will be included as binary files.

You can also customize what devices are connected to the dcpu.
This is done by changing the numbers in /build/devicelist.txt.
Make sure there is a space between the number and the name and do not change the order.

Please do not push the changes you make to the last three mentioned files to this repo.

Running without python

To run entropy without python, follow these steps:

1. run /tools/Lettuce.exe
2. select /bin/bootloader.bin
3. select the desired devices, make sure to have at least one Generic Clock and one M35FD
4. Double click an M35FD to get a disk selection screen
5. Select /bin/entropy.img, insert it and close the selection screen
6. Check the running checkbox to boot entropy

Editing

To edit the source files of entropy, you can use your preferred text editor.
We recommend notepad++ however. There is a user-defined style available on this repo in /tools/dcpu16.xml.
To include this style in notepad++, go to Language > Define your language... > Import and select the file.