Commit 6d6486a0 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab Committed by Jonathan Corbet
Browse files

docs: README.buddha: convert to ReST and add to m68k book 



Adjust the file for it to be properly parsed by Sphinx, adding
it to the index of the book it belongs.

Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent 76b5a6e8

Documentation/m68k/README.buddha→Documentation/m68k/buddha-driver.rst

+47 −48
Original line number Original line Diff line number Diff line 
=====================================

Amiga Buddha and Catweasel IDE Driver

=====================================





The Amiga Buddha and Catweasel IDE Driver (part of ide.c) was written by

The Amiga Buddha and Catweasel IDE Driver (part of ide.c) was written by

Geert Uytterhoeven based on the following specifications:

Geert Uytterhoeven based on the following specifications:
@@ -12,7 +15,7 @@ described in their manuals, no tricks have been used (for 
example leaving some address lines out of the equations...).

example leaving some address lines out of the equations...).

If you want to configure the board yourself (for example let

If you want to configure the board yourself (for example let

a  Linux  kernel  configure the card), look at the Commodore

a  Linux  kernel  configure the card), look at the Commodore

Docs.  Reading the nibbles should give this information:

Docs.  Reading the nibbles should give this information::





  Vendor number: 4626 ($1212)

  Vendor number: 4626 ($1212)

  product number: 0 (42 for Catweasel Z-II)

  product number: 0 (42 for Catweasel Z-II)
@@ -34,6 +37,7 @@ otherwise your chance is only 1:16 to find the board :-). 




The local memory-map is even active when mapped to $e8:

The local memory-map is even active when mapped to $e8:





==============  ===========================================

$0-$7e		Autokonfig-space, see Z-II docs.

$0-$7e		Autokonfig-space, see Z-II docs.





$80-$7fd	reserved

$80-$7fd	reserved
@@ -94,6 +98,7 @@ $1000-$ffff Buddha-Rom with offset $1000 in the rom 
		chip. The addresses $0 to $fff of the rom

		chip. The addresses $0 to $fff of the rom

		chip cannot be read. Rom is Byte-wide and

		chip cannot be read. Rom is Byte-wide and

		mapped to even addresses.

		mapped to even addresses.

==============  ===========================================





The  IDE ports issue an INT2.  You can read the level of the

The  IDE ports issue an INT2.  You can read the level of the

IRQ-lines  of  the  IDE-ports by reading from the three (two

IRQ-lines  of  the  IDE-ports by reading from the three (two
@@ -128,6 +133,7 @@ must always be set to 1 to be compatible with later Buddha 
versions  (if  I'll  ever  update this one).  I presume that

versions  (if  I'll  ever  update this one).  I presume that

I'll  never use the lower four bits, but they have to be set

I'll  never use the lower four bits, but they have to be set

to 1 by definition.

to 1 by definition.



The  values in this table have to be shifted 5 bits to the

The  values in this table have to be shifted 5 bits to the

left and or'd with $1f (this sets the lower 5 bits).

left and or'd with $1f (this sets the lower 5 bits).
@@ -138,37 +144,29 @@ values are no multiple of 71. One clock-cycle is 71ns long 
(exactly 70,5 at 14,18 Mhz on PAL systems).

(exactly 70,5 at 14,18 Mhz on PAL systems).





value 0 (Default after reset)

value 0 (Default after reset)



  497ns Select (7 clock cycles) , IOR/IOW after 172ns (2 clock cycles)

  497ns Select (7 clock cycles) , IOR/IOW after 172ns (2 clock cycles)

  (same timing as the Amiga 1200 does on it's IDE port without

  (same timing as the Amiga 1200 does on it's IDE port without

  accelerator card)

  accelerator card)





value 1

value 1



  639ns Select (9 clock cycles), IOR/IOW after 243ns (3 clock cycles)

  639ns Select (9 clock cycles), IOR/IOW after 243ns (3 clock cycles)





value 2

value 2



  781ns Select (11 clock cycles), IOR/IOW after 314ns (4 clock cycles)

  781ns Select (11 clock cycles), IOR/IOW after 314ns (4 clock cycles)





value 3

value 3



  355ns Select (5 clock cycles), IOR/IOW after 101ns (1 clock cycle)

  355ns Select (5 clock cycles), IOR/IOW after 101ns (1 clock cycle)





value 4

value 4



  355ns Select (5 clock cycles), IOR/IOW after 172ns (2 clock cycles)

  355ns Select (5 clock cycles), IOR/IOW after 172ns (2 clock cycles)





value 5

value 5



  355ns Select (5 clock cycles), IOR/IOW after 243ns (3 clock cycles)

  355ns Select (5 clock cycles), IOR/IOW after 243ns (3 clock cycles)





value 6

value 6



  1065ns Select (15 clock cycles), IOR/IOW after 314ns (4 clock cycles)

  1065ns Select (15 clock cycles), IOR/IOW after 314ns (4 clock cycles)





value 7

value 7



  355ns Select, (5 clock cycles), IOR/IOW after 101ns (1 clock cycle)

  355ns Select, (5 clock cycles), IOR/IOW after 101ns (1 clock cycle)





When accessing IDE registers with A6=1 (for example $84x),

When accessing IDE registers with A6=1 (for example $84x),
@@ -205,6 +203,7 @@ the third IDE port are going into data's Nirwana on the 
Buddha.

Buddha.





Jens Schönfeld february 19th, 1997

Jens Schönfeld february 19th, 1997



updated may 27th, 1997

updated may 27th, 1997

			     eMail: sysop@nostlgic.tng.oche.de





eMail: sysop@nostlgic.tng.oche.de

Documentation/m68k/index.rst

+1 −0
Original line number Original line Diff line number Diff line
@@ -8,6 +8,7 @@ m68k Architecture 
   :maxdepth: 2

   :maxdepth: 2





   kernel-options

   kernel-options

   buddha-driver





.. only::  subproject and html

.. only::  subproject and html