Skip to main content.

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

Availability:

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 CVS server 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 login on our public CVS server:

cvs -d :pserver:anonymous@www.denx.de:/cvsroot login

When prompted for the "CVS password:" just press the return key (empty password).

Please use the following commands to check out a copy of the MB8629x X11 Driver source code:

cvs -z6 -d :pserver:anonymous@www.denx.de:/cvsroot co -P x11_mb8629x

Building:

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 ""
             @date
             @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)
    

Installation:

Just copy two modules to the directory with X11 modules:

  1.  
    # cp programs/Xserver/hw/xfree86/drivers/mb86290/mb86290_drv.o 
    /usr/X11R6/lib/modules/drivers/
    
  2.  
    # 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"
    EndSection
    
  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"
    EndSubSection
    

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.