rlm@377
|
1 (ns com.aurellem.gb.rlm-assembly
|
rlm@377
|
2 "Version of main bootstrap program that is valid output for the
|
rlm@377
|
3 item-writer program."
|
rlm@377
|
4 (:use (com.aurellem.gb gb-driver assembly util vbm constants))
|
rlm@377
|
5 (:use (com.aurellem.run bootstrap-1))
|
rlm@377
|
6 (:import [com.aurellem.gb.gb_driver SaveState]))
|
rlm@377
|
7
|
rlm@390
|
8
|
rlm@390
|
9 ;; MODE-SELECT
|
rlm@390
|
10 ;; SET-LENGTH
|
rlm@390
|
11 ;; SET-TARGET
|
rlm@390
|
12 ;; WRITE
|
rlm@390
|
13 ;; JUMP
|
rlm@390
|
14
|
rlm@377
|
15 ;; Specs for Main Bootstrap Program
|
rlm@377
|
16
|
rlm@377
|
17 ;; Number-Input
|
rlm@377
|
18 ;; Number input works using all eight buttons to
|
rlm@377
|
19 ;; spell out an 8 bit number. The order of buttons is
|
rlm@377
|
20 ;; [:d :u :l :r :start :select :b :a] --> 11111111
|
rlm@377
|
21 ;; [ :l :start :a] --> 00101001
|
rlm@377
|
22
|
rlm@377
|
23 ;;; MODE-SELECT
|
rlm@377
|
24 ;; The bootstrap program starts in MODE-SELECT mode.
|
rlm@377
|
25 ;; MODE-SELECT transitions to one of three modes depending
|
rlm@377
|
26 ;; on which buttons are pressed:
|
rlm@377
|
27 ;; 0 (no-buttons) : MODE-SELECT
|
rlm@377
|
28 ;; 8 [:start] : WRITE-BYTES
|
rlm@377
|
29 ;; 0xFF (all-buttons) : JUMP
|
rlm@377
|
30
|
rlm@377
|
31 ;;; WRITE-BYTES
|
rlm@377
|
32
|
rlm@377
|
33 ;; WRITE-BYTES mode writes sequences of arbitray values to
|
rlm@377
|
34 ;; arbitray memory locations. It expects you to enter a
|
rlm@377
|
35 ;; header of three bytes describing what to write:
|
rlm@377
|
36
|
rlm@377
|
37 ;; Byte 0 : Number of Bytes to Write
|
rlm@377
|
38 ;; Byte 1 : Start Address High Byte
|
rlm@377
|
39 ;; Byte 1 : Start Address Low Byte
|
rlm@377
|
40
|
rlm@377
|
41 ;; Then, you enter the number of bytes specified in Byte 0
|
rlm@377
|
42 ;; they are written to the start address in
|
rlm@377
|
43 ;; sequence. After the last byte is written control
|
rlm@377
|
44 ;; returns to MODE-SELECT mode.
|
rlm@377
|
45
|
rlm@377
|
46 ;; Example: to write the sequence [1 2 3 4] starting at
|
rlm@377
|
47 ;; address 0xC01F enter
|
rlm@377
|
48 ;; Byte 0 : 4 (will write four bytes)
|
rlm@377
|
49 ;; Byte 1 : 0xC0 (high byte of 0xC01F)
|
rlm@377
|
50 ;; Byte 2 : 0x1F (low byte of 0xC01F)
|
rlm@377
|
51 ;; Byte 3 : 1 (write 1 to 0xC01F)
|
rlm@377
|
52 ;; Byte 4 : 2 (write 2 to 0xC020)
|
rlm@377
|
53 ;; Byte 5 : 3 (write 3 to 0xC021)
|
rlm@377
|
54 ;; Byte 6 : 4 (write 4 to 0xC022)
|
rlm@377
|
55
|
rlm@377
|
56 ;;; JUMP
|
rlm@377
|
57 ;; JUMP mode jumps program control to any arbitray
|
rlm@377
|
58 ;; location. It expects you to enter two bytes which
|
rlm@377
|
59 ;; correspond to the high and low bytes of the memory
|
rlm@377
|
60 ;; address to which you want to jump.
|
rlm@377
|
61 ;; Byte 0 : Jump Address High Byte
|
rlm@377
|
62 ;; Byte 1 : Jump Address Low Byte
|
rlm@377
|
63
|
rlm@377
|
64 ;; Example: to jump to address 0x1234 enter
|
rlm@377
|
65 ;; Byte 0 : 0x12 (high byte of 0x1234)
|
rlm@377
|
66 ;; Byte 1 : 0x34 (low byte of 0x1234)
|
rlm@377
|
67
|
rlm@377
|
68
|
rlm@378
|
69 (defn ->signed-8-bit [n]
|
rlm@378
|
70 (if (< n 0)
|
rlm@378
|
71 (+ 256 n) n))
|
rlm@378
|
72
|
rlm@378
|
73 (defn frame-metronome []
|
rlm@390
|
74 (let [init [0xC5] ;; save value of BC
|
rlm@390
|
75 timing-loop
|
rlm@388
|
76 [0x01 ; \
|
rlm@388
|
77 0x43 ; |
|
rlm@388
|
78 0xFE ; | load 0xFF44 into BC without repeats
|
rlm@388
|
79 0x0C ; |
|
rlm@388
|
80 0x04 ; /
|
rlm@388
|
81 0x0A] ;; (BC) -> A, now A = LY (vertical line coord)
|
rlm@379
|
82 continue-if-144
|
rlm@379
|
83 [0xFE
|
rlm@379
|
84 144 ;; compare LY (in A) with 144
|
rlm@379
|
85 0x20 ;; jump back to beginning if LY != 144 (not-v-blank)
|
rlm@379
|
86 (->signed-8-bit
|
rlm@381
|
87 (+ -4 (- (count timing-loop))))]
|
rlm@381
|
88 spin-loop
|
rlm@388
|
89 [0x05 ;; dec B, which is 0xFF
|
rlm@382
|
90 0x20 ;; spin until B==0
|
rlm@381
|
91 0xFD]]
|
rlm@390
|
92 (concat init timing-loop continue-if-144 spin-loop)))
|
rlm@378
|
93
|
rlm@379
|
94 (defn test-frame-metronome
|
rlm@379
|
95 "Ensure that frame-metronome ticks exactly once every frame."
|
rlm@379
|
96 ([] (test-frame-metronome 151))
|
rlm@379
|
97 ([steps]
|
rlm@388
|
98 (let [inc-E [0x1C 0x18
|
rlm@379
|
99 (->signed-8-bit
|
rlm@379
|
100 (+ -3 (- (count (frame-metronome)))))]
|
rlm@388
|
101 program (concat (frame-metronome) inc-E)
|
rlm@379
|
102 count-frames
|
rlm@379
|
103 (-> (tick (mid-game))
|
rlm@379
|
104 (IE! 0)
|
rlm@388
|
105 (DE! 0)
|
rlm@379
|
106 (set-memory-range pokemon-list-start program)
|
rlm@379
|
107 (PC! pokemon-list-start))
|
rlm@390
|
108 E-after-moves
|
rlm@390
|
109 (E (run-moves count-frames (repeat steps [])))]
|
rlm@388
|
110 (println "E:" E-after-moves)
|
rlm@388
|
111 (assert (= steps E-after-moves))
|
rlm@379
|
112
|
rlm@388
|
113 (println "E =" E-after-moves "after" steps "steps")
|
rlm@379
|
114 count-frames)))
|
rlm@379
|
115
|
rlm@384
|
116 (defn read-user-input []
|
rlm@388
|
117 [0x3E
|
rlm@388
|
118 0x20 ; prepare to measure d-pad
|
rlm@384
|
119
|
rlm@388
|
120 0x01 ;\
|
rlm@388
|
121 0x01 ; |
|
rlm@388
|
122 0xFE ; | load 0xFF00 into BC without repeats
|
rlm@388
|
123 0x04 ; |
|
rlm@388
|
124 0x0D ;/
|
rlm@386
|
125
|
rlm@388
|
126 0x02
|
rlm@388
|
127 0x0A ;; get D-pad info
|
rlm@385
|
128
|
rlm@385
|
129 0xF5 ;; push AF
|
rlm@385
|
130
|
rlm@385
|
131 0x3E
|
rlm@388
|
132 0x10 ; prepare to measure buttons
|
rlm@388
|
133
|
rlm@388
|
134 0x3F ;; clear carry flag no-op to prevent repeated nybbbles
|
rlm@385
|
135
|
rlm@388
|
136 0x02
|
rlm@388
|
137 0x0A ;; get button info
|
rlm@385
|
138
|
rlm@384
|
139 0xE6 ;; select bottom bits of A
|
rlm@384
|
140 0x0F
|
rlm@384
|
141
|
rlm@388
|
142 0x47 ;; A->B
|
rlm@385
|
143
|
rlm@385
|
144 0xF1 ;; pop AF
|
rlm@385
|
145
|
rlm@385
|
146 0xE6
|
rlm@385
|
147 0x0F ;; select bottom bits of A
|
rlm@385
|
148
|
rlm@384
|
149 0xCB
|
rlm@384
|
150 0x37 ;; swap A nybbles
|
rlm@387
|
151
|
rlm@388
|
152 0xB0 ;; (or A B) -> A
|
rlm@387
|
153
|
rlm@384
|
154 0x2F ;; (NOT A) -> A
|
rlm@390
|
155
|
rlm@384
|
156 ])
|
rlm@384
|
157
|
rlm@384
|
158 (defn test-read-user-input []
|
rlm@384
|
159 (let [program
|
rlm@384
|
160 (concat
|
rlm@384
|
161 (frame-metronome) (read-user-input)
|
rlm@388
|
162 [0x5F ;; A-> E
|
rlm@384
|
163 0x18
|
rlm@384
|
164 (->signed-8-bit
|
rlm@384
|
165 (+ (- (count (frame-metronome)))
|
rlm@384
|
166 (- (count (read-user-input)))
|
rlm@384
|
167 (- 3)))])
|
rlm@384
|
168 read-input
|
rlm@384
|
169 (-> (tick (mid-game))
|
rlm@384
|
170 (IE! 0)
|
rlm@384
|
171 (set-memory-range pokemon-list-start program)
|
rlm@384
|
172 (PC! pokemon-list-start))]
|
rlm@384
|
173 (dorun
|
rlm@385
|
174 (for [i (range 0x100)]
|
rlm@388
|
175 (assert (= (E (step read-input (buttons i))) i))))
|
rlm@385
|
176 (println "Tested all inputs.")
|
rlm@384
|
177 read-input))
|
rlm@384
|
178
|
rlm@385
|
179 (def mode-select-mode (Integer/parseInt "00000000" 2))
|
rlm@385
|
180 (def write-mode (Integer/parseInt "00000001" 2))
|
rlm@385
|
181 (def jump-mode (Integer/parseInt "10000000" 2))
|
rlm@385
|
182
|
rlm@385
|
183 (def input-high-addr-jump (Integer/parseInt "10000010" 2))
|
rlm@385
|
184 (def input-high-addr-write (Integer/parseInt "00000010" 2))
|
rlm@385
|
185 (def input-low-addr-jump (Integer/parseInt "10000100" 2))
|
rlm@385
|
186 (def input-low-addr-write (Integer/parseInt "00000100" 2))
|
rlm@385
|
187
|
rlm@385
|
188 (def input-write-num-mode (Integer/parseInt "00001000" 2))
|
rlm@385
|
189 (def do-write-mode (Integer/parseInt "00010000" 2))
|
rlm@385
|
190
|
rlm@377
|
191 (defn main-bootstrap-program [start-address]
|
rlm@390
|
192 ;; Register Use:
|
rlm@390
|
193
|
rlm@391
|
194 ;; ED non-volitale scratch
|
rlm@391
|
195
|
rlm@390
|
196 ;; A user-input
|
rlm@390
|
197 ;; HL target-address
|
rlm@391
|
198 ;; B bytes-to-write
|
rlm@391
|
199 ;; C current-mode
|
rlm@390
|
200
|
rlm@391
|
201 ;; Modes (with codes) are:
|
rlm@390
|
202
|
rlm@390
|
203 ;; single-action-modes:
|
rlm@390
|
204 ;; SET-MODE
|
rlm@391
|
205 ;; SET-TARGET-HIGH 0x67 ;; A->H
|
rlm@391
|
206 ;; SET-TARGET-LOW 0x6F ;; A->L
|
rlm@391
|
207 ;; JUMP 0xE9 ;; jump to (HL)
|
rlm@390
|
208
|
rlm@390
|
209 ;; multi-action-modes
|
rlm@391
|
210 ;; WRITE 0x47 ;; A->B
|
rlm@390
|
211
|
rlm@378
|
212 (let [[start-high start-low] (disect-bytes-2 start-address)
|
rlm@390
|
213 jump-distance (+ (count (frame-metronome))
|
rlm@390
|
214 (read-user-input))
|
rlm@385
|
215
|
rlm@385
|
216 init
|
rlm@390
|
217 [0xAF 0x5F 0x57 0x47] ;; 0->A; 0->E; 0->D; 0->B
|
rlm@388
|
218
|
rlm@391
|
219 input
|
rlm@391
|
220 [0xC1 ;; pop BC so it's not volatile
|
rlm@391
|
221
|
rlm@391
|
222 0x4F ;; A->C
|
rlm@391
|
223
|
rlm@391
|
224 0xAF ;; test for output-mode (bytes-to-write > 0)
|
rlm@391
|
225 0xB8 ;; (cp A B)
|
rlm@391
|
226
|
rlm@391
|
227 0x20 ;; skip input section if
|
rlm@391
|
228 :to-output ;; we're not in input mode
|
rlm@391
|
229
|
rlm@391
|
230
|
rlm@391
|
231 :to-be-executed
|
rlm@390
|
232
|
rlm@388
|
233
|
rlm@391
|
234 ;; write mode to instruction to be executed (pun)
|
rlm@391
|
235 0xEA
|
rlm@391
|
236 :to-be-executed-address
|
rlm@391
|
237 0x18 ;; return
|
rlm@391
|
238 :to-beginning]
|
rlm@391
|
239
|
rlm@391
|
240 output
|
rlm@391
|
241 [0x05 ;; DEC bytes-to-write (B)
|
rlm@391
|
242
|
rlm@391
|
243 0x54 ;;
|
rlm@391
|
244 0x5D ;; HL->DE \
|
rlm@391
|
245 ;; |
|
rlm@391
|
246 0x79 ;; C->A | this mess is all to do
|
rlm@391
|
247 0x12 ;; A->(DE) | 0x22 (LDI (HL), A) without
|
rlm@391
|
248 ;; | any repeating nybbles
|
rlm@391
|
249 0x23 ;; inc HL /
|
rlm@391
|
250
|
rlm@391
|
251 ]
|
rlm@391
|
252
|
rlm@390
|
253
|
rlm@390
|
254
|
rlm@391
|
255
|
rlm@390
|
256
|
rlm@389
|
257
|
rlm@391
|
258 0x22 ;; A->(HL) ; inc HL
|
rlm@389
|
259
|
rlm@389
|
260
|
rlm@389
|
261
|
rlm@389
|
262
|
rlm@389
|
263
|
rlm@385
|
264
|
rlm@385
|
265 ;; HL = here
|
rlm@387
|
266 ;; add C to HL
|
rlm@385
|
267 ;; jp HL
|
rlm@385
|
268
|
rlm@390
|
269 ]]))
|
rlm@378
|
270
|
rlm@378
|
271
|
rlm@378
|
272
|
rlm@378
|
273
|
rlm@378
|
274
|
rlm@378
|
275
|
rlm@378
|
276
|
rlm@388
|
277 (comment
|
rlm@377
|
278
|
rlm@377
|
279 ;;;;;; TESTS ;;;;;;
|
rlm@377
|
280
|
rlm@377
|
281 (defn bootstrap-base []
|
rlm@377
|
282 (let [program (main-bootstrap-program pokemon-list-start)]
|
rlm@377
|
283 ;; make sure program is valid output for item-writer
|
rlm@377
|
284 (bootstrap-pattern program)
|
rlm@377
|
285 (-> (tick (mid-game))
|
rlm@377
|
286 (set-memory-range pokemon-list-start program)
|
rlm@377
|
287 (PC! pokemon-list-start))))
|
rlm@377
|
288
|
rlm@377
|
289 (defn test-write-bytes-mode []
|
rlm@377
|
290 (let [target-address 0xC00F
|
rlm@377
|
291 [target-high target-low] (disect-bytes-2 target-address)
|
rlm@377
|
292 assembly [0xF3 0x18 0xFE 0x12]
|
rlm@377
|
293 get-mem-region #(subvec (vec (memory %))
|
rlm@377
|
294 target-address (+ target-address 20))
|
rlm@377
|
295 before (bootstrap-base)
|
rlm@377
|
296 after
|
rlm@377
|
297 (-> before
|
rlm@377
|
298 (step []) ; make sure it can handle blanks
|
rlm@377
|
299 (step []) ; at the beginning.
|
rlm@377
|
300 (step [])
|
rlm@377
|
301 (step [:start]) ; select WRITE-BYTES mode
|
rlm@377
|
302 (step (buttons 4)) ; write 4 bytes
|
rlm@377
|
303 (step (buttons target-high))
|
rlm@377
|
304 (step (buttons target-low))
|
rlm@377
|
305 (step (buttons (nth assembly 0)))
|
rlm@377
|
306 (step (buttons (nth assembly 1)))
|
rlm@377
|
307 (step (buttons (nth assembly 2)))
|
rlm@377
|
308 (step (buttons (nth assembly 3)))
|
rlm@377
|
309 (step [])
|
rlm@377
|
310 (step [])
|
rlm@377
|
311 (step []))]
|
rlm@377
|
312 (println "before :" (get-mem-region before))
|
rlm@377
|
313 (println "after :" (get-mem-region after))
|
rlm@377
|
314 (assert (= assembly (take 4 (get-mem-region after))))
|
rlm@377
|
315 after))
|
rlm@377
|
316
|
rlm@377
|
317 (defn test-jump-mode []
|
rlm@377
|
318 (let [target-address 0xC00F
|
rlm@377
|
319 [target-high target-low] (disect-bytes-2 target-address)
|
rlm@377
|
320 post-jump
|
rlm@377
|
321 (-> (test-write-bytes-mode)
|
rlm@377
|
322 (step [])
|
rlm@377
|
323 (step [])
|
rlm@377
|
324 (step [])
|
rlm@377
|
325 (step (buttons 0xFF)) ; Select JUMP mode.
|
rlm@377
|
326 (step (buttons target-high))
|
rlm@377
|
327 (step (buttons target-low)))
|
rlm@377
|
328 program-counters
|
rlm@377
|
329 (capture-program-counter
|
rlm@377
|
330 post-jump
|
rlm@377
|
331 10000)]
|
rlm@377
|
332 (println program-counters)
|
rlm@377
|
333 (assert (contains? (set program-counters) target-address))
|
rlm@377
|
334 post-jump))
|
rlm@388
|
335 ) |