histcomp:apple_ii

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
histcomp:apple_ii [2024-08-24 18:02] – finished copying appendix III tables from Inside the Apple IIe asdfhistcomp:apple_ii [2024-10-01 06:15] (current) – asdf
Line 5: Line 5:
 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. 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 ==== ==== I/O ====
 <table |tab_io> <table |tab_io>
-<caption>Soft switches, status, and I/O addresses [(Little1985>//[[https://apple2online.com/wp-content/uploads/Inside-the-Apple-IIe.pdf|Inside the Apple IIe]]// (1985))]</caption>+<caption>Soft switches, status, and I/O addresses [(Little1985)]</caption>
 ^ Address ^ Direction ^ Symbolic name ^ Description ^ ^ Address ^ Direction ^ Symbolic name ^ Description ^
 | \$C000 | W | ''80STOREOFF'' | Allow ''PAGE2'' to switch between video page 1 and page 2 | | \$C000 | W | ''80STOREOFF'' | Allow ''PAGE2'' to switch between video page 1 and page 2 |
Line 177: Line 187:
 | \$C0F0--\$C0FF | | | Reserved for use by slot 7 | | \$C0F0--\$C0FF | | | Reserved for use by slot 7 |
 </table> </table>
 +
 +==== Video memory ====
 +==== Other locations ====
 +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)]
 +
 +  * \$EA: IIe with original ROMs
 +  * \$E0: IIe with enhanced ROMs
 +  * \$00: IIc
 +
 +===== Programming =====
 +==== Applesoft ====
 +==== Integer BASIC ====
 +==== System monitor ====
 +<table |tab_moncmd>
 +<caption>Monitor commands [(Little1985)]</caption>
 +
 +</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>
 +10 LET X% = 69
 +20 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>
 +10 FOR Y=-12 TO 12
 +20 FOR X=-39 TO 39
 +30 CA=X*0.0458
 +40 CB=Y*.08333
 +50 A=CA
 +60 B=CB
 +70 FOR I = 0 TO 15
 +80 T=A*A-B*B+CA
 +90 B=2*A*B+CB
 +100 A=T
 +110 IF(A*A+B*B)>4 GOTO 200
 +120 NEXT I
 +130 PRINT " ";
 +140 GOTO 210
 +200 IF I>9 THEN I=I+7
 +205 PRINT CHR$(48+I);
 +210 NEXT X
 +220 PRINT
 +230 NEXT Y
 +</code>
 +
 ===== Resources ===== ===== Resources =====
   * [[https://apple2online.com]]   * [[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~~ ~~REFNOTES~~
  • histcomp/apple_ii.1724522564.txt.gz
  • Last modified: 2024-08-24 18:02
  • by asdf