cosmosc2-demo 5.0.2.pre.beta2

data/targets/SYSTEM/lib/example_background_task.rb

@@ -0,0 +1,66 @@
+# encoding: ascii-8bit
+
+# Copyright 2022 Ball Aerospace & Technologies Corp.
+# 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 program may also be used under the terms of a commercial or
+# enterprise edition license of COSMOS if purchased from the
+# copyright holder
+
+# This file implements an example background task
+
+require 'cosmos/tools/cmd_tlm_server/background_task'
+
+module Cosmos
+  # Starts by sleeping 5 seconds then sends up to three collect commands
+  class ExampleBackgroundTask < BackgroundTask
+    def initialize
+      super()
+      @name = 'Example Background Task'
+      # Create Sleeper here in case the task is stopped before call is executed
+      @sleeper = Sleeper.new
+    end
+
+    def call
+      sent_count = 0
+      @sleeper = Sleeper.new
+      @status = "Sleeping for 5 seconds"
+      return if @sleeper.sleep(5) # allow interfaces time to start
+      initial_count = tlm('INST', 'HEALTH_STATUS', 'COLLECTS')
+      loop do
+        # Start up with at least 3 collects
+        count = tlm('INST', 'HEALTH_STATUS', 'COLLECTS')
+        if count < (initial_count + 3)
+          begin
+            cmd('INST', 'COLLECT', 'TYPE' => 'NORMAL', 'DURATION' => 1)
+            sent_count += 1
+            @status = "Sent COLLECT ##{sent_count} at #{Time.now.sys.formatted}"
+            wait("INST HEALTH_STATUS COLLECTS > #{count}", 5)
+            @status = "Tlm Updated at #{Time.now.sys.formatted}"
+          rescue
+            # Oh well - probably disconnected
+          end
+        else
+          break
+        end
+        return if @sleeper.sleep(1)
+      end
+      @status = "Finished at #{Time.now.sys.formatted}"
+    end
+
+    def stop
+      @sleeper.cancel
+      @status = "Stopped at #{Time.now.sys.formatted}"
+    end
+  end
+end

data/targets/SYSTEM/lib/example_target.rb

@@ -0,0 +1,112 @@
+# encoding: ascii-8bit
+
+# Copyright 2022 Ball Aerospace & Technologies Corp.
+# 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 program may also be used under the terms of a commercial or
+# enterprise edition license of COSMOS if purchased from the
+# copyright holder
+
+require 'cosmos'
+require 'cosmos/interfaces'
+require 'cosmos/tools/cmd_tlm_server/interface_thread'
+
+module Cosmos
+  class ExampleTarget
+    class ExampleServerInterface < TcpipServerInterface
+      PORT = 9999
+
+      def initialize
+        super(PORT, PORT, 5.0, nil, 'LENGTH', 0, 32, 4, 1, 'BIG_ENDIAN', 4, nil, nil, true)
+      end
+    end
+
+    class ExampleInterfaceThread < InterfaceThread
+      protected
+      def handle_packet(packet)
+        identified_packet = System.commands.identify(packet.buffer, ['EXAMPLE'])
+        if identified_packet
+          Logger.info "Received command: #{identified_packet.target_name} #{identified_packet.packet_name}"
+        else
+          Logger.info "Received UNKNOWN command"
+        end
+      end
+    end
+
+    class ExampleTelemetryThread
+      attr_reader :thread
+
+      def initialize(interface)
+        @interface = interface
+        @sleeper = Sleeper.new
+      end
+
+      def start
+        packet = System.telemetry.packet('EXAMPLE', 'STATUS')
+        @thread = Thread.new do
+          @stop_thread = false
+          begin
+            loop do
+              packet.write('PACKET_ID', 1)
+              packet.write('STRING', "The time is now: #{Time.now.sys.formatted}")
+              @interface.write(packet)
+              break if @sleeper.sleep(1)
+            end
+          rescue Exception => err
+            Logger.error "ExampleTelemetryThread unexpectedly died\n#{err.formatted}"
+          end
+        end
+      end
+
+      def stop
+        Cosmos.kill_thread(self, @thread)
+      end
+
+      def graceful_kill
+        @sleeper.cancel
+      end
+    end
+
+    def initialize
+      # Create interface to receive commands and send telemetry
+      @interface = ExampleServerInterface.new
+      @interface_thread = nil
+      @telemetry_thread = nil
+    end
+
+    def start
+      @interface_thread = ExampleInterfaceThread.new(@interface)
+      @interface_thread.start
+      @telemetry_thread = ExampleTelemetryThread.new(@interface)
+      @telemetry_thread.start
+    end
+
+    def stop
+      @telemetry_thread.stop if @telemetry_thread
+      @interface_thread.stop if @interface_thread
+    end
+
+    def self.run
+      Logger.level = Logger::INFO
+      target = self.new
+      begin
+        target.start
+        while true
+          sleep 1
+        end
+      rescue SystemExit, Interrupt
+        target.stop
+      end
+    end
+  end
+end

