Differences

This shows you the differences between two versions of the page.

--- histcomp:apple_ii [2024-08-24 05:53] – copied memory regions and IO through page 384 of Inside the Apple IIe asdf
+++ histcomp:apple_ii [2024-10-01 06:15] (current) – asdf
@@ Line 1: / Line 1: @@
 ====== Apple ][ ======
 The bulk of this page will focus on the Enhanced IIe, both because it was the most popular of the line and because it is the model we have.
 ===== Memory layout =====
 Despite the [[.:6502]]'s 64K address space, an Apple II could have significantly more RAM and ROM than that. The IIe came standard with 64K built into the motherboard, which could be doubled with an extended 80-column text card. Other peripheral cards tended to contain their own onboard RAM/ROM. All of this extra memory is accessible through bank switching.
-  * \$0000--\$00ff: zero page
+  * \$0000--\$00FF: [[#zero page]]
-  * \$0100--\$01ff: stack, Applesoft temporary storage
+  * \$0100--\$01FF: stack, [[#Applesoft]] temporary storage
-  * \$0200--\$02ff: keyboard/diskette input buffer
+  * \$0200--\$02FF: keyboard/diskette input buffer
-  * \$0300--\$03cf: user assembly programs
+  * \$0300--\$03CF: user assembly programs
-  * \$03d0--\$03ff: subroutine vectors for DOS, Applesoft, and system monitor
+  * \$03D0--\$03FF: subroutine vectors for DOS, Applesoft, and system monitor
-  * \$0400--\$07ff: text/low-res page 1
+  * \$0400--\$07FF: text/low-res page 1
-  * \$0800--\$0bff: text/low-res page 2; more commonly used for Applesoft program storage
+  * \$0800--\$0BFF: text/low-res page 2; more commonly used for Applesoft program storage
-  * \$0c00--\$1fff: free for use
+  * \$0C00--\$1FFF: free for use
-  * \$2000--\$3fff: high-res page 1
+  * \$2000--\$3FFF: high-res page 1
-  * \$4000--\$5fff: high-res page 2
+  * \$4000--\$5FFF: high-res page 2
-  * \$6000--\$bfff: normally free for use; \$9600 and above is used by DOS
+  * \$6000--\$BFFF: normally free for use; \$9600 and above is used by DOS
-  * \$c000--\$c0ff: I/O
+  * \$C000--\$C0FF: [[#I/O]]
+  * \$C100--\$C1FF: slot 1 ROM
+  * \$C200--\$C2FF: slot 2 ROM
+  * \$C300--\$C3FF: slot 3 ROM
+  * \$C400--\$C4FF: slot 4 ROM
+  * \$C500--\$C5FF: slot 5 ROM
+  * \$C600--\$C6FF: slot 6 ROM
+  * \$C700--\$C7FF: slot 7 ROM
+==== Zero page ====
+==== I/O ====
 <table |tab_io>
-<caption>Soft switches, status, and I/O addresses </caption>
+<caption>Soft switches, status, and I/O addresses [(Little1985)]</caption>
 ^ Address ^ Direction ^ Symbolic name ^ Description ^
 | \$C000 | W | ''80STOREOFF'' | Allow ''PAGE2'' to switch between video page 1 and page 2 |
@@ Line 40: / Line 51: @@
 | \$C00F | W | ''ALTCHARSETON'' | Turn on alternate characters |
 | \$C010 | R7 | ''AKD'' | 1 = a key is being pressed \\ 0 = all keys are released |
+| | RW | ''KBDSTRB'' | Clear keyboard strobe |
 | \$C011 | R7 | ''BSRBANK2'' | 1 = bank 2 of BSR is available \\ 0 = bank 1 of BSR is available |
 | \$C012 | R7 | ''BSRREADRAM'' | 1 = BSR is active for read operations \\ 0 = \$D000--\$FFFF ROM is active for read operations |
@@ Line 55: / Line 67: @@
 | \$C01E | R7 | ''ALTCHARSET'' | 1 - alternate character set is on \\ 0 = primary character set is on |
 | \$C01F | R7 | ''80COL'' | 1 = 80-column display is on \\ 0 = 40-column display is on |
-| \$C020 |
+| \$C020 | R | ''CASSOUT'' | Toggle the state of the cassette output port |
 | \$C021 |
 | \$C022 |
@@ Line 71: / Line 83: @@
 | \$C02E |
 | \$C02F |
-| \$C030 |
+| \$C030 | R | ''SPEAKER'' | Toggle the state of the speaker |
 | \$C031 |
 | \$C032 |
@@ Line 87: / Line 99: @@
 | \$C03E |
 | \$C03F |
-| \$C040 |
+| \$C040 | R | ''GCSTROBE'' | Generate a game I/O connector strobe signal |
 | \$C041 |
 | \$C042 |
@@ Line 119: / Line 131: @@
 | \$C05E | RW | ''CLRAN3'' | Turn off annunciator 3 |
 | \$C05F | RW | ''SETAN1'' | Turn on annunciator 3 |
-| \$C060 |
+| \$C060 | R7 | ''CASSIN'' | 1 = cassette input is on |
-| \$C061 |
+| \$C061 | R7 | ''PB0'' | 1 = push button 0 is on |
-| \$C062 |
+| \$C062 | R7 | ''PB1'' | 1 = push button 1 is on |
-| \$C063 |
+| \$C063 | R7 | ''PB2'' | 1 = push button 2 is on |
-| \$C064 |
+| \$C064 | R7 | ''GC0'' | 0 = game controller 0 timed out |
-| \$C065 |
+| \$C065 | R7 | ''GC1'' | 0 = game controller 1 timed out |
-| \$C066 |
+| \$C066 | R7 | ''GC2'' | 0 = game controller 2 timed out |
-| \$C067 |
+| \$C067 | R7 | ''GC3'' | 0 = game controller 3 timed out |
-| \$C068 |
+| \$C068 | R | ''GCRESET'' | Reset the game controllers |
 | \$C069 |
 | \$C06A |
@@ Line 151: / Line 163: @@
 | \$C07E |
 | \$C07F |
-| \$C080 |
+| \$C080 | R | ''READBSR2'' | Select bank 2, read BSR, write-protect BSR |
-| \$C081 |
+| \$C081 | RR | ''WRITEBSR2'' | Select bank 2, read ROM, write-enable BSR |
-| \$C082 |
+| \$C082 | R | ''OFFBSR2'' | Select bank 2, read ROM, write-protect BSR |
-| \$C083 |
+| \$C083 | RR | ''RDWRBSR2'' | Select bank 2, read BSR, write-enable BSR |
 | \$C084 |
 | \$C085 |
 | \$C086 |
 | \$C087 |
-| \$C088 |
+| \$C088 | R | ''READBSR1'' | Select bank 1, read BSR, write-protect BSR |
-| \$C089 |
+| \$C089 | RR | ''WRITEBSR1'' | Select bank 1, read ROM, write-enable BSR |
-| \$C08A |
+| \$C08A | R | ''OFFBSR1'' | Select bank 1, read ROM, write-protect BSR |
-| \$C08B |
+| \$C08B | RR | ''RDWRBSR1'' | Select bank 1, read BSR, write-enable BSR |
 | \$C08C |
 | \$C08D |
 | \$C08E |
 | \$C08F |
-| \$C090 |
+| \$C090--\$C09F | | | Reserved for use by slot 1 |
-| \$C091 |
+| \$C0A0--\$C0AF | | | Reserved for use by slot 2 |
-| \$C092 |
+| \$C0B0--\$C0BF | | | Reserved for use by slot 3 |
-| \$C093 |
+| \$C0C0--\$C0CF | | | Reserved for use by slot 4 |
-| \$C094 |
+| \$C0D0--\$C0DF | | | Reserved for use by slot 5 |
-| \$C095 |
+| \$C0E0--\$C0EF | | | Reserved for use by slot 6 |
-| \$C096 |
+| \$C0F0--\$C0FF | | | Reserved for use by slot 7 |
-| \$C097 |
+</table>
-| \$C098 |
-| \$C099 |
+==== Video memory ====
-| \$C09A |
+==== Other locations ====
-| \$C09B |
+To determine the exact model and version, examine \$FBB3 and \$FBC0. If \$FBB3 contains \$06, the computer is a IIe or IIc. \$FBC0 can contain the following values: [(Little1985)]
-| \$C09C |
-| \$C09D |
+  * \$EA: IIe with original ROMs
-| \$C09E |
+  * \$E0: IIe with enhanced ROMs
-| \$C09F |
+  * \$00: IIc
-| \$C0A0 |
-| \$C0A1 |
+===== Programming =====
-| \$C0A2 |
+==== Applesoft ====
-| \$C0A3 |
+==== Integer BASIC ====
-| \$C0A4 |
+==== System monitor ====
-| \$C0A5 |
+<table |tab_moncmd>
-| \$C0A6 |
+<caption>Monitor commands [(Little1985)]</caption>
-| \$C0A7 |
-| \$C0A8 |
-| \$C0A9 |
-| \$C0AA |
-| \$C0AB |
-| \$C0AC |
-| \$C0AD |
-| \$C0AE |
-| \$C0AF |
-| \$C0B0 |
-| \$C0B1 |
-| \$C0B2 |
-| \$C0B3 |
-| \$C0B4 |
-| \$C0B5 |
-| \$C0B6 |
-| \$C0B7 |
-| \$C0B8 |
-| \$C0B9 |
-| \$C0BA |
-| \$C0BB |
-| \$C0BC |
-| \$C0BD |
-| \$C0BE |
-| \$C0BF |
-| \$C0C0 |
-| \$C0C1 |
-| \$C0C2 |
-| \$C0C3 |
-| \$C0C4 |
-| \$C0C5 |
-| \$C0C6 |
-| \$C0C7 |
-| \$C0C8 |
-| \$C0C9 |
-| \$C0CA |
-| \$C0CB |
-| \$C0CC |
-| \$C0CD |
-| \$C0CE |
-| \$C0CF |
-| \$C0D0 |
-| \$C0D1 |
-| \$C0D2 |
-| \$C0D3 |
-| \$C0D4 |
-| \$C0D5 |
-| \$C0D6 |
-| \$C0D7 |
-| \$C0D8 |
-| \$C0D9 |
-| \$C0DA |
-| \$C0DB |
-| \$C0DC |
-| \$C0DD |
-| \$C0DE |
-| \$C0DF |
-| \$C0E0 |
-| \$C0E1 |
-| \$C0E2 |
-| \$C0E3 |
-| \$C0E4 |
-| \$C0E5 |
-| \$C0E6 |
-| \$C0E7 |
-| \$C0E8 |
-| \$C0E9 |
-| \$C0EA |
-| \$C0EB |
-| \$C0EC |
-| \$C0ED |
-| \$C0EE |
-| \$C0EF |
-| \$C0F0 |
-| \$C0F1 |
-| \$C0F2 |
-| \$C0F3 |
-| \$C0F4 |
-| \$C0F5 |
-| \$C0F6 |
-| \$C0F7 |
-| \$C0F8 |
-| \$C0F9 |
-| \$C0FA |
-| \$C0FB |
-| \$C0FC |
-| \$C0FD |
-| \$C0FE |
-| \$C0FF |
 </table>
+===== Operating systems =====
+==== DOS 3.3 ====
+==== ProDOS 8 ====
+==== CP/M ====
+In order to run CP/M, a Z80 soft card is required. While we do not currently possess one, it should be possible to find one online --- or we may be able to assemble our own from scratch using available schematics [(msc80scschem)].
+===== Peripheral cards =====
+As with the rest of this page, we will focus on cards our machine has installed.
+The Apple IIe has eight expansion slots (7 regular and 1 auxiliary). This alone is indicative of a completely different era of Apple's history, one in which the engineering team held more sway than the marketing team.
+==== Apple extended 80-column card ====
+==== Disk II interface ====
+==== Super Serial ====
+==== Applied Engineering RAMFactor  ====
+A RAM disk/memory expansion. ProDOS automatically registers it as a volume named ''/RAMs'' (where ''s'' is the slot number where the card is installed), and AppleWorks appears to relocate some of itself onto the card. Because the card uses volatile RAM, **anything saved to the card will be lost when the computer is switched off** unless external power is applied to the card. Applied Engineering sold a device to do just that, but we do not have one, nor do we particularly wish to.
+The particular revision we have contains a total of 1 MB of RAM.
+===== Sample code =====
+==== Determining current execution page ====
+This snippet is particularly useful for writing peripheral card ROM, where the code needs to function irrespective of its installed slot. It works by calling a "subroutine" consisting entirely of an ''RTS'' (\$FF58 is one of a handful of addresses that Apple guaranteed will contain an ''RTS'' instruction). Upon returning, ''$100+S'' contains the high byte of the return (calling) address.
+If calling from a peripheral card, the slot number can be identified by ANDing the result with 0F.
+<code asm6502>
+; stores the high byte of the execution address in the A register
+; clobbers: A, X
+getpage:
+    JSR $FF58    ; push the return address to the stack
+    TSX          ; use stack pointer as index to stack page
+    LDA $100,X   ; get high byte of return address
+    RTS
+</code>
+==== Writing bytes as hexadecimal ====
+We don't have to reinvent the wheel for this one --- the [[#system monitor]] includes a handy routine called ''PRBYTE'' (\$FDDA) for just this task, shown below [(a2eenhpg)]:
+<code asm6502>
+PRBYTE:    PHA
+           LSR A
+           LSR A
+           LSR A
+           LSR A
+           JSR PRHEXZ    ; =$FDE5
+           PLA
+PRHEX:     AND #$0F
+PRHEXZ:    ORA #$B0
+           CMP #$BA
+           BCC COUT      ; =$FDED
+           ADC #$06
+COUT:      JMP (CSWL)    ; =$0036, user output routine
+</code>
+To make use of it from Applesoft, load the following anywhere into memory:
+<code asm6502>
+JSR $DEBE      ; CHKCOM - skips comma in Applesoft parsing
+JSR $DFE3      ; GETPNT - get pointer to variable data, put it in $83...$84
+LDY #$00
+LDA ($83),Y    ; get high byte from VARPNT
+JSR $FDDA      ; PRBYTE
+INY
+LDA ($83),Y    ; get low byte from VARPNT
+JMP $FDDA      ; PRBYTE (will RTS for us)
+</code>
+Then it can be called from Applesoft like so (assuming the program was loaded at \$0300):
+<code basic>
+LET X% = 69
+CALL 768,X%
+</code>
+==== Generate the Mandelbrot set ====
+Useful as a benchmark. The computer must be in 80-column mode for it to display properly.
+<code basic>
+FOR Y=-12 TO 12
+FOR X=-39 TO 39
+CA=X*0.0458
+CB=Y*.08333
+A=CA
+B=CB
+FOR I = 0 TO 15
+T=A*A-B*B+CA
+B=2*A*B+CB
+A=T
+IF(A*A+B*B)>4 GOTO 200
+NEXT I
+PRINT " ";
+GOTO 210
+IF I>9 THEN I=I+7
+PRINT CHR$(48+I);
+NEXT X
+PRINT
+NEXT Y
+</code>
 ===== Resources =====
   * [[https://apple2online.com]]
+  * [[http://mirrors.apple2.org.za/Apple%20II%20Documentation%20Project/|Apple II Documentation Project]]
+  * [[https://adtpro.com/index.html|ADTPro]]
+===== Notes =====
+[(Little1985>//[[https://apple2online.com/wp-content/uploads/Inside-the-Apple-IIe.pdf|Inside the Apple IIe]]// (1985))]
+[(a2etechnotes>[[https://mirrors.apple2.org.za/Apple%20II%20Documentation%20Project/Computers/Apple%20II/Apple%20IIe/Documentation/Apple%20IIe%20Technical%20Notes.pdf|Apple IIe Technical Notes]])]
+[(a2etechrefmanual>[[https://mirrors.apple2.org.za/Apple%20II%20Documentation%20Project/Computers/Apple%20II/Apple%20IIe/Manuals/Apple%20IIe%20Technical%20Reference%20Manual.pdf|Apple IIe Technical Reference Manual]])]
+[(msc80scschem>https://mirrors.apple2.org.za/Apple%20II%20Documentation%20Project/Interface%20Cards/Z80%20Cards/Microsoft%20SoftCard/Schematics/)]
+[(a2eenhpg>[[https://ia804504.us.archive.org/19/items/about-your-enhanced-apple-iie-programmers-guide/About%20Your%20Enhanced%20Apple%20IIe%20Programmer%27s%20Guide.pdf|About Your Enhanced Apple IIe: Programmer's Guide]])]
+[(Sather1985>[[https://ia800702.us.archive.org/18/items/Understanding_the_Apple_IIe/Understanding_the_Apple_IIe.pdf|Understanding the Apple IIe]] (1985))]
+[(usingprodos>[[https://mirrors.apple2.org.za/ftp.apple.asimov.net/documentation/os/prodos/Using%20ProDOS%20-%20The%20Multilayered%20DOS.pdf|Using ProDOS]])]
+[(allpinoutsa2>[[https://allpinouts.org/pinouts/connectors/buses/apple-ii-slot/]])]
+~~REFNOTES~~