openc3 5.2.0 → 5.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aff3df27d8a9cde6fb3e45403131ff0a29fbb5abb2e204e398e33d79c2bb7ead
-  data.tar.gz: ae3041bbd1868d8f3c5627dd5a6ebc381397deae7d27d997e7dfee009683175c
+  metadata.gz: 6c51fd2722cde933052c2bf5941c3a111a14ae995de868bb6371faf9f32f708e
+  data.tar.gz: 0a1684b608df0335f485e59b29e55e66a1307cb62c7ab76586989a4566096946
 SHA512:
-  metadata.gz: 967885d19c2ccf945765d355346ffde2aca982e65993630f4a4c4fe36a7f04c425176f50b9a8e4c639a21a5cc673f87928513047c84fccc3d12a8d59762fe44e
-  data.tar.gz: 2d11de60af3e15328db350cd278dc4ec79a848bb8bfbcb5f6f1a819f052f93f37397f2f23e1a1ebc1868b002f9568262599e05aa9c33f960f8fef31fe25e221b
+  metadata.gz: c36db608db41b6f0c1edc8ae6b83293d71eb37984e115d86a9ca9ff1e6aa4f124c3e0d645b1ac01b329d3fd490ef6a3b281ddc2754344bbdc1c78a702258522c
+  data.tar.gz: 754bc2ce9f0fd0066e47731bc5b50279ac5ce166f20752bb5be42d2ce4ab09698212ee82abcfd1ab353aa1e85029f47e5b766b4bfdba60823682c23148754837

data/bin/openc3cli

@@ -322,14 +322,14 @@ ensure
   exit(result)
 end
 
-def update_plugin(plugin_file_path, plugin_name, variables: nil, plugin_txt_lines: nil, scope:, existing_plugin_name:)
+def update_plugin(plugin_file_path, plugin_name, variables: nil, plugin_txt_lines: nil, scope:, existing_plugin_name:, force: false)
   new_gem = File.basename(plugin_file_path)
   old_gem = existing_plugin_name.split("__")[0]
   puts "Updating existing plugin: #{existing_plugin_name} with #{File.basename(plugin_file_path)}"
   plugin_model = OpenC3::PluginModel.get_model(name: existing_plugin_name, scope: scope)
   begin
     # Only update if something has changed
-    if (new_gem != old_gem) or (variables and variables != plugin_model.variables) or (plugin_txt_lines and plugin_txt_lines != plugin_model.plugin_txt_lines)
+    if force or (new_gem != old_gem) or (variables and variables != plugin_model.variables) or (plugin_txt_lines and plugin_txt_lines != plugin_model.plugin_txt_lines)
       puts "Gem version change detected - New: #{new_gem}, Old: #{old_gem}" if new_gem != old_gem
       if variables and variables != plugin_model.variables
         pp_variables = ""
@@ -360,7 +360,7 @@ end
 # This code is used from the command line and is the same code that gets called if you
 # edit/upgrade or install a new plugin from the Admin interface
 #
-# Usage: cli load gemfile_path [scope] [plugin_hash_file_path]
+# Usage: cli load gemfile_path [scope] [plugin_hash_file_path] [force]
 #
 # With just gemfile_path and/or scope: Will do nothing if any plugin
 # with the same gem file already exists
@@ -370,7 +370,10 @@ end
 # Otherwise, it will be assumed that the plugin is intentionally being installed for a second
 # time
 #
-def load_plugin(plugin_file_path, scope:, plugin_hash_file: nil)
+# Pass true as the last argument to force install even if a plugin with
+# the same version number exists
+#
+def load_plugin(plugin_file_path, scope:, plugin_hash_file: nil, force: false)
   scope ||= 'DEFAULT'
   # Only create the scope if it doesn't already exist
   unless OpenC3::ScopeModel.names.include?(scope)
@@ -403,7 +406,7 @@ def load_plugin(plugin_file_path, scope:, plugin_hash_file: nil)
           found = true
           # Upgrade if version changed else do nothing
           if file_full_name != full_name
