plusrom

Documentation

Overview

Package plusrom implements the PlusROM cartridge as developed by Wolfgang Stubig. Information here:

http://pluscart.firmaplus.de/pico/?PlusROM

An AtariAge thread with the original discussion here:

https://atariage.com/forums/topic/297172-pluscart-an-inexpensive-diy-wifi-multicart/

Index

• Constants
• func NewPlusROM(child mapper.CartMapper, onLoaded func(cart mapper.CartMapper) error) (mapper.CartMapper, error)
• type AddrInfo
  • func (ai *AddrInfo) String() string
• type PlusROM
  • func (cart *PlusROM) ContainerID() string
  • func (cart *PlusROM) CopyAddrInfo() AddrInfo
  • func (cart *PlusROM) CopyBanks() []mapper.BankContent
  • func (cart *PlusROM) CopyRecvBuffer() []uint8
  • func (cart *PlusROM) CopySendBuffer() []uint8
  • func (cart *PlusROM) GetBank(addr uint16) mapper.BankInfo
  • func (cart *PlusROM) GetRAM() []mapper.CartRAM
  • func (cart *PlusROM) GetRegisters() mapper.CartRegisters
  • func (cart *PlusROM) GetStatic() []mapper.CartStatic
  • func (cart *PlusROM) GetTapeState() (bool, mapper.CartTapeState)
  • func (cart *PlusROM) ID() string
  • func (cart *PlusROM) Listen(addr uint16, data uint8)
  • func (cart *PlusROM) Mapping() string
  • func (cart *PlusROM) NumBanks() int
  • func (cart *PlusROM) Patch(offset int, data uint8) error
  • func (cart *PlusROM) Plumb()
  • func (cart *PlusROM) PutRAM(bank int, idx int, data uint8)
  • func (cart *PlusROM) PutRegister(register string, data string)
  • func (cart *PlusROM) PutStatic(segment string, idx uint16, data uint8) error
  • func (cart *PlusROM) Read(addr uint16, active bool) (data uint8, err error)
  • func (cart *PlusROM) Reset(randSrc *rand.Rand)
  • func (cart *PlusROM) Rewind()
  • func (cart *PlusROM) RewindBoundary() bool
  • func (cart *PlusROM) SetAddrInfo(host string, path string) (hostValid bool, pathValid bool)
  • func (cart *PlusROM) SetRecvBuffer(idx int, data uint8)
  • func (cart *PlusROM) SetSendBuffer(idx int, data uint8)
  • func (cart *PlusROM) Snapshot() mapper.CartMapper
  • func (cart *PlusROM) Step(clock float32)
  • func (cart *PlusROM) Write(addr uint16, data uint8, active bool, poke bool) error
• type Preferences
  • func (p *Preferences) Load() error
  • func (p *Preferences) Save() error

Constants

const (
	MaxNickLength = 10
	MaxIDLength   = 22
)

const NotAPlusROM = "not a plus rom: %s"

PlusROMError denotes a specific error in the plusrom package.

Functions

func NewPlusROM

func NewPlusROM(child mapper.CartMapper, onLoaded func(cart mapper.CartMapper) error) (mapper.CartMapper, error)

Types

type AddrInfo

type AddrInfo struct {
	Host string
	Path string
}

func (*AddrInfo) String

func (ai *AddrInfo) String() string

type PlusROM

type PlusROM struct {
	Prefs *Preferences
	// contains filtered or unexported fields
}

PlusROM wraps another mapper.CartMapper inside a network aware format.

func (*PlusROM) ContainerID

func (cart *PlusROM) ContainerID() string

ID implements the mapper.CartContainer interface.

func (*PlusROM) CopyAddrInfo

func (cart *PlusROM) CopyAddrInfo() AddrInfo

CopyAddrInfo returns a new instance of AddrInfo.

func (*PlusROM) CopyBanks

func (cart *PlusROM) CopyBanks() []mapper.BankContent

CopyBanks implements the mapper.CartMapper interface.

func (*PlusROM) CopyRecvBuffer

func (cart *PlusROM) CopyRecvBuffer() []uint8

CopyRecvBuffer makes a copy of the bytes in the receive buffer.

func (*PlusROM) CopySendBuffer

func (cart *PlusROM) CopySendBuffer() []uint8

