crazyettin
/
Thingamajig
1
0
Fork 0
Code Issues Pull Requests Projects Releases 2 Wiki Activity

Reword the readme slightly

This commit is contained in:
CrazyEttin 2022-09-18 16:34:36 +03:00
parent 5fd7fa707f
commit 3f7cf0d8ea
1 changed files with 22 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
readme.md
View File

@ -9,7 +9,7 @@ Included Software
----------------- -----------------
The repository includes an emulator implementation of Thingamajig with a The repository includes an emulator implementation of Thingamajig with a
control program for the emulated punched tape reader and punch, and an control program for the emulated paper tape reader and punch, and an
assembler and a disassembler, all written in FreePascal. It also assembler and a disassembler, all written in FreePascal. It also
includes couple of simple example programs for Thingamajig written in includes couple of simple example programs for Thingamajig written in
assembly. assembly.
@ -99,29 +99,30 @@ Usage:
* emulator (-v) program (2> verbose_output) * emulator (-v) program (2> verbose_output)
* tapectl (-r reader_file) (-p punch_file) * tapectl (-r reader_file) (-p punch_file)
By default the emulator runs at roughly 500 KIPS, has 2 KiB of RAM, and By default the emulator runs at roughly 500 KIPS and has 2 KiB of RAM.
interacts with memory mapped devices at roughly 1 kB/s. The arguments The arguments -dRAM4, -dRAM8, -dRAM16, -dRAM32, and -dRAM64 can be used
-dRAM4, -dRAM8, -dRAM16, -dRAM32, and -dRAM64 can be used to compile to compile the emulator with 4, 8, 16, 32, or 64 KiB (minus the reserved
the emulator with 4, 8, 16, 32, or 64 KiB (minus the reserved addresses) addresses) of RAM respectively instead and the speed limitations can be
of RAM respectively instead and the speed limitations can be removed removed with the argument -dfast. When run with the argument -v the
with the argument -dfast. When run with the argument -v the current current state of the registers is output to stderr before each
state of the registers is output to stderr before each instruction. instruction.
Input and output are handled by an emulated glass teletype terminal with Input and output are handled by an emulated roughly 1000 CPS
local echo on by default. Of the control characters bell (^G), ASCII-compatible glass teletype terminal with local echo on by default.
backspace (^H), line feed (^J), carriage return (^M), and device control Of the control characters bell (^G), backspace (^H), line feed (^J),
characters two (^R) and four (^T) are used by the terminal: the device carriage return (^M), and device control characters two (^R) and four
control characters are used to turn the local echo on and off (^T) are used by the terminal: the device control characters are used to
respectively while the rest have their standard uses. The backspace and turn the local echo on and off respectively while the rest have their
delete keys input their respective characters and non-character keys standard uses. The backspace and delete keys input their respective
null. characters and non-character keys null.
In Linux the emulator can be compiled with support for a character In Linux the emulator can be compiled with support for a character
printer and an emulated punched tape reader and punch with the arguments printer and an emulated high speed paper tape reader and punch with the
-dprinter and -dtape respectively. The printer is mapped to address FFFE arguments -dprinter and -dtape respectively. The printer is mapped to
and the tape reader and punch to FFFD. The printer prints into address FFFE and the tape reader and punch to FFFD. The printer prints
/dev/usb/lp0 and the tape files read from and punched to are (re)set into /dev/usb/lp0 and the tape files read from and punched to are
using the program tapectl with the arguments -r and -p respectively. (re)set using the program tapectl with the arguments -r and -p
respectively.
The IPL loads the program specified as an argument when running the The IPL loads the program specified as an argument when running the
emulator. emulator.