View source for Cara pake OpenCL di Android

Panduan memperbaiki masalah '''<code>clinfo</code> melaporkan "Number of platforms: 0"''' di [[Termux]] pada perangkat Android dengan GPU Qualcomm Adreno. Masalah ini terjadi karena ICD loader OpenCL sudah terpasang, tetapi belum ada driver OpenCL vendor yang terdaftar ke loader tersebut.

{| class="wikitable"
|+ Lingkungan yang diuji
! Item !! Keterangan
|-
| Perangkat || Redmi Note 12 4G
|-
| SoC / GPU || Snapdragon 685 / Adreno 610
|-
| Sistem operasi || Android (rooted)
|-
| Shell || Termux (arsitektur aarch64)
|}

== Gejala ==

Menjalankan <code>clinfo</code> menghasilkan output berikut:

<syntaxhighlight lang="text">
Number of platforms                               0
ICD loader properties
  ICD loader Name                                 OpenCL ICD Loader
  ICD loader Vendor                               OCL Icd free software
  ICD loader Version                              2.3.5
  ICD loader Profile                              OpenCL 3.1
</syntaxhighlight>

ICD loader terdeteksi normal, tetapi '''jumlah platform 0''' — artinya tidak ada implementasi OpenCL (driver) yang ditemukan oleh loader.

== Penyebab ==

Pada Android, driver OpenCL untuk GPU Adreno '''sudah tersedia''' dalam bentuk <code>libOpenCL.so</code> milik Qualcomm di partisi vendor. Namun, ICD loader bawaan Termux (ocl-icd) tidak mengetahui lokasi driver tersebut karena belum ada berkas ICD (<code>*.icd</code>) yang menunjuk ke sana.

'''Catatan:''' Terdapat '''dua''' berkas bernama <code>libOpenCL.so</code> pada sistem — satu milik Termux (berperan sebagai ''loader'', yaitu yang dipanggil oleh <code>clinfo</code>) dan satu milik Qualcomm (driver asli di <code>/vendor</code>). Yang perlu didaftarkan adalah milik Qualcomm.

== Persyaratan ==

* Perangkat Android dengan GPU Adreno yang mendukung OpenCL (seri Adreno 6xx ke atas umumnya mendukung OpenCL Full Profile).
* Termux dengan paket <code>clinfo</code> dan ICD loader (ocl-icd) sudah terpasang.
* Akses root '''disarankan''' (membantu pada beberapa kasus pemuatan library vendor).

== Solusi ==

=== 1. Temukan lokasi driver ===

<syntaxhighlight lang="bash">
ls -l /vendor/lib64/libOpenCL.so /system/vendor/lib64/libOpenCL.so /system/lib64/libOpenCL.so 2>/dev/null

# Jika ragu, scan menyeluruh:
find /vendor /system -iname 'libOpenCL*.so' 2>/dev/null
</syntaxhighlight>

Catat path yang muncul (umumnya <code>/vendor/lib64/libOpenCL.so</code>).

=== 2. Daftarkan driver sebagai ICD ===

<syntaxhighlight lang="bash">
mkdir -p $PREFIX/etc/OpenCL/vendors
echo /vendor/lib64/libOpenCL.so > $PREFIX/etc/OpenCL/vendors/adreno.icd
</syntaxhighlight>

Sesuaikan path dengan hasil langkah 1.

=== 3. Arahkan linker ke library dependensi ===

Driver vendor membutuhkan berkas <code>.so</code> lain yang berada di <code>/vendor/lib64</code>:

<syntaxhighlight lang="bash">
export LD_LIBRARY_PATH=/vendor/lib64:/system/vendor/lib64:/system/lib64${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}
</syntaxhighlight>

=== 4. Uji ===

<syntaxhighlight lang="bash">
clinfo | head -20
</syntaxhighlight>

Jika berhasil, '''Number of platforms''' menjadi 1 dan muncul nama seperti <code>QUALCOMM Snapdragon</code> / <code>Adreno (TM) 610</code>.

=== 5. Membuat pengaturan permanen ===

Tambahkan ke <code>~/.bashrc</code> agar tidak perlu mengetik ulang setiap membuka Termux:

<syntaxhighlight lang="bash">
echo 'export LD_LIBRARY_PATH=/vendor/lib64:/system/vendor/lib64:/system/lib64${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}' >> ~/.bashrc
</syntaxhighlight>

== Troubleshooting ==

Jika platform masih 0, aktifkan mode debug pada loader untuk melihat penyebab kegagalan:

<syntaxhighlight lang="bash">
OCL_ICD_DEBUG=15 clinfo 2>&1 | head -40
</syntaxhighlight>

Berdasarkan pesan yang muncul:

; Berkas ICD seperti tidak terbaca (platform tetap 0)
: Paksa direktori vendor lalu ulangi pengujian: <code>export OCL_ICD_VENDORS=$PREFIX/etc/OpenCL/vendors</code>

; <code>... not accessible for the namespace "(default)"</code>
: Android memblokir pemuatan library vendor dari aplikasi. Karena perangkat sudah root, jalankan sebagai root: pasang <code>tsu</code> melalui <code>pkg install tsu</code>, lalu jalankan <code>sudo env LD_LIBRARY_PATH=/vendor/lib64:/system/lib64 clinfo</code>.

; <code>cannot locate symbol</code> / <code>undefined reference</code>
: Ada dependensi yang kurang. Periksa dengan <code>readelf -d /vendor/lib64/libOpenCL.so | grep NEEDED</code> (perlu <code>pkg install binutils</code>), lalu tambahkan folder library terkait (mis. <code>/odm/lib64</code>) ke <code>LD_LIBRARY_PATH</code>.

; Arsitektur tidak cocok
: Pastikan Termux 64-bit — <code>dpkg --print-architecture</code> harus menghasilkan <code>aarch64</code> — agar sesuai dengan library di <code>lib64</code>. Jika Termux 32-bit, gunakan <code>/vendor/lib/libOpenCL.so</code> (tanpa <code>64</code>).

=== Memakai berkas ICD bawaan ROM ===

Beberapa ROM sudah menyertakan berkas ICD sendiri yang menunjuk ke driver asli:

<syntaxhighlight lang="bash">
cat /vendor/etc/OpenCL/vendors/*.icd /system/etc/OpenCL/vendors/*.icd 2>/dev/null
</syntaxhighlight>

Jika ada isinya, gunakan path tersebut pada langkah 2.

== Catatan ==

* Jika perintah <code>find</code> pada langkah 1 sama sekali tidak menemukan <code>libOpenCL.so</code>, kemungkinan ROM (umumnya custom ROM) telah membuang blob OpenCL. Berkas tersebut perlu ditarik manual dari stock ROM (MIUI/HyperOS).
* GPU seri Adreno 6xx mendukung OpenCL Full Profile; performa nyata bergantung pada model GPU dan versi driver.