RTC Toolkit Logo
6.0.0

Table of Contents

  • Introduction
    • Scope
    • Overview
    • Source Code
  • Release Notes
    • Summary
      • What is the scope of this version?
        • Component Framework
        • Reusable Components
        • Examples and Tutorials
        • Other Features
        • Documentation
      • Limitations and Constraints
    • Dependencies
      • Development Environment ELT DevEnv
      • Deployment
      • Core Integration Infrastructure CII
      • DDS Middleware FastDDS
      • Rapid Application Development RAD
      • Roadrunner
      • Data Display Tool DDT
      • Control UI Toolkit (CUT)
      • STD Interface (stdif)
      • METADAQ Interface (metadaqif)
      • Low-latency Networking Library (llnetio)
      • TAI Clock
      • Msgsend
      • Extensible Test Runner etr
    • Porting Instructions
  • Installation
    • Machine Preparation
      • Prerequisites
      • ELT Development Environment
      • Further Information
    • Install RTC Toolkit and Dependencies
    • Account Configuration
    • Configuration of Required Services
      • Install the CII Service Packages
      • Configure CII
      • Configure Consul
      • Configure Nomad
      • Start and Verify the Required Services
        • CII OLDB
        • Consul
        • Nomad
    • Verify the Installation
      • CII Service Documentation
    • Configuration of Optional Services
      • Install the Monitoring Packages
      • InfluxDB
        • Authenticated Operation
        • Unauthenticated Operation
        • Start InfluxDB
        • Create the Database
      • Telegraf
      • Grafana
      • Import RTC Toolkit Resources
        • Create a Grafana Service Account
        • Configure the InfluxDB Data-Source Token
        • Run the Import
    • Install from Source Code - Optional
      • Installation of Dependencies
      • Installation of the RTC Toolkit
      • Verify Correct Installation
  • Tutorials
    • Creating a Simple RTC Component
      • Running the Example
      • Development Guide
        • Build Script
        • Business Logic Class
        • main.cpp
        • Config Files
    • Creating a Custom RTC Component
      • Running the Example
      • Development Guide
        • MAL Interface Definition
        • RTC Component Application
        • RTC Client Application
    • Telemetry Republisher Example
      • Provided Example
        • Example Location
        • Modules
        • Dependencies
        • The Example Components
        • Configuration
        • Running the Example
    • Customise a Telemetry Subscriber
      • Prerequisites
      • Running the Example
        • Initial Run
        • Deployment
        • Send State Steering Commands
        • Checking the State
        • Checking the Output
        • Stopping and Cleanup
      • Instantiating a Telemetry Subscriber
        • Overview
        • Adjusting the Blender Function
        • Add Additional Topics
    • Creating a Custom Data Task
      • Provided Examples
      • Periodic Telemetry Data Task
        • Source Code Location
        • Modules
        • Dependencies
        • Running the Periodic Telemetry Data Task Example
      • Data Task Development Guide
        • Business Logic Class
        • Computation Class
        • Configuration
      • Measure Telemetry Data Task
        • Source Code Location
        • Modules
        • Dependencies
        • Running the Measure Telemetry Data Task Example
      • Measure Interface Development Guide
        • Business Logic Class
      • Optimise Data Task
        • Source Code Location
        • Modules
        • Running the Optimise Data Task Example
      • Optimise Interface Development Guide
        • Business Logic Class
      • GPU and Python integration
        • GPU Support
        • Python Support
    • Creating a Custom Telemetry Recorder
      • Provided Example
        • Source Code Location
        • Modules
        • Dependencies
        • Running the Example Telemetry Recorder
      • Development Guide
        • Customisation
        • Configuration
    • Creating a Custom Metadata Collector
      • Provided Example
        • Source Code Location
        • Modules
        • Dependencies
        • Running the Example Telemetry Recorder
      • Development Guide
        • Recording Units
        • RecordingInfo
        • Business Logic Factory
    • Creating a Custom DDT Server
      • Provided Example
        • Source Code Location
        • Modules
        • Dependencies
        • Running the Example DDT Server
      • Development Guide
        • Customisation
        • Configuration
    • Creating a Custom RTC Widget
      • Provided Example
        • Source Code Location
        • Modules
        • Dependencies
        • Using the Widget
      • Development Guide
        • Item Factory
        • Widget Implementation
        • Project Definition and Wscript
    • Creating a Custom Grafana visualisation
      • Managing Data Sources
      • Dashboards
        • Create a New Dashboard from a Template
        • Create a New Dashboard from Scratch
      • Create library panel
    • GPU support
      • Overview
      • CUDA
        • Supported versions
        • Installation
        • Waf Support
      • Example Data Task GPU
        • Source Code Location
        • Modules
        • Classes
      • Limitations and Known Issues
    • Python support
      • Overview
        • Source Code Location
        • Modules
        • Running the Example
      • Using Provided Python Bindings
    • Putting Everything Together for a Minimalistic SRTC System
      • Prerequisites
      • Running the Example
      • Development Guide
        • Configuring the example SRTC
        • Configuration of the RTC Supervisor
        • Configuration of the HRTC Supervisor
      • Distributed Scenario
        • CII Services
        • Consul and Nomad
        • Service Discovery Endpoint
        • Running the Example
  • Component Framework
    • RTC Component
      • Supported Functionality
      • Launching
      • Basic Component Life-cycle
      • Introspection Commands
      • Update Command with Custom Payload
      • Custom Component Life-cycles
      • API Usage
      • Limitations and Known Issues
    • Logging
      • API Usage
      • Log Files
    • Service Discovery
      • Supported Service Queries
      • Service Discovery API
      • Example Code
      • Limitations and Known Issues
    • Runtime Configuration Repository
      • Data Access
        • Datapoint Paths
        • Datapoint Creation
        • Datapoint Reading
        • Datapoint Writing
        • Datapoint Querying
        • Datapoint Deletion
        • Command-line/Graphical Manipulation
      • Datapoint Subscription
        • Subscribing to Value Changes
        • Subscribing to Creation and Deletion Events
        • Batch Subscriptions
        • Unsubscribing
      • Supported Data Types
      • Composite Datapoints
        • NUMA Policies
      • Limitations
    • Persistent Configuration Repository
      • Modifying the Configuration
        • Datapoint Paths
        • Datapoint Reading
        • Datapoint Writing
        • Datapoint Querying
      • Configuration Layout
      • Service Discovery Endpoint
      • Data Access Using the API
      • Supported Data Types
      • File Format
        • Layout and Directory Structure
        • External URIs
      • Limitations and Known Issues
    • Online Database
      • Data Access
      • Datapoint Subscription
      • Supported Data Types
      • Limitations and Known Issues
        • Aliasing of Types
        • Performance
    • InfluxDB and Telegraf
      • InfluxDB
        • Terminology
      • Telegraf
        • Plugins
      • TelegrafAdapter
        • InfluxPoint
        • InfluxTagMap
      • Integration in RTC toolkit
        • Metrics
        • States
        • Alerts
    • Event Service
      • Design Assumptions
      • Event Service API
      • Predefined Event Types
      • Creating Custom Event Types
      • Limitations and Known Issues
    • Component Metrics
      • Usage
      • Configuration
      • Online Database Data Points
      • InfluxDB Data Points
      • Supported Performance Counter Types
    • Alert Service
      • Introduction
      • Observability
      • History
      • Usage
    • Consul and Nomad usage
      • Nomad usage
        • Nomad job files
        • Nomad agent
      • Consul usage
        • Consul agent
    • Python Support
      • Guidelines
        • Interpreter Instantiation
        • Always Acquire The GIL
        • Python Exceptions
        • Python Code As Modules
      • Embedded Python Interpreter
      • Provided Python Bindings
      • Limitations and Known Issues
  • Reusable Components
    • RTC Supervisor
      • Overview
      • Launching
      • Commands
      • Customisation
      • Configuration
      • Monitoring
      • Behaviour
        • Populating the Runtime Configuration Repository
        • Handling Operational Modes
        • Writeback to Persistent Configuration Repository
        • State Guiding
        • Status Estimation
        • Component Monitoring
        • Error Recovery
        • Alert Clearing
      • Limitations and Known Issues
    • Telemetry Republisher
      • Overview
      • Prerequisites
      • Customisation
      • Running
      • Commands
      • Configuration
        • Common Configuration
        • Receivers with DDS topics Configuration
        • Simulated DDS Topic Configuration
      • Errors
        • Not Operational
        • Operational
      • Monitoring
        • Component Metrics
        • Alerts
      • Limitations and Known Issues
    • Telemetry Subscriber
      • Overview
      • Prerequisites
      • Customisation
        • Shared Memory Super-Topic
        • The Blender Function
        • Generic Blender Error Codes
        • Custom Error Categories
        • Instantiation
      • Configuration
        • DDS Parameters
        • Shared Memory Queue Parameters
        • Operational Logic Parameters
      • Commands
      • Errors
        • Not Operational
        • Operational
      • Alerts
      • Component Metrics
    • Telemetry Recorder
      • Overview
      • Commands
      • Customisation
      • Configuration
        • Recording Session Configuration
        • Recording Unit Configuration
        • Configuration Example
      • Monitoring
        • Recording Session Monitoring
        • Recording Unit Monitoring
      • Errors
        • Not Operational
        • Operational
      • Limitations and Known Issues
    • Metadata Collector
      • Overview
      • Commands
      • Customisation
      • Configuration
      • Monitoring
      • Limitations and Known Issues
    • Data Task
      • Overview
      • Prerequisites
      • Customisation
      • Telemetry-based Data Tasks
        • Structure
        • Behaviour
        • Configuration
        • Errors
      • Other Data Task Flavours
      • Limitations and Known Issues
    • Deployment Daemon
      • Overview
      • Prerequisites
      • Running
      • Configuration
      • Commands
      • Errors
      • Extendability
      • Troubleshooting
    • DDT Server
      • Overview
      • Commands
      • Customisation
        • IPCQ DDT Forwarder
        • Custom DDT Forwarders
      • Configuration
        • IPCQ DDT Forwarder Configuration
        • DDT Publisher Configuration
      • Monitoring
        • DDT Forwarder Monitoring
      • Errors
        • Not Operational
        • Operational
      • Limitations and Known Issues
    • MUDPI Publisher
      • Overview
      • Running
      • Commands
      • Customisation
      • Configuration
        • Common Configuration
        • Synchronising Publisher Component Instances
        • Publishers Configuration
      • Monitoring
        • Component Metrics
      • Limitations and Known Issues
  • Clients
    • Client Application
      • Overview
      • Configuration
      • Usage
      • Commands
        • Special Commands
        • Standard Interface stdif
        • Update Command Interface ucif
        • Function Control Interface fcif
        • Loop Control Interface lcif
        • Loop Suspension Interface lsif
        • Measure Command Interface mcif
        • Optimise Command Interface ocif
        • Set Modes Interface smif
        • Writeback Interface wbif
      • Customisation
      • Limitations and Known Issues
    • Configuration Tool
      • Tool Setup
      • Command Line Repository Operations
        • Get
        • Set
        • Delete
        • List
        • Read
        • Write
        • Validate
        • Populate
      • Graphical User Interface
      • Interactive Shell
      • Grafana resources
        • Import
        • Export
        • Cleanup
      • Limitations and Known Issues
    • Control and Monitoring Tool
      • Starting the Application
      • Summary of the Control and Monitoring Tool
        • Menu
        • Deployment Overview
        • Commands
        • Logs
      • Errors
      • Limitations and Known Issues
    • Service Discovery Client
      • Usage
      • Limitations and Known Issues
    • Grafana
      • Prepared dashboards
        • Server status
        • RTC Overview
        • Data Task
        • DDT Server
        • Deployment Daemon
        • General Component
        • Metadata Collector
        • MUDPI Publisher
        • RTC Supervisor
        • Telemetry Recorder
        • Telemetry Republisher
        • Telemetry Subscriber
        • Template
      • Prepared Library panels
  • Standalone Tools
    • Generic DDS publisher
      • Overview
      • Prerequisites
      • Running
      • Stopping
    • Generic DDS subscriber
      • Overview
      • Prerequisites
      • Running
      • Stopping
    • Shared Memory Publisher
      • Customisation
      • Operation
        • Repeat Mode
      • Troubleshooting
    • Raw Recorder
      • Overview
      • Raw Recorder Capture Tool
        • Usage
        • Example
      • Raw Recorder Extractor Tool
        • Usage
        • Example
    • Generic MUDPI publisher standalone tool
      • Overview
      • Running
      • Stopping
      • Limitations and Known Issues
    • MUDPI Publisher
      • Introduction
      • Running Multiple Instances with Triggering
      • Making a sample text file
      • Running with the TelRepub
    • Generic RTR Writer
      • Overview
      • Prerequisites
      • Running
      • Stopping
    • Generic Event Channel publisher
      • Overview
      • Running
      • Stopping
    • Generic Event Channel subscriber
      • Overview
      • Running
      • Stopping
  • Developer Guides
    • ELT Development Environment Documentation
    • ELT Software Development Guides
    • CII Documentation
    • Data Display Tool (DDT)
    • Control UI Toolkit (CUT)
    • ICS Documentation
    • Third Party Documentation
  • API Documentation
RTC Toolkit
  • Welcome to RTC Toolkit documentation!

Welcome to RTC Toolkit documentation!

Table of Contents

  • Introduction
  • Release Notes
  • Installation
  • Tutorials
  • Component Framework
  • Reusable Components
  • Clients
  • Standalone Tools
  • Developer Guides
  • API Documentation
Next

© Copyright 2025 ESO - European Southern Observatory.