commit 7f2170326a458167c32394d611316484302bd509
Author: Fabio <fabio.micheluz@gmail.com>
Date:   Sun Aug 30 16:07:02 2026 +0200

    first commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f3a1eb6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,1337 @@
+Rockchip MPP + FFmpeg su Orange Pi 5 Plus
+
+Guida alla configurazione di Rockchip MPP e FFmpeg-Rockchip su Orange Pi 5 Plus / RK3588, con test di:
+
+- decoding hardware HEVC con "hevc_rkmpp"
+- encoding hardware H.264 con "h264_rkmpp"
+- transcodifica HEVC → H.264
+- output HLS
+- segmenti MPEG-TS
+- audio AAC
+- video verticale con rotazione presente nei metadata MP4
+- verifica finale con "ffprobe"
+
+La configurazione riportata è quella verificata durante i test su Orange Pi 5 Plus.
+
+---
+
+1. Hardware e software
+
+Hardware utilizzato:
+
+Orange Pi 5 Plus
+Rockchip RK3588
+ARM64 / aarch64
+
+La libreria Rockchip MPP supporta la famiglia RK3588.
+
+Il progetto "ffmpeg-rockchip" è una fork di FFmpeg pensata per la pipeline hardware Rockchip MPP/RGA e include decoder ed encoder hardware. Il progetto è indirizzato in particolare a piattaforme RK3588/RK3588S.
+
+Repository:
+
+- MPP: https://github.com/rockchip-linux/mpp
+- FFmpeg-Rockchip: https://github.com/nyanmisaka/ffmpeg-rockchip
+- Wiki FFmpeg-Rockchip: https://github.com/nyanmisaka/ffmpeg-rockchip/wiki
+
+---
+
+2. Controllo iniziale del sistema
+
+Controllare l'architettura:
+
+uname -m
+
+Atteso:
+
+aarch64
+
+Controllare il kernel:
+
+uname -a
+
+Controllare la distribuzione:
+
+cat /etc/os-release
+
+---
+
+3. Controllo dei device Rockchip
+
+Il supporto FFmpeg-Rockchip richiede che l'utente possa accedere ai device hardware Rockchip.
+
+Il progetto indica, tra gli altri:
+
+/dev/dri
+/dev/dma_heap
+/dev/rga
+/dev/mpp_service
+
+e, su alcune configurazioni/kernel:
+
+/dev/iep
+/dev/mpp-service
+/dev/vpu_service
+/dev/vpu-service
+/dev/hevc_service
+/dev/hevc-service
+/dev/rkvdec
+/dev/rkvenc
+
+Controllare:
+
+ls -l /dev/mpp_service
+
+e:
+
+ls -l /dev | grep -Ei 'mpp|rga|rkv|vpu|iep'
+
+Controllare anche:
+
+ls -l /dev/dri
+
+e:
+
+ls -l /dev/dma_heap
+
+---
+
+4. Permessi utente
+
+Aggiungere l'utente ai gruppi normalmente utilizzati per l'accesso ai device video:
+
+sudo usermod -aG video "$USER"
+
+Se sulla distribuzione sono presenti anche gruppi "render":
+
+sudo usermod -aG render "$USER"
+
+Controllare:
+
+groups
+
+Dopo la modifica è consigliato effettuare logout/login.
+
+---
+
+5. Pacchetti necessari
+
+Aggiornare il sistema:
+
+sudo apt update
+sudo apt upgrade -y
+
+Installare gli strumenti di compilazione:
+
+sudo apt install -y \
+  git \
+  build-essential \
+  cmake \
+  pkg-config \
+  yasm \
+  nasm \
+  libdrm-dev \
+  libdrm2 \
+  libnuma-dev \
+  libssl-dev \
+  zlib1g-dev
+
+Per una build FFmpeg più completa possono essere necessari altri pacchetti a seconda dei codec/librerie che si desidera abilitare.
+
+---
+
+6. Installazione Rockchip MPP
+
+6.1 Directory sorgenti
+
+Creare:
+
+sudo mkdir -p /usr/local/src
+sudo chown "$USER":"$USER" /usr/local/src
+
+Entrare:
+
+cd /usr/local/src
+
+---
+
+6.2 Clonare MPP
+
+Repository ufficiale:
+
+https://github.com/rockchip-linux/mpp
+
+Clonare:
+
+cd /usr/local/src
+
+git clone https://github.com/rockchip-linux/mpp.git rockchip-mpp
+
+Entrare nella directory:
+
+cd /usr/local/src/rockchip-mpp
+
+Controllare il commit:
+
+git rev-parse HEAD
+
+È consigliato salvare il commit utilizzato, così una futura reinstallazione può essere riprodotta.
+
+MPP utilizza CMake e il progetto raccomanda una build out-of-source.
+
+---
+
+7. Compilazione MPP
+
+Creare la directory di build:
+
+cd /usr/local/src/rockchip-mpp
+
+mkdir -p build
+cd build
+
+Configurare:
+
+cmake \
+  -DCMAKE_BUILD_TYPE=Release \
+  -DBUILD_SHARED_LIBS=ON \
+  -DBUILD_TEST=OFF \
+  -DCMAKE_INSTALL_PREFIX=/usr/local \
+  ..
+
+Compilare:
+
+make -j"$(nproc)"
+
+Installare:
+
+sudo make install
+
+---
+
+8. Aggiornare il linker
+
+Aggiungere "/usr/local/lib" alla configurazione del linker:
+
+echo '/usr/local/lib' | sudo tee /etc/ld.so.conf.d/local.conf
+
+Aggiornare:
+
+sudo ldconfig
+
+Controllare:
+
+ldconfig -p | grep -i mpp
+
+Cercare anche direttamente:
+
+find /usr/local -name 'librockchip_mpp.so*' -print
+
+---
+
+9. Test della libreria MPP
+
+Controllare il device:
+
+ls -l /dev/mpp_service
+
+Controllare la libreria:
+
+ldconfig -p | grep -i rockchip
+
+Se la build di MPP ha installato gli strumenti di test, possono essere disponibili utility come:
+
+mpp_info_test
+mpp_buffer_test
+mpp_mem_test
+mpp_runtime_test
+mpp_platform_test
+
+La documentazione ufficiale MPP descrive questi strumenti per verificare libreria e ambiente hardware.
+
+Cercarli:
+
+find /usr/local -type f -name 'mpp_*_test' -print
+
+---
+
+10. Installazione FFmpeg-Rockchip
+
+Per la configurazione utilizzata nei test viene utilizzato:
+
+ffmpeg-rockchip
+
+Repository:
+
+https://github.com/nyanmisaka/ffmpeg-rockchip
+
+Il progetto fornisce supporto hardware MPP/RGA direttamente nella CLI FFmpeg.
+
+Entrare nella directory sorgenti:
+
+cd /usr/local/src
+
+Clonare:
+
+git clone https://github.com/nyanmisaka/ffmpeg-rockchip.git
+
+Entrare:
+
+cd /usr/local/src/ffmpeg-rockchip
+
+Controllare il commit:
+
+git rev-parse HEAD
+
+---
+
+11. Configurazione FFmpeg
+
+Prima di compilare verificare che MPP sia visibile a "pkg-config".
+
+pkg-config --modversion rockchip_mpp
+
+Se non viene trovato, cercare il file:
+
+find /usr/local -name 'rockchip_mpp.pc' -print
+
+Impostare eventualmente:
+
+export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:/usr/local/share/pkgconfig:$PKG_CONFIG_PATH
+
+Riprovare:
+
+pkg-config --modversion rockchip_mpp
+
+---
+
+11.1 Configure
+
+Configurazione utilizzata:
+
+./configure \
+  --prefix=/usr/local \
+  --enable-gpl \
+  --enable-version3 \
+  --enable-libdrm \
+  --enable-rkmpp \
+  --enable-rkrga \
+  --enable-shared \
+  --disable-static \
+  --extra-cflags="-I/usr/local/include" \
+  --extra-ldflags="-L/usr/local/lib"
+
+"ffmpeg-rockchip" include il supporto MPP e RGA e documenta le pipeline hardware per decoder, encoder e filtri.
+
+---
+
+12. Compilazione FFmpeg
+
+Compilare:
+
+make -j"$(nproc)"
+
+Installare:
+
+sudo make install
+
+Aggiornare il linker:
+
+sudo ldconfig
+
+---
+
+13. Verificare il binario FFmpeg
+
+Controllare:
+
+which ffmpeg
+
+Il binario che abbiamo utilizzato nei test è:
+
+/usr/local/bin/ffmpeg
+
+Controllare:
+
+/usr/local/bin/ffmpeg -hide_banner -version
+
+Controllare la configurazione:
+
+/usr/local/bin/ffmpeg -hide_banner -buildconf
+
+---
+
+14. Verificare i decoder RKMPP
+
+Eseguire:
+
+/usr/local/bin/ffmpeg \
+  -hide_banner \
+  -decoders | grep -i rkmpp
+
+Tra quelli importanti per il nostro test deve esserci:
+
+hevc_rkmpp
+
+Il progetto FFmpeg-Rockchip documenta esplicitamente "hevc_rkmpp" come decoder HEVC Rockchip MPP.
+
+Controllo diretto:
+
+/usr/local/bin/ffmpeg \
+  -hide_banner \
+  -decoders | grep hevc_rkmpp
+
+---
+
+15. Verificare gli encoder RKMPP
+
+Eseguire:
+
+/usr/local/bin/ffmpeg \
+  -hide_banner \
+  -encoders | grep -i rkmpp
+
+Controllare direttamente H.264:
+
+/usr/local/bin/ffmpeg \
+  -hide_banner \
+  -encoders | grep h264_rkmpp
+
+Deve essere disponibile:
+
+h264_rkmpp
+
+---
+
+16. Verificare i filtri RGA
+
+Se RGA è stato compilato:
+
+/usr/local/bin/ffmpeg \
+  -hide_banner \
+  -filters | grep rkrga
+
+Possibili filtri:
+
+scale_rkrga
+vpp_rkrga
+overlay_rkrga
+
+Il progetto documenta "scale_rkrga" per scaling/conversione formato e "vpp_rkrga" per operazioni come scaling, crop e transpose.
+
+---
+
+17. Primo test: decoder HEVC
+
+Prima di fare HLS conviene verificare il decoder.
+
+Esempio:
+
+/usr/local/bin/ffmpeg \
+  -hide_banner \
+  -loglevel verbose \
+  -c:v hevc_rkmpp \
+  -i input.mp4 \
+  -f null -
+
+Nel log deve comparire una sequenza simile:
+
+Created a RKMPP hardware device
+
+e:
+
+hevc_rkmpp
+
+---
+
+18. Test HEVC → H.264
+
+Testare contemporaneamente decoder e encoder hardware:
+
+/usr/local/bin/ffmpeg \
+  -hide_banner \
+  -loglevel verbose \
+  -y \
+  -c:v hevc_rkmpp \
+  -i input.mp4 \
+  -map 0:v:0 \
+  -c:v h264_rkmpp \
+  -rc_mode CBR \
+  -b:v 5000k \
+  -maxrate 6000k \
+  -bufsize 12000k \
+  -r 30 \
+  -g 90 \
+  -keyint_min 90 \
+  output.mp4
+
+Controllare:
+
+/usr/local/bin/ffprobe \
+  -hide_banner \
+  output.mp4
+
+---
+
+19. Test con il video Xiaomi 13T Pro
+
+Il file utilizzato nei test:
+
+VID_20260221_095917.mp4
+
+Directory:
+
+cd /home/nvme/dockerdata/prove/s120js
+
+Il file presenta:
+
+Video: HEVC
+1920x1080
+~30 fps
+yuv420p
+
+e:
+
+Audio: AAC
+48000 Hz
+stereo
+
+Controllare il video:
+
+/usr/local/bin/ffprobe \
+  -hide_banner \
+  -select_streams v:0 \
+  -show_entries stream=codec_name,width,height,r_frame_rate,pix_fmt \
+  -of default=noprint_wrappers=1 \
+  VID_20260221_095917.mp4
+
+Controllare l'audio:
+
+/usr/local/bin/ffprobe \
+  -hide_banner \
+  -select_streams a:0 \
+  -show_entries stream=codec_name,sample_rate,channels \
+  -of default=noprint_wrappers=1 \
+  VID_20260221_095917.mp4
+
+---
+
+20. Rotazione del video Xiaomi
+
+Il file contiene nei metadata:
+
+Display Matrix: rotation of -90.00 degrees
+
+Durante il test FFmpeg ha rilevato automaticamente la rotazione.
+
+Nel log è comparso:
+
+[transpose] w:1920 h:1080 dir:1 -> w:1080 h:1920
+
+Quindi l'output corretto è:
+
+1080x1920
+
+Non è stato necessario aggiungere manualmente:
+
+-vf transpose=...
+
+Questo è importante.
+
+Per il file Xiaomi testato la pipeline ha quindi fatto:
+
+Input:
+1920x1080 HEVC
+rotation -90°
+
+        ↓
+
+hevc_rkmpp
+
+        ↓
+
+transpose automatico
+
+        ↓
+
+1080x1920
+
+        ↓
+
+h264_rkmpp
+
+        ↓
+
+HLS MPEG-TS
+
+---
+
+21. Pipeline HLS funzionante
+
+Questa è la pipeline che abbiamo verificato con successo.
+
+Creare la directory:
+
+rm -rf /tmp/hls_xiaomi
+mkdir -p /tmp/hls_xiaomi
+
+Eseguire:
+
+/usr/local/bin/ffmpeg \
+  -hide_banner \
+  -loglevel verbose \
+  -y \
+  -probesize 5000000 \
+  -analyzeduration 10000000 \
+  -c:v hevc_rkmpp \
+  -i VID_20260221_095917.mp4 \
+  -map 0:v:0 \
+  -map 0:a:0? \
+  -c:v h264_rkmpp \
+  -rc_mode CBR \
+  -b:v 5000k \
+  -maxrate 6000k \
+  -bufsize 12000k \
+  -r 30 \
+  -g 90 \
+  -keyint_min 90 \
+  -c:a aac \
+  -b:a 160k \
+  -ac 2 \
+  -ar 48000 \
+  -f hls \
+  -hls_time 3 \
+  -hls_list_size 0 \
+  -hls_playlist_type vod \
+  -hls_segment_type mpegts \
+  -hls_segment_filename '/tmp/hls_xiaomi/segment_%05d.ts' \
+  /tmp/hls_xiaomi/master.m3u8
+
+---
+
+22. Struttura corretta dell'output
+
+Dopo l'esecuzione:
+
+ls -lh /tmp/hls_xiaomi
+
+Atteso:
+
+master.m3u8
+segment_00000.ts
+segment_00001.ts
+
+Nel test reale abbiamo ottenuto circa:
+
+master.m3u8       183 bytes
+segment_00000.ts  ~1.9 MB
+segment_00001.ts  ~1.5 MB
+
+---
+
+23. Playlist risultante
+
+Controllare:
+
+cat /tmp/hls_xiaomi/master.m3u8
+
+Nel test è risultata:
+
+#EXTM3U
+#EXT-X-VERSION:3
+#EXT-X-TARGETDURATION:3
+#EXT-X-MEDIA-SEQUENCE:0
+#EXT-X-PLAYLIST-TYPE:VOD
+#EXTINF:3.000000,
+segment_00000.ts
+#EXTINF:2.466667,
+segment_00001.ts
+#EXT-X-ENDLIST
+
+La durata totale è circa:
+
+5.47 secondi
+
+---
+
+24. Verifica HLS con ffprobe
+
+Eseguire:
+
+/usr/local/bin/ffprobe \
+  -hide_banner \
+  /tmp/hls_xiaomi/master.m3u8
+
+Il risultato del test ha mostrato:
+
+Video: h264
+1080x1920
+30 fps
+
+e:
+
+Audio: aac
+48000 Hz
+stereo
+
+Quindi:
+
+HEVC input
+    ↓
+hevc_rkmpp
+    ↓
+h264_rkmpp
+    ↓
+HLS MPEG-TS
+
+ha funzionato correttamente.
+
+---
+
+25. Perché usare "-hls_segment_filename"
+
+Questa opzione è importante:
+
+-hls_segment_filename '/tmp/hls_xiaomi/segment_%05d.ts'
+
+La playlist deve essere:
+
+/tmp/hls_xiaomi/master.m3u8
+
+e i segmenti:
+
+/tmp/hls_xiaomi/segment_00000.ts
+/tmp/hls_xiaomi/segment_00001.ts
+
+La struttura corretta è:
+
+/tmp/hls_xiaomi/
+├── master.m3u8
+├── segment_00000.ts
+└── segment_00001.ts
+
+Non bisogna concatenare accidentalmente il pattern dei segmenti al nome della playlist.
+
+---
+
+26. Configurazione Node.js utilizzata dall'applicazione
+
+La funzione può essere strutturata così:
+
+function buildFfmpegArgs(inputPath, jobDir, useRkmpp) {
+  const master = path.join(jobDir, 'master.m3u8');
+  const segPattern = path.join(jobDir, 'segment_%05d.ts');
+
+  if (useRkmpp) {
+    return [
+      '-hide_banner',
+      '-loglevel',
+      'verbose',
+      '-y',
+
+      // Input probing
+      '-probesize',
+      '5000000',
+
+      '-analyzeduration',
+      '10000000',
+
+      // Rockchip HEVC hardware decoder
+      '-c:v',
+      'hevc_rkmpp',
+
+      '-i',
+      inputPath,
+
+      // Streams
+      '-map',
+      '0:v:0',
+
+      '-map',
+      '0:a:0?',
+
+      // Rockchip H.264 hardware encoder
+      '-c:v',
+      'h264_rkmpp',
+
+      '-rc_mode',
+      'CBR',
+
+      '-b:v',
+      '5000k',
+
+      '-maxrate',
+      '6000k',
+
+      '-bufsize',
+      '12000k',
+
+      // Output framerate
+      '-r',
+      '30',
+
+      // 90 frames = 3 seconds at 30 fps
+      '-g',
+      '90',
+
+      '-keyint_min',
+      '90',
+
+      // Audio
+      '-c:a',
+      'aac',
+
+      '-b:a',
+      '160k',
+
+      '-ac',
+      '2',
+
+      '-ar',
+      '48000',
+
+      // HLS
+      '-f',
+      'hls',
+
+      '-hls_time',
+      '3',
+
+      '-hls_list_size',
+      '0',
+
+      '-hls_playlist_type',
+      'vod',
+
+      '-hls_segment_type',
+      'mpegts',
+
+      '-hls_segment_filename',
+      segPattern,
+
+      master
+    ];
+  }
+}
+
+Questa è la configurazione da mantenere come riferimento per la pipeline che abbiamo testato.
+
+---
+
+27. Significato delle opzioni video
+
+Decoder
+
+-c:v hevc_rkmpp
+
+Utilizza il decoder hardware Rockchip MPP per HEVC.
+
+---
+
+Encoder
+
+-c:v h264_rkmpp
+
+Utilizza l'encoder hardware Rockchip MPP per H.264.
+
+Il progetto FFmpeg-Rockchip espone i codec MPP direttamente alla CLI FFmpeg.
+
+---
+
+CBR
+
+-rc_mode CBR
+
+Target:
+
+-b:v 5000k
+
+Massimo:
+
+-maxrate 6000k
+
+Buffer:
+
+-bufsize 12000k
+
+Durante il test il log MPP ha confermato:
+
+mode cbr
+bps [4687500:5000000:5312500]
+
+---
+
+28. Framerate
+
+-r 30
+
+L'output viene forzato a:
+
+30 fps
+
+---
+
+29. GOP
+
+-g 90
+-keyint_min 90
+
+A 30 fps:
+
+90 / 30 = 3 secondi
+
+Quindi il GOP è coerente con:
+
+-hls_time 3
+
+Questo è particolarmente utile per una segmentazione HLS regolare.
+
+---
+
+30. Audio
+
+Configurazione:
+
+-c:a aac
+-b:a 160k
+-ac 2
+-ar 48000
+
+Output:
+
+AAC
+160 kbps
+stereo
+48000 Hz
+
+Il punto interrogativo:
+
+-map 0:a:0?
+
+rende l'audio opzionale.
+
+Se il file non contiene una traccia audio, FFmpeg continua comunque con il video.
+
+---
+
+31. HLS
+
+Configurazione:
+
+-f hls
+-hls_time 3
+-hls_list_size 0
+-hls_playlist_type vod
+-hls_segment_type mpegts
+
+Significato:
+
+-hls_time 3
+
+segmenti di circa 3 secondi.
+
+-hls_list_size 0
+
+mantiene tutti i segmenti nella playlist.
+
+-hls_playlist_type vod
+
+crea una playlist VOD.
+
+-hls_segment_type mpegts
+
+forza segmenti MPEG-TS.
+
+---
+
+32. Test completo automatico
+
+Dopo una reinstallazione è possibile eseguire questo controllo:
+
+cd /home/nvme/dockerdata/prove/s120js
+
+rm -rf /tmp/hls_test
+mkdir -p /tmp/hls_test
+
+/usr/local/bin/ffmpeg \
+  -hide_banner \
+  -loglevel verbose \
+  -y \
+  -probesize 5000000 \
+  -analyzeduration 10000000 \
+  -c:v hevc_rkmpp \
+  -i VID_20260221_095917.mp4 \
+  -map 0:v:0 \
+  -map 0:a:0? \
+  -c:v h264_rkmpp \
+  -rc_mode CBR \
+  -b:v 5000k \
+  -maxrate 6000k \
+  -bufsize 12000k \
+  -r 30 \
+  -g 90 \
+  -keyint_min 90 \
+  -c:a aac \
+  -b:a 160k \
+  -ac 2 \
+  -ar 48000 \
+  -f hls \
+  -hls_time 3 \
+  -hls_list_size 0 \
+  -hls_playlist_type vod \
+  -hls_segment_type mpegts \
+  -hls_segment_filename '/tmp/hls_test/segment_%05d.ts' \
+  /tmp/hls_test/master.m3u8
+
+Controllare:
+
+echo "=== FILE ==="
+
+ls -lh /tmp/hls_test
+
+echo
+echo "=== PLAYLIST ==="
+
+cat /tmp/hls_test/master.m3u8
+
+echo
+echo "=== SEGMENTI ==="
+
+ls -lh /tmp/hls_test/segment_*.ts
+
+echo
+echo "=== PROBE ==="
+
+/usr/local/bin/ffprobe \
+  -hide_banner \
+  /tmp/hls_test/master.m3u8
+
+---
+
+33. Risultato considerato corretto
+
+Il test è da considerarsi riuscito se:
+
+ffmpeg exit code = 0
+
+e vengono creati:
+
+master.m3u8
+segment_00000.ts
+segment_00001.ts
+
+e "ffprobe" mostra:
+
+Video: h264
+
+con:
+
+1080x1920
+30 fps
+
+e:
+
+Audio: aac
+48000 Hz
+stereo
+
+Nel test reale il video è risultato senza artefatti.
+
+---
+
+34. Warning MPP osservati durante i test
+
+Durante la transcodifica sono comparsi alcuni messaggi MPP come:
+
+mpp_platform: client 4 driver is not ready!
+mpp_platform: client 12 driver is not ready!
+
+e:
+
+mpp_buffer: check buffer found NULL pointer from get_packet_async
+
+oltre a:
+
+mpp_mem_pool: mpp_mem_pool_put_f invalid mem pool ptr
+
+Questi messaggi non hanno impedito il funzionamento della pipeline testata.
+
+Nel test abbiamo infatti ottenuto:
+
+Exiting with exit code 0
+
+e:
+
+164 frames decoded
+0 decode errors
+
+seguiti dalla corretta generazione dei segmenti HLS.
+
+Quindi non bisogna considerare automaticamente questi warning come un fallimento, ma bisogna sempre verificare:
+
+1. exit code di FFmpeg
+2. presenza dei segmenti
+3. validità della playlist
+4. output di "ffprobe"
+5. qualità visiva del video
+
+---
+
+35. Errori da evitare
+
+35.1 Usare un path HLS errato
+
+Non fare:
+
+/tmp/hls_test/master.m3u8mp/hls_test/segment_...
+
+Usare invece:
+
+-hls_segment_filename '/tmp/hls_test/segment_%05d.ts'
+
+e:
+
+/tmp/hls_test/master.m3u8
+
+---
+
+35.2 Aggiungere inutilmente "-hwaccel rkmpp"
+
+La configurazione che abbiamo testato utilizza esplicitamente:
+
+-c:v hevc_rkmpp
+
+per il decoder.
+
+Quindi la configurazione applicativa non deve essere modificata aggiungendo:
+
+-hwaccel rkmpp
+
+solo perché si sta usando MPP.
+
+Il progetto "ffmpeg-rockchip" documenta anche pipeline basate su "-hwaccel rkmpp", ma quella è una modalità diversa dalla pipeline esplicitamente testata qui.
+
+---
+
+35.3 Aggiungere manualmente "transpose"
+
+Nel test Xiaomi FFmpeg ha già rilevato:
+
+Display Matrix: rotation of -90.00 degrees
+
+e ha applicato automaticamente:
+
+1920x1080
+→
+1080x1920
+
+Quindi non aggiungere:
+
+-vf transpose=...
+
+senza prima verificare il comportamento del file specifico.
+
+---
+
+36. Pipeline finale
+
+La configurazione verificata può essere riassunta così:
+
+                 MP4 Xiaomi
+                     │
+                     │
+                     ▼
+              HEVC / H.265
+              1920x1080
+                  ~30 fps
+                     │
+                     ▼
+               hevc_rkmpp
+                     │
+                     │
+             RK3588 hardware
+                     │
+                     ▼
+             rotazione metadata
+                     │
+                     ▼
+               1080x1920
+                     │
+                     ▼
+               h264_rkmpp
+                     │
+              CBR 5000 kbps
+                     │
+                     ▼
+                H.264
+                     │
+          ┌──────────┴──────────┐
+          │                     │
+          ▼                     ▼
+        Video                  AAC
+        H.264                 160 kbps
+          │                     │
+          └──────────┬──────────┘
+                     │
+                     ▼
+                  HLS
+                     │
+                     ▼
+              MPEG-TS segments
+                     │
+          ┌──────────┴──────────┐
+          ▼                     ▼
+ segment_00000.ts        segment_00001.ts
+          │                     │
+          └──────────┬──────────┘
+                     ▼
+                master.m3u8
+
+---
+
+37. Checklist finale
+
+Sistema
+
+- [ ] "uname -m" → "aarch64"
+- [ ] RK3588
+- [ ] "/dev/mpp_service" presente
+- [ ] "/dev/dri" presente
+- [ ] "/dev/dma_heap" presente
+- [ ] permessi utente corretti
+
+MPP
+
+- [ ] repository MPP compilato
+- [ ] "librockchip_mpp.so" installata
+- [ ] "ldconfig" aggiornato
+- [ ] eventuali test MPP funzionanti
+
+FFmpeg
+
+- [ ] "/usr/local/bin/ffmpeg"
+- [ ] "hevc_rkmpp" disponibile
+- [ ] "h264_rkmpp" disponibile
+- [ ] "rkrga" disponibile, se necessario
+
+Transcoding
+
+- [ ] HEVC hardware decode
+- [ ] H.264 hardware encode
+- [ ] CBR 5000k
+- [ ] 30 fps
+- [ ] GOP 90
+- [ ] audio AAC 160k
+- [ ] 48 kHz stereo
+
+HLS
+
+- [ ] "master.m3u8"
+- [ ] "segment_00000.ts"
+- [ ] "segment_00001.ts"
+- [ ] playlist VOD
+- [ ] segmenti MPEG-TS
+- [ ] "ffprobe" legge correttamente HLS
+- [ ] nessun artefatto video
+
+---
+
+38. Versioni da salvare per riproducibilità
+
+Quando la configurazione è funzionante, salvare le versioni:
+
+echo "=== MPP ==="
+cd /usr/local/src/rockchip-mpp
+git rev-parse HEAD
+
+echo
+echo "=== FFmpeg Rockchip ==="
+cd /usr/local/src/ffmpeg-rockchip
+git rev-parse HEAD
+
+echo
+echo "=== FFmpeg ==="
+/usr/local/bin/ffmpeg -hide_banner -version | head -n 3
+
+echo
+echo "=== Kernel ==="
+uname -a
+
+È consigliato conservare questo output insieme alla guida.
+
+In caso di futura reinstallazione, sarà così possibile capire esattamente quale combinazione di:
+
+kernel
+MPP
+FFmpeg-Rockchip
+
+era stata utilizzata nella configurazione funzionante.
+
+---
+
+39. Riferimenti ufficiali
+
+Rockchip MPP
+
+Repository ufficiale:
+
+https://github.com/rockchip-linux/mpp
+
+Documentazione MPP:
+
+https://github.com/rockchip-linux/mpp/blob/develop/doc/Rockchip_Developer_Guide_MPP_EN.md
+
+MPP supporta RK3588 e fornisce API e librerie per encoding, decoding e processing hardware Rockchip.
+
+FFmpeg-Rockchip
+
+Repository:
+
+https://github.com/nyanmisaka/ffmpeg-rockchip
+
+Wiki:
+
+https://github.com/nyanmisaka/ffmpeg-rockchip/wiki
+
+Transcoding:
+
+https://github.com/nyanmisaka/ffmpeg-rockchip/wiki/Video-Transcode
+
+Il progetto documenta pipeline MPP decode + MPP encode e supporto ai decoder/encoder Rockchip.
+
+---
+
+40. Configurazione di riferimento
+
+La configurazione da considerare come baseline funzionante è:
+
+SoC:
+RK3588
+
+Decoder:
+hevc_rkmpp
+
+Encoder:
+h264_rkmpp
+
+Video:
+CBR
+5000 kbps
+maxrate 6000 kbps
+bufsize 12000 kbps
+30 fps
+GOP 90
+
+Audio:
+AAC
+160 kbps
+48 kHz
+stereo
+
+HLS:
+3 secondi
+VOD
+playlist completa
+MPEG-TS
+segment_%05d.ts
+
+Questa è la configurazione utilizzata nei test che hanno prodotto HLS valido e video senza artefatti.