This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

`devg-carmine.so`

Graphics driver for Fujitsu Carmine chipsets

Syntax:

io-display [-vf]
           -d vid=[0x]vendor_id,did=[0x]device_id[,deviceindex=index]
           [-c config_file] [-p priority]

Options:

For the general io-display options that you can use with this driver, see io-display.

You can set configuration options that are specific to this driver by using the modeopts setting in display.conf:

modeopts=config-file: The full path to the configuration file for the driver. For example, carmine.conf is located in /usr/photon/config so that modeopts=/usr/photon/config/carmine.conf.

Description:

The devg-carmine.so driver provides accelerated 2D and 3D support for the Fujitsu Carmine graphics controller.

You can edit the configuration file to enable devg-carmine.so to run on your board. Follow the editing instructions in the sample file, /usr/photon/config/carmine.conf, to specify the correct configuration for the required display mode. (For a more detailed explanation of the display settings, see the appropriate Fujitsu documentation.)

If you use a configuration file for this driver, you must use the modeopts setting in your display.conf configuration file to specify its location.

Supported chipsets

Fujitsu MB86297 Carmine

2D Acceleration features

Feature	Provision
Solid fills	Yes
Bresenham lines	Yes
Pattern fills	No
Polygons	Yes
Onscreen blitting	Yes
Offscreen blitting	Yes
Chroma-keyed blitting	Yes
Alpha blending	Yes
Raster OP's	16
Bitmaps	Yes

Other features

Feature	Provision
Hardware Cursor	Yes
TV Out	No
Video capture	Yes
DPMS (power saving)	Yes
Layers supported	8

Resolution and refresh support

Display size (pixels):	Refresh rate (Hz):	Color depth (bits per pixel):
640x480	60	15, 32
800x600	60	15, 32
1024x768	60	15, 32

Restrictions:

You can use the configuration file to specify other resolutions and refresh rates.

The `carmine.conf` file

The carmine.conf file provides additional control over the driver, including dual-head support. This file is also required for providing additional configuration for panel displays. The file (by default located in /usr/photon/config/) contains a description of each option, and several preconfigured command lines for various Carmine device and display combinations.

The Carmine chipset supports two display controllers. In carmine.conf, display-related settings may be specified independently for each display controller.

Additionally, you can use the configuration file to configure:

memory controller initialization sequence
layer per-pixel blending mode: inline alpha vs. separate alpha layers
LVDS reset sequence, using the output of the GV pin

See the comments in the sample configuration file for more details.

Alpha layer support

The alpha layers work in one of two modes on the Carmine:

In the default mode, there is a single layer supporting per-pixel alpha (compared to four alpha layers in the second mode). The alpha values are inlined with the RGB values in this mode, as opposed to being on a separate alpha layer. However, this inline alpha mode is supported only on one layer, which is GF layer index 2. This mode provides flexibility: you can, for example, use the alpha values generated by OpenGL ES to do some interesting effects.
In the second mode, there are 4 special-purpose alpha layers, which are in addition to the 8 color layers.
In the GF API, the gf_alpha_t alpha map is configured for blending with an RGB layer as follows:
```
gf_alpha_t alpha;

memset(&alpha, 0, sizeof(alpha));
alpha.mode = GF_ALPHA_M1_MAP | GF_BLEND_SRC_M1 |
             GF_BLEND_DST_1mM1;
alpha.map = asurf;

gf_layer_set_blending(fglayer, &alpha);
```
In the above example, the driver internally picks one of the four alpha layers (if there is still one available) and uses it.

The two modes of alpha layer operation are mutually exclusive, and must be selected via the carmine.conf configuration file. The mode of operation can't be changed at runtime. By default, the inline alpha mode is used. To use the other mode, specify this option in the configuration file:

alphamap=1

Files:

This driver needs the following at run time:

libffb.so: Software rasterization library.