<P>The Apple II is one of the finest personal computers ever made, if not the finest. I love it, and even if one of mine is something like 15 years old, I still make hardware and software projects for it (I have a basic IIe, an enhanced IIe, a IIc w/384k, a ROM1 IIgs and a ROM3 IIgs).</P>
<P>I felt it lacked a hard disk, and that it would be fun to make my own hardware adapter and software, thus I designed an easy to build hardware interface. At present time, I have :</P>
<UL>
<LI>Fully functional hardware adapter for 2 IDE peripherals (e.g. a HDD and a CD-Rom reader), PIO Mode 1, running in any Apple 2 slot (tested on my IIe and on my IIgs).
<LI>low level software enabling initialization of devices, reading and writing sectors from the harddrive, analysis of Master Boot Record (find partition table), and Boot Partition Block (find a FAT16 FS in a partition). <LI>Small and fast user commands on top of low level software, to save / load / execute something from memory to disk, navigate in directory tree and more
<LI>POSIX-like API (creat(), open(), read(), write() etc.) which eases creating standard unix-like utilities (like cp, rm, mv, cat, mkdir, etc.)
<LI>Some of the utilities above.</LI></UL>
<P>These routines are currently under development, at various stages of completion.</P>
<P>This project is (to my knowledge) unique and different from other existing Apple II HDD interfaces by the following aspects :</P>
<UL>
<LI>It is freely available : you can do it and change it on your own (as opposed to commercial products). I would love to be notified of enhancements,
<LI>It is really cheap to build (my prototype cost under US$15 or FRF100 or EUR15),
<LI>It enables full 16 bit transfers to/from the IDE peripherals, by use of a 2-way MSB buffer (technique inspired by a 8051 IDE interface project published in Elektor March 2001),
<LI>On a software basis, it conforms to Microsoft FAT16 filesystem structures, so that you can mix and match files w/ PC files. Plus, user level services from my software are (will be or can easily be ported to) usable under current
Apple II operating systems (DOS3.3, ProDOS, UCSD and CP/M). This is an original and arbitrary choice, as opposed to supporting the classical 2 x 32 MB native ProDOS volumes, because it is much more open and flexible, even if
it will not be compatible with all ProDOS applications.</LI></UL></FONT><B><FONT
face=Arial size=4>
<P>2 - Theory</P></FONT></B>
<FONT face=Arial size=2>
<P>The basics are :</P>
<UL>
<LI>IDE / ATA is a 16 bit interface designed in the PC world. Use of it in a 8 bit environment like the Apple II requires some asynchronous dual way buffering of the MSB (upper 8 bits of the 16 bit word). I recently found in an Elektor application note (March 2001, Stefan Schwark) the idea of using 2 8 bit latches to add IDE/ATA to a 8051 microcontroller, and recycled this idea into this project (Elektor is an European electronics monthly newspaper).
<LI>Apart from this, IDE can be very simple to implement, since PIO modes only require a processor able to tell if it is reading or writing, 4 address bits, and a few device selection and R/W bits.
<LI>IDE / ATA standard is completely defined in an on line available document " Working Draft 1410D - T13 - Revision 1b - 14 March 2001 Information Technology - AT Attachment with Packet Interface - 6 (ATA/ATAPI-6) ", available
(Nota JPL : j'ai changΘ le lien d'origine qui Θtait mort)
<LI>FAT filesystem structures are completely defined in various web documents, among which " Hardware White Paper - Designing Hardware for Microsoft« Operating Systems - Microsoft Extensible Firmware Initiative FAT32 File System Specification - FAT: General Overview of On-Disk Format - Version 1.03, December 6, 2000 - Microsoft Corporation ", available <A
href="http://www.o3one.org/hwdocs/fat_fs/fatgen103.doc"><FONT face=Arial size=2>here</FONT></A> (Nota JPL : j'ai changΘ le lien d'origine qui Θtait mort)
<LI>From the above, I have made a hardware schematics, built a prototype, developed a few 65C02 assembly code lines and voilα ! My Apple IIe has a 170 MB hard drive and a 6x CD-ROM reader !</LI>
</UL></FONT>
<P>Here are the interface (in slot 7) and HDD (on top of power supply, w/insulating plastic shield), in my enhanced IIe :</P>
Note : all pictures below may not be very readable on your setup, but if you save them and view them separately it should be OK.
</P>
</I>
<P>The idea behind the 2 latches is to operate them asynchronously :</P>
<UL>
<LI>When I read a 16 bit word from the device, I indeed read the D0..D7 bits into the processor, and by latching logics, the other 8 D8..D15 bits get latched into a MSB "read" latch. Then, in a second read cycle at another address, I read these bits from the latch without activating the IDE device.
<LI>When I write a 16 bit word to the device, in a first step I write the D8..D15 bits into the MSB "write" latch without activating the IDE device, then in a second write cycle at another address, I write the D0..D7 bits to the device, and by another latching logics, the MSB "write" contents gets sent to the device at the same time as the D0..D7.</LI></UL>
<P>The following picture illustrates this :</P></FONT>
<P>Please note that since the decoding logic is activated by the Device Select line from the Apple II slot, the interface is mapped as 16 bytes into the Apple address space.</P>
<P>In my setup, I put the interface in slot 7, thus addresses are in the C0F0 ..C0FF range.</P>
<P>The +5V and +12V DC power supply voltages for the IDE peripherals can be taken from the Apple II bus, but it is not really recommended, due to current limitations of the Apple II power supply. This is especially true if your Apple
II is loaded with boards, like mine </P></FONT><FONT face=Wingdings
size=2>J</FONT><FONT face=Arial size=2>
<P>Don't make wiring too long. Add decoupling capacitors (100 nF) between +5VDC and GND on each chip.</P>
<P>All recommended pull-ups and pull-downs in the ATA specs are included in this design. It can handle 2 devices (master & slave), and supports cable select (then use a cable select-compatible IDE cable).</P>
<P>Schematics mention HCT class logic chips, but any (reasonably fast) kind will suit. My prototype is based on recycled chips coming from old boards.</P><P>On the photo of my prototype, there is a 20 pin DIL empty chip holder, it was intended for spare use but not used. Total chip count is 7.</P></FONT>
<B><FONT face=Arial size=4>
<P>4 - Software, basics</P></FONT></B>
<FONT face=Arial size=2>
<P>From a low level software point of view, the IDE registers map into the board address space this way :</P></FONT>
<P>Then I have written (Procode 65C02 assembly) a low level set of </FONT><A href="../../../THEMAS/M4/GUILLARD/lwlv-src.txt">routines</A><FONT face=Arial size=2> which are able to initialize the master IDE device, inquiry it and print info, analyze its MBR and find the partitions, and tell the 4 partition information. The code is commented, thus I won't go in explanations
within this document. Here is its output with my drive (actual Apple II screen capture) :</FONT></P>
<P>From this base, and with the Master Boot Record and FAT structure definition, I have made an </FONT><A href="../../../THEMAS/M4/GUILLARD/LBA-CHS.xls">Excel file</A><FONT face=Arial size=2> which helps calculating the position of various important sectors (MBR, FAT, 2<SUP>nd</SUP> FAT, First Root Dir Block, First Data Block) on the disk from its geometry, and gives cylinder / head / sector numbers, like the following for my hard drive and its only 1 FAT16 partition :</FONT></P>
<P>In the Excel file, all values in WHITE cells can be changed according to your hard drive. MBR should ALWAYS be at CHS 0 0 1.</P>
<P>The small BASIC listing included is a simple sector browser based on the assembly routines mentioned above, which will ask for a C H S location, read the 512 byte sector from the drive and display it in ASCII and HEX form. This simple program, which prompts for CHS, stores them in RAM, calls read sector routine and dump sector routine, gives the following output from my drive (3 actual Apple II screen captures) :</P></FONT>
<P>If you look at the third dumped sector (first block of the root directory of the first partition), you will recognize well-known files </FONT><FONT face=Wingdings size=2>J</FONT></P><FONT face=Arial size=2>
<P>All screen captures made through a serial cable using an Apple II super serial card and HyperTerminal on the PC.</P></FONT><B><FONT face=Arial size=4>
<P>5 - Operating system software (OSS)</P></FONT><U><FONT face=Arial>
<P>From the experience collected with the above prototype software, I went on with the idea of writing a multi layer operating environment (OSS) for the HDD :</P>
<LI>2nd layer : disk structure analysis - master boot record -> find the partition table, boot parameter block -> find the FAT16 FS and its main structures
<P>Experiencing assembly coding with the prototype software has proved to be very inefficient (even if it is the best path to small and fast code), so in order to develop all this quickly, I decided to code all in C, then when
everything is running, convert at least layers 1 to 4 back to assembly.</P>
</FONT>
<P>Thus I downloaded the CC65 6502 C compiler package from
<FONT face=Arial size=2> (thanks Ullrich Von Bassewitz), and integrated it into Microsoft Visual C++ 6. Thus I can edit code in MSVC, compile it using CC65 (configured as an external make tool), edit errors directly in MSVC thanks to CC65 printing its errors in an MSVC style, and when all is OK, wrap the binary into an Apple II bin file (which consists in adding 2 address bytes and 2 size bytes at the beginning) using a small too lI made for this purpose.
<BR><BR>
Then the code is downloaded to floppy (DOS3.3, but works as well under ProDOS) on the Apple II using HyperTerminal on the PC and Kermit385 on the Apple II (Apple Super Serial Card set to 19.200 bauds and hardware handshaking).
</FONT></P><B><U>
<FONT face=Arial>
<P>Downloads</FONT></P></U></B>
<P><A href="http://s.guillard.free.fr/Apple2IDE/csrc">Here</A><FONT face=Arial size=2> you can find the source and binaries for the current snapshot of the OSS.</FONT></P><B><FONT face=Arial size=4>
<P>6 - Limitations and future</P>
</FONT></B><UL><FONT face=Arial size=2>
<LI>The interface won't work with modern fast IDE peripherals, for reasons which probably lie in slow bus timings on the Apple II, which almost but not completely match IDE/ATA PIO mode 1 timings. Try with the oldest drives you may find. Mine works well with a Quantum LPS170AT (170 MB) drive, and a 6x CD-ROM drive, which are the only "old" IDE peripherals I have on hand. This may get fixed if I find enough time to work on bus timings. This may be different in a II GS context (had not enough time to extensively try yet). By the way, the system works as well in the II GS as it does in the IIe.
<LI>To get detailed operation info, please read the assembly source provided, it is not long but self documented. </LI></FONT></UL><B><FONT face=Arial
<P>I hope no one will find a legal issue in all this stuff, as its only purpose is have fun with open source hardware and software, experiment and share, and bring life back into an ancient but lovely computer.</P>
<P>" The author of this project can not be pursued in any case à"</P>
<P>" Use at your own risk à"</P>
<P>" Make backups à "</P>
<P>" Please if you propagate this project, do so using the original archives
à"</P>
<P>" Send me back your enhancement ideas and source code à"</P>
