mschuldt / ga144-sim

A simulator for the GA144

This GA144 simulator has been pulled from the rest of these GA144 tools and modified for use as a standalone simulator with ga-tools.

The only dependency is a recent version of Emacs. It has only been tested on Linux.

Installation

make to byte compile - important for speed!

make install to install the ga-sim script

Overview

The ga144 map in corner shows the active node as green and colors other nodes shades of red to indicate their ram usage when in 'usage view'. when in 'activity view' the shade of red represents recent activity in that node.

The stacks for the active node are listed on the bottom left under the map. The data stack is on the left.

The registers for the active node are to the right of the stack.

A view of the active nodes disassembled RAM is to the right of the map.

Usage

Run with: ga FILE.ga --sim The ga script is installed from ga-tools

Simulation control

Selecting the active node

Use arrow keys to move the selected node visable on the map.

Additionally common Emacs movement keys are supported such as C-n, C-p, C-b, C-f, C-e, C-a, M-b, M-f, M-m

Running the simulation

• s Step the selected node by the current step increment (default 1)
• S Like 's' but steps all nodes
• c Continue stepping until quit 'g' or all nodes are suspended
• n Set the step increment used by 's'
• Q Exit simulator

Map view control

• u usage view (default)
• a activity view
• + increase map size
• - decrease map size

RAM view control

• < Move view up (towards lower addresses)
• > Move view down
• 0 Move view to start of RAM
• . Center view on P

Simulating the bootstream

The simulation is automatically setup to simulate the bootstream if it is included in the input data. Use the --bootstream option to do this: ga FILE.ga --sim --bootstream async

There is currently a bug in the simulator in which the pin 507.17 cannot be set high. This means the simulator runs the SPI boot ROM until it times out, this takes a while so be patient while it starts.

Once initialized, press c to continue the simulation and watch the bootstream load. Use a to switch to the activity view first to watch its progress through the chip.

Only the 'async' bootstream through node 708 is supported in simulation. The simulator creates a virtual port in node 708 to load the stream so it's not running the time consuming async protocol.

TODO

• mouse support