rdk-model-benchmark

Measures inference latency and peak FPS of quantized models on D-Robotics RDK boards.

3|Updated Aug 6, 2026
One-click install
npx skills add https://github.com/D-Robotics/rdk-skills --skill rdk-model-benchmark-d-robotics
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rdk-model-benchmark
Source: https://github.com/D-Robotics/rdk-skills/tree/main/skills/rdk-model-benchmark
Command: npx skills add https://github.com/D-Robotics/rdk-skills --skill rdk-model-benchmark-d-robotics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? It answers how fast a quantized .bin model actually runs on an RDK board by producing reproducible latency and frame-rate benchmarks with the official hrt_model_exec perf tool, instead of relying on guesswork. ## Core Features & Use Cases - Structured Benchmarking: Wraps hrt_model_exec perf and emits a JSON summary with average latency, FPS, and the exact running conditions (core_id, thread count, frame count). - Baseline Mode: Benchmarks a preinstalled official model to check whether a board performs normally when the user has no model of their own. - Peak FPS & Profiling: Sweeps thread counts (1-8) to find peak frame rate and optionally generates per-operator profiler logs to locate slow operators. - Use Case: An engineer asks "how many frames can yolov5s.bin run on my RDK X5?" and receives measured latency/FPS plus the optimal thread count. ## Quick Start Ask the agent to benchmark your model, for example: run a benchmark on /userdata/yolov5s.bin and report its latency and FPS on this board.

Frequently Asked Questions about rdk-model-benchmark

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I benchmark model inference FPS on an RDK board?▼

Run the benchmark script with your quantized model path, for example benchmark.sh --model /userdata/model.bin. It wraps the official hrt_model_exec perf tool and returns average latency in milliseconds and FPS as structured JSON.

How to find the peak frame rate of a BPU model?▼

Sweep the thread count parameter within the official range of 1 to 8 and compare FPS across runs. On dual-BPU boards like RDK X3 use core_id 0 so any core can be used, then report the best thread count found.

Can I check if my RDK board performs normally without my own model?▼

Yes, use baseline mode which automatically picks the first preinstalled model from /app/model/basic or /opt/hobot/model/<soc>/basic. The output marks the model source as baseline, and conclusions apply only to that model.

Does this tool convert ONNX models to bin format?▼

No, model conversion and quantization happen on the development host with the hb_mapper toolchain, not on the board. This skill only benchmarks already-quantized .bin or .hbm models and points you to the official toolchain docs for conversion.

Why do benchmark results vary between runs on the same board?▼

Results are affected by board temperature and background load; near thermal thresholds the board may throttle and distort measurements. Cool the board before rerunning, monitor with diagnostic tools, and note temperature conditions when reporting.

What should I do when hrt_model_exec is not found on the board?▼

Check your RDK OS version or install the tool from the official toolchain release package. The script reports the missing tool explicitly and never substitutes another benchmarking tool in its place.