m68kemu

package module

Go to main page

Versions in this module

v1

v1.5.0

Sep 8, 2026

Changes in this version

+ const AutoVector

type CPU

+ Hooks func() Hooks

+ SetFastMemory func(...FastRegion)

+ SetHooks func(Hooks)

+ SetIRQSource func(IRQSource)

+ type ContainsDevice interface

+ Contains func(address uint32) bool

type CycleScheduler

+ func (s *CycleScheduler) SetClockRatio(deviceHz, cpuHz uint64)

+ type FastRegion struct

+ Base uint32

+ Mem []byte

+ ReadOnly bool

+ WaitStates uint32

+ type Hooks struct

+ Bus BusAccessCallback

+ Exception ExceptionCallback

+ Interrupt InterruptCallback

+ PreTrace PreTraceCallback

+ Trace TraceCallback

+ type IRQSource interface

+ AckIRQ func(level uint8)

+ PendingIRQ func() (level, vector uint8)

+ type Option func(*cpuConfig)

+ func WithDeferredReset() Option

v1.4.0

Sep 3, 2026

v1.3.0

Jun 13, 2026

v1.2.3

Apr 3, 2026

Changes in this version

type BusAccessInfo

+ PC uint32

type CPU

+ CurrentExceptionFrame func() (ExceptionStackFrame, bool, error)

+ History func() []HistoryEntry

+ SetHistoryLimit func(limit int)

+ SetInterruptTracer func(InterruptCallback)

+ SetPreTracer func(PreTraceCallback)

type DebugState

+ HasInterrupt bool

+ LastInterrupt InterruptInfo

type ExceptionInfo

+ Frame ExceptionStackFrame

+ FrameValid bool

+ OpcodeAddress uint32

+ StackPointer uint32

+ type ExceptionStackFrame struct

+ FaultAddress uint32

+ Format ExceptionStackFrameFormat

+ InstructionRegister uint16

+ PC uint32

+ SR uint16

+ StackPointer uint32

+ StatusWord uint16

+ func ReadExceptionStackFrame(bus AddressBus, sp uint32, format ExceptionStackFrameFormat) (ExceptionStackFrame, error)

+ type ExceptionStackFrameFormat int

+ const ExceptionStackFrameGroup0

+ const ExceptionStackFrameGroup12

+ type HistoryEntry struct

+ BusAccess BusAccessInfo

+ Exception ExceptionInfo

+ Interrupt InterruptInfo

+ Kind HistoryKind

+ Trace TraceInfo

+ type HistoryKind int

+ const HistoryBusAccess

+ const HistoryException

+ const HistoryInstruction

+ const HistoryInterrupt

+ type InterruptCallback func(InterruptInfo)

+ type InterruptInfo struct

+ AutoVector bool

+ Level uint8

+ NewPC uint32

+ NewSR uint16

+ PC uint32

+ SR uint16

+ Vector uint32

+ type PreTraceCallback func(PreTraceInfo)

+ type PreTraceInfo struct

+ Bytes []byte

+ Cycles uint64

+ Mnemonic string

+ Opcode uint16

+ PC uint32

+ Registers Registers

+ SR uint16

+ type RunPredicateInfo struct

+ Cycles uint64

+ HasBusAccess bool

+ HasException bool

+ HasInterrupt bool

+ Instructions uint64

+ LastBusAccess BusAccessInfo

+ LastException ExceptionInfo

+ LastInterrupt InterruptInfo

+ Registers Registers

type RunResult

+ BusAccess BusAccessInfo

+ HasBusAccess bool

+ HasInterrupt bool

+ Interrupt InterruptInfo

type RunStopReason

+ const RunStopBusAccess

+ const RunStopPC

+ const RunStopPredicate

type RunUntilOptions

+ StopAtPC []uint32

+ StopOnBusAccess func(BusAccessInfo) bool

+ StopPredicate func(RunPredicateInfo) bool

type TraceInfo

+ BeforeRegisters Registers

+ Cycles uint64

+ Mnemonic string

v1.2.2

Mar 29, 2026

v1.2.1

Mar 28, 2026

v1.2.0

Mar 28, 2026

Changes in this version

+ const STCartridgeEnd

+ const STCartridgeStart

+ const STIOEnd

+ const STIOStart

