// // ExecutorImplementation.hpp // Clock Signal // // Created by Thomas Harte on 01/05/2022. // Copyright © 2022 Thomas Harte. All rights reserved. // #ifndef InstructionSets_M68k_ExecutorImplementation_hpp #define InstructionSets_M68k_ExecutorImplementation_hpp #include "../Perform.hpp" #include namespace InstructionSet { namespace M68k { template Executor::Executor(BusHandler &handler) : bus_handler_(handler) { reset(); } template void Executor::reset() { // Establish: supervisor state, all interrupts blocked. status_.set_status(0b0010'0011'1000'0000); // Seed stack pointer and program counter. data_[7].l = bus_handler_.template read(0); program_counter_.l = bus_handler_.template read(4); } template void Executor::read(DataSize size, uint32_t address, CPU::SlicedInt32 &value) { switch(size) { case DataSize::Byte: value.b = bus_handler_.template read(address); break; case DataSize::Word: value.w = bus_handler_.template read(address); break; case DataSize::LongWord: value.l = bus_handler_.template read(address); break; } } template void Executor::write(DataSize size, uint32_t address, CPU::SlicedInt32 value) { switch(size) { case DataSize::Byte: bus_handler_.template write(address, value.b); break; case DataSize::Word: bus_handler_.template write(address, value.w); break; case DataSize::LongWord: bus_handler_.template write(address, value.l); break; } } template template IntT Executor::read_pc() { const IntT result = bus_handler_.template read(program_counter_.l); if constexpr (sizeof(IntT) == 4) { program_counter_.l += 4; } else { program_counter_.l += 2; } return result; } template uint32_t Executor::index_8bitdisplacement() { // TODO: if not a 68000, check bit 8 for whether this should be a full extension word; // also include the scale field even if not. const auto extension = read_pc(); const auto offset = int8_t(extension); const int register_index = (extension >> 12) & 7; const uint32_t displacement = (extension & 0x8000) ? address_[register_index].l : data_[register_index].l; const uint32_t sized_displacement = (extension & 0x800) ? displacement : int16_t(displacement); return offset + sized_displacement; } template typename Executor::EffectiveAddress Executor::calculate_effective_address(Preinstruction instruction, uint16_t opcode, int index) { EffectiveAddress ea; switch(instruction.mode(index)) { case AddressingMode::None: // Permit an uninitialised effective address to be returned; // this value shouldn't be used. break; // // Operands that don't have effective addresses, which are returned as values. // case AddressingMode::DataRegisterDirect: ea.value = data_[instruction.reg(index)]; ea.requires_fetch = false; break; case AddressingMode::AddressRegisterDirect: ea.value = address_[instruction.reg(index)]; ea.requires_fetch = false; break; case AddressingMode::Quick: ea.value.l = quick(instruction.operation, opcode); ea.requires_fetch = false; break; case AddressingMode::ImmediateData: switch(instruction.size()) { case DataSize::Byte: ea.value.l = read_pc() & 0xff; break; case DataSize::Word: ea.value.l = read_pc(); break; case DataSize::LongWord: ea.value.l = read_pc(); break; } ea.requires_fetch = false; break; // // Absolute addresses. // case AddressingMode::AbsoluteShort: ea.value.l = int16_t(read_pc()); ea.requires_fetch = true; break; case AddressingMode::AbsoluteLong: ea.value.l = read_pc(); ea.requires_fetch = true; break; // // Address register indirects. // case AddressingMode::AddressRegisterIndirect: ea.value = address_[instruction.reg(index)]; ea.requires_fetch = true; break; case AddressingMode::AddressRegisterIndirectWithPostincrement: { const auto reg = instruction.reg(index); ea.value = address_[reg]; ea.requires_fetch = true; switch(instruction.size()) { case DataSize::Byte: address_[reg].l += byte_increments[reg]; break; case DataSize::Word: address_[reg].l += 2; break; case DataSize::LongWord: address_[reg].l += 4; break; } } break; case AddressingMode::AddressRegisterIndirectWithPredecrement: { const auto reg = instruction.reg(index); switch(instruction.size()) { case DataSize::Byte: address_[reg].l -= byte_increments[reg]; break; case DataSize::Word: address_[reg].l -= 2; break; case DataSize::LongWord: address_[reg].l -= 4; break; } ea.value = address_[reg]; ea.requires_fetch = true; } break; case AddressingMode::AddressRegisterIndirectWithDisplacement: ea.value.l = address_[instruction.reg(index)].l + int16_t(read_pc()); ea.requires_fetch = true; break; case AddressingMode::AddressRegisterIndirectWithIndex8bitDisplacement: ea.value.l = address_[instruction.reg(index)].l + index_8bitdisplacement(); ea.requires_fetch = true; break; // // PC-relative addresses. // // TODO: rephrase these in terms of instruction_address_. Just for security // against whatever mutations the PC has been through already to get to here. // case AddressingMode::ProgramCounterIndirectWithDisplacement: ea.value.l = program_counter_.l + int16_t(read_pc()); ea.requires_fetch = true; break; case AddressingMode::ProgramCounterIndirectWithIndex8bitDisplacement: ea.value.l = program_counter_.l + index_8bitdisplacement(); ea.requires_fetch = true; break; default: // TODO. assert(false); break; } return ea; } template void Executor::run_for_instructions(int count) { while(count--) { // TODO: check interrupt level, trace flag. // Read the next instruction. instruction_address_ = program_counter_.l; const auto opcode = read_pc(); const Preinstruction instruction = decoder_.decode(opcode); // TODO: check privilege level. // Temporary storage. CPU::SlicedInt32 operand_[2]; EffectiveAddress effective_address_[2]; // Calculate effective addresses; copy 'addresses' into the // operands by default both: (i) because they might be values, // rather than addresses; and (ii) then they'll be there for use // by LEA and PEA. // // TODO: much of this work should be performed by a full Decoder, // so that it can be cached. effective_address_[0] = calculate_effective_address(instruction, opcode, 0); effective_address_[1] = calculate_effective_address(instruction, opcode, 1); operand_[0] = effective_address_[0].value; operand_[1] = effective_address_[1].value; // Obtain the appropriate sequence. // // TODO: make a decision about whether this goes into a fully-decoded Instruction. Sequence sequence(instruction.operation); // Perform it. while(!sequence.empty()) { const auto step = sequence.pop_front(); switch(step) { default: assert(false); // i.e. TODO case Step::FetchOp1: case Step::FetchOp2: { const auto index = int(step) & 1; // If the operand wasn't indirect, it's already fetched. if(!effective_address_[index].requires_fetch) continue; // TODO: potential bus alignment exception. read(instruction.size(), effective_address_[index].value.l, operand_[index]); } break; case Step::Perform: perform(instruction, operand_[0], operand_[1], status_, *this); break; case Step::StoreOp1: case Step::StoreOp2: { const auto index = int(step) & 1; // If the operand wasn't indirect, store directly to Dn or An. if(!effective_address_[index].requires_fetch) { // This must be either address or data register indirect. assert( instruction.mode(index) == AddressingMode::DataRegisterDirect || instruction.mode(index) == AddressingMode::AddressRegisterDirect); // TODO: is it worth holding registers as a single block to avoid this conditional? if(instruction.mode(index) == AddressingMode::DataRegisterDirect) { data_[instruction.reg(index)] = operand_[index]; } else { address_[instruction.reg(index)] = operand_[index]; } break; } // TODO: potential bus alignment exception. write(instruction.size(), effective_address_[index].value.l, operand_[index]); } break; } } } } // MARK: - State template typename Executor::Registers Executor::get_state() { Registers result; for(int c = 0; c < 8; c++) { result.data[c] = data_[c].l; } for(int c = 0; c < 7; c++) { result.address[c] = address_[c].l; } result.status = status_.status(); result.program_counter = program_counter_.l; stack_pointers_[status_.is_supervisor_] = address_[7]; result.user_stack_pointer = stack_pointers_[0].l; result.supervisor_stack_pointer = stack_pointers_[1].l; return result; } template void Executor::set_state(const Registers &state) { for(int c = 0; c < 8; c++) { data_[c].l = state.data[c]; } for(int c = 0; c < 7; c++) { address_[c].l = state.address[c]; } status_.set_status(state.status); program_counter_.l = state.program_counter; stack_pointers_[0].l = state.user_stack_pointer; stack_pointers_[1].l = state.supervisor_stack_pointer; address_[7] = stack_pointers_[status_.is_supervisor_]; } // MARK: - Flow Control. // TODO: flow control, all below here. template void Executor::raise_exception(int) {} template void Executor::stop() {} template void Executor::set_pc(uint32_t) {} template void Executor::add_pc(uint32_t) {} template void Executor::decline_branch() {} } } #endif /* InstructionSets_M68k_ExecutorImplementation_hpp */