= Introduction

This is graphics driver for the Qualcomm MSM7xxx and QSD8x50x processors.

= Building

== Dependencies

You will need the following X development dependencies installed on your
development system before building this package:

xorg-server > 1.4, xproto, fontsproto, renderproto

== Configuration

Type ./autogen.sh at the command line to automatically generate the
confguration system.

If you need to change some parameters to the configure  script (such as
prefix paths), you can re-run configure again after the autogen.sh
script has completed.  Make sure that you specify the correct host and
build targets for your cross compiler.  Here is an example:

./configure --build=x86_64-linux --host=arm-linux-gnueabi --target=arm-linux-gnueabi --prefix=/usr/local/qcomle/arm/arm-linux-gnueabi/

This will configure the system to use the 'arm-linux-gnueabi-gcc' compiler.

== Building

After the driver has been configured, it can be built by typing 'make' at
the command line.

= Using the driver

After building, the driver is located at
src/.libs/msm_drv.so

This can be copied diretly to your target.  All X video drivers are located
in 'usr/lib/xorg/modules/drivers' on target.  Copy the .so there.

To use the driver, you need to configure it in /etc/X11/xorg.conf.
Add the  following section to your xorg.conf file:

Section "Device"
   Identifier    "MSM"
   Driver        "msm"
   Option        "fb"    "/dev/fb0"
#  Option       "NoAccel" "true"
#  Option       "SWBlit"  "true"
EndSection

To change which framebuffer device you want to use, modify the "fb"
option to point at the device file you want to run on.

To disable accelerations, set the "NoAccel" option to true.
To use software blits only in EXA (no MSMFB_BLIT), then set the "SWBlit"
option to "true".  Note that software blits may be used regardless of
the value of the option.

Next, you need to add the "MSM" device to the screen:

Section "Screen"
  ...
  Device        "MSM"
EndSection

You do not need to configure a monitor or a mode size -the mode size is
determined automatically and cannot be changed.

Finally, restart X.  In the log you should see the following:

(II) msm: Driver for Qualcomm MSM processors: MSM7201, MSM7X25

That indicates that the msm driver has been loaded.
