[PATCH 0/9] TI DMM-TILER driver

David Sin
2010-12-06T22:16:02Z

Tiling and Isometric Lightweight Engine for Rotation (TILER) driver
=====

Dynamic Memory Manager (DMM) is a hardware block made by Texas Instruments.
Within the DMM exists at least one TILER hardware component. Its purpose is to
organize video/image memory in a 2-dimensional fashion to limit memory
bandwidth and facilitate 0 effort rotation and mirroring. The TILER driver
facilitates allocating, freeing, as well as mapping 2D blocks (areas) in the
TILER container(s). It also facilitates rotating and mirroring the allocated
blocks or its rectangular subsections.

TERMINOLOGY

"slot"

The basic TILER driver operates on blocks of slots. A slot is the granularity
of the TILER hardware device. For all current uses it is 4K, but could also be
16 or 64K. The DMM-TILER TRM refers to this as "page" but we want to separate
this concept from the MMU pages.

"page"

The granularity of the MMU, used by the kernel. This is 4K.

"block"

The TILER hardware component supports 1D and 2D blocks. A 2D block is a
rectangular arrangement of slots with arbitrary width and height in a 2D
container. A 1D block is a linear arrangement of slots with arbitrary length
in a 1D container. This TILER driver only supports 2D blocks.

"container"

The TILER driver supports an arbitrary TILER container size. However, for
all current implementations it is 256 by 128 slots. The container currently can
only be used as a 2D container.

"reserved area"

Each block resides within a reserved area in the container. This area may
be larger than the actual set of slots that a block occupies. The reason for
this is to protect access from one block into another. Since TILER container is
mmap-ped into user space as individual pages, all slots that are spanned by
that page become visible to the user. The tiler driver allows restricting the
granularity of the reserved area (default alignment) as well as the mapped
area (granularity).

Technical Reference Manual
=====
http://focus.ti.com/pdfs/wtbu/OMAP4430_ES2.x_PUBLIC_TRM_vN.zip

Changes since RFC v2: https://lkml.org/lkml/2010/11/30/352
=====
Randy Dunlap:
1) Clarify the meaning of 2^n when referring to TILER alignment and
allocation granularity

Greg KH:
1) Move tiler.h to include/linux since it's not arch specific
2) Rename _tiler.h to tiler-geom.h (ick)
3) Use WARN_ON instead of BUG_ON
4) Export symbols as 'EXPORT_SYMBOL_GPL'
5) Remove comment from Kconfig file

Santosh Shilimkar:
1) Create separate DMM OMAP device file patch (#9)

Changes since RFC v1: http://www.spinics.net/lists/linux-omap/msg33867.html
=====
Santosh Shilimkar:
1) Correct documentation location
2) Remove ioremap of RAM
3) Implement probe function and hwmod
4) Correct commenting style
5) Reduce use of barrier instances

Linus Walleij:
1) Define TCM acryonym

Russell King:
1) Implement probe function
2) Fix spelling mistake
3) Remove GFP_ATOMIC flag when calling dma_alloc_coherent for PAT array mem
4) Replace alloc_page and flush range calls with dma_alloc_coherent

Nishanth Menon:
1) Address infinite while loop when reading dmm register

Benoit Cousson:
1) Fix source file headers
2) Correct logical errors in device file

Kevin Hilman:
1) Move DMM/TILER source code into driver/misc/tiler until a recommendation
is made as to where it should go

List of pending items in proposed order:

* Determine driver source code location
(Currently, resides in drivers/misc/tiler)
* Add area packing support (multiple blocks can reside in the same band/area)
to optimize area use
* Add group-ID support (to specify which blocks can reside together in the
same area)
* Add multiple search directions to TCM-SiTA
* Add 1D block support (including adding 1D search algo to TCM-SiTA)
* Optimize mutex handling (don.t hold mutex during memory
allocation/mapping/cache flushing)
* Add block reference counting, support for sharing blocks
* Move all kernel-API-s to tiler-iface.c
* Support orphaned block support (in preparation for process cleanup support)
* Change block identification from physical address to key-ID pair
(in preparation for user space support, and process security)
* Add support for process security (blocks from separate processes never
reside in the same band)
* Support file interface (ioctl and mmap)
* Support for buffers (ordered list of blocks that are mapped to userspace
together, such as YUV420sp)
* Support 1D user buffer mapping into TILER container
* Support for block pre-reservation (to further optimize area use)

