Skip to content

Latest commit

 

History

History
61 lines (45 loc) · 1.92 KB

graphics-troubleshooting.md

File metadata and controls

61 lines (45 loc) · 1.92 KB

Debug Graphics

When booting into Bliss for the first time, some users may see a blinking cursor, scrambled graphics, or black screen. These are all signs that your device requires some configuration to get things to run.

Android-x86, AG & Bliss OS builds all come with a configurable graphics stack that can be used through Grub CLI.

The main options for configuration are as follows,

Gralloc:

  • GRALLOC=gbm - Uses GBM interface (Vulkan mode default)
  • GRALLOC=minigbm - Uses Minigbm interface
  • GRALLOC=intel - Uses Intel minigbm interface
  • GRALLOC=none - Force no Gralloc interface

HW-Composer:

  • HWC=drm - Standard for versions <= Android 9
  • HWC=drmfb - Use drm-framebuffer insead
  • HWC=intel - Used Intel IA HWC
  • HWC=none - Force no hwcomposer definition

Grub Examples:

label debug
	menu label Live CD - ^Debug mode
	kernel /kernel
	append initrd=/initrd.img CMDLINE DEBUG=2 SRC= DATA=

label debug_gbm
	menu label Live CD - Debug mode gralloc.gbm
	kernel /kernel
	append initrd=/initrd.img CMDLINE DEBUG=2 SRC= DATA= GRALLOC=gbm

label debug_drmfb-composer
	menu label Live CD - Debug mode drmfb-composer gralloc.gbm
	kernel /kernel
	append initrd=/initrd.img CMDLINE DEBUG=2 SRC= DATA= HWC=drmfb GRALLOC=gbm

label debug_hwc_gbm
	menu label Live CD - Debug mode hwcomposer.drm gralloc.gbm
	kernel /kernel
	append initrd=/initrd.img CMDLINE DEBUG=2 SRC= DATA= HWC=drm GRALLOC=gbm

label debug_minigbm
	menu label Live CD - Debug mode gralloc.minigbm
	kernel /kernel
	append initrd=/initrd.img CMDLINE DEBUG=2 SRC= DATA= GRALLOC=minigbm

label debug_hwc_minigbm
	menu label Live CD - Debug mode hwcomposer.drm_minigbm gralloc.minigbm
	kernel /kernel
	append initrd=/initrd.img CMDLINE DEBUG=2 SRC= DATA= HWC=drm_minigbm GRALLOC=minigbm

label debug_intel
	menu label Live CD - Debug mode hwcomposer.intel gralloc.intel
	kernel /kernel
	append initrd=/initrd.img CMDLINE DEBUG=2 SRC= DATA= HWC=intel GRALLOC=intel