rdk-board-knowledge

Diagnose RDK board identity, runtime baselines, and on-board failures including S-series xburn flashing.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? RDK developers often misidentify their board (X3/X5/Ultra/S100/S100P/S600) and receive wrong package names, TROS paths, and toolchain advice, or brick S-series boards by flashing with incorrect xburn settings. This Skill grounds every answer in read-only on-board probes and official D-Robotics documentation instead of guesses. ## Core Features & Use Cases - Board identification & baseline confirmation: Runs a read-only probe (scripts/board_probe.sh) reading /sys/class/socinfo and /proc/device-tree/model to map the board to its BPU march, OS/TROS version, default IP, and power requirements. - Failure diagnosis: Routes 59 documented error symptoms (camera SIGABRT, model/BPU OOM, ros2: command not found, NO_PUBKEY, GPIO permissions, under-voltage, SSH timeouts) to exact commands and official doc links, with safe/moderate/dangerous command risk tiers. - S-series flashing: Guides xburn DFU/Fastboot flashing of S100/S100P/S600 with correct product/media settings (S100=emmc, S600=ufs) and per-board DFU entry sequences. - Use Case: A user reports "ros2 launch fails with /opt/tros/humble/setup.bash missing on my S600" — the Skill corrects the premise (S600 is Ubuntu 24.04/Jazzy) and directs them to source /opt/tros/jazzy/setup.bash. ## Quick Start Ask the agent to identify which RDK board you are connected to and diagnose the error message you are seeing before making any system changes.

Frequently Asked Questions about rdk-board-knowledge

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

FAQPage Schema
How do I identify which RDK board I am using?▼

Run the read-only probe `bash scripts/board_probe.sh`, which reads /sys/class/socinfo/board_id, som_name, /proc/device-tree/model, and /etc/version, returning structured JSON. Map the output to X3, X5, Ultra, S100, S100P, or S600 before applying any board-specific advice.

How do I flash an RDK S100 or S600 with xburn?▼

Use xburn over USB in DFU+Fastboot mode for blank or bricked boards. Set product to RDKS100 or RDKS600, media to emmc for S100/S100P or ufs for S600, and type secure. Enter DFU using the per-board switch sequence with the board powered off.

Can a .bin model compiled for RDK X5 run on RDK Ultra?▼

No. X5 uses BPU march bayes-e while Ultra uses bayes; they are distinct marches and compiled artifacts never interchange. Recompile the model with the toolchain --march flag matching the target board.

Why does ros2 launch fail with /opt/tros/humble/setup.bash missing on S600?▼

RDK S600 runs Ubuntu 24.04 with ROS2 Jazzy, so TROS lives at /opt/tros/jazzy with tros-jazzy-* packages. Source /opt/tros/jazzy/setup.bash instead; humble paths apply only to X3, X5, Ultra, S100, and S100P.

Why does my USB camera node crash with exit code -6 on RDK?▼

This is almost always a format mismatch: USB cameras default to YUYV but the node expects MJPEG. Run v4l2-ctl --list-formats-ext to read supported modes, set MJPEG at a listed resolution, and note the RDK default camera node is /dev/video8.

What are the default login accounts on RDK boards?▼

Every official RDK image ships both sunrise/sunrise as the normal user and root/root as the superuser. The desktop autologin uses sunrise, while RDK Studio's SSH channel typically uses root.