;===============================================================================
; ASPEED Graphics Linux DRM Driver ReadMe
;===============================================================================
1.Description:
- RPMs and SRPMs for ASPEED Graphics Linux DRM Driver
2.Support ASPEED Graphics Chipsets:
- AST1100/1300/1400/2000/2050/2100/2150/2200/2300/2400/2500/2510/2530/2600
3.Support Linux LTS Distributions:
- RPMS:
  >> RHEL/CentOS 7.9 x86_64: 3.10.0-1160.el7.x86_64.rpm
  >> RHEL/CentOS 8.2 x86_64: 4.18.0-193.el8.x86_64.rpm
  >> RHEL/CentOS 8.4 x86_64: 4.18.0-305.el8.x86_64.rpm
  >> RHEL/CentOS 8.6 x86_64: 4.18.0-372.9.1.el8.x86_64.rpm
  >> RHEL/CentOS 9.0 x86_64: ast-drm-5.14.0-70.13.1.el9_0.x86_64.x86_64.rpm
- SPRMS:
  >> RHEL/CentOS 7.9 x86_64: ast-drm-[version]-rhel79.src.rpm
  >> RHEL/CentOS 8.2 x86_64: ast-drm-[version]-rhel82.src.rpm
  >> RHEL/CentOS 8.4 x86_64: ast-drm-[version]-rhel84.src.rpm
  >> RHEL/CentOS 8.6 x86_64: ast-drm-[version]-rhel86.src.rpm
  >> RHEL/CentOS 9.0 x86_64: ast-drm-[version]-rhel90.src.rpm
  >> SLES 12 SP5 x86_64: ast-drm-[version]-sles12.5.src.rpm
  >> SLES 15 SP4 x86_64: ast-drm-[version]-sles15.4.src.rpm
- RHEL life cycle:
  >> https://access.redhat.com/support/policy/updates/errata
4.Update Driver by RPMS:
- auto-update:
  >> run ./auto-update.sh
  >> reboot system
5.Update Driver by SRPMS: used if cannot find proper RPMs
- RHEL/CentOS:
  >> Install Build Package:
  +++ yum groupinstall "Development Tools" "Development Libraries"
  +++ yum install rpmdevtools
  +++ yum install kernel-devel-$(uname -r)
  >> Build RPMS
  +++ rpmbuild --rebuild ast-drm-1.10.1-rhel7.src.rpm
  >> Install RPMS
  +++ cd ~/rpmbuild/RPMS
  +++ rpm -ivh ast-drm-1.10.1.rpm --force
  >> make initramfs
  +++ mkinitrd /boot/initramfs-$(uname -r).img $(uname -r) --force
  >> reboot
- SLES12/15:
  >> Install Build Package
  +++ zypper install kernel-devel
  +++ zypper install rpm-build
  >> There two install ways
  >> 1. Build and Install SRPM by manual
	+++ rpmbuild --rebuild ast-drm-[version]-[distribution].src.rpm
	>> Install RPMS
	+++ cd /usr/src/packages
	+++ rpm -ivh ast-drm-[version].rpm --force
	>> make initramfs
	+++ dracut -f
	>> allow un-supported modules
	+++ set allow_unsupported_modules 0 to 1 in /etc/modprobe.d/10-unsupported-modules.conf
	>> reboot
  >> 2. Build and Install SRPM by auto script
	>> run ./auto-srpm.sh
	>> reboot system
6.FAQ:
- Extra Steps if Secure Boot is Enabled
  >> check if "ASPEED" signing key had been added to .system_keyring
  +++ should show "EFI: loaded cert 'ASPEED Technology Inc. signing key: ....'" in /var/log/messages
  >> add "ASPEED" signing key to MOK list if it is not in .system_keyring
  +++ cd Misc
  +++ tar zxvf aspeed-signing-key-pub.tar.gz
  +++ mokutil --import signing_key.x509
  ++++ follow prompt message, reboot system and enroll the key to keyring
- Show "kernel: Request for unknown module key 'ASPEED Technology Inc. signing key: ....'" in /var/log/messages
  >> If secure boot is enabled: please add "ASPEED" signing key to MOK list.
  >> If secure boot is disabled: driver still can be loaded properly, please ingore it.
- Run ./auto-update.sh and show "No permission to write to /boot"
  >> It require run as "root". Please run "su" and input the password of root.
- DRM driver may not be enable.
  >> check /etc/default/grub or /etc/sysconfig/grub. Is there parament, "nomodeset", in GRUB_LINUX.
  >> if yes, remove "nomodeset", then rebuild grub menu: 
    RHEL:
		In legacy bios. Execute cmd “grub2-mkconfig -o /boot/grub2/grub.cfg“ to generate grub.cfg.
		In UEFI mode, Execute cmd “grub2-mkconfig -o /boot/efi/EFI/centos/grub.cfg“ to generate grub.cfg.
	Ubuntu:
		In legacy bios. Execute cmd “grub-mkconfig --output=/boot/grub/grub.cfg“ to generate grub.cfg.
		In UEFI mode Execute cmd “grub-mkconfig -o /boot/efi/EFI/ubuntu/grub.cfg“ to generate grub.cfg.
- Check AST DRM driver has been update.
  >> Get driver version, check the version same with courrent version.
  +++ dmesg | grep drm
- Get the connect status with physical monitor.
  >> Get the EDID from monitor.
  +++ cat /sys/class/drm/card0-VGA-1/edid | xxd
  >> Get the mode list from monitor.
  +++ cat /sys/class/drm/card0-VGA-1/modes
- Get information of current distribution.
  +++ cat /etc/os-release
- The incompatible issues of Wayland after the version 40 of gnome.
  >> The default window system on some of distributions may is wayland. like sles15.4 desktop.
  >> There are incompatible issues after the version 40 of gnome.
  >> We suggest you disable wayland feature on such situations.
  +++ Edit file /etc/gdm/custom.conf, and setup “WaylandEnable=false”

7.Contact Window:
- kuohsiang_chou@aspeedtech.com
- 886.3.575.1185 ext. 8875
