;===============================================================================
; ASPEED Graphics Linux XFree86/XORG Driver ReadMe
;===============================================================================
1.Modify X config
- RHEL4.7/4.8, SUSE 10.1, SUSE11, SLES11
  >> These dritributions can detect ASPEED Graphics automatically, no need to modify
- SLES10, SUSE10:
  >> set to runlevel 3
  >> run sax2 -m 0=ast
- Debian:
  >> the default xorg.conf is empty, please create your own xorg.conf first
- RHEL4/5, Fedora, SLES9 and other distributions:
  >> Change the driver to "ast" in "DEVICE" Section
2.Update Driver:
- auto-update: detect X Window version and update the driver automatically
  >> Run ./auto-update.sh
- manual update: used if the auto-update.sh can't find proper driver to update
  >> select the proper driver package (ref. FAQ - Package description)
  >> go to the the package's directly you select
  >> chmod u+x *  in the package's directory
  >> Install:
     + Run ./update.sh in the package's directory
  >> Uninstall
     + Run ./update.sh uninstall in the package's directory
  >> Force Install:
     + Run ./update.sh force in the package's directory
3. FAQ:
- Support Chips
  >> AST1100/2000/2050/2100/2150/2200/1300/2300/1400/2400/2500/2510/2530
  >> AST1160/1180
- Package description:
  >> x86: 32bits driver
  >> x86_64: 64bits driver
     >> xf86: Xfree86 driver
     >> xorg67: Xorg 6.7.x (driver version: 1.10.1)
     >> xorg68: Xorg 6.8.x driver (driver version: 1.10.1)
     >> xorg69: Xorg 6.9.x (driver version: 1.10.1)
     >> xorg7:  Xorg 7.0 (driver version: 1.10.1)
     >> xorg71: Xorg 7.1 (driver version: 1.10.1)
     >> xorg72: Xorg 7.2 (driver version: 1.10.1)
     >> xorg73: Xorg 7.3 (driver version: 1.10.1)
     >> xorg74: Xorg 7.4 (driver version: 1.10.1)
     >> xorg75: Xorg 7.5 (xserver 1.6.x) (driver version: 1.10.1)
     >> xorg75_1: Xorg 7.5 (xserver 1.7.x) (driver version: 1.10.1)
     >> xorg76: Xorg 7.6 (xserver 1.8.x) (driver version: 1.10.1)
     >> xorg76_1: Xorg 7.6 (xserver 1.9.x) (driver version: 1.10.1)
     >> xorg77: Xorg 7.7 (xserver 1.10.x) (driver version: 1.10.1)
     >> xorg77_1: Xorg 7.7 (xserver 1.11.x) (driver version: 1.10.1)
     >> xorg77_2: Xorg 7.7 (xserver 1.12.x) (driver version: 1.10.1)
     >> xorg78: Xorg 7.8 (xserver 1.13.x) (driver version: 1.10.1)
     >> xorg78_1: Xorg 7.8 (xserver 1.14.x) (driver version: 1.10.1)
     >> xorg78_2: Xorg 7.8 (xserver 1.15.x) (driver version: 1.10.1)
     >> xorg78_3: Xorg 7.8 (xserver 1.16.x) (driver version: 1.10.1)
     >> xorg78_4: Xorg 7.8 (xserver 1.17.x) (driver version: 1.10.1)
     >> xorg78_5: Xorg 7.8 (xserver 1.18.x) (driver version: 1.10.1)
     >> xorg78_6: Xorg 7.8 (xserver 1.19.x) (driver version: 1.10.1)
     >> xorg78_7: Xorg 7.8 (xserver 1.20.x) (driver version: 1.10.1)
