# Ripristino offline OpenCL + Vulkan — Orange Pi 5 Plus

## Scopo

Questa procedura ripristina la configurazione GPU funzionante utilizzando esclusivamente il backup:

`
/root/mali-offline-backup/
`

oppure una copia dello stesso backup proveniente da USB, disco esterno o altro computer.

La configurazione di riferimento è:

`
Kernel Mali       g21p0-01eac0
Firmware          g21p0
Userspace Mali    g24p0-00eac0
OpenCL            3.0
Vulkan            1.3.276
GPU               Mali-G610
`

La procedura non modifica:

- kernel
- DTB
- U-Boot
- partizioni di boot

# Importante

Il backup contiene le librerie userspace Mali g24 già funzionanti e il firmware g21 compatibile con il kernel.

Non utilizzare un firmware g24 al posto del firmware g21.

---

# 1. Requisiti

Il backup deve avere questa struttura:

`
mali-offline-backup/
├── firmware/
│   └── mali_csffw.bin
├── libs/
│   ├── libmali-hook-injector.a
│   ├── libmali-hook.so.1.9.0
│   ├── libmali.so.1.9.0
│   └── mali/
│       ├── libEGL.so.1
│       ├── libgbm.so.1
│       ├── libGLESv1_CM.so.1
│       ├── libGLESv2.so.2
│       ├── libMaliOpenCL.so.1
│       ├── libMaliVulkan.so.1
│       └── libwayland-egl.so.1
├── linker/
│   └── 00-aarch64-mali.conf
├── opencl/
│   └── mali.icd
├── system/
│   └── mali-priority.sh
├── symlinks/
│   ├── libmali-hook.so
│   ├── libmali-hook.so.1
│   ├── libmali-valhall-g610-g24p0-x11-wayland-gbm.so
│   ├── libmali.so
│   └── libmali.so.1
├── vulkan/
│   └── mali.json
└── checksums.sha256
`

---

# 2. Posizione del backup

Se il backup è già presente:

`
/root/mali-offline-backup
`

impostare:

`
BACKUP=/root/mali-offline-backup
`

Se il backup è stato copiato da USB in un'altra posizione, modificare BACKUP di conseguenza.

Esempio:

`
BACKUP=/media/orangepi/USB/mali-offline-backup
`

Controllare:

`
sudo find `$BACKUP` -type f -printf '%P\n' | sort
`

---

# 3. Verificare il backup prima di installarlo

`
sudo bash -c '
cd "$BACKUP" &&
sha256sum -c checksums.sha256
'
`

Tutti i file devono risultare:

`
OK
`

Se anche un solo file risulta FAILED:

`
STOP
`

Non procedere con il ripristino.

---

# 4. Controllare il kernel Mali

Prima di modificare qualsiasi file:

`
uname -a
`

Controllare il DDK Mali:

`
dmesg | grep -E 'mali fb000000.gpu: (Kernel DDK|GPU identified|Probed as mali0)'
`

Il kernel previsto deve utilizzare:

`
g21p0-01eac0
`

# Non procedere se il kernel utilizza un DDK incompatibile senza prima verificare la compatibilità del firmware.

---

# 5. Disabilitare il servizio firmware automatico

Controllare:

`
systemctl is-enabled set-mali-firmware.service
`

Deve risultare:

`
disabled
`

Se necessario:

`
sudo systemctl disable set-mali-firmware.service
`

Non avviare il servizio durante il ripristino.

---

# 6. Creare un backup della configurazione attuale

Prima di sovrascrivere qualsiasi file:

`
sudo mkdir -p /root/mali-before-offline-restore
`

Salvare gli elementi principali:

`
sudo cp -a /etc/OpenCL/vendors \
  /root/mali-before-offline-restore/

sudo cp -a /etc/ld.so.conf.d/00-aarch64-mali.conf \
  /root/mali-before-offline-restore/ 2>/dev/null || true

sudo cp -a /usr/share/vulkan/icd.d/mali.json \
  /root/mali-before-offline-restore/ 2>/dev/null || true

sudo cp -L /lib/firmware/mali_csffw.bin \
  /root/mali-before-offline-restore/mali_csffw.bin 2>/dev/null || true
`

---

# 7. Ripristinare il firmware g21

Creare la directory:

`
sudo mkdir -p /lib/firmware/mali_csffw_g21p0
`

Copiare il firmware:

`
sudo cp -a "$BACKUP/firmware/mali_csffw.bin" \
  /lib/firmware/mali_csffw_g21p0/mali_csffw.bin
`

Creare il link attivo:

`
sudo ln -sfn /lib/firmware/mali_csffw_g21p0/mali_csffw.bin \
  /lib/firmware/mali_csffw.bin
`

Verificare:

`
readlink -f /lib/firmware/mali_csffw.bin
`

Deve puntare a:

