9 ms·

Apple 1 ROM disassembly

109 points by janvdberg 8y ago

scarface74 8y ago
This really takes me back. I loved programming in 65C02 assembly. It was simple but complex enough to understand how computers worked. Random aside. One thing I miss is that I never had an assembler for my Apple //e. The small assembly programs I wrote, I had to write using the bare bones mini-assembler that you got by doing call -151 and then !
- dekhn 8y ago
  In high school, we had access to ORC/ASM which was a high level assembler. I spent a long time trying to understand how to program high speed graphics from machine language (Apple II had a painful mechanism for accessing graphics from machine language).
  - pvg 8y ago
    You might be thinking of ORCA/M (which is 'macro' spelled backwards), ORC/ASM would have been a bit too edgy even in those less-corporate days. There is a lot of NES programming info out there these days and if you haven't had a chance to, it's entertaining to take a look at it - it's a machine with the same CPU but real graphics hardware (for the time). Bitblitting into the mildly non-linear Apple ][ frame buffer will look pleasantly simple. The NES can do an awful lot more, of course.
    - dekhn 8y ago
      I was thinking of ORCA/M but I could have sworn it was written as ORC/ASM at some point (I recall my teacher made a joke about it).
- coldcode 8y ago
  6502 was an amazing assembly language. I wrote a VT-100 terminal emulator from scratch in a week or so way back then. Thankfully I had an Apple III with an assembler to build it in. The syntax was so simple to learn, but you could build interesting and sophisticated code by taking advantage of the quirks and tricks in the design. Of course I remember none of it any more. I am still in awe of Woz building the Apple I ROM without any tools at all.
  - ryandrake 8y ago
    6502 was the first assembly language I learned and still my favorite. Nowadays we see “programmers” who can’t even read assembly, let alone write it :(
    - jacquesm 8y ago
      Between the 6800, 6809, Z80 and the 6502 I far preferred the 6809, but I did a lot more programming for the 6502 because I got a machine with much better hardware using that chip. After that it was 68K (ST), and then PCs felt like a step down again.
  - cgh 8y ago
    This got me thinking about my time as a teenager teaching myself assembly on my C64 (which of course used the 6502 instruction set). I was trying to recall the assembler I used and I finally dredged it out of my memory: Develop-64 by French Silk Software, a now-forgotten program that I used a lot. My mom ordered it for me (her credit card) and she mentioned that the person on the phone wondered how in the hell some kid in northern Canada had ever heard of them. Good times.
    - exikyut 8y ago
      Awesome. Just did some idle digging out of curiosity, and stumbled on something that may be of interest: http://iancoog.altervista.org/HF/develop64_hf.rar http://iancoog.altervista.org/HF/develop64_hf.rar It was hiding in here: http://comp.sys.cbm.narkive.com/YJAWnSun/develop-64 http://comp.sys.cbm.narkive.com/YJAWnSun/develop-64 There are references to a "develop64_cracked" on a retro FTP server that's 404ing for that file; this RAR seems to contain the file was was on the FTP server. Also, backspacing the file off the path in the first URL gives a listing of some other releases, but this file isn't listed. Woot. Here are the other tabs that ended up open: - https://www.google.com/search?q=%22develop-64%22 https://www.google.com/search?q=%22develop-64%22 - [interesting] https://www.lemon64.com/forum/viewtopic.php?t=24254 https://www.lemon64.com/forum/viewtopic.php?t=24254 (unfortunately the embedded photos seem definitively dead; I checked IA.) Interstitial: the forum post above mentions has a link to http://www.radiks.net/~jimbo/art/int7.htm http://www.radiks.net/~jimbo/art/int7.htm. IA had captures of this just fine, but fiddling around with the dates caused me to stumble on the specific capture http://web.archive.org/web/20110724025913/http://www.radiks.net/~jimbo/art/int7.htm http://web.archive.org/web/20110724025913/http://www.radiks...., which contains a "page moved" update pointing to http://web.archive.org/web/20110813050154/http://www.mailsend-online.com/blog/?p=93; http://web.archive.org/web/20110813050154/http://www.mailsen... after stripping the IA prefix off that to see if it was still live, it transparently redirected me to... - [interesting] https://lawlessguy.wordpress.com/2016/12/04/an-interview-with-the-author-of-the-french-silk-assembler/ https://lawlessguy.wordpress.com/2016/12/04/an-interview-wit... I wish I could use bold for this line - THIS is how you keep data alive, people!! :D Also for reference, the reocities link in the above URL is dead, but oocities.com works. Unfortunately the geocities paths are not in oocities' archive. And these links were near the top of Google's results. - [uninteresting] https://www.lemon64.com/forum/viewtopic.php?t=40768 https://www.lemon64.com/forum/viewtopic.php?t=40768 - [uninteresting] http://sleepingelephant.com/ipw-web/bulletin/bb/viewtopic.php?t=2135 http://sleepingelephant.com/ipw-web/bulletin/bb/viewtopic.ph...
monocasa 8y ago
The Apple I actually shipped with a full disassembly of the ROM, with Woz's comments. http://s3data.computerhistory.org/brochures/apple.applei.1976.102646518.pdf http://s3data.computerhistory.org/brochures/apple.applei.197...
- pvg 8y ago
  Yeah, odd for someone to redo it. So did the Apple ][, with lots more commented ROM.
  - monocasa 8y ago
    I don't want to shit on him though. It's a great exercise. It's only 256 bytes, and you can compare to the original's comments when you're done to see if you were on the right track.
    - pvg 8y ago
      Oh, absolutely. It is in no way bad, I'm just wondering how one gets this far down the retro rabbit hole (An Apple I is a pretty obscure piece of hardware) and misses a thing it was well-known for. Obviously, it happens.
      - SmellyGeekBoy 8y ago
        Perhaps just a learning exercise in preparation for something much bigger. Seems like a fun project!
- adiusmus 8y ago
  Learning exercise? Keeps them off the streets at least. If someone’s really keen how about annotating the old GEOS applications from the c64? Someone’s already done the OS.
- ginko 8y ago
  Wouldn't it then just be the assembly of the ROM?
jacquesm 8y ago
I've been working on an annotated disassembly of the Yamaha DX7 ROM, it's been quite a trip so far. Figuring out all the hardware, how the operators and the envelope generators work by looking at the code, the midi implementation and so on. I work a little bit on it every week on Saturday evening, it's my way of winding down from a busy week. Other people play Sudoku ;) In case you're wondering why: I'd like to de-solder the CPU from a broken motherboard that I have (besides two working ones) to see how hard it is to take over the hardware by simulating the CPU with a RasPi, but for that I have to know exactly how the bloody thing works in the first place and it is quite a complex beast. The ROM is 16K.
- aidos 8y ago
  This I would like to know more about. Last year I started to get into electronics by creating on my own synth using an Arduino. As a software boffin, it was marvellous to learn about PWM, timers and the MIDI protocol (along with everything else). Obviously, I read up on the various synths over the years to see how they did their sound generation. Where do you even start with your project? How to you even get to the disassembled code?
  - jacquesm 8y ago
    Dump the ROM through an EPROM programmer used to read back the data, then try to figure out what chip it is (found a schematic somewhere), turns out there are two CPUs in it, one which is mask programmable which handles all the A/D and the buttons and keys, the second one which drives the whole thing. The two CPUs talk on some funky parallel link (think 'LapLink' but then for two old 8 bitters sitting 5 cm away from each other). After you know the CPU it is relatively straightforward, you try to figure out the memory map by looking at the address decoding circuitry , and from there you can infer things like where the vectors are pointing (usually they are at the end of the memory map in CPUs from that era, alternatively at '0'). So that will give you a good idea where the ROM should be located, (in this case from $C000 upwards). Then you spend lots of evenings with cups of tea and some quiet music on trying to figure out what all the instructions are trying to achieve. A good starting point is any ASCII strings, then tables of pointers to code and strings, then trace the boot vector until you come to the inevitable main loop and trace inwards from there. IRQ and NMI vectors are also useful entry points to dig around in (NMI not used here). It's a job that requires quite a bit of patience and a false start somewhere can cost you dearly. I love the little 'aha!' moments whenever I've sussed out what a particular bit of code does. For instance, the DX7 can display the battery voltage and the patch numbers and other information in decimal, like it should. So then you come across this repeated subtraction test with the contents of a table, turns out it is the binary-to-decimal convertor. It's going to be a while before this is done but it is very interesting.
tom_ 8y ago
There's a wasted byte in prnybble :( - you should do it like this instead: and #$0f sed clc adc #$90 adc #$40 cld
- Cyberdog 8y ago
  Please, reach out to Woz and let him know you found a tiny mistake in his forty-year-old work. Let me know what he says.
  - tom_ 8y ago
    Why do you think Wozniak would care? Man is a multi-milionaire on account of his Apple shares, and has better things to do these days than bum single bytes out of 6502 code ;) My post is made for the benefit of current and future 6502 programmers. I guess you must not be a 6502 programmer, because if you were, your response would be, like, "dude, fuck, that's awesome, holy shit, let me take some notes". Because that was what my response was the first time I saw this code. And that's why I'm passing it on.
    - saagarjha 8y ago
      > Why do you think Wozniak would care? From the little I know about him, this seems like exactly the thing he would care about.
      - jackhack 8y ago
        You are correct. in 2014 he woke up in a hotel in equador with an idea for saving a few chips (and add two grey-levels) in the Apple ][ design. https://www.cultofmac.com/302087/38-years-later-woz-still-thinks-ways-improve-apple-ii/ https://www.cultofmac.com/302087/38-years-later-woz-still-th... So yes, he would care.
    - wzdd 8y ago
      Just wanted to let you know that I worked through this, and I agree, it's cool... ... but no neat hack can justify the existence of BCD. :)
userbinator 8y ago
256 bytes is a reasonable amount for a "first stage bootstrap"; in other words, it's useful enough to enter a bigger program such as an assembler, through which you could eventually write a compiler... https://news.ycombinator.com/item?id=17851311 https://news.ycombinator.com/item?id=17851311 I wonder how big implementing the equivalent functionality with an x86 PC would be --- my guess is somewhat shorter, because the x86 ISA is denser than 6502. the constrained space means woz used a lot of tricks, like having a routine "fall thru" to another instead of calling it explicitly Basically tail-call optimisation with jump elimination. Nearly all compilers can do it too if you have the optimisation settings right.
- wk_end 8y ago
  > I wonder how big implementing the equivalent functionality with an x86 PC would be --- my guess is somewhat shorter, because the x86 ISA is denser than 6502. (grain of salt alert: I don't know a ton about modern PCs at this low a level) Eh, maybe if a modern PC were just an Apple I with an x86 chip dropped into it - although even then, don't underestimate the 6502 for code density (or overestimate x86) when it comes to simple bit-banging and byte-bashing. And remember, your x86-64 CPU when it starts up isn't much more than a hot-rodded 8086, so we're comparing the 6502 to that - real mode x86 with 16-bit registers and all - rather than something more modern. But my guess is that the complexity of modern IO would absolutely crush you in terms of complexity. For keyboard and video alone, the absolute bare minimum, you need to speak to the USB controller and across the PCI-E bus to the graphics card, and my intuition tells me this hardware wasn't designed to be easily programmable in a microscopic number of bytes. (I also don't know how much stuff you strictly need to do to get a stable system, but looking through the pages of Advanced Options in my BIOS concerning things like memory timing and who knows what else makes me think the motherboard itself needs a fair amount of configuration on start up...)
  - pjc50 8y ago
    Yes, it all depends where you start; a similar program written as a boot sector would be quite short, but by the time you've got there a lot of BIOS and ACPI code has already run. If you want to start from the very beginning of bootup, you do indeed have to start by turning the RAM on. See http://www.drdobbs.com/parallel/booting-an-intel-architecture-system-par/232300699?pgno=2 http://www.drdobbs.com/parallel/booting-an-intel-architectur... which I found for answering https://electronics.stackexchange.com/questions/311832/can-a-cpu-function-with-nothing-more-than-a-power-supply-and-a-rom-using-only-t/311839#311839 https://electronics.stackexchange.com/questions/311832/can-a...
ConcernedCoder 8y ago
Learning 6502 assembly, and subsequently implementing worm, and then tetris on an apple ][ from scratch, were the single greatest things I've ever done to advance my understanding of computer programming and computing architecture in general.
solomondrix 8y ago
Oh man, assembly. Brings back memories of reverse engineering, OlyDbg, and stuff.

109 points by janvdberg 8y ago

This really takes me back. I loved programming in 65C02 assembly. It was simple but complex enough to understand how computers worked. Random aside. One thing I miss is that I never had an assembler for my Apple //e. The small assembly programs I wrote, I had to write using the bare bones mini-assembler that you got by doing call -151 and then !

dekhn 8y ago
In high school, we had access to ORC/ASM which was a high level assembler. I spent a long time trying to understand how to program high speed graphics from machine language (Apple II had a painful mechanism for accessing graphics from machine language).
- pvg 8y ago
  You might be thinking of ORCA/M (which is 'macro' spelled backwards), ORC/ASM would have been a bit too edgy even in those less-corporate days. There is a lot of NES programming info out there these days and if you haven't had a chance to, it's entertaining to take a look at it - it's a machine with the same CPU but real graphics hardware (for the time). Bitblitting into the mildly non-linear Apple ][ frame buffer will look pleasantly simple. The NES can do an awful lot more, of course.
  - dekhn 8y ago
    I was thinking of ORCA/M but I could have sworn it was written as ORC/ASM at some point (I recall my teacher made a joke about it).
coldcode 8y ago
6502 was an amazing assembly language. I wrote a VT-100 terminal emulator from scratch in a week or so way back then. Thankfully I had an Apple III with an assembler to build it in. The syntax was so simple to learn, but you could build interesting and sophisticated code by taking advantage of the quirks and tricks in the design. Of course I remember none of it any more. I am still in awe of Woz building the Apple I ROM without any tools at all.
- ryandrake 8y ago
  6502 was the first assembly language I learned and still my favorite. Nowadays we see “programmers” who can’t even read assembly, let alone write it :(
  - jacquesm 8y ago
    Between the 6800, 6809, Z80 and the 6502 I far preferred the 6809, but I did a lot more programming for the 6502 because I got a machine with much better hardware using that chip. After that it was 68K (ST), and then PCs felt like a step down again.
- cgh 8y ago
  This got me thinking about my time as a teenager teaching myself assembly on my C64 (which of course used the 6502 instruction set). I was trying to recall the assembler I used and I finally dredged it out of my memory: Develop-64 by French Silk Software, a now-forgotten program that I used a lot. My mom ordered it for me (her credit card) and she mentioned that the person on the phone wondered how in the hell some kid in northern Canada had ever heard of them. Good times.
  - exikyut 8y ago
    Awesome. Just did some idle digging out of curiosity, and stumbled on something that may be of interest: http://iancoog.altervista.org/HF/develop64_hf.rar http://iancoog.altervista.org/HF/develop64_hf.rar It was hiding in here: http://comp.sys.cbm.narkive.com/YJAWnSun/develop-64 http://comp.sys.cbm.narkive.com/YJAWnSun/develop-64 There are references to a "develop64_cracked" on a retro FTP server that's 404ing for that file; this RAR seems to contain the file was was on the FTP server. Also, backspacing the file off the path in the first URL gives a listing of some other releases, but this file isn't listed. Woot. Here are the other tabs that ended up open: - https://www.google.com/search?q=%22develop-64%22 https://www.google.com/search?q=%22develop-64%22 - [interesting] https://www.lemon64.com/forum/viewtopic.php?t=24254 https://www.lemon64.com/forum/viewtopic.php?t=24254 (unfortunately the embedded photos seem definitively dead; I checked IA.) Interstitial: the forum post above mentions has a link to http://www.radiks.net/~jimbo/art/int7.htm http://www.radiks.net/~jimbo/art/int7.htm. IA had captures of this just fine, but fiddling around with the dates caused me to stumble on the specific capture http://web.archive.org/web/20110724025913/http://www.radiks.net/~jimbo/art/int7.htm http://web.archive.org/web/20110724025913/http://www.radiks...., which contains a "page moved" update pointing to http://web.archive.org/web/20110813050154/http://www.mailsend-online.com/blog/?p=93; http://web.archive.org/web/20110813050154/http://www.mailsen... after stripping the IA prefix off that to see if it was still live, it transparently redirected me to... - [interesting] https://lawlessguy.wordpress.com/2016/12/04/an-interview-with-the-author-of-the-french-silk-assembler/ https://lawlessguy.wordpress.com/2016/12/04/an-interview-wit... I wish I could use bold for this line - THIS is how you keep data alive, people!! :D Also for reference, the reocities link in the above URL is dead, but oocities.com works. Unfortunately the geocities paths are not in oocities' archive. And these links were near the top of Google's results. - [uninteresting] https://www.lemon64.com/forum/viewtopic.php?t=40768 https://www.lemon64.com/forum/viewtopic.php?t=40768 - [uninteresting] http://sleepingelephant.com/ipw-web/bulletin/bb/viewtopic.php?t=2135 http://sleepingelephant.com/ipw-web/bulletin/bb/viewtopic.ph...

monocasa 8y ago

The Apple I actually shipped with a full disassembly of the ROM, with Woz's comments. http://s3data.computerhistory.org/brochures/apple.applei.1976.102646518.pdf http://s3data.computerhistory.org/brochures/apple.applei.197...

pvg 8y ago
Yeah, odd for someone to redo it. So did the Apple ][, with lots more commented ROM.
- monocasa 8y ago
  I don't want to shit on him though. It's a great exercise. It's only 256 bytes, and you can compare to the original's comments when you're done to see if you were on the right track.
  - pvg 8y ago
    Oh, absolutely. It is in no way bad, I'm just wondering how one gets this far down the retro rabbit hole (An Apple I is a pretty obscure piece of hardware) and misses a thing it was well-known for. Obviously, it happens.
    - SmellyGeekBoy 8y ago
      Perhaps just a learning exercise in preparation for something much bigger. Seems like a fun project!
adiusmus 8y ago
Learning exercise? Keeps them off the streets at least. If someone’s really keen how about annotating the old GEOS applications from the c64? Someone’s already done the OS.
ginko 8y ago
Wouldn't it then just be the assembly of the ROM?

jacquesm 8y ago

I've been working on an annotated disassembly of the Yamaha DX7 ROM, it's been quite a trip so far. Figuring out all the hardware, how the operators and the envelope generators work by looking at the code, the midi implementation and so on. I work a little bit on it every week on Saturday evening, it's my way of winding down from a busy week. Other people play Sudoku ;) In case you're wondering why: I'd like to de-solder the CPU from a broken motherboard that I have (besides two working ones) to see how hard it is to take over the hardware by simulating the CPU with a RasPi, but for that I have to know exactly how the bloody thing works in the first place and it is quite a complex beast. The ROM is 16K.

aidos 8y ago
This I would like to know more about. Last year I started to get into electronics by creating on my own synth using an Arduino. As a software boffin, it was marvellous to learn about PWM, timers and the MIDI protocol (along with everything else). Obviously, I read up on the various synths over the years to see how they did their sound generation. Where do you even start with your project? How to you even get to the disassembled code?
- jacquesm 8y ago
  Dump the ROM through an EPROM programmer used to read back the data, then try to figure out what chip it is (found a schematic somewhere), turns out there are two CPUs in it, one which is mask programmable which handles all the A/D and the buttons and keys, the second one which drives the whole thing. The two CPUs talk on some funky parallel link (think 'LapLink' but then for two old 8 bitters sitting 5 cm away from each other). After you know the CPU it is relatively straightforward, you try to figure out the memory map by looking at the address decoding circuitry , and from there you can infer things like where the vectors are pointing (usually they are at the end of the memory map in CPUs from that era, alternatively at '0'). So that will give you a good idea where the ROM should be located, (in this case from $C000 upwards). Then you spend lots of evenings with cups of tea and some quiet music on trying to figure out what all the instructions are trying to achieve. A good starting point is any ASCII strings, then tables of pointers to code and strings, then trace the boot vector until you come to the inevitable main loop and trace inwards from there. IRQ and NMI vectors are also useful entry points to dig around in (NMI not used here). It's a job that requires quite a bit of patience and a false start somewhere can cost you dearly. I love the little 'aha!' moments whenever I've sussed out what a particular bit of code does. For instance, the DX7 can display the battery voltage and the patch numbers and other information in decimal, like it should. So then you come across this repeated subtraction test with the contents of a table, turns out it is the binary-to-decimal convertor. It's going to be a while before this is done but it is very interesting.

tom_ 8y ago

There's a wasted byte in prnybble :( - you should do it like this instead: and #$0f sed clc adc #$90 adc #$40 cld

Cyberdog 8y ago
Please, reach out to Woz and let him know you found a tiny mistake in his forty-year-old work. Let me know what he says.
- tom_ 8y ago
  Why do you think Wozniak would care? Man is a multi-milionaire on account of his Apple shares, and has better things to do these days than bum single bytes out of 6502 code ;) My post is made for the benefit of current and future 6502 programmers. I guess you must not be a 6502 programmer, because if you were, your response would be, like, "dude, fuck, that's awesome, holy shit, let me take some notes". Because that was what my response was the first time I saw this code. And that's why I'm passing it on.
  - saagarjha 8y ago
    > Why do you think Wozniak would care? From the little I know about him, this seems like exactly the thing he would care about.
    - jackhack 8y ago
      You are correct. in 2014 he woke up in a hotel in equador with an idea for saving a few chips (and add two grey-levels) in the Apple ][ design. https://www.cultofmac.com/302087/38-years-later-woz-still-thinks-ways-improve-apple-ii/ https://www.cultofmac.com/302087/38-years-later-woz-still-th... So yes, he would care.
  - wzdd 8y ago
    Just wanted to let you know that I worked through this, and I agree, it's cool... ... but no neat hack can justify the existence of BCD. :)

userbinator 8y ago

256 bytes is a reasonable amount for a "first stage bootstrap"; in other words, it's useful enough to enter a bigger program such as an assembler, through which you could eventually write a compiler... https://news.ycombinator.com/item?id=17851311 https://news.ycombinator.com/item?id=17851311 I wonder how big implementing the equivalent functionality with an x86 PC would be --- my guess is somewhat shorter, because the x86 ISA is denser than 6502. the constrained space means woz used a lot of tricks, like having a routine "fall thru" to another instead of calling it explicitly Basically tail-call optimisation with jump elimination. Nearly all compilers can do it too if you have the optimisation settings right.

wk_end 8y ago
> I wonder how big implementing the equivalent functionality with an x86 PC would be --- my guess is somewhat shorter, because the x86 ISA is denser than 6502. (grain of salt alert: I don't know a ton about modern PCs at this low a level) Eh, maybe if a modern PC were just an Apple I with an x86 chip dropped into it - although even then, don't underestimate the 6502 for code density (or overestimate x86) when it comes to simple bit-banging and byte-bashing. And remember, your x86-64 CPU when it starts up isn't much more than a hot-rodded 8086, so we're comparing the 6502 to that - real mode x86 with 16-bit registers and all - rather than something more modern. But my guess is that the complexity of modern IO would absolutely crush you in terms of complexity. For keyboard and video alone, the absolute bare minimum, you need to speak to the USB controller and across the PCI-E bus to the graphics card, and my intuition tells me this hardware wasn't designed to be easily programmable in a microscopic number of bytes. (I also don't know how much stuff you strictly need to do to get a stable system, but looking through the pages of Advanced Options in my BIOS concerning things like memory timing and who knows what else makes me think the motherboard itself needs a fair amount of configuration on start up...)
- pjc50 8y ago
  Yes, it all depends where you start; a similar program written as a boot sector would be quite short, but by the time you've got there a lot of BIOS and ACPI code has already run. If you want to start from the very beginning of bootup, you do indeed have to start by turning the RAM on. See http://www.drdobbs.com/parallel/booting-an-intel-architecture-system-par/232300699?pgno=2 http://www.drdobbs.com/parallel/booting-an-intel-architectur... which I found for answering https://electronics.stackexchange.com/questions/311832/can-a-cpu-function-with-nothing-more-than-a-power-supply-and-a-rom-using-only-t/311839#311839 https://electronics.stackexchange.com/questions/311832/can-a...

ConcernedCoder 8y ago

Learning 6502 assembly, and subsequently implementing worm, and then tetris on an apple ][ from scratch, were the single greatest things I've ever done to advance my understanding of computer programming and computing architecture in general.

solomondrix 8y ago

Oh man, assembly. Brings back memories of reverse engineering, OlyDbg, and stuff.