minix/drivers/storage/mmc/README.txt

   1 This directory contains code to access MMC based devices.
   2
   3 It was created during the initial port of MINIX to the ARM platform. mmbclk
   4 implements a normal MINIX block device. It uses the interfaces defined in
   5 mmchost.h to perform it's operations.
   6
   7 mmchost_mmchs is the MMC host controller driver for the TI omap device range.
   8 It contains the logic to access SD cards on that device.
   9
  10  drivers/mmc
  11  |-- Makefile        (The makefile)
  12  |-- mmclog.h        (A simpel logging system)
  13  |-- omap_mmc.h      (TI Omap register definitions)
  14  |-- sdhcreg.h       (BSD headers for the MMC layer)
  15  |-- sdmmcreg.h      (BSD headers for the MMC layer)
  16  |-- mmcblk.c        (MINIX 3 block device)
  17  |-- mmchost.h       (interface between the block device and the MMC layer)
  18  |-- mmchost_mmchs.c (Driver to use on the ARM port/beagle)
  19  '-- README.txt      (This file)
  20
  21
  22 Future work:
  23 ============
  24
  25 * Creating a more generic MMC layer
  26 The SD protocol is well defined and the imported the netbsd sdhcreg and
  27 sdmmcreg headers will allow us to make the MMC interface more generic. We would
  28 like  mmchost_mmchs to be split in a generic part and a specific part.
  29
  30 * 8 bits access
  31 The driver currently only reads data over 1 or 4 bits address lines. Adding support
  32 for 4 or 8 bits(for movinands) mode is very welcome.
  33
  34 * DMA.
  35 The OMAP driver allows the usage of DMA. Adding DMA support will increase the
  36 performance of the driver
  37
  38 * Removal of the PRIVCTL call.
  39 The MMC driver uses memory mapped IO to perform it's operations. On i386 it is
  40 the pci driver that will grant access to certain piece of memory to a driver.
  41 On the ARM port we lack pci and other self describing busses. In the current
  42 driver the driver will itself grant itself access to the correct piece of
  43 memory but this is unwanted behavior.  We currently as thinking about two
  44 possible solutions. The first would be to add the memory ranges in system.conf.
  45 The second would be to modify the PCI driver to grant access to memory based on
  46 a fixed configuration. For example we could use the driver tree to perform
  47 device discovery and granting access to devices.
  48
  49
  50 * TODO removal
  51 The driver contains (quite a few) TODO's where the code need to be improved.