kb_eval_docs/kb-eval/eval_dataset.json
peng01.guo 15b3337339 RDK 知识库数据集:论坛帖子导出 + 文档中心 Markdown + RAG 评测集(352 条)及全量生产管线
- forum-solved-export: 3539 个已解决话题(问题+全部对话+采纳回答),含索引
- rdk-docs-export: 21 个文档子站 ~3430 篇 Markdown(源码仓库/抓取/反解析三种方式)
- kb-eval: 352 条 RAG 检索评测集(答案全部锚定文档、多轮子代理交叉审计),
  含检索/出题/校验工具与子代理提示词模板,支持增量扩产
- pipeline: 论坛枚举导出、文档抓取反解析、覆盖率统计全部脚本(可重跑)
2026-09-18 17:14:40 +08:00

3480 lines
260 KiB
JSON
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[
{
"question": "RDK X3 开发板的 MIPI CSI 摄像头接口 CAM0、CAM1、CAM2 分别是几 lane?",
"expected_answer": "CAM0 为 2lane,CAM1 为 4lane,CAM2 为 2lane(见 RDK X3 硬件资源介绍中的接口列表)。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/hardware_introduction/rdk_x3.md"
],
"difficulty": "简单",
"source_topic": 35432
},
{
"question": "RDK X5 官方认证配件清单包含哪些类别?在哪里查适配的摄像头型号?",
"expected_answer": "认证配件清单指经 D-Robotics 官方认证、可适配 RDK X5 开发板的第三方配件,包含基础配件(电源、外壳、散热器)、摄像头、显示屏等类别,清单内容会不定期更新,可在 RDK X5 硬件开发文档的「配件清单」页面查询。",
"expected_docs": [
"rdk_x_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/accessory.md",
"rdk_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/accessory.md"
],
"difficulty": "简单",
"source_topic": 28250
},
{
"question": "RDK X5 的 PWM 支持多大的频率范围?想输出 10kHz 的 PWM 信号该怎么设置?",
"expected_answer": "X5 有两类控制器:标准 PWM 共 4 组、每组 2 路(8 个输出),默认支持频率 0.05Hz - 1MHz,周期有效时间 1us 到 20s;输出 10kHz 信号即把周期配置为 100us。另一类 LPWM(1Hz 到 1MHz、脉宽 1us~4ms)是为 Sensor 同步曝光设计的,不是通用 PWM,单纯 PWM 功能建议使用标准 PWM。",
"expected_docs": [
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/driver_development_x5/driver_pwm.md",
"rdk_doc/docs/07_Advanced_development/02_linux_development/driver_development_x5/driver_pwm.md",
"x5_sdk_doc/linux_development/driver_develop_guide/29-PWM_Driver_Debug_Guide.md"
],
"difficulty": "中等",
"source_topic": 28926
},
{
"question": "RDK S100 的温控框架中有哪些降温设备(cooling device)?",
"expected_answer": "Thermal 框架中的降温设备被抽象为 Thermal Cooling Device,包括 CPU、BPU 和风扇:CPU/BPU 等设备通过调频降温,风扇通过控制转速降温。S100 上另有 5 个 thermal zone(thermal_zone0~thermal_zone4),分别绑定 5 个温度传感器。",
"expected_docs": [
"rdk_s_doc/docs/02_System_configuration/04_frequency_management.md",
"rdk_doc/docs_s/02_System_configuration/04_frequency_management.md"
],
"difficulty": "简单",
"source_topic": 35392
},
{
"question": "RDK X5 上通过 HBN 框架手动控制摄像头曝光,应该调用什么接口?",
"expected_answer": "使用 hbn_isp_set_exposure_attr 设置 ISP 的曝光属性,hbn_isp_get_exposure_attr 获取曝光属性;还可用 hbn_isp_get_module_control 获取 ISP 模块的控制状态。曝光可配置为手动(HBN_ISP_MODE_MANUAL)或自动模式。",
"expected_docs": [
"x5_sdk_doc/multimedia_development/5-ISP_Tune_API_zh_CN.md",
"x5_sdk_doc/samples/sample_isp.md"
],
"difficulty": "中等",
"source_topic": 35662
},
{
"question": "RDK X5 调试摄像头时想查看每一帧的实际曝光情况,有哪些方法?",
"expected_answer": "① 打开 ISP 调试日志:echo 31 31 31 > /sys/kernel/debug/isp/log,之后从日志中查看 AE 相关信息;② 连接 VTunerClient 调试工具查看并验证 2A(AE/AWB)状态。Camera Sensor FAQ 中还提供曝光行数(帧长)、gain 索引与增益倍率对照等定位手段。",
"expected_docs": [
"x5_sdk_doc/multimedia_development/2-Multimedia_Debugging_Guide.md",
"x5_sdk_doc/multimedia_development/isp_tuning_guide/Camera_sensor_FAQ.md"
],
"difficulty": "困难",
"source_topic": 33700
},
{
"question": "TROS 的 ROS2 功能包运行异常,如何定位出问题的节点并收集日志?",
"expected_answer": "TROS 功能包的 launch 文件通常位于 /opt/tros/<tros_distro>/share/<package_name>/launch/ 目录(例如 /opt/tros/humble/share/mipi_cam/launch/),可将日志级别调为 debug 重新运行以定位问题节点;ROS2 日志存储在 ~/.ros/log/ 或 /root/.ros/log/,排查前先执行 rm -rf ~/.ros/log/* 清空旧日志再收集最新日志。",
"expected_docs": [
"rdk_x_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_s_doc/docs/08_FAQ/06_tros_ros.md"
],
"difficulty": "中等",
"source_topic": 28093
},
{
"question": "在 RDK 板卡上用 apt 安装 TROS 软件包时提示无法定位软件包,应该检查什么?",
"expected_answer": "确认系统的 apt 源中包含地平线(D-Robotics)软件源 sunrise.horizon.cc,执行 apt update 后再安装;同时建议将系统和所有 TROS 软件包升级到最新版本,许多问题在新版本中已修复。",
"expected_docs": [
"rdk_x_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "简单",
"source_topic": 28926
},
{
"question": "板卡上跑多路视频推理时报 hbmem_alloc failed、Fail to do ION_IOC_ALLOC 无法分配内存,如何解决?",
"expected_answer": "扩大设备树中 ion_cma 节点预留的共享内存:先用 dtc 把 dtb 反编译成 dts(dtc -I dtb -O dts -o xxx.dts /boot/hobot/xxx.dtb),找到 ion_cma 节点,把 alloc-ranges 和 size 属性(如默认的 0x2a000000)修改为需要的内存大小,再重新编译烧录设备树。",
"expected_docs": [
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/driver_development/driver_bpu_mem_dev.md",
"rdk_doc/docs/07_Advanced_development/02_linux_development/driver_development/driver_bpu_mem_dev.md"
],
"difficulty": "中等",
"source_topic": 26134
},
{
"question": "使用 HAT 训练模型时意外中断,如何从上次的 checkpoint 恢复训练?需要配置哪些字段?",
"expected_answer": "在 config 的 {stage}_trainer 中配置恢复相关字段:完全恢复中断训练(恢复 optimizer、LR、epoch、step 等所有状态)配置 resume_optimizer 即可;只恢复 optimizer 和 LR 做微调需配置 resume_optimizer 并将 resume_epoch_or_step 设为 False(epoch/step 从 0 开始);只加载模型参数则在 model_convert_pipeline 中配置 LoadCheckpoint,并设置 resume_optimizer=False、resume_epoch_or_step=False。",
"expected_docs": [
"oe_s_doc/guide/advanced_content/hat/tutorials/quantization/quantization.md",
"oe_s_doc/guide/advanced_content/hat/hat_faq.md"
],
"difficulty": "中等",
"source_topic": 26142
},
{
"question": "RDK X5 算法工具链在开发机(x86)上如何部署运行环境?",
"expected_answer": "X5 算法工具链支持使用 Docker 部署方式在开发机上部署环境,官方推荐使用标准交付的工具链 Docker 镜像;开发机还需按文档准备 CUDA 等依赖。",
"expected_docs": [
"x5_sdk_doc/toolchain_development/intermediate/environment_config.md"
],
"difficulty": "简单",
"source_topic": 28810
},
{
"question": "RDK S100 上 MIPI 摄像头图像噪声大,想开 ynr 降噪,S100 的 YNR 模块支持什么场景?",
"expected_answer": "YNR 是 yuv 域的降噪模块(Digital Noise Reduction),支持 2DNR 与 3DNR 模式。S100 上共有一个 YNR 模块(YNR1),只支持 ISP1-online-YNR1-online-PYM1 场景;S600 则有 YNR0-3 四个模块,只支持 isp-online-ynr-online-pym 场景。",
"expected_docs": [
"rdk_s_doc/docs/07_Advanced_development/03_multimedia_development/01_multimedia_development/01_camsys.md",
"rdk_doc/docs_s/07_Advanced_development/03_multimedia_development/01_S100/01_camsys.md"
],
"difficulty": "困难",
"source_topic": 32857
},
{
"question": "X5 ISP 调优中 A3DNR 的噪声模型参数 noisemodelA 和 noisemodelB 分别是什么?取值范围多少?",
"expected_answer": "noiseModelEn 用于使能噪声模型曲线;noisemodelA 是噪声模型曲线的斜率(标定数据),取值范围 0.1~100,默认 0.3;noisemodelB 是噪声模型曲线的偏移,取值范围 0.1~10000,默认 1.5。两者都是驱动计算噪声曲线使用的标定数据,3DNR 异常时需检查当前场景增益下这些值是否配置正确。",
"expected_docs": [
"x5_sdk_doc/multimedia_development/isp_tuning_guide/isp_tuning/isp_tuning.md"
],
"difficulty": "简单",
"source_topic": 33786
},
{
"question": "RDK 上有 YOLOv8 的 TROS 部署示例吗?在哪里可以找到?",
"expected_answer": "有。TROS Boxs 算法包文档中提供 YOLOv8 相关示例:分割类有 yolov8_seg 示例,检测类 YOLO 系列示例(yolo)也包含 YOLOv8 的部署说明,可在 RDK 机器人开发 Boxs 文档中查看。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/segmentation/yolov8_seg.md",
"rdk_doc/docs/05_Robot_development/03_boxs/detection/yolo.md"
],
"difficulty": "简单",
"source_topic": 28524
},
{
"question": "PTQ 量化后的模型板端推理精度差、效果异常,工具链建议按什么思路排查?",
"expected_answer": "按精度损失程度分情况处理:损失明显(大于 4%)通常是 yaml 配置不当、校验数据集不均衡导致,按文档建议逐一排查;损失较小(1.5%~3%)多为模型自身敏感,可使用精度调优工具调优;仍不满足预期时再用精度 debug 工具(accuracy_debug)进一步分析。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/tune_content/accuracy_tune.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/accuracy_debug.md"
],
"difficulty": "困难",
"source_topic": 29122
},
{
"question": "PTQ 校准方法选 max 时,max_percentile 参数的取值范围、默认值是什么?",
"expected_answer": "max_percentile 取值范围 0.5~1.0,默认 1.0,仅在 calibration_type 为 max 时有效,用于调整 max 校准的截取点,常用配置有 0.99999/0.99995/0.99990/0.99950/0.99900。官方建议先尝试 calibration_type 配置 default,精度不满足预期时再调整该参数。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md",
"oe_x3_doc/oe_mapper/source/faststart/quickstart.md"
],
"difficulty": "简单",
"source_topic": 35331
},
{
"question": "使用 HAT 训练自己的数据集时,数据是如何加载的?如何打包成 lmdb 格式?",
"expected_answer": "数据加载通过在 config 中调用 dataloader 实现,dataloader 加载的 dataset 由 Coco 类返回,Coco 类读取的是 lmdb 格式的打包数据,该数据通过调用 packer 接口(如 CocoDetectionPacker 将 CocoDetection 返回的 image/label 打包成 lmdb、mxrecord 格式)生成。实现自定义 dataset 需要对相关类重写,根据数据集 format 重写 __getitem()__。",
"expected_docs": [
"oe_s_doc/guide/advanced_content/hat/hat_faq.md",
"oe_s_doc/guide/advanced_content/hat/examples/pointpillars.md"
],
"difficulty": "困难",
"source_topic": 25384
},
{
"question": "RDK 板卡上 I2C 先写寄存器地址再连续读数据(中间不发 STOP、用重复起始位),应该用哪种方式?",
"expected_answer": "应使用 I2C_RDWR 方式(组合 struct i2c_msg 的 ioctl I2C_RDWR 传输),而不是 I2C_SMBUS。具体用法参考 I2C 调试指南。",
"expected_docs": [
"x5_sdk_doc/linux_development/driver_develop_guide/9-I2C_Debug_Guide_zh_CN.md"
],
"difficulty": "中等",
"source_topic": 34920
},
{
"question": "手上有 PyTorch/ONNX 模型,想转成 RDK BPU 能跑的模型,官方有什么参考资源?",
"expected_answer": "RDK Model Zoo 收录覆盖图像分类、目标检测、实例分割、姿态估计、OCR、多模态等领域的 BPU 可运行模型,并提供从原始模型(PyTorch/ONNX)→ 定点量化转换 → 推理运行 → 结果解析 → 示例验证的完整参考实现,可参照对应模型的教程完成转换。",
"expected_docs": [
"rdk_x_doc/docs/04_model_zoo_intro.md",
"rdk_doc/docs/04_Algorithm_Application/01_model_zoo/model_zoo_intro.md",
"rdk_s_doc/docs/04_Algorithm_Application/01_model_zoo_intro.md"
],
"difficulty": "简单",
"source_topic": 35055
},
{
"question": "RDK S100/S600 想接 GMSL 相机,官方提供了什么方案?",
"expected_answer": "官方提供相机扩展板方案(如 RDK S100 Camera Expansion Board),用于接入 GMSL 相机(含单目、双目深度相机等);具体支持的相机型号和接口说明可查看 S100/S600 文档中的相机扩展板介绍及认证配件清单(配件清单包含电源、外壳、散热器、摄像头、显示屏等类别)。",
"expected_docs": [
"rdk_s_doc/docs/01_Quick_start/01_hardware_introduction/01_rdk_s100/02_rdk_s100_camera_expansion_board/01_rdk_s100_camera_expansion_board.md",
"rdk_s_doc/docs/07_Advanced_development/01_hardware_development/02_accessory.md",
"rdk_s_doc/docs/07_Advanced_development/03_multimedia_development/01_multimedia_development/02_camera_bringup.md"
],
"difficulty": "中等",
"source_topic": 35413
},
{
"question": "RDK 开发板上如何对 C/C++ 程序做断点/单步调试?断点不生效怎么排查?",
"expected_answer": "可远程调试时需确保 GDBserver 正确启动并监听正确的端口(注意网络配置与防火墙)。断点不生效或被跳过时,用 info breakpoints 查看断点状态,重新编译时使用较低的优化级别,并确保加载共享库符号。",
"expected_docs": [
"x5_sdk_doc/linux_development/system_debug/gdb.md"
],
"difficulty": "中等",
"source_topic": 35573
},
{
"question": "模型 BPU 量化成 int8 后精度明显下降,如何验证是量化问题还是前处理问题?",
"expected_answer": "标准排查流程:① 用原生 ONNXRuntime 推理原始浮点 ONNX 建立 baseline,确保前后处理逻辑正确;② 在 yaml 中将输入配置为 NCHW(FeatureMap 模式)并设置 no_preprocess,使编译出的模型不包含任何硬件前处理;③ 在开发机用工具链提供的 hb_onnxruntime 加载 quantized_model.onnx 对比推理结果;④ 确认量化模型符合预期后,再加入 NV12/RGB 等硬件前处理加速配置。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_workflow.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md",
"oe_x3_doc/oe_mapper/source/faststart/quickstart.md"
],
"difficulty": "困难",
"source_topic": 33385
},
{
"question": "RDK S100/S600 的算法工具链(OpenExplorer)安装包和 Docker 镜像从哪里下载?",
"expected_answer": "通过官方阿里云 OSS 下载工具链包,例如 wget https://d-robotics-aitoolchain.oss-cn-beijing.aliyuncs.com/oe/3.7.0/oe-package-3.7.0-s100-s600.tgz;Docker 镜像从官方私有 Registry 获取:docker login registry.d-robotics.cc 后 docker pull 对应版本的 ai_toolchain 镜像。旧的 FTP 下载地址已不再维护。",
"expected_docs": [
"rdk_s_doc/docs/07_Advanced_development/04_toolchain_development/01_algorithm_toolchain/01_overview.md",
"rdk_doc/docs_s/07_Advanced_development/04_toolchain_development/01_overview.md"
],
"difficulty": "简单",
"source_topic": 35343
},
{
"question": "RDK X5/S100 上想本地体验大模型,TROS 有提供现成的应用吗?",
"expected_answer": "有。TROS Apps 提供「视觉语音盒子」应用(hobot_llamacpp,代码仓库 github.com/D-Robotics/hobot_llamacpp),支持在 RDK X5/X5 Module 和 RDK S100/S100P(Ubuntu 22.04 Humble)上体验 ASR + VLM/LLM + TTS 全链路。",
"expected_docs": [
"tros_doc/docs/04_apps/hobot_llamacpp.md",
"rdk_doc/docs/05_Robot_development/04_apps/hobot_llamacpp.md",
"rdk_doc/docs/05_Robot_development/03_boxs/generate/hobot_llamacpp.md"
],
"difficulty": "简单",
"source_topic": 34682
},
{
"question": "RDK 各产品线的系统镜像、源码、工具链等资源在哪里统一查看下载?",
"expected_answer": "RDK 文档的「1.7 下载资源汇总」页面汇总了 D-Robotics RDK 套件的相关下载资源,涵盖 RDK X3(旭日 X3 派)、RDK X3 Module、RDK X5、RDK X5 Module 以及 RDK Ultra 等系列产品的各类资源下载目录。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/download.md",
"rdk_doc/docs/01_Quick_start/download.md",
"rdk_doc/docs/RDK.md"
],
"difficulty": "简单",
"source_topic": 33747
},
{
"question": "X5 ISP 的 LSC(镜头阴影校正)参数如何标定?",
"expected_answer": "使用 X5 ISP 标定工具(Calibration Tool):在主窗口点击 Lens Shade Correction 打开 LSC Parameter 页面,按 Load Image 方式加载测试图像并确认 RGB Bayer Pattern,使用默认设置即可推导 LSC 参数,点击 Start 并指定输出文件名后工具计算参数并写入文本文件。注意 X5 ISP 必须配置为所需的图像分辨率,每个支持的分辨率需要不同的 LSC 参数,且需在初始化和更改传感器分辨率后写入 ISP 寄存器。",
"expected_docs": [
"x5_sdk_doc/multimedia_development/isp_tuning_guide/calibration_tool_guide/calibration_tool_guide.md",
"x5_sdk_doc/multimedia_development/isp_tuning_guide/isp_tuning/isp_tuning.md",
"x5_sdk_doc/multimedia_development/5-ISP_Tune_API_zh_CN.md"
],
"difficulty": "简单",
"source_topic": 33421
},
{
"question": "RDK S100 有几路 CAN 接口?使用时有什么注意事项?",
"expected_answer": "RDK S100 的 CAN 接口为 CAN5、CAN6、CAN7、CAN8、CAN9 共 5 路。使用 MCU 100-Pin Connector 上的外设 IO(如 CAN5_TX_3V3、CAN6_TX_3V3 等)时,必须保证外设对应管脚上电默认高/低状态与 Pin 定义文件中的 Pull Up/Down 状态保持一致。",
"expected_docs": [
"rdk_s_doc/docs/01_Quick_start/01_hardware_introduction/01_rdk_s100/01_rdk_s100.md",
"rdk_doc/docs_s/01_Quick_start/01_hardware_introduction/01_rdk_s100.md"
],
"difficulty": "中等",
"source_topic": 35623
},
{
"question": "RDK 的 40pin 接口用 Python 怎么配置 GPIO 输入/输出?",
"expected_answer": "使用 Hobot.GPIO 库(API 风格与 RPi.GPIO 一致):GPIO.setmode(GPIO.BOARD) 指定物理引脚编号,GPIO.setup(channel, GPIO.IN) 配置输入、GPIO.setup(channel, GPIO.OUT) 配置输出(可用 initial=GPIO.HIGH 指定初始电平),GPIO.input() 读取电平、GPIO.output() 输出电平,最后 GPIO.cleanup() 释放。",
"expected_docs": [
"rdk_x_doc/docs/03_Basic_Application/01_40pin_user_sample/gpio.md",
"rdk_doc/docs/03_Basic_Application/01_40pin_user_sample/gpio.md",
"rdk_doc/docs_s/03_Basic_Application/03_40pin_user_guide/02_gpio.md"
],
"difficulty": "简单",
"source_topic": 28862
},
{
"question": "RDK S100 的 Type-C 接口可以配置成哪些 USB Gadget 模式?",
"expected_answer": "RDK S100 的 USB 2.0 Type-C 接口支持配置为 ADB 模式和 RNDIS 模式(用于虚拟网卡等),具体配置方法见 S100 文档的 USB Gadget 功能使用章节,其中也说明了硬件限制条件。",
"expected_docs": [
"rdk_s_doc/docs/07_Advanced_development/02_linux_development/08_usb_gadget.md",
"rdk_doc/docs_s/07_Advanced_development/02_linux_development/05_hardware_unit_test/09-usb_performance.md"
],
"difficulty": "中等",
"source_topic": 35391
},
{
"question": "RDK 平台上能用硬件加速做 JPEG 单张图片的编解码吗?用什么工具?",
"expected_answer": "可以。TROS 的 hobot_codec 功能包采用硬件单元加速 MJPEG/H264/H265 与 BGR8/RGB8/NV12 格式之间的转换(X86 平台仅支持 MJPEG 与 BGR8/RGB8/NV12 之间的转换)。例如配置 codec_in_format:=nv12、codec_out_format:=jpeg,即可从摄像头获取 NV12 图像压缩编码为 JPEG 并在 Web 端预览。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/02_quick_demo/hobot_codec.md",
"tros_doc/docs/02_quick_demo/hobot_codec.md",
"rdk_doc/docs/08_FAQ/03_applications_and_examples.md"
],
"difficulty": "简单",
"source_topic": 26571
},
{
"question": "用 hb_mapper 转换 ONNX 模型时无法识别模型的输入尺寸,怎么处理?",
"expected_answer": "在 yaml 配置的 input_parameters 部分显式配置 input_shape 参数(如 '1x3x224x224',各维度以 x 连接)。原始浮点模型只有一个输入节点时可不配置(工具会自动读取模型文件中的尺寸信息);模型为多输入节点时必须配置,且节点顺序需与 input_name 中的顺序严格一致。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md",
"x5_sdk_doc/toolchain_development/intermediate/ptq_process.md"
],
"difficulty": "中等",
"source_topic": 28899
},
{
"question": "RDK X5 双目深度估计(StereoNet)功能的启动脚本在哪里?",
"expected_answer": "run_stereo.sh 脚本已内置在 hobot_stereonet 功能包中:Humble 环境从 /opt/tros/humble/share/hobot_stereonet/script/run_stereo.sh 拷贝出来运行,Jazzy 环境对应 /opt/tros/jazzy/share/hobot_stereonet/script/run_stereo.sh。",
"expected_docs": [
"tros_doc/docs/03_boxs/spatial/hobot_stereonet.md",
"rdk_doc/docs/05_Robot_development/03_boxs/spatial/hobot_stereonet.md",
"rdk_doc/docs/05_Robot_development/03_boxs/spatial/stereo_imu_cam.md"
],
"difficulty": "简单",
"source_topic": 35045
},
{
"question": "RDK S100 的大模型工具链(D-Robotics_LLM_S100)目前支持哪些模型?",
"expected_answer": "LLM 方面支持:DeepSeek-R1-Distill-Qwen(1.5B 和 7B,支持模型量化、简单会话、多轮对话、PPL 评估)、InternLM2-1.8B(量化、简单会话、PPL 评估)、Qwen2.5-1.5B/7B 及对应 Instruct 版本(量化、会话、多轮对话仅 Instruct、PPL 评估);多模态支持 Qwen2.5-Omni-3B(模型量化、离线运行、在线运行)。",
"expected_docs": [
"rdk_s_doc/docs/07_Advanced_development/04_toolchain_development/02_LLM_Toolchain/01_rdk_s100/01_s100_LLM_Toolchain.md",
"oe_llm_s100p_doc/guide/preface/develop_process.md",
"oe_llm_s100p_doc/guide/quickstart/S100P.md"
],
"difficulty": "中等",
"source_topic": 35126
},
{
"question": "RDK IMU 模组用的什么传感器芯片?量程和精度如何?",
"expected_answer": "RDK IMU 模组采用 Bosch Sensortec 的 6 轴惯性测量单元 BMI088,包含一个三轴陀螺仪和一个三轴加速度计,均为 16 位精度;具备 ±24g 加速度和 ±2000°/s 角速度的扩展量程,出厂已校准,适合无人机、机器人等强震动环境。",
"expected_docs": [
"accessories_doc/docs/03_imu_module/01_product_overview.md",
"accessories_bmi088_doc/docs/introduction.md"
],
"difficulty": "简单",
"source_topic": 35389
},
{
"question": "RDK X5 的 USB 2.0 Type-C 和 USB 3.0 Type-A 接口分别工作在什么模式?",
"expected_answer": "USB 2.0 Type-C(接口 3)为 USB Device 模式,用于连接主机实现 ADB、Fastboot、系统烧录等功能;USB 3.0 Type-A 为 USB Host 模式(通过 HUB 扩展出 4 个 USB 端口),用于接入 USB 3.0 外设。模式由硬件设计决定。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/hardware_introduction/rdk_x5.md"
],
"difficulty": "简单",
"source_topic": 34481
},
{
"question": "RDK 双目深度相机 GS130W 支持哪些开发板?使用说明在哪里?",
"expected_answer": "RDK 配件文档(accessories)已收录双目摄像头模组 GS130W / GS130WI 的使用说明,覆盖选型、安装、点亮与二次开发。GS130W 与 GS130WI 均适配 RDK X5、RDK X5 Module、RDK S100、RDK S100P、RDK S600。",
"expected_docs": [
"accessories_doc/docs/01_accessories.md",
"accessories_stereo_camera_doc/docs/02_stereo_camera_gs130wi/02_installation.md",
"accessories_stereo_camera_doc/docs/02_stereo_camera_gs130wi/03_quick_start.md"
],
"difficulty": "简单",
"source_topic": 35500
},
{
"question": "在开发机上如何用 HB_ONNXRuntime 加载模型做推理验证?",
"expected_answer": "使用 horizon_tc_ui 包:from horizon_tc_ui import HB_ONNXRuntime;用 HB_ONNXRuntime(model_file=\"model.onnx\") 创建会话;通过 sess.input_names / sess.output_names 获取输入输出节点;构造 {input_names[0]: input_data} 后调用 sess.run(output_names, input_info),返回值是与 output_names 一一对应的 list。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_onnxruntime.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_workflow.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_usage/accuracy_evaluation.md"
],
"difficulty": "简单",
"source_topic": 28129
},
{
"question": "RDK Model Zoo 的模型在不同平台上分别用什么推理接口运行?",
"expected_answer": "RDK X5 使用 hbm_runtime(板端系统自带);RDK X3 使用 bpu_infer_lib_x3 或 hobot_dnn 的 pyeasy_dnn(手动安装/板端自带);RDK S 系列使用 hbm_runtime;RDK X5 历史分支使用 bpu_infer_lib_x5 / hobot_dnn.pyeasy_dnn。详见 Model Zoo 推理接口参考文档。",
"expected_docs": [
"rdk_doc/docs/04_Algorithm_Application/01_model_zoo/infer_api_ref.md",
"model_zoo_doc/docs/infer_api_ref.md",
"rdk_doc/docs/04_Algorithm_Application/01_model_zoo/rdk_x3_guide.md"
],
"difficulty": "中等",
"source_topic": 26081
},
{
"question": "PC 上跑 Gazebo 仿真、RDK 板卡上跑算法节点、PC 上用 Rviz 可视化,这种跨设备架构怎么保证 ROS2 通信正常?",
"expected_answer": "RDK 板卡上的节点负责发布传感器数据(图像、点云、里程计)、机器人状态、AI 检测结果等话题,PC 上的 Rviz 订阅这些话题做可视化,PC 上的 Gazebo 通过 ROS 话题与 RDK 上的控制节点交互。网络配置需保证 PC 与 RDK 之间互通,ROS2 设置正确的 ROS_DOMAIN_ID(同一网络且 DOMAIN_ID 相同即可自动发现);若 PC 使用 Ubuntu 虚拟机,网络模式需设置为桥接模式(Bridged),使其获得与 RDK 同网段的独立 IP。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_x_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_s_doc/docs/08_FAQ/06_tros_ros.md"
],
"difficulty": "困难",
"source_topic": 35365
},
{
"question": "RDK 的最小化 Linux 镜像上能直接运行手册中以 Ubuntu 为环境的示例吗?",
"expected_answer": "官方手册示例(尤其是 TROS/ROS 相关)通常在功能更完整的 Ubuntu 系统环境下演示,最小化 Linux 镜像可能没有预装 Python 解释器或完整的 ROS 环境,直接运行 C++ ROS 节点等示例需要先做环境配置调整。对于需要在 RDK 上运行的应用程序,官方推荐采用交叉编译方式:在 PC 开发主机上配置目标平台的交叉编译环境,编译后将可执行文件和依赖部署到板卡运行。",
"expected_docs": [
"rdk_x_doc/docs/08_FAQ/03_applications_and_examples.md",
"rdk_doc/docs/08_FAQ/03_applications_and_examples.md",
"rdk_s_doc/docs/08_FAQ/03_applications_and_examples.md"
],
"difficulty": "中等",
"source_topic": 27272
},
{
"question": "RDK 上 USB 摄像头取流容易断流或无图像,和像素格式有什么关系?怎么处理?",
"expected_answer": "UVC 摄像头默认尝试 YUYV 格式,在板端 USB 带宽紧张时容易断流,应优先切换到 MJPEG(launch 参数设置 pixel_format='MJPEG' 并选择支持的分辨率/帧率);如果设备列表里没有 MJPG,说明该摄像头只支持 YUYV,建议降到 320x240 这类低分辨率使用。",
"expected_docs": [
"rdk_studio_doc/docs/5-faq/4-camera-no-image.md",
"rdk_doc/docs/05_Robot_development/02_quick_demo/demo_sensor.md"
],
"difficulty": "中等",
"source_topic": 27964
},
{
"question": "RDK X5 的 Ubuntu 系统镜像怎么烧录到 Micro SD 卡?支持哪些工具?",
"expected_answer": "RDK 文档「烧录系统镜像」章节介绍使用 Rufus、RDK Studio 或 XBurn 将 Ubuntu 系统镜像(如 rdk-x5-ubuntu22-preinstalled-desktop-*.img)写入 Micro SD 卡或 eMMC:下载并解压镜像文件夹后,用工具选择镜像和目标卡写入即可。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/system-burn/burn-sd-card.md",
"rdk_doc/docs/01_Quick_start/install_os/rdk_x5/01_system_burn.md",
"rdk_doc/docs/01_Quick_start/install_os/rdk_x5_module/01_system_burn.md"
],
"difficulty": "简单",
"source_topic": 35545
},
{
"question": "BPU 模型上板后帧率低/性能差,yaml 转换配置里哪些参数影响性能?应该怎么配?",
"expected_answer": "性能评测时注意以下 yaml 参数:layer_out_dump 必须配置为 False(配置 True 会为每个卷积算子增加反量化输出节点,显著降低上板性能,仅调试用);compile_mode 选择编译优化方向,关注性能时配置为 latency;optimize_level 配置为 O3 获取最佳性能;debug 配置 True 可输出帧率、DDR 带宽占用等性能仿真信息,产品化交付时关闭以减小模型体积、提高执行效率。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/tune_content/performance_tune.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md",
"oe_x3_doc/oe_mapper/source/ptq/ptq_usage/performance_evaluation.md"
],
"difficulty": "困难",
"source_topic": 25369
},
{
"question": "RDK GS130WI 双目深度相机的传感器配置和主要规格是什么?",
"expected_answer": "GS130WI 是基于 MIPI 接口的双目深度相机,搭载双颗 SC132GS 全局快门图像传感器与 ICM-42688-P 六轴 IMU,支持双目同步曝光及外部触发;基线 70mm,单路分辨率 1080×1280,最高输出帧率 120fps,具备 HDR、40dB 信噪比及 850/940nm 近红外增强。",
"expected_docs": [
"accessories_doc/docs/02_stereo_camera_gs130wi/01_product_overview.md",
"accessories_stereo_camera_doc/docs/02_stereo_camera_gs130wi/01_product_overview.md",
"magicbox_doc/docs/magicbox.md"
],
"difficulty": "简单",
"source_topic": 35456
},
{
"question": "模型量化后部分中间层余弦相似度过低、输出波动大,按什么顺序调优?",
"expected_answer": "① 先将 calibration_type 配置为 default(自动参数搜索,以第一张校准数据输出节点余弦相似度为依据,从 max、max-percentile 0.99995、kl 等方法及 per_channel/非对称量化方案中选最优,可关注日志 Select xx method 提示);② 选择余弦相似度最高的方案后再尝试启用 per_channel 量化;③ 将精度问题算子通过 run_on_cpu 回退到 CPU,一般仅建议回退模型尾部输出层的 1~2 个算子(太多 CPU 算子影响性能,且反复重量化可能带来更大精度损失)。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/tune_content/accuracy_tune.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md",
"x5_sdk_doc/toolchain_development/intermediate/ptq_process.md"
],
"difficulty": "困难",
"source_topic": 25293
},
{
"question": "配置好 yaml 后用什么命令完成 S100/S600 的模型转换编译?",
"expected_answer": "调用 hb_compile 工具执行 hb_compile -c config.yaml 即可;单输入且输入无动态 shape 的场景,input_name 和 input_shape 可直接置空,工具内部会解析 ONNX 模型自动补充。模型部署实践指导(如 RGB ResNet18 部署指导)中有完整示例。",
"expected_docs": [
"oe_s_doc/guide/model_deployment_guidance/model_deployment_guidance_examples/rgb_resnet18_deployment_guidance.md",
"oe_s_doc/guide/model_deployment_guidance/model_deployment_guidance_examples/pyramid_resnet18_deployment_guidance.md",
"oe_s_doc/guide/model_deployment_guidance/model_deployment_guidance_examples/rgb_remove_resnet18_deployment_guidance.md"
],
"difficulty": "简单",
"source_topic": 35628
},
{
"question": "RDK 开发板系统默认的登录用户名和密码是什么?",
"expected_answer": "RDK 系统默认用户名和密码均为 sunrise(远程登录文档中以 SSH 登录为例:输入用户名 sunrise、密码 sunrise 即可完成登录)。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/remote_login.md",
"rdk_doc/docs/01_Quick_start/remote_login.md",
"rdk_doc/docs_s/01_Quick_start/remote_login.md"
],
"difficulty": "简单",
"source_topic": 34869
},
{
"question": "RDK X5 上 Python 多媒体库 srcampy 的 Camera.get_img() 等接口说明在哪个文档?",
"expected_answer": "在 RDK X5 cdev 多媒体 API 文档(pydev_multimedia_api_x5)中:object_camera.md 介绍 Camera 对象(含 get_img 取图接口),同目录还有 object_encoder/object_decoder 等 Encoder、Decoder、Display 对象说明,以及 pydev_api_demo.md 演示完整调用流程。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/pydev_multimedia_api_x5/object_camera.md",
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/pydev_multimedia_api_x5/pydev_api_demo.md",
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/pydev_multimedia_api_x5/object_decoder.md"
],
"difficulty": "简单",
"source_topic": 32483
},
{
"question": "X5 上用 hbplayer 抓 sensor RAW 图,pack 方式和 msb/lsb 在哪里设置?",
"expected_answer": "在 Hobot Player 工具界面配置:设置 online 模式 raw 的 pack 方式;配置 raw 图的 msb/lsb 类型(msb 为高位对齐,lsb 为低位对齐);设备 IP 和端口号一般不需修改,dynamic-displayer 模式下通过网络连接板侧 server。",
"expected_docs": [
"x5_sdk_doc/multimedia_development/isp_tuning_guide/Hobot_Player_User_Guide.md"
],
"difficulty": "简单",
"source_topic": 33431
},
{
"question": "HAT 训练框架的 export_onnx.py 脚本导出的 ONNX 模型有什么用途限制?",
"expected_answer": "export_onnx.py 用来将模型导出为 ONNX,但只用于可视化,不支持推理。",
"expected_docs": [
"oe_s_doc/guide/advanced_content/hat/examples/scripts.md"
],
"difficulty": "简单",
"source_topic": 27088
},
{
"question": "RDK 开发板上如何用命令行给网络连接配置静态 IP?",
"expected_answer": "使用 nmcli:nmcli connection modify <连接名> ipv4.method manual ipv4.addresses <IP>/<掩码> ipv4.gateway <网关> ipv4.dns <DNS>,连接名可用 nmcli connection show 查看,配置后断开重连生效。例如 nmcli connection modify WiFiConnection ipv4.method manual ipv4.addresses 192.168.0.100/24 ipv4.gateway 192.168.0.1 ipv4.dns 8.8.8.8。",
"expected_docs": [
"rdk_s_doc/docs/02_System_configuration/01_network_bluetooth.md",
"rdk_doc/docs/02_System_configuration/01_network_blueteeth.md",
"rdk_x_doc/docs/02_System_configuration/01_network_blueteeth.md"
],
"difficulty": "中等",
"source_topic": 26225
},
{
"question": "TROS 的 Web 端(hobot_websocket)看不到图像画面,有哪些排查方向?",
"expected_answer": "① 确认图像发布节点和 WebSocket 节点同时正常运行,访问的 IP 是板卡 IP 且无 IP/路由冲突;② 电脑配置了代理服务器时,代理可能阻止对局域网板卡 IP 的直接访问,需临时禁用代理或配置例外规则;③ 若 only_show_image=False(同时显示图像和 AI 结果),WebSocket 节点需收到第一个 ai_msg 才能开始同步渲染,需确认 AI 推理节点确实检出目标并发布了结果;④ 内网带宽不足(如手机热点)或板卡 CPU 占用过高也会导致无画面或卡顿。",
"expected_docs": [
"rdk_s_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_x_doc/docs/08_FAQ/06_tros_ros.md"
],
"difficulty": "困难",
"source_topic": 27497
},
{
"question": "RDK X5 上自己编译的内核驱动模块(.ko)加载时需要签名吗?",
"expected_answer": "不需要:RDK X5 没有启用内核模块签名机制,驱动模块可以直接加载;RDK X3 自系统版本 3.0.1 开始也已取消内核模块签名机制。仅旧版本系统需要对驱动模块进行签名。",
"expected_docs": [
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/kernel_headers.md",
"rdk_doc/docs/07_Advanced_development/02_linux_development/kernel_headers.md"
],
"difficulty": "中等",
"source_topic": 34436
},
{
"question": "OV5647 摄像头在 RDK X5 上能用吗?官方支持情况如何?",
"expected_answer": "OV5647 摄像头在 RDK X3/X3 Module 和 RDK X5 的认证配件清单中均有收录:X3/X3 Module 列有微雪版本,X5 列有第三方效果库优化版和微雪版本(OV5647 传感器,500W 像素,FOV 对角 160 度)。支持的分辨率组合为 1920x1080@30fps(默认)、640x480@60fps、1280x960@30fps、2592x1944@15fps(最大)。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/accessory.md",
"rdk_x_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/accessory.md"
],
"difficulty": "中等",
"source_topic": 34950
},
{
"question": "RDK 双目深度估计算法(StereoNet)采用了什么网络结构?",
"expected_answer": "地瓜双目深度估计算法借鉴 IGEV 网络,采用 GRU 架构:输入为双目图像数据,输出为左视图对应的视差图和深度图,具有较好的数据泛化性和较高的推理效率。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/spatial/hobot_stereonet.md"
],
"difficulty": "简单",
"source_topic": 34798
},
{
"question": "RDK X3 和 RDK Ultra 的端侧推理算力分别是多少?",
"expected_answer": "RDK X3(旭日 X3 派)是全功能开发板,具有 5Tops 端侧推理算力;RDK Ultra 是高性能开发套件,具有 96Tops 端侧推理算力与 8 核 ARM A55 处理能力,支持 4 路 MIPI Camera、4 路 USB3.0、3 路 PCIe3.0。",
"expected_docs": [
"rdk_doc/docs/RDK.md"
],
"difficulty": "简单",
"source_topic": 27322
},
{
"question": "RDK 开发板如何开启 WiFi 热点(Soft AP)模式?",
"expected_answer": "开发板无线网络默认运行在 Station 模式,文档「Soft AP 模式」章节给出了热点模式的配置步骤;此外文档另有「Soft AP 模式(NetworkManager)」章节,适用于 RDK X5(>=3.3.0)和 RDK X3(>=3.0.2)系统。",
"expected_docs": [
"rdk_x_doc/docs/02_System_configuration/01_network_blueteeth.md",
"rdk_doc/docs/02_System_configuration/01_network_blueteeth.md",
"rdk_doc/docs_s/02_System_configuration/01_network_bluetooth.md"
],
"difficulty": "简单",
"source_topic": 35513
},
{
"question": "RDK S100 的 MCU(FreeRTOS)固件如何编译?",
"expected_answer": "在 PC 端使用 S100 MCU 构建系统:通过 build_freertos.py 脚本配合交叉编译工具链编译 FreeRTOS 固件(详见 S100 MCU 开发的构建系统文档),编译产物烧录到板端 MCU 运行。",
"expected_docs": [
"rdk_doc/docs_s/07_Advanced_development/05_mcu_development/01_S100/02_MCU_build_system.md",
"rdk_doc/docs_s/07_Advanced_development/05_mcu_development/01_S100/01_basic_information.md",
"rdk_doc/docs_s/07_Advanced_development/02_linux_development/04_driver_development_s100/12_driver_timesync.md"
],
"difficulty": "中等",
"source_topic": 35585
},
{
"question": "RDK X5 的系统里如何添加开机自启动脚本?",
"expected_answer": "RDK OS 使用 Busybox init 管理自启动服务:在 /etc/init.d 目录下创建以 S 开头加两位数字的可执行脚本(例如 S99auto_startup 或 S99auto_startup.sh),系统启动时即会自动运行;添加或修改自启动脚本无需重新构建系统镜像,便于调试阶段快速验证。",
"expected_docs": [
"x5_sdk_doc/linux_development/system_component_development/35-Auto-start.md",
"x5_sdk_doc/linux_development/system_component_development/36-Custom_Partition_Content.md"
],
"difficulty": "中等",
"source_topic": 28532
},
{
"question": "RDK S100 的 MCU1 上 core0 和 core1 是如何分工的?支持锁步(Lock)模式切换吗?",
"expected_answer": "MCU1 的 main 函数通过 GetCurrentCoreID() 区分两个核的初始化流程:core0 负责主要外设、log、版本信息、GIC WAKER、中断亲和性和 FreeRTOS 任务初始化;core1 负责 Can5~Can9 数据中断、核间中断以及 stop/deepsleep 流程。锁步方面,当前系统版本的 Release Note 明确列出已知问题:目前不支持锁步解锁。",
"expected_docs": [
"rdk_s_doc/docs/07_Advanced_development/05_mcu_development/01_basic_information.md",
"rdk_s_doc/docs/10_Release_Note/s100/03_v4_0_4.md"
],
"difficulty": "困难",
"source_topic": 35722
},
{
"question": "想在自己的 x86 电脑上交叉编译 TROS/ROS2 功能包(如摄像头功能包),官方有提供什么工具?",
"expected_answer": "官方提供 TROS 交叉编译 Docker 镜像:从 http://archive.d-robotics.cc/TogetheROS/cross_compile_docker/ 下载(如 pc_tros_v1.0.5.tar.gz),用 docker load 导入镜像,再以挂载本地工作目录的方式启动容器,即可在 x86 环境中交叉编译面向 RDK 平台的 ROS2 功能包,具体步骤见 TROS 文档「交叉编译」章节。",
"expected_docs": [
"tros_doc/docs/01_quick_start/cross_compile.md",
"rdk_doc/docs/05_Robot_development/01_quick_start/cross_compile.md"
],
"difficulty": "中等",
"source_topic": 34179
},
{
"question": "RDK X3 智能语音的默认唤醒词是什么?在哪里修改唤醒词和命令词?",
"expected_answer": "智能语音功能对原始音频降噪后做 ASR 识别,默认唤醒词和命令词定义在智能语音功能代码模块根目录的 config/hrsc/cmd_word.json 文件中,默认包含「地瓜你好」(唤醒)以及「向前走」「向后退」「向左转」「向右转」「停止运动」等命令词,可直接编辑该文件修改。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/audio/hobot_audio.md"
],
"difficulty": "简单",
"source_topic": 28812
},
{
"question": "RDK 板卡 eMMC 系统损坏需要重新烧录镜像,用什么官方工具?",
"expected_answer": "官方提供 hbupdate 烧录工具用于系统镜像烧录(工具及各版本镜像可在 RDK 下载资源汇总页获取),按板卡型号选择对应镜像执行烧录即可恢复系统。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/download.md"
],
"difficulty": "中等",
"source_topic": 35553
},
{
"question": "RDK 文档里说「修改 dts 文件」,dts 源文件到底在哪里?改完怎么生效?",
"expected_answer": "正规流程是修改 PC 开发主机上 SDK/内核源码中 arch/arm64/boot/dts/ 目录下的板级 dts 文件,再通过 SDK 编译系统重新编译生成 dtb 并更新到板端。调试阶段也可直接在板端操作:用 dtc -I dtb -O dts 把 /boot/hobot/ 下的 dtb 反编译成 dts,修改后再编译回去(例如 BPU 内存、GPIO 等驱动文档中的示例即采用此方式)。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/02_linux_development/driver_development/driver_gpio_dev.md",
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/driver_development/driver_bpu_mem_dev.md",
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/driver_development/driver_gpio_dev.md"
],
"difficulty": "困难",
"source_topic": 31206
},
{
"question": "RDK X5 上做 MIPI 摄像头图像采集开发,用什么编程接口?",
"expected_answer": "使用板端的 Python 版 libsrcampy 图像多媒体模块:可创建 Camera、Encode、Decode、Display 等对象,完成摄像头图像采集、视频编解码和显示输出,接口说明见 cdev 多媒体 API 文档的 object_camera(Camera 对象)等章节;也可使用 TROS 的 mipi_cam 节点以 ROS2 话题方式取图。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/pydev_multimedia_api_x5/object_camera.md",
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/pydev_multimedia_api_x5/object_display.md"
],
"difficulty": "中等",
"source_topic": 34158
},
{
"question": "RDK IMU 模组有哪些软件接入方式?",
"expected_answer": "官方针对 BMI088 适配了 Linux IIO 驱动,接入 IMU 模组后加载驱动,通过操作 IMU 相关字符设备文件获取数据;软件层提供多种接入方式:C API、Python API、ROS2 功能包以及直接使用 IIO 接口。",
"expected_docs": [
"accessories_doc/docs/03_imu_module/05_software/01_overview.md"
],
"difficulty": "中等",
"source_topic": 27775
},
{
"question": "RDK X5 的供电接口规格是什么?",
"expected_answer": "RDK X5 通过 USB Type-C 接口供电,供电规格为 5V/5A(硬件介绍中的供电接口:USB Type C 5V/5A)。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/hardware_introduction/rdk_x5.md",
"rdk_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/accessory.md",
"rdk_doc/docs/01_Quick_start/accessory.md"
],
"difficulty": "简单",
"source_topic": 35368
},
{
"question": "RDK X5 桌面版系统切换实时内核后明显卡顿,这正常吗?官方对实时内核的支持程度如何?",
"expected_answer": "官方提供预编译的实时内核版本,只是为了简化构建流程;使用实时内核需注意文档中列明的事项,建议仅在充分测试验证并可接受相关风险的场景中部署(文档未对实时内核下的稳定性与兼容性做保证)。",
"expected_docs": [
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/realtime_kernel.md"
],
"difficulty": "中等",
"source_topic": 33801
},
{
"question": "RDK S100 开发板的电源输入规格是什么?",
"expected_answer": "RDK S100 使用外接电源:包装内包含 90W 电源适配器;板卡电源输入支持 12~20V DC,最大 150W。注意有独立供电的外设时,开发板需先上电、外设后上电,否则电源倒灌可能导致开发板触发保护状态无法启动。",
"expected_docs": [
"rdk_s_doc/docs/01_Quick_start/01_hardware_introduction/01_rdk_s100/01_rdk_s100.md"
],
"difficulty": "简单",
"source_topic": 35249
},
{
"question": "RDK S100 上 A 核与 MCU 之间走 CAN 通信(MCU-CAN),IPCF 通道配置文件是什么?",
"expected_answer": "MCU-CAN 基于 IPCF(核间通信框架)实现,配置文件为 ipcf_channel.json:顶层包含 enable、libipcf_path(IPCF 动态库路径)和 channels 数组;每个通道配置 id、name、instance/channel(决定映射到哪个物理 CAN 口)、fifo_size、pkg_size_max、dev_path(/dev/ipcdrv)等字段。详细字段说明见 S100 MCU 开发文档的 MCU-CAN 章节。",
"expected_docs": [
"rdk_doc/docs_s/07_Advanced_development/05_mcu_development/01_S100/09_mcu_can.md",
"rdk_s_doc/docs/07_Advanced_development/05_mcu_development/09_mcu_can.md"
],
"difficulty": "中等",
"source_topic": 35429
},
{
"question": "RDK X5 系统从 3.5.0 开始,Python 算法推理接口有什么重大变化?",
"expected_answer": "自 3.5.0 版本起,Python 算法推理、目标检测、语义分段等模块统一升级为 hbm_runtime 接口:该接口基于 pybind11 实现,提供对 libdnn C++ 库的高效访问,支持高性能模型加载与神经网络推理;基于新版接口,/app/pydev_demo/ 下所有示例完成全量重写,RDK 文档也随之全面修订。旧接口(hobot_dnn/bpu_infer_lib)开发的应用需要迁移。",
"expected_docs": [
"rdk_x_doc/docs/10_Release_Note/01_release_note.md",
"rdk_doc/docs/10_Release_Note/01_release_note.md",
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/pydev_multimedia_api_x5/pydev_hbdnn_demo.md"
],
"difficulty": "中等",
"source_topic": 35476
},
{
"question": "如何验证量化后的 ONNX 模型与编译出的 bin 模型输出是否一致?",
"expected_answer": "使用工具链提供的 hb_verifier 工具,例如 hb_verifier -m quanti.onnx,model.bin -s True(-i 可选),可在 x86 开发机上直接对比量化 ONNX 与 bin 模型的推理输出;板端无法安装工具时这是推荐的替代验证方式,详见工具链 hb_verifier 章节。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_faq_troubleshooting/troubleshooting.md",
"oe_x5_doc/oe_mapper/source/faststart/quickstart.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_verifier.md"
],
"difficulty": "简单",
"source_topic": 26440
},
{
"question": "RDK X3 反复重启、无法进入系统,和供电有什么关系?怎么排查?",
"expected_answer": "供电不足或不稳定是常见原因(Uboot 引导内核或内核启动数秒后重启是典型现象)。排查建议:更换符合开发板要求的 5V/3A 电源适配器;使用质量可靠的 USB Type-C 供电线;必要时重新烧录镜像。",
"expected_docs": [
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "中等",
"source_topic": 27213
},
{
"question": "在开发机上跑 hb_mapper/编译任务时提示内存不足(OOM)怎么办?",
"expected_answer": "增加 Swap 交换空间:当物理内存不足时用硬盘空间作虚拟内存缓解 OOM(性能慢于物理内存)。例如创建 4GB Swap 文件:fallocate -l 4G(或 6G)/swapfile,chmod 600 /swapfile,mkswap /swapfile,swapon /swapfile 激活;也可减少编译线程数(make -j1、colcon build --parallel-workers 1 或 --executor sequential)。",
"expected_docs": [
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_s_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "中等",
"source_topic": 28057
},
{
"question": "RDK S100 的 MCU CAN 最高支持多大波特率?波特率如何配置?",
"expected_answer": "CAN 最高传输速率为 8M(受限于 transceiver 的波特率限制,目前实验室只测试验证到 5M)。波特率由位时间的各个段(分段)总和决定,通过调整这些段的长度可以配置不同的波特率,具体配置方法见 S100 MCU 开发文档 MCU-CAN 使用指南的「波特率配置」章节。",
"expected_docs": [
"rdk_s_doc/docs/07_Advanced_development/05_mcu_development/09_mcu_can.md",
"rdk_doc/docs_s/07_Advanced_development/05_mcu_development/01_S100/09_mcu_can.md"
],
"difficulty": "中等",
"source_topic": 35555
},
{
"question": "RDK X5 的 40PIN 接口兼容树莓派的扩展板吗?IO 电平是多少?",
"expected_answer": "兼容。RDK X5 开发板提供 40PIN 接口,管脚定义兼容树莓派等产品;板卡提供一路 IO 电平选择接口(接口 18),可切换 IO 电平为 1.8V 或 3.3V(同时影响 40Pin 和 CAM 接口),40Pin 使用时 IO 电平需选择 3.3V。详细管脚定义、复用关系参考基础应用开发的 40pin_define 章节。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/hardware_introduction/rdk_x5.md"
],
"difficulty": "简单",
"source_topic": 31279
},
{
"question": "RDK X3/X5 各版本的网口默认 IP 和闪连口默认 IP 分别是多少?",
"expected_answer": "RDK 文档给出了各版本镜像的默认 IP:X3 系统小于等于 2.0.0 时网口 IP 为 192.168.1.10/24;X3 大于等于 2.1.0 与 X5 3.0.0 网口 IP 为 192.168.127.10/24;X5 3.0.0 的闪连口(USB Device 虚拟网卡)IP 为 192.168.128.10/24。远程登录时电脑 IP 前三段需与板卡一致(如 192.168.127.100),并注意关闭电脑防火墙。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/remote_login.md",
"rdk_doc/docs/01_Quick_start/remote_login.md",
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "中等",
"source_topic": 28259
},
{
"question": "RDK X5 上视频解码异常或解码慢,如何查看 VPU 解码器的运行状态?",
"expected_answer": "通过内核 debug 节点查看:cat /sys/kernel/debug/vpu/vdec,输出包括 decode param(各通道码流格式、buffer 大小/数量配置)、decode frameinfo(显示宽高)和 decode status(当前/累计输入输出 buffer 计数),可据此判断解码通道状态与数据流转情况(多媒体调试指南有详细说明)。",
"expected_docs": [
"x5_sdk_doc/multimedia_development/2-Multimedia_Debugging_Guide.md"
],
"difficulty": "中等",
"source_topic": 28581
},
{
"question": "RDK X5 桌面版系统 HDMI 没有显示,排查方向是什么?",
"expected_answer": "按系统 FAQ 排查:确认 HDMI 线缆与显示器连接正常且被系统识别;对于 Desktop 版本系统,确保图形界面服务(如 LightDM)正常启动;若仍异常,可通过串口/SSH 登录后查看显示相关服务与日志进一步定位。",
"expected_docs": [
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_s_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "简单",
"source_topic": 28960
},
{
"question": "板端用 hrt_model_exec 工具测模型性能,frame_count 和 thread_num 参数分别是什么含义?",
"expected_answer": "hrt_model_exec perf 用于板端模型性能测试:frame_count 默认 200,设置推理帧数,工具执行指定次数后分析平均耗时(perf_time 为 0 时生效);thread_num 默认 1,设置运行线程数,取值范围 1~8,若要分析极限帧率请将线程数改大。执行时还可加 --profile_path ./ 参数生成更详细的耗时 log 文件。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_usage/performance_evaluation.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md",
"oe_x3_doc/oe_mapper/source/ptq/ptq_usage/performance_evaluation.md"
],
"difficulty": "简单",
"source_topic": 24703
},
{
"question": "RDK S100 上用 USB 摄像头跑 YOLOv5 实时目标检测,有官方示例吗?",
"expected_answer": "有。RDK S100 的 Python 示例「USB Camera YOLOv5x 推理」基于 hbm_runtime 的 Ultralytics YOLOv5x 实时推理,支持 USB 摄像头读取画面进行目标检测并全屏可视化,示例代码位于板端 /app/pydev_demo/09_usb_camera_sample/ 目录。",
"expected_docs": [
"rdk_s_doc/docs/04_Algorithm_Application/03_Python_Sample/13_USB_Camera_yolov5x.md",
"rdk_doc/docs_s/04_Algorithm_Application/03_Python_Sample/13_USB_Camera_yolov5x.md"
],
"difficulty": "简单",
"source_topic": 35030
},
{
"question": "RDK X5 用 230AI MIPI 双目相机跑双目深度估计,应该怎么启动?",
"expected_answer": "230AI 是双目深度估计算法支持的 MIPI 双目相机之一(另支持 132GS 双目模组)。使用 hobot_stereonet 功能包,确认功能包版本满足手册要求(tros-humble-hobot-stereonet 2.5.0 及以上)后,运行 bash run_stereo.sh --mipi_rotation 0.0 即可。",
"expected_docs": [
"tros_doc/docs/03_boxs/spatial/hobot_stereonet.md",
"rdk_doc/docs/05_Robot_development/03_boxs/spatial/hobot_stereonet.md",
"rdk_doc/docs/05_Robot_development/03_boxs/spatial/stereo_imu_cam.md"
],
"difficulty": "中等",
"source_topic": 34780
},
{
"question": "RDK X5 上如何用 PWM 控制舵机(比如 MG90S)转动角度?",
"expected_answer": "使用 RDK X5 的 PWM 接口输出脉宽调制信号:PWM 提供高精度可编程脉冲输出,通过调节占空比控制舵机位置。X5 Cases 的 PWM 案例以 MG90S 舵机(180°)为例,舵机通过接收不同脉宽的控制信号实现指定角度的精准转动(180°/360° 舵机控制信息不同),DATA 信号接 32 号引脚。",
"expected_docs": [
"x5_cases_doc/docs/01_getting_started/02_pwm.md"
],
"difficulty": "中等",
"source_topic": 31666
},
{
"question": "OpenExplorer 工具链的 Docker 镜像下载后如何启动容器?",
"expected_answer": "先按环境部署文档下载工具链 Docker 镜像并用 docker load 导入,然后运行 OE 包提供的脚本启动容器:sh run_docker.sh data/(CPU 版镜像对应 sh run_docker.sh data/ cpu),容器内已配置好工具链环境;具体下载与启动步骤见 OE 文档「环境部署」章节。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/preface/learn_oe.md",
"oe_x5_doc/oe_mapper/source/env_install/env_deploy.md"
],
"difficulty": "简单",
"source_topic": 26652
},
{
"question": "模型转换 yaml 中 norm_type(网络输入预处理方法)有哪些可选值?分别是什么含义?",
"expected_answer": "norm_type 取值范围:'data_mean_and_scale'、'data_mean'、'data_scale'、'no_preprocess'(默认)。no_preprocess 表示不添加任何数据预处理;data_mean 表示减均值预处理(配合 mean_value);data_scale 表示乘 scale 系数预处理;data_mean_and_scale 表示先减均值再乘 scale。注意当 input_type_rt 配置为 featuremap 且为非四维输入时,norm_type 只能配置为 no_preprocess。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md",
"x5_sdk_doc/toolchain_development/intermediate/ptq_process.md"
],
"difficulty": "简单",
"source_topic": 27395
},
{
"question": "OE Runtime 开发中如何提升工程的任务吞吐/并行能力?",
"expected_answer": "推荐使用 workflow 调度管理工具,充分发挥不同任务阶段的并行能力:一般应用可拆分为输入前处理、模型推理、输出后处理三个阶段,简易流程下三者串行;利用 workflow 管理实现不同任务阶段并行后,理想情况下处理流程可流水线化,显著提升吞吐(详见 OE Runtime 开发文档)。",
"expected_docs": [
"oe_x5_doc/runtime/source/runtime_dev.md",
"oe_x3_doc/runtime/source/runtime_dev.md",
"oe_s_doc/guide/ucp/runtime/runtime_dev.md"
],
"difficulty": "中等",
"source_topic": 25480
},
{
"question": "TROS 功能包(比如某个算法 Node)的源码在哪里可以获取?",
"expected_answer": "三个途径:① TROS 官方用户手册在介绍各核心功能包或示例时通常提供对应源码的 GitHub 仓库链接;② NodeHub(应用商店/组件平台)的功能包介绍页面也包含源码链接;③ 大部分 TROS 开源功能包托管在 GitHub 的 D-Robotics 组织(github.com/D-Robotics)下,可按功能包名称搜索,仓库 README 一般有详细的编译和使用方法。",
"expected_docs": [
"rdk_s_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_x_doc/docs/08_FAQ/06_tros_ros.md"
],
"difficulty": "简单",
"source_topic": 27804
},
{
"question": "RDK X3 的音频子板和 USB 声卡能同时使用吗?声卡序号怎么区分?",
"expected_answer": "可以共存。当板卡同时连接板载声卡(音频子板)和 USB 声卡时,Linux 音频系统(ALSA)会为它们分配不同的声卡序号;板载声卡 duplexaudio(RDK 音频子板名称)通常被分配为声卡序号 1,需要使用正确的声卡序号(可通过 aplay -l 查看)来精确控制对应设备,也可通过 PulseAudio 统一识别管理。",
"expected_docs": [
"rdk_x_doc/docs/08_FAQ/04_multimedia.md",
"rdk_doc/docs/08_FAQ/04_multimedia.md",
"rdk_s_doc/docs/08_FAQ/04_multimedia.md"
],
"difficulty": "中等",
"source_topic": 25345
},
{
"question": "工具链里的 hbdk-cc 和 hb_mapper 转换工具是什么关系?TensorFlow 模型怎么转换?",
"expected_answer": "OpenExplorer 浮点模型转换对框架的支持情况:Caffe 导出的 caffemodel 直接支持;PyTorch、TensorFlow 和 MXNet 通过转到 ONNX 实现间接支持(ONNX 主要支持 opset10 和 opset11)。TensorFlow 模型可使用 ONNX 社区的 onnx/tensorflow-onnx 工具先转换为 ONNX,再用 hb_mapper 完成转换。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_usage/model_prepare.md"
],
"difficulty": "中等",
"source_topic": 25541
},
{
"question": "RDK X3 上处理摄像头图像时出现花屏、绿线,和什么有关?",
"expected_answer": "X3 芯片对 VPS 输出的宽度有 32 对齐要求:设置的宽度不满足 32 对齐时会自动向上取整;在非绑定情况下手动处理帧 buffer 时必须注意宽度对齐问题,把未对齐的帧传给显示模块就会出现花屏、绿线现象。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X3/pydev_multimedia_api_x3/object_camera.md"
],
"difficulty": "困难",
"source_topic": 26630
},
{
"question": "RDK X3/X5 同时接两个 USB 摄像头时,第二个摄像头取不到图像怎么办?",
"expected_answer": "RDK 系列板卡只有一路 USB 控制器,多路 USB 设备都是通过 USB HUB 扩展出来的,所有外设共享这一路 USB 的总带宽:USB 2.0 设备加起来只能共享 480 Mbps 总带宽(不存在 USB 2.0 外设共享 USB 3.0 带宽的情况)。默认情况下第一台 UVC 相机会申请几乎全部带宽,导致无法再接第二台;RDK 特殊的 UVC 驱动(uvcvideo)可通过 limitsize 参数限制相机带宽占用(如 modprobe uvcvideo quirks=128),让两个相机同时取流。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/04_vision/RDK_X3/usb_camera.md",
"rdk_x_doc/docs/03_Basic_Application/04_vision/RDK_X3/usb_camera.md",
"rdk_doc/docs_s/03_Basic_Application/01_Image/02_usb_camera.md"
],
"difficulty": "中等",
"source_topic": 28276
},
{
"question": "TROS 中如何订阅零拷贝共享内存图像话题(/hbmem_img)?用什么消息类型?",
"expected_answer": "使用 hbm_img_msgs 消息包(按图像分辨率选择具体类型,如 HbmMsg1080P):C++ 节点包含头文件 hbm_img_msgs/msg/hbm_msg1080_p.hpp,通过 rclcpp 的 create_subscription<hbm_img_msgs::msg::HbmMsg1080P> 订阅 /hbmem_img 话题获取零拷贝共享内存图像;AI 检测结果消息则使用 ai_msgs 包(节点依赖声明为 rclcpp sensor_msgs hbm_img_msgs ai_msgs dnn_node 等)。",
"expected_docs": [
"tros_doc/docs/05_tros_dev/ai_predict.md",
"rdk_doc/docs/05_Robot_development/05_tros_dev/ai_predict.md"
],
"difficulty": "中等",
"source_topic": 28473
},
{
"question": "RDK S100 上推理时报找不到 hobot_dnn 模块,应该用什么推理库?",
"expected_answer": "S100 平台不使用 hobot_dnn(hobot_dnn 是 RDK X3/X5 平台的 Python 推理库)。RDK S100 使用 hbm_runtime(新版工具链对应的 Python 推理包);例如 S100 的「USB Camera YOLOv5x 推理」官方示例即基于 hbm_runtime 实现,代码位于板端 /app/pydev_demo/09_usb_camera_sample/ 目录。",
"expected_docs": [
"rdk_s_doc/docs/04_Algorithm_Application/03_Python_Sample/13_USB_Camera_yolov5x.md",
"rdk_doc/docs_s/04_Algorithm_Application/03_Python_Sample/13_USB_Camera_yolov5x.md",
"rdk_doc/docs/10_Release_Note/01_release_note.md"
],
"difficulty": "中等",
"source_topic": 35226
},
{
"question": "在 X3/X5 上部署自己训练的 YOLOv5,导出 ONNX 时需要对网络做哪些修改?",
"expected_answer": "参考 OE 工具链的 ultralytics_yolov5 算法示例:导出前修改 yolo.py 的 Detect forward——注释掉原有的 x[i] = x[i].view(bs, self.na, self.no, ny, nx).permute(0, 1, 3, 4, 2) 分支,改为 x[i] = x[i].permute(0, 2, 3, 1).contiguous()(NHWC 布局)以适配后处理;导出参数与示例保持一致(opset 版本、输入名 data、输入尺寸 672x672)。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_sample/algorithm_sample.md"
],
"difficulty": "困难",
"source_topic": 24825
},
{
"question": "RDK X5 上程序帧率上不去,如何查看 CPU 和 BPU 的使用率来定位瓶颈?",
"expected_answer": "用 top/htop 查看 CPU 占用,用 hrut_somstatus 命令查看当前开发板的 BPU 使用率(OE Runtime 辅助工具手册「查看 BPU 使用率」章节有说明)。若 CPU 和 BPU 占用都不高,说明算力没有吃满,应通过多线程、异步等方式提高整体利用率;若占用均已很高,则需要优化程序本身的计算量,或更换更大算力的平台。",
"expected_docs": [
"oe_x5_doc/runtime/source/tool_introduction/auxiliary_tool.md",
"oe_x5_doc/runtime/source/tool_introduction/hrt_model_exec.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/runtime_sample.md"
],
"difficulty": "中等",
"source_topic": 29108
},
{
"question": "RDK X5 想把当前系统整体备份成镜像,有官方工具吗?",
"expected_answer": "有,官方提供 rdk-backup 工具用于系统备份(可将当前系统备份生成镜像)。从版本发布记录可见该工具随版本持续修复完善,例如修复了 X5 MD eMMC 系统无法使用 rdk-backup 进行备份的问题;使用前建议将系统与 miniboot 更新到最新版本。",
"expected_docs": [
"rdk_doc/docs/RDK.md",
"rdk_x_doc/docs/RDK.md",
"rdk_doc/docs/10_Release_Note/01_release_note.md"
],
"difficulty": "简单",
"source_topic": 31345
},
{
"question": "RDK X3、RDK X5、RDK Ultra、RDK S100、RDK S100P 各产品线的 BPU 处理器架构分别是什么?在 RDK X5 上用 hb_mapper 做模型转换时 march 应设置为什么?",
"expected_answer": "各产品线 BPU 架构:RDK X3 为 Bernoulli2,RDK Ultra 为 Bayes,RDK X5 为 Bayes-e,S100(Super100)为 Nash-e,S100P(Super100P)为 Nash-m。因此 RDK X5 上模型转换时 march 应设置为 bayes-e;hb_mapper makertbin 的 march 取值 'bayes-e'、'bayes'、'bernoulli2' 依次对应 X5、J5 和 X3&J3 处理器。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/05_toolchain.md",
"rdk_x_doc/docs/08_FAQ/05_toolchain.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md"
],
"difficulty": "中等",
"source_topic": 28917
},
{
"question": "RDK X5 用 rdk-backup 备份系统镜像时,默认的打包目录是哪里?为什么一般把 U 盘挂载到这个目录再备份?",
"expected_answer": "rdk-backup 的参数为生成和挂载镜像的打包目录,默认打包目录是/mnt;打包目录在制作镜像时会被忽略(该目录下的内容不会计入镜像),所以一般将 U 盘挂载到 /mnt 目录来备份,执行完成后会在打包目录下得到备份的镜像文件 rdk-时间和日期.img。",
"expected_docs": [
"rdk_doc/docs/09_Appendix/rdk-command-manual/cmd_rdk-backup.md",
"rdk_x_doc/docs/09_Appendix/rdk-command-manual/cmd_rdk-backup.md"
],
"difficulty": "简单",
"source_topic": 31315
},
{
"question": "RDK X5 系统能正常启动且已联网时,如何升级 miniboot?有什么注意事项?",
"expected_answer": "系统正常启动且已联网时,使用 rdk-miniboot-update 命令升级:sudo rdk-miniboot-update 更新为最新版本,可用 -f 指定镜像文件、-l 查看当前使用的镜像文件;系统无法正常启动或想通过 PC 工具烧录时使用 XBurn(通过 USB 和串口连接写入板载 NAND)。miniboot 是最小启动镜像,包含 miniboot、U-Boot 等底层固件,严禁降级刷入旧版本,否则可能无法启动。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/system-burn/upgrade-miniboot.md"
],
"difficulty": "简单",
"source_topic": 31310
},
{
"question": "PTQ 模型转换生成的性能预估 html/json 里显示的 FPS/Latency 很高,为什么和板端实测帧率差距很大?",
"expected_answer": "模型转换成功后会在 working_dir 生成包含模型静态性能预估的 html 和 json 文件,其中 Summary 选项卡提供的是编译器预估的模型 BPU 部分性能,不包含 CPU 算子性能预估;板端实际运行还有 CPU 算子、前后处理等开销,所以实测帧率会低于预估值。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/faststart/quickstart.md",
"oe_x3_doc/oe_mapper/source/faststart/quickstart.md"
],
"difficulty": "中等",
"source_topic": 26464
},
{
"question": "编译 X5 BSP 时,device/horizon/x5 下的板级配置文件 board_x5_evb_* 和 board_x5_soc_* 分别对应什么?",
"expected_answer": "board_x5_evb_* 是 X5 EVB 的板级配置文件(如 board_x5_evb_debug_config.mk,Kernel 配置使能 Debug 选项),除 debug/release 模式外还有使用 NAND Flash、Jammy 作为主存储器的变体;board_x5_soc_debug_config.mk 是 X5 SoC Debug 模式的板级配置(Linux Kernel 配置使能 Debug 选项),board_x5_soc_release_config.mk 是 X5 SoC 发布模式的板级配置(关闭 Debug 选项)。",
"expected_docs": [
"x5_sdk_doc/linux_development/bsp_develop.md"
],
"difficulty": "中等",
"source_topic": 35142
},
{
"question": "RDK 多媒体 VPS(视频处理系统)硬件一共有几路输出通道?缩小和放大分别由哪些通道实现?",
"expected_answer": "VPS 硬件由一个 IPU、一个 PYM、两个 GDC 组成,共有7路输出Channel(chn0~chn6):chn0~chn4 可以实现 downscale(缩小),chn5 可以实现 upscale(放大),chn0~chn5 均可实现裁剪(ROI)、旋转、矫正、帧率控制,chn6为金字塔online Channel。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/03_multimedia_development/video_processing.md"
],
"difficulty": "简单",
"source_topic": 25778
},
{
"question": "RDK X5 的 MediaCodec API 中 hb_mm_mc_set_intra_refresh_config 设置的是什么参数?是静态参数还是动态参数?适用于哪些编码格式?",
"expected_answer": "hb_mm_mc_set_intra_refresh_config 用于设置帧内刷新模式参数,该参数为静态参数,适用于 H264/H265。Intra Refresh 模式通过在非 I 帧内部周期性插入帧内编码的 MB/CTU 来提高容错性,为解码器提供更多修复点,避免时域错误造成的图像损坏。",
"expected_docs": [
"x5_sdk_doc/multimedia_development/10-MediaCodec_API_zh_CN.md"
],
"difficulty": "简单",
"source_topic": 34844
},
{
"question": "RDK S100 的 3D GPU 支持哪些标准 API?官方提供了哪些 API 的示例代码?",
"expected_answer": "S100 的 3D GPU 支持以下标准 API:OpenGLES、OpenCL、Vulkan。官方针对其中两种 API 提供了示例代码:OpenCL 示例和 OpenGLES 示例(sample_gpu_3d),可根据需求选择对应 API 示例参考使用。",
"expected_docs": [
"rdk_s_doc/docs/07_Advanced_development/03_multimedia_development/02_multimedia_application/08_sample_gpu_3d.md",
"rdk_doc/docs_s/07_Advanced_development/03_multimedia_development/02_multimedia_application/08_sample_gpu_3d.md"
],
"difficulty": "简单",
"source_topic": 32389
},
{
"question": "RDK S100 想在 40PIN 上使用 UART2 串口,官方文档要求做哪些配置?",
"expected_answer": "RDK S100 在 40PIN 上支持 UART2 但默认没有使能(物理管脚号 8 和 10,IO 电压 3.3V)。由于 UART2 与 I2C5 引脚复用,需要先拨动 40pin 上的拨码开关来选择使用 UART2 还是 I2C5,然后修改设备树文件(source/hobot-drivers/kernel-dts/drobot-s100-soc.dtsi):将 uart2 的 status 设置为 okay,将 i2c5 的 status 设置为 disabled。",
"expected_docs": [
"rdk_s_doc/docs/03_Basic_Application/03_40pin_user_guide/01_s100/04_uart.md",
"rdk_doc/docs_s/03_Basic_Application/03_40pin_user_guide/04_uart.md"
],
"difficulty": "中等",
"source_topic": 35415
},
{
"question": "BPU SDK 中张量类型 HB_DNN_IMG_TYPE_NV12 和 HB_DNN_IMG_TYPE_NV12_SEPARATE 有什么区别?",
"expected_answer": "HB_DNN_IMG_TYPE_NV12 与 HB_DNN_IMG_TYPE_NV12_SEPARATE 都代表 NV12 的数据,只是在存储上有差异:HB_DNN_IMG_TYPE_NV12 的张量类型为一张 NV12 的图片;HB_DNN_IMG_TYPE_NV12_SEPARATE 的张量类型为 Y 通道及 UV 通道为输入的图片。",
"expected_docs": [
"oe_x5_doc/runtime/source/bpu_sdk_api/bpu_sdk_api.md"
],
"difficulty": "简单",
"source_topic": 25534
},
{
"question": "多输入模型做 PTQ 转换时,yaml 中 input_name 以及各输入类型/排布参数应该怎么配置?",
"expected_answer": "多输入时 input_name 配置为 \"input_name1; input_name2; input_name3...\"(用分号分隔),且必须配置以保证后续类型及校准数据输入顺序的准确性;input_type_train、input_layout_train、input_type_rt、input_layout_rt 等参数每个输入节点都需要配置一个确定值,节点顺序需与 input_name 中的顺序严格保持一致。mean_value 等预处理参数配置的输入节点数量必须与 norm_type 配置的节点数量一致,不需要 mean 处理的节点配置 'None'。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_appendix/norm_type.md"
],
"difficulty": "简单",
"source_topic": 26426
},
{
"question": "模型转换时想把某个中间节点指定为模型输出(便于对比中间层结果),yaml 里应该配置什么参数?",
"expected_answer": "在 model_parameters 中配置 output_nodes 参数,取值为模型中的具体节点名称,此参数用于支持指定节点作为模型输出。另外 layer_out_dump 设为 True 可让模型保留输出中间层值的能力,但输出中间层的值是调试手段,常规状态下请不要开启。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md"
],
"difficulty": "简单",
"source_topic": 27107
},
{
"question": "RDK X5 上为什么以 Conv 结尾的模型编译后尾部卷积算子耗时明显偏高?怎么优化成低精度输出?",
"expected_answer": "X5 算法工具链目前只在模型尾部支持 Conv 算子以 int32 高精度输出,其他算子都只能以 int8 低精度输出;且由于 BPU 硬件限制,在模型尾部以 int32 高精度输出的 Conv 不支持与其后 BN 和 ReLU/ReLU6 的算子融合,因此耗时会多。可在 yaml 的 optimization 参数中配置 set_model_output_int8(或 set_model_output_int16)将模型设置为 int8/int16 格式低精度输出。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_faq_troubleshooting/ptq_faq.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md"
],
"difficulty": "中等",
"source_topic": 25363
},
{
"question": "bin 模型里的反量化(Dequantize)节点为什么比较耗时?官方性能建议如何优化?",
"expected_answer": "CPU 和 BPU 之间的异构调度会引入量化、反量化节点,该节点的计算因为需要遍历数据,所以耗时与shape大小成正比。对于量化、反量化算子官方建议手动摘除,并将相关计算合入前、后处理代码中,可节省一次数据遍历的冗余耗时;在后处理中还可以先完成筛选过滤的操作,仅对剩下的数据做反量化,进一步压缩耗时(模型收尾处的反量化节点可用 hb_model_modifier 工具删除后合并至前后处理代码)。",
"expected_docs": [
"oe_s_doc/guide/tune_content/efficient_model_advice.md",
"oe_x3_doc/oe_mapper/source/advanced_content/efficient_model_advice.md"
],
"difficulty": "中等",
"source_topic": 32122
},
{
"question": "RDK OE 发布包里用于模型上板运行的 runtime 示例包叫什么?包含什么内容?",
"expected_answer": "horizon_runtime_sample 示例包,介绍模型上板运行的具体用法,开发者可以体验并基于这些示例进行应用开发。示例代码包的 code 目录下有 00_quick_start(用 mobilenetv1 读取单张图片进行推理的快速入门示例)等多种示例,示例包获取方式参考交付物说明。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/runtime_sample.md",
"x5_sdk_doc/toolchain_development/intermediate/runtime_sample.md"
],
"difficulty": "简单",
"source_topic": 24732
},
{
"question": "想把模型编译成多 batch(例如 4 路相机共用同一个模型一次推理),yaml 里的 input_batch 参数怎么用?有什么限制?",
"expected_answer": "input_batch 用于指定转换后混合异构模型需要适配的输入 batch 数量,取值范围 1-4096。限制:该参数仅在 input_shape 第一维为 1 的时候可以使用(模型为多输入时,需要所有输入的 input_shape 第一维均为 1),且仅在原始 onnx 模型本身支持多 batch 推理时才能生效;此参数仅支持配置一个数值,且不影响转换后 onnx 模型的输入 batch 数量。若把 input_shape 第一维配置为大于 1 的整数(如 4x3x224x224),模型本身会认定为多 batch 模型,此时无法使用 input_batch,且每份校准数据 shape 需与 input_shape 一致。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_faq_troubleshooting/ptq_faq.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md"
],
"difficulty": "简单",
"source_topic": 26958
},
{
"question": "TROS 智能语音的 /audio_smart 话题有输出,但 /asr_text 一直没有输出,可能的原因是什么?",
"expected_answer": "sensevoice_ros2 默认发布的智能语音消息话题名为 /audio_smart 和 /asr_text 两个;其中 /asr_text 话题需要特定的唤醒词「你好,地瓜机器人」唤醒后才会有输出,可用 ros2 topic echo /asr_text 查看语音识别文本。",
"expected_docs": [
"tros_doc/docs/03_boxs/audio/sensevoice_ros2.md",
"rdk_doc/docs/05_Robot_development/03_boxs/audio/sensevoice_ros2.md"
],
"difficulty": "中等",
"source_topic": 34265
},
{
"question": "RDK X3 发热比较明显,用什么命令查看芯片温度?系统对过热有什么保护机制?",
"expected_answer": "可通过 sudo hrut_somstatus 命令查看当前芯片工作频率、温度等状态。过热保护(RDK X3/X3 Module):温度超过降频温度点时 CPU 和 BPU 会降低运行频率,CPU 最低降到 240MHz,BPU最低降到400MHz,降频温度默认 95 摄氏度(trip_point_1_temp 默认 95000);温度超过宕机温度点时系统会关机保护,默认 105 摄氏度(trip_point_2_temp 默认 105000),宕机后不会自动重启,需手动断电重启。降频、宕机温度可通过命令临时设置,宕机温度不能设置超过 105 度。",
"expected_docs": [
"rdk_doc/docs/02_System_configuration/04_frequency_management.md",
"rdk_x_doc/docs/02_System_configuration/04_frequency_management.md"
],
"difficulty": "简单",
"source_topic": 24712
},
{
"question": "hb_verifier 在开发机上验证量化 ONNX 与 bin 模型一致性时执行非常慢,-s 和 -b 参数分别是什么作用?",
"expected_answer": "-s/--run-sim 设置是否使用 X86 环境的 libdnn 做 bin 模型推理,默认为 False,设为 True 时即用 x86 CPU 模拟推理;-b/--board-ip 指定上板测试使用的 arm board ip 地址,可改为在板端做推理来对比结果,。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_verifier.md",
"oe_x3_doc/oe_mapper/source/ptq/ptq_tool/hb_verifier.md"
],
"difficulty": "简单",
"source_topic": 27170
},
{
"question": "RDK 上多线程/多实例程序中多次加载同一个 bin 模型文件会重复加载吗?模型句柄能否跨线程使用?",
"expected_answer": "不会重复加载。从文件(hbDNNInitializeFromFiles)或内存创建的 packedDNNHandle,调用方可以跨函数、跨线程使用返回的句柄,因此同一模型不需要在每个线程里重复加载,共享该句柄即可。",
"expected_docs": [
"oe_x5_doc/runtime/source/bpu_sdk_api/bpu_sdk_api.md",
"oe_x3_doc/runtime/source/bpu_sdk_api/source/bpu_sdk_api_doc.md"
],
"difficulty": "中等",
"source_topic": 28438
},
{
"question": "RDK S600 上想部署 Pi0 视觉语言动作(VLA)模型,官方文档在哪里?基于什么环境部署?",
"expected_answer": "RDK Cases 文档的「视觉语言动作模型(VLA)」章节提供在 RDK S600 与 PC 仿真环境上部署 Pi0 模型的教程(PC 侧部署 RoboTwin 仿真环境,用于得到模型输入、执行模型输出并观测推理效果)。S600 侧基于 OELLM 环境部署:模型放在 D-Robotics_LLM_S600_1.0.2_SDK/oellm_runtime/model 目录下,示例在 oellm_runtime/examples/pi0_demo,文档给出性能 benchmark(all(ms):98)。",
"expected_docs": [
"case_doc/docs/04_advanced/vla.md"
],
"difficulty": "简单",
"source_topic": 35452
},
{
"question": "RDK X5 上 BPU 或多媒体报内存分配失败,系统的 ION 内存是怎么划分的?如何调整区域大小?",
"expected_answer": "RDK X5 使用 ION 内存管理,主要使用 3 个 ION 区域:cma_reserved 主要为多媒体系统提供内存(VIN、ISP、VSE、GDC、VPU、OSD、GPU、Display 等硬件加速单元);carveout 主要为 BPU 子系统提供内存;ion_cma 作为备用区域,当上述两个区域没有空间时 ION 管理子系统会自动从 ion_cma 区域申请内存。可通过 srpi-config 工具调整 ION 区域大小(ION memory 一节)。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/02_linux_development/driver_development_x5/memory.md",
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/driver_development_x5/memory.md"
],
"difficulty": "中等",
"source_topic": 33815
},
{
"question": "RDK X5 开发板的端侧推理算力是多少?",
"expected_answer": "RDK X5 是一款全功能开发板,具有 10Tops 端侧推理算力与 8 核 ARM A55 处理能力,支持 2 路 MIPI Camera 接入、4 路 USB3.0 接口。",
"expected_docs": [
"rdk_doc/docs/RDK.md",
"rdk_x_doc/docs/RDK.md"
],
"difficulty": "简单",
"source_topic": 34653
},
{
"question": "RDK 板端 BPU 推理时模型输入数据的取值范围是什么?uint8 图像数据送入模型前要做什么处理?",
"expected_answer": "模型输入取值范围为 [-128,127]。当 yaml 配置 mean/scale 时,模型转换会在输入端新增 HzPreprocess 节点,其计算公式为 ((input(取值范围[-128,127])+ 128) - mean) * scale,其中 weight=scale、bias=(128-mean)*scale;若模型不走 HzPreprocess,官方验证代码中需将 uint8 图像数值减 128 并转为 int8(image = image - 128 后 .astype(np.int8))再送入模型。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_appendix/norm_type.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_usage/accuracy_evaluation.md"
],
"difficulty": "中等",
"source_topic": 31273
},
{
"question": "BPU 推理时如何获取模型输入/输出张量的有效数据形状和对齐后的形状?用哪些字段表示?",
"expected_answer": "用 hbDNNTensorProperties 中的字段表示:validShape 是有效数据的 shape;stride 表示 validShape 各维度的步长(跨越各维度需经过的字节数),若某维 stride 与有效尺寸不一致说明存在对齐;alignedShape 表示张量对齐内容的形状,alignedByteSize 是张量对齐内容的内存大小,当 alignedByteSize > 0 时建议按照 alignedByteSize 大小申请内存空间。",
"expected_docs": [
"oe_s_doc/guide/ucp/runtime/bpu_sdk_api/alignment_rule.md",
"oe_x5_doc/runtime/source/bpu_sdk_api/bpu_sdk_api.md"
],
"difficulty": "简单",
"source_topic": 26198
},
{
"question": "BPU 对模型输入输出内存的首地址有什么对齐要求?S600 和其他平台有区别吗?",
"expected_answer": "BPU 对模型输入输出内存首地址有对齐限制,要求输入与输出内存的首地址 32 或者 64 对齐,对应不同的计算平台:S600 要求 64 对齐,非S600要求 32 对齐。使用 hbUCPMalloc 与 hbUCPMallocCached 接口申请的内存首地址默认 64 对齐;若使用偏移地址作为模型的输入或输出,需检查偏移后的首地址是否满足对齐要求。",
"expected_docs": [
"oe_s_doc/guide/ucp/runtime/bpu_sdk_api/alignment_rule.md"
],
"difficulty": "简单",
"source_topic": 26198
},
{
"question": "在 x86 开发机上用 C/C++ 做 BPU 模型推理开发(如 #include <dnn/hb_dnn.h>),libdnn 库和头文件从哪里获取?",
"expected_answer": "从 OE(OpenExplorer)发布包获取:解压后 package 目录下包含了发布物运行的一些基础库和组件,其中 board 文件夹下为板端可执行程序;host 文件夹下为 x86 开发环境下的环境依赖、工具依赖以及模型推理相关的libdnn库和头文件,在 cmake 中引用即可。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/environment_config.md"
],
"difficulty": "简单",
"source_topic": 26420
},
{
"question": "PTQ 量化编译后,YOLOv5 头部的 Reshape、Sigmoid 等算子被放在了 CPU 上运行,如何在 yaml 中强制指定算子运行在 BPU?run_on_bpu 支持指定哪些算子?",
"expected_answer": "在模型转换 yaml 的 node_info 中配置 run_on_bpu 参数(作用是强制指定 OP 在 BPU 上运行,取值为模型中的节点名称),与之对应的 run_on_cpu 可强制算子在 CPU 上运行(CPU 为 float 精度计算)。注意 run_on_bpu 暂仅支持指定模型中 Relu/Softmax/Reshape/pooling(maxpool、avgpool 等)算子以及 CPU*+Transpose 组合(声明 Transpose 节点名称,可将 CPU*+Transpose 都运行在 BPU 上)。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_faq_troubleshooting/troubleshooting.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md"
],
"difficulty": "简单",
"source_topic": 27204
},
{
"question": "hb_mapper makertbin 转换模型时开启 fast-perf 模式有什么作用?工具内部主要做哪些操作?",
"expected_answer": "hb_mapper makertbin 分为开启和不开启 fast-perf 两种模式。fast-perf 模式开启后,会在转换过程中生成可以在板端运行最高性能的 bin 模型,工具内部主要进行:将 BPU 可执行算子尽可能运行在 BPU 上(可通过 yaml 中 node_info 参数指定在 BPU 上运行的算子);删除模型首尾可删除的 CPU 算子(包括 Quantize/Dequantize、Transpose、Cast、Reshape 等);以性能最高的 O3 优化等级编译模型。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md",
"oe_x3_doc/oe_mapper/source/ptq/ptq_usage/quantize_compile.md"
],
"difficulty": "简单",
"source_topic": 27204
},
{
"question": "板端推理报错 hbDNNInfer not support resizer model, please use hbDNNRoiInfer,这和模型转换 yaml 里的哪个参数有关?resizer 模型应如何配合使用?",
"expected_answer": "这是 resizer 输入源模型:yaml 中 input_source 参数(取值 ddr、pyramid、resizer)配置为 resizer 时表示数据来自处理器上的固定硬件(ddr 表示数据来自内存),此时 input_type_rt 仅支持配置为 nv12 或 gray;在具体工程环境中适配 resizer 数据源需要调用 hbDNNRoiInfer 专有接口(可按 roi 抠图并依据模型输入大小自动 resize)。若并不需要 resizer 模型,可不配置 input_source:input_type_rt 为 nv12 或 gray 时默认自动选择 pyramid,其他值默认选择 ddr。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/runtime_sample.md"
],
"difficulty": "中等",
"source_topic": 26961
},
{
"question": "训练时图像前处理是 x/255、减 mean、除 std(mean/std 为 0~1 的归一化系数),RDK 模型转换 yaml 中的 mean_value 和 scale_value 应该如何换算?",
"expected_answer": "换算关系为 mean_yaml = 255*mean、scale_yaml = 1/(255*std)。在 yaml 中配置 mean/scale 后,模型转换时会在输入端新增一个 HzPreprocess 节点(BPU 节点,可理解为对输入数据做了一次 conv 操作加速),其内部计算公式为 ((input(取值范围[-128,127])+128) - mean) * scale,其中 weight=scale,bias=(128-mean)*scale;因此不需要再在前处理里添加 MeanTransformer 和 ScaleTransformer。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_appendix/norm_type.md",
"oe_x3_doc/oe_mapper/source/ptq/ptq_appendix/norm_type.md"
],
"difficulty": "中等",
"source_topic": 25213
},
{
"question": "转换出的 bin 模型输入/输出端带有 Quantize/Dequantize 等 CPU 节点,影响板端性能评测,用什么工具可以把这些节点删除?",
"expected_answer": "使用 hb_model_modifier 工具,它用于对 runtime 模型中输入端的 Transpose、Quantize、Cast、Reshape 节点和输出端的 Transpose、Dequantize、DequantizeFilter、Cast、Reshape、Softmax 节点进行删除。用法示例:hb_model_modifier model.bin --all Dequantize 删除某类节点(所有 Dequantize);hb_model_modifier x.bin -a Quantize -a Dequantize 删除多种类型节点;先用 hb_model_modifier model.bin 可查看可删除的节点。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_model_modifier.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md"
],
"difficulty": "简单",
"source_topic": 26822
},
{
"question": "模型部署到板端后想获取某一网络层(中间层)的输入输出计算结果,应该用什么工具和参数?",
"expected_answer": "使用 hrt_model_exec 工具的 dump_intermediate 参数,可以 dump 模型每一层输入和输出:dump_intermediate=0 时默认关闭;=1 时模型中每一层节点输入输出数据以 bin 方式保存(BPU 节点输出为 aligned 数据);=2 时以 bin 和 txt 两种方式保存(BPU 节点输出为 aligned 数据);=3 时以 bin 和 txt 保存且 BPU 节点输出为 valid 数据。",
"expected_docs": [
"oe_x5_doc/runtime/source/tool_introduction/hrt_model_exec.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/runtime_sample.md"
],
"difficulty": "简单",
"source_topic": 27199
},
{
"question": "板端用 hrt_model_exec 做模型推理或性能测试时,core_id 参数的 0/1/2 分别是什么含义?默认值是多少?",
"expected_answer": "core_id 用于指定运行核:0 表示任意核,1 表示 core0,2 表示 core1;默认为 0。",
"expected_docs": [
"oe_x5_doc/runtime/source/tool_introduction/hrt_model_exec.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/runtime_sample.md"
],
"difficulty": "简单",
"source_topic": 26372
},
{
"question": "RDK X5 上用 DNN C++ 接口(hbDNNInfer)跑 batch 模型时,可以把一个 batch 的输入拆成多个 hbDNNTensor 分别设置内存地址吗?该接口最多支持同时存在多少个模型任务?",
"expected_answer": "可以。对于 batch 模型,允许分开设置输入张量的内存地址:例如模型输入 validShape/alignedShape 为 [4, 3, 224, 224],可以申请四个 hbDNNTensor,每个 hbDNNTensor 的 validShape/alignedShape 都设置为 [1, 3, 224, 224],存放每个 batch 的数据;当模型有多个输入时,input 的顺序应为 input0[batch0], input0[batch1], …, inputn[batch0], inputn[batch1], …。接口最多支持同时存在 32 个模型任务。",
"expected_docs": [
"x5_sdk_doc/toolchain_development/intermediate/dnn_api.md"
],
"difficulty": "中等",
"source_topic": 26120
},
{
"question": "TROS 的 mipi_cam 节点默认读取哪个传感器(sensor)的相机标定文件?换用 GC4663 摄像头时标定文件如何处理?",
"expected_answer": "mipi_cam 提供 F37 以及 GC4663 两种摄像头的标定文件,默认读取 F37 的标定文件 F37_calibration.yaml;如使用 GC4663,需要更改相机标定文件的读取路径,通过 launch 参数 mipi_camera_calibration_file_path 指定(标定文件位于 /opt/tros/${TROS_DISTRO}/lib/mipi_cam/config/ 目录下)。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/02_quick_demo/demo_sensor.md",
"tros_doc/docs/02_quick_demo/demo_sensor.md"
],
"difficulty": "简单",
"source_topic": 24947
},
{
"question": "TROS 智能语音(hobot_audio)支持哪两种麦克风阵列?配置文件中用什么字段区分阵列类型和麦克风设备号?",
"expected_answer": "支持环形麦克风阵列(一体化设计)和线形麦克风阵列(由音频转接板和线形麦克风板组成),均连接到 RDK X3 的 40PIN GPIO 接口。麦克风阵列类型通过 mic_type 字段设置:默认值 0 表示环形麦克风阵列,使用线形麦克风阵列需修改为 1;麦克风设备号通过 micphone_name 字段设置,默认为 hw:0,0(音频设备 Card0 Device0)。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/audio/hobot_audio.md",
"tros_doc/docs/03_boxs/audio/hobot_audio.md"
],
"difficulty": "简单",
"source_topic": 26699
},
{
"question": "TROS 智能语音支持输出声源定位的 DOA 角度信息,环形和线形麦克风阵列的 DOA 角度取值范围分别是多少?",
"expected_answer": "智能语音功能支持输出声源定位的 DOA 角度信息,单位为角度:环形麦克风阵列取值范围 0 度~360 度,线形麦克风阵列取值范围 0 度~180 度;角度的相对位置关系与麦克风的安装位置强相关。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/audio/hobot_audio.md",
"tros_doc/docs/03_boxs/audio/hobot_audio.md"
],
"difficulty": "简单",
"source_topic": 26699
},
{
"question": "RDK 上 hobot_cv 功能包的高斯滤波示例如何启动?BPU 加速和 NEON 加速分别支持什么数据格式?",
"expected_answer": "先拷贝配置 cp -r /opt/tros/${TROS_DISTRO}/lib/hobot_cv/config/ .,然后 ros2 launch hobot_cv hobot_cv_gaussian_blur.launch.py 启动 BPU 加速测试程序,ros2 launch hobot_cv hobot_cv_neon_blur.launch.py 启动 NEON 加速测试程序。高斯滤波的加速类型分为 BPU 加速和 NEON 加速:BPU 加速暂时只支持 int16 格式,NEON 加速暂时只支持 int16 和 uint16 格式。",
"expected_docs": [
"tros_doc/docs/02_quick_demo/demo_cv.md",
"rdk_doc/docs/05_Robot_development/02_quick_demo/demo_cv.md"
],
"difficulty": "简单",
"source_topic": 24896
},
{
"question": "TROS 的零拷贝(zero-copy)通信是怎么实现的?tros.b Foxy 版本和 Humble 版本有什么区别?如何评测零拷贝性能?",
"expected_answer": "原生 ROS2 Foxy 进行大数据量通信时存在时延较大、系统负载较高等问题;tros.b Foxy 版本基于 RDK 系统软件库 hbmem 实现了 zero-copy 功能,数据跨进程传输零拷贝,可减少大块数据传输延时和系统资源占用;tros.b Humble 版本使用的是 ROS2 Humble 的 zero-copy 功能(具体使用方法参考 ROS2 官方 FastDDS 配置文档)。TROS 集成 performance_test 工具,做数据传输测试时加入 --zero-copy 参数即可评测开启零拷贝前后的时延和 CPU 占用差异。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/05_tros_dev/zero_copy.md",
"rdk_doc/docs/05_Robot_development/02_quick_demo/demo_communication.md",
"tros_doc/docs/02_quick_demo/demo_communication.md"
],
"difficulty": "中等",
"source_topic": 28268
},
{
"question": "RDK X5 的 CAN/CAN FD 接口用什么芯片实现?支持多高的速率?",
"expected_answer": "RDK X5 集成 TCAN4550——它是带有集成 CAN FD 收发器的 CAN FD 控制器(SPI 转 CAN),符合 ISO11898-1:2015 高速 CAN 数据链路层规范并满足 ISO11898-2:2016 物理层要求,支持高达 8Mbps 的数据速率,同时支持经典 CAN 和 CAN FD(支持 1M 的 CAN、2M 的 CAN FD)。",
"expected_docs": [
"rdk_x_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/can.md",
"rdk_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/can.md"
],
"difficulty": "简单",
"source_topic": 31331
},
{
"question": "RDK X5 使用 CAN 总线通信时,什么情况下需要闭合板上的终端电阻开关?",
"expected_answer": "RDK X5 的 CAN 通信接口配备了一个 120 欧姆终端电阻开关,需要启用终端电阻时闭合该开关即可。如果通信距离过长(大于 1 米)、速率过大(大于 125Kbps),需要闭合 RDK X5 的终端电阻开关,并且对端设备也要使能 120 欧姆的电阻,这样可以消除信号反射、保证总线的稳定通信。",
"expected_docs": [
"rdk_x_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/can.md",
"rdk_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/can.md"
],
"difficulty": "简单",
"source_topic": 31331
},
{
"question": "RDK X5 想用以太网 PoE 给板卡供电可行吗?具体如何实现,对 PoE Hat 有什么要求?",
"expected_answer": "可行,RDK X5 支持通过 PoE 系统供电,但其本身并非完整的 PSE 设备或 PD 设备:板载 RJ45 座内置变压器、可以输出 AC 交流电源(接口位于以太网连接器旁边的 4PIN 针脚),应将该 4PIN 针脚连接到外部第三方 PoE Hat,由 PoE Hat 把 AC 转换为 DC 电源,要求该 DC 电源为 5V(MAX 5.2V),再把 DC 5V 电源连接到 RDK X5 40PIN 上的 5V 针脚。选购 PoE Hat 时注意协议标准,地瓜推荐使用 IEEE 802.3at 标准(最高 30W)的 PoE 方案。",
"expected_docs": [
"rdk_x_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/POE.md",
"rdk_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/POE.md"
],
"difficulty": "中等",
"source_topic": 31576
},
{
"question": "RDK X5 的 GPU 不支持 CUDA,那它支持哪些标准的图形/计算 API?分别用于什么场景?",
"expected_answer": "X5 3D GPU 支持四种标准 API:EGL、OpenGL ES、Vulkan 和 OpenCL。EGL(1.5)管理图形上下文和窗口表面;OpenGL ES(3.1/3.0/2.0/1.1)用于嵌入式图形渲染(游戏、UI 渲染);Vulkan 用于高性能图形和计算渲染;OpenCL(1.1/1.2/3.0)用于通用并行计算(图像处理、机器学习、科学计算)。因此需要 GPU 通用计算时应使用 OpenCL,而非 CUDA。",
"expected_docs": [
"x5_sdk_doc/multimedia_development/11-3DGPU_API_zh_CN.md"
],
"difficulty": "中等",
"source_topic": 32864
},
{
"question": "OpenExplorer(OE)发布包 samples 目录下的 model_zoo 是做什么的?OE 包没有附带模型文件时如何获取?",
"expected_answer": "samples(X3 包中为 ddk.samples)下包含 ai_benchmark、ai_toolchain 和 model_zoo 三部分;model_zoo 是一个模型库,用于放置工具链示例模型编译的源模型和 runtime 模型。为减小 OE 包交付体积,可在 OE 包主目录运行 resolve_all.sh 脚本(用于自动下载 OE 包内所有可下载的依赖项)来获取这些模型文件。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/preface/learn_oe.md",
"oe_x3_doc/oe_mapper/source/preface/learn_oe.md"
],
"difficulty": "简单",
"source_topic": 26378
},
{
"question": "RDK 的多媒体应用示例程序(get_sif_data、sample_vps、sample_video_codec 等)如何获取?安装在哪个目录?",
"expected_answer": "通过 apt 安装:sudo apt install hobot-multimedia-samples,示例所涉及源码安装在 /app/multimedia_samples 目录下,包括 get_sif_data、get_isp_data、sample_isp、sample_vps、sample_osd、sample_video_codec 等示例程序。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/03_multimedia_development/multimedia_samples.md",
"rdk_x_doc/docs/07_Advanced_development/03_multimedia_development/multimedia_samples.md"
],
"difficulty": "简单",
"source_topic": 27724
},
{
"question": "RDK OS 的 Server 版系统想改成带图形桌面的 Desktop 版,可以直接在 Server 版上升级吗?官方推荐怎么做?",
"expected_answer": "不推荐。Server 版和 Desktop 版预装的软件包差异显著(Desktop 版包含 XFCE 桌面环境及相关组件,Server 版通常不包含以节省资源)。理论上可以在 Server 版上手动安装 Desktop 版所需的软件包(xserver-xorg、xfce4、lightdm 及其依赖)将其升级为图形界面系统,但官方不提供也不推荐这种手动升级路径,不对该方式构建的 Desktop 系统的稳定性和完整性做保证;推荐做法是直接下载并烧录官方发布的 Desktop 版本系统镜像。",
"expected_docs": [
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "简单",
"source_topic": 27971
},
{
"question": "RDK X5 的 HDMI 接口最高支持什么分辨率?Server 版系统通过 HDMI 输出显示的是什么?",
"expected_answer": "RDK X5 提供一路 HDMI(接口 10)显示接口,最高支持 1080P 分辨率;开发板通过 HDMI 接口在显示器输出 Ubuntu 系统桌面,其中 Ubuntu Server 版本显示 logo 图标;此外 HDMI 接口还支持实时显示摄像头、网络流画面。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/hardware_introduction/rdk_x5.md",
"rdk_doc/docs/01_Quick_start/hardware_introduction/rdk_x5.md"
],
"difficulty": "简单",
"source_topic": 35636
},
{
"question": "RDK X5 Desktop 版系统上运行 HDMI 硬件直出类示例(如 02_camera_hdmi_output)画面不出来或冲突报错,需要先做什么?",
"expected_answer": "这类示例(如 02_camera_hdmi_output)的目的是将摄像头获取的 NV12 图像数据通过硬件 BT1120 接口直接从 HDMI 物理端口输出,属于硬件直出,并不是在 XFCE 桌面环境中通过 cv2.imshow 显示。因此在 Desktop 版 RDK X5 系统上运行此类示例实现 HDMI 硬件直出预览时,必须先关闭 XFCE 图形桌面环境(执行 sudo systemctl stop lightdm),否则会产生冲突或报错,HDMI 不会显示预期的图像。",
"expected_docs": [
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "中等",
"source_topic": 29102
},
{
"question": "RDK X5 上使用微雪 WM8960 Audio HAT 音频转接板,官方的软件配置步骤是什么?如何确认安装成功?",
"expected_answer": "硬件上将转接板接入 RDK X5 的 40pin header;软件上使用 srpi-config 配置音频板:进入 3 Interface Options → I5 Audio,选择 WM8960 Audio Driver HAT,根据提示 reboot 重启后,执行 cat /proc/asound/cards 出现 duplexaudioi2s1 声卡即说明转接板安装成功;卸载时在同一菜单选择 UNSET 即可卸载音频驱动和相关配置。",
"expected_docs": [
"rdk_x_doc/docs/03_Basic_Application/05_audio/rdk_x5/wm8960_audio_hat.md",
"rdk_doc/docs/03_Basic_Application/05_audio/rdk_x5/wm8960_audio_hat.md"
],
"difficulty": "简单",
"source_topic": 28340
},
{
"question": "RDK X5 板载的 3.5mm 耳机口对所接耳机有什么要求?",
"expected_answer": "板载耳机口自带 3.5mm 音频口,需要搭配 4 段式耳机或符合该接口的其他设备使用,普通 3 段式接口一般没有 MIC(无法录制声音);耳机需完全插接到位,若金属接口外露导致连接不完整,程序即使正常运行也无法听到或录制声音。可通过 cat /proc/asound/cards 确认声卡(duplexaudio)注册情况。",
"expected_docs": [
"rdk_x_doc/docs/03_Basic_Application/05_audio/rdk_x5/in_board_es8326.md",
"rdk_doc/docs/03_Basic_Application/05_audio/rdk_x5/in_board_es8326.md"
],
"difficulty": "简单",
"source_topic": 28340
},
{
"question": "RDK S100 上想跑激光雷达点云 3D 目标检测,TROS 有现成的功能包吗?它的输入输出是什么?",
"expected_answer": "有,hobot_centerpoint(激光雷达目标检测算法示例):使用 OpenExplorer(HAT)在 nuscenes 数据集上训练出来的 CenterPoint 算法模型;算法输入为 32 线激光雷达点云数据,输出信息包括目标的 3D 检测框、置信度、类别,支持 car、truck、bus、barrier、motorcycle、pedestrian 共六大类别。示例使用本地激光雷达点云文件回灌,利用 BPU 推理,通过 websocket package 在 PC 端浏览器渲染显示点云与检测结果,支持 RDK S100/S100P(Ubuntu 22.04 Humble)。",
"expected_docs": [
"tros_doc/docs/03_boxs/driver/hobot_centerpoint.md"
],
"difficulty": "中等",
"source_topic": 26786
},
{
"question": "RDK S100 想自己编译系统(bootloader/kernel 等 BSP 源码),BSP 源码包从哪里获取?",
"expected_answer": "RDK S100 支持 BSP 源码方式开发:BSP 源码包下载地址参见 RDK S100/S600 文档「7.2.1 开发环境搭建及编译说明」中指向的「系统软件」下载页(需要注册登录),在 PC 主机上搭建交叉编译开发环境后编译系统镜像。",
"expected_docs": [
"rdk_doc/docs_s/07_Advanced_development/02_linux_development/01_environment_build.md",
"rdk_s_doc/docs/07_Advanced_development/02_linux_development/01_environment_build.md"
],
"difficulty": "简单",
"source_topic": 33021
},
{
"question": "RDK X3 开发板上电后板上指示灯是什么含义?如果绿灯常亮说明什么?",
"expected_answer": "按 RDK 文档的指示灯说明:红灯点亮代表硬件上电正常;绿灯点亮代表系统启动中,熄灭或闪烁代表系统启动完成。如果上电 2 分钟以上仍无显示输出且绿灯常亮,说明系统启动失败,可检查电源适配器是否满足要求或重新制作系统镜像;若绿灯熄灭或闪烁,则系统已启动成功,是显示服务启动失败,需确认显示器符合支持列表规格。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/install_os/rdk_x3/03_boot_system.md",
"rdk_x_doc/docs/01_Quick_start/install_os/rdk_x3/03_boot_system.md"
],
"difficulty": "简单",
"source_topic": 27830
},
{
"question": "用 hb_mapper 做 PTQ 模型转换时,featuremap 输入模型的校准数据应该如何保存成文件?工具链校准时怎么读取?",
"expected_answer": "当 yaml 中关闭 preprocess_on 时,需要把取自训练集/验证集的样本做与模型推理前一样的前处理,使校准数据与原始模型具备相同的数据类型、尺寸和 layout。对于 featuremap 输入的模型,通过 numpy.tofile 命令将数据保存为 float32 格式的二进制文件,工具链校准时会基于 numpy.fromfile 命令进行读取;图片输入则先转换为模型要求的类型(如 uint8)再用 image.tofile(dst_file) 二进制存储。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md"
],
"difficulty": "简单",
"source_topic": 28736
},
{
"question": "RDK X3/X5 的算法工具链与 RDK S100/S600 的算法工具链,各自支持的 ONNX opset 版本范围分别是什么?",
"expected_answer": "RDK X3(XJ3 OE)与 RDK X5 的工具链文档写明:ONNX 目前主要支持的 opset 版本是 opset10 和 opset11(并要求原始模型 ir_version≤7)。而 S100/S600 的地瓜算法工具链支持的 opset 版本范围是 opset10-19。两个平台的工具链都需要注意 opset 版本匹配。",
"expected_docs": [
"oe_x3_doc/oe_mapper/source/ptq/ptq_usage/model_prepare.md",
"oe_s_doc/guide/ptq/ptq_usage/model_prepare.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_usage/model_prepare.md"
],
"difficulty": "中等",
"source_topic": 25514
},
{
"question": "x86 上用 HB_ONNXRuntime 做 ONNX 模型精度验证时,图像输入的模型和 featuremap 输入的模型分别调用哪个 run 接口?input_offset 如何设置?",
"expected_answer": "按输入数据类型区分:图像输入的模型(RGB/BGR/NV12/YUV444/GRAY,数据 dtype=uint8)使用 sess.run(output_names, feed_dict, input_offset=128);featuremap 模型(数据 dtype=float32)使用 sess.run_feature(output_names, feed_dict, input_offset=0)。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/05_toolchain.md",
"rdk_x_doc/docs/08_FAQ/05_toolchain.md"
],
"difficulty": "中等",
"source_topic": 27176
},
{
"question": "模型转换后想确认某个算子(例如 Softmax)在 RDK 平台上是 BPU 加速还是 CPU 计算,应该去哪里查?不满足 BPU 约束的算子会怎么处理?",
"expected_answer": "查阅 RDK 文档的「模型算子支持列表」章节:标注 BPU加速 的算子表示 D-Robotics 处理器可以在满足约束条件下加速,不满足约束条件则会在 CPU 进行计算;标注 CPU计算 的是已在 ARM CPU 上优化的算子(支持 onnx opset10 与 opset11)。无法满足 BPU 加速约束条件的算子将会退化到 ARM CPU 进行计算。列表还给出一般限制,例如 RDK X3 所有 BPU 上运行的算子均要求 input_batch ≤ 128。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/supported_op_list.md"
],
"difficulty": "简单",
"source_topic": 28844
},
{
"question": "板端的 hrt_model_exec 工具提供哪几类功能(子命令)?分别做什么用?",
"expected_answer": "hrt_model_exec 是可直接在开发板上评测的模型执行工具,提供三类功能(子命令):model_info 获取模型信息(如模型的输入输出信息等)、infer 执行模型推理获取推理结果、perf 执行模型性能分析获取性能分析结果。它可以让用户了解模型的真实性能和速度极限,对应用调优的目标极限具有指导意义。",
"expected_docs": [
"oe_x3_doc/runtime/source/tool_introduction/source/hrt_model_exec.md",
"oe_x5_doc/runtime/source/tool_introduction/hrt_model_exec.md"
],
"difficulty": "简单",
"source_topic": 26332
},
{
"question": "RDK 板卡上做模型性能测试,开发板重启后默认启用 CPU 自动降频影响测试结果,如何让 CPU 运行在性能模式?",
"expected_answer": "将 cpufreq 的调频策略(governor)设为 performance,即执行 echo performance > /sys/devices/system/cpu/cpufreq/policy0/scaling_governor(文档示例:sudo bash -c \"echo performance > /sys/devices/system/cpu/cpufreq/policy0/scaling_governor\")。工具链板端性能测试文档提示:目前开发板重启后默认启用自动降频,为了获得最好的性能,需要在开发板上执行该关闭降频命令后再测试。",
"expected_docs": [
"rdk_doc/docs/02_System_configuration/04_frequency_management.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/runtime_sample.md"
],
"difficulty": "简单",
"source_topic": 25579
},
{
"question": "用串口登录 RDK 开发板,RDK X3 和 RDK X5 的调试串口波特率分别是多少?其他串口参数是什么?",
"expected_answer": "RDK X3 调试串口波特率为 921600,RDK X5 为 115200;其余串口参数两者相同:数据位 8、奇偶校验 None、停止位 1。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/remote_login.md",
"rdk_x_doc/docs/01_Quick_start/remote_login.md"
],
"difficulty": "中等",
"source_topic": 28661
},
{
"question": "RDK X3 Module 官方载板的调试串口是哪个接口?硬件上通过什么芯片转成 USB?",
"expected_answer": "RDK X3 Module 载板提供一路调试串口(接口 15),硬件上通过 CH340 芯片将核心模组的调试串口转换为 USB 接口,可直接用 USB 线连接电脑调试。串口工具参数需配置为:波特率 921600、数据位 8、奇偶校验 None、停止位 1。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/01_hardware_development/rdk_x3_module/interface.md",
"rdk_doc/docs/01_Quick_start/hardware_introduction/rdk_x3.md"
],
"difficulty": "简单",
"source_topic": 26638
},
{
"question": "RDK X5 用 USB 线烧录、需要设备手动进入 Fastboot 下载模式时,应该如何操作?",
"expected_answer": "在设备 U-Boot 正常的前提下,开发板上电后长按空格键进入 U-Boot 命令行,然后输入 fastboot 0 进入 Fastboot 模式。该手动方式适用于 USB 连接(fastboot)以及 Serial+USB(xmodem_fastboot/fastboot,X5 串口波特率 115200)等下载场景。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/system-burn/upgrade-miniboot.md"
],
"difficulty": "简单",
"source_topic": 26534
},
{
"question": "RDK X5 Module 板载 eMMC,想把 Ubuntu 系统烧进 eMMC 或 Micro SD 卡,官方支持哪几种烧录方式?分别用什么 PC 端工具?",
"expected_answer": "RDK X5 Module 支持 Micro SD 存储卡和 eMMC 两种系统启动介质,烧录方式共三种:SD 卡单独烧录、SD 卡在板烧录和 eMMC 烧录,可借助 PC 端工具 RDK Studio(支持本地已有镜像和烧录时在线下载两种方式,支持 Windows、Mac 系统)或 Rufus(Windows 系统、本地镜像)完成烧录。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/install_os/rdk_x5_module/01_system_burn.md"
],
"difficulty": "简单",
"source_topic": 35268
},
{
"question": "RDK 板卡上通过 apt 安装 TogetheROS.Bot(tros.b)的命令是什么(Foxy 与 Humble 两种版本)?安装完成后在哪个目录?",
"expected_answer": "先执行 sudo apt update,然后 Foxy 版本执行 sudo apt install tros,Humble 版本执行 sudo apt install tros-humble。安装完成后 tros.b 位于 /opt 目录(/opt/tros)。如果安装命令提示 E: Unmet dependencies,先执行 apt --fix-broken install 安装相关依赖后再安装 tros.b。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/01_quick_start/install_tros.md",
"tros_doc/docs/01_quick_start/install_tros.md"
],
"difficulty": "简单",
"source_topic": 32393
},
{
"question": "RDK S100 板卡上编译 ROS2 工作空间时提示 colcon: command not found,如何安装 colcon?",
"expected_answer": "colcon 是 ROS2 常用的构建工具,如果系统镜像中未预装需要手动安装:sudo apt update 后执行 sudo apt install python3-colcon-common-extensions python3-catkin-pkg-modules python3-rosdep,或通过 pip3 install -U colcon-common-extensions empy 安装。另外,板卡上的 TROS 本身就是完整的 ROS2 运行环境,也可自行安装标准 ROS2(Foxy/Humble)或 ROS1 与 TROS 共存,但一个终端会话中只能 source 一个 ROS 环境。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_x_doc/docs/08_FAQ/06_tros_ros.md"
],
"difficulty": "简单",
"source_topic": 29293
},
{
"question": "在 RDK 板卡上直接运行 rviz/Gazebo 做 ROS2 可视化,官方建议吗?推荐的做法是什么?",
"expected_answer": "官方不建议在 RDK 这种嵌入式终端设备上直接运行 Rviz 或 Gazebo:它们资源消耗巨大,可能导致板卡资源耗尽、系统极其缓慢甚至卡死,并影响板上感知、决策、控制等核心程序的实时性。推荐做法是利用 ROS/ROS2 的分布式特性,将 Rviz/Gazebo 运行在与 RDK 板卡处于同一局域网下的一台性能较好的 PC 或 Ubuntu 虚拟机上(虚拟机网络需为桥接模式),RDK 板卡节点发布传感器数据、AI 检测结果等话题,PC 端订阅并可视化。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_x_doc/docs/08_FAQ/06_tros_ros.md"
],
"difficulty": "简单",
"source_topic": 27473
},
{
"question": "在 x86 电脑上直接编译出来的 ROS2 功能包,能直接拷贝到 ARM 架构的 RDK 板卡上运行吗?",
"expected_answer": "不能。任何在 x86 平台直接编译(而非交叉编译)的 ROS 功能包都不能直接在 ARM 架构的 RDK 板卡上运行,反之亦然。需要确保程序是为目标平台的架构编译的,例如使用官方提供的 TROS 交叉编译 Docker 环境在 x86 开发机上交叉编译。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_x_doc/docs/08_FAQ/06_tros_ros.md"
],
"difficulty": "简单",
"source_topic": 28163
},
{
"question": "RDK X5 上使用双目相机模组(如 GS130WI)做相机与 IMU 的时间同步,同步信号线应接 40PIN 的哪个管脚?模组背后的开关要设置成什么模式?",
"expected_answer": "相机的黑色杜邦线要连接 RDK X5 的 37 号管脚,该管脚用于外部触发控制相机和 IMU 的时间同步(管脚定义可参考 RDK X5 硬件手册中的 40PIN 章节);同时模组背后的开关需设置为 EXT 模式,不要放在 LPWM 模式。",
"expected_docs": [
"tros_doc/docs/03_boxs/spatial/stereo_imu_cam.md",
"rdk_doc/docs/05_Robot_development/03_boxs/spatial/stereo_imu_cam.md"
],
"difficulty": "中等",
"source_topic": 35183
},
{
"question": "RDK X3 Module 配合官方载板,最多能同时接入几路 MIPI Camera 模组?接口编号是什么?",
"expected_answer": "RDK X3 Module 官方载板提供 CAM 0/1/2 三组 MIPI CSI 接口,可以满足 3 路 Camera 模组的同时接入。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/01_hardware_development/rdk_x3_module/interface.md",
"rdk_doc/docs/01_Quick_start/hardware_introduction/rdk_x3.md"
],
"difficulty": "简单",
"source_topic": 26475
},
{
"question": "模型转换工具链校准数据 Transformer 中的 PadResizeTransformer 是什么操作?默认填充值是多少?填充位置有哪两种选择?",
"expected_answer": "PadResizeTransformer 是使用填充的方式做图像放大的操作,该 transformer 会在输出时将数据格式转为 float32。参数:target_size 为目标大小(元组,如 (240,240));pad_value 为填充到数组中的值,默认值为 127;pad_position 为填充的位置,取值范围为 boundary(默认,填充到边框)和 bottom_right(填充到右下角)。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_appendix/transformer.md"
],
"difficulty": "简单",
"source_topic": 25566
},
{
"question": "X3 天工开物(XJ3 OE)的 horizon_plugin_pytorch(QAT 训练插件)GPU 训练环境的依赖版本要求是什么?",
"expected_answer": "GPU 环境依赖:Ubuntu 20.04、CUDA 11.6、Python 3.8、torch 1.13.0+cuda-11.6、torchvision 0.14.0;CPU 环境对应 torch 1.13.0+cpu、torchvision 0.14.0+cpu,无 CUDA 依赖。",
"expected_docs": [
"oe_x3_doc/plugin/source/installation/installation.md"
],
"difficulty": "简单",
"source_topic": 26230
},
{
"question": "RDK 上想跑 ROS2 的 Nav2 导航框架,官方 TROS 手册的 Nav2 演示采用什么架构?",
"expected_answer": "TROS 应用文档的 Nav2 章节基于 SLAM 建立的地图使用 Nav2 进行导航,演示架构为:使用 Gazebo 在 PC 端创建虚拟环境和小车,使用 Rviz2 设置导航目的地,RDK 运行 Nav2 程序导航。Nav2 负责动态路径规划、计算电机速度、避免障碍等,实现机器人从 A 点到 B 点的安全移动。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/04_apps/navigation2.md"
],
"difficulty": "简单",
"source_topic": 24659
},
{
"question": "TROS 的 hobot_audio 智能语音节点默认发布什么话题?开启 ASR 输出后又发布什么话题?",
"expected_answer": "hobot_audio 默认发布的智能语音消息话题名为 /audio_smart,在另一个终端用 ros2 topic list 命令可以查询到该话题;若开启 ASR 输出,则发布消息话题 /audio_asr。话题消息中包含识别到的语音命令词及 DOA 角度等信息。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/audio/hobot_audio.md",
"tros_doc/docs/03_boxs/audio/hobot_audio.md"
],
"difficulty": "简单",
"source_topic": 31688
},
{
"question": "RDK X5/X3 官方镜像中 C 语言(cdev/sp 接口)多媒体示例代码放在板端哪个目录?如何编译运行?",
"expected_answer": "示例代码以源码形式放在板端 /app/cdev_demo 目录下,例如 vio2display 示例实现 MIPI 摄像头图像采集并通过 HDMI 接口输出。编译运行步骤:进入对应示例目录(如 cd /app/cdev_demo/vio2display),执行 sudo make 编译,再运行生成的可执行文件,如 sudo ./vio2display -w 1920 -h 1080。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/cdev_multimedia_api_x5/cdev_demo.md",
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X3/cdev_multimedia_api_x3/cdev_demo.md"
],
"difficulty": "简单",
"source_topic": 27014
},
{
"question": "RDK X5 上能否通过 V4L2 接口访问 MIPI 摄像头?能取到哪些处理阶段的图像数据?",
"expected_answer": "可以。RDK X5 支持 V4L2 接口,用户可以通过 V4L2 接口访问 RDK X5 的 MIPI 接口摄像头,获取 VIN、ISP、VSE 等阶段的图像数据:VIN 可从 SIF 接口采集原生图像(一般为 RAW 格式);ISP 完成调试的 sensor 可直接获取处理后的 NV12 格式图像;VSE 用于图像裁剪、缩放和颜色空间转换,支持 6 个缩放通道,最大处理能力 3840x2160@60fps。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/V4l2.md"
],
"difficulty": "简单",
"source_topic": 34989
},
{
"question": "RDK X5 开发板提供几路 MIPI Camera 接口和几路 USB 3.0 Type A 接口?板载 CAN 是什么类型的接口?",
"expected_answer": "RDK X5 提供 2 路 MIPI Camera 接口和 4 路 USB 3.0 Type A 接口;板载 CAN 为 CAN FD 高速接口。此外开发板还提供千兆以太网口(支持 POE)、HDMI 显示接口、40PIN 接口、多标准兼容耳机接口、LCD(MIPI DSI)显示接口、闪连接口和调试串口(Micro USB)等。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/hardware_introduction/rdk_x5.md"
],
"difficulty": "简单",
"source_topic": 28840
},
{
"question": "RDK X5 上用 Python 多媒体库 libsrcampy 的 Camera.open_cam 同时打开双目 MIPI 相机的两路图像,第二个参数传 -1 只能打开一个相机,应该怎么设置?",
"expected_answer": "open_cam(pipe_id, video_index, fps, width, height) 的第二个参数是 video_index,即 camera 对应的 host 编号,-1 表示自动探测,取值为 -1、0、1、2;双目时需要为两路相机显式指定各自的 host 编号(例如一路传 0、另一路传 1),第一个参数 pipe_id 是 camera 对应的 pipeline 通道号(默认从 0 开始,范围 0~7)。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/pydev_multimedia_api_x5/object_camera.md",
"rdk_x_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/pydev_multimedia_api_x5/object_camera.md"
],
"difficulty": "中等",
"source_topic": 28449
},
{
"question": "RDK X5 上 MIPI 摄像头接口与 host 编号(I2C 通道)的对应关系,在开发板上的哪个配置文件里查看?",
"expected_answer": "查看 /etc/board_config.json 配置文件。Camera.open_cam 的 video_index 参数(camera 对应的 host 编号,-1 表示自动探测)取值即可通过该文件确认。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/pydev_multimedia_api_x5/object_camera.md",
"rdk_x_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/pydev_multimedia_api_x5/object_camera.md"
],
"difficulty": "简单",
"source_topic": 28206
},
{
"question": "RDK Ultra 开发板能不能跑 TROS 的单目 3D 室内物体检测(mono3d_indoor_detection)?该算法支持哪些平台?",
"expected_answer": "不支持 RDK Ultra。mono3d_indoor_detection 的支持平台为:RDK X3 与 RDK X3 Module(Ubuntu 20.04 Foxy / Ubuntu 22.04 Humble)、RDK X5 与 RDK X5 Module(Ubuntu 22.04 Humble),以及 X86(Ubuntu 20.04 Foxy,本地回灌)。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/spatial/mono3d_indoor_detection.md"
],
"difficulty": "简单",
"source_topic": 27007
},
{
"question": "TROS 的单目 3D 室内物体检测算法(mono3d_indoor_detection)支持检测哪些物体类别?",
"expected_answer": "算法支持的室内物体检测类别包括:充电座、垃圾桶、拖鞋。每个类别的检测结果包含 3D 位置与朝向等信息,可用于导航避障等场景。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/spatial/mono3d_indoor_detection.md",
"tros_doc/docs/03_boxs/spatial/mono3d_indoor_detection.md"
],
"difficulty": "简单",
"source_topic": 27007
},
{
"question": "RDK X5 和 RDK S 系列统一用 hbm_runtime 做 Python 推理,两者在 NV12 图像输入方式上有什么区别?",
"expected_answer": "hbm_runtime 是 RDK X5 和 RDK S 系列统一使用的 Python 推理接口:RDK X5 底层依赖 libdnn、模型格式 .bin,NV12 为单个 packed 输入(Y+UV 拼接为一个输入 tensor);RDK S 系列底层依赖 libhbucp、模型格式 .hbm,NV12 为双输入(Y 与 UV 分离)。",
"expected_docs": [
"rdk_doc/docs/04_Algorithm_Application/01_model_zoo/infer_api_ref.md",
"model_zoo_doc/docs/infer_api_ref.md"
],
"difficulty": "中等",
"source_topic": 32443
},
{
"question": "RDK 板卡上想把一段文本转成语音并通过音频接口播放,TROS 有没有现成的功能包示例?",
"expected_answer": "有,TROS 提供 hobot_tts 功能包(文本转语音示例),功能是将一段文本转化为语音信号,并通过音频输出接口播放;它订阅文本消息,然后转化为语音数据,最后播放出去,支持 RDK X3(Foxy/Humble)和 RDK X5、RDK X5 Module(Humble)。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/02_quick_demo/hobot_tts.md",
"tros_doc/docs/02_quick_demo/hobot_tts.md"
],
"difficulty": "简单",
"source_topic": 34792
},
{
"question": "模型转换前想确认网络算子是否被支持、以及每个算子会被分配到 BPU 还是 CPU,应该跑工具链的哪一步?",
"expected_answer": "运行模型检查步骤 hb_mapper checker(示例脚本 01_check.sh):确认模型结构及算子是否支持,并提供每个算子执行硬件的分配情况(BPU/CPU)。",
"expected_docs": [
"x5_sdk_doc/toolchain_development/beginner.md"
],
"difficulty": "中等",
"source_topic": 27260
},
{
"question": "在开发机(x86)工具链环境里,不用上板就想预估转换出的 bin 模型的板端性能,用什么命令?",
"expected_answer": "使用工具链提供的 hb_perf 工具:以模型转换得到的 *.bin 为输入(命令 hb_perf xxx.bin),可以直接得到模型预期上板性能(不含 CPU 部分的计算评估)。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_usage/performance_evaluation.md",
"oe_x3_doc/oe_mapper/source/ptq/ptq_usage/performance_evaluation.md"
],
"difficulty": "简单",
"source_topic": 26674
},
{
"question": "PTQ 模型量化转换的校准阶段,一般需要准备多少份校准样本?对样本来源有什么要求?",
"expected_answer": "校准阶段会需要 20~100 份的标定样本输入,每一份样本都是一个独立的数据文件。为确保转换后模型的精度,校准样本应来自训练模型使用的训练集或验证集,不要使用非常少见的异常样本,例如纯色图片、不含任何检测或分类目标的图片等。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_usage/prepare_calibration_data.md",
"oe_x3_doc/oe_mapper/source/ptq/ptq_usage/prepare_calibration_data.md"
],
"difficulty": "简单",
"source_topic": 28298
},
{
"question": "送入工具链量化的浮点模型,输入维度有什么限制?",
"expected_answer": "模型输入维度只支持固定 4 维,输入 NCHW 或 NHWC(N 维度只能为 1),例如 1x3x224x224 或 1x224x224x3,不支持动态维度及非 4 维输入。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/overview.md"
],
"difficulty": "简单",
"source_topic": 32383
},
{
"question": "RDK X5 上不想用 HBN 私有 API,想用标准 V4L2 接口访问 MIPI 摄像头,怎么开启这个模式?",
"expected_answer": "使用 srpi-config 配置 camera 采集模式:进入 3 Interface Options -> I7 V4L2,选择 I1 V4L2 Enable/disable V4L2 interface for camera。开启后可通过 V4L2 接口访问 RDK X5 的 MIPI 摄像头,获取 VIN、ISP、VSE 等阶段的图像数据。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/V4l2.md",
"rdk_x_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/V4l2.md"
],
"difficulty": "简单",
"source_topic": 31474
},
{
"question": "RDK S100 上如何查看 BPU 占用率?S100 有几个 BPU core?",
"expected_answer": "S100 平台只有一个 BPU core,因此无需提供 BPU 核心选择参数。可通过 sysfs 节点查看 BPU 占用率:cat /sys/devices/system/bpu/ratio,配合 watch -n1 cat /sys/devices/system/bpu/ratio 持续观察。注意 S600 平台才有 4 个 BPU core(bpu0~bpu3),S100 不涉及核选择。",
"expected_docs": [
"rdk_s_doc/docs/07_Advanced_development/02_linux_development/05_hardware_unit_test/01-bpu_cpu_ddr_stress.md"
],
"difficulty": "简单",
"source_topic": 27082
},
{
"question": "HAT/QAT 量化训练中,activation_fake_quant(激活伪量化方式)有哪些可选值?默认是什么?",
"expected_answer": "可选值为 fake_quant、lsq、pact,默认 fake_quant;weight_fake_quant(权重的伪量化方式)同样支持 fake_quant、lsq、pact,默认 fake_quant。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/expert/api_reference.md"
],
"difficulty": "简单",
"source_topic": 26873
},
{
"question": "多个 bin 模型打包成一个模型文件后,用 BPU SDK C API 部署时使用什么句柄类型?",
"expected_answer": "使用 hbPackedDNNHandle_t,它是 DNN 句柄,指向打包的多个模型;可通过 hbDNNInitializeFromFiles 等接口初始化(参数为 hbPackedDNNHandle_t *packedDNNHandle),再配合 hbDNNGetModelNameList、hbDNNGetModelHandle 等接口获取具体模型。",
"expected_docs": [
"oe_x5_doc/runtime/source/bpu_sdk_api/bpu_sdk_api.md",
"oe_x3_doc/runtime/source/bpu_sdk_api/source/bpu_sdk_api_doc.md"
],
"difficulty": "中等",
"source_topic": 26295
},
{
"question": "RDK X3 上用 OpenCV cv2.VideoCapture 拉 RTSP 网络流解码很慢,官方有什么走硬件解码的示例?",
"expected_answer": "参考 RTSP 流解码示例(位于板端 /app/pydev_demo/08_decode_rtsp_stream/,decode_rtsp_stream.py):从 RTSP 视频流获取 H.264/H.265 码流,通过硬件解码、视频处理和 BPU 推理,实现实时视频解码和目标检测,示例展示了 RTSP 流接收、硬件解码、视频处理、推理和结果显示的完整流水线。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/03_pydev_demo_sample/RDK_X3/08_decode_rtsp_stream.md",
"rdk_x_doc/docs/03_Basic_Application/03_pydev_demo_sample/RDK_X3/08_decode_rtsp_stream.md"
],
"difficulty": "中等",
"source_topic": 28454
},
{
"question": "RDK X3 CPU 性能不够想超频,最高频率能提到多少?用什么命令开启?",
"expected_answer": "RDK X3/RDK X3 Module 提供超频功能,可将 CPU 最高频率从 1.2GHz 提升到 1.5GHz,开启命令:sudo bash -c 'echo 1 > /sys/devices/system/cpu/cpufreq/boost'(仅当前运行生效,重启恢复默认;超频会增加功耗和发热,echo 0 关闭;RDK Ultra 不适用)。",
"expected_docs": [
"rdk_doc/docs/02_System_configuration/04_frequency_management.md",
"rdk_x_doc/docs/02_System_configuration/04_frequency_management.md"
],
"difficulty": "简单",
"source_topic": 27109
},
{
"question": "想自己编译 RDK OS 系统镜像(内核、bootloader 等),RDK X3 和 RDK X5 的源码分别在哪个 GitHub 仓库?",
"expected_answer": "RDK X3 的相关源码托管在 GitHub 的 rdk-gen 仓库,RDK X5 的相关源码托管在 GitHub 的 x5-rdk-gen 仓库;两个仓库的 README 提供从环境安装、构建系统镜像到交叉编译工具链配置的开发说明。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/02_linux_development/environment_build.md",
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/environment_build.md"
],
"difficulty": "简单",
"source_topic": 27055
},
{
"question": "RDK S100 CAMSYS 中的 STITCH 硬件拼接模块主要用在什么场景?",
"expected_answer": "stitch 是一个可配置的图像拼接计算单元,可以完成多幅图像之间的融合拼接,主要应用于自动泊车场景下的 360 度环视图像拼接;它基于 ROI 进行 alpha-beta 融合,在 APA/ADAS 场景下可将四路摄像头畸变矫正后的 IPM 图像拼接成一路 360 环视图,也支持自定义权重实现背景虚化、图像水印等效果。",
"expected_docs": [
"rdk_s_doc/docs/07_Advanced_development/03_multimedia_development/01_multimedia_development/01_camsys.md",
"rdk_doc/docs_s/07_Advanced_development/03_multimedia_development/01_S100/01_camsys.md"
],
"difficulty": "简单",
"source_topic": 35348
},
{
"question": "HAT 训练框架的 config 配置里 deploy_inputs 字段是做什么用的?",
"expected_answer": "deploy_inputs 是 deploy 过程的模拟输入,不用关心具体的数值,只要保证格式满足输入要求即可(例如导出 ONNX 时需给出固定 shape 的输入,如 torch.randn 形式的 img/points 等张量)。",
"expected_docs": [
"oe_s_doc/guide/advanced_content/hat/tutorials/config/keywords.md"
],
"difficulty": "简单",
"source_topic": 26616
},
{
"question": "RDK 的 BPU 擅长加速什么类型的模型?工具链对高性能模型设计有什么建议?",
"expected_answer": "地瓜机器人的计算平台旨在加速 CNN(卷积神经网络),主要计算资源都集中在处理各种卷积计算;因此建议模型以卷积计算为主,卷积之外的算子都会导致计算资源利用率降低。设计时应尽量让模型 BPU 段的输入输出维度降低,以减少量化、反量化节点的耗时和硬件带宽压力。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/tune_content/performance_tune.md"
],
"difficulty": "简单",
"source_topic": 26570
},
{
"question": "RDK X3 的 BPU 卷积算子支持的 kernel 宽高范围是多少?AlexNet 第一层 11x11 卷积为什么跑不了 BPU?",
"expected_answer": "X3 BPU 的 Convolution/Conv 算子 kernel 宽高取值范围为 HxW=[1,7]x[1,7](单个 kernel 总体大小还限制 HxWxC<=32768),因此 11x11 的卷积超出 BPU 支持范围,只能改用不超过 7x7 的卷积或更换 backbone(如 mobilenetv2)。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/supported_op_list.md"
],
"difficulty": "中等",
"source_topic": 26720
},
{
"question": "RDK X3 上用 Python 多媒体库 libsrcampy 的 Camera.open_cam 传入 list 型的 width/height 开启多组分辨率输出时,最多支持几组?缩放倍数区间是多少?",
"expected_answer": "width、height 参数支持 list 类型输入,表示使能 camera 多组不同分辨率输出:list 最多支持 4 组缩小、1 组放大,缩放区间为 camera 原始分辨率的 1/8~1.5 倍之间,例如 cam.open_cam(0, -1, 30, [1920, 1280], [1080, 720])。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X3/pydev_multimedia_api_x3/object_camera.md",
"rdk_x_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X3/pydev_multimedia_api_x3/object_camera.md"
],
"difficulty": "简单",
"source_topic": 25959
},
{
"question": "RDK X3 上用 Python 多媒体 API(srcampy Encoder 对象)做视频编码时,输入图像需要用什么像素格式?",
"expected_answer": "编码输入图像需要使用 NV12 格式:Encoder 的 encode 接口中 img 参数为需要编码的图像数据,需要使用NV12格式(RDK X3 编解码均使用 NV12 数据)。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X3/pydev_multimedia_api_x3/object_encoder.md"
],
"difficulty": "简单",
"source_topic": 27882
},
{
"question": "RDK X3 上做 PTQ 模型转换时,校准图片不想自己预先处理成模型输入格式,yaml 里有什么参数可以开启自动处理?有什么注意点?",
"expected_answer": "在转换配置文件的 calibration_parameters 中配置 preprocess_on: True:启用后标定样本使用 skimage 支持读取的图片格式文件即可,转换工具读取图片后会将其缩放到模型输入节点要求的尺寸,以此结果作为校准输入;关闭状态下则需要把样本做与推理(inference)前一样的前处理,使校准样本与原始模型具备一样的数据类型、尺寸和 layout。注意开启自动处理对量化精度没有保障,官方强烈建议使用关闭 preprocess_on 的方式。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md",
"oe_x3_doc/oe_mapper/source/ptq/ptq_usage/prepare_calibration_data.md"
],
"difficulty": "中等",
"source_topic": 28649
},
{
"question": "RDK X3 模型转换 yaml 中的 core_num 参数是什么含义?设置双核(core_num: 2)理想情况下能带来多大提升?",
"expected_answer": "core_num 是模型运行核心数:D-Robotics 平台支持利用多个 AI 加速器核心同时完成一个推理任务,多核心适用于输入尺寸较大的情况,理想状态下的双核速度可以达到单核的1.5倍左右。双核模型编译时在 yaml 中配置 core_num: 2,运行后会自动占用两个核的资源,把一帧数据拆成两部分分别计算再拼起来(单帧双核),小模型反而可能因双核调度变慢;另有双帧双核(两个核分别跑一个模型独立处理数据帧)方式,时延不变但帧率约 2 倍。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md"
],
"difficulty": "简单",
"source_topic": 26754
},
{
"question": "RDK X5 上安装 Model Zoo 历史分支(rdk_x5_legacy)demo 用的 bpu_infer_lib_x5 Python 推理库,官方文档给出的安装命令是什么?",
"expected_answer": "从 archive.d-robotics.cc 下载 whl 包后本地安装:wget -nc https://archive.d-robotics.cc/downloads/rdk_model_zoo/rdk_x5/bpu_infer_lib_x5-1.0.3-py3-none-any.whl,然后 pip install bpu_infer_lib_x5-1.0.3-py3-none-any.whl。使用 hobot_dnn.pyeasy_dnn 的 demo 则直接用板端系统自带接口,无需额外安装。",
"expected_docs": [
"rdk_doc/docs/04_Algorithm_Application/01_model_zoo/rdk_x5_guide.md"
],
"difficulty": "简单",
"source_topic": 34306
},
{
"question": "RDK X3 算法工具链的 horizon_runtime_sample 示例包中,detection(检测模型)目录下包含哪些示例网络?",
"expected_answer": "detection 检测模型示例包括:centernet_resnet50、efficientdetd0、fcos_efficientnetb0、preq_qat_fcos_efficientnetb0/b1/b2、ssd_mobilenetv1、yolov2_darknet19、yolov3_darknet53、yolov5s;同包还有 classification(efficientnet_lite、googlenet、mobilenetv1/v2、resnet18 等)和 segmentation(deeplabv3plus、fastscnn、unet_mobilenet)示例。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/runtime_sample.md"
],
"difficulty": "简单",
"source_topic": 25581
},
{
"question": "RDK X5(3.x 系统,Ubuntu 22.04)上运行 TROS 节点前 source 环境的 setup.bash 路径是什么?和 2.x(Foxy)系统的路径有什么区别?",
"expected_answer": "Humble 版环境执行 source /opt/tros/humble/setup.bash;旧的 2.x/Foxy 系统则是 source /opt/tros/setup.bash。注意一个终端会话中只能 source 一个 ROS 版本的环境,同时 source 多个版本会导致 PATH、LD_LIBRARY_PATH、PYTHONPATH 等环境变量冲突。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/03_applications_and_examples.md",
"rdk_doc/docs/05_Robot_development/02_quick_demo/demo_sensor.md"
],
"difficulty": "中等",
"source_topic": 28655
},
{
"question": "TogetheROS.Bot(TROS)和标准 ROS2 是什么关系?自己写的 ROS1 程序能直接在 TROS 里用吗?",
"expected_answer": "TogetheROS.Bot 是 D-Robotics 推出的机器人操作系统,其 Communication 通信组件是在 ROS2 Foxy 和 Humble 版本通信核心组件基础上做的功能优化和扩展,与 ROS2 Foxy/Humble 版本接口保持完全兼容,便于复用 ROS 丰富工具包。TROS 基于 ROS2 发布和管理功能包,不提供 ROS1 版本;额外特性包括 zero-copy 进程间零拷贝通信、hobot_dnn 推理、hobot_codec 软硬结合编解码、hobot_cv 硬件加速 CV 算子等。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/tros.md",
"tros_doc/docs/tros.md"
],
"difficulty": "简单",
"source_topic": 27390
},
{
"question": "RDK X3 上硬件解码输出 NV12,用 OpenCV 在 CPU 上转 BGR 再缩放的开销很大,官方推荐用什么硬件模块做缩放前处理?C 接口怎么调用?",
"expected_answer": "使用 VPS(Video Process System,视频处理系统)硬件做缩放前处理:VPS 支持对图像进行缩小、放大、裁剪、旋转等处理,输入源可以是解码后的内存数据。C 接口(sp 接口)用 sp_open_vps 打开 VPS 通道,再用 sp_vio_set_frame 把解码后的图像帧发送给 vps 模块、sp_vio_get_frame 获取处理后的视频图像帧,避免 CPU 上的 NV12 转 BGR 与缩放。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X3/cdev_multimedia_api_x3/vio_api.md",
"rdk_doc/docs/07_Advanced_development/03_multimedia_development/video_processing.md"
],
"difficulty": "中等",
"source_topic": 29034
},
{
"question": "RDK X3 的 40pin 上能不能像树莓派 RPi.GPIO 那样用任意引脚输出软件模拟 PWM?X3 有几个硬件 PWM 通道、对应哪些引脚?",
"expected_answer": "不能。Hobot.GPIO 库仅在带有附加硬件 PWM 控制器的引脚上支持 PWM,与 RPi.GPIO 库不同,Hobot.GPIO 库不实现软件模拟 PWM。RDK X3(和 RDK Ultra)支持 2 个 PWM 通道,对应 40pin 引脚为 33 32。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/01_40pin_user_sample/pwm.md",
"rdk_x_doc/docs/03_Basic_Application/01_40pin_user_sample/pwm.md"
],
"difficulty": "中等",
"source_topic": 31663
},
{
"question": "RDK X5 的网口 MAC 地址每次重启会变化,想让板卡使用固定的 MAC 地址,官方文档给出哪些配置方法?",
"expected_answer": "在系统网络配置中指定 MAC:RDK X5(>= 3.3.0,netplan 方式)修改 [ethernet] 字段添加 cloned-mac-address=12:34:56:78:9A:BA,reboot 重启生效(桌面版也可在网络设置中修改 MAC);旧版本系统(RDK X5 < 3.3.0)在 /etc/network/interfaces 中增加 pre-up ifconfig eth0 hw ether <MAC地址> 配置(如 pre-up ifconfig eth0 hw ether 00:11:22:9f:51:27),reboot 生效。",
"expected_docs": [
"rdk_doc/docs/02_System_configuration/01_network_blueteeth.md",
"rdk_x_doc/docs/02_System_configuration/01_network_blueteeth.md"
],
"difficulty": "中等",
"source_topic": 32573
},
{
"question": "树莓派的 DSI 排线屏幕能直接接在 RDK X3 标准开发板上用吗?RDK X3 的显示输出靠什么接口?",
"expected_answer": "不能。RDK X3 标准板的板载接口为 USB、千兆以太网口、40PIN、MIPI CSI 摄像头接口、HDMI 接口、调试串口等,没有 DSI 屏幕接口,显示输出使用 HDMI接口(可接 HDMI 屏幕)。若需要 MIPI DSI 屏幕接口,应使用 RDK X3 Module 官方载板,其提供了以太网口、USB、HDMI、MIPI CSI、MIPI DSI、40PIN 等外围接口。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/hardware_introduction/rdk_x3.md",
"rdk_x_doc/docs/01_Quick_start/hardware_introduction/rdk_x3.md"
],
"difficulty": "中等",
"source_topic": 25259
},
{
"question": "RDK S100 通过 remoteproc 启动自己编译的 MCU 固件(如 S100_MCU_DEBUG.elf)时,elf 固件文件必须放在板端哪个目录?启动命令是什么?",
"expected_answer": "编译产生的 S100_MCU_DEBUG.elf 是 MCU1 的 firmware 文件,需要推送到板端的 /lib/firmware 目录。然后进入 /sys/class/remoteproc/remoteproc_mcu0,执行 echo S100_MCU_DEBUG.elf > firmware 指定固件,再执行 echo start > state 启动 MCU。",
"expected_docs": [
"rdk_s_doc/docs/07_Advanced_development/05_mcu_development/01_basic_information.md",
"rdk_doc/docs_s/07_Advanced_development/05_mcu_development/01_S100/01_basic_information.md"
],
"difficulty": "简单",
"source_topic": 32096
},
{
"question": "RDK S100 上接多路 Camera 想让各路传感器曝光同步(还要与 Lidar 同步),硬件上依靠什么模块实现?",
"expected_answer": "依靠 S100 的 LPWM 模块:LPWM 主要给 Camera trigger 使用,能提供具有延时输出能力的 PWM 波形,用于校准sensor的曝光同步;它有多个外部 trigger 源可选,可支持与 MCU 或 GPS 设备时间同步(与 Lidar 也可通过 ETH PPS 等方式同步)。S100 总共有 3 个 LPWM chip,每个 LPWM chip 下有 4 个 LPWM 通道,按实际硬件连接配置使用。",
"expected_docs": [
"rdk_s_doc/docs/07_Advanced_development/03_multimedia_development/01_multimedia_development/05_camerasync.md",
"rdk_doc/docs_s/07_Advanced_development/03_multimedia_development/01_S100/05_camerasync.md"
],
"difficulty": "中等",
"source_topic": 33394
},
{
"question": "RDK S100 的 MCU 子板上接了 IMU(如 bmi088),从哪个系统版本开始支持?",
"expected_answer": "从 RDK S100 V4.0.5 系统版本(发布日期 2026-03-03)开始支持MCU子板上的IMU;该版本内核升级为 Linux V6.1.158-rt58,还新增了 ICU GPIO 中断、MCU 透传外设(SPI 等)等功能。",
"expected_docs": [
"rdk_s_doc/docs/10_Release_Note/s100/02_v4_0_5.md",
"rdk_doc/docs_s/10_Release_Note/02_v4_0_5.md"
],
"difficulty": "简单",
"source_topic": 35451
},
{
"question": "RDK X3 上要转换的浮点模型输入不是图像(例如 mel 频谱、坐标序列),模型转换 yaml 的 input_type_rt 应该怎么配置?这种输入有什么格式要求?",
"expected_answer": "input_type_rt 配置为 featuremap(该参数取值范围为 rgb、bgr、yuv444、nv12、gray、featuremap)。featuremap 输入模型的数据只要求是四维数据、每个数值采用 float32 表示(即四维张量),例如雷达和语音等模型处理就常用这个格式;对应的 input_type_train 也可选 featuremap。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md"
],
"difficulty": "中等",
"source_topic": 25381
},
{
"question": "RDK X5 的 bootloader 启动分为哪几个阶段(BL1/BL2/BL31/BL33)?U-Boot 对应哪个阶段?",
"expected_answer": "整个 Bootloader 分为:BL1(Bootloader Level 1,存储在芯片 IROM 中的一段程序,也称之为 Bootrom,负责初始化基本硬件功能)、BL2(负责硬件初始化以及安全校验)、BL31(主要执行与安全有关的操作)、BL33/U-Boot(Bootloader Level 3_3,即 U-Boot)。这是 ARM Trusted Firmware(TF,可信固件)架构中的典型多阶段引导设计,可以实现安全启动和硬件隔离。",
"expected_docs": [
"x5_sdk_doc/linux_development/driver_develop_guide/bootloader_user_guide/1-bootloader-user-guide.md"
],
"difficulty": "简单",
"source_topic": 25461
},
{
"question": "RDK X5 官方双目 MIPI 摄像头同时采集两路图像,TROS 的双目图像采集示例目前支持哪些传感器型号?用什么命令启动?",
"expected_answer": "TROS hobot_sensor 的双目MIPI图像采集目前支持的传感器为 SC230ai(200W)和 SC132gs(200W),支持 RDK X5/X5 Module、RDK S100/S100P 平台。配置 tros.b 环境后用 launch 方式启动:ros2 launch mipi_cam mipi_cam_dual_channel.launch.py;代码仓库为 https://github.com/D-Robotics/hobot_mipi_cam.git。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/02_quick_demo/demo_sensor.md",
"tros_doc/docs/02_quick_demo/demo_sensor.md"
],
"difficulty": "中等",
"source_topic": 33902
},
{
"question": "RDK S100 上跑 Model Zoo 的模型想要 C++ 示例(比如 yolov11-seg 的 C++ 接口),从哪个系统版本开始提供?包含哪些?",
"expected_answer": "V4.0.4(发布日期 2025-10-24)新增支持 C++ BPU 例程,包括:RTSP 运行 YOLOV5X、视频解码后 yolov5x 推理、mipi camera 读图后 yolov5x 推理、USB camera 读图后 yolov5x 推理、paddleOCR 模型推理、ASR 模型推理、LaneNet 模型推理、yoloe11 图像分割模型推理、yolo11 位姿检测模型推理等 C/C++ Sample。",
"expected_docs": [
"rdk_s_doc/docs/10_Release_Note/s100/03_v4_0_4.md",
"rdk_doc/docs_s/10_Release_Note/05_v4_0_4.md"
],
"difficulty": "简单",
"source_topic": 33184
},
{
"question": "RDK S100 上想用 GStreamer 从摄像头取流,camsys v4l2 对 GStreamer 取流的支持是从哪个系统版本开始的?",
"expected_answer": "从 RDK S100 V4.0.5 版本开始,camsys v4l2 支持通过 gstreamer 取流(见 V4.0.5 版本发布说明新增内容,发布日期 2026-03-03)。",
"expected_docs": [
"rdk_s_doc/docs/10_Release_Note/s100/02_v4_0_5.md",
"rdk_doc/docs_s/10_Release_Note/02_v4_0_5.md"
],
"difficulty": "简单",
"source_topic": 35180
},
{
"question": "RDK X3 长时间未使用后执行 sudo apt update 报 Could not resolve 'archive.sunrisepi.tech',应该如何修复软件源?",
"expected_answer": "这是官方软件源域名变更导致本地配置过期。检查 /etc/apt/sources.list.d/sunrise.list,将旧域名 archive.sunrisepi.tech(或 sunrise.horizon.cc 等)替换为新域名 archive.d-robotics.cc,例如:sudo sed -i 's/archive.sunrisepi.tech/archive.d-robotics.cc/g' /etc/apt/sources.list.d/sunrise.list。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "简单",
"source_topic": 28391
},
{
"question": "旭日 X3 SDB 开发板(X3 OE 包环境)上想把 IP、掩码、网关配置成掉电重启后仍然生效的固定值,应该用哪个 hrut 工具命令?如何读取和清除该配置?",
"expected_answer": "使用 hrut_ipfull 工具:写入执行 hrut_ipfull s IP MASK GATEWAY(示例:hrut_ipfull s 192.168.1.10 255.255.255.0 192.168.1.255),配置完成后板子下次上电会自动配置 IP、MASK、GATEWAY 信息;读取用 hrut_ipfull g;清除用 hrut_ipfull c,清除后板子下次上电会使用默认地址 192.168.1.10。",
"expected_docs": [
"oe_x3_doc/oe_mapper/source/appendix/hardware/board_command.md"
],
"difficulty": "简单",
"source_topic": 25532
},
{
"question": "RDK Ultra 上接入 H264 编码的相机,能否用 Ultra 的硬件编解码处理 H264 码流?官方文档如何说明?",
"expected_answer": "不能。RDK Ultra 的 cdev 多媒体编解码 API 文档(编码器和解码器 API 章节开头)都以显著提示(note)明确说明:RDK Ultra 不支持 H264 编解码,因此 H264 码流无法通过 Ultra 的硬件编解码通道处理。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_Ultra/multi_media_api/cdev_multimedia_api_ultra/encoder_api.md",
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_Ultra/multi_media_api/cdev_multimedia_api_ultra/decoder_api.md"
],
"difficulty": "中等",
"source_topic": 27521
},
{
"question": "RDK S100 用官方 MIPI 扩展板接了两个 IMX219,hobot_vio 的 Python 示例无法同时打开两个相机。S 系列多媒体示例中哪个示例支持同时接入多路 Sensor 输入?",
"expected_answer": "sample_pipeline 示例中的 multi_pipe_vin_isp_ynr_pym_gdc_vpu(多路 sensor pipeline 串联并编码示例):它支持同时接入多路 Sensor 输入,并通过 VIN、ISP、PYM、GDC、CODEC 等多个处理模块进行视频流处理。",
"expected_docs": [
"rdk_s_doc/docs/07_Advanced_development/03_multimedia_development/02_multimedia_application/09_sample_pipeline.md",
"rdk_doc/docs_s/07_Advanced_development/03_multimedia_development/02_multimedia_application/09_sample_pipeline.md"
],
"difficulty": "简单",
"source_topic": 33232
},
{
"question": "RDK S600 上电后只有 D61 灯常亮、无法进入系统,这表示板卡处于什么状态?板上 SW2 是什么开关,想让系统正常启动应把 SW2 拨到哪一侧?",
"expected_answer": "D61 是 Flash 指示灯:熄灭表示正常启动模式,常亮表示处于 DFU 烧录模式。SW2 是烧录开关:ON 为 DFU 烧录模式,OFF 为正常启动模式;要正常进入系统需将 SW2 拨至 OFF(仅在烧录系统时按步骤将 SW2 拨至 ON 进入 DFU 模式)。",
"expected_docs": [
"rdk_s_doc/docs/01_Quick_start/01_hardware_introduction/02_rdk_s600/01_rdk_s600.md",
"rdk_s_doc/docs/01_Quick_start/02_install_os/rdk_s600/03_burn.md"
],
"difficulty": "简单",
"source_topic": 35521
},
{
"question": "RDK X5 桌面版系统手边没有 HDMI 显示器,想远程进入开发板的图形可视化桌面,官方文档提供哪些方式?",
"expected_answer": "两种官方方式:1) VNC 登录——使用 VNC Viewer 图形桌面共享软件远程登录开发板(面向 Ubuntu Desktop 系统版本用户),支持直接、云端两种连接方式,文档推荐直接连接;2) RDK Studio 的「远程桌面」功能——设备连接成功后在 Studio 同一页面显示板端桌面,可直接用鼠标键盘操作,无需在电脑上额外安装远程桌面软件。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/remote_login.md",
"rdk_studio_doc/docs/3-user-guide/6-remote-desktop/index.md"
],
"difficulty": "简单",
"source_topic": 34868
},
{
"question": "RDK X5 与 RDK X3 用 cdev 编码接口(sp_encoder)送入图像编码时,对输入图像的对齐要求有什么区别?",
"expected_answer": "X3/X5 的 cdev 编码 API 文档中的注意事项写明:编码的图片 RDK X5 需要 16bit 对齐,RDK X3 可以 8/16bit 对齐。",
"expected_docs": [
"rdk_x_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/cdev_multimedia_api_x5/encoder_api.md",
"rdk_x_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X3/cdev_multimedia_api_x3/encoder_api.md"
],
"difficulty": "中等",
"source_topic": 26248
},
{
"question": "RDK X3 的 40pin 串口(如 /dev/ttyS3)被禁用、板端看不到串口设备,用什么系统配置工具重新使能 40pin 上的 Serial Port?该配置修改的本质是什么?",
"expected_answer": "使用 srpi-config 系统配置工具:命令行执行 sudo srpi-config(桌面系统也可打开 RDK Configuration 应用),在 Interface Options 中启用/禁用 40pin 接口上的 SPI、I2C、Serial Port、I2S 等接口(RDK X3 在 40PIN 上默认使能 UART3,物理管脚 8 和 10)。该配置方式会直接修改使用的设备树文件中对应总线的 status,重启后生效。注意 srpi-config 仅适用于 RDK X3、RDK X5 和 RDK X3 Module,不适用于 RDK Ultra。",
"expected_docs": [
"rdk_doc/docs/02_System_configuration/02_srpi-config.md",
"rdk_x_doc/docs/02_System_configuration/02_srpi-config.md"
],
"difficulty": "中等",
"source_topic": 27598
},
{
"question": "在 RDK X5 的 OE 算法工具链上,模型里有工具链不支持的算子,想自己实现自定义算子并放到 BPU 上运行,可行吗?自定义算子提供什么开发能力、包含哪些阶段?",
"expected_answer": "不可行:自定义算子只提供 CPU 上算子开发能力。一个完整的自定义算子应用过程包括创建模板、算子实现、算子编译、含自定义算子模型转换和运行含自定义 op 模型几个阶段;其中在模型转换阶段需要提供自定义 OP 的 Python 代码,在模拟器/上板运行推理阶段需要提供自定义 OP 的 C++ 代码,并要确保这两部分代码运算的一致性。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/custom_op.md",
"oe_x3_doc/oe_mapper/source/ptq/ptq_usage/custom_op.md"
],
"difficulty": "中等",
"source_topic": 27034
},
{
"question": "RDK X3 运行 Web 显示摄像头示例(/app/pydev_demo/05_web_display_camera_sample)后,如何在电脑上查看 MIPI 摄像头画面?运行 Python 脚本前需要先做什么?",
"expected_answer": "先运行 ./start_nginx.sh 启动 Nginx 服务器,再运行 python3 mipi_camera_web.py;程序启动 Web 服务后,在浏览器中访问开发板的 IP 地址即可查看实时视频流和目标检测结果,默认地址是 http://192.168.127.10。另外采用 IMX477 相机时,需要将 mipi_camera_web.py 文件中的 fps 设置为 50。",
"expected_docs": [
"rdk_x_doc/docs/03_Basic_Application/03_pydev_demo_sample/RDK_X3/05_web_display_camera_sample.md",
"rdk_doc/docs/03_Basic_Application/03_pydev_demo_sample/RDK_X3/05_web_display_camera_sample.md"
],
"difficulty": "简单",
"source_topic": 24833
},
{
"question": "RDK S100 能否把板载 Wi-Fi 配置成 Soft AP 热点模式供其他设备连接?官方文档目前的说明是什么?",
"expected_answer": "暂不可用。S 系列文档「网络与蓝牙配置」的 Soft AP 模式章节目前仅给出提示:RDK S100 的 WIFI AP 模式暂不可用,持续更新中(具体的 AP 配置步骤尚未开放)。",
"expected_docs": [
"rdk_doc/docs_s/02_System_configuration/01_network_bluetooth.md",
"rdk_s_doc/docs/02_System_configuration/01_network_bluetooth.md"
],
"difficulty": "中等",
"source_topic": 32928
},
{
"question": "RDK S100 用 Python 推理接口部署多输入模型(例如带提示词、转换后有多个 input tensor 的模型)时,hbm_runtime 的 run() 支持怎样的输入传参格式?",
"expected_answer": "hbm_runtime 的 run() 支持灵活输入格式:单输入传 numpy.ndarray;单模型多输入传字典 Dict[str, np.ndarray](key 为 input tensor name);多模型多输入传 Dict[str, Dict[str, np.ndarray]](外层 key 为 model name,内层 key 为 input tensor name)。所有输入会自动检查是否为 C 连续内存格式,必要时自动拷贝转换。",
"expected_docs": [
"rdk_s_doc/docs/04_Algorithm_Application/02_Python_API.md",
"rdk_doc/docs_s/04_Algorithm_Application/02_Python_API.md"
],
"difficulty": "中等",
"source_topic": 32590
},
{
"question": "RDK X5/X3 的 OpenExplorer 发布包里,官方开源的分类/检测/分割等参考算法的公版 PyTorch 训练实现(例如 deeplabv3+)放在包内什么路径?",
"expected_answer": "在 samples/ai_toolchain/horizon_model_train_sample 路径(X3 OE 包中为 ddk/samples/ai_toolchain/horizon_model_train_sample)。该路径下开源了分类/检测/分割等场景高效模型的公版 Pytorch 实现,支持在宿主机上进行训练和复现;其浮点及 QAT 训练基础环境可参考「QAT 量化环境部署」章节。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/env_install/env_deploy.md",
"oe_x3_doc/oe_mapper/source/env_install/env_deploy.md"
],
"difficulty": "简单",
"source_topic": 27147
},
{
"question": "RDK X3 上用 OpenCV 的 cv2.VideoCapture 打开 USB(UVC)摄像头,默认应使用哪个设备号?如何确认实际设备节点?",
"expected_answer": "USB 摄像头接入后默认设备节点通常是 /dev/video8(也可能是 /dev/video9、/dev/video10 等,取决于系统中是否有其他视频设备或多个 USB 摄像头)。可在接入摄像头后执行 ls /dev/video* 查看实际生成的设备节点,OpenCV 等程序中使用摄像头时需指定正确的设备节点号,例如 cv2.VideoCapture(8)。",
"expected_docs": [
"rdk_x_doc/docs/08_FAQ/02_interface.md",
"rdk_doc/docs/08_FAQ/02_interface.md"
],
"difficulty": "简单",
"source_topic": 25799
},
{
"question": "RDK X3 的 40PIN 排针上引出了哪条 SPI 总线?使用哪些物理管脚、支持几个片选、IO 电压是多少?",
"expected_answer": "RDK X3 在 40PIN 上通过物理管脚 19、21、23、24 引出芯片的 SPI2 总线,支持一个片选,IO 电压 3.3V。作为对比:RDK X5 在 40PIN 管脚 19/21/23/24/26 引出 SPI1 总线(支持两个片选),RDK Ultra 引出 SPI0 总线(支持两个片选)。板端可运行 /app/40pin_samples/test_spi.py 做回环测试。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/01_40pin_user_sample/spi.md",
"rdk_x_doc/docs/03_Basic_Application/01_40pin_user_sample/spi.md"
],
"difficulty": "简单",
"source_topic": 28606
},
{
"question": "RDK X5 用 hb_mapper makertbin 编译 BPU 模型时,yaml 里的 core_num 参数能像 RDK X3 那样设置成 2 利用双核吗?",
"expected_answer": "不能。core_num 参数的作用是设置模型运行核心数,取值范围为 1、2,默认配置为 1;多核心适用于输入尺寸较大的情况,理想状态下双核速度可达单核的 1.5 倍左右,但该选项在 X5 上仅支持配置为 1(RDK Ultra 同样尚不支持,此参数只适用于 RDK X3)。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md"
],
"difficulty": "中等",
"source_topic": 35405
},
{
"question": "用 hb_mapper makertbin 编译 RDK X5 的 BPU 模型时,想在编译阶段批量删除模型输出端的 Dequantize(反量化)节点,yaml 中应配置哪个参数?它支持哪些取值、对被删除节点有什么要求?",
"expected_answer": "在 yaml 的 model_parameters 配置组中配置 remove_node_type 参数,用于设置删除节点的类型,不同类型用 ; 分割,例如 remove_node_type: \"Dequantize\"。取值范围为 Quantize、Transpose、Dequantize、Cast、Reshape、Softmax。被删除的节点必须在模型的开头或者末尾、与模型的输入或输出连接;待删除节点会按顺序依次删除并动态更新模型结构,因此节点的删除顺序很重要。不设置或设置为空不影响模型转换过程。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md",
"oe_x5_doc/oe_mapper/source/tune_content/performance_tune.md"
],
"difficulty": "简单",
"source_topic": 29121
},
{
"question": "RDK X5 模型转换 yaml 中的 max_time_per_fc 参数作用是什么?取值范围和默认值是多少?",
"expected_answer": "max_time_per_fc 指定模型的每个 function call 的最大可连续执行时间(单位 μs)。编译后的模型在 BPU 上推理时表现为一个或多个 function-call(BPU 的执行粒度)的调用,模型只有在单个 function-call 执行完时才有机会被抢占。取值范围为 0 或 1000-4294967295,默认配置为 0(不做限制)。该参数仅用于实现模型抢占功能,如无需实现该功能可以忽略;模型抢占功能仅支持在板端实现,不支持模拟器实现。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md"
],
"difficulty": "简单",
"source_topic": 33819
},
{
"question": "RDK X5 上想查看 bin 模型逐层(每个 BPU 算子)的耗时等性能信息来定位性能瓶颈,模型转换 yaml 中哪个参数控制编译 debug 信息?开启后在哪里能看到逐层数据?",
"expected_answer": "debug 参数:是否打开编译的 debug 信息,取值 True/False(X5 工具链默认 True)。默认开启该参数时,模型的静态分析的性能结果将保存在模型中,可在模型转换成功后生成的静态性能评估文件 html 页和 hb_perf 时产生的 html 页内的 Layer Details 选项卡中查看模型逐层 BPU 算子的性能信息,包括计算量、原始和对齐后的算子输出 shape、计算耗时、数据搬运耗时以及编译后 layer 活跃时间段。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md"
],
"difficulty": "简单",
"source_topic": 28708
},
{
"question": "RDK X5 的 OE Runtime 板端示例中,以 feature(featuremap)数据为输入的模型推理示例脚本是哪个?示例代码对输入 feature 做了什么处理?",
"expected_answer": "03_misc 目录下的 run_resnet50_feature.sh:该脚本主要实现 feature 数据输入的 resnet50 模型推理功能。示例代码对 feature 数据做了 quantize 和 padding 以满足模型的输入条件,然后输入到模型进行 infer,进入 03_misc 目录直接执行 sh run_resnet50_feature.sh 即可。",
"expected_docs": [
"oe_x5_doc/runtime/source/basic_sample/basic_sample.md"
],
"difficulty": "简单",
"source_topic": 26999
},
{
"question": "RDK X3 芯片的 I2S 接口支持哪些采样率、采样精度和传输协议?",
"expected_answer": "X3 芯片的 I2S:采样率支持 8k/16k/32k/48k/44.1k/64k;采样精度支持 8bit/16bit;传输协议支持 i2s/dsp(TDM)A。此外音频输入支持 1/2/4/8/16 通道输入,音频输出支持 1/2 通道输出。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/02_linux_development/driver_development/driver_codec_dev.md",
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/driver_development/driver_codec_dev.md"
],
"difficulty": "简单",
"source_topic": 28784
},
{
"question": "RDK X3 的 I2S 配置为 slave(从模式)时,读写 I2S 寄存器有什么必须注意的要求?",
"expected_answer": "I2S 做 slave 时,在需要读写 i2s 寄存器操作前,必须要有 bclk 时钟灌入,否则会访问 i2s 模块寄存器异常,导致系统不能正常工作。补充:I2S 做 master 模式下的默认时钟 mclk 为 12.288M、bclk 为 2.048M,mclk 不变时 bclk 支持 6.144M/4.096M/3.072M/2.048M/1.536M 动态调整。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/02_linux_development/driver_development/driver_codec_dev.md",
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/driver_development/driver_codec_dev.md"
],
"difficulty": "简单",
"source_topic": 27759
},
{
"question": "RDK X5 芯片一共提供几个 I2C 控制器?分布在哪些子系统?哪一路支持高速模式?",
"expected_answer": "X5 总共提供 8 个 I2C 控制器,其中 7 个(I2C0~6)位于 LSIO 子系统,1 个(I2C7)位于 DSP 子系统;所有 8 个 I2C 控制器只有 I2C4 支持 high-speed mode(3.4Mb/s)。I2C 速率默认 100K,支持 100k/200k/400k/1M/3.4M,可通过修改 DTS 中相应 I2C 节点的 clock-frequency 字段完成速率修改。",
"expected_docs": [
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/driver_development_x5/driver_i2c_dev.md"
],
"difficulty": "简单",
"source_topic": 28222
},
{
"question": "手头没有 RDK S100/S600 开发板,能在 x86 电脑上运行、调试 S 系列工具链(UCP)的量化模型和示例代码吗?和板端相比性能有什么区别?",
"expected_answer": "可以。除开发板外,UCP 还在 x86 仿真环境下提供了与板端同样的开发能力支撑,所有的示例及接口代码均可以在仿真环境中等效使用,可在 x86 环境中进行代码开发和调试并即时获得反馈,确保代码能够无缝迁移到 SoC 硬件上运行。但 x86 仿真环境采用指令级仿真方式,需要逐条指令进行模拟和执行,仿真性能通常低于实际硬件的性能。",
"expected_docs": [
"oe_s_doc/guide/ucp/ucp_overview.md"
],
"difficulty": "简单",
"source_topic": 33850
},
{
"question": "RDK X5 上想用硬件加速把 NV12 等 YUV 图像转换成 RGB(类似其他平台的 RGA),X5 芯片的 2D GPU 支持吗?基础规格如何?使用前必须先调用什么接口?",
"expected_answer": "支持。X5 的 2D GPU 支持色彩空间转换,即 YUV 转 RGB 和 RGB 转 YUV(Color Space Convert),此外还支持位块传输、拉伸位图传输、矩形填充和清除、透明度混合、90°/180°/270° 旋转、镜像翻转、ROP、裁剪、多源融合等。基础规格:最大分辨率为 4K(即 3840*2160),处理性能 4k@90fps。如果想使用 N2D 功能,必须先调用 n2d_open 获取 GPU 的上下文和资源。注意使用 GPU2D 做 YUV 与 RGB 之间格式转换时会存在误差。",
"expected_docs": [
"x5_sdk_doc/multimedia_development/12-2DGPU_API_zh_CN.md",
"x5_sdk_doc/samples/sample_gpu_2d.md"
],
"difficulty": "中等",
"source_topic": 33360
},
{
"question": "RDK X5 上已经用 RGB 图像完成 QAT 训练的模型,而 BPU 图像金字塔输出的是 centered YUV 格式,不想重新训练模型如何补救部署?QAT 插件提供什么算子、插在什么位置、还需要什么配套修改?",
"expected_answer": "在推理模型的开头(QuantStub 的后面)插入 horizon.functional.centered_yuv2rgb(或 centered_yuv2bgr)算子,把输入的 YUV 图像实时转换为 RGB 格式。使用方法:先获取 QAT 时 QuantStub 的 scale 和 RGB 图像归一化参数 mean/std;调用 convert_fx(convert)接口将 qat 模型转为 quantized 模型后插入该算子;由于该算子已包含对 RGB 图像的量化操作,插入后需手动将 QuantStub 的 scale 参数改为 1;swing 参数应设为 \"full\" 与 BPU 的 YUV 数据格式对齐。注意:该算子为部署专用算子,请勿在训练阶段使用;它在 BPU 上采用定点运算实现,会引入一定精度损失,仅作为补救方案,推荐训练时就用 rgb2centered_yuv 等函数把 RGB 转成 YUV。",
"expected_docs": [
"oe_x5_doc/plugin/source/advanced_content/rgb888_deploy.md"
],
"difficulty": "困难",
"source_topic": 26637
},
{
"question": "RDK X5 上 QAT 训练得到的模型(包含地平线自定义算子)无法用 netron 可视化,horizon_plugin_pytorch 提供什么接口来查看模型图结构?",
"expected_answer": "使用 horizon_plugin_pytorch.quantization.visualize_model 接口,以 HBDK 的视角可视化 nn.Module 或 jit.ScriptModule。参数:module 为待可视化的模型;example_inputs 为 torch.tensor 格式的示例输入,用于 jit trace 和 shape 推断;march 可指定目标 BPU 架构,取值 bayes、bernoulli2、bayes-e,不提供则使用 horizon plugin 的全局 march;还可指定 save_path 保存路径和 show 是否展示。",
"expected_docs": [
"oe_x5_doc/plugin/source/api_reference/apis/compiler.md",
"oe_x5_doc/plugin/source/quick_start/quick_start.md"
],
"difficulty": "简单",
"source_topic": 26705
},
{
"question": "RDK S100 上使用 SC230AI 双目 MIPI 摄像头,官方从哪个系统(SDK)版本开始提供对应的采集 Sample?",
"expected_answer": "RDKS100_LNX_SDK_V4.0.3(发布日期 2025-09-01)。该版本 Release Note 的 Sample 部分注明:新增多媒体模块及链路 Sample,其中增加了 SC230AI 和 SC132GS 的 Sample。",
"expected_docs": [
"rdk_s_doc/docs/10_Release_Note/s100/04_v4_0_3.md"
],
"difficulty": "简单",
"source_topic": 32198
},
{
"question": "RDK X5 可以 SSH 连接但 VNC 一直连不上,如何在板端开启 VNC 服务?",
"expected_answer": "VNC 默认未开启,需要在板端运行 srpi-config,进入 Interface Options(接口选项)启用 VNC,该选项用于启用/禁用 X11vnc 虚拟网络计算服务器;接口选项菜单中还可启用/禁用 SSH、VNC、SPI、I2C、I2S、Serial 等功能。",
"expected_docs": [
"rdk_doc/docs/02_System_configuration/02_srpi-config.md",
"rdk_x_doc/docs/02_System_configuration/02_srpi-config.md"
],
"difficulty": "简单",
"source_topic": 28331
},
{
"question": "RDK 开发板 40PIN 上的 3.3V 和 5V 电源引脚最大各能输出多大电流?对板卡的输入适配器有什么要求?",
"expected_answer": "40PIN 的 3.3V 最大支持 800mA 输出,5V 最大支持 500mA 输出;在上述最大输出电流下,要求 RDK 的输入适配器最小支持 25W 带载能力。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/01_40pin_user_sample/40pin_define.md",
"rdk_x_doc/docs/03_Basic_Application/01_40pin_user_sample/40pin_define.md"
],
"difficulty": "简单",
"source_topic": 28462
},
{
"question": "RDK X3/X5 板卡 40PIN 的管脚默认使能 UART、SPI、I2C、I2S 等专用功能,想把某个管脚改作普通 GPIO 使用,应该怎么配置?",
"expected_answer": "需要通过 srpi-config 配置工具进行配置。同一组复用功能中只有开启其中一项功能时才会生效;当所有复用功能都关闭时,接口才会表现为普通 GPIO 功能。okay 配置对应管脚为专用功能,disabled 关闭该管脚的专用功能(可用作 GPIO),配置重启后生效。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/01_40pin_user_sample/40pin_define.md",
"rdk_x_doc/docs/03_Basic_Application/01_40pin_user_sample/40pin_define.md"
],
"difficulty": "简单",
"source_topic": 28202
},
{
"question": "使用地平线 QAT/HAT 量化训练插件做精度分析时,如何在 TensorBoard 中查看网络每一层输入输出的直方图?调用什么接口、有哪些参数?",
"expected_answer": "调用 OpRunningInfoManager 的 tensorboard() 方法,可在 tensorboard 中显示每一层输入输出直方图。参数:out_dir 为 tensorboard 相关文件保存目录(默认保存到 self.out_dir/tensorboard 目录下);prefixes 指定需要统计的 op 前缀(默认统计所有);types 指定 op 的 type(默认统计所有);force_per_channel 控制是否以 per_channel 量化的方式展示直方图。",
"expected_docs": [
"oe_x3_doc/plugin/source/user_guide/quant_analysis.md",
"oe_x5_doc/plugin/source/user_guide/quant_analysis.md"
],
"difficulty": "中等",
"source_topic": 26228
},
{
"question": "在 RDK S100 上已经跑通 YOLO 目标检测,想继续做多目标跟踪,Model Zoo 有现成的示例吗?代码在哪个目录、支持哪些平台?",
"expected_answer": "有。RDK Model Zoo(rdk_model_zoo_s,见 rdk_s_guide 模型列表)提供多目标跟踪示例 ByteTrack,代码位于 samples/vision/bytetrack,支持 S100 / S100P / S600。",
"expected_docs": [
"model_zoo_doc/docs/rdk_s_guide.md"
],
"difficulty": "中等",
"source_topic": 31867
},
{
"question": "RDK X5 的显示子系统接入了 DRM/KMS 框架,内核的 DRM 驱动模块叫什么名字?如何查看板上的 DRM 资源?",
"expected_answer": "X5 显示子系统软件部分接入 DRM 框架(分为用户空间的 libdrm 和内核空间的 DRM 驱动),DRM 驱动模块为 vs_drm,相关模块还包括 galcore、vio_n2d、lontium_lt8618、vs-x5-syscon-bridge、panel-jc-050hd134 等。可用 modetest -M vs-drm 命令查看 Encoders、Connectors 等 DRM 资源,运行前需先 modprobe 加载上述模块。",
"expected_docs": [
"x5_sdk_doc/multimedia_development/9-Display_zh_CN.md"
],
"difficulty": "中等",
"source_topic": 28412
},
{
"question": "RDK X5 上做图像几何校正类的预处理(鱼眼/畸变矫正、全景展开、梯形校正等)不想占用 CPU,多媒体部分提供了什么硬件模块?使用流程是怎样的?",
"expected_answer": "使用 GDC 模块。GDC API 属于 HBN 框架的一部分,作为一个 vnode 可与其他 vnode 连接形成 vflow;GDC 模块只支持 offline 模式,从 DDR 读数据,处理完再写到 DDR。使用主要涉及三部分:GDC Tool 用于效果仿真并生成 GDC 配置参数文件(layout.json 或 config.bin),提供 Affine、Equisolid、Equisolid(cylinder)、Equidistant、Custom、Keystone+dewarping 六种变换模式;GDC bin API 用于生成 GDC bin 文件(hbn_gen_gdc_bin_json 或 hbn_gen_gdc_bin);GDC API 用于打开、关闭 GDC 节点及配置属性。板端示例见 sample_gdc(如 gdc_equisolid 处理 NV12 全景校正、gdc_transformation 做梯形校正+去畸变)。",
"expected_docs": [
"x5_sdk_doc/multimedia_development/8.0-GDC_Overview_zh_CN.md",
"x5_sdk_doc/samples/sample_gdc.md"
],
"difficulty": "中等",
"source_topic": 34910
},
{
"question": "RDK 板卡通过 HDMI 连接显示器时提示当前输入时序不被支持(如 The current input timing is not supported)或黑屏,官方 FAQ 建议如何处理?",
"expected_answer": "部分显示器可能与板卡输出的特定分辨率或刷新率不完全兼容;RDK OS 2.1.0 及以上版本引入了更多的 HDMI 分辨率支持,但也可能导致与某些旧显示器的兼容性问题;通常标准 1080p(1920x1080)分辨率的显示器在板卡启动时直接连接,兼容性较好。遇到显示不兼容时,可先通过 VNC 连接到板卡(如果已开启),然后在系统中手动调整 HDMI 的输出分辨率。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "中等",
"source_topic": 27326
},
{
"question": "RDK X3 的硬件视频解码模块(VPU/JPU)最大通道数是多少?H.264/H.265 解码支持的最大分辨率和最大性能分别是多少?",
"expected_answer": "X3 解码基础规格:硬件解码模块 VPU/JPU 的最大通道数为 32;VPU 支持 H.264(最大 8192x8192、最小 32x32)和 H.265(最大 8192x8192、最小 8x8),JPU 支持 JPEG/MJPEG(最大 32768x32768、最小 16x16);最大性能 H.264/H.265 为 3840×2160 @60fps,JPEG/MJPEG 为 YUV4:2:0 290M pixel/sec。(以上为 X3 cdec 多媒体 API 手册口径)",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/03_multimedia_development/video_decode.md",
"rdk_x_doc/docs/07_Advanced_development/03_multimedia_development/video_decode.md"
],
"difficulty": "简单",
"source_topic": 25163
},
{
"question": "RDK X3 上想读取开发板的板卡 ID(Boardid)作为设备标识,用什么工具和命令?该 ID 存放在哪里、能否设置?",
"expected_answer": "使用 hrut_utilities 工具集(用于处理器侧采集/设置系统信息,包括板卡 ID 查询/设置、BPU/DDR 状态监控、温度传感器读数等)中的 hrut_boardid 命令:执行 hrut_boardid g 可读取(get)Boardid,hrut_boardid s 可设置(set)Boardid;Boardid 存储在 veeprom 中,因此可以被设置,并非只读的唯一硬件标识。",
"expected_docs": [
"oe_x3_doc/oe_mapper/source/appendix/hardware/board_command.md"
],
"difficulty": "简单",
"source_topic": 25962
},
{
"question": "用 RDK X3/X5 的 OE 工具链做 PTQ 模型转换时,转换过程各阶段会产出哪些中间 ONNX 模型文件?它们各自的特点是什么?",
"expected_answer": "模型解析阶段产出 original_float_model.onnx(计算精度仍为 float32,输入部分加入了数据预处理节点);模型优化阶段产出 optimized_float_model.onnx(float32,做 BN 融合到 Conv 等平台优化,不影响计算结果);模型校准阶段产出 calibrated_model.onnx(校准得到的量化参数保存在校准节点中);模型量化阶段产出 quantized_model.onnx(计算精度已是 int8,可用于评估量化带来的精度损失)。",
"expected_docs": [
"oe_x3_doc/oe_mapper/source/ptq/ptq_usage/quantize_compile.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_usage/quantize_compile.md"
],
"difficulty": "中等",
"source_topic": 26261
},
{
"question": "RDK OE 工具链 PTQ 示例 mapper 目录下的 00_init.sh、01_check.sh、02_preprocess.sh、03_build.sh、04_inference.sh 脚本分别用于做什么?",
"expected_answer": "00_init.sh 用于获取当前示例所需的模型和校准数据集;01_check.sh 用于对模型进行预验证;02_preprocess.sh 用于对数据进行预处理;03_build.sh 用于转换 debug 模型;04_inference.sh 用于使用 onnx runtime 进行推理。",
"expected_docs": [
"oe_x3_doc/oe_mapper/source/ptq/ptq_sample/misc_sample.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_sample/misc_sample.md"
],
"difficulty": "中等",
"source_topic": 25683
},
{
"question": "TROS 的 DnnNode(hobot_dnn)C++ 推理 Run 接口中,如何指定同步/异步推理模式?参数取值分别是什么含义?",
"expected_answer": "Run 接口中名为 is_sync_mode 的参数指定预测模式:true 为同步模式,false 为异步模式(异步是效率更高的推理模式)。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/05_tros_dev/ai_predict.md",
"tros_doc/docs/05_tros_dev/ai_predict.md"
],
"difficulty": "简单",
"source_topic": 28666
},
{
"question": "RDK X3 的 Server 系统/console 模式下想修改 HDMI 显示分辨率,官方提供什么配置工具?该工具适用于哪些开发板?",
"expected_answer": "使用系统配置工具 srpi-config(命令行执行 sudo srpi-config,桌面系统也可在菜单中打开 RDK Configuration 应用),在 Display Options 的 FB Console Resolution 中设置 Server 系统和 console 模式下的 HDMI 显示分辨率。srpi-config 仅适用于 RDK X3、RDK X5 和 RDK X3 Module 开发板,不适用于 RDK Ultra。",
"expected_docs": [
"rdk_doc/docs/02_System_configuration/02_srpi-config.md",
"rdk_x_doc/docs/02_System_configuration/02_srpi-config.md"
],
"difficulty": "简单",
"source_topic": 28850
},
{
"question": "RDK 板卡上没有接摄像头,想体验 TROS 的 YOLO 目标检测算法效果,官方示例支持什么运行方式?",
"expected_answer": "支持使用本地回灌:无摄像头的情况下通过回灌本地 JPEG/PNG 格式图片或 MP4、H.264 和 H.265 的视频方式体验算法效果,渲染结果保存在本地。示例启动命令为 ros2 launch dnn_node_example dnn_node_example_feedback.launch.py(配合 dnn_example_config_file 和 dnn_example_image 参数),渲染图片如 render_feedback_0_0.jpeg 保存在运行路径下。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/detection/yolo.md",
"tros_doc/docs/03_boxs/detection/yolo.md"
],
"difficulty": "简单",
"source_topic": 25415
},
{
"question": "RDK Studio 应该安装在 RDK 开发板上还是电脑上?它支持哪些电脑系统的安装包?",
"expected_answer": "RDK Studio 是安装在电脑上的桌面客户端,搭配 RDK 开发板使用,不是装在开发板上。支持 Windows 10/11(64-bit,.exe 安装器)和 macOS(Apple Silicon/M 系列芯片,.dmg);暂不提供 32 位 Windows、Windows 7/8/8.1、Intel Mac、Linux/Ubuntu 桌面客户端安装包。",
"expected_docs": [
"rdk_studio_doc/docs/2-quick-start/1-install-and-login.md"
],
"difficulty": "简单",
"source_topic": 29093
},
{
"question": "RDK X3 开发板想查网口、USB 等接口的线序和原理,硬件原理图从哪里获取?1.0 和 2.0 版本原理图文件分别叫什么?",
"expected_answer": "RDK X3 硬件开发文档的「设计资料」章节提供硬件原理图、机械尺寸图等下载:RDK X3 1.0 原理图为 RDK_X3_IO_Schematics.pdf,RDK X3 2.0 原理图为 RDK_X3_2.0_IO_Schematics.pdf(托管在 archive.d-robotics.cc)。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/01_hardware_development/rdk_x3/hardware.md"
],
"difficulty": "简单",
"source_topic": 28902
},
{
"question": "RDK 板端推理时报模型版本与 BPU SDK/工具链版本不一致类错误,官方 FAQ 认为关键要保证什么版本兼容?工具链 Docker 基于 Ubuntu 20.04 会影响模型在板端 Ubuntu 22.04 系统上运行吗?",
"expected_answer": "通常不会影响。工具链 Docker 镜像只提供模型转换环境,生成的模型文件(.bin 用于 PTQ,.hbm 用于 QAT)是针对 RDK 板卡上特定 BPU 架构的二进制指令和权重数据,与板端操作系统的 Ubuntu 版本(20.04 或 22.04)解耦;关键是保证板端使用的 BPU 驱动和 Runtime 库(如 libdnn.so 等)与模型转换时使用的工具链版本兼容。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/05_toolchain.md",
"rdk_x_doc/docs/08_FAQ/05_toolchain.md"
],
"difficulty": "简单",
"source_topic": 29033
},
{
"question": "RDK X5 的调试串口接入 Linux/Ubuntu 主机后出现不识别,官方文档指出可能与主机上的哪个系统服务有关?如何解决?",
"expected_answer": "若 Linux/Ubuntu 系统中安装了 brltty,brltty 会通过 udev 规则扫描接入系统的 USB 设备(如 CH340、CP2102、FT232 等)并抢占 CH340 驱动,导致调试串口不识别。优先检查系统是否安装 brltty,如果存在,建议使用 apt remove brltty 命令卸载。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/hardware_introduction/rdk_x5.md"
],
"difficulty": "简单",
"source_topic": 27655
},
{
"question": "RDK X3 的 BPU 能否加速 Sub(减法)算子?RDK X5 上的支持情况有什么不同?",
"expected_answer": "两个平台不同:在 RDK X3 支持的 ONNX 算子列表中,Sub 为 CPU计算(不满足 BPU 加速),其约束为支持相同输入 shape 计算、支持输入 1 是标量或输入 2 是标量的计算、支持 broadcast 计算且最大维度是 5;而 RDK X5 的 Sub 为 BPU加速,支持 int16 输入输出,输入类型支持 featuremap 和常量且最多支持一个常量输入,支持所有维度的广播(两个输入之间可互相广播,例如 NH1C 和 N1WC),输入输出维度支持 1-10 维。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/supported_op_list.md"
],
"difficulty": "中等",
"source_topic": 31382
},
{
"question": "RDK X5 上用双目 Occupancy Network(OCC,dstereo_occnet)做实时在线推理,对相机有什么要求?做离线推理需要准备什么数据?",
"expected_answer": "双目 OCC 算法如果要实时在线推理,目前只支持搭配 ZED-2i 相机;如果要离线推理,需要准备矫正后的双目图像数据。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/spatial/dstereo_occupancy.md",
"tros_doc/docs/03_boxs/spatial/dstereo_occupancy.md"
],
"difficulty": "简单",
"source_topic": 33457
},
{
"question": "RDK X3 上TROS hobot_audio 智能语音节点配置文件中的 asr_mode 字段有哪些取值?分别是什么含义?",
"expected_answer": "asr_mode 字段设置是否发布 ASR 结果:默认值为 0,表示不输出 ASR 结果;改为 1 表示唤醒后进行一次 ASR 识别并发布结果;改为 2 表示一直进行 ASR 识别并发布结果。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/audio/hobot_audio.md"
],
"difficulty": "简单",
"source_topic": 27852
},
{
"question": "RDK X5 一共有几路 SPI 控制器?40PIN 上引出的是哪几路?SPI 主模式(Master)和从模式(Slave)的最高工作频率分别是多少?",
"expected_answer": "X5 共支持 7 路 SPI 控制器,其中 6 路(spi0-spi5)位于 LSIO 子系统、1 路(spi6)位于 DSP 子系统,所有 SPI 控制器均支持主/从模式;RDK X5 在 40PIN 上引出的主要是 SPI1 和 SPI2,其他 SPI 口不在 40pin 上。运行限制:SPI-Master 最高频率 50MHz,SPI-Slave 最高频率 32MHz。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/02_linux_development/driver_development_x5/driver_spi_dev.md",
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/driver_development_x5/driver_spi_dev.md"
],
"difficulty": "简单",
"source_topic": 28638
},
{
"question": "RDK X5 上用 Python 多媒体库(srcampy)的 Encoder.encode 创建编码通道时,video_chn 通道号的取值范围是多少?encode_type 参数 1~3 分别对应什么编码格式?",
"expected_answer": "Encoder.encode(video_chn, encode_type, width, height, bits) 中:video_chn 指定视频编码器的通道号,范围为 0~31;encode_type 为视频编码类型,范围 1~3,分别对应 H264、H265、MJPEG;输入编码模块的图像宽度和高度均不超过 4096。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/pydev_multimedia_api_x5/object_encoder.md",
"rdk_x_doc/docs/03_Basic_Application/06_multi_media_sp_dev_api/RDK_X5/pydev_multimedia_api_x5/object_encoder.md"
],
"difficulty": "简单",
"source_topic": 31155
},
{
"question": "RDK X5 上 TROS 双目深度估计(hobot_stereonet)中 mipi_gdc_enable 参数的作用是什么?官方双目相机做图像畸变矫正的参数从哪里来?",
"expected_answer": "mipi_gdc_enable 控制相机开启 GDC 矫正:开启后相机会读取 EEPROM 存储的参数进行图像的畸变矫正,目前官方生成的双目相机都带有出厂标定参数。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/spatial/hobot_stereonet.md"
],
"difficulty": "简单",
"source_topic": 28702
},
{
"question": "RDK 开发板(X 系列)推荐的环境工作温度范围是多少?开发测试阶段和产品化阶段分别有什么散热建议?",
"expected_answer": "推荐环境温度为 -20°C 至 60°C,请确保设备在此温度范围内运行,以保障其稳定性和可靠性。散热建议:开发与测试阶段建议配备散热片、RDK Case 及散热风扇等辅助散热措施;产品化阶段需根据整机热环境进行充分的热设计评估与优化,确保芯片在各种使用场景下的工作温度处于合理范围,避免因过热导致性能下降或系统异常。",
"expected_docs": [
"rdk_doc/docs/RDK.md",
"rdk_x_doc/docs/RDK.md"
],
"difficulty": "简单",
"source_topic": 26563
},
{
"question": "RDK X5 上同时运行多个模型时,大模型推理任务独占 BPU 导致高优先级模型无法及时执行,官方 OpenExplorer Runtime 提供什么控制策略?使用 PTQ 方案时在 yaml 里配置什么参数?上板运行还要设置什么环境变量和接口参数?",
"expected_answer": "官方提供多模型控制策略即模型优先级控制:X5 的 BPU 计算单元硬件本身没有任务抢占功能,Runtime SDK 基于模型优先级以软件方式实现 BPU 资源抢占,抢占粒度为 function-call。具体做法:PTQ 方案在模型转换阶段于 yaml 的 compiler_parameters 中添加 max_time_per_fc 参数(QAT 方案则在编译接口中配置 max-time-per-fc 选项),把大的 function-call 拆小;上板时先执行 export BPLAT_CORELIMIT=1 设置可抢占粒度(取值 0 表示不抢占);再通过 dnn infer 接口的 hbDNNInferCtrlParam.priority 参数(如配置为 HB_DNN_PRIORITY_PREEMP(255))把任务设为抢占任务。",
"expected_docs": [
"oe_x5_doc/runtime/source/runtime_dev.md",
"oe_x3_doc/runtime/source/runtime_dev.md"
],
"difficulty": "困难",
"source_topic": 31276
},
{
"question": "RDK GS130W 双目相机(SC132GS 传感器)的 FFC/FPC 软排线损坏需要自行更换,应购买什么规格的排线?安装连接时有哪些注意事项?",
"expected_answer": "需要 FFC/FPC 线缆 x2,规格为 22pin、0.5mm 间距、同面触点。注意事项:连接 FFC/FPC 排线时务必将开发板断电,避免因接触打火或触点错位导致设备烧毁;排线是柔性材质导线,勿大力拉扯;GS130W 模组与 GS130WI 模组接入 FFC/FPC 排线的方向相反,注意区分切勿反接。",
"expected_docs": [
"accessories_stereo_camera_doc/docs/01_stereo_camera_gs130w/02_installation.md",
"accessories_doc/docs/01_stereo_camera_gs130w/02_installation.md"
],
"difficulty": "简单",
"source_topic": 35614
},
{
"question": "RDK 板端调用 BPU SDK 推理时返回错误码 -6000001 表示什么错误?-6000011 又是什么?",
"expected_answer": "错误码定义见 BPU SDK 错误码列表:-6000001 为 HB_DNN_INVALID_ARGUMENT(非法参数);-6000011 为 HB_DNN_INVALID_TASK_HANDLE(非法 task handle)。相关错误还有 -6000012 HB_DNN_RUN_TASK_FAILED(任务执行失败)、-6000010 HB_DNN_TASK_BATCH_SIZE_EXCEED_LIMIT(多任务处理数量超限制)等。",
"expected_docs": [
"oe_x5_doc/runtime/source/bpu_sdk_api/bpu_sdk_api.md",
"oe_x3_doc/runtime/source/bpu_sdk_api/source/bpu_sdk_api_doc.md"
],
"difficulty": "简单",
"source_topic": 28437
},
{
"question": "RDK OS 2.x 和 RDK OS 3.x 系统上的 TROS 分别基于哪个 ROS2 发行版?能否通过 apt upgrade 从 Foxy 直接升级到 Humble?",
"expected_answer": "在 RDK OS 2.x(基于 Ubuntu 20.04)上 TROS 通常基于 ROS2 Foxy Fitzroy;在 RDK OS 3.x(基于 Ubuntu 22.04)上 TROS 通常基于 ROS2 Humble Hawksbill。由于 TROS 版本与 RDK OS 底层 Ubuntu 版本紧密绑定,通常无法直接通过 apt upgrade 等命令将 TROS 从一个大 LTS 版本(如 Foxy)升级到另一个大 LTS 版本(如 Humble)。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_x_doc/docs/08_FAQ/06_tros_ros.md"
],
"difficulty": "简单",
"source_topic": 28927
},
{
"question": "RDK X5 上官方适配列表中的 IMX219 摄像头(800W 像素)支持哪些分辨率和帧率?其中 FOV 对角 120 度的 Pi5 版 IMX219 使用前需要额外做什么?",
"expected_answer": "X5 配件清单中 IMX219 摄像头支持:1920x1080@30fps(默认)、640x480@30fps、1632x1232@30fps、3264x2464@15fps(最大)。其中微雪 Pi5 版 IMX219(FOV 对角 120 度)需要先使用 srpi-config 切换效果库后再使用。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/accessory.md",
"rdk_x_doc/docs/01_Quick_start/accessory.md"
],
"difficulty": "简单",
"source_topic": 28809
},
{
"question": "RDK X5 想给 RTC 外接一块电池(手头有树莓派用的 4.2V 可充电 RTC 电池),官方文档对 RTC 电池的电压、电流有什么要求?4.2V 的电池能用吗?",
"expected_answer": "RDK X5 硬件文档要求:RTC 供电时电池电压为 2~3.3V、放电电流 >2.5uA;开机后 PMIC 检测到 RTC 电压低到充电电压时会自动给 RTC 充电,要求电池可承受的最大充电电压 >=3.3V、最大可允许充入电流 >1mA;且必须使用可充电 RTC 电池,非充电的 RTC 不可以用于供电。4.2V 电池超出 2~3.3V 的供电电压要求,不符合文档要求。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/hardware_introduction/rdk_x5.md",
"rdk_doc/docs/01_Quick_start/hardware_introduction/rdk_x5.md"
],
"difficulty": "简单",
"source_topic": 28236
},
{
"question": "RDK X5 的 RTC 电池接口两个引脚哪个是正极?板子重启后系统时间总是回到 1970-01-01,怎么解决?",
"expected_answer": "RDK X5 的 RTC 电池接口中,靠近 PWR(电源按键)的引脚为 B+(正极),另一引脚为 GND。重启后硬件时间回到 1970 说明没有 RTC 电池维持时钟,需要外接 RTC 电池来保持系统时间。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/hardware_introduction/rdk_x5.md",
"rdk_doc/docs/01_Quick_start/hardware_introduction/rdk_x5.md"
],
"difficulty": "简单",
"source_topic": 35277
},
{
"question": "RDK X3 上运行 TROS 智能可视化示例后,在 PC 浏览器查看图像/AI 渲染结果应输入什么地址?websocket 默认端口被占用了怎么处理?",
"expected_answer": "PC 浏览器(chrome/firefox/edge)输入 http://IP:8000 即可查看(IP 为 RDK 的 IP 地址)。websocket 默认需要使用 8000 端口,被占用会启动失败:可用 lsof -i:8000 查看占用进程并 kill 后重启 websocket;或者修改 /opt/tros/${TROS_DISTRO}/lib/websocket/webservice/conf/nginx.conf 配置中的 listen 端口号为大于 1024 且未使用的端口,并同步修改浏览器端 URL。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/02_quick_demo/demo_render.md",
"tros_doc/docs/02_quick_demo/demo_render.md"
],
"difficulty": "简单",
"source_topic": 26312
},
{
"question": "RDK X5 的 PTQ 模型转换 yaml 中 calibration_type 参数支持哪些校准算法取值?默认是什么?转换时报出 NaN threshold 相关错误想更换校准算法,mix 是什么策略?",
"expected_answer": "calibration_type 取值范围:'default'、'mix'、'kl'、'max'、'load' 和 'skip',默认配置为 'default'。kl 和 max 是公开的校准量化算法;mix 是一个集成多种校准方法的搜索策略,能够自动确定量化敏感节点并在节点粒度上挑选最佳方法,构建融合多种校准方法优势的组合校准方式;load 用于 QAT(plugin 导出)的模型;skip 使用随机数据校准、无需准备校准数据,仅适合验证模型结构,得到的模型不可用于精度验证。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md",
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md"
],
"difficulty": "简单",
"source_topic": 34041
},
{
"question": "RDK X5 的 CAN 接口与外部 CAN 设备通信时完全收不到也发不出去(只对接了 CAN_H/CAN_L),硬件接线有什么要求?两台设备软件上还要配置什么?",
"expected_answer": "按官方双设备通信测试的硬件连接要求:GND 接 GND、L 接 L、H 接 H,即双方必须共地构成回路,只接 CAN_H/CAN_L 不够。软件上两台设备要配置相同的 CAN 总线位速率(例如 ip link set can0 type can bitrate 125000)后再起接口收发。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/can.md",
"rdk_x_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/can.md"
],
"difficulty": "简单",
"source_topic": 32171
},
{
"question": "RDK 板卡解码 RTSP 视频流报错或解不出来,尤其是用 ffmpeg 从 .mp4/.avi 视频文件推流时,推流命令需要加什么选项?为什么不推荐用 VLC 直接推流?",
"expected_answer": "用 ffmpeg 从视频文件(如 .mp4、.avi)推流时,建议在命令中添加 -bsf:v h264_mp4toannexb(较新版本 ffmpeg 中 -vbsf 已被 -bsf:v 替代),例如 ffmpeg -re -stream_loop -1 -i xxx.mp4 -c:v copy -bsf:v h264_mp4toannexb -f rtsp rtsp://IP:8554/h264_stream。原因是推流码流(尤其 H.264)必须包含 PPS 和 SPS 参数信息,解码器需要这些信息才能正确解析,该过滤器会自动为码流添加 PPS 和 SPS。VLC 直接推流可能不支持主动添加/保证 PPS 和 SPS 信息,因此不推荐;另外 RDK 对 RTSP 流解码分辨率有支持范围(如 1080p),需确认流分辨率。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/04_multimedia.md",
"rdk_x_doc/docs/08_FAQ/04_multimedia.md"
],
"difficulty": "中等",
"source_topic": 33390
},
{
"question": "RDK X3 的 VDEC 视频解码模块支持哪些解码协议?H.264/H.265 硬解码对送入的第一帧码流有什么要求(例如拉海康 RTSP 流时 HB_VDEC_GetFrame 失败)?",
"expected_answer": "VDEC 支持 H.264/H.265/JPEG/MJPEG 硬件解码:VPU 负责 H.264/H.265,JPU 负责 JPEG/MJPEG。H.264/H.265 解码的时候第一帧要给齐 sps、pps、idr,如果只给 sps 就会报错,报错信息是 FAILED TO DEC_PIC_HDR: ret(1), SEQERR(00005000)。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/03_multimedia_development/video_decode.md",
"rdk_x_doc/docs/07_Advanced_development/03_multimedia_development/video_decode.md"
],
"difficulty": "中等",
"source_topic": 25864
},
{
"question": "RDK X3 上用 VENC 做 H.264/H.265 或 JPEG/MJPEG 硬件编码,输入图像的 stride、宽、高各有什么对齐要求?输入不满足对齐时怎么办?",
"expected_answer": "H.264/H.265 的 stride 是 32 字节对齐,width 和 height 都是 8 字节对齐;MJPEG、JPEG 的 stride 是 32 字节对齐,width 是 16 字节对齐,height 是 8 字节对齐。如果不是对齐的,建议使用 VIDEO_CROP_INFO_S 去做对应的裁剪。",
"expected_docs": [
"rdk_x_doc/docs/07_Advanced_development/03_multimedia_development/video_encode.md",
"rdk_doc/docs/07_Advanced_development/03_multimedia_development/video_encode.md"
],
"difficulty": "简单",
"source_topic": 25276
},
{
"question": "RDK X3 烧录官方系统镜像(桌面版/服务器版)后,板子里有没有预装 TROS(ROS2 环境)?还需要再手动执行完整安装流程吗?",
"expected_answer": "TROS 通常在烧录官方提供的 RDK OS 系统镜像时就已内置并预装在板卡上,不需要在烧录完系统后再手动执行完整的 TROS 安装流程(使用 ros2 相关命令前需先 source 对应版本的 tros 环境脚本)。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/06_tros_ros.md",
"rdk_x_doc/docs/08_FAQ/06_tros_ros.md"
],
"difficulty": "简单",
"source_topic": 25403
},
{
"question": "RDK X5 上用 BPU SDK C API 开发:hbDNNInfer 提交推理任务后如何等待推理完成?hbDNNWaitTaskDone 的 timeout 参数取值分别是什么含义,返回值 0 代表什么?",
"expected_answer": "提交推理任务后调用 hbDNNWaitTaskDone(taskHandle, timeout) 等待任务完成或超时,等待结束后再解析模型输出。timeout > 0 表示等待时间(单位毫秒);timeout <= 0 表示一直等待,直到任务完成。返回 0 表示 API 成功执行,否则执行失败。",
"expected_docs": [
"oe_x5_doc/runtime/source/bpu_sdk_api/bpu_sdk_api.md",
"oe_x5_doc/runtime/source/runtime_dev.md"
],
"difficulty": "简单",
"source_topic": 29071
},
{
"question": "RDK X5 双目深度估计(hobot_stereonet)提供多个模型版本,输出深度图的分辨率有哪几档?当前主版本和最新版本分别是什么?",
"expected_answer": "X5 上各模型版本输出规格有 640x352x3x2 和 544x448x3x2 两档:V2.0~V2.4 系列输出 640x352x3x2,当前主版本为 V2.4_int16(高精度深度估计,15fps)和 V2.4_int8(高帧率,23fps);最新版本为 V2.5 系列,包括 V2.5_int16、V2.5_int16_96(最大搜索视差 96 视差)以及输出 544x448 分辨率的 V2.5_int16_544_448(15fps)和 V2.5_int16_544_448_96(17fps)。要不同的深度图输出分辨率需选用对应模型版本。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/spatial/hobot_stereonet.md",
"tros_doc/docs/03_boxs/spatial/hobot_stereonet.md"
],
"difficulty": "中等",
"source_topic": 34333
},
{
"question": "RDK X5 上做 SLAM 建图,TROS 手册的 SLAM 建图应用用什么建图算法?怎么安装(Foxy/Humble)?各组件分别运行在哪里?",
"expected_answer": "TROS 的 SLAM 建图应用使用 ROS2 的 SLAM-Toolbox 作为建图算法。安装 TROS 后通过 apt 安装:Foxy 执行 sudo apt-get install ros-foxy-slam-toolbox,Humble 执行 sudo apt-get install ros-humble-slam-toolbox;若报 nav2-map-server 依赖错误,先 apt update 再 sudo apt install libwebp6=0.6.1-2ubuntu0.20.04.3 后安装。架构上 SLAM-Toolbox 运行在 RDK 上,Gazebo 和 Rviz2 运行在与 RDK 同一网段的 PC 上。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/04_apps/slam.md",
"tros_doc/docs/04_apps/slam.md"
],
"difficulty": "简单",
"source_topic": 35357
},
{
"question": "在 RDK X5/S100 上部署端侧视觉语言模型(hobot_llamacpp,如 InternVL2_5、InternVL3、SmolVLM2),需要准备哪两类模型文件?X5 和 S100 平台的视觉模型文件有什么区别?",
"expected_answer": "需要两类模型文件:视觉模型文件和语言模型 gguf 文件,例如 InternVL2_5-1B 在 X5 上为 vit_model_int16_v2.bin + Qwen2.5-0.5B-Instruct-Q4_0.gguf。区别在视觉模型格式:RDK X5/X5 Module 用 .bin 文件(如 vit_model_int16_v2.bin),RDK S100/S100P 用 .hbm 文件(如 vit_model_int16.hbm),语言模型统一为 .gguf 格式,可从 hf-mirror 的 D-Robotics 仓库下载。该示例基于 llama.cpp 的 KV Cache 管理能力并结合 BPU 计算优势实现本地 VLM 部署,支持平台为 RDK X5/X5 Module 与 RDK S100/S100P(Ubuntu 22.04/Humble)。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/generate/hobot_llamacpp.md",
"tros_doc/docs/03_boxs/generate/hobot_llamacpp.md"
],
"difficulty": "中等",
"source_topic": 33716
},
{
"question": "在 x86 开发机上用 TROS 交叉编译 Docker 环境编译出 ROS2 功能包后,如何部署到 RDK 板端运行?需要拷贝什么内容、放到哪个目录?",
"expected_answer": "将编译生成的 install 目录整体拷贝至 RDK 中并重命名为 tros,部署包放在 /opt/tros 目录下,与 deb 安装目录保持一致。如果使用了 minimal_build.sh 进行最小化编译,还可以执行 ./minimal_deploy.sh -d \"install_path\" 进一步压缩部署包大小。",
"expected_docs": [
"tros_doc/docs/01_quick_start/cross_compile.md",
"rdk_doc/docs/05_Robot_development/01_quick_start/cross_compile.md"
],
"difficulty": "简单",
"source_topic": 27123
},
{
"question": "TROS 的 dnn_node 示例(如 YOLO 目标检测)把算法推理结果发布到哪个话题上?想用 ros2 订阅检测框结果应该订阅哪个话题名?",
"expected_answer": "dnn_node 示例发布算法推理结果的 topic 为 hobot_dnn_detection(无前导斜杠),可用 ros2 订阅该话题获取检测结果;同时该示例订阅图片的 topic 为 /hbmem_img(零拷贝图像话题)。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/detection/yolo.md",
"tros_doc/docs/03_boxs/detection/yolo.md"
],
"difficulty": "简单",
"source_topic": 28426
},
{
"question": "能否把不做量化的纯浮点(FP32)模型直接编译后放到 RDK X5 的 BPU 上运行?",
"expected_answer": "不能。D-Robotics BPU 架构的处理器使用 INT8 的计算精度(业内处理器的通用精度),只能运行定点量化模型;上板前需要用算法工具链把浮点模型量化为定点模型。工具链主要使用训练后量化 PTQ 方法,只需一批校准数据对训练好的浮点模型校准即可。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/overview.md",
"x5_sdk_doc/toolchain_development/overview.md"
],
"difficulty": "简单",
"source_topic": 28376
},
{
"question": "RDK S100/S100P 上运行 LLM 大模型时如何调整模型可用的内存空间?运行 7B 模型报内存不足时应切换到哪种模式?",
"expected_answer": "S100/S100P 底软提供 /usr/hobot/bin/hb_switch_ion.sh 脚本分配模型可使用的内存空间,有 balanced 和 bpu_first 两种使用方式,执行后需 reboot 重启生效。建议运行 3B 及以内的模型时使用 balanced 模式,若运行 7B 模型报错请切换到 bpu_first 模式;bpu_first 模式下模型可使用最多的内存空间,适合运行 7B 模型的场景。",
"expected_docs": [
"oe_llm_s100p_doc/guide/quickstart/S100P/ion_allocate.md"
],
"difficulty": "简单",
"source_topic": 34291
},
{
"question": "RDK S100 上如何用命令行使能蓝牙、让设备可被发现,并与手机等设备完成配对?",
"expected_answer": "执行 sudo bluetoothctl 进入交互模式,用 show 查看蓝牙信息(留意 powered 和 discoverable 状态);执行 power on 使能蓝牙;为让蓝牙被附近设备发现,需执行 discoverable on 使能蓝牙并打开蓝牙可发现属性,附近设备即可扫描到名为 ubuntu 的蓝牙设备;scan on 可周期性打印附近设备,scan off 关闭扫描;配对命令为 pair [targetMAC],输入后根据提示输入 yes,对端设备选择配对即可。更多功能可查阅 BlueZ 官方帮助说明。",
"expected_docs": [
"rdk_s_doc/docs/02_System_configuration/01_network_bluetooth.md",
"rdk_doc/docs_s/02_System_configuration/01_network_bluetooth.md"
],
"difficulty": "简单",
"source_topic": 34694
},
{
"question": "RDK X3 Module 在 U-Boot 命令行下操作(例如把板载 eMMC 映射为 USB 存储设备烧录)时,为防止看门狗超时导致设备重启,应先执行什么命令?",
"expected_answer": "在 U-Boot 中执行 watchdog off 关闭看门狗,防止设备重启;随后可执行 ums 0 mmc 0,将板载 eMMC 设备(设备号 0)通过 USB OTG 接口 0 映射为 USB Mass Storage 设备,使主机系统将其识别为标准 U 盘进行直接读写或烧录。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/install_os/rdk_x3_module/01_system_burn.md"
],
"difficulty": "简单",
"source_topic": 27979
},
{
"question": "RDK X3 上如何查看当前系统镜像版本和已安装的 tros.b 版本?tros.b 与系统镜像版本有什么对应关系?",
"expected_answer": "系统版本:登录板卡后 cat /etc/version 查看系统大版本号(如 2.0.0),用 apt list --installed | grep hobot 查看已安装的地瓜核心功能包版本,较新系统(2.1.0 及以后)还可用 rdkos_info 命令一次性收集软硬件版本、驱动加载清单等信息。tros.b 版本:Foxy 用 apt show tros、Humble 用 apt show tros-humble 查看 Version 字段。对应关系:2.x 版本 tros.b 仅支持 2.x 版本系统镜像,1.x 版本 tros.b 仅支持 1.x 版本系统;使用 1.x 系统镜像需先将系统升级到 2.x。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_doc/docs/05_Robot_development/01_quick_start/install_tros.md",
"rdk_doc/docs/09_Appendix/rdk-command-manual/cmd_rdkos_info.md"
],
"difficulty": "中等",
"source_topic": 26336
},
{
"question": "RDK X3 多媒体 C 接口中 HB_VP_DmaCopy 的功能是什么?函数参数分别是什么含义?",
"expected_answer": "HB_VP_DmaCopy 用于通过 DMA 拷贝物理内存,函数声明为 int HB_VP_DmaCopy(void *dstPaddr, void *srcPaddr, uint32_t len)。参数:dstPaddr 为目的物理地址,srcPaddr 为源物理地址,len 为长度(均为输入);返回 0 表示成功,非 0 表示失败。注意该接口操作的是物理地址而非用户态虚拟地址。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/03_multimedia_development/system_control.md"
],
"difficulty": "简单",
"source_topic": 25826
},
{
"question": "地平线 OE 包 ai_benchmark 中提供的 fps.sh 和 latency.sh 脚本分别测试什么?如何使用?",
"expected_answer": "fps.sh 利用多线程调度实现 fps 统计,用户可根据需求自由设置线程数;采用多线程并发方式让模型在 BPU 上达到极致性能,启动阶段帧率较低,之后上升并趋于稳定,帧率浮动范围控制在 0.5% 之内。latency.sh 实现单帧延迟统计(一个线程,单帧)。使用方法:进入需要评测的模型目录下,执行 sh fps.sh 测帧率、sh latency.sh 测单帧延迟。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/runtime_sample.md",
"oe_x3_doc/runtime/source/ai_benchmark/source/ai-benchmark.md"
],
"difficulty": "简单",
"source_topic": 28064
},
{
"question": "在 RDK X5 上部署 featuremap 输入的量化模型(如 st-gcn 骨架行为识别),用 bpu_infer_lib 或 hobot_dnn.pyeasy_dnn 这两个 Python 推理接口可以吗?应该改用哪个接口?",
"expected_answer": "不建议。bpu_infer_lib 和 hobot_dnn.pyeasy_dnn 都对 featuremap 输入模型支持不佳,如需使用 featuremap 输入模型,请使用 hbm_runtime 推理接口(RDK X5 或 RDK S 系列)。",
"expected_docs": [
"rdk_doc/docs/04_Algorithm_Application/01_model_zoo/infer_api_ref.md",
"model_zoo_doc/docs/infer_api_ref.md"
],
"difficulty": "中等",
"source_topic": 34786
},
{
"question": "RDK X3(标准版)开发板的 MIPI CSI 接口官方适配了哪些摄像头模组?各自的分辨率是多少?",
"expected_answer": "RDK X3 提供 1 路 MIPI CSI 接口,目前已适配多种规格的摄像头模组:GC4663(400W)、JXF37(200W)、IMX219(800W)、IMX477(1200W)、OV5647(500W)。模组通过 FPC 排线与开发板连接(排线两端蓝面向上插入连接器),安装后可用 i2cdetect 确认模组 I2C 地址能否正常检测到。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/hardware_introduction/rdk_x3.md"
],
"difficulty": "简单",
"source_topic": 24478
},
{
"question": "TROS 的 mono2d_body_detection(人体检测和跟踪)算法使用的网络模型是什么?在 RDK X3 上的输入尺寸和推理帧率是多少?",
"expected_answer": "算法信息表中模型为 fastrcnn,输入尺寸 1x3x544x960;RDK X3 上推理帧率约 74.96 fps(RDK X5 上约 125.21 fps)。该算法发布包含人体、人头、人脸、人手框和人体关键点检测结果的 msg,并通过多目标跟踪(MOT)实现检测框跟踪;X86 版本暂不支持多目标跟踪以及 Web 端展示功能。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/body/mono2d_body_detection.md",
"tros_doc/docs/03_boxs/body/mono2d_body_detection.md"
],
"difficulty": "简单",
"source_topic": 28574
},
{
"question": "TROS 有没有人手关键点检测的示例功能包?它的工作方式、使用模型和支持平台是什么?",
"expected_answer": "有,人手关键点检测(hand_lmk_detection)示例订阅图片和包含人手框信息的智能 msg(人手框由 mono2d_body_detection 提供),利用 BPU 推理后发布包含人手关键点信息的算法 msg,可用于自定义手势识别等场景。模型为 handLMKs,输入尺寸 8x21,X3 上 806 fps、X5 上 948 fps;支持 RDK X3/X3 Module(Foxy/Humble)、RDK X5/X5 Module(Humble)、RDK Ultra(Foxy),通过 websocket 在 PC 浏览器渲染结果。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/body/hand_lmk_detection.md",
"tros_doc/docs/03_boxs/body/hand_lmk_detection.md"
],
"difficulty": "简单",
"source_topic": 25815
},
{
"question": "PTQ 转换后,PC 端推理的 quanti.onnx 与板端 bin 模型的输入数据排布(layout)一定一致吗?用同一张图片推理两者输出差异很大时应先排查什么?",
"expected_answer": "不一定完全一致。bin 模型的输入数据排布与 yaml 配置文件中的 input_layout_rt 对齐,而 quanti.onnx 的排布会因多种因素改变:当 input_type_rt 为 nv12 时 input_source 默认为 pyramid,quanti.onnx 输入均为 NHWC;当 input_type_rt 为 yuv444/rgb/bgr 等类型时 input_source 默认为 ddr,quanti.onnx 输入与原始浮点模型一致。PC 端建议用可视化工具查看 onnx 输入 shape,板端用 hrt_model_exec model_info 或 BPU SDK 的 hbDNNGetInputTensorProperties() 获取 bin 输入 shape;输出差异很大时先排查输入数据排布是否正确。",
"expected_docs": [
"oe_x3_doc/oe_mapper/source/ptq/ptq_usage/ptq_faq.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_faq_troubleshooting/ptq_faq.md"
],
"difficulty": "困难",
"source_topic": 25440
},
{
"question": "RDK Ultra 上能不能跑 TROS 的人脸关键点检测(face_landmarks_detection,人脸106关键点)?该算法官方支持哪些平台?",
"expected_answer": "不支持 RDK Ultra。人脸106关键点检测(face_landmarks_detection)的支持平台为 RDK X3、RDK X3 Module 和 RDK X5、RDK X5 Module(Ubuntu 22.04 Humble)。模型为 faceLandmark106pts,输入尺寸 1x3x128x128,X3 上推理帧率 741.93 fps、X5 上 985.75 fps;该示例订阅图片以及 mono2d_body_detection 发布的人脸框检测结果,经 websocket 在 PC 浏览器渲染。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/body/mono_face_landmarks_detection.md",
"tros_doc/docs/03_boxs/body/mono_face_landmarks_detection.md"
],
"difficulty": "中等",
"source_topic": 28877
},
{
"question": "RDK X3 上想修改内核启动阶段的调试串口波特率,应该改哪个文件?修改后如何让配置生效?",
"expected_answer": "内核启动阶段的波特率配置位于 /boot/boot.cmd 文件中;修正串口配置后需要重新生成 boot.scr 文件,命令为:mkimage -C none -A arm -T script -d boot.cmd boot.scr。(调试串口默认参数:波特率 921600、数据位 8、奇偶校验 None、停止位 1、无流控。)",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/hardware_introduction/rdk_x3.md"
],
"difficulty": "简单",
"source_topic": 32215
},
{
"question": "RDK X3 通过 VNC 远程桌面连接时无法向电脑传递文件,RDK 开发板和电脑之间有哪些常用的文件传输方式?",
"expected_answer": "常用方式包括:1)SCP:用 scp 拷贝单个文件、scp -r 拷贝整个文件夹(Windows 端可用 WinSCP、MobaXterm 或 Git Bash 中的 scp);2)SFTP:FileZilla、WinSCP 等 FTP 客户端选择 SFTP 协议,使用 SSH 的用户名、密码和 IP 登录,图形化传输;3)USB 存储设备:U 盘/移动硬盘格式化为 FAT32、exFAT(或安装 ntfs-3g 后的 NTFS),插入开发板 USB Host 口后挂载(如 sudo mount /dev/sda1 /mnt/usb_disk,设备节点可能变化);4)ADB:adb push 从电脑推送文件到开发板,adb pull 从开发板拉取文件;5)网络共享:配置 Samba 或 NFS 将目录共享到局域网;6)临时共享小文件:在待共享目录执行 python3 -m http.server 8000,电脑浏览器访问 http://<开发板IP>:8000 下载。开发过程中的代码/配置同步推荐 SCP/SFTP 或 VS Code Remote-SSH。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "中等",
"source_topic": 26842
},
{
"question": "在 RDK X5 上用 hb_mapper makertbin 转换模型时,yaml 中 compiler_parameters 的 compile_mode(编译策略)参数有哪些取值?各自的优化目标是什么?",
"expected_answer": "compile_mode 的取值范围为 'latency'、'bandwidth'、'balance',默认配置为 'latency'。latency 以优化推理时间为目标;bandwidth 以优化 ddr 的访问带宽为目标;balance 平衡优化目标 latency 和 bandwidth,设置为此项需指定 balance_factor(取值范围 0-100,仅在 compile_mode 为 balance 时配套使用:配置为 0 即为带宽最优,对应 bandwidth 策略;配置为 100 即为性能最优,对应 latency 策略)。如果模型没有严重超过预期的带宽占用,建议使用 latency 策略。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/ptq/ptq_tool/hb_mapper/hb_mapper_makertbin.md",
"oe_s_doc/guide/ptq/ptq_tool/hb_compile/convert.md"
],
"difficulty": "简单",
"source_topic": 25577
},
{
"question": "RDK X3 上模型中的 Sigmoid、Tanh、Sin 等激活函数在 BPU 上是如何实现的?什么情况下会回退到 CPU 计算?官方建议如何替代?",
"expected_answer": "对于 BPU 原生无法支持的算子(包括 Cos、Sin、Sigmoid、Softplus、Sqrt、Tanh 等激活函数),地瓜机器人开发了查表算子,对应模型转换日志里的 HzLUT(Horizon Look up Table)算子类型。查表算子本身的计算效率不如 ReLU、ReLU6 这种 BPU 原生支持的算子,但少量查表算子不会过多影响模型整体性能。需要注意的是,当查表算子执行时的 align_shape(NxCxHxW)大小超过 8192 时会回退至 CPU 计算,因此更建议将此类激活替换为 ReLU/ReLU6。",
"expected_docs": [
"oe_x3_doc/oe_mapper/source/advanced_content/efficient_model_advice.md"
],
"difficulty": "中等",
"source_topic": 26369
},
{
"question": "在 RDK X3 上转换包含 ScatterElements/ScatterND 的 ONNX 模型(PyTorch 导出时 indices 为 int64)时类型报错,这两个算子在 X3 上运行在 BPU 还是 CPU?indices 支持什么类型?",
"expected_answer": "在 RDK X3 的 ONNX 算子支持列表中,ScatterElements 和 ScatterND 均为 CPU 计算算子(已在 ARM CPU 上优化的算子,支持 opset10 与 opset11)。类型约束方面:data、updates、to_type 的 type 约束支持 float、int32、int8;ScatterElements 的 indices 类型约束仅支持 int32(不支持 int64),因此需要把 indices 修改为 int32 后再进行模型转换。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/supported_op_list.md"
],
"difficulty": "中等",
"source_topic": 31296
},
{
"question": "RDK X3 的 Conv 卷积算子是否支持 3D 卷积(五维输入)?RDK X5 的 Conv 算子支持情况有何不同?",
"expected_answer": "RDK X3 的 ONNX Conv 算子仅支持 4 维 Conv 计算,不支持 3D 卷积(五维输入);未列出或不满足约束条件的算子因 BPU 硬件限制暂不支持,无法通过工具链转换(ConvTranspose 同样只支持 4 维)。RDK X5 的 Conv 为 BPU 加速算子,支持四维输入(conv2d)和五维输入(conv3d):conv3d 输入大小 NCDHW 中 N ∈ [1,128]、H,W,D,C ∈ [1,65536],kernel 的 H,W ∈ [1,31]、D ∈ [1,8191],stride 要求 H、W 同为 1 或同为 2,group 和 dilation 暂不支持。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/supported_op_list.md"
],
"difficulty": "中等",
"source_topic": 29016
},
{
"question": "RDK X3 开发板的 USB Host 和 USB Device 模式是什么关系?Micro USB(Device)口接入设备后 USB Host 口还能用吗?",
"expected_answer": "RDK X3 的 USB 主从模式切换完全由硬件电路实现,用户只需按照接口逻辑连接设备即可,无需软件配置。开发板 USB Host、Device 功能互斥:Device 接口接入设备后,Host 接口会自动失效;反之在 Host 口(如 USB Type A)接入设备则工作在 Host 模式。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/hardware_introduction/rdk_x3.md",
"rdk_x_doc/docs/01_Quick_start/hardware_introduction/rdk_x3.md"
],
"difficulty": "简单",
"source_topic": 28303
},
{
"question": "RDK 开发板上蓝牙功能默认没有开启(hciconfig 查看不到设备)时应如何初始化?从哪个系统版本开始蓝牙默认随系统启动?",
"expected_answer": "可以执行 /usr/bin/startbt.sh 脚本进行初始化,该脚本完成以下工作:完成蓝牙初始化、执行 hciconfig hci0 up 完成蓝牙的 Link Up、执行 hciconfig hci0 piscan 进行蓝牙扫描。从 3.0.0 系统开始,蓝牙默认随系统启动,无需手动重复初始化,在 RDK X3 和 RDK X5 平台上均保持一致;用户还可以通过命令查询蓝牙进程是否正常运行。",
"expected_docs": [
"rdk_doc/docs/02_System_configuration/01_network_blueteeth.md",
"rdk_x_doc/docs/02_System_configuration/01_network_blueteeth.md"
],
"difficulty": "简单",
"source_topic": 29075
},
{
"question": "TROS 的姿态检测 App(hobot_falldown_detection)是如何工作的?它订阅什么数据、发布什么结果?目前支持什么检测功能?",
"expected_answer": "姿态检测 App 通过订阅摄像头发布的图片消息,检测出人体关键点后分析人体姿态,并发布姿态事件;姿态事件使用自定义算法 msg 发布出去,用户可以订阅此 topic 的 msg 用于应用开发。具体链路上,姿态检测 pkg 订阅人体关键点检测 pkg 发布的数据(body_kps),经过算法推理后发布算法 msg,并通过 websocket package 在 PC 端浏览器上渲染显示图片和算法结果。目前只支持跌倒检测功能,检测人体是否跌倒。支持平台:RDK X3/X3 Module(Ubuntu 20.04 Foxy、Ubuntu 22.04 Humble)、RDK X5/X5 Module(Humble)、RDK Ultra(Foxy)。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/04_apps/fall_detection.md",
"tros_doc/docs/04_apps/fall_detection.md"
],
"difficulty": "简单",
"source_topic": 26927
},
{
"question": "RDK 开发板执行 apt upgrade 时桌面环境黑屏怎么办?官方建议在什么终端里执行系统更新命令?",
"expected_answer": "建议通过串口终端或 SSH 远程登录后,在纯字符界面的终端中执行系统更新命令(如 sudo apt update && sudo apt upgrade)。直接在图形桌面的终端中执行更新,有时在升级桌面自身相关的包时可能会导致显示中断或 X Server 重启,从而造成黑屏现象。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "简单",
"source_topic": 29065
},
{
"question": "RDK 开发板的 40PIN GPIO 接口支持 C/C++ 语言操作吗?WiringPi 库适用于哪块板卡?",
"expected_answer": "支持。可以参考地平线开发者社区论坛中的相关文章和代码示例,例如《旭日 X3 派 WiringPi》——一个适配 RDK X3 的 C/C++ GPIO 库;同时可查阅对应 RDK 型号官方文档中关于 GPIO 开发的章节,通常会提供底层的操作方法或推荐的库。需要注意 WiringPi 是在旭日 X3 派上移植的库,其他型号(如 RDK X5)不能直接沿用 X3 的 WiringPi 代码。",
"expected_docs": [
"rdk_x_doc/docs/08_FAQ/02_interface.md"
],
"difficulty": "简单",
"source_topic": 28193
},
{
"question": "RDK 开发板如何启用和使用 ADB(Android Debug Bridge)与电脑通信?",
"expected_answer": "RDK 的 Ubuntu 系统中通常默认已经编译并可能启动了 adbd(ADB 守护进程)服务,但其默认配置和 USB 接口的功能模式可能需要调整才能用于 ADB 连接:1)确认 adbd 服务是否运行,或是否有启动脚本;2)RDK 板卡的 USB Type-C 口或特定的 Micro USB 口(通常标有 OTG 或 Device 功能)可能需要配置为 USB Device 模式(而不是 Host 模式)才能被 PC 识别为 ADB 设备,这有时可以通过 srpi-config 修改;3)电脑端安装 ADB 工具包(通常作为 Android SDK Platform Tools 的一部分提供);4)用 USB 线将 PC 与 RDK 板卡上配置为 Device 模式的 USB 口连接。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "中等",
"source_topic": 27328
},
{
"question": "RDK X3 上连接 F37 或 GC4663 MIPI 摄像头后,如何用 i2cdetect 验证摄像头是否被识别?这两个传感器的 I2C 地址分别是多少?",
"expected_answer": "F37 和 GC4663 这类 MIPI 摄像头模组通过 24pin FPC 排线与开发板连接(FPC 排线蓝色加强筋一面朝上插入并锁紧卡扣)。连接后验证方法:1)运行 MIPI 摄像头示例程序(以 RDK X3 为例:cd /app/ai_inference/03_mipi_camera_sample 后 sudo python3 mipi_camera.py,路径可能因系统版本而异),正常时可通过 HDMI 输出看到摄像头画面及算法处理结果;2)通过 i2cdetect 检查 I2C 通信:sudo i2cdetect -y -r 1(RDK X3 上 MIPI 摄像头常用 i2c-1 或 i2c-2 总线),F37 的地址通常为 0x40,GC4663 通常为 0x29;扫描到地址说明摄像头在 I2C 通信层面被识别(UU 表示内核驱动已占用)。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "中等",
"source_topic": 25801
},
{
"question": "RDK 开发板上的 MIPI 摄像头可以带电热插拔吗?插拔摄像头有什么注意事项?",
"expected_answer": "不可以。严禁在开发板未断电的情况下插拔摄像头,否则非常容易烧坏摄像头模组或主板接口。请务必在断开开发板所有电源后,再进行摄像头的连接或移除操作。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "简单",
"source_topic": 32011
},
{
"question": "RDK 音频套件在开发板上如何录制多通道音频和播放多声道音频?",
"expected_answer": "以 RDK X5 + RDK 音频套件为例,保证录音节点存在后,使用 arecord 工具录制多通道音频,例如:arecord -D hw:0,1 -d 10 -r 16000 -f S16_LE -c 8 record.wav(录制 8 通道);播放使用 aplay 工具播放多声道音频;两者支持全双工录制播放(录音与播放节点独立,可同时进行)。",
"expected_docs": [
"accessories_audio_kit_doc/docs/03_quick_start.md"
],
"difficulty": "简单",
"source_topic": 27709
},
{
"question": "RDK X5 的 Model Zoo(rdk_x5 分支)提供哪些类别的模型?单个 sample 的标准目录结构中哪个目录用于精度与性能评测?",
"expected_answer": "RDK X5 分支提供的模型类别包括:yolo26_depth(单目深度估计)、ultralytics_yolo(检测、分割、姿态、分类)、ultralytics_yolo26(检测、分割、姿态、OBB、分类)、vargconvnet(图像分类)、yoloe(实例分割)、yolov5(目标检测)、yoloworld(开放词表目标检测)等。每个 sample 的标准结构包含:conversion(ONNX 到 HBM/BIN 的转换配置)、evaluator(精度与性能评测)、model(预编译 .bin 模型 + 下载脚本)、runtime(python/cpp 推理代码)和 test_data(测试图片与推理结果)等目录;rdk_x5 分支的 Python sample 统一使用 hbm_runtime 推理接口。",
"expected_docs": [
"model_zoo_doc/docs/rdk_x5_guide.md"
],
"difficulty": "简单",
"source_topic": 27970
},
{
"question": "RDK X5 上想获取 SoC 芯片的唯一标识符(UID),用于自己软件的加密和设备授权,应该用哪个命令行工具?",
"expected_answer": "使用 hrut_socuid 命令,该命令打印当前 soc 芯片的 uid(唯一标识符),直接执行 hrut_socuid 即可,无需参数。",
"expected_docs": [
"rdk_doc/docs/09_Appendix/rdk-command-manual/cmd_hrut_socuid.md",
"rdk_x_doc/docs/09_Appendix/rdk-command-manual/cmd_hrut_socuid.md"
],
"difficulty": "简单",
"source_topic": 28279
},
{
"question": "RDK 算法工具链(OE,适用于 X3/X5)用 hb_mapper makertbin 做模型转换的过程中会生成 onnx 模型,这个 onnx 模型有什么用途和限制?",
"expected_answer": "模型转换过程会生成 onnx 模型,该模型均为中间产物,只是便于用户验证模型精度情况,因此不保证其在版本间的兼容性;若使用示例中的评测脚本对 onnx 模型单张或在测试集上评测,应使用当前版本工具生成的 onnx 模型进行操作,不能把旧版本工具生成的 onnx 直接拿来评测。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/ptq_process.md",
"oe_x3_doc/oe_mapper/source/ptq/ptq_usage/ptq_preface.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_workflow.md"
],
"difficulty": "简单",
"source_topic": 25550
},
{
"question": "RDK X5 的 OE 算法工具链示例模型做精度评测需要 ImageNet、COCO、VOC、Cityscapes 等公共数据集,官方文档在哪里给出下载地址?VOC 数据集需要下载哪些版本?",
"expected_answer": "在 OE 工具链文档附录《数据集下载》(oe_x5_doc 的 appendix/dataset_link)中给出了示例模型所用数据集的下载地址:ImageNet(image-net.org)、COCO(cocodataset.org)、VOC(host.robots.ox.ac.uk/pascal/VOC/,需要下载 2007 和 2012 两个版本)、Cityscapes(github.com/mcordts/cityscapesScripts),另外还有 CIFAR-10、KITTI3D、CULane、Nuscenes、Mot17 等数据集链接,各数据集的目录结构可参考对应的数据集参考结构章节。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/appendix/dataset_link.md"
],
"difficulty": "简单",
"source_topic": 25126
},
{
"question": "RDK S100 想接入多路 GMSL 相机( 实现 12 路输入),RDK S100 官方 12 通道相机扩展板用的是什么解串器芯片?提供多少个 GMSL 相机接口?",
"expected_answer": "RDK S100 相机扩展板(12 通道)基于 S100 的 Camera Expansion Connector二次开发,解串器为 Maxim MAX96712,GMSL 连接器为 Fakra-Mini 4in1,提供了 12 个 GMSL 相机接口;外部供电 12V DC(仅用于电流需求大于 700mA 时,最大 7.2A),仅适配 RDK S100 系列主板使用,禁止与其他型号设备兼容。",
"expected_docs": [
"rdk_s_doc/docs/01_Quick_start/01_hardware_introduction/01_rdk_s100/02_rdk_s100_camera_expansion_board/02_rdk_s100_camera_expansion_board_12l.md"
],
"difficulty": "中等",
"source_topic": 35539
},
{
"question": "RDK X5 做 OTA 系统升级时,eMMC 中的分区按升级方式分为哪几类?AB 分区和 BAK 分区的升级方式有什么区别?",
"expected_answer": "分区按升级方式分为:持久化分区(ubootenv、misc、userdata 等,数据需长期保存,不支持 OTA 升级)、AB 分区(前缀同名且尾缀带 _a/_b,如 boot_a/boot_b,AB 分区交替升级)、BAK 分区(尾缀带 _bak,主要指 miniboot 分区,只升级主分区,主分区升级并验证成功后将主分区内容同步到备份分区,如 miniboot、miniboot_bak1)、单分区(GOLDEN,如 hbre、system,在 recovery 模式时可对 GOLDEN 分区进行 OTA 升级,仅适用于 NAND 和 eMMC)。",
"expected_docs": [
"x5_sdk_doc/linux_development/system_component_development/ota/1-ota.md"
],
"difficulty": "中等",
"source_topic": 31224
},
{
"question": "RDK IMU 模组接到开发板时,选择 I2C 还是 SPI 通信方式,在硬件上如何设置?",
"expected_answer": "通过 RDK IMU 模组上的通信方式选择接口(跳线帽)设置:使用 5 个跳线帽将中间 5PIN 排针与丝印 I2C 一侧的 5PIN 排针连接,即可选择 I2C 通信;将中间 5PIN 排针与丝印 SPI 一侧的 5PIN 排针连接,即可选择 SPI 通信。",
"expected_docs": [
"accessories_doc/docs/03_imu_module/04_hardware.md",
"accessories_bmi088_doc/docs/04_hardware.md"
],
"difficulty": "简单",
"source_topic": 35018
},
{
"question": "RDK S100/S100P 开发板想外接扬声器做音频播放,官方提供了什么配件方案?扬声器如何连接、支持哪些板卡?",
"expected_answer": "可使用 RDK 音频套件(RDK 音频拓展板):支持全双工多通道录音与播放,提供双通道播放(2 路立体声输出)、最多 6 路麦克风输入与 2 路回采输入,采样率 8kHz-96kHz,支持 USB 与 I2S 模式切换;扬声器 x2 通过 HC1.25 连接器连接。适用板卡为 RDK X5、RDK X5 Module、RDK S100/S100P、RDK S600(连接 X5/S100 等需要 RDK 音频拓展板接口转接);RDK X3 和 RDK X3 Module 不支持(未经过测试验证)。",
"expected_docs": [
"accessories_audio_kit_doc/docs/01_introduction.md",
"accessories_audio_kit_doc/docs/02_installation.md"
],
"difficulty": "中等",
"source_topic": 35316
},
{
"question": "RDK X3(旭日X3派)用 SD 卡启动时遇到 SD 卡兼容性问题(SD 卡不识别、识别不稳定等),官方 FAQ 建议尝试什么方法改善?",
"expected_answer": "官方建议可以尝试手动烧录最新的 miniboot 镜像来改善 SD 卡兼容性(此方法对旭日X3派提出,也适用于 RDK X3),可参考官方教程《SD卡兼容性问题及miniboot更新》。此外 FAQ 还建议排查 SD 卡本身质量(更换 Class10、U1/U3 级高速卡)、SD 卡与卡槽接触、镜像及烧录过程、供电稳定性等。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/01_hardware_and_system.md",
"rdk_x_doc/docs/08_FAQ/01_hardware_and_system.md"
],
"difficulty": "中等",
"source_topic": 26845
},
{
"question": "RDK X5 Desktop(桌面版)系统想修改 HDMI 的默认显示分辨率,应修改哪个配置文件?X5 的 HDMI 和 MIPI DSI 输出能否同时使用?",
"expected_answer": "默认分辨率可以通过修改 /etc/X11/xorg.conf.d/1-resolution.conf 文件实现(在 Screen 配置的 Modes 中指定如 \"1280x720\")。RDK X5 支持 HDMI 和 MIPI DSI 两种显示输出方式,不能同时使用,系统默认采用 HDMI 输出,HDMI 支持的最大分辨率为 1080P60。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/display_use/display_rdkx5.md",
"rdk_doc/docs/01_Quick_start/display_use/display_rdkx5.md"
],
"difficulty": "中等",
"source_topic": 28621
},
{
"question": "RDK X5 已经切换到 MIPI DSI 显示输出后,想切回 HDMI 输出,用什么工具如何操作?",
"expected_answer": "使用 srpi-config 工具切换回 HDMI:进入 2 Display Options > D1 Dsiplay Choice > 2 HDMI,重启设备后生效。如果不想使用 srpi-config 工具,也可以按命令行方式配置:将 /etc/X11/xorg.conf.d/xorg_hdmi_ignore.conf 重命名为 xorg_hdmi_ignore.conf.disable,并将 xorg_dsi_ignore.conf.disable 恢复为 xorg_dsi_ignore.conf。",
"expected_docs": [
"rdk_x_doc/docs/01_Quick_start/display_use/display_rdkx5.md",
"rdk_doc/docs/01_Quick_start/display_use/display_rdkx5.md"
],
"difficulty": "简单",
"source_topic": 28621
},
{
"question": "在 x86 PC(Ubuntu 20.04)上安装 TROS(RDK 的 X86 模拟器环境)需要添加什么 apt 软件源?之前装过 1.x 版本 tros.b 的话,安装 2.x 前要注意什么?",
"expected_answer": "需要添加 D-Robotics 的 X86 模拟器源:先下载 gpg 密钥 http://archive.d-robotics.cc/keys/sunrise.gpg 到 /usr/share/keyrings/,再添加 deb [arch=amd64 signed-by=/usr/share/keyrings/sunrise.gpg] http://archive.d-robotics.cc/ubuntu-rdk-sim focal main(同时添加 ROS2 官方 apt 源),然后 sudo apt update && sudo apt install tros。注意:如果 X86 平台已安装 1.x 版本 tros.b,需要先执行 sudo apt remove tros 删除后再安装 2.x 版本。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/01_quick_start/install_tros.md"
],
"difficulty": "中等",
"source_topic": 27832
},
{
"question": "RDK S100 上做音频功能测试(录音/播放),音频模块基于什么框架?用什么命令列出系统中已识别的声卡?",
"expected_answer": "S100 音频基于标准 alsa 框架进行开发,用户空间使用开源 alsa-lib 提供的库和二进制 bin(arecord/aplay)进行功能测试。列出声卡和数字音频设备信息使用 arecord -l 和 aplay -l;查看硬件支持能力可用 arecord --dump-hw-params -Dhw:0,0。",
"expected_docs": [
"rdk_s_doc/docs/03_Basic_Application/02_audio/01_audio_board_super.md",
"rdk_doc/docs_s/03_Basic_Application/02_audio/01_audio_board_s100.md"
],
"difficulty": "简单",
"source_topic": 35316
},
{
"question": "TROS 的 mipi_cam 节点在 RDK 板卡上发布摄像头图像后,想在 PC 浏览器上通过 WebSocket 查看实时画面,为什么还需要额外启动编码节点?完整启动流程是什么?",
"expected_answer": "因为 mipi_cam 发布的是原始图像数据,Web 端查看需要先编码 JPEG 图像,流程为:先启动编码 ros2 launch hobot_codec hobot_codec_encode.launch.py;再另起终端(配置 tros.b 环境)启动 websocket:ros2 launch websocket websocket.launch.py websocket_image_topic:=/image_jpeg websocket_only_show_image:=true;最后 PC 打开浏览器(chrome/firefox/edge)输入 http://IP:8000 即可看到摄像头实时画面。",
"expected_docs": [
"tros_doc/docs/02_quick_demo/demo_sensor.md",
"rdk_doc/docs/05_Robot_development/02_quick_demo/demo_sensor.md"
],
"difficulty": "中等",
"source_topic": 28956
},
{
"question": "RDK S100 开发板上电后风扇一直不转,是硬件故障吗?S100 的风扇在什么条件下才会转动?",
"expected_answer": "不一定是故障,S100 的风扇纳入 Thermal 框架温控策略:thermal_zone0 的 trip_point_1_temp 默认为43度,超过 43 度风扇将从关闭状态调整为2档(最高可提升到5档);trip_point_2_temp 默认为65度,超过 65 度调整到 6 档(最高 10 档)。风扇由 emc2305 控制器控制,档位 0~10,0 表示关闭、10 为满转速,温度未达阈值时风扇保持关闭属于正常温控策略(thermal_zone0 的 trip_point_0_temp 为 120 度关机温度,trip_point_3_temp 为 95 度 CPU Acore 降频温度)。",
"expected_docs": [
"rdk_s_doc/docs/02_System_configuration/04_frequency_management.md",
"rdk_doc/docs_s/02_System_configuration/04_frequency_management.md"
],
"difficulty": "中等",
"source_topic": 31882
},
{
"question": "RDK S100 想在 PC 端烧录系统镜像、或把设备某区域的镜像导出备份,官方推荐的板级烧录工具是什么?它替代了哪个早期工具?",
"expected_answer": "官方工具是 XBurn:运行在 PC 端(Windows/Linux/macOS)的板级烧录工具,适用于 RDK S100、RDK S600、RDK X5、RDK X5 Module,用于固件烧录与备份,它替代了早期的 D-Navigation 成为推荐烧录工具。对 S100/S600 提供全镜像烧录、指定区域烧录、指定区域备份和指定分区镜像烧录能力(X5/X5 Module 不支持指定区域备份与指定分区镜像烧录)。DiskGenius 这类第三方工具不适用于 RDK S100 镜像烧录。",
"expected_docs": [
"xburn_doc/docs/overview.md"
],
"difficulty": "简单",
"source_topic": 34546
},
{
"question": "RDK X3 和 RDK X5 的 40PIN 接口上默认使能的 I2C 总线分别是哪几路?对应哪些物理管脚?",
"expected_answer": "RDK X3 在 40PIN 上默认使能 I2C0,物理管脚号 3 和 5;RDK X5 在 40PIN 上默认使能 I2C5(物理管脚号 3 和 5)和 I2C0(物理管脚号 27 和 28)。两者 IO 电压均为 3.3V。可运行板端预置的 /app/40pin_samples/test_i2c.py 列出系统使能的 I2C 总线并测试外设读写。",
"expected_docs": [
"rdk_x_doc/docs/03_Basic_Application/01_40pin_user_sample/i2c.md",
"rdk_doc/docs/03_Basic_Application/01_40pin_user_sample/i2c.md"
],
"difficulty": "中等",
"source_topic": 31840
},
{
"question": "RDK Ultra 开发板做模型转换应该使用哪个算法工具链(OpenExplorer)?在哪里查对应的手册?",
"expected_answer": "RDK Ultra 使用 J5 平台的 OpenExplorer 工具链。官方 FAQ「RDK Ultra平台有哪些社区算法资源和工具链手册」给出:RDK Ultra 算法工具链社区手册(OpenExplorer)为 horizon_j5_open_explorer_cn_doc(即 J5 OpenExplorer 手册),并附 RDK Ultra OpenExplorer 产品发布及相关资源帖。提问时官方还要求注明平台架构:RDK Ultra 对应 BPU Bayes。",
"expected_docs": [
"rdk_doc/docs/08_FAQ/05_toolchain.md"
],
"difficulty": "简单",
"source_topic": 29056
},
{
"question": "RDK X5 上想用多路相机做 360° 全景拼接,X5 SDK 提供了哪些现成的示例和硬件模块支持?",
"expected_answer": "X5 SDK 的 sample_pipeline 提供多路拼接测试用例:multi_pipe_crop_and_stitch(多路 sensor 裁剪拼接测试用例)和 multi_pipe_gdc_stitching(从 2 路相同分辨率的 sensor 获取图像并进行 gdc 拼接,拼接之后编码成 h264 视频输出)。畸变校正依赖 GDC 模块:GDC API 属于 HBN 框架的一部分,只支持 offline 模式(从 DDR 读数据、处理完写回 DDR),使用前需用 GDC Tool 仿真生成 layout.json/config.bin,再通过 GDC bin API(hbn_gen_gdc_bin_json/hbn_gen_gdc_bin)生成 GDC bin 配置文件。",
"expected_docs": [
"x5_sdk_doc/samples/sample_pipeline.md",
"x5_sdk_doc/multimedia_development/8.0-GDC_Overview_zh_CN.md"
],
"difficulty": "中等",
"source_topic": 25429
},
{
"question": "RDK X3 40PIN 上使用的音频转接板(Audio Driver HAT REV2)是什么方案?接入后软件上如何配置使能、如何确认安装成功?",
"expected_answer": "Audio Driver HAT REV2 是微雪电子生产的音频转接板,采用 ES7210+ES8156 双 Codec 方案,可实现环形 4 麦克风录音、双通道音频播放、音频信号回采,接入 RDK X3/X3 Module 的 40pin。配置步骤:先用 cat /sys/class/socinfo/som_name 查询开发板类型并设置拨码开关(返回值为 5 或 6 时 3 个拨码开关全部拨到 ON,返回值为 8 时全部拨到 OFF);再用 srpi-config 进入 3 Interface Options → I5 Audio 选择 Audio Driver HAT V2,执行 sync && reboot 重启后,ls /dev/snd 出现 controlC0、pcmC0D0c、pcmC0D1p 等设备节点说明转接板安装成功。",
"expected_docs": [
"rdk_x_doc/docs/03_Basic_Application/05_audio/rdk_x3_and_rdk_x3_module/audio_driver_hat2_rev2.md",
"rdk_doc/docs/03_Basic_Application/05_audio/rdk_x3_and_rdk_x3_module/audio_driver_hat2_rev2.md"
],
"difficulty": "中等",
"source_topic": 25437
},
{
"question": "RDK X5 算法工具链的 PTQ 和 QAT 两种量化方案有什么区别?各自最终生成的模型文件格式是什么?",
"expected_answer": "PTQ(Post-training Quantization,训练后量化):在宿主机开发环境完成模型的量化转换,再将编译生成的 `.bin` 模型拷贝至开发板部署。QAT(Quantization aware training,量化感知训练,暂时只支持 Pytorch 框架):需要先在宿主机完成模型的 QAT 训练,再进行量化转换,再将编译生成的 `.hbm` 模型拷贝至开发板部署。官方建议在浮点模型训练完成后优先选择简单易用的 PTQ 量化方案,只在精度问题确实无法解决时再切换到 QAT 量化方案。",
"expected_docs": [
"oe_x5_doc/oe_mapper/source/env_install/env_deploy.md",
"rdk_doc/docs/08_FAQ/05_toolchain.md"
],
"difficulty": "中等",
"source_topic": 31203
},
{
"question": "语义分割后处理中用 ArgMax 逐像素取类别,该算子在 RDK X3/X5 上能被 BPU 加速吗?有哪些约束?",
"expected_answer": "ArgMax 是 BPU 加速算子,但约束较严格:仅支持沿C维度进行argmax(axis=1)、C ≤ 64、不支持配置top_k != 1;在 RDK X5 的 ONNX 算子列表中还要求输入维度为四维 NCHW、支持 int16 输入输出,并支持沿 C 维 argmax/argmin。即通道数超过 64 或需要在其他 axis 上做 ArgMax 时无法获得 BPU 加速。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/supported_op_list.md"
],
"difficulty": "中等",
"source_topic": 25218
},
{
"question": "RDK 板端用系统自带的 Python 推理库 hobot_dnn 加载 .bin 模型并推理,正确的调用方式是什么?",
"expected_answer": "hobot_dnn 的 Python 接口是 hobot_dnn.pyeasy_dnn(板端系统自带,RDK X3 的 YOLO、FCOS、YOLOv8-Seg 等 demo 使用):先 from hobot_dnn import pyeasy_dnn as dnn,再用 models = dnn.load(\"模型.bin\") 加载,返回的是模型列表,需取 models[0],然后用 model.forward(input_tensor) 执行推理得到输出。注意 hobot_dnn.pyeasy_dnn 对 featuremap 输入模型支持不佳,这类模型应改用 hbm_runtime 推理接口(RDK X5 或 RDK S 系列)。",
"expected_docs": [
"rdk_doc/docs/04_Algorithm_Application/01_model_zoo/infer_api_ref.md"
],
"difficulty": "中等",
"source_topic": 32708
},
{
"question": "RDK X5 的桌面版系统默认使用 CPU 桌面还是 GPU 桌面渲染?从哪个系统版本开始支持两者切换?",
"expected_answer": "默认 CPU 桌面。RDK OS 版本发布记录在 3.3.1 版本的新功能中列出:支持CPU,GPU桌面切换,默认CPU桌面;后续版本还持续进行 GPU 桌面稳定性提升和 GPU 桌面体验优化。",
"expected_docs": [
"rdk_doc/docs/RDK.md",
"rdk_x_doc/docs/RDK.md"
],
"difficulty": "简单",
"source_topic": 33705
},
{
"question": "RDK X5 模型转换时报 internal error: dilated conv only supports int8 output,工具链对空洞卷积(dilation > 1 的 Conv)有什么输出类型约束?",
"expected_answer": "X5 的 ONNX Conv 算子(BPU 加速)约束:Dilation取值范围 H,W∈[1,16];当 H 或 W 大于 1(即空洞卷积)时,只支持输出int8,且输入 Tensor 的 H 必须能被 dilation 的 H 整除、输入 Tensor 的 W 必须能被 dilation 的 W 整除。也就是说 dilated conv 不能配置非 int8(如 float)输出,这是该报错的根源,需要让模型满足 int8 输出约束。",
"expected_docs": [
"rdk_doc/docs/07_Advanced_development/04_toolchain_development/intermediate/supported_op_list.md"
],
"difficulty": "困难",
"source_topic": 25744
},
{
"question": "RDK 上有 BEV(鸟瞰图)感知算法示例吗?支持哪些平台?模型的输入输出是什么?",
"expected_answer": "TROS 提供 hobot_bev BEV 感知算法示例:使用 OpenExplorer 在 nuscenes 数据集上训练的 BEV 多任务模型。输入为 6 组图像数据(前视、左前、右前、后视、左后、右后),模型输出 10 个类别的目标及对应的 3D 检测框(障碍物、多种类型车辆、交通标志等),以及车道线、人行道、马路边缘的语义分割。支持平台为 RDK S100, RDK S100P(Ubuntu 22.04 Humble,本地回灌并通过 web 展示推理渲染结果),RDK 用户手册版本还列出 RDK Ultra(Ubuntu 20.04 Foxy);X3/X5 不在支持平台列表中。",
"expected_docs": [
"rdk_doc/docs/05_Robot_development/03_boxs/driver/hobot_bev.md",
"tros_doc/docs/03_boxs/driver/hobot_bev.md"
],
"difficulty": "中等",
"source_topic": 34700
},
{
"question": "RDK X5 能安装 Ubuntu 20.04 系统吗?官方目前提供哪个 Ubuntu 版本的镜像?",
"expected_answer": "不能装 20.04。RDK X5 目前提供的是 Ubuntu 22.04 系统镜像,分为两种:desktop 版本(带有桌面的 Ubuntu 系统,可外接屏幕、鼠标操作)和 server 版本(无桌面的 Ubuntu 系统,通过串口、网络远程连接操作)。如需 ROS1 等旧环境只能自行尝试 Docker 等方式。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/install_os/rdk_x5/01_system_burn.md"
],
"difficulty": "简单",
"source_topic": 35629
},
{
"question": "RDK X3/X5 模型转换工具链中,Reshape、Transpose 这类算子在什么条件下才能在 BPU 上运行(被动量化)?",
"expected_answer": "这类算子依赖特定的上下文才能被被动量化:Reshape、Transpose 需要前后均为 BPU 算子才能被动量化(在 BPU 上加速)。工具链中大部分算子(如 conv)由 BPU 硬件直接支持;有些会被替换成其他算子实现加速(如 gemm 会被替换成 conv);BPU 无法直接或间接加速的算子会被放在 CPU 上计算,由 runtime 预测库在推理时自动完成异构调度。",
"expected_docs": [
"oe_x3_doc/oe_mapper/source/ptq/ptq_usage/ptq_faq.md",
"oe_x5_doc/oe_mapper/source/ptq/ptq_faq_troubleshooting/ptq_faq.md"
],
"difficulty": "中等",
"source_topic": 27899
},
{
"question": "旭日X3派(RDK X3)板载的 WiFi+蓝牙功能基于哪个模组设计?符合什么无线标准、最高速率是多少?",
"expected_answer": "X3 基于 AP6212 模组设计了 WiFi+蓝牙功能。AP6212 是结合 WiFi + Bluetooth + FM 技术的整体解决方案,符合 IEEE 802.11 b/g/n 标准,传输速度最高可达 72.2Mbps;WiFi 使用 SDIO 接口,蓝牙使用 UART/PCM 接口(FM 使用 UART/I2S/PCM 接口)。",
"expected_docs": [
"oe_x3_doc/oe_mapper/source/appendix/hardware/dev_board_kit.md"
],
"difficulty": "简单",
"source_topic": 25200
},
{
"question": "RDK S100P 的 BPU 算力是多少?和 RDK S100 在芯片、主频、内存上有什么区别?",
"expected_answer": "RDK S100P(型号 KS1P75Y,SoC 为 S100P,CPU 主频 2.0GHz,内存 24GB LPDDR5)的 BPU 算力为 128 TOPS;RDK S100(型号 KS1E55Y,SoC 为 S100E,CPU 主频 1.5GHz,内存 12GB LPDDR5)为 80 TOPS。S100 系列 BPU 可提供高达 80/128TOPS 的算力。",
"expected_docs": [
"rdk_s_doc/docs/01_Quick_start/01_hardware_introduction/01_rdk_s100/01_rdk_s100.md",
"rdk_doc/docs_s/01_Quick_start/01_hardware_introduction/01_rdk_s100.md"
],
"difficulty": "简单",
"source_topic": 35377
},
{
"question": "旭日X3(XJ3)芯片的 MIPI Rx 总共支持几条 Lane?每个 Lane 的设计带宽是多少、支持哪些 Sensor 输入格式?",
"expected_answer": "MIPI Rx 分为 Rx0、Rx1/3、Rx2,总共支持 8 条 Lane,每个 Lane 带宽设计支持 2Gbps;支持 YUV422 8/10bit 以及 Raw 8、10、12、14 格式的 Sensor 输入(Video In 模块另支持 DVP 类型 Sensor 和 USB 接口 Sensor 输入)。",
"expected_docs": [
"oe_x3_doc/oe_mapper/source/appendix/xj3_introduction/x3_introduction.md"
],
"difficulty": "简单",
"source_topic": 27974
},
{
"question": "旭日X3(XJ3)芯片的视频编解码能力如何?H.265、H.264、JPEG 分别支持到什么规格?",
"expected_answer": "VENC/VDEC 模块提供最大 8M@60fps 的 H.265 编解码、最大 8M@30fps 的 H.264 编解码能力,并支持最大 16Mpixels 的 JPEG 编解码能力。(以上为 X3 芯片介绍文档口径)",
"expected_docs": [
"oe_x3_doc/oe_mapper/source/appendix/xj3_introduction/x3_introduction.md"
],
"difficulty": "简单",
"source_topic": 24676
},
{
"question": "RDK X3、RDK X5、RDK Ultra 在 40PIN 上默认使能的分别是哪个 UART?对应什么管脚和电平?",
"expected_answer": "RDK X3 在 40PIN 上默认使能 UART3(测试用 /dev/ttyS3),RDK X5 默认使能 UART1(测试用 /dev/ttyS1),RDK Ultra 默认使能 UART2(测试用 /dev/ttyS2);物理管脚号均为 8 和 10,IO 电压 3.3V。注意 /dev/ttyS0 是系统调试口,不建议对它进行测试;可运行 /app/40pin_samples/test_serial.py 做回环测试(TXD 与 RXD 短接)。",
"expected_docs": [
"rdk_doc/docs/03_Basic_Application/01_40pin_user_sample/uart.md",
"rdk_x_doc/docs/03_Basic_Application/01_40pin_user_sample/uart.md"
],
"difficulty": "中等",
"source_topic": 35426
},
{
"question": "RDK 开发板(X 系列)上如何手动设置系统时间并写入 RTC 硬件时钟?断电后如何保持/恢复时间?",
"expected_answer": "以 pcf8563 RTC 芯片为例(驱动 drivers/rtc/rtc-pcf8563.c,设备节点 /dev/rtc1,可软链接到 /dev/rtc):用 date -s 2022.01.21-21:24:00 设置系统时间;hwclock -w 将系统时间写入RTC;hwclock -r 读取 RTC 时间确认写入成功;断电再上电后可用 hwclock -s 将 RTC 时间更新到系统时间。要保证 RTC 断电后依然记录时间,需要通过 RTC Battery Con 接口给 RTC 单独供电。",
"expected_docs": [
"rdk_x_doc/docs/07_Advanced_development/02_linux_development/driver_development/driver_rtc_dev.md",
"rdk_doc/docs/07_Advanced_development/02_linux_development/driver_development/driver_rtc_dev.md"
],
"difficulty": "简单",
"source_topic": 25100
},
{
"question": "RDK X5(Server 版系统,无桌面)如何用命令行连接 WiFi 热点?",
"expected_answer": "开发板无线模块支持 Station 和 Soft AP 两种模式,默认运行在 Station 模式。命令行步骤:1)sudo nmcli device wifi rescan 扫描热点;2)sudo nmcli device wifi list 列出扫描到的热点;3)sudo wifi_connect \"SSID\" \"PASSWD\" 连接热点。若提示找不到热点,可重新执行 rescan 后再次连接。",
"expected_docs": [
"rdk_doc/docs/02_System_configuration/01_network_blueteeth.md",
"rdk_x_doc/docs/02_System_configuration/01_network_blueteeth.md"
],
"difficulty": "简单",
"source_topic": 34860
},
{
"question": "RDK X5 可以使用 4G 模块上网吗?官方认证配件清单里有哪些 4G 通信模块?",
"expected_answer": "可以。RDK X5 认证配件清单中收录了微雪的4G通信模块:SIM7600G-H 4G DTU(工业级 4G 通信模块,支持 USB/UART/RS232/RS485 接口,4G/3G/2G 网络及 GNSS 定位)和 SIM7600G-H 4G DONGLE(支持 USB/UART 接口,4G/3G/2G 网络及 GNSS 定位)。",
"expected_docs": [
"rdk_doc/docs/01_Quick_start/accessory.md",
"rdk_doc/docs/07_Advanced_development/01_hardware_development/rdk_x5/accessory.md"
],
"difficulty": "简单",
"source_topic": 33847
}
]