Welcome to dgtools’s documentation!


dgtools is a mini-toolchain for compiling and testing ASM programs for the Digirule 2 series of hardware.

It is composed of an assembler (dgasm.py), a binary file “inspector” (dginspect.py) and a simulator (dgsim.py) that are used to develop and test code and also assist in transfering the program to the Digirule.

For an example of the level of detail in terms of simulating program execution, please see this sample output file and keep reading through the introductory section to generate traces of your own code.

Alternatively, you can now try out online any of the examples in these pages via dgrdo which also exposes the brainfuck and Super Stack! compilers included with dgtools.

Indices and tables