[linux-2.6-block.git] / Documentation / SM501.txt

.. include:: <isonum.txt>

============
SM501 Driver
============

:Copyright: |copy| 2006, 2007 Simtec Electronics

The Silicon Motion SM501 multimedia companion chip is a multifunction device
which may provide numerous interfaces including USB host controller USB gadget,
asynchronous serial ports, audio functions, and a dual display video interface.
The device may be connected by PCI or local bus with varying functions enabled.

Core
----

The core driver in drivers/mfd provides common services for the
drivers which manage the specific hardware blocks. These services
include locking for common registers, clock control and resource
management.

The core registers drivers for both PCI and generic bus based
chips via the platform device and driver system.

On detection of a device, the core initialises the chip (which may
be specified by the platform data) and then exports the selected
peripheral set as platform devices for the specific drivers.

The core re-uses the platform device system as the platform device
system provides enough features to support the drivers without the
need to create a new bus-type and the associated code to go with it.


Resources
---------

Each peripheral has a view of the device which is implicitly narrowed to
the specific set of resources that peripheral requires in order to
function correctly.

The centralised memory allocation allows the driver to ensure that the
maximum possible resource allocation can be made to the video subsystem
as this is by-far the most resource-sensitive of the on-chip functions.

The primary issue with memory allocation is that of moving the video
buffers once a display mode is chosen. Indeed when a video mode change
occurs the memory footprint of the video subsystem changes.

Since video memory is difficult to move without changing the display
(unless sufficient contiguous memory can be provided for the old and new
modes simultaneously) the video driver fully utilises the memory area
given to it by aligning fb0 to the start of the area and fb1 to the end
of it. Any memory left over in the middle is used for the acceleration
functions, which are transient and thus their location is less critical
as it can be moved.


Configuration
-------------

The platform device driver uses a set of platform data to pass
configurations through to the core and the subsidiary drivers
so that there can be support for more than one system carrying
an SM501 built into a single kernel image.

The PCI driver assumes that the PCI card behaves as per the Silicon
Motion reference design.

There is an errata (AB-5) affecting the selection of the
of the M1XCLK and M1CLK frequencies. These two clocks
must be sourced from the same PLL, although they can then
be divided down individually. If this is not set, then SM501 may
lock and hang the whole system. The driver will refuse to
attach if the PLL selection is different.
Commit	Line	Data
d1bb1d04	1	.. include:: <isonum.txt>
ffd65af0	2
d1bb1d04 MCC	3	============
	4	SM501 Driver
	5	============
	6
	7	:Copyright: \|copy\| 2006, 2007 Simtec Electronics
ffd65af0	8
f0ae5669 RL	9	The Silicon Motion SM501 multimedia companion chip is a multifunction device
f0ae5669 RL	10	which may provide numerous interfaces including USB host controller USB gadget,
19f59460	11	asynchronous serial ports, audio functions, and a dual display video interface.
f0ae5669 RL	12	The device may be connected by PCI or local bus with varying functions enabled.
f0ae5669 RL	13
ffd65af0 BD	14	Core
	15	----
	16
	17	The core driver in drivers/mfd provides common services for the
	18	drivers which manage the specific hardware blocks. These services
	19	include locking for common registers, clock control and resource
	20	management.
	21
	22	The core registers drivers for both PCI and generic bus based
	23	chips via the platform device and driver system.
	24
	25	On detection of a device, the core initialises the chip (which may
	26	be specified by the platform data) and then exports the selected
	27	peripheral set as platform devices for the specific drivers.
	28
	29	The core re-uses the platform device system as the platform device
	30	system provides enough features to support the drivers without the
	31	need to create a new bus-type and the associated code to go with it.
	32
	33
	34	Resources
	35	---------
	36
	37	Each peripheral has a view of the device which is implicitly narrowed to
	38	the specific set of resources that peripheral requires in order to
	39	function correctly.
	40
	41	The centralised memory allocation allows the driver to ensure that the
	42	maximum possible resource allocation can be made to the video subsystem
	43	as this is by-far the most resource-sensitive of the on-chip functions.
	44
	45	The primary issue with memory allocation is that of moving the video
	46	buffers once a display mode is chosen. Indeed when a video mode change
	47	occurs the memory footprint of the video subsystem changes.
	48
	49	Since video memory is difficult to move without changing the display
	50	(unless sufficient contiguous memory can be provided for the old and new
	51	modes simultaneously) the video driver fully utilises the memory area
	52	given to it by aligning fb0 to the start of the area and fb1 to the end
	53	of it. Any memory left over in the middle is used for the acceleration
	54	functions, which are transient and thus their location is less critical
	55	as it can be moved.
	56
	57
	58	Configuration
	59	-------------
	60
	61	The platform device driver uses a set of platform data to pass
	62	configurations through to the core and the subsidiary drivers
	63	so that there can be support for more than one system carrying
	64	an SM501 built into a single kernel image.
	65
	66	The PCI driver assumes that the PCI card behaves as per the Silicon
	67	Motion reference design.
	68
	69	There is an errata (AB-5) affecting the selection of the
	70	of the M1XCLK and M1CLK frequencies. These two clocks
	71	must be sourced from the same PLL, although they can then
	72	be divided down individually. If this is not set, then SM501 may
	73	lock and hang the whole system. The driver will refuse to
	74	attach if the PLL selection is different.