`
/usr/lib/firmware/mali_csffw_g21p0/mali_csffw.bin
`

Controllare SHA-256:

`
sha256sum /lib/firmware/mali_csffw.bin
`

Deve risultare:

`
8e7c821a55ca1c345cc79f61243616dd25fc35b81f090946f302886d67712df5
`

---

# 8. Ripristinare le librerie Mali userspace

Creare la directory:

`
sudo mkdir -p /usr/lib/aarch64-linux-gnu/mali
`

Copiare le librerie Mali:

`
sudo cp -a "$BACKUP/libs/mali/." \
  /usr/lib/aarch64-linux-gnu/mali/
`

Copiare le librerie principali:

`
sudo cp -a \
  "$BACKUP/libs/libmali-hook-injector.a" \
  "$BACKUP/libs/libmali-hook.so.1.9.0" \
  "$BACKUP/libs/libmali.so.1.9.0" \
  /usr/lib/aarch64-linux-gnu/
`

---

# 9. Ripristinare i symlink

Copiare i symlink:

`
sudo cp -a "$BACKUP/symlinks/." \
  /usr/lib/aarch64-linux-gnu/
`

Controllare:

`
ls -l \
  /usr/lib/aarch64-linux-gnu/libmali.so \
  /usr/lib/aarch64-linux-gnu/libmali.so.1 \
  /usr/lib/aarch64-linux-gnu/libmali-valhall-g610-g24p0-x11-wayland-gbm.so \
  /usr/lib/aarch64-linux-gnu/libmali-hook.so \
  /usr/lib/aarch64-linux-gnu/libmali-hook.so.1
`

I collegamenti devono essere equivalenti a:

`
libmali.so.1 -> libmali.so.1.9.0
libmali-valhall-g610-g24p0-x11-wayland-gbm.so -> libmali.so.1
libmali-hook.so -> libmali-hook.so.1
libmali-hook.so.1 -> libmali-hook.so.1.9.0
libmali.so -> libmali.so.1
`

---

# 10. Ripristinare la configurazione del linker

`
sudo mkdir -p /etc/ld.so.conf.d

sudo cp -a \
  "$BACKUP/linker/00-aarch64-mali.conf" \
  /etc/ld.so.conf.d/00-aarch64-mali.conf
`

Controllare:

`
cat /etc/ld.so.conf.d/00-aarch64-mali.conf
`

Deve contenere:

`
/usr/lib/aarch64-linux-gnu/mali
`

---

# 11. Aggiornare il linker

`
sudo ldconfig
`

Se compare il warning:

`
ldconfig: /lib/librknnrt.so is not a symbolic link
`

il warning è indipendente da Mali.

---

# 12. Ripristinare OpenCL

Creare la directory:

`
sudo mkdir -p /etc/OpenCL/vendors
`

Copiare l'ICD:

`
sudo cp -a \
  "$BACKUP/opencl/mali.icd" \
  /etc/OpenCL/vendors/mali.icd
`

Controllare:

`
cat /etc/OpenCL/vendors/mali.icd
`

Deve contenere:

`
/usr/lib/aarch64-linux-gnu/mali/libMaliOpenCL.so.1
`

# Importante

Se esiste un vecchio ICD g13:

`
/etc/OpenCL/vendors/mali-arm64.icd
`

non deve essere attivo contemporaneamente, se si vuole riprodurre la configurazione di riferimento.

Spostarlo in un backup:

`
if [ -f /etc/OpenCL/vendors/mali-arm64.icd ]; then
    sudo mv /etc/OpenCL/vendors/mali-arm64.icd \
      /root/mali-before-offline-restore/mali-arm64.icd.g13
fi
`

---

# 13. Ripristinare Vulkan

Creare la directory:

`
sudo mkdir -p /usr/share/vulkan/icd.d
`

Copiare l'ICD:

`
sudo cp -a \
  "$BACKUP/vulkan/mali.json" \
  /usr/share/vulkan/icd.d/mali.json
`

Controllare:

`
cat /usr/share/vulkan/icd.d/mali.json
`

Deve contenere un library_path equivalente a:

`
libMaliVulkan.so.1
`

---

# 14. Ripristinare la configurazione Mali

`
sudo mkdir -p /etc/profile.d

sudo cp -a \
  "$BACKUP/system/mali-priority.sh" \
  /etc/profile.d/mali-priority.sh
`

Controllare:

`
cat /etc/profile.d/mali-priority.sh
`

---

# 15. Aggiornare nuovamente il linker

`
sudo ldconfig
`

---

# 16. Verifica OpenCL prima del reboot

`
clinfo | grep -E \
'arm_release_ver|Number of platforms|Platform Version|Device Name'
`

Configurazione attesa:

`
arm_release_ver: g24p0-00eac0, rk_so_ver: 10
Number of platforms                               1
Platform Version                                OpenCL 3.0 v1.g24p0-00eac0...
Device Name                                     Mali-G610 r0p0
`