-            update_plugin(plugin_file_path, plugin_name, scope: scope, existing_plugin_name: plugin_name)
+            update_plugin(plugin_file_path, plugin_name, scope: scope, existing_plugin_name: plugin_name, force: force)
           else
             puts "No version change detected for: #{plugin_name}"
           end
@@ -430,15 +433,16 @@ def load_plugin(plugin_file_path, scope:, plugin_hash_file: nil)
 
     if existing_plugin_hash
       # Upgrade or Edit
-      update_plugin(plugin_file_path, plugin_hash['name'], variables: plugin_hash['variables'], plugin_txt_lines: plugin_hash['plugin_txt_lines'], scope: scope, existing_plugin_name: existing_plugin_hash['name'])
+      update_plugin(plugin_file_path, plugin_hash['name'], variables: plugin_hash['variables'], scope: scope,
+        plugin_txt_lines: plugin_hash['plugin_txt_lines'], existing_plugin_name: existing_plugin_hash['name'], force: force)
     else
       # New Install
       puts "Loading new plugin: #{plugin_file_path}\n#{plugin_hash}"
       plugin_hash = OpenC3::PluginModel.install_phase2(plugin_hash, scope: scope)
       OpenC3::LocalMode.update_local_plugin(plugin_file_path, plugin_hash, scope: scope)
     end
-  rescue => err
-    abort("Error installing plugin: #{scope}: #{plugin_file_path}: #{err.formatted}")
+  rescue => error
+    abort("Error installing plugin: #{scope}: #{plugin_file_path}\n#{error.message}")
   end
 end
 
@@ -517,129 +521,128 @@ def run_migrations(folder)
   end
 end
 
-if __FILE__ == $0
-  if not ARGV[0].nil? # argument(s) given
+if not ARGV[0].nil? # argument(s) given
 
-    # Handle each task
-    case ARGV[0].downcase
+  # Handle each task
+  case ARGV[0].downcase
 
-    when 'rake'
-      puts `rake #{ARGV[1..-1].join(' ')}`
+  when 'rake'
+    puts `rake #{ARGV[1..-1].join(' ')}`
 
-    when 'validate'
-      validate_plugin(ARGV[1], scope: ARGV[2], variables_file: ARGV[3])
+  when 'validate'
+    validate_plugin(ARGV[1], scope: ARGV[2], variables_file: ARGV[3])
 
-    when 'load'
-      load_plugin(ARGV[1], scope: ARGV[2], plugin_hash_file: ARGV[3])
+  when 'load'
+    # force is a boolean so if they pass 'force' it is true
+    # See plugins_controller.rb install for usage
+    load_plugin(ARGV[1], scope: ARGV[2], plugin_hash_file: ARGV[3], force: ARGV[4] == 'force')
 
-    when 'unload'
-      unload_plugin(ARGV[1], scope: ARGV[2])
+  when 'unload'
+    unload_plugin(ARGV[1], scope: ARGV[2])
 
-    when 'geminstall'
-      gem_install(ARGV[1], scope: ARGV[2])
+  when 'geminstall'
+    gem_install(ARGV[1], scope: ARGV[2])
 
-    when 'generate'
-      generate(ARGV[1..-1])
+  when 'generate'
+    generate(ARGV[1..-1])
 
-    when 'migrate'
-      migrate(ARGV[1..-1])
+  when 'migrate'
+    migrate(ARGV[1..-1])
 
-    when 'rubysloc'
-      puts `ruby /openc3/bin/rubysloc #{ARGV[1..-1].join(' ')}`
+  when 'rubysloc'
+    puts `ruby /openc3/bin/rubysloc #{ARGV[1..-1].join(' ')}`
 
-    when 'cstol_converter'
-      puts `ruby /openc3/bin/cstol_converter #{ARGV[1..-1].join(' ')}`
+  when 'cstol_converter'
+    puts `ruby /openc3/bin/cstol_converter #{ARGV[1..-1].join(' ')}`
 
-    when 'xtce_converter'
-      xtce_converter(ARGV[1..-1])
+  when 'xtce_converter'
+    xtce_converter(ARGV[1..-1])
 
