This is an old revision of the document!
Raspberry Pi OS
This is the default OS that is provided by the Raspberry Pi foundation and comes preinstalled on the micro SD card that the Hackberry ships with.
Device Specific Installations
Raspberry Pi Zero 2W
Amend the config.txt with the following line:
dtoverlay=vc4-kms-dpi-hyperpixel4sq
If you mount the micro SD card on a computer, it will be located on the bootfs partition under /firmware/config.txt.
If you want to edit the file on a running Raspberry Pi (either through SSH or by attaching an external display via HDMI), it will be located under /boot/firmware/config.txt.
Screen blanking should be disabled by default, but it is never a bad idea to manually disable it by running sudo raspi-config and navigating to Display Options > Screen Blanking.
Raspberry Pi 4B
Raspberry Pi 5
Raspberry Pi CM5
The following image is a clean install of Raspberry Pi OS. It comes with a configured config.txt to enable the display. Furthermore, it comes with Pi-Apps and Alacritty preinstalled. It also includes the battery voltage script.
rpios-base-compressed.img.xz
rpios-base.checksum.txt
Screen blanking should be disabled by default, but it is never a bad idea to manually disable it by running sudo raspi-config and navigating to Display Options > Screen Blanking.
External Display
If you fail to get an external display working, make sure you're using Wayland.
To do so, run sudo raspi-config and go to Advanced Options > Wayland and choose Wayfire, then reboot. The display should now be recognized and work automatically.
Use the Screen Configuration application to configure the orientation and arrangement.