armada - Man Page

Section "Device"
  Identifier "devname"
  Driver "armada"
  ...
EndSection

armada is an Xorg driver for Marvell Armada and Freescale iMX6 SoCs. This is kernel mode setting front end driver, with modular acceleration backends.  The following framebuffer depths are supported: 8, 15, 16, 24. All visual types are supported for depth 8, and TrueColor visual is supported for the other depths.  The driver has preliminary support for the Direct Rendering Infrastructure (DRI) version 2 and version 3. Multi-head configurations are supported.

Acceleration support is dependent on a separate acceleration module.  See the "Gpu Acceleration Modules" section below for additional information.

Support for video overlay is provided, supporting I420, YV12, I422, YUY2, UYVY, VYUY and YV16 formats, dependent on support from the kernel DRM driver.  The common I420 and YV12 formats are converted on the fly by this driver to I422 and YV16 for the hardware.  Support is also provided for video overlay using an XVBO format, which can be used to pass a DRM buffer handle to the video overlay backend.

The armada driver currently supports the Marvell Armada 510 LCD controller(s) and the Freescale iMX6 IPU.

armada communicates with the Linux Kernel Direct Rendering Manager (drm) layer to control and arbitrate access to the hardware.  Kernel drm support is required.

Other hardware which provides a Linux Kernel drm driver should also work with this driver.

Several GPU acceleration methods are supported by the DDX driver.  Each method is contained within its own module.  Details are listed below.

Two GPU acceleration modules are currently supported.

Please refer to xorg.conf(5) for general configuration details.  This section only covers configuration details specific to this driver.

For this driver it is not required to specify modes in the screen  section of the config file.  The armada driver will request video mode information from the Linux Kernel drm layer.

The VideoRAM option is ignored by this driver; video memory is managed by the Linux Kernel drm layer using system memory.

The following driver Options are supported:

Option "AccelModule" "filename"

Force the usage of an acceleration module.

Default: try the etnadrm_gpu drivers in turn, selecting the first which initialises.

Option "Hotplug" "boolean"

This option controls whether the driver automatically notifies when monitors are connected or disconnected.

Default: enabled.

Option "HWcursor" "boolean"

Enable or disable use of the hardware cursor.

Default: disabled.

Option "UseGPU" "boolean"

Enable or disable use of a GPU module for acceleration and textured XV support.

Default: enabled.

Option "XvAccel" "boolean"

Enable or disable the X Video backend.

Default: enabled.

Option "XvDisablePrimary" "boolean"

Allow the X Video backend to disable the primary plane when X Video image is displayed at full screen.

Note: Some kernel drivers may not fully support this (eg, the kernel driver does a full modeset when restoring the primary plane, causing the screen to momentarily blank.)  This option should be disabled for such kernel drivers, or the kernel driver updated to avoid such behaviour.

Default: enabled.

Option "XvPreferOverlay" "boolean"

Make the hardware overlay the first XV adapter.  Disabling this option makes any GPU provided textured overlay the first XV adapter.

Note: iMX hardware does not provide scaling for XV overlay, and this option should be disabled on such systems to prefer textured overlay instead.

Default: Overlay is preferred.

The following XV attributes are supported by the XV overlay video driver.

Textured overlay attributes are dependent on the GPU acceleration module.

The xf86-video-armada driver is a separately maintained driver, and bugs should be reported to the author.

Xorg(1), xorg.conf(5), xorgconfig(1), Xserver(1), X(7)

Authors include: Gerd Knorr, Michel Dänzer, Geert Uytterhoeven, Russell King.