AssembSim

AsembSim is an educational tool that allows you to write 8-bit assembly script and run in any way or speed. (machine code is custom made)

Editor Menu

The Editor menu allows you to write assembly code. Hitting the "Run Program" button will compile the code into binary and sends you to the "Run Program" Menu to execute your code. The Editor also has an Info button that will display a panel  containing all the opcodes, what they do, and more information.

Run Program Menu

• Run Program menu displays many things:
  • Code Output list.
  • Registers Table.
  • Code and Binary Table.
• You can run program in many ways:
  • Run code at speeds of 2Hz, 60Hz, 1KHz, 80KHz, or 1MHz.
  • Step code instruction-by-instruction and see how it executes.

Saving and loading

You can save and load either the assembly script to edit, or save and load binary programs. Loading a Binary program will not allow you to modify it as it is in binary, not in text. You can do "Open With" on files with file format of either .asmb, .txt, or .json to load it into the editor. You can do "Open With" on binary programs too! The binary file must be exactly 256 bytes in order to load properly.

Commands

You can run commands in command prompt within the folder that has AsembSim.exe. 

Some of these commands are:

• AsembSim.exe [fileName]
  • This command will try to run with a file name as argument. If the file name is of format .txt, .asmb, or .json, it will launch AsembSim in the Code Editor. Otherwise it will try and load it as a compiled binary file into the Run Program menu.
• AsembSim.exe -c [codeFileName] [outputFileName]
  • This command has -c argument that will read the [codeFileName] as assembly code and compile it into binary and saves / overwrites into [outputFileName]. If assembly code has compilation errors, it will show up in a console window.
  • There's also a variant of this that takes -cn instead of -c, which would try to compile like -c, but will not open any console window.
• AsembSim.exe -r [binFile]
  • This command has -r argument that will read [binFile] as a pre-compiled program and executes code directly in console without opening the AsembSim Run Program menu, and will not run in a forced fixed speed. All output numbers created by the running program will be printed onto the Console window.

Made using SpriteX Framework