cosmosc2-demo 5.0.2.pre.beta2

data/README.md

@@ -0,0 +1,31 @@
+## COSMOS Demo Plugin
+
+[Documentation](http://cosmosc2.com)
+
+This plugin provides a simple demo configuration for COSMOS that shows off a lot of the features of COSMOS and provides a test environment.
+
+## Getting Started
+
+1.  At the COSMOS Admin - Plugins, upload the cosmosc2-demo.gem file
+
+2. To build widgets run: yard && yard install
+
+## Contributing
+
+We encourage you to contribute to COSMOS!
+
+Contributing is easy.
+
+1. Fork the project
+2. Create a feature branch
+3. Make your changes
+4. Submit a pull request
+
+Before any contributions can be incorporated we do require all contributors to sign a Contributor License Agreement here:
+[Contributor License Agreement](https://docs.google.com/forms/d/1ppnHUSXtY1GRTNPIyUaB1OYHbW5Ca67GFMgMRPBG8u0/viewform)
+
+This protects both you and us and you retain full rights to any code you write.
+
+## License
+
+This Ball Aerospace plugin is released under the AGPLv3.0 with a few addendums. See [LICENSE.txt](LICENSE.txt)

data/Rakefile

@@ -0,0 +1,35 @@
+# 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
+
+PLUGIN_NAME = Dir['*.gemspec'][0].split('.')[0..-2].join('.')
+
+task :require_version do
+  unless ENV['VERSION']
+    puts "VERSION is required: rake <task> VERSION=X.X.X"
+    exit 1
+  end
+end
+
+task :build => [:require_version] do
+  _, platform, *_ = RUBY_PLATFORM.split("-")
+  if platform == 'mswin32' or platform == 'mingw32'
+    puts "Warning: Building gem on Windows will lose file permissions"
+  end
+  system("gem build #{PLUGIN_NAME}")
+end

data/microservices/EXAMPLE/example_target.rb

@@ -0,0 +1,123 @@
+# 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
+      def initialize(port)
+        super(port.to_i, port.to_i, 5.0, nil, 'LENGTH', 0, 32, 4, 1, 'BIG_ENDIAN', 4, nil, nil, true)
+      end
+    end
+
+    class ExampleInterfaceThread < InterfaceThread
+      attr_accessor :target_name
+
+      protected
+      def handle_packet(packet)
+        identified_packet = System.commands.identify(packet.buffer, [@target_name])
+        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, target_name)
+        @interface = interface
+        @target_name = target_name
+        @sleeper = Sleeper.new
+      end
+
+      def start
+        packet = System.telemetry.packet(@target_name, 'STATUS')
+        @thread = Thread.new do
+          @stop_thread = false
+          @sleeper.sleep(5)
+          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}"
+            raise err
+          end
+        end
+      end
+
+      def stop
+        Cosmos.kill_thread(self, @thread)
+      end
+
+      def graceful_kill
+        @sleeper.cancel
+      end
+    end
+
+    def initialize(target_name, port)
+      # Create interface to receive commands and send telemetry
+      @target_name = target_name
+      @interface = ExampleServerInterface.new(port)
+      @interface_thread = nil
+      @telemetry_thread = nil
+    end
+
+    def start
+      @interface_thread = ExampleInterfaceThread.new(@interface)
+      @interface_thread.target_name = @target_name
+      @interface_thread.start
+      @telemetry_thread = ExampleTelemetryThread.new(@interface, @target_name)
+      @telemetry_thread.start
+    end
+
+    def stop
+      @telemetry_thread.stop if @telemetry_thread
+      @interface_thread.stop if @interface_thread
+    end
+
+    def self.run(target_name, port)
+      Logger.level = Logger::INFO
+      Thread.abort_on_exception = true
+      temp_dir = Dir.mktmpdir
+      System.setup_targets([target_name], temp_dir, scope: ENV['COSMOS_SCOPE'])
+      target = self.new(target_name, port)
+      begin
+        target.start
+        while true
+          sleep 1
+        end
+      rescue SystemExit, Interrupt
+        target.stop
+        FileUtils.remove_entry(temp_dir) if File.exist?(temp_dir)
+      end
+    end
+  end
+end
+
+Cosmos::ExampleTarget.run(ARGV[0], ARGV[1]) if __FILE__ == $0

data/microservices/TEMPLATED/scpi_target.rb

