lisa/android_kernel_xiaomi_sm8350
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

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

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
Mauro Carvalho Chehab 2019-07-26 09:51:22 -03:00 committed by Jonathan Corbet
parent 76b5a6e842
commit 6d6486a0c5
2 changed files with 48 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
Documentation/m68k/README.buddha → Documentation/m68k/buddha-driver.rst
View File

@ -1,3 +1,6 @@
=====================================
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
eMail: sysop@nostlgic.tng.oche.de
updated may 27th, 1997
eMail: sysop@nostlgic.tng.oche.de

1
Documentation/m68k/index.rst
View File

@ -8,6 +8,7 @@ m68k Architecture
:maxdepth: 2 :maxdepth: 2
kernel-options kernel-options
buddha-driver
.. only:: subproject and html .. only:: subproject and html