- Package selection description:
  >> RHEL 3.x: xf86 (driver version: 1.10.1)
  >> RHEL 4.x: xorg68 (driver version: 1.10.1)
  >> RHEL 5.x: xorg71 (driver version: 1.10.1)
  >> RHEL 6.0-6.1: xorg75_1 (driver version: 1.10.1)
  >> RHEL 6.2-6.3: xorg77 (driver version: 1.10.1)
  >> RHEL 6.4-6.5: xorg78 (driver version: 1.10.1)
  >> RHEL 6.6-6.8: xorg78_2 (driver version: 1.10.1)
  >> RHEL 6.9+: xorg78_4 (driver version: 1.10.1)
  >> RHEL 7.0-7.2: xorg78_2 (driver version: 1.10.1)
  >> RHEL 7.3+: xorg78_4 (driver version: 1.10.1)
  >> SLES 9: xf86 (driver version: 1.10.1)
  >> SLES 10.x: xorg69 (driver version: 1.10.1)
  >> SLES 11.0: xorg74 (driver version: 1.10.1)
  >> SLES 11.1+: xorg75 (driver version: 1.10.1)
  >> SLES 12.0-12.1: xorg78_2 (driver version: 1.10.1)
  >> SLES 12.2+: xorg78_5 (driver version: 1.10.1)
  >> SLES 15: xorg78_6 (driver version: 1.10.1)
  >> RedHat 9: xf86 (driver version: 1.10.1)
  >> Fedora 3/4: xorg68 (driver version: 1.10.1)
  >> Fedora 5: xorg7 (driver version: 1.10.1)
  >> Fedora 6: xorg71 (driver version: 1.10.1)
  >> Fedora 7/8: xorg72 (driver version: 1.10.1)
  >> Fedora 9/10: xorg74 (driver version: 1.10.1)
  >> Fedora 11: xorg75 (driver version: 1.10.1)
  >> Fedora 12: xorg75_1 (driver version: 1.10.1)
  >> Fedora 13: xorg76 (driver version: 1.10.1)
  >> Fedora 14: xorg76_1 (driver version: 1.10.1)
  >> Fedora 15: xorg77 (driver version: 1.10.1)
  >> Fedora 16: xorg77_1 (driver version: 1.10.1)
  >> Fedora 17: xorg77_2 (driver version: 1.10.1)
  >> Fedora 18: xorg78 (driver version: 1.10.1)
  >> Fedora 19: xorg78_1 (driver version: 1.10.1)
  >> Fedora 20: xorg78_1 (driver version: 1.10.1)
  >> Fedora 21: xorg78_3 (driver version: 1.10.1)
  >> Fedora 22: xorg78_4 (driver version: 1.10.1)
  >> Fedora 23: xorg78_5 (driver version: 1.10.1)
  >> Fedora 24: xorg78_5 (driver version: 1.10.1)
  >> Fedora 25: xorg78_6 (driver version: 1.10.1)
  >> Fedora 26: xorg78_6 (driver version: 1.10.1)
  >> Fedora 27: xorg78_6 (driver version: 1.10.1)
  >> Fedora 28: xorg78_6 (driver version: 1.10.1)
  >> Fedora 29: xorg78_7 (driver version: 1.10.1)
  >> OpenSUSE 10: xorg68 (driver version: 1.10.1)
  >> OpenSUSE 10.1: xorg69 (driver version: 1.10.1)
  >> OpenSUSE 10.2/10.3: xorg72 (driver version: 1.10.1)
  >> OpenSUSE 11.0: xorg73 (driver version: 1.10.1)
  >> OpenSUSE 11.1: xorg74 (driver version: 1.10.1)
  >> OpenSUSE 11.2: xorg75 (driver version: 1.10.1)
  >> OpenSUSE 11.3: xorg76 (driver version: 1.10.1)
  >> OpenSUSE 11.4: xorg76_1 (driver version: 1.10.1)
  >> OpenSUSE 12.0/12.1: xorg77 (driver version: 1.10.1)
  >> OpenSUSE 12.2: xorg77_2 (driver version: 1.10.1)
  >> OpenSUSE 12.3: xorg78 (driver version: 1.10.1)
  >> OpenSUSE 13.0/13.1: xorg78_1 (driver version: 1.10.1)
  >> OpenSUSE 13.2+: xorg78_3 (driver version: 1.10.1)
  >> OpenSUSE 42.1+: xorg78_4 (driver version: 1.10.1)
  >> OpenSUSE 15: xorg78_6 (driver version: 1.10.1)
  >> Ubuntu 8.10: xorg74 (driver version: 1.10.1)
  >> Ubuntu 9.04: xorg75 (driver version: 1.10.1)
  >> Ubuntu 9.10: xorg75 (driver version: 1.10.1)
  >> Ubuntu 10.04: xorg75_1 (driver version: 1.10.1)
  >> Ubuntu 10.10: xorg76_1 (driver version: 1.10.1)
  >> Ubuntu 11.04: xorg77 (driver version: 1.10.1)
  >> Ubuntu 11.10: xorg77 (driver version: 1.10.1)
  >> Ubuntu 12.04: xorg77_1 (driver version: 1.10.1)
  >> Ubuntu 12.10: xorg78 (driver version: 1.10.1)
  >> Ubuntu 13.04: xorg78 (driver version: 1.10.1)
  >> Ubuntu 13.10: xorg78_1 (driver version: 1.10.1)
  >> Ubuntu 14.04: xorg78_2 (driver version: 1.10.1)
  >> Ubuntu 14.10: xorg78_3 (driver version: 1.10.1)
  >> Ubuntu 15.04: xorg78_4 (driver version: 1.10.1)
  >> Ubuntu 15.10: xorg78_4 (driver version: 1.10.1)
  >> Ubuntu 16.04: xorg78_5 (driver version: 1.10.1)
  >> Ubuntu 16.10: xorg78_5 (driver version: 1.10.1)
  >> Ubuntu 17.04: xorg78_6 (driver version: 1.10.1)
  >> Ubuntu 17.10: xorg78_6 (driver version: 1.10.1)
  >> Ubuntu 18.04: xorg78_6 (driver version: 1.10.1)
  >> Ubuntu 18.10: xorg78_7 (driver version: 1.10.1)
  >> CentOS 4.x: xorg68 (driver version: 1.10.1)
  >> CentOS 5.x: xorg71 (driver version: 1.10.1)
  >> CentOS 6.0-6.1: xorg75_1 (driver version: 1.10.1)
  >> CentOS 6.2-6.3: xorg77 (driver version: 1.10.1)
  >> CentOS 6.4-6.5: xorg78 (driver version: 1.10.1)
  >> CentOS 6.6-6.8: xorg78_2 (driver version: 1.10.1)
  >> CentOS 6.9+: xorg78_4 (driver version: 1.10.1)
  >> CentOS 7.0-7.2: xorg78_2 (driver version: 1.10.1)
  >> CentOS 7.3+: xorg78_4 (driver version: 1.10.1)
  >> Debian 5.x(lenny): xorg73 (driver version: 1.10.1)
  >> Debian 6.x(squeeze): xorg75_1 (driver version: 1.10.1)
  >> Debian 7.x(wheezy): xorg77_2 (driver version: 1.10.1)
  >> Debian 8.x(jessie): xorg78_3 (driver version: 1.10.1)
  >> Debian 9.x(stretch): xorg78_6 (driver version: 1.10.1)
  >> Gentoo 2008: xorg72 (driver version: 1.10.1)
  >> Mandrake 10.1: xorg67 (driver version: 1.10.1)
