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.
General
You need to adjust the config.txt on a new install, for every version of the Hackberry. It won't work out-of-the-box without the adjustments.
There are two ways to edit the config.txt:
- Mounting the micro SC card on a computer
- Editing the file on a running Hackberry
1) Mounting the micro SD card on a computer
After you've flashed your micro SD card, you probably need to (safely) remove it from your computer and plug it back in again.
There should be two (or at least one) “device” or partition now. The config.txt will be located on the bootfs partition under /firmware/config.txt.
2) Editing the file on a running Hackberry
If you have access to the Hackberry through SSH, hooked up an external display, or need to do adjustments after having it configured, you can edit the config.txt located under /boot/firmware/config.txt.
Be aware that you need to have root privileges (e.g. sudo nano /boot/firmware/config.txt).
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.