libsidplayfp 2.15.0
mmu.h
1/*
2 * This file is part of libsidplayfp, a SID player engine.
3 *
4 * Copyright 2011-2021 Leandro Nini <drfiemost@users.sourceforge.net>
5 * Copyright 2007-2010 Antti Lankila
6 * Copyright 2000 Simon White
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
21 */
22
23#ifndef MMU_H
24#define MMU_H
25
26#include <stdint.h>
27
28#include "sidendian.h"
29#include "sidmemory.h"
30#include "EventScheduler.h"
31
32#include "Banks/pla.h"
33#include "Banks/SystemRAMBank.h"
34#include "Banks/SystemROMBanks.h"
35#include "Banks/ZeroRAMBank.h"
36
37#include "sidcxx11.h"
38
39#include <cstring>
40
41namespace libsidplayfp
42{
43
44class Bank;
45class IOBank;
46
50class MMU final : public PLA, public sidmemory
51{
52private:
53 EventScheduler &eventScheduler;
54
56
57 bool loram = false;
58 bool hiram = false;
59 bool charen = false;
61
62 friend uint8_t readIO(MMU &self, uint_least16_t addr);
63 using ReadFunc = uint8_t (*)(MMU &self, uint_least16_t addr);
64
66 ReadFunc cpuReadMap[16];
67
69 Bank* cpuWriteMap[16];
70
72 IOBank* ioBank;
73
75 KernalRomBank kernalRomBank;
76
78 BasicRomBank basicRomBank;
79
81 CharacterRomBank characterRomBank;
82
84 SystemRAMBank ramBank;
85
87 ZeroRAMBank zeroRAMBank;
88
90 mutable unsigned int seed = 3686734;
91
92private:
93 void setCpuPort(uint8_t state) override;
94 uint8_t getLastReadByte() const override;
95 event_clock_t getPhi2Time() const override { return eventScheduler.getTime(EVENT_CLOCK_PHI2); }
96
97 void updateMappingPHI2();
98
99public:
100 MMU(EventScheduler &eventScheduler, IOBank* ioBank);
101
102 void reset();
103
104 // ROM banks methods
105 void setKernal(const uint8_t* rom) override { kernalRomBank.set(rom); }
106 void setBasic(const uint8_t* rom) override { basicRomBank.set(rom); }
107 void setChargen(const uint8_t* rom) override { characterRomBank.set(rom); }
108
109 // RAM access methods
110 uint8_t readMemByte(uint_least16_t addr) override { return ramBank.peek(addr); }
111 uint_least16_t readMemWord(uint_least16_t addr) override { return endian_little16(ramBank.ram+addr); }
112
113 void writeMemByte(uint_least16_t addr, uint8_t value) override { ramBank.poke(addr, value); }
114 void writeMemWord(uint_least16_t addr, uint_least16_t value) override { endian_little16(ramBank.ram+addr, value); }
115
116 void fillRam(uint_least16_t start, uint8_t value, unsigned int size) override
117 {
118 std::memset(ramBank.ram+start, value, size);
119 }
120 void fillRam(uint_least16_t start, const uint8_t* source, unsigned int size) override
121 {
122 std::memcpy(ramBank.ram+start, source, size);
123 }
124
125 // SID specific hacks
126 void installResetHook(uint_least16_t addr) override { kernalRomBank.installResetHook(addr); }
127
128 void installBasicTrap(uint_least16_t addr) override { basicRomBank.installTrap(addr); }
129
130 void setBasicSubtune(uint8_t tune) override { basicRomBank.setSubtune(tune); }
131
138 uint8_t cpuRead(uint_least16_t addr) { return (cpuReadMap[addr >> 12])(*this, addr); }
139
146 void cpuWrite(uint_least16_t addr, uint8_t data) { cpuWriteMap[addr >> 12]->poke(addr, data); }
147};
148
149}
150
151#endif
Definition Bank.h:36
virtual void poke(uint_least16_t address, uint8_t value)=0
Definition SystemROMBanks.h:151
void installTrap(uint_least16_t addr)
Definition SystemROMBanks.h:180
Definition SystemROMBanks.h:208
Definition EventScheduler.h:62
event_clock_t getTime(event_phase_t phase) const
Definition EventScheduler.h:158
Definition IOBank.h:40
Definition SystemROMBanks.h:87
void installResetHook(uint_least16_t addr)
Definition SystemROMBanks.h:138
Definition mmu.h:51
void installBasicTrap(uint_least16_t addr) override
Definition mmu.h:128
void cpuWrite(uint_least16_t addr, uint8_t data)
Definition mmu.h:146
void installResetHook(uint_least16_t addr) override
Definition mmu.h:126
uint8_t cpuRead(uint_least16_t addr)
Definition mmu.h:138
uint8_t readMemByte(uint_least16_t addr) override
Definition mmu.h:110
void writeMemWord(uint_least16_t addr, uint_least16_t value) override
Definition mmu.h:114
void setBasicSubtune(uint8_t tune) override
Definition mmu.h:130
void writeMemByte(uint_least16_t addr, uint8_t value) override
Definition mmu.h:113
void setKernal(const uint8_t *rom) override
Definition mmu.h:105
void fillRam(uint_least16_t start, uint8_t value, unsigned int size) override
Definition mmu.h:116
void fillRam(uint_least16_t start, const uint8_t *source, unsigned int size) override
Definition mmu.h:120
uint_least16_t readMemWord(uint_least16_t addr) override
Definition mmu.h:111
Definition pla.h:35
Definition SystemRAMBank.h:39
uint8_t peek(uint_least16_t address) override
Definition SystemRAMBank.h:72
void poke(uint_least16_t address, uint8_t value) override
Definition SystemRAMBank.h:77
Definition ZeroRAMBank.h:132
void set(const uint8_t *source)
Definition SystemROMBanks.h:68
Definition sidmemory.h:34