@@ -0,0 +1,79 @@
+# 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
+      def initialize(port)
+        super(port.to_i, port.to_i, 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(port)
+      # Create interface to receive commands and send telemetry
+      @target_interface = ScpiServerInterface.new(port)
+      @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(target_name, port)
+      Logger.level = Logger::INFO
+      temp_dir = Dir.mktmpdir
+      System.setup_targets([target_name], temp_dir, scope: ENV['COSMOS_SCOPE'])
+      target = self.new(port)
+      begin
+        target.start
+        loop { sleep 1 }
+      rescue SystemExit, Interrupt
+        target.stop
+        FileUtils.remove_entry(temp_dir) if File.exist?(temp_dir)
+      end
+    end
+  end
+end
+
+Cosmos::ScpiTarget.run(ARGV[0], ARGV[1]) if __FILE__ == $0

data/plugin.txt

@@ -0,0 +1,100 @@
+# Note: This plugin includes 4 targets in one plugin to make it easy to install
+# the COSMOS demo with one plugin.  Generally it is better to only have one
+# target per plugin
+
+VARIABLE inst_target_name INST
+VARIABLE inst2_target_name INST2
+VARIABLE example_target_name EXAMPLE
+VARIABLE templated_target_name TEMPLATED
+VARIABLE system_target_name SYSTEM
+VARIABLE inst_int_name INST_INT
+VARIABLE inst_router_name INST_ROUTER
+VARIABLE inst2_int_name INST2_INT
+VARIABLE example_int_name EXAMPLE_INT
+VARIABLE templated_int_name TEMPLATED_INT
+VARIABLE demo_tool_name Demo
+VARIABLE example_microservice_name cosmos-example
+VARIABLE templated_microservice_name cosmos-templated
+VARIABLE example_port 9999
+VARIABLE templated_port 5025
+
+<% include_inst = (inst_target_name.strip.length > 0) %>
+<% include_inst2 = (inst2_target_name.strip.length > 0) %>
+<% include_example = (example_target_name.strip.length > 0) %>
+<% include_templated = (templated_target_name.strip.length > 0) %>
+<% include_system = (system_target_name.strip.length > 0) %>
+<% include_inst_int = (inst_int_name.strip.length > 0) %>
+<% include_inst_router = (inst_router_name.strip.length > 0) %>
+<% include_inst2_int = (inst2_int_name.strip.length > 0) %>
+<% include_example_int = (example_int_name.strip.length > 0) %>
+<% include_templated_int = (templated_int_name.strip.length > 0) %>
+<% include_example_microservice = (example_microservice_name.strip.length > 0) %>
+<% include_templated_microservice = (templated_microservice_name.strip.length > 0) %>
+
+<% if include_inst %>
+  TARGET INST <%= inst_target_name %>
+    TLM_LOG_CYCLE_TIME 300
+<% end %>
+
+<% if include_inst2 %>
+  TARGET INST <%= inst2_target_name %>
+    TLM_LOG_CYCLE_TIME 600
+<% end %>
+
+<% if include_example %>
+  TARGET EXAMPLE <%= example_target_name %>
+<% end %>
+
+<% if include_templated %>
+  TARGET TEMPLATED <%= templated_target_name %>
+<% end %>
+
+<% if include_system %>
+  TARGET SYSTEM <%= system_target_name %>
+<% end %>
+
+<% if include_inst and include_inst_int %>
+  INTERFACE <%= inst_int_name %> simulated_target_interface.rb sim_inst.rb
+    MAP_TARGET <%= inst_target_name %>
+    PROTOCOL READ OverrideProtocol
+<% end %>
+
+<% if include_inst2 and include_inst2_int %>
+  INTERFACE <%= inst2_int_name %> simulated_target_interface.rb sim_inst.rb
+    MAP_TARGET <%= inst2_target_name %>
+    DONT_LOG
+    PROTOCOL READ_WRITE OverrideProtocol
+<% end %>
+
+<% if include_example and include_example_int %>
+  INTERFACE <%= example_int_name %> example_interface.rb cosmos-operator <%= example_port %>
+    MAP_TARGET <%= example_target_name %>
+    DONT_CONNECT
+    LOG_RAW
+<% end %>
+
+<% if include_templated and include_templated_int %>
+  INTERFACE <%= templated_int_name %> templated_interface.rb cosmos-operator <%= templated_port %> <%= templated_port %> 5.0 nil TEMPLATE 0xA 0xA
+    MAP_TARGET <%= templated_target_name %>
+    DONT_CONNECT
+<% end %>
+
+<% if include_inst and include_inst_router %>
+  ROUTER <%= inst_router_name %> tcpip_server_interface.rb 7779 7779 nil 10.0 PREIDENTIFIED
+    MAP_TARGET <%= inst_target_name %>
+<% end %>
+
+<% if include_example_microservice %>
+  MICROSERVICE EXAMPLE <%= example_microservice_name %>
+    WORK_DIR .
+    CMD ruby example_target.rb <%= example_target_name %> <%= example_port %>
+<% end %>
+
+<% if include_templated_microservice %>
+  MICROSERVICE TEMPLATED <%= templated_microservice_name %>
+    WORK_DIR .
+    CMD ruby scpi_target.rb <%= templated_target_name %> <%= templated_port %>
+<% end %>
+
+WIDGET BIG
+WIDGET HELLOWORLD

data/targets/EXAMPLE/cmd_tlm/example_cmds.txt

@@ -0,0 +1,2 @@
+COMMAND <%= target_name %> START BIG_ENDIAN "Starts something on the example target"
+  APPEND_ID_PARAMETER PACKET_ID 8 UINT 1 1 1 "Packet id"

data/targets/EXAMPLE/cmd_tlm/example_tlm.txt

@@ -0,0 +1,5 @@
+TELEMETRY <%= target_name %> STATUS BIG_ENDIAN "Health and status from the instrument"
+  APPEND_ID_ITEM PACKET_ID 8 UINT 1 "Packet id"
+  APPEND_ITEM VALUE 32 UINT "Limits value"
+    LIMITS DEFAULT 1 ENABLED 0 1 10 11
+  APPEND_ITEM STRING 0 STRING "Time string"

data/targets/EXAMPLE/lib/example_interface.rb

@@ -0,0 +1,27 @@
+# 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/tcpip_client_interface'
+
+class ExampleInterface < Cosmos::TcpipClientInterface
+  def initialize (hostname, port, write_timeout = 10.0, read_timeout = nil)
+    super(hostname, port, port, write_timeout, read_timeout, 'LENGTH', 0, 32, 4, 1, 'BIG_ENDIAN', 4, nil, nil, true)
+  end
+end

data/targets/EXAMPLE/target.txt

@@ -0,0 +1,9 @@
+REQUIRE example_interface.rb
+
+# Ignored Parameters
+# IGNORE_PARAMETER parameter_name
+IGNORE_PARAMETER PACKET_ID
+
+IGNORE_ITEM RECEIVED_COUNT
+IGNORE_ITEM RECEIVED_TIMESECONDS
+IGNORE_ITEM RECEIVED_TIMEFORMATTED

data/targets/INST/cmd_tlm/_ccsds_cmd.txt

@@ -0,0 +1,9 @@
+  PARAMETER    CCSDSVER        0   3  UINT  0     0   0 "CCSDS primary header version number"
+  PARAMETER    CCSDSTYPE       3   1  UINT  1     1   1 "CCSDS primary header packet type"
+  PARAMETER    CCSDSSHF        4   1  UINT  0     0   0 "CCSDS primary header secondary header flag"
+  ID_PARAMETER CCSDSAPID       5  11  UINT  0  2047 999 "CCSDS primary header application id"
+  PARAMETER    CCSDSSEQFLAGS  16   2  UINT  3     3   3 "CCSDS primary header sequence flags"
+  PARAMETER    CCSDSSEQCNT    18  14  UINT  0 16383   0 "CCSDS primary header sequence count"
+    OVERFLOW TRUNCATE
+  PARAMETER    CCSDSLENGTH    32  16  UINT MIN MAX 12 "CCSDS primary header packet length"
+  ID_PARAMETER PKTID          48  16  UINT MIN MAX <%= id %> "Packet id"

data/targets/INST/cmd_tlm/_ccsds_tlm.txt

@@ -0,0 +1,19 @@
+  APPEND_ITEM CCSDSVER      3 UINT   "CCSDS packet version number (See CCSDS 133.0-B-1)"
+  APPEND_ITEM CCSDSTYPE     1 UINT   "CCSDS packet type (command or telemetry)"
+    STATE TLM 0
+    STATE CMD 1
+  APPEND_ITEM CCSDSSHF      1 UINT   "CCSDS secondary header flag"
+    STATE FALSE 0
+    STATE TRUE 1
+  APPEND_ID_ITEM CCSDSAPID 11 UINT <%= apid %> "CCSDS application process id"
+  APPEND_ITEM CCSDSSEQFLAGS 2 UINT   "CCSDS sequence flags"
+    STATE FIRST 1
+    STATE CONT 0
+    STATE LAST 2
+    STATE NOGROUP 3
+  APPEND_ITEM CCSDSSEQCNT  14 UINT   "CCSDS packet sequence count"
+    OVERFLOW TRUNCATE
+  APPEND_ITEM CCSDSLENGTH  16 UINT   "CCSDS packet data length"
+  APPEND_ITEM TIMESEC      32 UINT   "Seconds since epoch (January 1st, 1970, midnight)"
+  APPEND_ITEM TIMEUS       32 UINT   "Microseconds of second"
+  APPEND_ID_ITEM PKTID     16 UINT 1 "Packet id (The combination of CCSDS_APID and PACKET_ID identify the packet)"

data/targets/INST/cmd_tlm/inst_cmds.txt

@@ -0,0 +1,53 @@
+COMMAND <%= target_name %> COLLECT BIG_ENDIAN "Starts a collect on the <%= target_name %> target"
+  <%= render "_ccsds_cmd.txt", locals: {id: 1} %>
+  PARAMETER    TYPE           64  16  UINT MIN MAX 0 "Collect type"
+    REQUIRED
+    STATE NORMAL  0
+    STATE SPECIAL 1 HAZARDOUS
+  PARAMETER    DURATION       80  32  FLOAT 0.0 10.0 1.0 "Collect duration"
+  PARAMETER    OPCODE        112   8  UINT 0x0 0xFF 0xAB "Collect opcode"
+    FORMAT_STRING "0x%0X"
+  PARAMETER    TEMP          120  32  FLOAT 0.0 25.0 0.0 "Collect temperature"
+    UNITS Celsius C
+
+COMMAND <%= target_name %> ABORT BIG_ENDIAN "Aborts a collect on the <%= target_name %> instrument"
+  <%= render "_ccsds_cmd.txt", locals: {id: 2} %>
+
+COMMAND <%= target_name %> CLEAR BIG_ENDIAN "Clears counters on the <%= target_name %> instrument"
+  HAZARDOUS "Clearing counters may lose valuable information."
+  <%= render "_ccsds_cmd.txt", locals: {id: 3} %>
+
+COMMAND <%= target_name %> SETPARAMS BIG_ENDIAN "Sets numbered parameters"
+  <%= render "_ccsds_cmd.txt", locals: {id: 4} %>
+  # ERB syntax:
+  <% (1..5).each do |i| %>
+    APPEND_PARAMETER VALUE<%= i %> 16 UINT 0 5 1 "Value <%= i %> setting"
+  <% end %>
+
+  SELECT_PARAMETER VALUE5
+    POLY_WRITE_CONVERSION 0 2
+
+COMMAND <%= target_name %> ASCIICMD BIG_ENDIAN "Enumerated ASCII command"
+  <%= render "_ccsds_cmd.txt", locals: {id: 5} %>
+  APPEND_PARAMETER STRING 2048 STRING "NOOP" "Enumerated string parameter"
+    STATE "NOOP" "NOOP"
+    STATE "ARM LASER" "ARM LASER" HAZARDOUS "Arming the laser poses an eye safety hazard."
+    STATE "FIRE LASER" "FIRE LASER" HAZARDOUS "WARNING Laser will be fired!"
+  APPEND_PARAMETER BINARY 32 STRING 0xDEADBEEF "Binary string"
+  APPEND_PARAMETER ASCII 80 STRING "0xDEADBEEF" "ASCII string"
+
+COMMAND <%= target_name %> FLTCMD BIG_ENDIAN "Command with float parameters"
+  <%= render "_ccsds_cmd.txt", locals: {id: 6} %>
+  PARAMETER    FLOAT32        64  32  FLOAT MIN MAX 0.0 "Float32 parameter"
+  PARAMETER    FLOAT64        96  64  FLOAT MIN MAX 0.0 "Float64 parameter"
+
+COMMAND <%= target_name %> ARYCMD BIG_ENDIAN "Command with array parameter"
+  <%= render "_ccsds_cmd.txt", locals: {id: 7} %>
+  ARRAY_PARAMETER ARRAY       64  32  UINT -8 "Array parameter"
+  PARAMETER    CRC            -8   8  UINT MIN MAX 0 "CRC"
+
+COMMAND <%= target_name %> SLRPNLDEPLOY BIG_ENDIAN "Deploy solar array panels"
+  <%= render "_ccsds_cmd.txt", locals: {id: 8} %>
+
+COMMAND <%= target_name %> SLRPNLRESET BIG_ENDIAN "Reset solar array panels"
+  <%= render "_ccsds_cmd.txt", locals: {id: 9} %>

data/targets/INST/cmd_tlm/inst_tlm.txt

@@ -0,0 +1,162 @@
+TELEMETRY <%= target_name %> HEALTH_STATUS BIG_ENDIAN "Health and status from the <%= target_name %> target"
+  <%= render "_ccsds_tlm.txt", locals: {apid: 1} %>
+  APPEND_ITEM COLLECTS         16 UINT     "Number of collects"
+  APPEND_ITEM TEMP1            16 UINT     "Temperature #1"
+    POLY_READ_CONVERSION  -100.0 0.00305
+    POLY_WRITE_CONVERSION 32768.885246 327.86885
+    UNITS CELSIUS C
+    FORMAT_STRING "%0.3f"
+    LIMITS DEFAULT 1 ENABLED -80.0 -70.0 60.0 80.0 -20.0 20.0
+    LIMITS TVAC 1 ENABLED -80.0 -30.0 30.0 80.0
+    LIMITS_RESPONSE example_limits_response.rb
+  APPEND_ITEM TEMP2            32 FLOAT    "Temperature #2"
+    POLY_READ_CONVERSION -100.0 0.00305
+    POLY_WRITE_CONVERSION 32768.885246 327.86885
+    UNITS CELSIUS C
+    FORMAT_STRING "%0.3f"
+    LIMITS DEFAULT 1 ENABLED -60.0 -55.0 30.0 35.0
+    LIMITS TVAC 1 ENABLED -60.0 20.0 30.0 35.0
+  APPEND_ITEM TEMP3            16 UINT     "Temperature #3"
+    POLY_READ_CONVERSION -100.0 0.00305
+    POLY_WRITE_CONVERSION 32768.885246 327.86885
+    UNITS CELSIUS C
+    FORMAT_STRING "%0.3f"
+    LIMITS DEFAULT 1 ENABLED -25.0 -10.0 50.0 55.0
+    LIMITS TVAC 1 ENABLED -15.0 -10.0 20.0 30.0
+  APPEND_ITEM TEMP4            16 UINT     "Temperature #4"
+    POLY_READ_CONVERSION -100.0 0.00305
+    POLY_WRITE_CONVERSION 32768.885246 327.86885
+    UNITS CELSIUS C
+    FORMAT_STRING "%0.3f"
+    LIMITS DEFAULT 1 ENABLED -80.0 -70.0 60.0 80.0
+  APPEND_ARRAY_ITEM ARY         8 UINT 80 "Array data"
+    UNITS VOLTS V
+  APPEND_ITEM DURATION 32 FLOAT "Most recent collect duration"
+  APPEND_ITEM COLLECT_TYPE 16 UINT "Most recent collect type"
+    STATE NORMAL  0
+    STATE SPECIAL 1
+    STATE ERROR ANY
+  APPEND_ARRAY_ITEM ARY2       64 FLOAT 640 "Double array"
+    UNITS CELSIUS C
+  APPEND_ITEM ASCIICMD 2048 STRING "Most recent ASCIICMD string"
+    STATE "NOOP" "NOOP"
+    STATE "FIRE LASER" "FIRE LASER"
+    STATE "ARM LASER" "ARM LASER"
+  APPEND_ITEM GROUND1STATUS 8 UINT "Ground station #1 status"
+    STATE CONNECTED 1 GREEN
+    STATE UNAVAILABLE 0 YELLOW
+  APPEND_ITEM GROUND2STATUS 8 UINT "Ground station #2 status"
+    STATE CONNECTED 1 GREEN
+    STATE UNAVAILABLE 0 YELLOW
+  APPEND_ITEM BLOCKTEST 80 BLOCK "Block data"
+  ITEM TIMESECONDS 0 0 DERIVED "Derived floating-point time since epoch in seconds"
+    READ_CONVERSION unix_time_seconds_conversion.rb TIMESEC TIMEUS
+    FORMAT_STRING '%0.6f'
+  ITEM TIMEFORMATTED 0 0 DERIVED "Derived time since epoch as formatted string"
+    READ_CONVERSION unix_time_formatted_conversion.rb TIMESEC TIMEUS
+  ITEM TEMP1HIGH 0 0 DERIVED "High-water mark for TEMP1"
+    READ_CONVERSION processor_conversion.rb TEMP1WATER HIGH_WATER
+  ITEM TEMP1LOW 0 0 DERIVED "Low-water mark for TEMP1"
+    READ_CONVERSION processor_conversion.rb TEMP1WATER LOW_WATER
+  ITEM TEMP1MAX 0 0 DERIVED "Maximum of most recent 100 samples for TEMP1"
+    READ_CONVERSION processor_conversion.rb TEMP1STAT MAX
+  ITEM TEMP1MIN 0 0 DERIVED "Minimum of most recent 100 samples for TEMP1"
+    READ_CONVERSION processor_conversion.rb TEMP1STAT MIN
+  ITEM TEMP1MEAN 0 0 DERIVED "Mean of most recent 100 samples for TEMP1"
+    READ_CONVERSION processor_conversion.rb TEMP1STAT MEAN
+  ITEM TEMP1STDDEV 0 0 DERIVED "Stddev of most recent 100 samples for TEMP1"
+    READ_CONVERSION processor_conversion.rb TEMP1STAT STDDEV
+  PROCESSOR TEMP1STAT statistics_processor.rb TEMP1 100
+  PROCESSOR TEMP1WATER watermark_processor.rb TEMP1
+
+TELEMETRY <%= target_name %> ADCS BIG_ENDIAN "Position and attitude data"
+  META TYPE 'struct adcs'
+  <%= render "_ccsds_tlm.txt", locals: {apid: 2} %>
+  ITEM POSX             128 32 FLOAT "Position X"
+    UNITS METERS M
+  ITEM POSY             160 32 FLOAT "Position Y"
+    UNITS METERS M
+  ITEM POSZ             192 32 FLOAT "Position Z"
+    UNITS METERS M
+  ITEM VELX             224 32 FLOAT "Velocity X"
+    UNITS METERS_PER_SECOND MPS
+  ITEM VELY             256 32 FLOAT "Velocity Y"
+    UNITS METERS_PER_SECOND MPS
+  ITEM VELZ             288 32 FLOAT "Velocity Z"
+    UNITS METERS_PER_SECOND MPS
+  ITEM Q1               320 32 FLOAT "Quaternion param 1"
+    FORMAT_STRING "%0.6f"
+    META TYPE 'float32'
+  ITEM Q2               352 32 FLOAT "Quaternion param 2"
+    FORMAT_STRING "%0.6f"
+    META TYPE 'float32'
+  ITEM Q3               384 32 FLOAT "Quaternion param 3"
+    FORMAT_STRING "%0.6f"
+    META TYPE 'float32'
+  ITEM Q4               416 32 FLOAT "Quaternion param 4"
+    FORMAT_STRING "%0.6f"
+    META TYPE 'float32'
+  ITEM BIASX            448 32 FLOAT "Body X rate bias"
+    FORMAT_STRING "%0.6f"
+  ITEM BIASY            480 32 FLOAT "Body Y rate bias"
+    FORMAT_STRING "%0.6f"
+  ITEM BIASZ            512 32 FLOAT "Body Z rate bias"
+    FORMAT_STRING "%0.6f"
+  <% (1..5).each do |i| %>
+    APPEND_ITEM STAR<%= i %>ID 16 UINT "Star <%= i %> id"
+  <% end %>
+  ITEM POSPROGRESS      624 32 FLOAT "Position file progress"
+    FORMAT_STRING "%0.2f"
+  ITEM ATTPROGRESS      656 32 FLOAT "Attitude file progress"
+    FORMAT_STRING "%0.2f"
+  ITEM TIMESECONDS 0 0 DERIVED "Derived floating-point time since epoch in seconds"
+    READ_CONVERSION unix_time_seconds_conversion.rb TIMESEC TIMEUS
+    FORMAT_STRING '%0.6f'
+  ITEM TIMEFORMATTED 0 0 DERIVED "Derived time since epoch as formatted string"
+    READ_CONVERSION unix_time_formatted_conversion.rb TIMESEC TIMEUS
+
+TELEMETRY <%= target_name %> PARAMS BIG_ENDIAN "Params set by SETPARAMS command"
+  <%= render "_ccsds_tlm.txt", locals: {apid: 3} %>
+  # ERB syntax:
+  <% (1..5).each do |i| %>
+    APPEND_ITEM VALUE<%= i %> 16 UINT "Value <%= i %> setting"
+      STATE GOOD 0 GREEN
+      STATE BAD 1 RED
+  <% end %>
+
+  ITEM TIMESECONDS 0 0 DERIVED "Derived floating-point time since epoch in seconds"
+    READ_CONVERSION unix_time_seconds_conversion.rb TIMESEC TIMEUS
+    FORMAT_STRING '%0.6f'
+  ITEM TIMEFORMATTED 0 0 DERIVED "Derived time since epoch as formatted string"
+    READ_CONVERSION unix_time_formatted_conversion.rb TIMESEC TIMEUS
+
+TELEMETRY <%= target_name %> IMAGE BIG_ENDIAN "Packet with image data"
+  <%= render "_ccsds_tlm.txt", locals: {apid: 4} %>
+  ITEM BYTES 128 32 UINT "First bytes"
+    FORMAT_STRING '0x%08x'
+  ITEM IMAGE 128 131072 BLOCK   "10x10 Image Data"
+    OVERLAP # Notify COSMOS that this is intentionally overlapping the BYTES field
+  ITEM TIMESECONDS 0 0 DERIVED "Derived floating-point time since epoch in seconds"
+    READ_CONVERSION unix_time_seconds_conversion.rb TIMESEC TIMEUS
+    FORMAT_STRING '%0.6f'
+  ITEM TIMEFORMATTED 0 0 DERIVED "Derived time since epoch as formatted string"
+    READ_CONVERSION unix_time_formatted_conversion.rb TIMESEC TIMEUS
+
+TELEMETRY <%= target_name %> MECH BIG_ENDIAN "Mechanism status"
+  <%= render "_ccsds_tlm.txt", locals: {apid: 5} %>
+  APPEND_ITEM EXTRA         32 FLOAT    "Extra item to be deleted"
+  APPEND_ITEM SLRPNL1       32 FLOAT    "Solar panel 1 angle"
+    UNITS DEGREES DEG
+  APPEND_ITEM SLRPNL2       32 FLOAT    "Solar panel 2 angle"
+    UNITS DEGREES DEG
+  APPEND_ITEM SLRPNL3       32 FLOAT    "Solar panel 3 angle"
+    UNITS DEGREES DEG
+  APPEND_ITEM SLRPNL4       32 FLOAT    "Solar panel 4 angle"
+    UNITS DEGREES DEG
+  APPEND_ITEM SLRPNL5       32 FLOAT    "Solar panel 5 angle"
+    UNITS DEGREES DEG
+  ITEM TIMESECONDS 0 0 DERIVED "Derived floating-point time since epoch in seconds"
+    READ_CONVERSION unix_time_seconds_conversion.rb TIMESEC TIMEUS
+    FORMAT_STRING '%0.6f'
+  ITEM TIMEFORMATTED 0 0 DERIVED "Derived time since epoch as formatted string"
+    READ_CONVERSION unix_time_formatted_conversion.rb TIMESEC TIMEUS

data/targets/INST/cmd_tlm/inst_tlm_override.txt

@@ -0,0 +1,12 @@
+# NOTE: Telemetry definitions are processed in alphabetical order by default.
+#   However, this can be overridden by explicitly calling them out in target.txt.
+#   Thus it's recommended to create a file like this with an extension
+#   such as inst_tlm_override.txt which will be processed AFTER inst_tlm.txt.
+
+# Existing telemetry packets can be selected and items modified
+SELECT_TELEMETRY <%= target_name %> MECH
+  # Existing items can be selected and modified by adding conversions, limits, etc
+  SELECT_ITEM SLRPNL1
+    LIMITS DEFAULT 1 ENABLED -180.0 -170.0 170.0 180.0
+  # Delete an item so it doesn't appear in the packet
+  DELETE_ITEM EXTRA