ros2_medkit

User Guide

  • Introduction
    • ros2_medkit
    • What is ros2_medkit?
    • Packages
    • Next Steps
    • Community
  • Installation
    • System Requirements
    • Prerequisites
    • Installation from Source
    • Verifying Installation
    • Docker Installation
    • Development Installation
    • Troubleshooting
    • Next Steps
  • Getting Started
    • Overview
    • Prerequisites
    • Step 1: Launch the Gateway
    • Step 2: Explore the API
    • Step 3: Discover Areas and Components
    • Step 4: Read Sensor Data
    • Step 5: Call Services and Actions
    • Step 6: Manage Parameters
    • Step 7: Monitor Faults
    • Using with Web UI
    • Using with LLMs (MCP)
    • Using with Postman
    • Next Steps
  • Tutorials
    • Demos Overview
      • Sensor Diagnostics Demo
        • Overview
        • Prerequisites
        • Starting the Demo
        • Exploring the Demo
        • Reading Sensor Data
        • Managing Configurations
        • Fault Injection
        • Stopping the Demo
        • Architecture
        • See Also
      • TurtleBot3 Demo
        • Overview
        • Prerequisites
        • Starting the Demo
        • Exploring the System
        • Reading Sensor Data
        • Sending Navigation Goals
        • Managing Parameters
        • Fault Injection
        • Stopping the Demo
        • See Also
      • Learning Path
      • Choose Your Demo
    • Heuristic Runtime Discovery
      • Overview
      • When to Use Heuristic Discovery
      • Quick Start
      • Understanding the Entity Hierarchy
      • Configuration Options
        • create_synthetic_components
        • grouping_strategy
      • Handling Topic-Only Namespaces
        • Example: Filtering Noise
      • API Endpoints
        • Apps Endpoints
        • Components Endpoints
      • Migrating to Manifest Discovery
      • See Also
    • Manifest-Based Discovery
      • Introduction
      • Discovery Modes Comparison
      • Writing Your First Manifest
      • Enabling Manifest Mode
        • Option 1: Using Launch File
        • Option 2: Using Parameter File
        • Option 3: Command Line Parameters
      • Verifying the Configuration
      • Understanding Runtime Linking
        • ROS Binding Configuration
        • Checking Linking Status
      • Entity Hierarchy
      • Handling Unmanifested Nodes
      • Hot Reloading
      • REST API Endpoints
      • Next Steps
    • Migration Guide: Runtime to Hybrid Mode
      • Overview
      • Step 1: Audit Your System
      • Step 2: Define Areas
      • Step 3: Define Components
      • Step 4: Define Apps
      • Step 5: Define Functions
      • Step 6: Create the Manifest File
      • Step 7: Test in Hybrid Mode
      • Step 8: Iterate and Refine
      • Validation Checklist
      • Common Issues
      • Best Practices
      • Next Steps
    • Configuring Authentication
      • Overview
      • Authentication Modes
      • Roles and Permissions
      • Basic Setup
      • Using Authentication
      • Production Recommendations
      • Troubleshooting
      • See Also
    • Configuring HTTPS/TLS
      • Overview
      • Quick Start (Development)
      • Generating Development Certificates
      • Manual Configuration
      • Configuration Options
      • Using with curl
      • Using with Postman
      • Production Certificates
      • Security Best Practices
      • Troubleshooting
      • See Also
    • Configuring Snapshot Capture
      • Overview
      • Quick Start
      • Configuration Options
      • Advanced Configuration
      • Querying Snapshots
      • Example Workflow
      • Troubleshooting
      • Rosbag Capture (Time-Window Recording)
        • Enabling Rosbag Capture
        • Rosbag Configuration Options
        • Understanding lazy_start Mode
        • Downloading Rosbag Files
        • Example: Production Configuration
        • Example: Debugging Configuration
      • See Also
      • Migration from Legacy Endpoints
    • Configuring Fault Correlation
      • Overview
        • How It Works
      • Quick Start
      • Configuration Reference
        • Top-Level Settings
        • Patterns Section
      • Hierarchical Mode
      • Auto-Cluster Mode
      • Querying Correlation Data
      • Example: Complete Configuration
      • Troubleshooting
      • See Also
    • Docker Deployment
      • Overview
      • Quick Start with Demo
      • Building the Gateway Image
      • Docker Compose Configuration
      • Network Configuration
      • CORS for Web UI
      • Volume Mounts
      • Health Checks
      • Production Considerations
      • Running with Simulation
      • Troubleshooting
      • See Also
    • Development Container
      • Overview
      • Prerequisites
      • Quick Start
      • Container Configuration
        • devcontainer.json
        • Dockerfile
      • Development Workflow
        • Building the Project
        • Running Tests
        • Building Documentation
        • Generating Coverage
      • Customization
        • Adding Extensions
        • Changing Shell
        • Persistent Storage
      • Troubleshooting
        • Container fails to start
        • ROS 2 commands not found
        • Slow file I/O on macOS/Windows
      • See Also
    • Integrating with Your ROS 2 System
      • Overview
      • Zero-Configuration Integration
      • Organizing with Namespaces
      • Reporting Custom Faults
      • Exposing Custom Data
      • Exposing Services and Actions
      • Exposing Parameters
      • Launch File Integration
      • Production Checklist
      • See Also
    • Customizing the Entity Hierarchy
      • Understanding the Entity Model
      • Default Entity Mapping (Runtime Mode)
      • Designing Your Namespace Structure
      • Implementing in Launch Files
      • Topic-Based Discovery
      • Filtered Topics
      • Best Practices
      • Example: Complete Robot Hierarchy
      • See Also
    • Web UI (sovd_web_ui)
      • Features
      • Quick Start
        • Using Docker
        • From Source
      • Connecting to ros2_medkit
      • Using the Interface
        • Data View
        • Operations
        • Configurations
      • Docker Compose Example
      • Docker Image Tags
      • Tech Stack
      • Repository
      • See Also
    • MCP Server for LLM Integration
      • Overview
      • Quick Start
        • Prerequisites
        • Installation
        • Running the Server
      • Configuration
      • Claude Desktop Integration
      • VS Code Integration
      • Docker Usage
      • MCP Tools Reference
        • Discovery Tools
        • Faults Tools
        • Data Tools
        • Operations Tools
        • Configurations Tools
      • Example Prompts
      • Repository
      • See Also
    • Demos
    • Discovery Tutorials
    • Manifest Discovery
    • Basic Tutorials
    • Companion Projects
    • Advanced Tutorials
  • Troubleshooting & FAQ
    • Installation Issues
    • Gateway Issues
    • Authentication Issues
    • TLS/HTTPS Issues
    • Docker Issues
    • Fault Manager Issues
    • Performance Issues
    • FAQ
    • Getting Help