-    when 'bridge'
-      ENV['OPENC3_NO_STORE'] = '1'
-      filename = ARGV[1]
-      filename = 'bridge.txt' unless filename
-      bridge = OpenC3::Bridge.new(filename)
-      begin
-        while true
-          sleep(1)
-        end
-      rescue Interrupt
-        exit(0)
+  when 'bridge'
+    ENV['OPENC3_NO_STORE'] = '1'
+    filename = ARGV[1]
+    filename = 'bridge.txt' unless filename
+    bridge = OpenC3::Bridge.new(filename)
+    begin
+      while true
+        sleep(1)
       end
+    rescue Interrupt
+      exit(0)
+    end
 
-    when 'bridgesetup'
-      ENV['OPENC3_NO_STORE'] = '1'
-      filename = ARGV[1]
-      filename = 'bridge.txt' unless filename
-      unless File.exist?(filename)
-        OpenC3::BridgeConfig.generate_default(filename)
-      end
+  when 'bridgesetup'
+    ENV['OPENC3_NO_STORE'] = '1'
+    filename = ARGV[1]
+    filename = 'bridge.txt' unless filename
+    unless File.exist?(filename)
+      OpenC3::BridgeConfig.generate_default(filename)
+    end
 
-    when 'help'
-      print_usage()
-
-    when 'redis'
-      case (ARGV[1])
-      when 'keys'
-        get_redis_keys()
-      when 'hget'
-        redis = Redis.new(url: $redis_url, username: ENV['OPENC3_REDIS_USERNAME'], password: ENV['OPENC3_REDIS_PASSWORD'])
-        puts JSON.parse(redis.hget(ARGV[2], ARGV[3]), :allow_nan => true, :create_additions => true)
-      else
-        puts "Unknown redis task: #{ARGV[1]}\n"
-        puts "Valid redis tasks: keys, hget"
-      end
+  when 'help'
+    print_usage()
 
-    when 'removebase'
-      # Used to remove tool base to better support enterprise upgrade
-      scopes = OpenC3::ScopeModel.all
-      scopes.each do |scope_name, scope|
-        plugins = OpenC3::PluginModel.all(scope: scope_name)
-        plugins.each do |plugin_name, plugin|
-          if plugin["name"] =~ /tool-base/ and plugin["name"] !~ /enterprise/
-            unload_plugin(plugin_name, scope: scope_name)
-          end
-          if plugin["name"] =~ /tool-admin/ and plugin["name"] !~ /enterprise/
-            unload_plugin(plugin_name, scope: scope_name)
-          end
+  when 'redis'
+    case (ARGV[1])
+    when 'keys'
+      get_redis_keys()
+    when 'hget'
+      redis = Redis.new(url: $redis_url, username: ENV['OPENC3_REDIS_USERNAME'], password: ENV['OPENC3_REDIS_PASSWORD'])
+      puts JSON.parse(redis.hget(ARGV[2], ARGV[3]), :allow_nan => true, :create_additions => true)
+    else
+      puts "Unknown redis task: #{ARGV[1]}\n"
+      puts "Valid redis tasks: keys, hget"
+    end
+
+  when 'removebase'
+    # Used to remove tool base to better support enterprise upgrade
+    scopes = OpenC3::ScopeModel.all
+    scopes.each do |scope_name, scope|
+      plugins = OpenC3::PluginModel.all(scope: scope_name)
+      plugins.each do |plugin_name, plugin|
+        if plugin["name"] =~ /tool-base/ and plugin["name"] !~ /enterprise/
+          unload_plugin(plugin_name, scope: scope_name)
+        end
+        if plugin["name"] =~ /tool-admin/ and plugin["name"] !~ /enterprise/
+          unload_plugin(plugin_name, scope: scope_name)
         end
       end
+    end
 