CopySendBuffer makes a copy of the bytes in the send buffer.

func (*PlusROM) GetBank

func (cart *PlusROM) GetBank(addr uint16) mapper.BankInfo

GetBank implements the mapper.CartMapper interface.

func (*PlusROM) GetRAM

func (cart *PlusROM) GetRAM() []mapper.CartRAM

GetRAM implements the mapper.CartRAMbus interface.

func (*PlusROM) GetRegisters

func (cart *PlusROM) GetRegisters() mapper.CartRegisters

GetGetRegisters implements the mapper.CartRegistersBus interface.

func (*PlusROM) GetStatic

func (cart *PlusROM) GetStatic() []mapper.CartStatic

GetStatic implements the mapper.CartStaticBus interface.

func (*PlusROM) GetTapeState

func (cart *PlusROM) GetTapeState() (bool, mapper.CartTapeState)

GetTapeState implements the mapper.CartTapeBus interface.

func (*PlusROM) ID

func (cart *PlusROM) ID() string

ID implements the mapper.CartMapper interface.

func (*PlusROM) Listen

func (cart *PlusROM) Listen(addr uint16, data uint8)

Listen implements the mapper.CartMapper interface.

func (*PlusROM) Mapping

func (cart *PlusROM) Mapping() string

Mapping implements the mapper.CartMapper interface.

func (*PlusROM) NumBanks

func (cart *PlusROM) NumBanks() int

NumBanks implements the mapper.CartMapper interface.

func (*PlusROM) Patch

func (cart *PlusROM) Patch(offset int, data uint8) error

Patch implements the mapper.CartMapper interface.

func (*PlusROM) Plumb

func (cart *PlusROM) Plumb()

Plumb implements the mapper.CartMapper interface.

func (*PlusROM) PutRAM

func (cart *PlusROM) PutRAM(bank int, idx int, data uint8)

PutRAM implements the mapper.CartRAMbus interface.

func (*PlusROM) PutRegister

func (cart *PlusROM) PutRegister(register string, data string)

PutRegister implements the mapper.CartRegistersBus interface.

func (*PlusROM) PutStatic

func (cart *PlusROM) PutStatic(segment string, idx uint16, data uint8) error

PutStatic implements the mapper.CartStaticBus interface.

func (*PlusROM) Read

func (cart *PlusROM) Read(addr uint16, active bool) (data uint8, err error)

READ implements the mapper.CartMapper interface.

func (*PlusROM) Reset

func (cart *PlusROM) Reset(randSrc *rand.Rand)

Reset implements the mapper.CartMapper interface.

func (*PlusROM) Rewind

func (cart *PlusROM) Rewind()

Rewind implements the mapper.CartTapeBus interface.

func (*PlusROM) RewindBoundary

func (cart *PlusROM) RewindBoundary() bool

RewindBoundary implements the mapper.CartRewindBoundary interface.

func (*PlusROM) SetAddrInfo

func (cart *PlusROM) SetAddrInfo(host string, path string) (hostValid bool, pathValid bool)

SetAddrInfo updates the host/path information int the PlusROM.

func (*PlusROM) SetRecvBuffer

func (cart *PlusROM) SetRecvBuffer(idx int, data uint8)

SetRecvBuffer sets the entry that is idx places from the front with the specified value.

func (*PlusROM) SetSendBuffer

func (cart *PlusROM) SetSendBuffer(idx int, data uint8)

SetSendBuffer sets the entry that is idx places from the front with the specified value.

func (*PlusROM) Snapshot

func (cart *PlusROM) Snapshot() mapper.CartMapper

Snapshot implements the mapper.CartMapper interface.

func (*PlusROM) Step

func (cart *PlusROM) Step(clock float32)

Step implements the mapper.CartMapper interface.

func (*PlusROM) Write

func (cart *PlusROM) Write(addr uint16, data uint8, active bool, poke bool) error

Write implements the mapper.CartMapper interface.

type Preferences

type Preferences struct {
	Nick prefs.String
	ID   prefs.String

	// is true if the default nick/id are being used
	NewInstallation bool
	// contains filtered or unexported fields
}

func (*Preferences) Load

func (p *Preferences) Load() error

Load disassembly preferences and apply to the current disassembly.

func (*Preferences) Save

func (p *Preferences) Save() error

Save current disassembly preferences to disk.