Architecture

  • Architecture
    • ros2_medkit_diagnostic_bridge
      • Overview
      • Architecture
      • Data Flow
      • Severity Mapping
      • Main Components
      • Configuration
        • Parameters
        • Example Launch Configuration
      • Design Decisions
        • Fault Code Auto-Generation
        • STALE as CRITICAL
    • ros2_medkit_fault_manager
      • Architecture
      • Main Components
      • Services
        • ~/report_fault
        • ~/list_faults
        • ~/clear_fault
      • Design Decisions
        • Thread Safety
        • Fault Aggregation
        • Severity Escalation
        • Status Lifecycle (Debounce Model)
    • ros2_medkit_fault_reporter
      • Overview
      • Architecture
      • Main Components
      • Usage
        • Basic Example
        • Configuration
      • Design Decisions
        • Local Filtering Rationale
        • Fire-and-Forget Service Calls
        • Thread Safety
        • Integration with FaultManager
    • ros2_medkit_gateway
      • Architecture
      • Main Components
    • ros2_medkit_serialization
      • Overview
      • Architecture
      • Main Components
      • Data Flow
        • Publishing (JSON → CDR)
        • Subscribing (CDR → JSON)
        • Service Calls (JSON → CDR → JSON)
      • Design Decisions
        • YAML Bridge
        • Singleton TypeCache
        • Thread Safety
      • Usage in Gateway
        • Example: Publishing to a Topic
        • Example: Deserializing from Subscription
  • Roadmap
    • Strategy
    • Milestones
      • MS1: Full Discovery & Data Access
      • MS2: App Observability
      • MS3: Configuration & Control
      • MS4: Automation & Subscriptions
      • MS5: Fleet & Advanced Features
      • MS6: Fault Management System
    • Future Directions

