Hangman (2022) game for the Apple-1

Good stuff!

Working great from SD on R1+

Is loading from the audio file expected to work with a Replica1? Just curious.

Hi Alex,

I think it would work: R1+ provides 32kB of RAM, so there shouldn't be any problem in loading the game properly!

Let us know! :-)

Cheers,

C

The load process completes, but running from 0280R locks up. Is that the correct entry point? 

Hi Alex,

I am sure Nino will help, here.

In the meantime, you could compare for example the first 32 bytes (i.e. 0280.02B2) and the last 32 bytes (64DA.650C) of the program:

- when you load it from ACI (not working)

- when you load it from microSD card (working)

There should be no differences, of course.

Replica-1+ has also the possibility to use a USB serial terminal, it should be easy to dump even the whole program and find differences.

To be honest, I don't know if ACI loading have some limitation in memory handling (i.e. 4kB max), I am just speculating here.

Also, I don't think the program use any of the added features of microSD card (VIA/Timer/IRQ...).

Let us know your findings...

cheers!

C.

Ah yes, very good point! I should quite easily be able to dump the entire memory region over USB Serial terminal, from either loading method. I shall let you know what I find, thanks for the helpful tips toward troubleshooting. 

I think/hope a simple fix here.

Over SD (working:)

HANGMAN#060280

$0280-$650A (25227 BYTES)

OK

HANGMAN#060280

$0280-$650A (25227 BYTES)

OK

/PLAB>\

0280.02B2

0280: A9 8A 85 02 A9 07 85 03

0288: 20 D4 02 A9 9C 85 02 A9

0290: 07 85 03 20 D4 02 A9 01

0298: 85 0D A9 00 85 0E 20 EB

02A0: 02 C9 00 F0 F9 20 0A 03

02A8: A9 C2 85 02 A9 07 85 03

02B0: 20 D4 02

64DA.650C

64DA: 4F 57 00 59 45 53

64E0: 54 45 52 44 41 59 00 59

64E8: 49 45 4C 44 00 59 4F 55

64F0: 4E 47 00 59 4F 55 52 53

64F8: 00 59 4F 55 52 53 45 4C

6500: 46 00 59 4F 55 54 48 00

6508: 0D 0D 00 E7 64

From tape, there are 2 new bytes at the beginning, causing 2 missing bytes at the end it would appear:

From cassette:C100: A9*

0280.650CR

\

0280.02B2

0280: 80 02 A9 8A 85 02 A9 07

0288: 85 03 20 D4 02 A9 9C 85

0290: 02 A9 07 85 03 20 D4 02

0298: A9 01 85 0D A9 00 85 0E

02A0: 20 EB 02 C9 00 F0 F9 20

02A8: 0A 03 A9 C2 85 02 A9 07

02B0: 85 03 20

64DA.650C

64DA: 4C 4C 4F 57 00 59

64E0: 45 53 54 45 52 44 41 59

64E8: 00 59 49 45 4C 44 00 59

64F0: 4F 55 4E 47 00 59 4F 55

64F8: 52 53 00 59 4F 55 52 53

6500: 45 4C 46 00 59 4F 55 54

6508: 48 00 0D 0D 00

I tried adding the last 2 bytes at the end, and then starting from 0282 but didn't have any luck. 

I think I got it.

Nino usually add two bytes at the beginning, for its FPGA emu.

The two bytes are the start address in little endian format, as usual.

Te real code starts just after, but I am afraid it will miss the two final bytes, E7 and 64.

I'll inform Nino about the issue.

Unfortunately starting at $282 does not work 'cause all the jumps are disrupted.

Have faith, I think he'll fix the audio files soon.

Thanks for the drill down, read you soon!

Cheers,

Claudio.

Start address in little endian makes perfect sense.

No worries and thank you as well for your replies, it's always fun :)

Cheers,

Alex

A temporary work-around-solution could be:

- load from tape from 2 address before the real start: $027E (it's the end of the keyboard buffer: won't hurt): 027E.650AR  so the jumps will be preserved.

- add manually the two missing final bytes: with 650B: E7 64

I am sure Nino will fix it very soon, but if you wanna try... ;-)

Cheers!

C.

Awesome, great workaround, and as usual I learned something :)I knew that the ACI waits for the correct amount of data, and so previously I had appended the last two bytes, but chaning the start location is brilliantly simple.As you could probably have guessed, your proposed solution works perfectly verbatim, so thank you!

One more question (because, of course I have more questions lol)

When looking to reformat the bin into text for USB to Serial, I notice the file on the SD card doesn't contain those 2 final bytes. It seems to end on 0D 00. It's trivial because loading over text has no length check like the ACI program, so adding or ommitting them is no issue, but I'm curious now the signficance of those bytes. 

I tested this over USB to Serial (use case, owner of replica1 with no SD or ACI card)

It does take a very long time, but it also works fine :)

I used the same "one-liner" I posted in another thread, to convert the bin data to a text file:

% xxd -c 8 -g 1 HANGMAN\#060280 |cut -d':' -f 2|cut -d' ' -f 1-9|sed 's/^\ /\:/g' | tr a-z A-Z > Hangman_replica1.txt

I added the last 2 bytes as I saw no harm in doing so anyway, but it would be neat to know if they are needed and what for. Anyway, after parsing the binary file with the above command, Prepend line1 with 0280 so it looks like:

% head Hangman_replica1.txt 

0280: A9 8A 85 02 A9 07 85 03

:20 D4 02 A9 9C 85 02 A9

:07 85 03 20 D4 02 A9 01

[rest of file]

That bash command seems to be a pretty solid way to reformat flattened compiled code back into text in a format where the monitor accepts it over USB to Serial as input. Run the command, add the startpoint to line1, and optionally add a final line of 0280R for example if you want the file to auto-run like most software included with the Briel Replica 1 Plus does. 

Very nice, thanks, will test the woz files later. I see hangman and anagram, if these work, my original pull request was to have the .woz file for tapemon :) . As I believe I mentioned in another thread, I got it working; I see great value in that utility if anyone else builds an ACI for their Replica-1

Also much thanks for sharing the conversion utilities :)

Cheers,

Alex

Thanks for the game!

I will play it as soon as I build my Apple 1 and my SD ACI card gets here :)

Tested Hangman successfully from the provided .woz file. For those with a Replica 1, it will take quite a long time for the .woz file to be entered from your serial terminal application (with an overly conservative line and character delay, nearly an hour. I doubt it could be done under 30 minutes reliably, even if you stripped the addresses from all but the 1st line to save 4 characters per line).

But, it works! Which means, R1+ owners have 3 ways to load this new game:

Serial w/.woz file (takes forever but requires no expansion or accessories)

Cassette w/audio (Tested only with Uncle Bernies gen2 improved ACI, takes less than 3 minutes) 

P-LAB SD Card (Takes only a handful of seconds to load) 

I would be curious to see Uncle Bernie make a turbo loader digital audio file for this like he did to load basic insanely fast via his cassette interface ;)