devg-carmine.so

Graphics driver for Fujitsu Carmine chipsets

Syntax:

io-graphics -d carmine vid=[0x]vendor_id,did=[0x]device_id
            [option[,option...]] ... &

Runs on:

SH, x86

Options:

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

Options specific to this driver:

mode_opts=config-file

The full path to the configuration file for the driver. The sample file is /usr/photon/config/carmine.conf.

Description:

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

---

This driver is installed with the Advanced Graphics TDK. See the Advanced Graphics TDK documentation for updated information about this driver.

---

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 mode_opts option of io-graphics to specify its location. For example, mode_opts=/usr/photon/config/carmine.conf.

Supported chipsets

• Fujitsu MB86297 Carmine

2D Acceleration features

Other features

Resolution and refresh support

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.

See also:

crttrap, devgt-iographics, io-graphics

/usr/photon/config/carmine.conf