Waveshare DSI LCD Driver Installation Guide

• 中文版

Important Notes

📌 These instructions only apply to older Raspberry Pi OS versions (like Bullseye/Buster) that require manual driver installation.
✅ New Raspberry Pi OS (Bookworm) now natively supports Waveshare DSI displays:

• Driver has been open-sourced and merged into the official Raspberry Pi kernel
• Simply add one configuration line to config.txt to enable display and touch
• No manual driver installation required
• Official kernel support is more stable and convenient. We no longer maintain GitHub installation scripts.

---

Configuration Guide for New Systems (Bookworm)

Refer to our official Wiki for model-specific setup instructions:

Display Model	Wiki Link
2.8inch DSI LCD	Link
3.4inch DSI LCD (C)	Link
4inch DSI LCD	Link
4inch DSI LCD (C)	Link
5inch DSI LCD (C)	Link
5inch DSI LCD (D)	Link
6.25inch DSI LCD	Link
7inch DSI LCD (C)	Link
7inch DSI LCD (E)	Link
7inch DSI LCD (H)	Link
7-DSI-TOUCH-A	Link
7.9inch DSI LCD	Link
8inch DSI LCD (C)	Link
8-DSI-TOUCH-A	Link
8.8inch DSI LCD	Link
10.1inch DSI LCD (C)	Link
10.1-DSI-TOUCH-A	Link
11.9inch DSI LCD	Link
13.3inch DSI LCD	Link

---

Manual Driver Installation for Older OS (Bullseye/Buster)

Prerequisites

• Ensure Raspberry Pi has internet connection
• Confirm kernel version using uname -a in terminal

Installation Steps

1. Download driver and enter directory

   git clone https://github.com/waveshare/Waveshare-DSI-LCD
   cd Waveshare-DSI-LCD

2. Navigate to matching kernel version directory

   cd 5.15.61   # Example version - replace with your actual version
   # cd 5.15.76 # Alternative version example

3. Select architecture directory

   cd 32        # For 32-bit systems
   # cd 64      # For 64-bit systems

4. Execute model-specific installation command
   Verify I2C DIP switch configuration before running

   # 2.8inch DSI LCD 480×640:
   sudo bash ./WS_xinchDSI_MAIN.sh 28 I2C0
   
   # 3.4inch DSI LCD (C) 800×800:
   sudo bash ./WS_xinchDSI_MAIN.sh 34C I2C0
   
   # 4inch DSI LCD 480×800:
   sudo bash ./WS_xinchDSI_MAIN.sh 40 I2C0
   
   # 4inch DSI LCD (C) 720×720:
   sudo bash ./WS_xinchDSI_MAIN.sh 40C I2C0
   
   # 7inch DSI LCD (C) 1024×600:
   sudo bash ./WS_xinchDSI_MAIN.sh 70C I2C1
   
   # 7.9inch DSI LCD 400×1280:
   sudo bash ./WS_xinchDSI_MAIN.sh 79 I2C0
   
   # 11.9inch DSI LCD 320×1480:
   sudo bash ./WS_xinchDSI_MAIN.sh 119 I2C0
   
   # 8inch DSI LCD (C) 1280×800:
   sudo bash ./WS_xinchDSI_MAIN.sh 80C I2C0
   
   # 10.1inch DSI LCD (C) 1280×800:
   sudo bash ./WS_xinchDSI_MAIN.sh 101C I2C0

⚠️ Important Notes:

• Verify model codes before execution (e.g., 34C = 3.4-inch Type C)
• I2C interface selection must match physical hardware switches
• Requires stable internet connection

5. Reboot after installation

   sudo reboot