Demos Overview
This section provides walkthroughs for running ros2_medkit with demo systems of increasing complexity.
Learning Path
The demos are organized by complexity — start simple and progress to more advanced scenarios:
Start here: Getting Started — Quick tutorial ⚡
Learn the basics with built-in demo nodes. Perfect for exploring the gateway API without external dependencies.
✅ No Docker required
✅ Seconds to start
✅ Simple automotive sensors
✅ Interactive curl examples
Then explore these demos:
Sensor Diagnostics Demo — Lightweight diagnostics 🔬
Docker-based sensor simulation with comprehensive fault detection and multiple reporting paths.
🐳 Docker Compose deployment
✅ No Gazebo or GPU needed
🔧 Runtime fault injection scripts
📊 Dual reporting mechanisms
TurtleBot3 Demo — Full robot simulation 🤖
Complete robotics stack with navigation, visualization, and realistic sensor data.
🎮 Gazebo simulation
🗺️ Nav2 navigation
🚀 Production-like complexity
🖥️ GPU recommended
Choose Your Demo
I want to…
🚀 Get started quickly → Getting Started
🔍 Learn fault management → Sensor Diagnostics Demo
🤖 Test with realistic robotics → TurtleBot3 Demo
📚 Understand the full API → Start with Getting Started, then explore both demos