Skip to content

Rex--/mksim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MKSIM

A PDP-8 emulator with a console UI written in Go.

Usage

To run a program, pass the compiled program as the first argument:

mksim hello.po

Compiled programs must be in either Pobj or RIM format. To aquire programs in this format, use either pdpnasm (Pobj) or mkasm (Pobj or RIM).

IOT Devices

Programs can take advantage of a Teletype IOT device that uses device addresses 03 (keyboard) and 04 (printer).

Help

Usage: ./mksim [options] <in_file>

Options:
  -F_CPU speed
        simulated clock speed (default 8000000)
  -exit
        Exit the simulator on HALT
  -halt
        HALT the machine before first instruction cycle
  -help
        Print this message and exit
  -lock page
        Lock memory viewer to page (default -1)
  -no-gui
        Do not display curses ui
  -print-return
        Print return code (AC) upon exiting

Build

Building this project requires go, which can be downloaded online.

First, clone the repo to get the latest version:

git clone https://github.com/Rex--/mksim.git

Next, build the mksim executable. In the repo directory run:

go build .

Copying

Copyright (c) 2022-2024 Rex McKinnon
This software is available for free under the permissive University of Illinois/NCSA Open Source License. See the LICENSE file for full details.

About

A PDP-8 emulator written in Go.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages