173 lines
13 KiB
Swift
173 lines
13 KiB
Swift
// SPDX-License-Identifier: GPL-3.0-or-later
|
|
import XCTest
|
|
|
|
final class DebuggerMMUBridgeTests: XCTestCase {
|
|
@MainActor func testOverlayBridgeQualifiesOwnerAndRequiresFreshResidencyForSourceStep() async {
|
|
for enhanced in [false, true] {
|
|
let controller = VCCMachineController()
|
|
_ = await command { controller.setAudioEnabled(false, volume: 0, completion: $0) }
|
|
_ = await command { controller.configureMachine(use6309: enhanced, ram: 1, overclock: 1, frameInterval: 1, fastForward: false, completion: $0) }
|
|
_ = await command { controller.loadDiagnostic(use6309: enhanced, completion: $0) }
|
|
// Initial authored code setup. Guest-driven replacement itself is
|
|
// covered by the core and disposable-worker loader fixtures.
|
|
let a = Data([0x12, 0x86, 0x11, 0x39]), b = Data([0x12, 0x86, 0x22, 0x39])
|
|
_ = await command { controller.debuggerWriteMemory(address: 0x4000, data: a, completion: $0) }
|
|
_ = await command { controller.debuggerSetPC(0x4000, completion: $0) }
|
|
_ = await command { controller.debuggerSetBreakpoints([0x4567], completion: $0) }
|
|
let initial = await capture(controller, includePhysical: false)
|
|
let physical = Int(initial.mmu.effective[2].sourceAddress / 8192)
|
|
let modules: [[String: Any]] = [("a", a), ("b", b)].map { name, bytes in
|
|
["id": name, "pages": [["logicalPage": 2, "physicalPage": physical]],
|
|
"addresses": [0x4000], "bytes": [bytes], "breakpoints": [],
|
|
"overlay_group": "stage", "overlay_owner": name]
|
|
}
|
|
let armed = await command { controller.debuggerArmBankedDevelopmentBreakpoints([], modules: modules, completion: $0) }
|
|
XCTAssertNil(armed.errorMessage); XCTAssertTrue(armed.debuggerDevelopmentAttached)
|
|
XCTAssertNotEqual(armed.debuggerResidencyFingerprint, 0)
|
|
var malformed = modules
|
|
malformed[0].removeValue(forKey: "overlay_owner")
|
|
let invalid = await command { controller.debuggerArmBankedDevelopmentBreakpoints([], modules: malformed, completion: $0) }
|
|
XCTAssertNotNil(invalid.errorMessage)
|
|
XCTAssertEqual(invalid.debuggerResidencyFingerprint, armed.debuggerResidencyFingerprint)
|
|
for key in ["overlay_group", "overlay_owner"] {
|
|
var definitions = modules; definitions[0][key] = "a\0truncated"
|
|
let rejectedDefinitions = definitions
|
|
let rejected = await command { controller.debuggerArmBankedDevelopmentBreakpoints([], modules: rejectedDefinitions, completion: $0) }
|
|
XCTAssertNotNil(rejected.errorMessage)
|
|
XCTAssertEqual(rejected.debuggerResidencyFingerprint, armed.debuggerResidencyFingerprint)
|
|
}
|
|
func step(_ fingerprint: UInt64) async -> VCCMachineSnapshot {
|
|
await command {
|
|
controller.debuggerStepBankedSource(mode: 0, addresses: [0x4000,0x4001,0x4000,0x4001], locations: [1,2,3,4],
|
|
bytes: [Data([0x12]),Data([0x86,0x11]),Data([0x12]),Data([0x86,0x22])],
|
|
moduleIdentifiers: ["a","a","b","b"], generation: armed.generation,
|
|
programRevision: armed.debuggerProgramRevision, mappingFingerprint: armed.debuggerMappingFingerprint,
|
|
residencyFingerprint: fingerprint, programCounter: 0x4000, completion: $0)
|
|
}
|
|
}
|
|
let stale = await step(armed.debuggerResidencyFingerprint &+ 1)
|
|
XCTAssertNotNil(stale.errorMessage); XCTAssertEqual(stale.cycles, armed.cycles)
|
|
let started = await step(armed.debuggerResidencyFingerprint)
|
|
XCTAssertNil(started.errorMessage)
|
|
var stopped = started
|
|
for _ in 0..<100 where stopped.state == .running {
|
|
try? await Task.sleep(for: .milliseconds(5)); stopped = await command(controller.snapshot)
|
|
}
|
|
XCTAssertEqual(stopped.state, .paused); XCTAssertEqual(stopped.programCounter, 0x4001)
|
|
XCTAssertEqual(stopped.debuggerResidencyFingerprint, armed.debuggerResidencyFingerprint)
|
|
let final = await capture(controller, includePhysical: false)
|
|
XCTAssertEqual(final.breakpoints.map(\.uint16Value), [0x4567])
|
|
_ = await command(controller.shutdown)
|
|
}
|
|
}
|
|
@MainActor func testBankedGuardBridgeFreezesModulesAndPreservesManualPoints() async {
|
|
let controller = VCCMachineController()
|
|
_ = await command { controller.setAudioEnabled(false, volume: 0, completion: $0) }
|
|
_ = await command(controller.loadDiagnostic)
|
|
_ = await command { controller.debuggerWriteMemory(address: 0x4000, data: Data([0x12,0x20,0xfe]), completion: $0) }
|
|
_ = await command { controller.debuggerSetPC(0x4000, completion: $0) }
|
|
_ = await command { controller.debuggerSetBreakpoints([0x4567], completion: $0) }
|
|
let initial = await capture(controller, includePhysical: false)
|
|
let physical = Int(initial.mmu.effective[2].sourceAddress / 8192)
|
|
let pages = [["logicalPage": 2, "physicalPage": physical]]
|
|
let mutableBytes = NSMutableData(data: Data([0x12]))
|
|
let module: [String: Any] = ["id": "resident", "pages": pages,
|
|
"addresses": [0x4000,0x4001], "bytes": [mutableBytes, NSData(data: Data([0x20,0xfe]))], "breakpoints": [0x4000]]
|
|
let armed = await command {
|
|
controller.debuggerArmBankedDevelopmentBreakpoints([0x4000], modules: [module], completion: $0)
|
|
mutableBytes.mutableBytes.storeBytes(of: UInt8(0x39), as: UInt8.self)
|
|
}
|
|
XCTAssertNil(armed.errorMessage)
|
|
XCTAssertTrue(armed.debuggerBankedDevelopment); XCTAssertTrue(armed.debuggerDevelopmentAttached)
|
|
XCTAssertEqual(armed.generation, initial.machine.generation)
|
|
XCTAssertEqual(armed.debuggerProgramRevision, initial.machine.debuggerProgramRevision)
|
|
let invalidPages: [[String: Any]] = [["logicalPage": 2.5, "physicalPage": physical]]
|
|
let invalid: [String: Any] = ["id": "invalid", "pages": invalidPages,
|
|
"addresses": [0x4000], "bytes": [Data([0x12])]]
|
|
let rejected = await command { controller.debuggerArmBankedDevelopmentBreakpoints([0x4000], modules: [invalid], completion: $0) }
|
|
XCTAssertNotNil(rejected.errorMessage); XCTAssertTrue(rejected.debuggerBankedDevelopment)
|
|
XCTAssertTrue(rejected.debuggerDevelopmentAttached, "Invalid replacements must retain the verified existing attachment")
|
|
for points: Any in [[0x4001], [0x4000,0x4000], [true], [16384.5], "4000"] {
|
|
var invalidQualification = module
|
|
invalidQualification["breakpoints"] = points
|
|
let definition = invalidQualification
|
|
let invalid = await command { controller.debuggerArmBankedDevelopmentBreakpoints([0x4000], modules: [definition], completion: $0) }
|
|
XCTAssertNotNil(invalid.errorMessage)
|
|
XCTAssertTrue(invalid.debuggerDevelopmentAttached, "Invalid point qualification preserves the current source connection")
|
|
}
|
|
let stale = await command {
|
|
controller.debuggerStepBankedSource(mode: 0, addresses: [0x4000,0x4001], locations: [1,2],
|
|
bytes: [Data([0x12]),Data([0x20,0xfe])], moduleIdentifiers: ["resident","resident"],
|
|
generation: armed.generation, programRevision: armed.debuggerProgramRevision,
|
|
mappingFingerprint: armed.debuggerMappingFingerprint &+ 1,
|
|
residencyFingerprint: armed.debuggerResidencyFingerprint, programCounter: 0x4000, completion: $0)
|
|
}
|
|
XCTAssertNotNil(stale.errorMessage); XCTAssertEqual(stale.state, .paused)
|
|
let cleared = await command(controller.debuggerClearDevelopmentBreakpoints)
|
|
XCTAssertFalse(cleared.debuggerBankedDevelopment); XCTAssertFalse(cleared.debuggerDevelopmentAttached)
|
|
let capture = await capture(controller, includePhysical: false)
|
|
XCTAssertEqual(capture.breakpoints.map(\.uint16Value), [0x4567])
|
|
_ = await command(controller.shutdown)
|
|
}
|
|
@MainActor private func command(_ operation: (@escaping @Sendable (VCCMachineSnapshot) -> Void) -> Void) async -> VCCMachineSnapshot {
|
|
await withCheckedContinuation { continuation in operation { continuation.resume(returning: $0) } }
|
|
}
|
|
@MainActor private func capture(_ controller: VCCMachineController, physical: UInt32 = 0,
|
|
includePhysical: Bool = true) async -> VCCDebuggerSnapshot {
|
|
await withCheckedContinuation { continuation in
|
|
controller.debuggerSnapshot(address: 0x8000, followPC: false, memoryAddress: 0x8000,
|
|
physicalAddress: physical, physicalMemory: includePhysical) {
|
|
continuation.resume(returning: $0)
|
|
}
|
|
}
|
|
}
|
|
@MainActor func testPhysicalCaptureMatchesMappedRAMWithoutROMOverlayForAllCapacities() async {
|
|
for use6309 in [false, true] {
|
|
for (ram, capacity) in [0x20000, 0x80000, 0x200000, 0x800000].enumerated() {
|
|
let controller = VCCMachineController()
|
|
_ = await command { controller.setAudioEnabled(false, volume: 0, completion: $0) }
|
|
_ = await command { controller.configureMachine(use6309: use6309, ram: ram, overclock: 1, frameInterval: 1, fastForward: false, completion: $0) }
|
|
let loaded = await command { controller.loadDiagnostic(use6309: use6309, completion: $0) }
|
|
let before = await capture(controller, includePhysical: false)
|
|
XCTAssertEqual(before.mmu.ramByteCount, UInt32(capacity))
|
|
XCTAssertEqual(before.mmu.task0.count, 8); XCTAssertEqual(before.mmu.task1.count, 8)
|
|
XCTAssertEqual(before.mmu.effective.count, 8); XCTAssertFalse(before.mmu.enabled)
|
|
XCTAssertTrue(before.physicalMemory.isEmpty)
|
|
XCTAssertEqual(before.memory[0], 0x7c, "CPU $8000 is the diagnostic ROM")
|
|
XCTAssertEqual(before.mmu.effective[4].source, 1)
|
|
let physicalROM = await capture(controller, physical: before.mmu.effective[4].ramAddress)
|
|
XCTAssertEqual(physicalROM.physicalMemory[0], 0, "Physical RAM beneath the ROM is not the ROM image")
|
|
_ = await command { controller.debuggerWriteMemory(address: 0x4000, data: Data([0x5a]), completion: $0) }
|
|
let physicalRAM = await capture(controller, physical: before.mmu.effective[2].ramAddress)
|
|
XCTAssertEqual(physicalRAM.physicalMemory[0], 0x5a)
|
|
XCTAssertEqual(physicalRAM.machine.cycles, loaded.cycles)
|
|
XCTAssertEqual(physicalRAM.machine.generation, loaded.generation)
|
|
XCTAssertEqual(physicalRAM.machine.state, .paused)
|
|
XCTAssertEqual(physicalROM.physicalMemory[0], 0, "Owned captures don't change after later writes")
|
|
_ = await command(controller.shutdown)
|
|
}
|
|
}
|
|
}
|
|
@MainActor func testPhysicalEndAndRAMResizeRecoverCursorWithoutChangingSession() async {
|
|
let controller = VCCMachineController()
|
|
_ = await command { controller.setAudioEnabled(false, volume: 0, completion: $0) }
|
|
_ = await command { controller.configureMachine(use6309: false, ram: 3, overclock: 1, frameInterval: 1, fastForward: false, completion: $0) }
|
|
_ = await command(controller.loadDiagnostic)
|
|
let last = await capture(controller, physical: 0x7fffff)
|
|
XCTAssertEqual(last.physicalAddress, 0x7fffff); XCTAssertEqual(last.physicalMemory.count, 1)
|
|
let changed = await command { controller.configureMachine(use6309: false, ram: 0, overclock: 1, frameInterval: 1, fastForward: false, completion: $0) }
|
|
let recovered = await capture(controller, physical: 0x7fffff)
|
|
XCTAssertNil(recovered.machine.errorMessage)
|
|
XCTAssertEqual(recovered.physicalAddress, 0x1ff00); XCTAssertEqual(recovered.physicalMemory.count, 256)
|
|
XCTAssertEqual(recovered.machine.generation, changed.generation)
|
|
XCTAssertEqual(recovered.mmu.ramByteCount, 0x20000)
|
|
_ = await command(controller.resume)
|
|
let running = await capture(controller)
|
|
XCTAssertEqual(running.machine.state, .running); XCTAssertEqual(running.machine.generation, changed.generation)
|
|
_ = await command(controller.shutdown)
|
|
let closed = await capture(controller)
|
|
XCTAssertEqual(closed.machine.state, .closed); XCTAssertEqual(closed.mmu.ramByteCount, 0)
|
|
XCTAssertTrue(closed.physicalMemory.isEmpty); XCTAssertTrue(closed.mmu.effective.isEmpty)
|
|
}
|
|
}
|