RDK X5 App Resources Skill

This skill provides access to embedded hardware resources in /app folder on D-Robotics RDK X5 boards, including GPIO control, I2C/SPI communication, video capture, media processing, and AI inference.

⚠️ Important: Use System Python (NOT conda)

Most of these resources require system Python, NOT conda environment!

The D-Robotics board has hobot_dnn and other libraries installed in system Python (/usr/bin/python3.10), but NOT in conda environments.

Always use system Python to run these scripts:

# ✅ Correct - use system Python
/usr/bin/python3.10 /app/pydev_demo/01_basic_sample/test_resnet18.py

# ❌ Wrong - conda environment does NOT have hobot_dnn
python /app/pydev_demo/01_basic_sample/test_resnet18.py  # will fail!

If you accidentally use conda Python, you'll get errors like:

ModuleNotFoundError: No module named 'hobot_dnn'

Available Resources

1. 40pin GPIO Samples (/app/40pin_samples/)

Python-based GPIO control using Hobot.GPIO library:

2. Character Device Demos (/app/cdev_demo/)

C-based device driver examples:

3. Multimedia Samples (/app/multimedia_samples/)

C/C++ multimedia processing examples:

4. Python AI Samples (/app/pydev_demo/)

Python-based AI model inference examples:

Model files are linked from /app/model/basic (or /opt/hobot/model/x5/basic).

5. ISP Tuning Tool (/app/tuning_tool/)

Image Signal Processor tuning tools:

Quick Reference

Running Python Samples - ALWAYS use system Python!

# ✅ CORRECT - Use system Python (/usr/bin/python3.10)
# These have hobot_dnn and other D-Robotics libraries

/usr/bin/python3.10 /app/40pin_samples/simple_out.py
/usr/bin/python3.10 /app/40pin_samples/button_led.py
/usr/bin/python3.10 /app/40pin_samples/test_i2c.py
/usr/bin/python3.10 /app/40pin_samples/test_spi.py
/usr/bin/python3.10 /app/40pin_samples/test_serial.py

/usr/bin/python3.10 /app/pydev_demo/01_basic_sample/test_resnet18.py
/usr/bin/python3.10 /app/pydev_demo/07_yolov5_sample/main.py
/usr/bin/python3.10 /app/pydev_demo/08_decode_rtsp_stream/main.py

Building C/C++ Demos

# Build multimedia samples
cd /app/multimedia_samples/
make

# Build character device demos
cd /app/cdev_demo/v4l2/
make

Running ISP Tuning

cd /app/tuning_tool/
./run_tuning.sh

GPIO Pin Reference

• Pin 37 - BOARD编码模式下的 GPIO37 (对应 WPI 25)
• Uses Hobot.GPIO library (D-Robotics GPIO wrapper)
• Modes: GPIO.BOARD, GPIO.BCM, GPIO.WPI

Important Notes

1. ⚠️ ALWAYS use system Python - /usr/bin/python3.10, NOT conda
2. Hardware Access: Most operations require root privileges or proper hardware permissions
3. Pin Numbers: Use BOARD encoding (physical pin numbers) or BCM encoding (Broadcom)
4. Library: Uses Hobot.GPIO which is D-Robotics' GPIO wrapper
5. Cleanup: Always call GPIO.cleanup() when done
6. Models: Pre-trained models are in /app/model/basic/
7. Scope: This skill covers /app folder resources only. For system commands and other RDK X5 features, refer to official documentation.

Use Cases

• Control LEDs, motors, relays via GPIO
• Read button/switch states
• Communicate with I2C sensors (temperature, IMU, etc.)
• Interface with SPI devices
• Capture video from camera modules (USB, MIPI)
• Video encoding/decoding
• RTSP video streaming
• Run AI inference (YOLO, SSD, CenterNet, segmentation)
• ISP camera tuning
• Video pipeline processing

Note: This skill focuses on /app folder sample resources. It is not a complete RDK X5 operation guide.