+ const STTOSEnd

+ const STTOSStart

+ const XLineA

+ const XLineF

+ type AddressRange struct

+ End uint32

+ Start uint32

+ func (r AddressRange) Contains(address uint32) bool

type Bus

+ func NewAtariSTBus(mappings ...STRegionMapping) *Bus

+ type BusAccessCallback func(BusAccessInfo)

+ type BusAccessInfo struct

+ Address uint32

+ InstructionFetch bool

+ Size Size

+ Value uint32

+ Write bool

type CPU

+ DebugState func() DebugState

+ RunInstructions func(count uint64) error

+ RunUntil func(options RunUntilOptions) (RunResult, error)

+ SetBusTracer func(BusAccessCallback)

+ SetExceptionTracer func(ExceptionCallback)

type CycleScheduler

+ func NewCycleScheduler() *CycleScheduler

+ func (s *CycleScheduler) AddListener(listener CycleListener)

+ func (s *CycleScheduler) Advance(delta uint64)

+ func (s *CycleScheduler) Now() uint64

+ func (s *CycleScheduler) Reset(now uint64)

+ func (s *CycleScheduler) Schedule(at uint64, fn func(now uint64))

+ func (s *CycleScheduler) ScheduleAfter(delta uint64, fn func(now uint64))

+ type DebugFaultInfo struct

+ Address uint32

+ FunctionCode uint16

+ InstructionFetch bool

+ Opcode uint16

+ PC uint32

+ Valid bool

+ Write bool

+ type DebugState struct

+ HasException bool

+ InException bool

+ InterruptMask uint8

+ LastException ExceptionInfo

+ LastFault DebugFaultInfo

+ Registers Registers

+ type DisassemblyLine struct

+ Address uint32

+ Assembly string

+ Bytes []byte

+ func DisassembleInstruction(bus AddressBus, address uint32) (DisassemblyLine, error)

+ func DisassembleMemoryRange(bus AddressBus, start uint32, length uint32) ([]DisassemblyLine, error)

+ func (line DisassemblyLine) String() string

+ type ExceptionCallback func(ExceptionInfo)

+ type ExceptionInfo struct

+ FaultAddress uint32

+ FaultValid bool

+ Group0 bool

+ InterruptMask uint8

+ NewPC uint32

+ NewSR uint16

+ Opcode uint16

+ PC uint32

+ SR uint16

+ Vector uint32

type InterruptController

+ func (ic *InterruptController) HasPending(mask uint16) bool

+ func (ic *InterruptController) Reset()

+ type MemoryRange struct

+ Label string

+ Length uint32

+ Start uint32

type RAM

+ func (ram *RAM) AddressRange() (uint32, uint32)

+ func (ram *RAM) Peek(s Size, address uint32) (uint32, error)

+ type RunResult struct

+ Cycles uint64

+ Exception ExceptionInfo

+ HasException bool

+ Instructions uint64

+ PC uint32

+ Reason RunStopReason

+ type RunStopReason int

+ const RunStopException

+ const RunStopIllegalOpcode

+ const RunStopInstructionLimit

+ const RunStopNone

+ const RunStopPCInRange

+ const RunStopPCOutsideRange

+ func (reason RunStopReason) String() string

+ type RunUntilOptions struct

+ MaxInstructions uint64

+ StopOnException bool

+ StopOnIllegal bool

+ StopOnPCRange *AddressRange

+ StopWhenPCOutside *AddressRange

+ type STRegionMapping struct

+ Device Device

+ End uint32

+ Start uint32

type TraceInfo

+ Bytes []byte

+ CycleDelta uint32

+ Opcode uint16

+ type VerboseLogger struct

+ func NewVerboseLogger(cpu CPU, bus AddressBus, writer io.Writer, options VerboseLoggerOptions) *VerboseLogger

+ func (logger *VerboseLogger) Trace(info TraceInfo)

+ type VerboseLoggerOptions struct

+ IncludeCycles bool

+ IncludeRegisters bool

+ MemoryRanges []MemoryRange

v1.1.0

Mar 26, 2026

Changes in this version

+ type AddressRangeDevice interface

+ AddressRange func() (start uint32, end uint32)

type Bus

+ func (b *Bus) Peek(s Size, address uint32) (uint32, error)

type CPU

