RK 系列硬解调试
面向 Rockchip 板卡(常见如 RK3566 / RK3568 / RK3588 等)在 Olink 上开 rkmpp 硬编 / 硬解时的排查笔记。概念总览见 软编 / 硬编与软解 / 硬解;接入选型见 HomeKit 摄像头接入。
经典协议 + H.265 源时,板子算力紧,最值得开 硬编 + 硬解。界面旁注理想情况类似:硬编·rkmpp+硬解。
这条链路在干什么
米家上来的多为 HEVC(H.265)分包,HomeKit 经典路径要 H.264。在 RK 上启用硬解后,FFmpeg 大致是:
- 硬解:
-hwaccel rkmpp,输出drm_prime(并配合 RGA / AFBC); - 缩放:
scale_rkrga=宽:高(按 HomeKit 协商分辨率压多 slice); - 硬编:
h264_rkmpp输出给「家庭」。
只开硬编、不开硬解时,解码仍走 CPU,缩放也可能是软件 scale=——板卡上 CPU 仍可能偏高。硬解收益在 RK3566 一类上通常更明显(与控制台「硬件解码」说明一致)。
上板前先确认这三件事
当前用的 FFmpeg 真带 rkmpp
探测里应看到rkmpp(h264_rkmpp)· 可用。通用静态包常常没有h264_rkmpp/hevc_rkmpp,探测失败就永远是软编。自行替换二进制见 摄像头 · FFmpeg 目录。内核与用户态齐全
MPP / RGA 设备节点、librga等按发行版装齐。节点或库缺失时,探测编码可能偶发通过,一开真实米家 HEVC 就失败。开关已生效
摄像头管理 → 硬件转码:打开硬件编码,再开硬件解码。改完后重启转码 / 重新打开直播;旁注仍是软编或只有硬编·rkmpp没有+硬解时,说明硬解没挂上。
控制台:用「输入抓取」对照硬解
黑屏、花屏、硬解一开就挂时,先把上行原始码流抓下来,在板上用同一份 FFmpeg 做离线对照——比只看 HomeKit 黑屏快。入口在输入流行的 输入抓取;弹窗示意(可同时看到 codec,如下载 hevc / g711a):

更完整的「转圈排障 + 交给开发者」步骤见 配对后一直转圈。
- 打开 摄像头管理 → 对应输入流 → 输入抓取。
- 抓的是上行 Packet 字节原样拼接(任意视频编码均可),不是预览录像;媒体类型可选仅视频 / 仅音频 / 音视频。
- 时长可选约 3 / 5 / 8 秒,完成后分别下载视频 / 音频文件到本机或板子上。
- 在板上用同一套带 rkmpp 的
ffmpeg对视频文件试硬解(示例,按实际路径调整):
ffmpeg -hide_banner -hwaccel rkmpp -hwaccel_output_format drm_prime \
-i 抓到的视频文件 \
-f null -- 离线就能硬解失败 → 优先查 FFmpeg 构建、MPP/RGA、码流本身(是否缺参数集、分辨率突变等),不是 HomeKit / Olink 会话问题。
- 离线硬解正常,线上失败 → 再查 Olink 侧是否真插入了
-hwaccel、分辨率协商、正在跑的转码是否已按新配置重建。
调试页(FFmpeg 相关隐藏页)可核对:hardware_transcode、hardware_decode、selected_engine、实际转码参数里是否含 rkmpp / -hwaccel / scale_rkrga。
米家 HEVC 为什么容易「坑」硬解
Olink 在写 FFmpeg stdin 前会对米家 HEVC 做组帧(不影响纯 RTSP 播放),主要是为了硬解更稳:
| 点 | 含义 |
|---|---|
| 等参数集 + 首个 IDR | 避免硬解还没看到 VPS/SPS/PPS 就开始解 |
| 开流缓冲若干稳定 AU | 避免刚开流就把「预览低分」分辨率交给硬解,随后主码流 SPS 一变就炸 |
| 预览 → 主码流切换 | 中途出现新 SPS+IDR 时会丢缓冲重来 |
因此:刚开流前一两秒异常、随后才稳定,有时是源侧分辨率切换,不一定是板子坏了。用输入抓取时尽量抓已经出主码流之后的几秒,对照更准。
硬编多 slice 与 HomeKit
h264_rkmpp 等硬编有时会打出多 slice IDR。若首片就冲刷给「家庭」,可能残缺关键帧 → 黑屏 / 一直加载。Olink 侧会对协商分辨率做 RGA 缩放等处理来压制多 slice;若仍异常:
- 先关硬解 / 硬编,回退软编确认「家庭」能出画;
- 再只开硬编、不开硬解对比;
- 确认旁注与调试页里实际编码器仍是
h264_rkmpp,且已重启转码。
建议排查顺序
- 协议是否为经典(直通不走这条转码硬解路径)。
- FFmpeg 探测:
rkmpp是否可用;旁注是否硬编·rkmpp+硬解。 - 输入抓取 → 板上
-hwaccel rkmpp离线试。 - 离线 OK、线上挂:重启转码,看调试页真实 argv。
- 硬路径黑屏 / 花屏:回退软编验证;再换带 MPP 的 FFmpeg 或更新内核 / 固件。
- CPU 仍高:确认硬解真的开着(不是只开了硬编)。