cosmos 3.5.1 → 3.5.2

data/lib/cosmos/packets/parsers/packet_parser.rb

@@ -1,123 +1,123 @@
-# encoding: ascii-8bit
-
-# Copyright 2014 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 General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-
-require 'cosmos/packets/packet'
-
-module Cosmos
-
-  class PacketParser
-    # @param parser [ConfigParser] Configuration parser
-    # @param target_name [String] The name of the target to create the packet
-    #   under. If the target name is 'SYSTEM' the keyword parameter will be
-    #   used instead of this parameter.
-    # @param commands [Hash] Hash of the currently defined commands
-    # @param warnings [Array<String>] Any warning strings generated while
-    #   parsing this command will be appened to this array
-    def self.parse_command(parser, target_name, commands, warnings)
-      parser = PacketParser.new(parser)
-      parser.verify_parameters()
-      parser.create_command(target_name, commands, warnings)
-    end
-
-    # @param parser [ConfigParser] Configuration parser
-    # @param target_name [String] The name of the target to create the packet
-    #   under. If the target name is 'SYSTEM' the keyword parameter will be
-    #   used instead of this parameter.
-    # @param telemetry [Hash] Hash of the currently defined telemetry packets
-    # @param latest_data [Hash<String=>Hash<String=>Array(Packet)>>] Hash of hashes keyed
-    #   first by the target name and then by the item name. This results in an
-    #   array of packets containing that target and item. This structure is
-    #   used to perform lookups when the packet and item are known but the
-    #   packet is not.
-    # @param warnings [Array<String>] Any warning strings generated while
-    #   parsing this command will be appened to this array
-    def self.parse_telemetry(parser, target_name, telemetry, latest_data, warnings)
-      parser = PacketParser.new(parser)
-      parser.verify_parameters()
-      parser.create_telemetry(target_name, telemetry, latest_data, warnings)
-    end
-
-    # @param packet [Packet] Packet to check all default and range items for
-    #   appropriate data types. Only applicable to COMMAND packets.
-    def self.check_item_data_types(packet)
-      packet.sorted_items.each do |item|
-        item.check_default_and_range_data_types()
-      end
-    rescue => err
-      # Add the target name and packet name to the error message so the user
-      # can debug where the error occurred
-      raise $!, "#{packet.target_name} #{packet.packet_name} #{$!}", $!.backtrace
-    end
-
-    # @param parser [ConfigParser] Configuration parser
-    def initialize(parser)
-      @parser = parser
-    end
-
-    def verify_parameters
-      @usage = "#{@parser.keyword} <TARGET NAME> <PACKET NAME> <ENDIANNESS: BIG_ENDIAN/LITTLE_ENDIAN> <DESCRIPTION (Optional)>"
-      @parser.verify_num_parameters(3, 4, @usage)
-    end
-
-    def create_command(target_name, commands, warnings)
-      packet = create_packet(target_name)
-      warning = check_for_duplicate('Command', commands, packet)
-      warnings << warning if warning
-      commands[packet.target_name] ||= {}
-      packet
-    end
-
-    def create_telemetry(target_name, telemetry, latest_data, warnings)
-      packet = create_packet(target_name)
-      warning = check_for_duplicate('Telemetry', telemetry, packet)
-      warnings << warning if warning
-
-      # Add received time packet items
-      item = packet.define_item('RECEIVED_TIMESECONDS', 0, 0, :DERIVED, nil, packet.default_endianness, :ERROR, '%0.6f', ReceivedTimeSecondsConversion.new)
-      item.description = 'COSMOS Received Time (UTC, Floating point, Unix epoch)'
-      item = packet.define_item('RECEIVED_TIMEFORMATTED', 0, 0, :DERIVED, nil, packet.default_endianness, :ERROR, nil, ReceivedTimeFormattedConversion.new)
-      item.description = 'COSMOS Received Time (Local time zone, Formatted string)'
-      item = packet.define_item('RECEIVED_COUNT', 0, 0, :DERIVED, nil, packet.default_endianness, :ERROR, nil, ReceivedCountConversion.new)
-      item.description = 'COSMOS packet received count'
-
-      unless telemetry[packet.target_name]
-        telemetry[packet.target_name] = {}
-        latest_data[packet.target_name] = {}
-      end
-      packet
-    end
-
-    private
-
-    def create_packet(target_name)
-      params = @parser.parameters
-      target_name = params[0].to_s.upcase if target_name == 'SYSTEM'
-      packet_name = params[1].to_s.upcase
-      endianness = params[2].to_s.upcase.to_sym
-      description = params[3].to_s
-      if endianness != :BIG_ENDIAN and endianness != :LITTLE_ENDIAN
-        raise @parser.error("Invalid endianness #{params[2]}. Must be BIG_ENDIAN or LITTLE_ENDIAN.", @usage)
-      end
-      Packet.new(target_name, packet_name, endianness, description)
-    end
-
-    def check_for_duplicate(type, list, packet)
-      msg = nil
-      if list[packet.target_name]
-        if list[packet.target_name][packet.packet_name]
-          msg = "#{type} Packet #{packet.target_name} #{packet.packet_name} redefined."
-          Logger.instance.warn msg
-        end
-      end
-      msg
-    end
-
-  end
-end # module Cosmos
+# encoding: ascii-8bit
+
+# Copyright 2014 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 General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+
+require 'cosmos/packets/packet'
+
+module Cosmos
+
+  class PacketParser
+    # @param parser [ConfigParser] Configuration parser
+    # @param target_name [String] The name of the target to create the packet
+    #   under. If the target name is 'SYSTEM' the keyword parameter will be
+    #   used instead of this parameter.
+    # @param commands [Hash] Hash of the currently defined commands
+    # @param warnings [Array<String>] Any warning strings generated while
+    #   parsing this command will be appened to this array
+    def self.parse_command(parser, target_name, commands, warnings)
+      parser = PacketParser.new(parser)
+      parser.verify_parameters()
+      parser.create_command(target_name, commands, warnings)
+    end
+
+    # @param parser [ConfigParser] Configuration parser
+    # @param target_name [String] The name of the target to create the packet
+    #   under. If the target name is 'SYSTEM' the keyword parameter will be
+    #   used instead of this parameter.
+    # @param telemetry [Hash] Hash of the currently defined telemetry packets
+    # @param latest_data [Hash<String=>Hash<String=>Array(Packet)>>] Hash of hashes keyed
+    #   first by the target name and then by the item name. This results in an
+    #   array of packets containing that target and item. This structure is
+    #   used to perform lookups when the packet and item are known but the
+    #   packet is not.
+    # @param warnings [Array<String>] Any warning strings generated while
+    #   parsing this command will be appened to this array
+    def self.parse_telemetry(parser, target_name, telemetry, latest_data, warnings)
+      parser = PacketParser.new(parser)
+      parser.verify_parameters()
+      parser.create_telemetry(target_name, telemetry, latest_data, warnings)
+    end
+
+    # @param packet [Packet] Packet to check all default and range items for
+    #   appropriate data types. Only applicable to COMMAND packets.
+    def self.check_item_data_types(packet)
+      packet.sorted_items.each do |item|
+        item.check_default_and_range_data_types()
+      end
+    rescue => err
+      # Add the target name and packet name to the error message so the user
+      # can debug where the error occurred
+      raise $!, "#{packet.target_name} #{packet.packet_name} #{$!}", $!.backtrace
+    end
+
+    # @param parser [ConfigParser] Configuration parser
+    def initialize(parser)
+      @parser = parser
+    end
+
+    def verify_parameters
+      @usage = "#{@parser.keyword} <TARGET NAME> <PACKET NAME> <ENDIANNESS: BIG_ENDIAN/LITTLE_ENDIAN> <DESCRIPTION (Optional)>"
+      @parser.verify_num_parameters(3, 4, @usage)
+    end
+
+    def create_command(target_name, commands, warnings)
+      packet = create_packet(target_name)
+      warning = check_for_duplicate('Command', commands, packet)
+      warnings << warning if warning
+      commands[packet.target_name] ||= {}
+      packet
+    end
+
+    def create_telemetry(target_name, telemetry, latest_data, warnings)
+      packet = create_packet(target_name)
+      warning = check_for_duplicate('Telemetry', telemetry, packet)
+      warnings << warning if warning
+
+      # Add received time packet items
+      item = packet.define_item('RECEIVED_TIMESECONDS', 0, 0, :DERIVED, nil, packet.default_endianness, :ERROR, '%0.6f', ReceivedTimeSecondsConversion.new)
+      item.description = 'COSMOS Received Time (UTC, Floating point, Unix epoch)'
+      item = packet.define_item('RECEIVED_TIMEFORMATTED', 0, 0, :DERIVED, nil, packet.default_endianness, :ERROR, nil, ReceivedTimeFormattedConversion.new)
+      item.description = 'COSMOS Received Time (Local time zone, Formatted string)'
+      item = packet.define_item('RECEIVED_COUNT', 0, 0, :DERIVED, nil, packet.default_endianness, :ERROR, nil, ReceivedCountConversion.new)
+      item.description = 'COSMOS packet received count'
+
+      unless telemetry[packet.target_name]
+        telemetry[packet.target_name] = {}
+        latest_data[packet.target_name] = {}
+      end
+      packet
+    end
+
+    private
+
+    def create_packet(target_name)
+      params = @parser.parameters
+      target_name = params[0].to_s.upcase if target_name == 'SYSTEM'
+      packet_name = params[1].to_s.upcase
+      endianness = params[2].to_s.upcase.to_sym
+      description = params[3].to_s
+      if endianness != :BIG_ENDIAN and endianness != :LITTLE_ENDIAN
+        raise @parser.error("Invalid endianness #{params[2]}. Must be BIG_ENDIAN or LITTLE_ENDIAN.", @usage)
+      end
+      Packet.new(target_name, packet_name, endianness, description)
+    end
+
+    def check_for_duplicate(type, list, packet)
+      msg = nil
+      if list[packet.target_name]
+        if list[packet.target_name][packet.packet_name]
+          msg = "#{type} Packet #{packet.target_name} #{packet.packet_name} redefined."
+          Logger.instance.warn msg
+        end
+      end
+      msg
+    end
+
+  end
+end # module Cosmos

