在嵌入式開發(fā)中，RK3588憑借強勁的算力常被用于邊緣計算、工業(yè)視覺等場景，而USB攝像頭作為常見外設，調試過程中難免遇到各類“卡殼”問題。最近我們在RK3588上調試USB攝像頭時，先后遇到分辨率不兼容、預覽靜置崩潰等問題，最終通過針對性排查逐一解決。今天就把完整調試流程分享出來，幫大家少走彎路。

一、第一步：確認攝像頭節(jié)點與支持格式

調試的前提是“摸清”攝像頭的基礎信息——比如它在系統(tǒng)中對應的設備節(jié)點（videoX），以及實際支持的分辨率、格式。

1.定位USB攝像頭節(jié)點

通過sysfs文件系統(tǒng)可快速找到攝像頭對應的節(jié)點，執(zhí)行以下命令：

grep''/sys/class/video4linux/video*/name

命令會輸出所有視頻設備的名稱，比如：

/sys/class/video4linux/video0/name: USB Camera: USB Camera/sys/class/video4linux/video1/name: rkisp-statistics

其中標注“USB Camera”的video0就是我們要調試的USB攝像頭節(jié)點（實際節(jié)點可能是video1、video2等，以實際輸出為準）。

2.查看攝像頭支持的格式與分辨率

確定節(jié)點后，用v4l2-ctl工具查看攝像頭的詳細能力（需提前安裝v4l-utils）：

v4l2-ctl -d /dev/video0 --list-formats-ext

該命令會列出攝像頭支持的像素格式（如YUYV、MJPEG）、分辨率、幀率等關鍵信息。我們此次調試的攝像頭，從輸出中明確看到最大支持3840×2160分辨率，這為后續(xù)排查問題埋下關鍵線索。

二、核心問題1：分辨率不兼容導致報錯

當我們打開相機錄像預覽時，系統(tǒng)直接拋出錯誤：

ECameraSource: Video dimension (4096x3072) is unsupported

明明攝像頭最大只支持3840×2160，為何系統(tǒng)會調用4096×3072的分辨率？問題出在媒體配置文件上。

1.定位媒體配置文件來源

一開始我們嘗試直接拉取設備上的配置文件查看：

adb pull /vendor/etc/media_profiles_V1_0.xml

但對比代碼中的device/google/bonito/media_profiles_V1_0.xml和device/google/crosshatch/media_profiles_V1_0.xml時，發(fā)現(xiàn)差異極大——這兩個文件并非RK3588實際使用的配置。

經過排查發(fā)現(xiàn)：RK3588編譯時會將

/device/rockchip/media_profiles_defaults.xml

拷貝到/vendor/etc/media_profiles_V1_0.xml，也就是說，真正生效的配置文件是media_profiles_defaults.xml

2.修改分辨率配置

打開/device/rockchip/media_profiles_defaults.xml，找到對應錄像配置的VideoProfile節(jié)點，發(fā)現(xiàn)其中錯誤配置了分辨率：

<VideoProfilename="4K"codec="h264"width="4096"height="3072"bitRate="100000000"frameRate="30"/>

將分辨率修改為攝像頭實際支持的3840×2160：

<VideoProfilename="4K"codec="h264"width="3840"height="2160"bitRate="100000000"frameRate="30"/>

修改后重新編譯固件并燒錄，分辨率不兼容的報錯消失。

三、核心問題2：預覽靜置幾分鐘必現(xiàn)崩潰

解決分辨率問題后，新的異常出現(xiàn)：打開相機錄像預覽頁面靜置2-5分鐘，必然會出現(xiàn)崩潰——我們連續(xù)測試5次，100%復現(xiàn)。

1.定位問題根源：媒體處理庫缺失

排查發(fā)現(xiàn)，RK3588處理媒體編解碼依賴libmpp.so庫（Rockchip多媒體處理庫），當前系統(tǒng)中該庫版本存在穩(wěn)定性問題，導致長時間預覽時資源泄漏或編解碼異常。

2.更新媒體庫并驗證

將附件中的最新libmpp.so庫推送到設備指定路徑，覆蓋舊庫：

adb push libmpp.so /vendor/lib/adb reboot # 重啟設備使庫生效

重啟后再次測試：打開預覽頁面靜置10分鐘以上，未出現(xiàn)任何崩潰——靜置異常問題徹底解決。

四、最終驗證與SDK同步

問題解決后，需確保后續(xù)開發(fā)中不再出現(xiàn)類似問題，因此要將更新同步到SDK：

將驗證通過的libmpp.so庫更新到SDK的以下路徑：

vendor/rockchip/common/vpu/lib/libmpp/arm/mpp_dev

同步后重新編譯整個項目，多次測試確認：

1.攝像頭預覽長時間靜置無崩潰；

2.錄像分辨率正常（3840×2160），無報錯；

3.重啟設備后配置與庫均生效。

五、調試總結與避坑要點

1.節(jié)點確認是基礎：遇到攝像頭識別問題，先通過sys/class/video4linux路徑確認節(jié)點，避免操作錯誤設備；

2.配置文件別找錯：RK3588平臺優(yōu)先看/device/rockchip/media_profiles_defaults.xml，而非Google設備的配置文件；

3.庫版本要匹配：媒體相關問題（如預覽崩潰、編解碼失敗），優(yōu)先檢查libmpp.so等核心庫的版本，確保與硬件適配；

4.驗證要“極端”：類似靜置崩潰的問題，需多次長時間測試，避免偶發(fā)問題遺漏。

如果你的RK3588 USB攝像頭調試也遇到類似問題，不妨按照上述步驟排查。若有其他調試疑問，歡迎在評論區(qū)交流～