---

# 17. Verifica Vulkan prima del reboot

Utilizzare esplicitamente l'ICD Mali:

`
VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/mali.json \
vulkaninfo --summary
`

Devono comparire:

`
Mali-G610
DRIVER_ID_ARM_PROPRIETARY
apiVersion = 1.3.276
driverVersion = 24.0.0
`

# Nota

Un semplice vulkaninfo --summary può fallire con XCB se non è disponibile un server X. Il test con VK_ICD_FILENAMES è quello da utilizzare per verificare il driver.

---

# 18. Verifica del firmware prima del reboot

`
readlink -f /lib/firmware/mali_csffw.bin
sha256sum /lib/firmware/mali_csffw.bin
systemctl is-enabled set-mali-firmware.service
`

Devono risultare:

`
/usr/lib/firmware/mali_csffw_g21p0/mali_csffw.bin
8e7c821a55ca1c345cc79f61243616dd25fc35b81f090946f302886d67712df5
disabled
`

# Se il firmware non corrisponde allo SHA-256 previsto, NON riavviare.

---

# 19. Riavvio

Se tutti i controlli precedenti sono corretti:

`
sudo reboot
`

---

# 20. Verifica dopo il reboot

Controllare il kernel Mali:

`
dmesg | grep -E \
'mali fb000000.gpu: (Kernel DDK|GPU identified|Probed as mali0|Loading Mali firmware|Mali firmware git_sha)'
`

Devono essere presenti:

`
Kernel DDK version g21p0-01eac0
GPU identified as 0x7 arch 10.8.6 r0p0 status 0
Probed as mali0
Mali firmware git_sha: 221d2b3e5f4cf47df6227ccb24c82c4e4baa986e
`

---

# 21. Verifica OpenCL dopo il reboot

`
clinfo | grep -E \
'arm_release_ver|Number of platforms|Platform Version|Device Name'
`

Atteso:

`
arm_release_ver: g24p0-00eac0, rk_so_ver: 10
Number of platforms                               1
Platform Version                                OpenCL 3.0 v1.g24p0-00eac0...
Device Name                                     Mali-G610 r0p0
`

---

# 22. Verifica Vulkan dopo il reboot

`
VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/mali.json \
vulkaninfo --summary
`

Atteso:

`
Mali-G610
DRIVER_ID_ARM_PROPRIETARY
apiVersion = 1.3.276
driverVersion = 24.0.0
`

---

# 23. Verifica finale dell'integrità del backup

Il backup originale non deve essere modificato durante il ripristino.

Se il backup si trova ancora nella posizione originale:

`
sudo bash -c '
cd "$BACKUP" &&
sha256sum -c checksums.sha256
'
`

Tutti i file devono risultare OK.

---

# 24. Problemi comuni

# OpenCL mostra due piattaforme

Controllare:

`
ls -l /etc/OpenCL/vendors/
`

Se è presente il vecchio ICD g13:

`
/etc/OpenCL/vendors/mali-arm64.icd
`

spostarlo fuori dalla directory attiva.

# Vulkan restituisce errore XCB

Utilizzare:

`
VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/mali.json \
vulkaninfo --summary
`

# Il firmware ha SHA-256 diverso

Non riavviare.

Ripristinare:

`
sudo cp -a "$BACKUP/firmware/mali_csffw.bin" \
  /lib/firmware/mali_csffw_g21p0/mali_csffw.bin

sudo ln -sfn /lib/firmware/mali_csffw_g21p0/mali_csffw.bin \
  /lib/firmware/mali_csffw.bin
`

Poi verificare nuovamente lo SHA-256.

# clinfo restituisce zero piattaforme

Controllare:

`
cat /etc/OpenCL/vendors/mali.icd
ls -l /usr/lib/aarch64-linux-gnu/mali/libMaliOpenCL.so.1
ldconfig -p | grep -i mali
`

# Non utilizzare apt autoremove

Il ripristino è offline e non richiede la rimozione automatica dei pacchetti.

---

# 25. Rollback del ripristino

Prima del ripristino è stata creata:

`
/root/mali-before-offline-restore/
`

Se qualcosa non funziona, non modificare kernel, DTB o U-Boot.

Prima fermarsi e verificare:

`
dmesg | grep -i mali
clinfo
VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/mali.json vulkaninfo --summary
`

Il backup originale rimane disponibile per un ulteriore tentativo.

---

# 26. Stato finale desiderato

La configurazione finale deve essere:

`
Kernel Mali       g21p0-01eac0
Firmware          g21p0
Userspace Mali    g24p0-00eac0
GPU               Mali-G610 r0p0
OpenCL            3.0
Vulkan            1.3.276
OpenCL platforms  1
`

Il ripristino utilizza esclusivamente i file contenuti nel backup e non richiede il download del pacchetto Mali g24 originale.