Manual Pages for UNIX Operating System command usage for man siliconmotion

Device and Network Interfaces                    siliconmotion(7)



NAME
     siliconmotion - Silicon Motion video driver

SYNOPSIS
     Section "Device"
       Identifier "devname"
       Driver "siliconmotion"
       ...
       [ Option "optionname" ["optionvalue"]]
     EndSection

DESCRIPTION
     siliconmotion is an Xorg driver  for  Silicon  Motion  based
     video  cards.  The driver is fully accelerated, and provides
     support for the following framebuffer depths:   8,  16,  and
     24.   All  visual  types  are  supported  for  depth  8, and
     TrueColor visuals are supported for the other depths.

SUPPORTED HARDWARE
     The siliconmotion driver supports PCI and  AGP  video  cards
     based on the following Silicon Motion chips:

     Lynx        SM910

     LynxE       SM810

     Lynx3D      SM820

     LynxEM      SM710

     LynxEM+     SM712

     Lynx3DM     SM720

     Cougar3DR   SM731

     MSOC        SM501,SM502

CONFIGURATION DETAILS
     Please  refer  to  xorg.conf(4)  for  general  configuration
     details.   This  section  only  covers configuration details
     specific to this driver.  All options  names  are  case  and
     white space insensitive when parsed by the server, for exam-
     ple,  "lynxe" and "LynxE" are equivalent.

     Multihead mode configuration is done  through  the  RandR1.2
     interface (see xorg.conf(4) and xrandr(1) for further infor-
     mation). Hardware accelerated  screen  rotation  and  frame-
     buffer resizing are only supported with the EXA acceleration
     architecture (see the AccelMethod option below).





X Version 11Last change: xf86-video-siliconmotion 1.7.4          1






Device and Network Interfaces                    siliconmotion(7)



     The driver auto-detects the chipset type, but the  following
     ChipSet names may optionally be specified in the config file
     "Device" section, and will override the auto-detection:

         "lynx",   "lynxe",   "lynx3d",   "lynxem",    "lynxem+",
         "lynx3dm", "cougar3dr", "msoc".


     The following Cursor Options are supported:

     Option "HWCursor" "boolean"
          Enable or disable the HW cursor.  Default: on.

     Option "SWCursor" "boolean"
          Inverse of "HWCursor".  Default: off.


     The following display Options are supported:

     Option "VideoKey" "integer"
          Set the video color key.  Default: a  little  off  full
          blue.

     Option "ByteSwap" "boolean"
          Turn on byte swapping  for  capturing  using  SMI  demo
          board.  Default: off.

     Option "Interlaced" "boolean"
          Turn on interlaced video capturing.  Default: off.

     Option "UseBIOS" "boolean"
          Use the BIOS to set the modes. This is used for  custom
          panel  timings.  Default: off for SM72x and SM5xx, oth-
          erwise on.

     Option "Dualhead" "boolean"
          Enable dualhead mode.  Currently not all chips are sup-
          ported and hardware video overlay (XV) support may have
          some limitations.  Default: off.

     Option "PanelSize" "widthxheight"
          Override LCD panel dimension autodetection.

     Option "UseFBDev" "boolean"
          Don't actually program the hardware mode registers, but
          leave it as set by the operating system. Only available
          on MSOC chips. Default: off.

     Option "CSCVideo" "boolean"
          CSC video uses color space conversion to  render  video
          directly  to the framebuffer, without using an overlay.
          Only available on MSOC chips. Default: on.



X Version 11Last change: xf86-video-siliconmotion 1.7.4          2






Device and Network Interfaces                    siliconmotion(7)



     The following video memory Options are supported:

     Option "mclk" "integer"
          Sets the memory clock. You must specify the units.  For
          example  50Mhz  is  the same as 50000Khz or 50000000Hz.
          On MSOC chips this is the main  clock  source  for  all
          functional  blocks,  such as the 2D engine, GPIO, Video
          Engine, and DMA Engine. This option is  only  used  for
          debugging  purposes  on MSOC chips.  Default: probe the
          memory clock value, and use it at server start.

     Option "mxclk" "integer"
          Sets the memory clock. You must specify the units.  For
          example  50Mhz  is  the same as 50000Khz or 50000000Hz.
          Clock source  for  the  local  SDRAM  controller.  This
          option  is  only  available on MSOC chips and used only
          for debugging  purposes.   Default:  probe  the  memory
          clock value, and use it at server start.

     The following acceleration and graphics engine  Options  are
     supported:

     Option "NoAccel"
          Disable acceleration.  Very useful for  determining  if
          the  driver  has problems with drawing and acceleration
          routines.  This is the first  option  to  try  if  your
          server  runs  but  you  see  graphic  corruption on the
          screen.  Using it decreases  performance,  as  it  uses
          software  emulation  for  drawing  operations the video
          driver  can   accelerate   with   hardware.    Default:
          acceleration is enabled.

     Option "AccelMethod" "string"
          Chooses between available  acceleration  architectures.
          Valid  options  are XAA and EXA. XAA is the traditional
          acceleration architecture and support for  it  is  very
          stable.   EXA is a newer acceleration architecture with
          better performance for the Render and Composite  exten-
          sions,  but the rendering code for it is newer and pos-
          sibly unstable.  The default is XAA.


     The following PCI bus Options are supported:

     Option "PciBurst" "boolean"
          will enable PCI burst mode. This should work on all but
          a  few  broken  PCI chipsets, and will increase perfor-
          mance.  Default: on.

     Option "PciRetry" "boolean"
          will allow the driver to rely on PCI Retry  to  program
          the  registers.   PciBurst  must be enabled for this to



X Version 11Last change: xf86-video-siliconmotion 1.7.4          3






Device and Network Interfaces                    siliconmotion(7)



          work. This will increase  performance,  especially  for
          small  fills/blits, because the driver does not have to
          poll the card before sending it commands to  make  sure
          it  is  ready.  It should work on most recent PCI chip-
          sets.  Default: value of PciBurst option.


SEE ALSO
     Xorg(1), xorg.conf(4), Xserver(1), X(5)


SUPPORT
     For assistance with this driver, or Xorg in  general,  check
     the  web  site  at http://www.x.org/.  If you find a problem
     with Xorg or have a question not answered in the FAQ  please
     use  our  bug  report form available on the web site or send
     mail to xorg@lists.freedesktop.org.  When reporting problems
     with  the  driver send as much detail as possible, including
     chipset type, a server  output  log,  and  operating  system
     specifics.


AUTHORS
     Kevin Brosius, Matt Grossman, Harald Koenig, Sebastien  Mar-
     ineau, Mark Vojkovich, Frido Garritsen, Corvin Zahn.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     _______________________________________________________________________________
    |       ATTRIBUTE TYPE        |                 ATTRIBUTE VALUE                |
    |_____________________________|________________________________________________|
    | Availability                | x11/server/xorg/driver/xorg-video-siliconmotion|
    |_____________________________|________________________________________________|
    | Interface Stability         | Volatile                                       |
    |_____________________________|________________________________________________|

















X Version 11Last change: xf86-video-siliconmotion 1.7.4          4