Configuration

  • Configuration Reference
    • Server Configuration
      • Quick Start
      • Network Settings
      • TLS/HTTPS Configuration
      • CORS Configuration
      • Data Access Settings
      • Performance Tuning
      • Complete Example
      • See Also
    • Discovery Options Reference
      • Discovery Modes
      • Runtime Discovery Options
        • Synthetic Components
        • Topic-Only Namespaces
      • Configuration Example
      • Command Line Override
      • See Also
    • Manifest Schema Reference
      • Top-Level Structure
        • manifest_version (Required)
        • metadata (Optional)
        • config (Optional)
      • Areas
        • Schema
        • Fields
        • Example
      • Components
        • Schema
        • Fields
        • Common Component Types
        • Example
      • Apps
        • Schema
        • Fields
        • ros_binding Fields
        • Example
      • Functions
        • Schema
        • Fields
        • Function Capabilities
        • Example
      • Complete Example
      • Validation
    • Fault Manager Configuration
      • Basic Configuration
        • Storage
        • Debounce Settings
      • Snapshot Configuration
        • Basic Snapshot Settings
        • Rosbag Recording
      • Correlation Configuration
      • Complete Example
      • See Also
    • Diagnostic Bridge Configuration
      • Overview
      • Parameters
      • Custom Fault Code Mappings
        • Auto-Generated Fault Codes
      • Launch File Configuration
      • Integration with FaultManager
      • Migration Strategy
      • See Also
    • Server Configuration
    • Discovery Options
    • Manifest Configuration
    • Fault Manager
    • Diagnostic Bridge

API Reference

  • API Reference
    • REST API Reference
      • Server Capabilities
      • Discovery Endpoints
        • Areas
        • Components
        • Apps
        • Functions
      • Data Endpoints
      • Operations Endpoints
        • List Operations
        • Execute Operations
      • Configurations Endpoints
      • Faults Endpoints
      • Bulk Data Endpoints
        • List Categories
        • List Bulk Data Items
        • Download Bulk Data
      • Authentication Endpoints
      • Error Responses
        • Common Error Codes
      • URL Encoding
      • SOVD Compliance
      • See Also
    • Message Definitions
      • Messages
        • Fault.msg
        • FaultEvent.msg
        • MutedFaultInfo.msg
        • ClusterInfo.msg
      • Services
        • ReportFault.srv
        • ClearFault.srv
        • ListFaults.srv
        • GetSnapshots.srv
      • See Also
    • C++ API Reference
      • ros2_medkit_gateway
        • Classes
        • Data Models
      • ros2_medkit_fault_manager
        • ros2_medkit_fault_manager::FaultManagerNode
        • ros2_medkit_fault_manager::FaultStorage
        • ros2_medkit_fault_manager::InMemoryFaultStorage
      • ros2_medkit_fault_reporter
        • ros2_medkit_fault_reporter::FaultReporter
        • ros2_medkit_fault_reporter::LocalFilter
      • ros2_medkit_diagnostic_bridge
        • ros2_medkit_diagnostic_bridge::DiagnosticBridgeNode
      • ros2_medkit_serialization
        • ros2_medkit_serialization::JsonSerializer
        • ros2_medkit_serialization::TypeCache
        • ros2_medkit_serialization::SerializationError
        • ros2_medkit_serialization::TypeNotFoundError
        • ros2_medkit_serialization::JsonConversionError
    • REST API
    • Message Definitions
    • C++ API

Standard Compliance

  • Standard Compliance
    • Verification
    • Coverage Report
      • Overall Coverage
      • Coverage by Category
      • Missing Verification
      • Full Traceability Matrix
    • API Specification
      • Discovery
      • Faults
      • Data
      • DataSets
      • Subscriptions
      • Operations
        • Operations Overview
        • ExecutionStatus Values
        • Capability Mapping
      • Scripts
      • Configuration
      • Modes
      • ClearData
      • Logs
      • CommLogs
      • BulkData
      • Lifecycle
      • Updates
      • Auth
    • All Requirements

Reference

  • Glossary
  • Changelog
    • [Unreleased]
      • Added
      • Changed
      • Removed
    • [0.1.0] - 2026-02-01
      • Added
      • Companion Projects
      • SOVD Compliance
ros2_medkit
  • Search

© Copyright 2026, selfpatch.

Built with Sphinx using a theme provided by Read the Docs.