dpcplus

Documentation

Overview

Package dpcplus implements the DPC+ cartridge mapper. It was developed by adapting the existing DPC mapper, which is well documented. Differences to this extended mapper were learned by studying the following URLs.

https://atariage.com/forums/blogs/entry/11712-dpc-arm-development/?tab=comments#comment-27116

https://atariage.com/forums/topic/163834-harmony-dpc-arm-programming/

The only DPC+ ROMs that I am aware of that don't use the Harmony ARM coprocessor is, Chaotic Grill and the ROM titled "DPC+demo.bin" by Darrell Sprice.

Index

• func NewDPCplus(env *environment.Environment, loader cartridgeloader.Loader) (mapper.CartMapper, error)
• type Registers
  • func (r Registers) String() string
• type State
  • func (s *State) Snapshot() *State
• type Static
  • func (mem *Static) IsExecutable(addr uint32) bool
  • func (stc *Static) MapAddress(addr uint32, write bool, executing bool) (*[]byte, uint32)
  • func (stc *Static) Read16bit(addr uint32) (uint16, bool)
  • func (stc *Static) Read32bit(addr uint32) (uint32, bool)
  • func (stc *Static) Read8bit(addr uint32) (uint8, bool)
  • func (stc *Static) Reference(segment string) ([]uint8, bool)
  • func (stc *Static) ResetVectors() (uint32, uint32, uint32)
  • func (stc *Static) Segments() []mapper.CartStaticSegment
  • func (stc *Static) Snapshot() *Static

Functions

func NewDPCplus

func NewDPCplus(env *environment.Environment, loader cartridgeloader.Loader) (mapper.CartMapper, error)

NewDPCplus is the preferred method of initialisation for the dpcPlus type.

Types

type Registers

type Registers struct {
	Fetcher      [8]dataFetcher
	FracFetcher  [8]fractionalDataFetcher
	MusicFetcher [3]musicDataFetcher

	// random number generator
	RNG randomNumberFetcher

	// fast fetch read mode
	FastFetch bool
}

Registers implements the mapper.CartRegistersBus interface.

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 mapper.CartStatic interface.

func (*Static) IsExecutable

func (mem *Static) IsExecutable(addr uint32) bool

IsExecutable implements the arm.SharedMemory interface.

func (*Static) MapAddress

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

MapAddress implements the arm.SharedMemory interface.

func (*Static) Read16bit

func (stc *Static) Read16bit(addr uint32) (uint16, bool)

Read16bit implements the mapper.CartStatic interface

func (*Static) Read32bit

func (stc *Static) Read32bit(addr uint32) (uint32, bool)

Read32bit implements the mapper.CartStatic interface

func (*Static) Read8bit

func (stc *Static) Read8bit(addr uint32) (uint8, bool)

Read8bit implements the mapper.CartStatic interface

func (*Static) Reference

func (stc *Static) Reference(segment string) ([]uint8, bool)

Reference implements the mapper.CartStatic interface

func (*Static) ResetVectors

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

ResetVectors implements the arm.SharedMemory interface.

func (*Static) Segments

func (stc *Static) Segments() []mapper.CartStaticSegment

Segments implements the mapper.CartStatic interface

func (*Static) Snapshot

func (stc *Static) Snapshot() *Static