Home | History | Annotate | Line # | Download | only in dist
README revision 1.1.1.4
      1 OpenChrome Version 0.5 Release Note (July 6th, 2016)
      2 ----------------------------------------------------
      3 
      4 OpenChrome is an open source implementation of X.Org Server 
      5 DDX (Device Dependent X) graphics device driver for VIA Technologies 
      6 UniChrome and Chrome9 IGPs. (Integrated Graphics Processor)
      7 Please note that OpenChrome does not support VIA Technologies IGPs 
      8 that are related to Trident Microsystems (i.e., Apollo MVP4, PLE133, 
      9 and KLE133) or S3 Graphics (i.e., KM266). Here is the project home 
     10 page for OpenChrome.
     11 
     12 http://www.freedesktop.org/wiki/Openchrome/
     13 
     14 Please note that VIA Technologies does not support OpenChrome in any way.
     15 
     16 
     17 
     18 Supported Chipsets
     19 ------------------
     20 
     21 - CLE266
     22 - KM400 / KM400A / KN400 / P4M800
     23 - K8M800 / K8N800
     24 - PM800 / PN800 / PM880 / CN333 / CN400
     25 - P4M800 Pro / VN800 / CN700
     26 - CX700 / VX700
     27 - P4M890 / VN890 / CN800
     28 - K8M890 / K8N890
     29 - P4M900 / VN896 / CN896
     30 - VX800 / VX820
     31 - VX855 / VX875
     32 - VX900
     33 
     34 
     35 
     36 Supported Features
     37 ------------------
     38 
     39 - VGA
     40 - DVI from an integrated TMDS transmitter (CX700, VX700, and 
     41   VX900 chipsets)
     42 - DVI from VIA Technologies VT1632A TMDS transmitter
     43 - LVDS flat panel (i.e., laptop LCD flat panel)
     44 - EXA acceleration (RENDER acceleration)
     45 - Xv and XvMC
     46 - Multiple display output (i.e., RandR)
     47 
     48 
     49 
     50 Unproven Features
     51 -----------------
     52 
     53 - Standby (ACPI S1 and S3 State) resume
     54 - TV out
     55 - KMS support (Kernel Mode Setting; requires the use of VIA 
     56   Technologies IGP DRM module supporting KMS. See "Where to Obtain 
     57   OpenChrome Source Code" chapter for more details.)
     58 
     59 
     60 
     61 Unimplemented Features
     62 ----------------------
     63 
     64 - Hardware cursor support for CLE266, KM400, KM400A, KN400, and 
     65   P4M800 chipsets
     66 - DVI via Silicon Image SiI 164 TMDS transmitter or Chrontel TMDS 
     67   transmitter
     68 - LVDS via VT1631 / VT1636 LVDS transmitter
     69 - External HDMI transmitter (i.e., Jetway J7F5M-VHE-LF motherboard, 
     70   VIA Embedded EPIA-P720 motherboard, etc.)
     71 - DisplayPort and HDMI support for VX900 chipset (Might work with 
     72   the experimental DRM module that supports KMS. See "Where to Obtain 
     73   OpenChrome Source Code" chapter for more details.)
     74 
     75 
     76 
     77 OS Support
     78 ----------
     79 
     80 - X.Org Server Version 1.7 or later
     81   (It might not work correctly if it is compiled against an older 
     82   X.Org Server.)
     83 - Linux Version 2.6.32 or later
     84   (Note: For Linux Version 4.5 or later, you may have to blacklist 
     85   vesafb. This is a bug that has not been fixed so far.)
     86 
     87 
     88 
     89 What's New for OpenChrome Version 0.5
     90 -------------------------------------
     91 
     92 Based on OpenChrome Version 0.4.0 code, OpenChrome Version 0.5 fixes 
     93 several bugs while adding two new features. 
     94 
     95 - Major code cleanup
     96 - Removal of more manual options (BusWidth, ForcePanel, and AccelMethod)
     97 - Fix for runtime screen resolution change X.Org Server crash bug
     98 - Fix for CLE266 chipset not being able to function correctly if 
     99   "CRT + TV" option was chosen in BIOS setup
    100 - Initial support for VIA Technologies VT1632A TMDS transmitter for DVI
    101 - Initial support for multiple display output (i.e., RandR)
    102 
    103 
    104 
    105 How to Contact OpenChrome Developers
    106 ------------------------------------
    107 
    108 Please visit these OpenChrome mailing lists.
    109 
    110 http://lists.freedesktop.org/mailman/listinfo/openchrome-users
    111 http://lists.freedesktop.org/mailman/listinfo/openchrome-devel
    112 
    113 openchrome-users mailing list is meant for non-technical users asking 
    114 questions about how to use OpenChrome, etc. openchrome-devel mailing 
    115 list is for discussing OpenChrome development issues.
    116 
    117 
    118 
    119 Support for Older Versions
    120 --------------------------
    121 
    122 As a general rule, the older version OpenChrome will not be supported 
    123 once a new version is out. It is sometimes useful to try out the 
    124 older version, in order to see if a regression has occurred, but 
    125 generally speaking, there will be no fixes for the older versions.
    126 OpenChrome is written so that it can be compiled against X.Org Server 
    127 Version 1.7 or later and Linux Version 2.6.32 or later. We will likely 
    128 maintain this minimum platform requirement for the foreseeable future. 
    129 What this means is that if the user wanted to try the latest OpenChrome, 
    130 it can do so with an OS that was released around Year 2010. OpenChrome 
    131 might still compile for anything older than that, but it might not be 
    132 stable enough to be useful.
    133 
    134 
    135 
    136 Where to File a Bug Report
    137 --------------------------
    138 
    139 In order to file a bug report, please visit http://bugs.freedesktop.org. 
    140 When you file the bug, file it against "xorg." When specifying the 
    141 component, please select "Driver/openchrome." This allows a message to 
    142 be sent to openchrome-devel mailing list, so that developers can be 
    143 notified of the bug.
    144     It is highly recommended to file the bug report over at 
    145 http://bugs.freedesktop.org rather than sending a message to 
    146 openchrome-devel mailing list. Also, filing a bug report against the 
    147 Linux / BSD distribution you are using (i.e., Debian, Ubuntu, Fedora, 
    148 etc.) will likely be a waste of your time since the developers for those 
    149 distributions do not directly work on developing OpenChrome.
    150 
    151 
    152 
    153 Where to Submit a Patch
    154 -----------------------
    155 
    156 In order to submit a patch to improve OpenChrome, please visit 
    157 http://bugs.freedesktop.org. Open a bug report and upload the patch there.
    158 When you file the bug, file it against "xorg." When specifying the 
    159 component, please select "Driver/openchrome." This allows a message to 
    160 be sent to openchrome-devel mailing list, so that developers can be 
    161 notified of the bug.
    162 
    163 
    164 
    165 Where to Obtain OpenChrome Source Code
    166 --------------------------------------
    167 
    168 The OpenChrome source code repository is located at.
    169 
    170 http://cgit.freedesktop.org/openchrome/xf86-video-openchrome/
    171 
    172 
    173 The experimental DRM (Direct Rendering Manager) module that supports 
    174 KMS (Kernel Mode Setting) is located at.
    175 
    176 https://cgit.freedesktop.org/openchrome/drm-openchrome/tree/drivers/gpu/drm/via
    177 
    178 
    179 
    180 If You See a Bug
    181 ----------------
    182 
    183 If you see a bug, please don't be surprised. OpenChrome has been in 
    184 development for more than 10 years. In that process, there were many 
    185 different developers that wrote the code in varying ways. OpenChrome 
    186 is a unified graphics device driver that supports 12 generations of 
    187 VIA Technologies IGP starting from CLE266 chipset all the way to 
    188 VX900 chipset. Even the VIA Technoloiges in house unified graphics 
    189 device driver does not support the number of devices OpenChrome does. 
    190 Furthermore, VIA Technologies IGPs tend to rely heavily on many 
    191 different kinds of external encoders and transmitters to get the 
    192 desired functionality. As a result, it is very difficult to get the 
    193 code right for every possible configuration you can think of.
    194     Starting with OpenChrome Version 0.4.0, the project is under new 
    195 management, and moving forward, the emphasis will be on device driver 
    196 reliability, and code maintainability.
    197 
    198 (End of this document.)
    199