data/lib/cosmos/packets/parsers/processor_parser.rb

@@ -1,63 +1,63 @@
-# encoding: ascii-8bit
-
-# Copyright 2014 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 General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-
-require 'cosmos/processors'
-
-module Cosmos
-
-  class ProcessorParser
-    # @param parser [ConfigParser] Configuration parser
-    # @param packet [Packet] The current packet
-    # @param cmd_or_tlm [String] Whether this is a command or telemetry packet
-    def self.parse(parser, packet, cmd_or_tlm)
-      @parser = ProcessorParser.new(parser)
-      @parser.verify_parameters(cmd_or_tlm)
-      @parser.create_processor(packet)
-    end
-
-    # @param parser [ConfigParser] Configuration parser
-    def initialize(parser)
-      @parser = parser
-    end
-
-    # @param cmd_or_tlm [String] Whether this is a command or telemetry packet
-    def verify_parameters(cmd_or_tlm)
-      if cmd_or_tlm == PacketConfig::COMMAND
-        raise @parser.error("PROCESSOR only applies to telemetry packets")
-      end
-      @usage = "PROCESSOR <PROCESSOR NAME> <PROCESSOR CLASS FILENAME> <PROCESSOR SPECIFIC OPTIONS>"
-      @parser.verify_num_parameters(2, nil, @usage)
-    end
-
-    # @param packet [Packet] The packet the processor should be added to
-    def create_processor(packet)
-      # require should be performed in target.txt
-      klass = @parser.parameters[1].filename_to_class_name.to_class
-      raise @parser.error("#{@parser.parameters[1].filename_to_class_name} class not found. Did you require the file in target.txt?", @usage) unless klass
-      if @parser.parameters[2]
-        processor = klass.new(*@parser.parameters[2..(@parser.parameters.length - 1)])
-      else
-        processor = klass.new
-      end
-      raise ArgumentError, "processor must be a Cosmos::Processor but is a #{processor.class}" unless Cosmos::Processor === processor
-      processor.name = get_processor_name()
-      packet.processors[processor.name] = processor
-    rescue Exception => err
-      raise @parser.error(err, @usage)
-    end
-
-    private
-
-    def get_processor_name
-      @parser.parameters[0].to_s.upcase
-    end
-
-  end
-end # module Cosmos
+# encoding: ascii-8bit
+
+# Copyright 2014 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 General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+
+require 'cosmos/processors'
+
+module Cosmos
+
+  class ProcessorParser
+    # @param parser [ConfigParser] Configuration parser
+    # @param packet [Packet] The current packet
+    # @param cmd_or_tlm [String] Whether this is a command or telemetry packet
+    def self.parse(parser, packet, cmd_or_tlm)
+      @parser = ProcessorParser.new(parser)
+      @parser.verify_parameters(cmd_or_tlm)
+      @parser.create_processor(packet)
+    end
+
+    # @param parser [ConfigParser] Configuration parser
+    def initialize(parser)
+      @parser = parser
+    end
+
+    # @param cmd_or_tlm [String] Whether this is a command or telemetry packet
+    def verify_parameters(cmd_or_tlm)
+      if cmd_or_tlm == PacketConfig::COMMAND
+        raise @parser.error("PROCESSOR only applies to telemetry packets")
+      end
+      @usage = "PROCESSOR <PROCESSOR NAME> <PROCESSOR CLASS FILENAME> <PROCESSOR SPECIFIC OPTIONS>"
+      @parser.verify_num_parameters(2, nil, @usage)
+    end
+
+    # @param packet [Packet] The packet the processor should be added to
+    def create_processor(packet)
+      # require should be performed in target.txt
+      klass = @parser.parameters[1].filename_to_class_name.to_class
+      raise @parser.error("#{@parser.parameters[1].filename_to_class_name} class not found. Did you require the file in target.txt?", @usage) unless klass
+      if @parser.parameters[2]
+        processor = klass.new(*@parser.parameters[2..(@parser.parameters.length - 1)])
+      else
+        processor = klass.new
+      end
+      raise ArgumentError, "processor must be a Cosmos::Processor but is a #{processor.class}" unless Cosmos::Processor === processor
+      processor.name = get_processor_name()
+      packet.processors[processor.name] = processor
+    rescue Exception => err
+      raise @parser.error(err, @usage)
+    end
+
+    private
+
+    def get_processor_name
+      @parser.parameters[0].to_s.upcase
+    end
+
+  end
+end # module Cosmos

