Troubleshooting

32-bit processors only (Intel Atom and similar)

1. Install Android-x86 32-bit OS from here (doesn't matter which version, as long as it's 32-bit)
2. Update with Bliss OS 32-bit (current version is 11.9). After reboot you should be able to access the grub menu.
3. In grub menu select "Debug mode"
4. Run the following commands:

mount -o remount, rw /mnt cd /mnt/grub nano menu.lst </pre> 5. Add `nomodeset` before every `SCR=/bliss...` line. For example, your configuration should look something like this: <pre> default=0 timeout=6 splashimage=/grub/android-x86.xpm.gz root (hd0,0) title Bliss-OS 11.7 kernel /bliss-x86-11.7/kernel quiet root=/dev/ram0 androidboot.selinux=permissive androidboot.hardware=android_x86 vmalloc=192M androidboot.hardware=android_x86_64 nomodeset SRC=/bliss-x86-11.7 initrd /bliss-x86-11.7/initrd.img title Bliss-OS 11.7 (Legacy modprobe mode) kernel /bliss-x86-11.7/kernel root=/dev/ram0 androidboot.selinux=permissive androidboot.hardware=android_x86 vmalloc=192M androidboot.hardware=android_x86_64 AUTO_LOAD=old nomodeset SRC=/bliss-x86-11.7 initrd /bliss-x86-11.7/initrd.img title Bliss-OS 11.7 (Debug mode) kernel /bliss-x86-11.7/kernel root=/dev/ram0 androidboot.selinux=permissive androidboot.hardware=android_x86 vmalloc=192M DEBUG=2 androidboot.hardware=android_x86_64 nomodeset SRC=/bliss-x86-11.7 initrd /bliss-x86-11.7/initrd.img title Bliss-OS 11.7 (Debug nomodeset) kernel /bliss-x86-11.7/kernel nomodeset root=/dev/ram0 androidboot.selinux=permissive androidboot.hardware=android_x86 vmalloc=192M DEBUG=2 androidboot.hardware=android_x86_64 nomodeset SRC=/bliss-x86-11.7 initrd /bliss-x86-11.7/initrd.img title Bliss-OS 11.7 (Debug video=LVDS-1:d) kernel /bliss-x86-11.7/kernel video=LVDS-1:d root=/dev/ram0 androidboot.selinux=permissive androidboot.hardware=android_x86 vmalloc=192M DEBUG=2 nomodeset SRC=/bliss-x86-11.7 initrd /bliss-x86-11.7/initrd.img ``` 6. Press Ctrl+O to save, and then Ctrl+X to close. 7. Type reboot -f

You should be finished! If all goes well you will boot into Bliss OS on your 32-bit machine.

grub2 kernel parameters and options

You will want to pay attention here! With Bliss OS on the PC, we tend to use quite a few command line options to get things working right. We've gathered a few of them here to explain them a little bit.

A full list of available kernel parameters can be found here.

Brief options overview:

• parameter: Description
• root=: Root filesystem.
• rootflags=: Root filesystem mount options.
• initrd=: Specify the location of the initial ramdisk.
• init=: Run specified binary instead of /sbin/init (symlinked to systemd in Arch) as init process.
• init=/bin/sh: Boot to shell.
• systemd.unit=: Boot to a specified target.
• nomodeset: Disable kernel mode setting (useful for fixing video driver panics) This will load mostly everything in software rendering/support mode. No hardware acceleration. Good for debugging.
• panic=: Time before automatic reboot on kernel panic.
• debug: Enable kernel debugging (events log level).
• mem=: Force usage of a specific amount of memory to be used.
• maxcpus=: Maximum number of processors that an SMP kernel will bring up during bootup.
• selinux=: Disable or enable SELinux at boot time.
• netdev=: Network devices parameters.
• video=<videosetting>: Override framebuffer video defaults.
• sleep=1: This will enable the system.prop value for sleep.earlysuspend=1, and on some machines, it enables the proper sleep state.
• acpi_sleep=s3_bios,s3_mode: Sometimes needed for older machines to enter sleep mode properly
• SETUPWIZARD=0: This command will skip SetupWizard on boot. (Only needs to be run once!)
• AUTO_LOAD=old: This will load android-x86 variants using the old modprobe method to init devices. We sometimes use this to debug devices not starting.
• DEBUG=1 & DEBUG=2: These enable verbose console debugging, giving another command shell after loading kernel modules, but before Android init
• vga=xxx & video=: These are the common video modes that you can boot into if it doesn't pick the best choice automagically. You can also use video= as resolution parameters: video=LVDS-1:d video=1366x800. Learn more from our own Henri Koivuneva!
• HWACCELL=1: This will disable graphics hardware acceleration, enabling rendering through Swiftshader. (Must use this if running headless)
• buildvariant=eng, user, userdebug: This is the commandline parameter to run the current build as eng, userdebug, or user
• DPI=xxx: This will manually set the DPI on init. Use this if things are too big/small for you.
• fbcon=variablename: This is to configure framebuffer to use various options. Usually used to help fix video settings, etc. Even default rotation on some Atom tablets. Example: video=efifb fbcon=rotate:1
• VULKAN=1: Required for Vulkan-supported chipsets. This enables hwcomposer to work right with screenshots and other things.

!!! warning The following options can only be used on Android 9/10 builds released after 2020-02-02.

• HWC=xxx: Define DRM_HWComposer - options include drm, drm_minigbm, and intel.
• GRALLOC=xxx: Define DRM_Gralloc - options include gbm, minigbm, and intel.

As an example, here are a few of the boot options used in testing:

menuentry 'Bliss-x86 Test-Oreo' --class bliss {
    search --file --no-floppy --set=root /AndroidOS/android.boot
    linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng quiet sleep.earlysuspend=2 DATA=
    initrd /AndroidOS/initrd.img
}

menuentry 'Bliss-x86 Test-Oreo AUTO_LOAD=old' --class bliss {
    search --file --no-floppy --set=root /AndroidOS/android.boot
    linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng quiet DATA= AUTO_LOAD=old
    initrd /AndroidOS/initrd.img
}

menuentry 'Bliss-x86 Test-Oreo - SETUP_WIZARD=0' --class bliss {
    search --file --no-floppy --set=root /AndroidOS/android.boot
    linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive buildvariant=eng SETUPWIZARD=0 quiet DATA=
    initrd /AndroidOS/initrd.img
}

menuentry 'Bliss-x86 Test-Oreo - debug=1' --class bliss {
    search --file --no-floppy --set=root /AndroidOS/android.boot
    linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng SETUPWIZARD=0 quiet DATA= DEBUG=1
    initrd /AndroidOS/initrd.img
}

menuentry 'Bliss-x86 Test-Oreo - debug=2' --class bliss {
    search --file --no-floppy --set=root /AndroidOS/android.boot
    linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 buildvariant=eng SETUPWIZARD=0 quiet DATA= DEBUG=2
    initrd /AndroidOS/initrd.img
}