Setup - RoninRage/RoninsPiKivyDashboard GitHub Wiki

🐧 Raspberry Pi Zero 2 W Setup Guide with Waveshare Zero-DISP-7A

This guide walks you through preparing a Raspberry Pi Zero 2 W to run RoninsPiKivyDashboard using a Waveshare Zero-DISP-7A HDMI + USB touchscreen.

📦 Base System

Board: Raspberry Pi Zero 2 W
Display: Waveshare Zero-DISP-7A (HDMI + USB touch)
OS: Raspberry Pi OS Lite (32-bit)
Release: May 13th, 2025
Kernel: 6.12
Debian: 12 (bookworm)

📋 Step 1: Prepare SD Card

Flash Raspberry Pi OS Lite using Raspberry Pi Imager.
Select:

OS: Raspberry Pi OS Lite (32-bit), May 13th, 2025 release
Storage: 8 GB+ microSD card

Before first boot (optional but recommended):

Enable SSH: place a file named ssh (no extension) into the boot partition.
Pre-configure Wi-Fi: Create wpa_supplicant.conf in the boot partition with:

country=DE
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1

network={
  ssid="YourWiFiName"
  psk="YourWiFiPassword"
}

⚙️ Step 2: Configure display in `config.txt`

Mount the boot partition and edit config.txt.
Add this to the bottom of the file:

# Waveshare Zero-DISP-7A config
hdmi_force_hotplug=1 
config_hdmi_boost=10
hdmi_group=2 
hdmi_mode=87 
hdmi_cvt 1024 600 60 6 0 0 0

🔌 Step 3: Connect Hardware

Insert flashed microSD card into Pi Zero 2 W
Connect Waveshare display:
- HDMI to Pi’s mini HDMI port
- USB to Pi’s USB OTG port (for power + touch)
Connect power supply (2 A recommended)

🚀 Step 4: First Boot & Login

Wait for the Pi to boot (~20–30 sec)
SSH into it using hostname (raspberrypi.local) or IP
Default credentials:
```
user: pi
pass: raspberry
```

You should see a boot screen on the Waveshare display with system logs or a terminal login prompt.

🧪 Next Steps

Once the Pi is running and displaying correctly:

Follow the Setup Guide
Or install dependencies and run main.py directly

💡 No display? Double-check config.txt and HDMI cable. Also make sure to provide a power supply with sufficient output.