-    when 'removeenterprise'
-      # Used to remove enterprise plugins to better support downgrade
-      scopes = OpenC3::ScopeModel.all
-      scopes.each do |scope_name, scope|
-        plugins = OpenC3::PluginModel.all(scope: scope_name)
-        plugins.each do |plugin_name, plugin|
-          if plugin["name"] =~ /enterprise/
-            unload_plugin(plugin_name, scope: scope_name)
-          end
+  when 'removeenterprise'
+    # Used to remove enterprise plugins to better support downgrade
+    scopes = OpenC3::ScopeModel.all
+    scopes.each do |scope_name, scope|
+      plugins = OpenC3::PluginModel.all(scope: scope_name)
+      plugins.each do |plugin_name, plugin|
+        if plugin["name"] =~ /enterprise/
+          unload_plugin(plugin_name, scope: scope_name)
         end
       end
+    end
 
-    when 'destroyscope'
-      scope = OpenC3::ScopeModel.get_model(name: ARGV[1])
-      scope.destroy
+  when 'destroyscope'
+    scope = OpenC3::ScopeModel.get_model(name: ARGV[1])
+    scope.destroy
 
-    when 'localinit'
-      OpenC3::LocalMode.local_init()
+  when 'localinit'
+    OpenC3::LocalMode.local_init()
 
-    when 'initbuckets'
-      client = OpenC3::Bucket.getClient()
-      client.create(ENV['OPENC3_CONFIG_BUCKET'])
-      client.create(ENV['OPENC3_LOGS_BUCKET'])
-      client.create(ENV['OPENC3_TOOLS_BUCKET'])
-      client.ensure_public(ENV['OPENC3_TOOLS_BUCKET'])
+  when 'initbuckets'
+    client = OpenC3::Bucket.getClient()
+    client.create(ENV['OPENC3_CONFIG_BUCKET'])
+    client.create(ENV['OPENC3_LOGS_BUCKET'])
+    client.create(ENV['OPENC3_TOOLS_BUCKET'])
+    client.ensure_public(ENV['OPENC3_TOOLS_BUCKET'])
 
-    when 'runmigrations'
-      run_migrations(ARGV[1])
+  when 'runmigrations'
+    run_migrations(ARGV[1])
 
-    else # Unknown task
-      print_usage()
-      abort("Unknown task: #{ARGV[0]}")
-    end
-
-  else # No arguments given
+  else # Unknown task
     print_usage()
+    abort("Unknown task: #{ARGV[0]}")
   end
 
-end
+else # No arguments given
+  print_usage()
+end

data/data/config/interface_modifiers.yaml

@@ -78,10 +78,6 @@ PROTOCOL:
     Protocols can be either READ, WRITE, or READ_WRITE. READ protocols act on the data
     received by the interface while write acts on the data before it is sent out. READ_WRITE applies
     the protocol to both reading and writing.<br/><br/>
-    There is only one built in protocol implemented by override_protocol.rb.
-    This protocol allows for Scripts to use the override_tlm() and normalize_tlm() methods to permanently
-    change a telemetry value. Note, this differs from set_tlm() as set_tlm() is over-written by new
-    incoming telemetry.<br/><br/>
     For information on creating your own custom protocol please see <a href="https://openc3.com/docs/v5/protocols">https://openc3.com/docs/v5/protocols</a>
   since: 4.0.0
   parameters:
@@ -116,3 +112,25 @@ OPTION:
       required: false
       description: Parameters to pass to the option
       values: .*
+SECRET:
+  summary: Define a secret needed by this interface
+  description: Defines a secret for this interface and optionally assigns its value to an option
+  parameters:
+    - name: Type
+      required: true
+      description:
+        ENV or FILE.  ENV will mount the secret into an environment variable.
+        FILE mounts the secret into a file.
+      values: .*
+    - name: Secret Name
+      required: true
+      description: The name of the secret to retrieve
+      values: .*
+    - name: Environment Variable of File Path
+      required: true
+      description: Environment variable name or file path to store secret
+      values: .*
+    - name: Option Name
+      required: false
+      description: Interface option to pass the secret value
+      values: .*

data/data/config/item_modifiers.yaml

@@ -5,11 +5,13 @@ STATE:
   description: Key value pairs allow for user friendly strings. For example,
     you might define states for ON = 1 and OFF = 0. This allows the word ON to be
     used rather than the number 1 when sending the telemetry item and allows