data/targets/SYSTEM/lib/limits_groups.rb

@@ -0,0 +1,64 @@
+# encoding: ascii-8bit
+
+# Copyright 2022 Ball Aerospace & Technologies Corp.
+# 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 program may also be used under the terms of a commercial or
+# enterprise edition license of COSMOS if purchased from the
+# copyright holder
+
+require 'cosmos/tools/cmd_tlm_server/limits_groups_background_task'
+
+module Cosmos
+  # Inheriting from the LimitsGroupsBackgroundTask provides a framework for
+  # automatically enabling and disabling limits groups based on telemetry.
+  class LimitsGroups < LimitsGroupsBackgroundTask
+    def initialize(initial_delay = 0, task_delay = 0.5)
+      # Initial delay upon starting the server before staring the group checks
+      # followed by the background task delay between check iterations
+      super(initial_delay, task_delay)
+      # Creating a Proc allows for arbitrary code to be executed when a group
+      # is enabled or disabled.
+      @temp2_enable_code = Proc.new do
+        enable_limits_group('INST2_GROUND') # Enable the INST2_GROUND group
+      end
+      @temp2_disable_code = Proc.new do
+        disable_limits_group('INST2_GROUND') # Disable the INST2_GROUND group
+      end
+    end
+
+    # This method name is important. It must begin with 'check_' and end with
+    # the name of a Limits Group defined by the LIMITS_GROUP keyword. In the
+    # demo this is defined in config/targets/SYSTEM/cmd_tlm/limits_groups.txt.
+    # Note that there is a LIMITS_GROUP INST2_TEMP2 so we have a match.
+    def check_inst2_temp2
+      # Inside this method you must call process_group. The first parameter is
+      # the number of seconds to delay before enabling the group when the telemetry
+      # check is true. When the telemetry check is false the group is instantly
+      # disabled. The next two parameters are Proc objects which are called with
+      # the group is enabled and disabled respectively. We defined our Proc objects
+      # in the constructor to enable and disable the GROUND group.
+      process_group(0, @temp2_enable_code, @temp2_disable_code) do
+        val = tlm("INST2 HEALTH_STATUS TEMP2")
+        # The expression returns TRUE (to enable the group) when the value is
+        # not NAN  and not Infinite. If the value is NAN or Infinite the group
+        # is disabled. Note that this can't prevent false positives because the
+        # value has to change to something invalid before we can turn off the group
+        # at which point it is too late. Typically you enable or disable a group
+        # based on some external telemetry point such as a power supply output
+        # to enable a group of items powered by the supply.
+        !val.nan? && !val.infinite?
+      end
+    end
+  end
+end

data/targets/SYSTEM/lib/scpi_target.rb

@@ -0,0 +1,76 @@
+# encoding: ascii-8bit
+
+# Copyright 2022 Ball Aerospace & Technologies Corp.
+# 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 program may also be used under the terms of a commercial or
+# enterprise edition license of COSMOS if purchased from the
+# copyright holder
+
+require 'cosmos'
+require 'cosmos/interfaces'
+require 'cosmos/tools/cmd_tlm_server/interface_thread'
+
+module Cosmos
+  class ScpiTarget
+    class ScpiServerInterface < TcpipServerInterface
+      PORT = 5025
+
+      def initialize
+        super(PORT, PORT, 5.0, nil, 'TERMINATED', '0xA', '0xA')
+      end
+    end
+
+    class ScpiInterfaceThread < InterfaceThread
+      def initialize(interface)
+        super(interface)
+        @index = 0
+      end
+
+      protected
+      def handle_packet(packet)
+        Logger.info "Received command: #{packet.buffer}"
+        if packet.buffer.include?('?')
+          @interface.write_raw(@index.to_s + "\x0A")
+        end
+        @index += 1
+      end
+    end
+
+    def initialize
+      # Create interface to receive commands and send telemetry
+      @target_interface = ScpiServerInterface.new
+      @interface_thread = nil
+    end
+
+    def start
+      @interface_thread = ScpiInterfaceThread.new(@target_interface)
+      @interface_thread.start
+    end
+
+    def stop
+      @interface_thread.stop if @interface_thread
+    end
+
+    def self.run
+      Logger.level = Logger::INFO
+      target = self.new
+      begin
+        target.start
+        loop { sleep 1 }
+      rescue SystemExit, Interrupt
+        target.stop
+      end
+    end
+  end
+end

