libsidplayfp 3.0.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 "sidendian.h"
27#include "sidmemory.h"
28#include "EventScheduler.h"
29
30#include "Banks/pla.h"
31#include "Banks/SystemRAMBank.h"
32#include "Banks/SystemROMBanks.h"
33#include "Banks/ZeroRAMBank.h"
34
35#include "sidcxx11.h"
36
37#include <cstdint>
38#include <cstring>
39
40namespace libsidplayfp
41{
42
43class Bank;
44class IOBank;
45
49class MMU final : public PLA, public sidmemory
50{
51private:
52 EventScheduler &eventScheduler;
53
55
56 bool loram = false;
57 bool hiram = false;
58 bool charen = false;
60
61 friend uint8_t readIO(MMU &self, uint_least16_t addr);
62 using ReadFunc = uint8_t (*)(MMU &self, uint_least16_t addr);
63
65 ReadFunc cpuReadMap[16];
66
68 Bank* cpuWriteMap[16];
69
71 IOBank* ioBank;
72
74 KernalRomBank kernalRomBank;
75
77 BasicRomBank basicRomBank;
78
80 CharacterRomBank characterRomBank;
81
83 SystemRAMBank ramBank;
84
86 ZeroRAMBank zeroRAMBank;
87
89 mutable unsigned int seed = 3686734;
90
91private:
92 void setCpuPort(uint8_t state) override;
93 uint8_t getLastReadByte() const override;
94 event_clock_t getPhi2Time() const override { return eventScheduler.getTime(EVENT_CLOCK_PHI2); }
95
96 void updateMappingPHI2();
97
98public:
99 MMU(EventScheduler &scheduler, IOBank* ioBank);
100
101 void reset();
102
103 // ROM banks methods
104 void setKernal(const uint8_t* rom) override { kernalRomBank.set(rom); }
105 void setBasic(const uint8_t* rom) override { basicRomBank.set(rom); }
106 void setChargen(const uint8_t* rom) override { characterRomBank.set(rom); }
107
108 // RAM access methods
109 uint8_t readMemByte(uint_least16_t addr) override { return ramBank.peek(addr); }
110 uint_least16_t readMemWord(uint_least16_t addr) override { return endian_little16(ramBank.ram+addr); }
111
112 void writeMemByte(uint_least16_t addr, uint8_t value) override { ramBank.poke(addr, value); }
113 void writeMemWord(uint_least16_t addr, uint_least16_t value) override { endian_little16(ramBank.ram+addr, value); }
114
115 void fillRam(uint_least16_t start, uint8_t value, unsigned int size) override
116 {
117 std::memset(ramBank.ram+start, value, size);
118 }
119 void fillRam(uint_least16_t start, const uint8_t* source, unsigned int size) override
120 {
121 std::memcpy(ramBank.ram+start, source, size);
122 }
123
124 // SID specific hacks
125 void installResetHook(uint_least16_t addr) override { kernalRomBank.installResetHook(addr); }
126
127 void installBasicTrap(uint_least16_t addr) override { basicRomBank.installTrap(addr); }
128
129 void setBasicSubtune(uint8_t tune) override { basicRomBank.setSubtune(tune); }
130
137 uint8_t cpuRead(uint_least16_t addr) { return (cpuReadMap[addr >> 12])(*this, addr); }
138
145 void cpuWrite(uint_least16_t addr, uint8_t data) { cpuWriteMap[addr >> 12]->poke(addr, data); }
146};
147
148}
149
150#endif
Definition Bank.h:36
Definition SystemROMBanks.h:246
void set(const uint8_t *basic) override
Definition SystemROMBanks.h:252
Definition SystemROMBanks.h:299
Definition EventScheduler.h:62
Definition IOBank.h:40
Definition SystemROMBanks.h:99
void installBasicTrap(uint_least16_t addr) override
Definition mmu.h:127
void cpuWrite(uint_least16_t addr, uint8_t data)
Definition mmu.h:145
void installResetHook(uint_least16_t addr) override
Definition mmu.h:125
uint8_t cpuRead(uint_least16_t addr)
Definition mmu.h:137
uint8_t readMemByte(uint_least16_t addr) override
Definition mmu.h:109
void writeMemWord(uint_least16_t addr, uint_least16_t value) override
Definition mmu.h:113
void setBasicSubtune(uint8_t tune) override
Definition mmu.h:129
void writeMemByte(uint_least16_t addr, uint8_t value) override
Definition mmu.h:112
void setKernal(const uint8_t *rom) override
Definition mmu.h:104
void fillRam(uint_least16_t start, uint8_t value, unsigned int size) override
Definition mmu.h:115
void fillRam(uint_least16_t start, const uint8_t *source, unsigned int size) override
Definition mmu.h:119
uint_least16_t readMemWord(uint_least16_t addr) override
Definition mmu.h:110
Definition pla.h:35
Definition SystemRAMBank.h:39
Definition ZeroRAMBank.h:132
virtual void set(const uint8_t *source)
Definition SystemROMBanks.h:80
Definition sidmemory.h:34