+ Scheduler func() *CycleScheduler

+ SetScheduler func(*CycleScheduler)

+ type CycleListener interface

+ AdvanceCycles func(delta uint64, now uint64)

+ type CycleScheduler struct

type Device

+ func MapDevice(start, end uint32, device Device) Device

+ type MappedDevice struct

+ func (d *MappedDevice) AddressRange() (uint32, uint32)

+ func (d *MappedDevice) Contains(address uint32) bool

+ func (d *MappedDevice) Peek(size Size, address uint32) (uint32, error)

+ func (d *MappedDevice) Read(size Size, address uint32) (uint32, error)

+ func (d *MappedDevice) Reset()

+ func (d *MappedDevice) Write(size Size, address uint32, value uint32) error

+ type PeekDevice interface

+ Peek func(Size, uint32) (uint32, error)

+ type ScheduledEvent struct

+ At uint64

+ Fn func(now uint64)

v1.0.1

Jan 26, 2026

v1.0.0

Dec 22, 2025

Changes in this version

+ const Version

+ const XAddressError

+ const XBusError

+ const XDivByZero

+ const XIllegal

+ const XPrivViolation

+ const XTrap

+ const XUninitializedInt

+ type AddressBus interface

+ Read func(s Size, address uint32) (uint32, error)

+ Reset func()

+ Write func(s Size, address uint32, value uint32) error

+ type AddressError uint32

+ func (ae AddressError) Error() string

+ type Breakpoint struct

+ Address uint32

+ Callback func(BreakpointEvent) error

+ Halt bool

+ OnExecute bool

+ OnRead bool

+ OnWrite bool

+ type BreakpointEvent struct

+ Address uint32

+ Registers Registers

+ Type BreakpointType

+ type BreakpointHit struct

+ Address uint32

+ Type BreakpointType

+ func (bh BreakpointHit) Error() string

+ type BreakpointType int

+ const BreakpointExecute

+ const BreakpointRead

+ const BreakpointWrite

+ func (bt BreakpointType) String() string

+ type Bus struct

+ func NewBus(devices ...Device) *Bus

+ func (b *Bus) AddDevice(device Device)

+ func (b *Bus) Read(s Size, address uint32) (uint32, error)

+ func (b *Bus) Reset()

+ func (b *Bus) SetWaitHook(hook WaitHook)

+ func (b *Bus) SetWaitStates(states uint32)

+ func (b *Bus) Write(s Size, address uint32, value uint32) error

+ type BusError uint32

+ func (be BusError) Error() string

+ type CPU interface

+ AddBreakpoint func(Breakpoint)

+ Cycles func() uint64

+ Registers func() Registers

+ RequestInterrupt func(level uint8, vector *uint8) error

+ Reset func() error

+ RunCycles func(budget uint64) error

+ SetTracer func(TraceCallback)

+ Step func() error

+ func NewCPU(bus AddressBus) (CPU, error)

+ type Device interface

+ Contains func(address uint32) bool

+ Read func(Size, uint32) (uint32, error)

+ Reset func()

+ Write func(Size, uint32, uint32) error

+ type InterruptController struct

+ func NewInterruptController() *InterruptController

+ func (ic *InterruptController) Pending(mask uint16) (uint8, uint32, bool)

+ func (ic *InterruptController) Request(level uint8, vector *uint8) error

+ type RAM struct

+ func NewRAM(offset, size uint32) *RAM

+ func (ram *RAM) Contains(address uint32) bool

+ func (ram *RAM) Read(s Size, address uint32) (uint32, error)

+ func (ram *RAM) Reset()

+ func (ram *RAM) WaitStates(Size, uint32) uint32

+ func (ram *RAM) Write(s Size, address uint32, value uint32) error

+ type Registers struct

+ A [8]uint32

+ D [8]int32

+ IR uint16

+ PC uint32

+ SR uint16

+ SSP uint32

+ USP uint32

+ func (regs *Registers) String() string

+ type Size uint32

+ const Byte

+ const Long

+ const Word

+ type TraceCallback func(TraceInfo)

+ type TraceInfo struct

+ PC uint32

+ Registers Registers

+ SR uint16

+ type WaitHook func(states uint32)

+ type WaitStateDevice interface

+ WaitStates func(Size, uint32) uint32

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL