coprocessor

Documentation

Overview

Package coprocessor is used to capture execution/disassembly information from any program running on a coprocessor that may be present in an attached VCS cartridge. For example, CDFJ mapped cartridges have an ARM7TDMI available.

Index

• type Coprocessor
  • func Add(vcs *hardware.VCS, cart *cartridge.Cartridge) *Coprocessor
  • func (cop *Coprocessor) Instruction(entry mapper.CartCoProcDisasmEntry)
  • func (cop *Coprocessor) NewIteration() *Iterate
  • func (cop *Coprocessor) Reset()
• type Iterate
  • func (itr *Iterate) Next() (*mapper.CartCoProcDisasmEntry, bool)
  • func (itr *Iterate) SkipNext(n int) (*mapper.CartCoProcDisasmEntry, bool)
  • func (itr *Iterate) Start() (*mapper.CartCoProcDisasmEntry, bool)
• type LastExecutionDetails

Types

type Coprocessor

type Coprocessor struct {
	// contains filtered or unexported fields
}

Coprocessor is used to handle the disassembly of instructions from an attached cartridge that contains a coprocessor.

func Add

func Add(vcs *hardware.VCS, cart *cartridge.Cartridge) *Coprocessor

Add returns a new Coprocessor instance if cartridge implements the coprocessor bus.

func (*Coprocessor) Instruction

func (cop *Coprocessor) Instruction(entry mapper.CartCoProcDisasmEntry)

Instruction implements the CartCoProcDisassembler interface.

func (*Coprocessor) NewIteration

func (cop *Coprocessor) NewIteration() *Iterate

NewIteration is the preferred method if initialistation for the Iterate type.

func (*Coprocessor) Reset

func (cop *Coprocessor) Reset()

Reset implements the CartCoProcDisassembler interface.

type Iterate

type Iterate struct {

	// information about the last execution (eg. screen coordinates)
	Details LastExecutionDetails

	// number of entries in the iterations
	Count int
	// contains filtered or unexported fields
}

Iterate facilitates traversal over the disasm of the the last execution of the coprocessor.

func (*Iterate) Next

func (itr *Iterate) Next() (*mapper.CartCoProcDisasmEntry, bool)

Return the next entry in the iteration.

func (*Iterate) SkipNext

func (itr *Iterate) SkipNext(n int) (*mapper.CartCoProcDisasmEntry, bool)

Skip the next N entries of the entry and return that entry.

func (*Iterate) Start

func (itr *Iterate) Start() (*mapper.CartCoProcDisasmEntry, bool)

Start new iterations.

type LastExecutionDetails

type LastExecutionDetails struct {
	Frame    int
	Scanline int
	Clock    int
}