From ef88eb173fc87bfe1b87be533e4f574209d40b1d Mon Sep 17 00:00:00 2001 From: Lars-Dominik Braun Date: Tue, 26 Feb 2019 11:05:22 +0100 Subject: Initial import Disassembler seems to be working. --- README.rst | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 README.rst (limited to 'README.rst') diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..ab06b95 --- /dev/null +++ b/README.rst @@ -0,0 +1,49 @@ +EUMuLator +========= + +EUMuLator is a reimplementation of the EUMEL0 machine in PureScript_. +Currently it is compatible with the EUMEL0 BIT-A-encoded instruction set as of +version 1.8. For an introduction to the EUMEL operating system, see `this +page `__. + +.. Yes, this is my first PureScript project. + +.. _PureScript: http://www.purescript.org/ +.. _EUMuLator: https://github.com/promyloph/eumulator + +Project status +-------------- + +Works: + +- Disassembler + +Work-in-progress: + +- EUMEL0 virtual machine implementation + +Future work: + +- Browser intergation + +Usage +----- + +First `install PureScript`_. Then you’ll need a *Hintergrund* from EUMEL +version 1.8. Currently only `the base disk set’s Hintergrund version 1.8.7 +`__ is extractable by the script +``extractHintergrund.py``, found in the `tools repository`_. Extract the +dataspaces and run the disassembler: + +.. _tools repository: https://github.com/PromyLOPh/eumel-tools +.. _install PureScript: https://github.com/purescript/documentation/blob/master/guides/Getting-Started.md + +.. code:: bash + + linearizeDisk.py 03_eumel0.img 03_eumel0.img.linear + extractHintergrund.py 03_eumel0.img.linear + pulp run -- 0002_0004.ds + +Note that running the disassembler makes sense only for dataspace four, the +default dataspace, which contains each task’s code section. + -- cgit v1.2.3