data/targets/SYSTEM/procedures/cosmos_api_test.rb

@@ -0,0 +1,286 @@
+# cmd
+cmd("INST ABORT")
+cmd("INST ARYCMD with ARRAY []")
+cmd("INST CLEAR")
+cmd("INST COLLECT with DURATION 1.0, TEMP 0.0, TYPE 'NORMAL'")
+cmd("INST FLTCMD with FLOAT32 0.0, FLOAT64 0.0")
+cmd("INST SETPARAMS with VALUE1 0, VALUE2 0, VALUE3 0, VALUE4 0, VALUE5 0")
+cmd("INST SLRPNLDEPLOY")
+cmd("INST SLRPNLRESET")
+cmd("INST ASCIICMD with STRING 'ARM LASER'")
+
+cmd("INST", "ABORT")
+cmd("INST", "ARYCMD", "ARRAY" => [])
+cmd("INST", "CLEAR")
+cmd("INST", "COLLECT", "DURATION" => 1.0, "TEMP" => 0.0, "TYPE" => 'NORMAL')
+cmd("INST", "FLTCMD", "FLOAT32" => 0.0, "FLOAT64" => 0.0)
+cmd("INST", "SETPARAMS", "VALUE1" => 0, "VALUE2" => 0, "VALUE3" => 0, "VALUE4" => 0, "VALUE5" => 0)
+cmd("INST", "SLRPNLDEPLOY")
+cmd("INST", "SLRPNLRESET")
+cmd("INST", "ASCIICMD", "STRING" => 'ARM LASER')
+
+# cmd should fail
+begin
+  cmd("INST COLLECT with DURATION 11, TYPE 'NORMAL'")
+rescue RuntimeError => e
+  raise "Fail" if e.message != "Command parameter 'INST COLLECT DURATION' = 11 not in valid range of 0.0 to 10.0"
+rescue
+  raise "Fail"
+end
+
+cmd()
+cmd("BOB")
+cmd("BOB", "ABORT")
+cmd("INST", "BOB")
+cmd("INST", "ABORT", "BOB" => "BOB")
+cmd("INST", "ABORT", "TED", "BOB" => "BOB")
+cmd("BOB")
+cmd("BOB ABORT")
+cmd("INST BOB")
+
+# cmd_no_range_check
+cmd_no_range_check("INST ABORT")
+cmd_no_range_check("INST ARYCMD with ARRAY []")
+cmd_no_range_check("INST CLEAR")
+cmd_no_range_check("INST COLLECT with DURATION 1.0, TEMP 0.0, TYPE 'NORMAL'")
+cmd_no_range_check("INST FLTCMD with FLOAT32 0.0, FLOAT64 0.0")
+cmd_no_range_check("INST SETPARAMS with VALUE1 0, VALUE2 0, VALUE3 0, VALUE4 0, VALUE5 0")
+cmd_no_range_check("INST SLRPNLDEPLOY")
+cmd_no_range_check("INST SLRPNLRESET")
+cmd_no_range_check("INST ASCIICMD with STRING 'ARM LASER'")
+cmd_no_range_check("INST COLLECT with DURATION 11, TYPE 'NORMAL'")
+
+cmd_no_range_check("INST", "ABORT")
+cmd_no_range_check("INST", "ARYCMD", "ARRAY" => [])
+cmd_no_range_check("INST", "CLEAR")
+cmd_no_range_check("INST", "COLLECT", "DURATION" => 1.0, "TEMP" => 0.0, "TYPE" => 'NORMAL')
+cmd_no_range_check("INST", "FLTCMD", "FLOAT32" => 0.0, "FLOAT64" => 0.0)
+cmd_no_range_check("INST", "SETPARAMS", "VALUE1" => 0, "VALUE2" => 0, "VALUE3" => 0, "VALUE4" => 0, "VALUE5" => 0)
+cmd_no_range_check("INST", "SLRPNLDEPLOY")
+cmd_no_range_check("INST", "SLRPNLRESET")
+cmd_no_range_check("INST", "ASCIICMD", "STRING" => 'ARM LASER')
+cmd_no_range_check("INST", "COLLECT", "DURATION" => 11, "TYPE" => 'NORMAL')
+
+# cmd_no_range_check should fail
+cmd_no_range_check()
+cmd_no_range_check("BOB")
+cmd_no_range_check("BOB", "ABORT")
+cmd_no_range_check("INST", "BOB")
+cmd_no_range_check("INST", "ABORT", "BOB" => "BOB")
+cmd_no_range_check("INST", "ABORT", "TED", "BOB" => "BOB")
+cmd_no_range_check("BOB")
+cmd_no_range_check("BOB ABORT")
+cmd_no_range_check("INST BOB")
+
+# cmd_no_hazardous_check
+cmd_no_hazardous_check("INST ABORT")
+cmd_no_hazardous_check("INST ARYCMD with ARRAY []")
+cmd_no_hazardous_check("INST CLEAR")
+cmd_no_hazardous_check("INST COLLECT with DURATION 1.0, TEMP 0.0, TYPE 'NORMAL'")
+cmd_no_hazardous_check("INST FLTCMD with FLOAT32 0.0, FLOAT64 0.0")
+cmd_no_hazardous_check("INST SETPARAMS with VALUE1 0, VALUE2 0, VALUE3 0, VALUE4 0, VALUE5 0")
+cmd_no_hazardous_check("INST SLRPNLDEPLOY")
+cmd_no_hazardous_check("INST SLRPNLRESET")
+cmd_no_hazardous_check("INST ASCIICMD with STRING 'ARM LASER'")
+
+cmd_no_hazardous_check("INST", "ABORT")
+cmd_no_hazardous_check("INST", "ARYCMD", "ARRAY" => [])
+cmd_no_hazardous_check("INST", "CLEAR")
+cmd_no_hazardous_check("INST", "COLLECT", "DURATION" => 1.0, "TEMP" => 0.0, "TYPE" => 'NORMAL')
+cmd_no_hazardous_check("INST", "FLTCMD", "FLOAT32" => 0.0, "FLOAT64" => 0.0)
+cmd_no_hazardous_check("INST", "SETPARAMS", "VALUE1" => 0, "VALUE2" => 0, "VALUE3" => 0, "VALUE4" => 0, "VALUE5" => 0)
+cmd_no_hazardous_check("INST", "SLRPNLDEPLOY")
+cmd_no_hazardous_check("INST", "SLRPNLRESET")
+cmd_no_hazardous_check("INST", "ASCIICMD", "STRING" => 'ARM LASER')
+
+# cmd_no_hazardous_check should fail
+cmd_no_hazardous_check("INST COLLECT with DURATION 11, TYPE 'NORMAL'")
+cmd_no_hazardous_check()
+cmd_no_hazardous_check("BOB")
+cmd_no_hazardous_check("BOB", "ABORT")
+cmd_no_hazardous_check("INST", "BOB")
+cmd_no_hazardous_check("INST", "ABORT", "BOB" => "BOB")
+cmd_no_hazardous_check("INST", "ABORT", "TED", "BOB" => "BOB")
+cmd_no_hazardous_check("BOB")
+cmd_no_hazardous_check("BOB ABORT")
+cmd_no_hazardous_check("INST BOB")
+
+# cmd_no_checks
+cmd_no_checks("INST ABORT")
+cmd_no_checks("INST ARYCMD with ARRAY []")
+cmd_no_checks("INST CLEAR")
+cmd_no_checks("INST COLLECT with DURATION 1.0, TEMP 0.0, TYPE 'NORMAL'")
+cmd_no_checks("INST FLTCMD with FLOAT32 0.0, FLOAT64 0.0")
+cmd_no_checks("INST SETPARAMS with VALUE1 0, VALUE2 0, VALUE3 0, VALUE4 0, VALUE5 0")
+cmd_no_checks("INST SLRPNLDEPLOY")
+cmd_no_checks("INST SLRPNLRESET")
+cmd_no_checks("INST ASCIICMD with STRING 'ARM LASER'")
+cmd_no_checks("INST COLLECT with DURATION 11, TYPE 'NORMAL'")
+
+cmd_no_checks("INST", "ABORT")
+cmd_no_checks("INST", "ARYCMD", "ARRAY" => [])
+cmd_no_checks("INST", "CLEAR")
+cmd_no_checks("INST", "COLLECT", "DURATION" => 1.0, "TEMP" => 0.0, "TYPE" => 'NORMAL')
+cmd_no_checks("INST", "FLTCMD", "FLOAT32" => 0.0, "FLOAT64" => 0.0)
+cmd_no_checks("INST", "SETPARAMS", "VALUE1" => 0, "VALUE2" => 0, "VALUE3" => 0, "VALUE4" => 0, "VALUE5" => 0)
+cmd_no_checks("INST", "SLRPNLDEPLOY")
+cmd_no_checks("INST", "SLRPNLRESET")
+cmd_no_checks("INST", "ASCIICMD", "STRING" => 'ARM LASER')
+cmd_no_checks("INST", "COLLECT", "DURATION" => 11, "TYPE" => 'NORMAL')
+
+# cmd_no_checks should fail
+cmd_no_checks()
+cmd_no_checks("BOB")
+cmd_no_checks("BOB", "ABORT")
+cmd_no_checks("INST", "BOB")
+cmd_no_checks("INST", "ABORT", "BOB" => "BOB")
+cmd_no_checks("INST", "ABORT", "TED", "BOB" => "BOB")
+cmd_no_checks("BOB")
+cmd_no_checks("BOB ABORT")
+cmd_no_checks("INST BOB")
+
+# send_raw should fail (on demo cmd/tlm server)
+send_raw()
+send_raw("INT1")
+send_raw("INT1", "\x00\x00")
+send_raw("INT1", "\x00\x00", "\x00\x00")
+
+# get_all_commands
+expected_cmds = %w(ABORT ARYCMD ASCIICMD CLEAR COLLECT FLTCMD SETPARAMS SLRPNLDEPLOY SLRPNLRESET)
+commands = get_all_commands("INST")
+puts commands.inspect
+
+# get_all_commands should fail
+get_all_commands()
+get_all_commands("BOB")
+get_all_commands("BOB", "TED")
+
+# get_cmd_hazardous
+hazardous = get_cmd_hazardous("INST", "COLLECT", "TYPE" => "SPECIAL")
+puts hazardous
+hazardous = get_cmd_hazardous("INST", "COLLECT", "TYPE" => "NORMAL")
+puts hazardous
+hazardous = get_cmd_hazardous("INST", "ABORT")
+puts hazardous
+hazardous = get_cmd_hazardous("INST", "CLEAR")
+puts hazardous
+
+# get_cmd_hazardous should fail
+get_cmd_hazardous()
+get_cmd_hazardous("INST")
+get_cmd_hazardous("INST", "COLLECT", "BOB" => 5)
+get_cmd_hazardous("INST", "COLLECT", 5)
+
+# tlm
+tlm("INST HEALTH_STATUS ARY")
+tlm("INST HEALTH_STATUS ASCIICMD")
+tlm("INST HEALTH_STATUS CCSDSAPID")
+tlm("INST HEALTH_STATUS TEMP1")
+
+tlm("INST", "HEALTH_STATUS", "ARY")
+tlm("INST", "HEALTH_STATUS", "ASCIICMD")
+tlm("INST", "HEALTH_STATUS", "CCSDSAPID")
+tlm("INST", "HEALTH_STATUS", "TEMP1")
+
+# tlm should fail
+tlm()
+tlm("BOB")
+tlm("INST")
+tlm("INST BOB")
+tlm("INST HEALTH_STATUS")
+tlm("INST HEALTH_STATUS BOB")
+tlm("INST HEALTH_STATUS ARY BOB")
+tlm("INST", "BOB")
+tlm("INST", "HEALTH_STATUS")
+tlm("INST", "HEALTH_STATUS", "BOB")
+tlm("INST", "HEALTH_STATUS", "ARY", "BOB")
+
+# tlm_raw
+tlm_raw("INST HEALTH_STATUS ARY")
+tlm_raw("INST HEALTH_STATUS ASCIICMD")
+tlm_raw("INST HEALTH_STATUS CCSDSAPID")
+tlm_raw("INST HEALTH_STATUS TEMP1")
+
+tlm_raw("INST", "HEALTH_STATUS", "ARY")
+tlm_raw("INST", "HEALTH_STATUS", "ASCIICMD")
+tlm_raw("INST", "HEALTH_STATUS", "CCSDSAPID")
+tlm_raw("INST", "HEALTH_STATUS", "TEMP1")
+
+# tlm_raw should fail
+tlm_raw()
+tlm_raw("BOB")
+tlm_raw("INST")
+tlm_raw("INST BOB")
+tlm_raw("INST HEALTH_STATUS")
+tlm_raw("INST HEALTH_STATUS BOB")
+tlm_raw("INST HEALTH_STATUS ARY BOB")
+tlm_raw("INST", "BOB")
+tlm_raw("INST", "HEALTH_STATUS")
+tlm_raw("INST", "HEALTH_STATUS", "BOB")
+tlm_raw("INST", "HEALTH_STATUS", "ARY", "BOB")
+
+# tlm_formatted
+tlm_formatted("INST HEALTH_STATUS ARY")
+tlm_formatted("INST HEALTH_STATUS ASCIICMD")
+tlm_formatted("INST HEALTH_STATUS CCSDSAPID")
+tlm_formatted("INST HEALTH_STATUS TEMP1")
+
+tlm_formatted("INST", "HEALTH_STATUS", "ARY")
+tlm_formatted("INST", "HEALTH_STATUS", "ASCIICMD")
+tlm_formatted("INST", "HEALTH_STATUS", "CCSDSAPID")
+tlm_formatted("INST", "HEALTH_STATUS", "TEMP1")
+
+# tlm_formatted should fail
+tlm_formatted()
+tlm_formatted("BOB")
+tlm_formatted("INST")
+tlm_formatted("INST BOB")
+tlm_formatted("INST HEALTH_STATUS")
+tlm_formatted("INST HEALTH_STATUS BOB")
+tlm_formatted("INST HEALTH_STATUS ARY BOB")
+tlm_formatted("INST", "BOB")
+tlm_formatted("INST", "HEALTH_STATUS")
+tlm_formatted("INST", "HEALTH_STATUS", "BOB")
+tlm_formatted("INST", "HEALTH_STATUS", "ARY", "BOB")
+
+# tlm_with_units
+tlm_with_units("INST HEALTH_STATUS ARY")
+tlm_with_units("INST HEALTH_STATUS ASCIICMD")
+tlm_with_units("INST HEALTH_STATUS CCSDSAPID")
+tlm_with_units("INST HEALTH_STATUS TEMP1")
+
+tlm_with_units("INST", "HEALTH_STATUS", "ARY")
+tlm_with_units("INST", "HEALTH_STATUS", "ASCIICMD")
+tlm_with_units("INST", "HEALTH_STATUS", "CCSDSAPID")
+tlm_with_units("INST", "HEALTH_STATUS", "TEMP1")
+
+# tlm_with_units should fail
+tlm_with_units()
+tlm_with_units("BOB")
+tlm_with_units("INST")
+tlm_with_units("INST BOB")
+tlm_with_units("INST HEALTH_STATUS")
+tlm_with_units("INST HEALTH_STATUS BOB")
+tlm_with_units("INST HEALTH_STATUS ARY BOB")
+tlm_with_units("INST", "BOB")
+tlm_with_units("INST", "HEALTH_STATUS")
+tlm_with_units("INST", "HEALTH_STATUS", "BOB")
+tlm_with_units("INST", "HEALTH_STATUS", "ARY", "BOB")
+
+# override_tlm
+override_tlm("INST HEALTH_STATUS ARY = [0,0,0,0,0,0,0,0,0,0]")
+override_tlm("INST HEALTH_STATUS ASCIICMD = 'HI'")
+override_tlm("INST HEALTH_STATUS CCSDSAPID = 1000")
+override_tlm("INST HEALTH_STATUS TEMP1 = 15")
+
+# override_tlm_raw
+override_tlm_raw("INST HEALTH_STATUS ARY = [0,0,0,0,0,0,0,0,0,0]")
+override_tlm_raw("INST HEALTH_STATUS ASCIICMD = 'HI'")
+override_tlm_raw("INST HEALTH_STATUS CCSDSAPID = 1000")
+override_tlm_raw("INST HEALTH_STATUS TEMP1 = 10000")
+
+# normalize_tlm
+normalize_tlm("INST HEALTH_STATUS ARY")
+normalize_tlm("INST HEALTH_STATUS ASCIICMD")
+normalize_tlm("INST HEALTH_STATUS CCSDSAPID")
+normalize_tlm("INST HEALTH_STATUS TEMP1")