Skip to main content.

Download, Build, Install, and Configure the MB8629x X11 Drivers


This document was written by Nick Ivanter (nick {at} emcraft {dot} com).


The MB8629x X11 Drivers are available as Free Software under GPL.

You can either download and run the binary modules from the DENX FTP server, or you can download the full source tree from the DENX git repository and rebuild everything from scratch.

#Hardware Setup

Hardware Setup

For correct operation of the Coral-P card with the Linux X11 drivers the jumpers on the card must be set as documented in Installing a Coral-P PCI Evaluation Board.

Quick Installation:

  1. Download the following files from the DENX FTP server:
  2. Install the files on a Debian GNU/Linux system as follows:
    # cp mb86290_drv.o /usr/X11R6/lib/modules/drivers/
    # cp libmb86290_fb.a /usr/X11R6/lib/modules/
    # cp XF86Config-4 /etc/X11/
    # cp zvideo /usr/local/bin/
    # chmod 0755 /usr/local/bin/zvideo

Source Download:

Please use the following command to clone the git repository of the MB8629x X11 Driver source code:

git-clone git://


To build the drivers you must have the XFree86 sources. The procedures of getting and unpacking these can vary dependent on the type of OS which you are running. If you use Debian Linux you can perform the following steps to get and unpack the XFree86 sources:

  1. (as "root") Make sure your package database is up to date:
    # apt-get update
  2. (as normal user) Go to your chosen build directory:
    $ cd Coral-P
  3. Get XFree86 sources:
    $ apt-get source xserver-xfree86
  4. Go to the directory where the package sources has been downloaded; the name of this directory depends on the version of XFree86, for example:
    $ cd xfree86-4.3.0.dfsg.1
  5. Create the build tree (unpack the package):
    $ debian/rules setup
    The directory 'build-tree' will be created and the package will be unpacked in it.
  6. Go to 'build-tree' directory and copy the contents of the 'x11_mb8629x' CVS tree on top of the 'xc' directory in the Debian XFree86 build tree.
  7. Go to the 'xc' directory in the build tree.
  8. Set the KERNELSRC variable of programs/Xserver/hw/xfree86/drivers/mb86290/Imakefile to point to actual location of the MPC5200 Linux kernel sources.
  9. Comment out the line '$(MAKE_CMD) $(MFLAGS) $(WORLDOPTS) World' in the top-level Makefile in the 'xc' directory. The line is located near the end of the 'World' in the following context:
             $(MAKE_CMD) $(MFLAGS) Makefiles
             $(MAKE_CMD) $(MFLAGS) BOOTSTRAPSUBDIRS= clean
             $(MAKE_CMD) $(MFLAGS) includes
             $(MAKE_CMD) $(MFLAGS) depend
    #       $(MAKE_CMD) $(MFLAGS) $(WORLDOPTS) World
             @echo ""
             @echo ""
             @$(RM) $(VERSPROG)
             @$(CC) $(VERSINC) -o $(VERSPROG) $(VERSSRC)
             @echo Full build of XFree86`$(VERSPROG)` complete.
             @$(RM) $(VERSPROG)
             @echo ""
  10. Finally, to build the driver, execute the following commands:
    make World
    (cd config/util; make)
    (cd programs/Xserver/hw/xfree86/drivers/mb86290; make)
    (cd programs/Xserver/mb86290_fb; make)


Just copy two modules to the directory with X11 modules:

    # cp programs/Xserver/hw/xfree86/drivers/mb86290/mb86290_drv.o 
    # cp programs/Xserver/mb86290_fb/libmb86290_fb.a /usr/X11R6/lib/modules/

Configuring Xserver:

Now you have to edit the /etc/X11/XF86Config-4 file as follows:

  1. Add a new device section, something like:
    Section "Device"
            Identifier  "MB86290 card"
            Driver      "mb86290"
            Option      "Accel" "true"
  2. Modify the screen section; the device string has to look like this:
    Device "MB86290 card"
    If there are 'DefaultDepth' or 'DefaultFbBpp' options - delete them.

    There must be only one display subsection, and it has to look like this:
    SubSection "Display"
               Depth   15
               Modes   "1024x768"

Video Application:

If you followed the instructions above to build the X11 driver, you can proceed to build the demo video application as follows:

$ cd xfree86-4.3.0.dfsg.1/build-tree/zvideo
$ make
# cp zvideo /usr/local/bin/

There are some known limitations of the video capture software which you need to be aware of:

These limitations are actually due to limitations of the MB86295 hardware. We don't believe that they can be overcome in software.