data/lib/cosmos/packets/parsers/state_parser.rb

@@ -1,116 +1,116 @@
-# encoding: ascii-8bit
-
-# Copyright 2014 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 General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-
-require 'cosmos/packets/packet_item'
-
-module Cosmos
-
-  class StateParser
-    # @param parser [ConfigParser] Configuration parser
-    # @param packet [Packet] The current packet
-    # @param cmd_or_tlm [String] Whether this is a command or telemetry packet
-    # @param item [PacketItem] The packet item to create states on
-    # @param warnings [Array<String>] Array of string warnings which will be
-    #   appended with any warnings found when parsing the limits
-    def self.parse(parser, packet, cmd_or_tlm, item, warnings)
-      @parser = StateParser.new(parser)
-      @parser.verify_parameters(cmd_or_tlm)
-      @parser.create_state(packet, cmd_or_tlm, item, warnings)
-    end
-
-    # @param parser [ConfigParser] Configuration parser
-    def initialize(parser)
-      @parser = parser
-    end
-
-    # @param cmd_or_tlm [String] Whether this is a command or telemetry packet
-    def verify_parameters(cmd_or_tlm)
-      @usage = "STATE <STATE NAME> <STATE VALUE> "
-      if cmd_or_tlm == PacketConfig::COMMAND
-        @usage << "<HAZARDOUS (Optional)> <Hazardous Description (Optional)>"
-        @parser.verify_num_parameters(2, 4, @usage)
-      else
-        @usage << "<COLOR: GREEN/YELLOW/RED (Optional)>"
-        @parser.verify_num_parameters(2, 3, @usage)
-      end
-    end
-
-    # @param packet [Packet] The current packet
-    # @param cmd_or_tlm [String] Whether this is a command or telemetry packet
-    # @param item [PacketItem] The packet item to create states on
-    # @param warnings [Array<String>] Array of string warnings which will be
-    #   appended with any warnings found when parsing the limits
-    def create_state(packet, cmd_or_tlm, item, warnings)
-      item.states ||= {}
-
-      state_name = get_state_name()
-      check_for_duplicate_states(item, warnings)
-      item.states[state_name] = get_state_value(item.data_type)
-      parse_additional_parameters(packet, cmd_or_tlm, item)
-    end
-
-    private
-
-    def get_state_name
-      @parser.parameters[0].upcase
-    end
-
-    def get_state_value(data_type)
-      if data_type == :STRING || data_type == :BLOCK
-        @parser.parameters[1]
-      else
-        @parser.parameters[1].convert_to_value
-      end
-    end
-
-    def check_for_duplicate_states(item, warnings)
-      if item.states[get_state_name()]
-        msg = "Duplicate state defined on line #{@parser.line_number}: #{@parser.line}"
-        Logger.instance.warn(msg)
-        warnings << msg
-      end
-    end
-
-    def parse_additional_parameters(packet, cmd_or_tlm, item)
-      return unless @parser.parameters.length > 2
-
-      if cmd_or_tlm == PacketConfig::COMMAND
-        get_hazardous(item)
-      else
-        get_state_colors(item)
-        packet.update_limits_items_cache(item)
-      end
-    end
-
-    def get_hazardous(item)
-      if @parser.parameters[2].upcase == 'HAZARDOUS'
-        item.hazardous ||= {}
-        if @parser.parameters[3]
-          item.hazardous[get_state_name()] = @parser.parameters[3]
-        else
-          item.hazardous[get_state_name()] = ""
-        end
-      else
-        raise @parser.error("HAZARDOUS expected as third parameter for this line.", @usage)
-      end
-    end
-
-    def get_state_colors(item)
-      color = @parser.parameters[2].upcase.to_sym
-      unless PacketItem::STATE_COLORS.include? color
-        raise @parser.error("Invalid state color #{color}. Must be one of #{PacketItem::STATE_COLORS.join(' ')}.", @usage)
-      end
-      item.limits.enabled = true
-      item.state_colors ||= {}
-      item.state_colors[get_state_name()] = color
-    end
-
-  end
-end # module Cosmos
+# encoding: ascii-8bit
+
+# Copyright 2014 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 General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+
+require 'cosmos/packets/packet_item'
+
+module Cosmos
+
+  class StateParser
+    # @param parser [ConfigParser] Configuration parser
+    # @param packet [Packet] The current packet
+    # @param cmd_or_tlm [String] Whether this is a command or telemetry packet
+    # @param item [PacketItem] The packet item to create states on
+    # @param warnings [Array<String>] Array of string warnings which will be
+    #   appended with any warnings found when parsing the limits
+    def self.parse(parser, packet, cmd_or_tlm, item, warnings)
+      @parser = StateParser.new(parser)
+      @parser.verify_parameters(cmd_or_tlm)
+      @parser.create_state(packet, cmd_or_tlm, item, warnings)
+    end
+
+    # @param parser [ConfigParser] Configuration parser
+    def initialize(parser)
+      @parser = parser
+    end
+
+    # @param cmd_or_tlm [String] Whether this is a command or telemetry packet
+    def verify_parameters(cmd_or_tlm)
+      @usage = "STATE <STATE NAME> <STATE VALUE> "
+      if cmd_or_tlm == PacketConfig::COMMAND
+        @usage << "<HAZARDOUS (Optional)> <Hazardous Description (Optional)>"
+        @parser.verify_num_parameters(2, 4, @usage)
+      else
+        @usage << "<COLOR: GREEN/YELLOW/RED (Optional)>"
+        @parser.verify_num_parameters(2, 3, @usage)
+      end
+    end
+
+    # @param packet [Packet] The current packet
+    # @param cmd_or_tlm [String] Whether this is a command or telemetry packet
+    # @param item [PacketItem] The packet item to create states on
+    # @param warnings [Array<String>] Array of string warnings which will be
+    #   appended with any warnings found when parsing the limits
+    def create_state(packet, cmd_or_tlm, item, warnings)
+      item.states ||= {}
+
+      state_name = get_state_name()
+      check_for_duplicate_states(item, warnings)
+      item.states[state_name] = get_state_value(item.data_type)
+      parse_additional_parameters(packet, cmd_or_tlm, item)
+    end
+
+    private
+
+    def get_state_name
+      @parser.parameters[0].upcase
+    end
+
+    def get_state_value(data_type)
+      if data_type == :STRING || data_type == :BLOCK
+        @parser.parameters[1]
+      else
+        @parser.parameters[1].convert_to_value
+      end
+    end
+
+    def check_for_duplicate_states(item, warnings)
+      if item.states[get_state_name()]
+        msg = "Duplicate state defined on line #{@parser.line_number}: #{@parser.line}"
+        Logger.instance.warn(msg)
+        warnings << msg
+      end
+    end
+
+    def parse_additional_parameters(packet, cmd_or_tlm, item)
+      return unless @parser.parameters.length > 2
+
+      if cmd_or_tlm == PacketConfig::COMMAND
+        get_hazardous(item)
+      else
+        get_state_colors(item)
+        packet.update_limits_items_cache(item)
+      end
+    end
+
+    def get_hazardous(item)
+      if @parser.parameters[2].upcase == 'HAZARDOUS'
+        item.hazardous ||= {}
+        if @parser.parameters[3]
+          item.hazardous[get_state_name()] = @parser.parameters[3]
+        else
+          item.hazardous[get_state_name()] = ""
+        end
+      else
+        raise @parser.error("HAZARDOUS expected as third parameter for this line.", @usage)
+      end
+    end
+
+    def get_state_colors(item)
+      color = @parser.parameters[2].upcase.to_sym
+      unless PacketItem::STATE_COLORS.include? color
+        raise @parser.error("Invalid state color #{color}. Must be one of #{PacketItem::STATE_COLORS.join(' ')}.", @usage)
+      end
+      item.limits.enabled = true
+      item.state_colors ||= {}
+      item.state_colors[get_state_name()] = color
+    end
+
+  end
+end # module Cosmos