Gopher2600/coprocessor/disassembly/disassembly.go

// This file is part of Gopher2600.
//
// Gopher2600 is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Gopher2600 is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Gopher2600.  If not, see <https://www.gnu.org/licenses/>.

package disassembly

import (
	"sort"
	"sync"

	"github.com/jetsetilly/gopher2600/coprocessor"
	"github.com/jetsetilly/gopher2600/hardware/television"
	"github.com/jetsetilly/gopher2600/hardware/television/coords"
)

// TV defines the interface to the TV required by the coprocessor disassembly
// package
type TV interface {
	AdjCoords(adj television.Adj, amount int) coords.TelevisionCoords
}

// Cartridge defines the interface to the cartridge required by the
// coprocessor disassembly pacakge
type Cartridge interface {
	GetCoProcBus() coprocessor.CartCoProcBus
}

// Disassembly is used to handle the disassembly of instructions from an
// attached cartridge that contains a coprocessor.
type Disassembly struct {
	crit sync.Mutex

	tv   TV
	cart Cartridge

	disasm DisasmEntries
}

// DisasmEntries contains all the current information about the coprocessor
// disassembly, including whether disassembly is currently enabled.
type DisasmEntries struct {
	Enabled bool

	Entries map[string]coprocessor.CartCoProcDisasmEntry
	Keys    []string // sorted keys into the disasm map

	LastExecution        []coprocessor.CartCoProcDisasmEntry
	LastExecutionSummary coprocessor.CartCoProcDisasmSummary

	LastStart coords.TelevisionCoords
}

// NewDisassembly returns a new Coprocessor instance if cartridge implements the
// coprocessor bus.
func NewDisassembly(tv TV) Disassembly {
	return Disassembly{
		tv: tv,
	}
}

func (dsm *Disassembly) AttachCartridge(cart Cartridge) {
	dsm.crit.Lock()
	defer dsm.crit.Unlock()

	dsm.cart = nil

	dsm.disasm = DisasmEntries{
		LastExecution: make([]coprocessor.CartCoProcDisasmEntry, 0, 1024),
		Entries:       make(map[string]coprocessor.CartCoProcDisasmEntry),
		Keys:          make([]string, 0, 1024),
	}

	if cart != nil && cart.GetCoProcBus() != nil {
		dsm.cart = cart
	}
}

// Inhibit should be used to temporarily disable disassembly functionality.
// IsEnabled() will still return true as appropriate regardless of inhibit
// state.
func (dsm *Disassembly) Inhibit(inhibit bool) {
	dsm.crit.Lock()
	defer dsm.crit.Unlock()

	if dsm.cart == nil {
		return
	}

	if inhibit {
		dsm.cart.GetCoProcBus().GetCoProc().SetDisassembler(nil)
		dsm.disasm.LastExecution = dsm.disasm.LastExecution[:0]
	} else {
		if dsm.disasm.Enabled {
			dsm.cart.GetCoProcBus().GetCoProc().SetDisassembler(dsm)
		}
	}
}

// IsEnabled returns true if coprocessor disassembly is currently active.
func (dsm *Disassembly) IsEnabled() bool {
	dsm.crit.Lock()
	defer dsm.crit.Unlock()
	return dsm.disasm.Enabled
}

// Enable or disable coprocessor disassembly. We retain the disassembly
// (including last execution) already gathered but the LastExecution field is
// cleared on disable. The general disassembly is maintained.
func (dsm *Disassembly) Enable(enable bool) {
	dsm.crit.Lock()
	defer dsm.crit.Unlock()

	if dsm.cart == nil {
		return
	}

	dsm.disasm.Enabled = enable

	if dsm.disasm.Enabled {
		dsm.cart.GetCoProcBus().GetCoProc().SetDisassembler(dsm)
	} else {
		dsm.cart.GetCoProcBus().GetCoProc().SetDisassembler(nil)
		dsm.disasm.LastExecution = dsm.disasm.LastExecution[:0]
	}
}

// Start implements the CartCoProcDisassembler interface.
func (dsm *Disassembly) Start() {
	dsm.crit.Lock()
	defer dsm.crit.Unlock()

	if dsm.disasm.Enabled {
		// add one clock to frame/scanline/clock values. the Reset() function will
		// have been called on the last CPU cycle of the instruction that triggers
		// the coprocessor reset. the TV will not have moved onto the beginning of
		// the next instruction yet so we must figure it out here
		dsm.disasm.LastStart = dsm.tv.AdjCoords(television.AdjCycle, 1)
	}

	dsm.disasm.LastExecution = dsm.disasm.LastExecution[:0]
}

// Step implements the CartCoProcDisassembler interface.
func (dsm *Disassembly) Step(entry coprocessor.CartCoProcDisasmEntry) {
	dsm.crit.Lock()
	defer dsm.crit.Unlock()

	// check that coprocessor disassmebler hasn't been disabled in the period
	// while we were waiting for the critical section lock
	if !dsm.disasm.Enabled {
		return
	}

	dsm.disasm.LastExecution = append(dsm.disasm.LastExecution, entry)
}

// End implements the CartCoProcDisassembler interface.
func (dsm *Disassembly) End(summary coprocessor.CartCoProcDisasmSummary) {
	dsm.crit.Lock()
	defer dsm.crit.Unlock()

	dsm.disasm.LastExecutionSummary = summary

	for _, entry := range dsm.disasm.LastExecution {
		key := entry.Key()
		if _, ok := dsm.disasm.Entries[key]; !ok {
			dsm.disasm.Keys = append(dsm.disasm.Keys, key)
		}
		dsm.disasm.Entries[key] = entry
	}

	sort.Strings(dsm.disasm.Keys)
}

// BorrowDisasm will lock the DisasmEntries structure for the durction of the
// supplied function, which will be executed with the disasm structure as an
// argument.
//
// Should not be called from the emulation goroutine.
func (dsm *Disassembly) BorrowDisassembly(f func(*DisasmEntries)) {
	dsm.crit.Lock()
	defer dsm.crit.Unlock()
	f(&dsm.disasm)
}