IMPORTANT:
----------

  1. If you're using the Rev.A3 PCB layout in combination with the
     SED1520 LC-Display, you MUST add the following lines to your
     autoexec.bat. The A3 PCB has a minor error, which prevents the
     display controller from resetting correctly after power-up.
     These lines will enable the SED's power-save mode, and prevent
     damage of the display (it's for real! you might get a stuck
     pixel-line otherwise!)

     ALE 1
     PCS 5
     PCS 6
     OB 500 A5
     OB 500 AE
     OB 600 A5
     OB 600 AE
  
  2. Because the player makes use of the AMD186 DMA-Channels, you
     have to insert the following settings into your chip.ini file

     [SERIAL]
     COM_DMA=DISABLE
     EXT_DMA=DISABLE

  3. If you don't have any hardware connected to the serial ports,
     you should always disable them for console input (otherwise,
     you might get trash at the commandline!)

     [STDIO]
     STDIN=TELNET
     STDOUT=TELNET
     FOCUS=USER SHELL

  4. See the "chip" directory for a sample chip.ini and autoexec!

  5. Don't forget to read the GNU Public License! It's in the
     COPYING.TXT file!


ADDITIONAL STUFF:
-----------------

  If you want to connect a harddrive to your player, you should
  format it in a normal PC first. At the time, the BIOS handles
  all Disk I/O, and so it has to be smaller than 2 GB per partition,
  FAT16 only!

  You'll find the sourcecode for a harddisk-driver in the
  tools/extdisk directory. It's quite messy, but works just
  fine..

  If someone takes the time to cleanup the code, implement
  a caching scheme, and add support for hd-spin down, i'll
  be more than happy to hear of it!


CREDITS
--------

  Many thanks to all people who write me E-Mails, and support this
  project. I certainly wouldn't have continued, if there wasn't great
  support from all of you. Thanks!

  Special thanks go to:
   
    Ulrich Lechleuter, ulrich@lechleuter.de
      for soldering the very first version of the external IDE-
      Interface (using a 8255 on the PC Parrallel port).

    Thorsten Godau, thorsten.godau@gmx.de
      for the first implementation of the command line parameters
      in ExtIDE, and debugging my ExtIDE interface. (See his great 
      WeBox project at webox.tz-mikroelektronik.de)

    Robert Dubber, r.dubber@chello.nl
      for sending me his old harddisks, finding some bugs in the
      program, and writing the great Font Creator utility!

    Detlef Gerhardt @ BeckIPC
      for buying some of my players, and just great support. I'll
      thank the whole Beck team anyways, these guys just rock!

    Robert Rottmerhusen, info@rottmerhusen.com
      for allowing me to distribute his schematics for a much simpler
      Lattice ispLSI cable. Check it out in the docs directory, only 
      a male DSUB connector, a cable, and a resistor needed!

    All the folks at de.sci.electronics
      I simply don't know, if i could have built this player,
      without the invaluable support of this newsgroup..

    
Have fun!



MY PRIVATE AREA:
----------------

BUT WHY, DAMMIT? WHY? 
If you have to ask why, you're not a member of the intended audience. 
Please go on about your business and accept my apologies for this 
distraction. 



Eagle files - kleine änderungen:
  - etwas größere keepout-area um die befestigungslöcher
  - VS1001 etwas nach rechts rücken
  - gucken, ob man die klinkenbuchse gerade bekommt
  - größerer copyright-schriftzug
  - 1M widerstand drehen (wegen berührung)
  - 330R widerstand für IDE-Led
  - Konstrast-Poti vorsehen. Wenn das display warm wird,
    wird es sonst sehr schlecht ablesbar..
  - Welche Befestigungslöcher brauchen die 2.5" HD's
    eigentlich wirklich?
  - Jumper (oder lötbrücke), mit dem man den VS1001 Reset-Pin
    auf einen PIO legen kann (wichtig!)
  - Platine auf 100xXX mm bringen, sonst passt die in kein gehäuse...
  - Vielleicht sollte man D0-D7 und D8-D15 am IDE-Interface
    vertauschen -- 1.2Mb/s schreiben, 600k/s lesen ist besser
    geeignet für Festplatten...
  - aber vorher mit einem Adapterkabel ausprobieren!
  
  - 74245er ist eigentlich überflüssig. Statt dessen einen 10k (oder 5k)
    (oder 1k?!?) Widerstand in alle Leitungen zum VS1001, um den Strom an den
    Eingängen zu begrenzen. Sollte sehr viel platz auf der Platine schaffen...

  - Reset-Leitung mit 1k Pullup, und mit 10k an den VS1001.


Fehler im Platinenlayout A3:
  - Reset vom Display muss dauerhaft auf GND liegen, oder noch besser:
    den anderen resetausgang vom 7705 benutzen!
  - bei olimex anfragen...


4 LCD-Graustufen mit PWM
  - alle 32 Timer-Ticks (alle 32 scanlines!)
  - funktioniert noch gut mit 1000Hz timer
  - flimmert bei ethernet traffic, also nur
    für's titelbild o.ä. verwenden.. 
    (schaade, keine antialias-fonts..)

persistente variablen mit ini-settings
  - für volume, etc..
  - pvar_register()    - register (or reload) variable
  - pvar_unregister()  - delete from ini file

-- acoustic management für IDE-Treiber..


BIOS BUGS
----------

YVESDE~1 MP3  7462912  02-08-01  02:41
MR~1     OIZ  <DIR> 
THEPRO~1      <DIR> 
CAL      MP3  5992704  06-05-00  00:07
MARUSHA  MP3  67130040  06-05-00  00:18    << -- einrückung


-- ich glaube, das BIOS markiert defekte sektoren in der fat
   nicht als defekt. --> großes problem bei alten festplatten!!!

-- bad sectors zu markieren ist aufgabe des BIOS!! (notfalls in
   format integriert!!)


- inet_addr() versteht nur "dotted quad" ip-adresse der Form a.b.c.d
  die anderen formate, wie 8.8.16, 8.24, und 32 werden mit syntax-error" quittiert.
- ftp funktioniert nich mit dem internet explorer (irgendwie ärgerlich!)
- ftp weigert sich dateien mit einem ~ im namen zu übertragen
- einlesen von großen verzeichnissen dauert ewigkeiten
  - fehler bei findfirst/findnext