-    for much greater clarity and less chance for user error.
+    for much greater clarity and less chance for user error. A catch all value
+    of ANY applies to all other values not already defined as state values.
   example: |
     APPEND_ITEM ENABLE 32 UINT "Enable setting"
       STATE FALSE 0
       STATE TRUE 1
+      STATE ERROR ANY # Match all other values to ERROR
     APPEND_ITEM STRING 1024 STRING "String"
       STATE "NOOP" "NOOP" GREEN
       STATE "ARM LASER" "ARM LASER" YELLOW
@@ -21,7 +23,7 @@ STATE:
       values: .*
     - name: Value
       required: true
-      description: The numerical state value
+      description: The numerical state value or ANY to apply the state to all other values
       values: .*
     - name: Color
       required: false

data/data/config/microservice.yaml

@@ -88,3 +88,21 @@ MICROSERVICE:
           required: false
           description: Name of the container
           values: .+
+    SECRET:
+      summary: Define a secret needed by this microservice
+      description: Defines a secret for this microservice
+      parameters:
+        - name: Type
+          required: true
+          description:
+            ENV or FILE.  ENV will mount the secret into an environment variable.
+            FILE mounts the secret into a file.
+          values: .*
+        - name: Secret Name
+          required: true
+          description: The name of the secret to retrieve
+          values: .*
+        - name: Environment Variable of File Path
+          required: true
+          description: Environment variable name or file path to store secret
+          values: .*

data/data/config/table_manager.yaml

@@ -80,8 +80,8 @@ SELECT_TABLE:
       description: The name of the existin table
       values: .*
 DEFAULT:
-  summary: Specify default values for a SINGLE row in a multi-column table.
-    If you have multiple rows you need a DEFAULT line for each row.
+  summary: Specify default values for a SINGLE row in a multi-column table
+  description: If you have multiple rows you need a DEFAULT line for each row.
     If all your rows are identical consider using ERB as shown in the OpenC3 demo.
   parameters:
     - name: Default values

data/data/config/tool.yaml

@@ -47,7 +47,7 @@ TOOL:
           values: .+
     CATEGORY:
       summary: Category for the tool
-      description: Associates the tool with a category. In a future release this will be able to organize tools into submenus in the Navigation menu.
+      description: Associates the tool with a category which becomes a submenu in the Navigation menu.
       parameters:
         - name: Category Name
           required: true

data/ext/openc3/ext/config_parser/config_parser.c

@@ -41,6 +41,7 @@ static ID id_method_scan = 0;
 static ID id_method_strip = 0;
 static ID id_method_to_s = 0;
 static ID id_method_upcase = 0;