- X Windows can't enabled properly:
  >> check the config:
     XFree86: /etc/X11/XFree86.conf
     XORG: /etc/X11/xorg.conf
  >> check the log:
     XFree86: /var/log/XFree86.0.log
     XORG: /var/log/Xorg.0.log
  >> try force install
     >> if met unresolve symbols issue
  >> send the config & logs above to us for more check
- VGA2 CLONE Support
  >> Add Option "VGA2Clone" in X Config
     >> Option "VGA2Clone" "1"
- Show 'Ubuntu is running in low-graphics mode" on Ubuntu environment
  >> It's the issue of VBIOS, please upgrade the VBIOS to v.0.89 or after
  >> If can't find a way to upgrade VBIOS
     >> Method1: modify GdmXserverTimeout to 20 or even longer in /etc/gdm/gdm.conf
     >> Method2: use xdm instead of gdm
- Still use "vesa" driver instead of "ast" driver after reboot system
  >> copy ast-device.conf to /etc/X11/xorg.conf.d and reboot system
- Failed to boot to desktop environment if collocate with other VGA Adapters
  >> Some VGA driver rely on linux kernel mode driver, it will not work if lack of its kernel mode driver
     >> remove "nomodeset" in boot option
     >> use "modesetting" instead of "ast" in /etc/X11/xorg.conf for ASPEED Graphics
  >> if still failed, please send Xorg.0.log in /var/log for check
4.Contact Window:
- yc_chen@aspeedtech.com
- 886.3.578.9568 ext. 810

