-
Notifications
You must be signed in to change notification settings - Fork 19
/
preferences.go
162 lines (139 loc) · 4.48 KB
/
preferences.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
// This file is part of Gopher2600.
//
// Gopher2600 is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Gopher2600 is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Gopher2600. If not, see <https://www.gnu.org/licenses/>.
package preferences
import (
"math/rand"
"time"
"github.com/jetsetilly/gopher2600/prefs"
"github.com/jetsetilly/gopher2600/resources"
)
// Preferences defines and collates all the preference values used by the debugger.
type Preferences struct {
dsk *prefs.Disk
// random values generated in the hardware package should use the following
// number source
RandSrc *rand.Rand
// the number used to seed RandSrc
RandSeed int64
// initialise hardware to unknown state after reset
RandomState prefs.Bool
// unused pins when reading TIA/RIOT registers take the value of the last
// value on the bus. if RandomPins is true then the values of the unusued
// pins are randomised. this is the equivalent of the Stella option "drive
// unused pins randomly on a read/peek"
RandomPins prefs.Bool
// ARM preferences are contained in their own type so they can be passed
// easily to the ARM subsystem
ARM ARMPreferences
}
// Indicators that the ARM should put the MAM into the mode inidcated by the
// emulated driver for the cartridge mapper.
const MAMDriver = -1
type ARMPreferences struct {
// the specific model of ARM to use. this will affect things like memory
// addressing for cartridge formats that use the ARM.
//
// NOTE: this may be superceded in the future to allow for more flexibility
Model prefs.String
// whether the ARM coprocessor (as found in Harmony cartridges) execute
// instantly or if the cycle accurate steppint is attempted
Immediate prefs.Bool
// a value of MAMDriver says to use the driver supplied MAM value. any
// other value "forces" the MAM setting on Thumb program execution.
MAM prefs.Int
// abort Thumb program is it tries to access memory that does not exist.
// for example: reading from Flash memory above the 32k memtop (for 32k
// ROMs)
AbortOnIllegalMem prefs.Bool
}
func (p *Preferences) String() string {
return p.dsk.String()
}
// NewPreferences is the preferred method of initialisation for the Preferences type.
func NewPreferences() (*Preferences, error) {
p := &Preferences{}
p.SetDefaults()
// setup preferences and load from disk
pth, err := resources.JoinPath(prefs.DefaultPrefsFile)
if err != nil {
return nil, err
}
p.dsk, err = prefs.NewDisk(pth)
if err != nil {
return nil, err
}
err = p.dsk.Add("hardware.randState", &p.RandomState)
if err != nil {
return nil, err
}
err = p.dsk.Add("hardware.randPins", &p.RandomPins)
if err != nil {
return nil, err
}
err = p.dsk.Add("hardware.arm7.model", &p.ARM.Model)
if err != nil {
return nil, err
}
err = p.dsk.Add("hardware.arm7.immediate", &p.ARM.Immediate)
if err != nil {
return nil, err
}
err = p.dsk.Add("hardware.arm7.mam", &p.ARM.MAM)
if err != nil {
return nil, err
}
err = p.dsk.Add("hardware.arm7.abortOnIllegalMem", &p.ARM.AbortOnIllegalMem)
if err != nil {
return nil, err
}
err = p.dsk.Load(true)
if err != nil {
return nil, err
}
return p, nil
}
// SetDefaults reverts all settings to default values.
func (p *Preferences) SetDefaults() {
// initialise random number generator
p.Reseed(0)
p.RandomState.Set(false)
p.RandomPins.Set(false)
p.ARM.Model.Set("LPC2000")
p.ARM.Immediate.Set(false)
p.ARM.MAM.Set(-1)
p.ARM.AbortOnIllegalMem.Set(false)
}
// Reseed initialises the random number generator. Use a seed value of 0 to
// initialise with the current time.
func (p *Preferences) Reseed(seed int64) {
if seed == 0 {
p.RandSeed = int64(time.Now().Nanosecond())
} else {
p.RandSeed = seed
}
p.RandSrc = rand.New(rand.NewSource(p.RandSeed))
}
// Reset all hardware preferences to the default values.
func (p *Preferences) Reset() error {
return p.dsk.Reset()
}
// Load current hardware preference from disk.
func (p *Preferences) Load() error {
return p.dsk.Load(false)
}
// Save current hardware preferences to disk.
func (p *Preferences) Save() error {
return p.dsk.Save()
}