commit f769b55b90a9ca1964e5f7a21b0c77ed235f2e9d
Author: Fabio <fabio.micheluz@gmail.com>
Date:   Tue Aug 26 22:12:16 2025 +0800

    first commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c95d04a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,131 @@
+# Mesa 25.2 on RK3588 (Mali G610) in Debian 12
+
+## -- 01 Setup AmazingFate Panfork-Mesa repo for mali-g610-firmware 01
+
+
+### 1A: import gpg key and use it to sign repo
+
+'''
+wget -qO - https://download.opensuse.org/repositories/home:/amazingfate:/panfork-mesa/Debian_12/Release.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/panfork-mesa.gpg
+'''
+
+### 1B: Add Repo to apt sources & update
+
+'''
+echo "deb https://download.opensuse.org/repositories/home:/amazingfate:/panfork-mesa/Debian_12/ /" | sudo tee /etc/apt/sources.list.d/panfork-mesa.list
+sudo apt update
+'''
+
+### 1C: Install firmware
+
+	sudo apt install mali-g610-firmware libmali-g610-x11
+
+
+### 1D: **RECOMMENDED** : Remove panfork-mesa repo
+	
+	sudo rm -rf /etc/apt/sources.list.d/panfork-mesa.list
+	sudo rm -rf /etc/apt/trusted.gpg.d/panfork-mesa.gpg
+
+
+## -- 02 Enable Debian Experimental Repo for recent Mesa Packages 02
+
+	sudo nano /etc/apt/sources.list
+
+
+### 2A: Add the following to the bottom of the document... 
+
+	deb http://deb.debian.org/debian unstable main contrib non-free
+	deb http://deb.debian.org/debian experimental main
+
+
+### 2B: Update and install Mesa Packages
+
+	sudo apt update
+	sudo apt install -t experimental mesa-vulkan-drivers mesa-utils libgl1-mesa-dri libglx-mesa0 mesa-vdpau-drivers mesa-va-drivers mesa-opencl-icd mesa-libgallium
+
+
+### 2C: **RECOMMENDED** : Re-open apt sources and remove Experimental/Unstable repos...
+
+	sudo nano /etc/apt/sources.list
+
+Remove the following and update apt...
+
+	deb http://deb.debian.org/debian unstable main contrib non-free
+	deb http://deb.debian.org/debian experimental main
+
+	sudo apt update
+
+
+## -- 03 Add rockchip-multimedia Ubuntu Repo to Apt 03 -- 
+
+'''
+echo "deb [arch=arm64] https://ppa.launchpadcontent.net/liujianfeng1994/rockchip-multimedia/ubuntu jammy main" | sudo tee /etc/apt/sources.list.d/rockchip-multimedia.list
+'''
+
+### 3A: Download Key and add convert to gpg
+
+'''
+curl -o rockchip-multimedia.asc "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x8065BE1FC67AABDE"
+gpg --dearmor rockchip-multimedia.asc
+sudo mv rockchip-multimedia.asc.gpg /etc/apt/keyrings/rockchip-multimedia.gpg
+'''
+
+### 3B: Add PPA Repo and update 
+
+'''
+echo "deb [arch=arm64 signed-by=/etc/apt/keyrings/rockchip-multimedia.gpg] https://ppa.launchpadcontent.net/liujianfeng1994/rockchip-multimedia/ubuntu jammy main" | sudo tee /etc/apt/sources.list.d/rockchip-multimedia.list
+sudo apt update
+'''
+
+### 3C: Install packages
+
+	sudo apt install libv4l-rkmpp chromium gstreamer1.0-rockchip1 rockchip-multimedia-config
+
+
+### 3D: **OPTIONAL** : Disable rockchip-multimedia PPA repo ##
+
+	sudo mv /etc/apt/sources.list.d/rockchip-multimedia.list /etc/apt/sources.list.d/rockchip-multimedia.list.disabled
+	sudo apt update
+
+
+## -- 04 Optimize XFCE/Xorg and Reboot 04 -- 
+
+### 4A: Open default xorg config
+
+	sudo nano /etc/X11/xorg.conf.d/01-armbian-defaults.conf
+
+
+Add the following... 
+
+'''
+Section "Device"
+   Identifier "Mali-G610"
+   Driver "modesetting"
+   Option "DRI" "3"               # Required for Mali GPUs
+   Option "GALLIUM_DRIVER" "panfrost"
+   Option "PageFlip" "on"          # Reduces tearing
+   Option "TearFree" "true"        # Xfce-specific anti-tearing
+EndSection
+'''
+
+### 4B: Add XFCE Specific tweaks
+
+	sudo nano /etc/X11/xorg.conf.d/20-xfce-tweaks.conf
+
+
+Add the following... 
+
+'''
+Section "Extensions"
+   Option "COMPOSITE" "Enable"
+EndSection
+
+Section "ServerFlags"
+   Option "AutoAddGPU" "off"  # Prevents duplicate GPU detection
+EndSection    
+'''
+
+
+### 4C: Reboot
+
+	sudo reboot now