izapple2/cardBase.go

package izapple2

import (
	"fmt"
)

// Card represents an Apple II card to be inserted in a slot
type Card interface {
	loadRom(data []uint8)
	assign(a *Apple2, slot int)
	reset()

	setName(name string)
	setDebug(debug bool)
	GetName() string
	GetInfo() map[string]string
}

type cardBase struct {
	a       *Apple2
	name    string
	trace   bool
	romCsxx *memoryRangeROM
	romC8xx memoryHandler
	romCxxx memoryHandler

	slot     int
	_ssr     [16]softSwitchR
	_ssw     [16]softSwitchW
	_ssrName [16]string
	_sswName [16]string
}

func (c *cardBase) setName(name string) {
	c.name = name
}

func (c *cardBase) GetName() string {
	return c.name
}

func (c *cardBase) GetInfo() map[string]string {
	return nil
}

func (c *cardBase) setDebug(debug bool) {
	c.trace = debug
}

func (c *cardBase) reset() {
	// nothing
}

func (c *cardBase) loadRomFromResource(resource string) error {
	data, _, err := LoadResource(resource)
	if err != nil {
		// The resource should be internal and never fail
		return err
	}
	c.loadRom(data)
	return nil
}

func (c *cardBase) loadRom(data []uint8) {
	if c.a != nil {
		panic("Assert failed. ROM must be loaded before inserting the card in the slot")
	}
	if len(data) == 0x100 {
		// Just 256 bytes in Cs00
		c.romCsxx = newMemoryRangeROM(0, data, "Slot ROM")
	} else if len(data) == 0x400 {
		// The file has C800 to CBFF for ROM
		// The 256 bytes in Cx00 are copied from the last page in C800-CBFF
		// Used on the Videx 80 columns card
		c.romCsxx = newMemoryRangeROM(0, data[0x300:], "Slot ROM")
		c.romC8xx = newMemoryRangeROM(0xc800, data, "Slot C8 ROM")
	} else if len(data) == 0x800 {
		// The file has C800 to CFFF
		// The 256 bytes in Cx00 are copied from the first page in C800
		c.romCsxx = newMemoryRangeROM(0, data, "Slot ROM")
		c.romC8xx = newMemoryRangeROM(0xc800, data, "Slot C8 ROM")
	} else if len(data) == 0x1000 {
		// The file covers the full Cxxx range. Only showing the page
		// corresponding to the slot used.
		c.romCxxx = newMemoryRangeROM(0xc000, data, "Slot ROM")
	} else if len(data)%0x100 == 0 {
		// The ROM covers many 256 bytes pages oc Csxx
		// Used on the Dan 2 controller card
		c.romCsxx = newMemoryRangePagedROM(0, data, "Slot paged ROM", uint8(len(data)/0x100))
	} else {
		panic("Invalid ROM size")
	}
}

func (c *cardBase) assign(a *Apple2, slot int) {
	c.a = a
	c.slot = slot
	if slot != 0 {
		if c.romCsxx != nil {
			// Relocate to the assigned slot
			c.romCsxx.setBase(uint16(0xc000 + slot*0x100))
			a.mmu.setCardROM(slot, c.romCsxx)
		}
		if c.romC8xx != nil {
			a.mmu.setCardROMExtra(slot, c.romC8xx)
		}
		if c.romCxxx != nil {
			a.mmu.setCardROM(slot, c.romCxxx)
			a.mmu.setCardROMExtra(slot, c.romCxxx)
		}
	}

	for i := 0; i < 0x10; i++ {
		if c._ssr[i] != nil {
			a.io.addSoftSwitchR(uint8(0xC80+slot*0x10+i), c._ssr[i], c._ssrName[i])
		}
		if c._ssw[i] != nil {
			a.io.addSoftSwitchW(uint8(0xC80+slot*0x10+i), c._ssw[i], c._sswName[i])
		}
	}
}

func (c *cardBase) addCardSoftSwitchR(address uint8, ss softSwitchR, name string) {
	c._ssr[address] = ss
	c._ssrName[address] = name
}

func (c *cardBase) addCardSoftSwitchW(address uint8, ss softSwitchW, name string) {
	c._ssw[address] = ss
	c._sswName[address] = name
}

func (c *cardBase) addCardSoftSwitchRW(address uint8, ss softSwitchR, name string) {
	c._ssr[address] = ss
	c._ssrName[address] = name

	c._ssw[address] = func(uint8) {
		ss()
	}
	c._sswName[address] = name
}

type softSwitches func(address uint8, data uint8, write bool) uint8

func (c *cardBase) addCardSoftSwitches(sss softSwitches, name string) {

	for i := uint8(0x0); i <= 0xf; i++ {
		address := i
		c.addCardSoftSwitchR(address, func() uint8 {
			return sss(address, 0, false)
		}, fmt.Sprintf("%v%XR", name, address))
		c.addCardSoftSwitchW(address, func(value uint8) {
			sss(address, value, true)
		}, fmt.Sprintf("%v%XW", name, address))
	}
}

func (c *cardBase) tracef(format string, args ...interface{}) {
	if c.trace {
		prefixedFormat := fmt.Sprintf("[%s] %v", c.name, format)
		fmt.Printf(prefixedFormat, args...)
	}
}