157 lines
4.8 KiB
Markdown
157 lines
4.8 KiB
Markdown
### Introduction
|
|
|
|
*CODEBREAKER!* is a [*Mastermind*](http://en.wikipedia.org/wiki/Mastermind_%28board_game%29) implementation for the [*Apple-1*](http://en.wikipedia.org/wiki/Apple_I) computer (pre-1.0 video demo: <http://youtu.be/Q_ex8GgDBjc>).
|
|
|
|
*CODEBREAKER!* has three levels of difficulty:
|
|
|
|
| Level | Slots | Colors | Attempts | Time(s) |
|
|
|--------|-------|--------|----------|---------|
|
|
| Novice | 4 | 6 | 10 | inf. |
|
|
| Pro | 5 | 8 | 12 | inf. |
|
|
| Master | 5 | 8 | 12 | 60 |
|
|
|
|
**What sets *CODEBREAKER!* apart from all those *other* Apple-1 titles?**
|
|
|
|
* *A true random number generator!* Using cycle counting while waiting for keystrokes generates a very random number. No need for seeds and no cheating possible (unless you hack the code :-).
|
|
* *A countdown timer!* Using the 960 KHz clock of the Apple-1, *CODEBREAKER!* can countdown the *Master* level with sub-second accuracy. If you really want to stress yourself out, play as a *Master*. ***You've got 60 seconds or you fail!***
|
|
|
|
|
|
### Tested Platforms
|
|
|
|
* OpenEmulator 1.0.2 (<https://code.google.com/p/openemulator/>)
|
|
* M.E.S.S. v0.145 (Mar 8 2012) - Multi Emulator Super System (<http://www.mess.org/>)
|
|
* Apple-1 Mimeo Clone 4+4 configuration (tested by Corey Cohen). *This is about as close to a real Apple-1 as you can get without a million US dollars.*
|
|
|
|
|
|
### Download
|
|
|
|
```
|
|
git clone https://github.com/datajerk/codebreaker.git
|
|
```
|
|
|
|
*or*
|
|
|
|
Download <https://github.com/datajerk/codebreaker/archive/master.zip> and extract.
|
|
|
|
|
|
### Upload and Run
|
|
|
|
If your Apple-1 has 8K of contiguous memory starting at location `$0000` then use `codebreaker.8k.mon` or `codebreaker.8k.wav`.
|
|
|
|
Load/run with `codebreaker.8k.mon`:
|
|
|
|
1. Hand type (brutal) or cut/paste `codebreaker.8k.mon` into the Apple-1 monitor and then type `280R`.
|
|
|
|
Load/run with `codebreaker.8k.wav`:
|
|
|
|
1. Load up `codebreaker.8k.wav` into your audio player.
|
|
|
|
2. Type:
|
|
|
|
```
|
|
C100R
|
|
280.1AFFR
|
|
```
|
|
|
|
3. Press *play*.
|
|
|
|
4. To run, type:
|
|
|
|
```
|
|
280R
|
|
```
|
|
|
|
<br>
|
|
|
|
If your Apple-1 has 8K of memory split into 4K banks at memory locations `$0000` and `$E000` (classic Apple-1 configuration) then use `codebreaker.4+4k.mon` or `codebreaker.4+4k.wav`.
|
|
|
|
> `$E000-$EFFF` *must be writable.*
|
|
|
|
Load/run with `codebreaker.4+4k.mon`:
|
|
|
|
1. Hand type (brutal) or cut/paste `codebreaker.4+4k.mon` into the Apple-1 monitor and then type `280R`.
|
|
|
|
Load/run with `codebreaker.4+4k.wav`:
|
|
|
|
1. Load up `codebreaker.4+4k.wav` into your audio player.
|
|
|
|
2. Type:
|
|
|
|
```
|
|
C100R
|
|
280.BFFR E000.EFFFR
|
|
```
|
|
|
|
3. Press *play*
|
|
|
|
4. To run type:
|
|
|
|
```
|
|
280R
|
|
```
|
|
|
|
|
|
### CFFA Notes
|
|
|
|
`codebreaker.po` contains 3 binaries: `CODEBREAKER`, `CODEBREAKER.PT1`, `CODEBREAKER.PT2`.
|
|
|
|
Use `CODEBREAKER` with systems that have 8k of contiguous memory starting at `$0000`.
|
|
|
|
Use `CODEBREAKER.PT1` and `.PT2` for split 8k systems (`$0000-$0FFF`, `$E000-$EFFF`)--load `PT1` before `PT2`.
|
|
|
|
In either case type `280R` to start.
|
|
|
|
|
|
### Build Notes
|
|
|
|
*CODEBREAKER!* was written in C with a bit of assembly (keyboard input, timer, and 32-bit random number seed generator). (*CODEBREAKER!* may be the *only* Apple-1 title written in C :-).
|
|
|
|
#### Prerequisites
|
|
|
|
* To compile, you will need to build cc65 (<http://cc65.github.io/cc65/>) with the `cc65-2.13.2-apple1.patch` (included).
|
|
* c2t (<https://github.com/datajerk/c2t>) for creating `.mon` and `.wav` files to load via monitor (CLI) or cassette port.
|
|
* AppleCommander (<http://applecommander.sourceforge.net/>) for creating a CFFA `.po` diskette image.
|
|
|
|
Contiguous 8K build:
|
|
|
|
```
|
|
rm codebreaker *.o
|
|
ca65 -D CODESEG=0 -t none --listing --list-bytes 100 -o getkey.o getkey.s
|
|
ca65 -D CODESEG=0 -t none --listing --list-bytes 100 -o putchar.o putchar.s
|
|
cl65 -D CODESEG=0 -T -O --static-locals -t apple1 -C apple1-8k.cfg -o codebreaker codebreaker.c getkey.o putchar.o
|
|
|
|
c2t -l codebreaker codebreaker.8k.mon
|
|
c2t -1et -r 48000 codebreaker codebreaker.8k.wav
|
|
```
|
|
|
|
Non-contiguous 4+4K build:
|
|
|
|
```
|
|
rm code.1 code.2 *.o
|
|
ca65 -D CODESEG=1 -t none --listing --list-bytes 100 -o getkey.o getkey.s
|
|
ca65 -D CODESEG=1 -t none --listing --list-bytes 100 -o putchar.o putchar.s
|
|
cl65 -D CODESEG=1 -T -O --static-locals -t apple1 -C apple1.cfg -o code.header codebreaker.c getkey.o putchar.o
|
|
|
|
c2t -l code.1,280 code.2,e000 codebreaker.4+4k.mon
|
|
c2t -1et -r 48000 code.1,280 code.2,e000 codebreaker.4+4k.wav
|
|
|
|
```
|
|
|
|
CFFA `codebreaker.po` build:
|
|
|
|
```
|
|
applecmd='java -jar /path/to/AppleCommander.jar'
|
|
|
|
rm codebreaker.po
|
|
$applecmd -pro140 codebreaker.po codebreaker
|
|
tail -c $(( $(stat -f "%z" codebreaker) - 4 )) codebreaker | $applecmd -p codebreaker.po codebreaker bin 0x0280 bin
|
|
$applecmd -p codebreaker.po codebreaker.pt1 bin 0xe000 bin < code.2
|
|
$applecmd -p codebreaker.po codebreaker.pt2 bin 0x0280 bin < code.1
|
|
$applecmd -ll codebreaker.po
|
|
```
|
|
|
|
|
|
### Changelog
|
|
|
|
* Initial 1.0 release, May 13 2012
|