cdf

Documentation

Overview

Package cdf implemnents the various CDF type cartridge mappers including CDFJ. It was developed with reference to Darrell Spice's CDJF blog and the source to the various example ROMs therein

https://atariage.com/forums/forum/262-cdfj/

Also, it seems that most complete survey of details for this cartridge type is the Stella source code. Therefore, I have resorted to the study of the CartCDF.cxx file as found in Stella 6.4.

Note that all CDF formats rely on the arm7 package.

Index

• Constants
• func NewCDF(instance *instance.Instance, pathToROM string, version string, data []byte) (mapper.CartMapper, error)
• type Registers
  • func (r Registers) String() string
• type State
  • func (s *State) Snapshot() *State
• type Static
  • func (stc *Static) HotLoad(cartData []byte)
  • func (stc *Static) MapAddress(addr uint32, write bool) (*[]byte, uint32)
  • func (stc *Static) ResetVectors() (uint32, uint32, uint32)
  • func (stc *Static) Snapshot() *Static

Constants

const (
	DSCOMM = 32
	DSJMP  = 33
)

registers should be accessed via readDatastreamPointer() and updateDatastreamPointer(). Actually reading the data in the data stream should be done by streamData().

The following values can be used for convenience. The numbered datastreams can be accessed numerically as expected.

The AMPLITUDE register must be accessed with version.amplitude because it can change depending on the CDF version being emulated.

Functions

func NewCDF

func NewCDF(instance *instance.Instance, pathToROM string, version string, data []byte) (mapper.CartMapper, error)

NewCDF is the preferred method of initialisation for the CDF type.

Types

type Registers

type Registers struct {
	MusicFetcher [3]musicDataFetcher
	FastFetch    bool
	SampleMode   bool

	Datastream [8]datastream
}

Registers implements mappers.Registers.

func (Registers) String

func (r Registers) String() string

type State

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

func (*State) Snapshot

func (s *State) Snapshot() *State

type Static

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

Static implements the bus.CartStatic interface.

func (*Static) HotLoad

func (stc *Static) HotLoad(cartData []byte)

func (*Static) MapAddress

func (stc *Static) MapAddress(addr uint32, write bool) (*[]byte, uint32)

MapAddress implements the arm7tdmi.SharedMemory interface.

func (*Static) ResetVectors

func (stc *Static) ResetVectors() (uint32, uint32, uint32)

ResetVectors implements the arm7tdmi.SharedMemory interface.

func (*Static) Snapshot

func (stc *Static) Snapshot() *Static