TRS-HARD disk emulator, aka 'FreHD'
===================================

Current release: 2.02

TRS-HARD is my contribution to the TRS80 community. It emulates
genuine Tandy hard drives, with hard drive images stored on a FAT
filesystem, located on a SD-card.

Everything to build the emulator is contained in this archive,
organized in the following directories :

+ pcb
  - bom    : build material list, with Farnell part-numbers
  - gal    : equations of the GAL and the compiled jedec file
  - gerber : gerber files, ready to be sent to a PCB manufacture.
  - pdf    : schematics and pcb, in pdf format
  - protel : pcb source (schematics and pcb), in protel99 format

+ pic      : pic source code and compiled hex file.
  - FatFS  : elm FatFS library, ported to PIC18

+ z80
  - cmd    : compiled /CMD binaries
  - z80    : source code


To build the PIC software, you will need Microchip C18 compiler (free)
and MPLab (I used version 8.36). You will also need perl, which is
used to compute the CRC16 used by the bootloader. (If you modify the
source, you need to compile twice, the second time to include the
correct CRC in your hex file).

To build the Z80 code, you need zmac. We are using version 1.3, this
assembler is public domain (by Bruce Norskog and others).



This project started during the long evenings of December 2012, and I
am very proud to release it to the community today, May 12th 2013. 
Many thanks to Andrew Quinn, who beta-tested and motivated me to
finish this project, or at least make it usable :)

One last thing : you may modify, duplicate, enhance or do whatever you
want with the code. All I ask is to keep this README file. You must
make your modifications available (GPL). If you decide to build and
sell (modified) emulators, all I ask is an emulator for my TRS80, so I
can test your changes.


Enjoy !

-Frederic Vecoven (frederic@vecoven.com)



PS: we need your help, since a few things remain to be done. Amongst
them :

- finish PIC RS232 code (I am working on it, time permitting)
- write LSDOS RS232 driver
- enhance import2 and export2 to use available memory, instead of
  copying one sector at a time (it's slow with floppy drives)
- patch LSDOS to get the time from the emulator
- write TRS utilities to copy floppy images to/from the FAT filesystem
- write LSDOS floppy driver to "mount" a floppy image from the FAT
  filesystem
- ???