+static ID id_method_parse_errors = 0;
 
 /*
  * Removes quotes from the given string if present.
@@ -103,6 +104,7 @@ static VALUE parse_loop(VALUE self, VALUE io, VALUE yield_non_keyword_lines, VAL
   volatile VALUE ivar_keyword = Qnil;
   volatile VALUE ivar_parameters = rb_ary_new();
   volatile VALUE ivar_line = rb_str_new2("");
+  volatile VALUE errors = rb_ary_new();
 
   rb_ivar_set(self, id_ivar_line_number, INT2FIX(0));
   rb_ivar_set(self, id_ivar_keyword, ivar_keyword);
@@ -205,7 +207,12 @@ static VALUE parse_loop(VALUE self, VALUE io, VALUE yield_non_keyword_lines, VAL
         rb_ary_clear(array);
         rb_ary_push(array, ivar_keyword);
         rb_ary_push(array, ivar_parameters);
-        rb_yield(array);
+        line = rb_protect(rb_yield, array, &result);
+        if (result)
+        {
+          rb_ary_push(errors, rb_errinfo());
+          rb_set_errinfo(Qnil);
+        }
       }
       ivar_line = rb_str_new2("");
       rb_ivar_set(self, id_ivar_line, ivar_line);
@@ -247,11 +254,18 @@ static VALUE parse_loop(VALUE self, VALUE io, VALUE yield_non_keyword_lines, VAL
     rb_ary_clear(array);
     rb_ary_push(array, ivar_keyword);
     rb_ary_push(array, ivar_parameters);
-    rb_yield(array);
+    line = rb_protect(rb_yield, array, &result);
+    if (result)
+    {
+      rb_ary_push(errors, rb_errinfo());
+      rb_set_errinfo(Qnil);
+    }
     ivar_line = rb_str_new2("");
     rb_ivar_set(self, id_ivar_line, ivar_line);
   }
 
+  rb_funcall(self, id_method_parse_errors, 1, errors);
+
   if (RTEST(progress_callback))
   {
     rb_funcall(progress_callback, id_method_call, 1, rb_float_new(1.0));
@@ -278,6 +292,7 @@ void Init_config_parser(void)
   id_method_strip = rb_intern("strip");
   id_method_to_s = rb_intern("to_s");
   id_method_upcase = rb_intern("upcase");
+  id_method_parse_errors = rb_intern("parse_errors");
 
   mOpenC3 = rb_define_module("OpenC3");
 

data/lib/openc3/api/api.rb

@@ -26,6 +26,7 @@ require 'openc3/api/cmd_api'
 require 'openc3/api/config_api'
 require 'openc3/api/interface_api'
 require 'openc3/api/limits_api'
+require 'openc3/api/metrics_api'
 require 'openc3/api/offline_access_api'
 require 'openc3/api/router_api'
 require 'openc3/api/settings_api'

data/lib/openc3/api/interface_api.rb

@@ -36,6 +36,8 @@ module OpenC3
                        'stop_raw_logging_interface',
                        'get_all_interface_info',
                        'map_target_to_interface',
+                       'interface_cmd',
+                       'interface_protocol_cmd'
                      ])
 
     # Get information about an interface
@@ -139,5 +141,15 @@ module OpenC3
       end
       nil
     end
+
+    def interface_cmd(interface_name, cmd_name, *cmd_params, scope: $openc3_scope, token: $openc3_token)
+      authorize(permission: 'system_set', interface_name: interface_name, scope: scope, token: token)
+      InterfaceTopic.interface_cmd(interface_name, cmd_name, *cmd_params, scope: scope)
+    end
+
+    def interface_protocol_cmd(interface_name, cmd_name, *cmd_params, read_write: :READ_WRITE, index: -1, scope: $openc3_scope, token: $openc3_token)
+      authorize(permission: 'system_set', interface_name: interface_name, scope: scope, token: token)
+      InterfaceTopic.protocol_cmd(interface_name, cmd_name, *cmd_params, read_write: read_write, index: index, scope: scope)
+    end
   end
 end

data/lib/openc3/api/metrics_api.rb

@@ -0,0 +1,97 @@
+# encoding: ascii-8bit
+
+# Copyright 2023 OpenC3, Inc
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU Affero General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+
+# This file may also be used under the terms of a commercial license
+# if purchased from OpenC3, Inc.
+
+require 'openc3/models/metric_model'
+require 'openc3/utilities/authentication'
+require 'openc3/utilities/store'
+
+module OpenC3
+  module Api
+    WHITELIST ||= []
+    WHITELIST.concat([
+                       'get_metrics',
+                     ])
+
+    DELAY_METRICS = {}
+    DELAY_METRICS['decom_topic_delta_seconds'] = 0.0
+    DELAY_METRICS['interface_topic_delta_seconds'] = 0.0
+    DELAY_METRICS['log_topic_delta_seconds'] = 0.0
+    DELAY_METRICS['router_topic_delta_seconds'] = 0.0
+    DELAY_METRICS['text_log_topic_delta_seconds'] = 0.0
+
+    DURATION_METRICS = {}
+    DURATION_METRICS['decom_duration_seconds'] = 0.0
+    DURATION_METRICS['reducer_minute_processing_seconds'] = 0
+    DURATION_METRICS['reducer_hour_processing_seconds'] = 0
+    DURATION_METRICS['reducer_day_processing_seconds'] = 0
+
+    SUM_METRICS = {}
+    SUM_METRICS['cleanup_total'] = 0
+    SUM_METRICS['cleanup_delete_total'] = 0
+    SUM_METRICS['decom_total'] = 0
+    SUM_METRICS['decom_error_total'] = 0
+    SUM_METRICS['interface_cmd_total'] = 0
+    SUM_METRICS['interface_tlm_total'] = 0
+    SUM_METRICS['interface_directive_total'] = 0
+    SUM_METRICS['log_total'] = 0
+    SUM_METRICS['log_error_total'] = 0
+    SUM_METRICS['periodic_total'] = 0
+    SUM_METRICS['reducer_total'] = 0
+    SUM_METRICS['reducer_error_total'] = 0
+    SUM_METRICS['router_cmd_total'] = 0
+    SUM_METRICS['router_tlm_total'] = 0
+    SUM_METRICS['router_directive_total'] = 0
+    SUM_METRICS['text_log_total'] = 0
+    SUM_METRICS['text_log_error_total'] = 0
+
+    def get_metrics(scope: $openc3_scope, token: $openc3_token)
+      authorize(permission: 'system', scope: scope, token: token)
+
+      sum_metrics = SUM_METRICS.dup
+      duration_metrics = DURATION_METRICS.dup
+      delay_metrics = DELAY_METRICS.dup
+
+      metrics = MetricModel.all(scope: scope)
+      metrics.each do |microservice_name, metrics|
+        next unless metrics and metrics['values']
+        metrics['values'].each do |metric_name, data|
+          value = data['value']
+          if sum_metrics[metric_name]
+            sum_metrics[metric_name] += value
+          elsif duration_metrics[metric_name]
+            previous = duration_metrics[metric_name]
+            duration_metrics[metric_name] = value if value > previous
+          elsif delay_metrics.include?(metric_name)
+            previous = delay_metrics[metric_name]
+            delay_metrics[metric_name] = value if value > previous
+          else
+            # Ignore other metrics for now
+          end
+        end
+      end
+
+      result = delay_metrics
+      result.merge!(duration_metrics)
+      result.merge!(sum_metrics)
+
+      result.merge!(MetricModel.redis_metrics)
+
+      return result
+    end
+  end
+end

data/lib/openc3/api/router_api.rb

@@ -35,6 +35,8 @@ module OpenC3
                        'start_raw_logging_router',
                        'stop_raw_logging_router',
                        'get_all_router_info',
+                       'router_cmd',
+                       'router_protocol_cmd'
                      ])
 
     # Get information about a router
@@ -74,7 +76,7 @@ module OpenC3
 
     # Starts raw logging for a router
     #
-    # @param router_name [String] The name of the interface
+    # @param router_name [String] The name of the router
     def start_raw_logging_router(router_name = 'ALL', scope: $openc3_scope, token: $openc3_token)
       authorize(permission: 'system_set', router_name: router_name, scope: scope, token: token)
       if router_name == 'ALL'
@@ -88,7 +90,7 @@ module OpenC3
 
     # Stop raw logging for a router
     #
-    # @param router_name [String] The name of the interface
+    # @param router_name [String] The name of the router
     def stop_raw_logging_router(router_name = 'ALL', scope: $openc3_scope, token: $openc3_token)
       authorize(permission: 'system_set', router_name: router_name, scope: scope, token: token)
       if router_name == 'ALL'
@@ -116,5 +118,15 @@ module OpenC3
       info.sort! { |a, b| a[0] <=> b[0] }
       info
     end
+
+    def router_cmd(router_name, cmd_name, *cmd_params, scope: $openc3_scope, token: $openc3_token)
+      authorize(permission: 'system_set', router_name: router_name, scope: scope, token: token)
+      RouterTopic.router_cmd(router_name, cmd_name, *cmd_params, scope: scope)
+    end
+
+    def router_protocol_cmd(router_name, cmd_name, *cmd_params, read_write: :READ_WRITE, index: -1, scope: $openc3_scope, token: $openc3_token)
+      authorize(permission: 'system_set', router_name: router_name, scope: scope, token: token)
+      RouterTopic.protocol_cmd(router_name, cmd_name, *cmd_params, read_write: read_write, index: index, scope: scope)
+    end
   end
 end