external

type Absolute ¶ added in v0.6.3

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

Absolute implements the mapper used by the game F18 Hornet https://github.com/JetSetIlly/test7800/issues/30

func NewAbsolute(_ Context, d []byte) (*Absolute, error)

func (ext *Absolute) Access(write bool, address uint16, data uint8) (uint8, error)

func (ext *Absolute) Label() string

type Activision ¶ added in v0.6.3

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

Activision implements the activision type mapper

https://forums.atariage.com/topic/384647-what-means-the-rom-file-am-and-om-in-trebors-rom-pack/#comment-5719218

note that the information on that page isn't quite right but it gives a basic idea of the format. the Access() function for this mapper describes correctly the layout of the AM variant. The OM variant can be transformed into the AM variant by swapping each 8k block for each bank

func NewActivision(_ Context, d []byte, originalOrder bool) (*Activision, error)

func (ext *Activision) Access(write bool, address uint16, data uint8) (uint8, error)

func (ext *Activision) Label() string

type Banksets ¶ added in v0.5.1

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

https://7800.8bitdev.org/index.php/Bankset_Bankswitching

func NewBanksets(_ Context, supergame bool, d []byte, ram bool) (*Banksets, error)

func (ext *Banksets) Access(write bool, address uint16, data uint8) (uint8, error)

func (ext *Banksets) HLT(hlt bool)

func (ext *Banksets) Label() string

type Bus ¶ added in v0.6.0

type Bus interface {
	Label() string
	Access(write bool, address uint16, data uint8) (uint8, error)
}

type CartridgeInsertor ¶

type CartridgeInsertor struct {

	// the type of controller to use for this cartridge
	Controller string

	// use high-score cartridge shim with cartridge
	UseHSC     bool
	UseSavekey bool
	// contains filtered or unexported fields
}

func Fingerprint(filename string, mapper string) (CartridgeInsertor, error)

func FingerprintBlob(filename string, d []uint8, mapper string) (CartridgeInsertor, error)

func (c CartridgeInsertor) Data() []uint8

func (c CartridgeInsertor) Filename() string

func (c CartridgeInsertor) ResetProcedure() CartridgeReset

func (c CartridgeInsertor) Spec() string

type CartridgeReset ¶

type CartridgeReset struct {
	// if BypassBIOS is true then the normal BIOS initialisation procedure is bypassed
	BypassBIOS bool
}

CartridgeReset contains 'instructions' to be followed when the cartridge is inserted

type Context ¶

type Context interface {
	elf.Context
	Rand8Bit() uint8
}

type Device ¶

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

func Create(ctx Context) *Device

func (dev *Device) Access(write bool, address uint16, data uint8) (uint8, error)

func (dev *Device) BusChange(address uint16, data uint8) error

func (dev *Device) Chips(yield func(OptionalBus))

func (dev *Device) Eject()

func (dev *Device) GetCoProcBus() coprocessor.CartCoProcBus

func (dev *Device) HLT(halt bool)

func (dev *Device) Insert(c CartridgeInsertor) error

func (dev *Device) IsEjected() bool

func (dev *Device) Label() string

type Flat ¶

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

func NewFlat(_ Context, d []byte) (*Flat, error)

func (ext *Flat) Access(_ bool, address uint16, data uint8) (uint8, error)

func (ext *Flat) Label() string

type MRAM ¶ added in v0.7.5

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

MRAM is created when bit 0x0080 of the a78 cartridge type field is on. Example ROM is the prototype of Rescue on Fractalus. The name mRAM comes from the A7800 rom.cpp file which describes this type of cartridge as "no bankswitch + mRAM chip"

func NewMRAM(_ Context, d []byte) (*MRAM, error)

func (ext *MRAM) Access(write bool, address uint16, data uint8) (uint8, error)

func (ext *MRAM) Label() string

type OptionalBus ¶ added in v0.6.0

type OptionalBus interface {
	Label() string
	Access(write bool, address uint16, data uint8) (uint8, bool, error)
}

the OptionalBus interface differs to the Bus interface because the Access() function returns an additional boolean result to indicate whether the address was recognised and handled. The intention is for the External device to call Access() on the OptionalBus first and to only call Access() on the main Bus device if the first Access() returned false

type SN ¶ added in v0.6.0

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

SN is used for both SN and Eagle

func NewSN(_ Context, d []byte, version string) (*SN, error)

func (ext *SN) Access(write bool, address uint16, data uint8) (uint8, error)

func (ext *SN) Label() string

type Supergame ¶

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

https://7800.8bitdev.org/index.php/ATARI_7800_BANKSWITCHING_GUIDE

"There are several different types of Atari's SuperGame bankswitching. It basically consists of 8 16KB banks (0-7) that can be mapped in at $8000-$bfff. Bank 7 always is fixed at $c000-$ffff. To map in a chosen bank into $8000-$bfff you write it's bank number (0-7) to any address between $8000-bfff."

func NewSupergame(_ Context, d []byte, banked bool, exram bool, exrom bool) (*Supergame, error)

func (ext *Supergame) Access(write bool, address uint16, data uint8) (uint8, error)

func (ext *Supergame) Label() string