David Sin (2):
TILER-DMM: DMM-PAT driver for TI TILER
TILER-DMM: Device support for OMAP

Lajos Molnar (6):
TILER-DMM: Container manager interface and utility definitons
TILER-DMM: TILER Memory Manager interface and implementation
TILER-DMM: TILER interface file and documentation
TILER-DMM: Geometry and view manipulation functions
TILER-DMM: Main TILER driver implementation
TILER-DMM: Linking TILER driver into the Linux kernel build

Ravi Ramachandra (1):
TILER-DMM: Sample TCM implementation: Simple TILER Allocator (SiTA)

Documentation/arm/OMAP/TILER | 126 ++++++++++
arch/arm/mach-omap2/Makefile | 2 +
arch/arm/mach-omap2/dmm-omap44xx.c | 80 ++++++
arch/arm/mach-omap2/include/mach/dmm.h | 92 +++++++
drivers/misc/Kconfig | 1 +
drivers/misc/Makefile | 1 +
drivers/misc/tiler/Kconfig | 72 ++++++
drivers/misc/tiler/Makefile | 7 +
drivers/misc/tiler/dmm-main.c | 187 ++++++++++++++
drivers/misc/tiler/tcm.h | 171 +++++++++++++
drivers/misc/tiler/tcm/Makefile | 1 +
drivers/misc/tiler/tcm/_tcm-sita.h | 61 +++++
drivers/misc/tiler/tcm/tcm-sita.c | 422 ++++++++++++++++++++++++++++++++
drivers/misc/tiler/tcm/tcm-sita.h | 28 ++
drivers/misc/tiler/tcm/tcm-utils.h | 51 ++++
drivers/misc/tiler/tiler-geom.c | 362 +++++++++++++++++++++++++++
drivers/misc/tiler/tiler-geom.h | 48 ++++
drivers/misc/tiler/tiler-iface.c | 66 +++++
drivers/misc/tiler/tiler-main.c | 405 ++++++++++++++++++++++++++++++
drivers/misc/tiler/tmm-pat.c | 266 ++++++++++++++++++++
drivers/misc/tiler/tmm.h | 103 ++++++++
include/linux/tiler.h | 173 +++++++++++++
22 files changed, 2725 insertions(+), 0 deletions(-)
create mode 100644 Documentation/arm/OMAP/TILER
create mode 100644 arch/arm/mach-omap2/dmm-omap44xx.c
create mode 100644 arch/arm/mach-omap2/include/mach/dmm.h
create mode 100644 drivers/misc/tiler/Kconfig
create mode 100644 drivers/misc/tiler/Makefile
create mode 100644 drivers/misc/tiler/dmm-main.c
create mode 100644 drivers/misc/tiler/tcm.h
create mode 100644 drivers/misc/tiler/tcm/Makefile
create mode 100644 drivers/misc/tiler/tcm/_tcm-sita.h
create mode 100644 drivers/misc/tiler/tcm/tcm-sita.c
create mode 100644 drivers/misc/tiler/tcm/tcm-sita.h
create mode 100644 drivers/misc/tiler/tcm/tcm-utils.h
create mode 100644 drivers/misc/tiler/tiler-geom.c
create mode 100644 drivers/misc/tiler/tiler-geom.h
create mode 100644 drivers/misc/tiler/tiler-iface.c
create mode 100644 drivers/misc/tiler/tiler-main.c
create mode 100644 drivers/misc/tiler/tmm-pat.c
create mode 100644 drivers/misc/tiler/tmm.h
create mode 100644 include/linux/tiler.h