openc3 5.20.0 → 6.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: afacc218fcbddf94eaf648df3232e9f6c99f9637fb0694cde932267542968d5e
-  data.tar.gz: 1ce5bf3127b8b7ea3c1adae3de0a294f435302854bb08835d5fdb18a4b786804
+  metadata.gz: 964ea4b3a9cace2d4e12c4321cd5f6f3e734f90e794aeb6e46cedad56f336732
+  data.tar.gz: e7948a2ca0dab6e9b975f6f4e8753ed7494b63f0161af293f2ce0797a507adeb
 SHA512:
-  metadata.gz: ad58ad437fb0f7391d33fef0bafdf6f0b670cb6f59b63f60f2f03bda7a65c06acf59cad85ba92069c79a505da0fe4c33d8fb928d9cd926e0c4a9be0d42ee20c9
-  data.tar.gz: 503095241e1a8d34f71875abc4f1313c036470c86bb7627a3bd70b482281d03eeb6479d9a3109753b2f3b7927e1ceef49a62532197c5827f360ba66f23f4c4ff
+  metadata.gz: 4fc717bb0d80d646771ae045e1f9a739907dbae94c05b94162f9685ecf8eee70fb2375b72ee75b8db25cb5f24b4579898d1af53b52f6d755cc33746356f50641
+  data.tar.gz: 2faf1ccd06fe62ed0f47286d91622ce83b220b7d6f42352be4c22f471538fbb838d73e3f151d9702cb60bdf2126aceaa25185156eb469f7a8fa5786740e6eb3b

data/bin/openc3cli

@@ -47,15 +47,6 @@ require 'irb/completion'
 
 $redis_url = "redis://#{ENV['OPENC3_REDIS_HOSTNAME']}:#{ENV['OPENC3_REDIS_PORT']}"
 
-# Build the OpenStruct and OptionParser here as constants so we can use in methods
-MIGRATE_OPTIONS = OpenStruct.new
-MIGRATE_OPTIONS.all = false
-MIGRATE_PARSER = OptionParser.new do |opts|
-  opts.banner = "cli migrate PLUGIN [TGT1...]      # Create a OpenC3 plugin from existing COSMOS 4 targets"
-  opts.on("-a", "--all", " Move all COSMOS 4 targets into a single OpenC3 plugin") do
-    MIGRATE_OPTIONS.all = true
-  end
-end
 ERROR_CODE = 1
 
 CLI_SCRIPT_ACTIONS = %w(help list run spawn)
@@ -82,7 +73,6 @@ def print_usage
   puts "  cli list <SCOPE>                  # Lists installed plugins, SCOPE is DEFAULT if not given"
   puts "  cli generate TYPE OPTIONS         # Generate various COSMOS entities"
   puts "    OPTIONS: --ruby or --python is required to specify the language in the generated code unless OPENC3_LANGUAGE is set"
-  puts "  #{MIGRATE_PARSER}"
   puts "  cli bridge CONFIG_FILENAME        # Run COSMOS host bridge"
   puts "  cli bridgegem gem_name variable1=value1 variable2=value2 # Runs bridge using gem bridge.txt"
   puts "  cli bridgesetup CONFIG_FILENAME   # Create a default config file"
@@ -116,110 +106,6 @@ def check_environment
   end
 end
 
-def migrate(args)
-  MIGRATE_PARSER.parse!(args)
-  abort(MIGRATE_PARSER.to_s) if args.length == 0
-  if MIGRATE_OPTIONS.all and args.length > 1
-    puts "Only specify the plugin name when using --all"
-    abort(MIGRATE_PARSER.to_s)
-  end
-  if !MIGRATE_OPTIONS.all and args.length < 2
-    puts "Specify the individual target names when not using --all"
-    abort(MIGRATE_PARSER.to_s)
-  end
-  if Dir.glob("config/targets/**/*").empty?
-    puts "No targets found in config/targets/*"
-    puts "Migrate must be run within an existing COSMOS configuration"
-    abort(MIGRATE_PARSER.to_s)
-  end
-
-  ###############################################################
-  # Create the framework for the plugin
-  # NOTE: generate does a chdir to be inside the plugin directory
-  ###############################################################
-  plugin = args.shift
-  OpenC3::CliGenerator.generate(['plugin', plugin])
-
-  if MIGRATE_OPTIONS.all
-    # Grab all target directories to match the command line input
-    args = Dir.glob("../config/targets/*").map { |path| File.basename(path) }
-  else
-    # Ensure targets passed in on command line actually exist
-    args.each do |target|
-      path = File.join('..', 'config', 'targets', target)
-      unless File.exist?(path)
-        puts "Target #{path} does not exist!"
-        abort(MIGRATE_PARSER.to_s)
-      end
-    end
-  end
-
-  # Overwrite plugin.txt with specified targets
-  plugin = File.open('plugin.txt', 'w')
-  FileUtils.mkdir 'targets'
-  args.each do |target|
-    puts "Migrating target #{target}"
-    FileUtils.cp_r "../config/targets/#{target}", 'targets'
-    plugin.puts "TARGET #{target} #{target}"
-  end
-  plugin.puts ""
-
-  files = Dir.glob('../lib/*')
-  files.concat(Dir.glob('../procedures/*'))
-  unless files.empty?
-    puts "Migrating /lib & /procedures to PROCEDURES target"
-    FileUtils.cp_r '../lib', "targets/PROCEDURES"
-    FileUtils.cp_r '../procedures', "targets/PROCEDURES"
-  end
-
-  # Migrate cmd_tlm_server.txt info to plugin.txt
-  Dir.glob('targets/**/cmd_tlm_server*.txt') do |cmd_tlm_server_file|
-    File.open(cmd_tlm_server_file) do |file|
-      file.each do |line|
-        next if line =~ /^\s*#/ # Ignore comments
-        next if line.strip.empty? # Ignore empty lines
-
-        # Convert TARGET to MAP_TARGET
-        line.gsub!(/TARGET (\S+)/, 'MAP_TARGET \1')
-        plugin.puts line
-      end
-    end
-    plugin.puts ''
-  end
-
-  # Migrate target.txt
-  Dir.glob('targets/**/target.txt') do |filename|
-    file = File.read(filename)
-    file.gsub!('LOG_RAW', 'LOG_STREAM')
-    file.gsub!('AUTO_SCREEN_SUBSTITUTE', '')
-    File.write(filename, file)
-  end
-
-  # Migrate some of the screens api
-  Dir.glob('targets/**/screens/*') do |file|
-    screen = File.read(file)
-    screen.gsub!('cmd(', 'api.cmd(')
-    screen.gsub!('cmd_no_checks(', 'api.cmd_no_checks(')
-    screen.gsub!('cmd_no_range_check(', 'api.cmd_no_range_check(')
-    screen.gsub!('cmd_no_hazardous_check(', 'api.cmd_no_hazardous_check(')
-    screen.gsub!('get_named_widget(', 'screen.getNamedWidget(')
-    lines = screen.split("\n")
-    lines.map! do |line|
-      if line.include?('Qt.')
-        "# FIXME (no Qt): #{line.sub("<%", "< %").sub("%>", "% >")}"
-      elsif line.include?('Cosmos::')
-        "# FIXME (no Cosmos::): #{line.sub("<%", "< %").sub("%>", "% >")}"
-      else
-        line
-      end
-    end
-    File.write(file, lines.join("\n"))
-  end
-
-  plugin.close
-  puts "Plugin complete: #{File.expand_path('.')}" # Remember we're inside the plugin dir
-end
-
 def xtce_converter(args)
   options = {}
   option_parser = OptionParser.new do |opts|
@@ -619,16 +505,25 @@ def run_migrations(folder)
   end
 
   # Run each newly discovered migration unless brand_new
-  folder = "/openc3/lib/openc3/migrations" unless folder
+  if !folder
+    folder = "/openc3/lib/openc3/migrations"
+    entries = Dir.entries(folder).map { |entry| File.join(folder, entry) }
+    folder = "/openc3-enterprise/lib/openc3-enterprise/migrations"
+    if File.exist?(folder)
+      entries.concat(Dir.entries(folder).map { |entry| File.join(folder, entry) })
+    end
+    entries = entries.sort() # run in alphabetical order
+  else
+    entries = Dir.entries(folder).sort
+  end
   migrations = OpenC3::MigrationModel.all
-  entries = Dir.entries(folder).sort # run in alphabetical order
   entries.each do |entry|
     name = File.basename(entry)
     extension = File.extname(name)
     if extension == '.rb' and not migrations[name]
       unless brand_new
         puts "Running Migration: #{name}"
-        require File.join(folder, entry)
+        require entry
       end
       OpenC3::MigrationModel.new(name: name).create
     end
@@ -869,9 +764,6 @@ if not ARGV[0].nil? # argument(s) given
   when 'generate'
     OpenC3::CliGenerator.generate(ARGV[1..-1])
 
-  when 'migrate'
-    migrate(ARGV[1..-1])
-
   when 'rubysloc'
     puts `ruby /openc3/bin/rubysloc #{ARGV[1..-1].join(' ')}`
 

data/data/config/command_modifiers.yaml

@@ -165,7 +165,7 @@ HAZARDOUS:
 ACCESSOR:
   summary: Defines the class used to read and write raw values from the packet
   description: Defines the class that is used too read raw values from the packet. Defaults to BinaryAccessor.
-    Provided accessors also include JsonAccessor, CborAccessor, HtmlAccessor, and XmlAccessor.
+    For more information see [Accessors](accessors).
   parameters:
     - name: Accessor Class Name
       required: true
@@ -278,6 +278,12 @@ VALIDATOR:
 
     require 'openc3/packets/command_validator'
     class CustomValidator < OpenC3::CommandValidator
+      # Both the pre_check and post_check are passed the command packet that was sent
+      # You can inspect the command in your checks as follows:
+      #   packet.target_name => target name
+      #   packet.packet_name => packet name (command name)
+      #   packet.read("ITEM") => converted value
+      #   packet.read("ITEM", :RAW) => raw value
       def pre_check(packet)
         if tlm("TGT PKT ITEM") == 0
           return [false, "TGT PKT ITEM is 0"]
@@ -297,6 +303,12 @@ VALIDATOR:
     Defined in custom_validator.py:
 
     class CustomValidator(CommandValidator):
+        # Both the pre_check and post_check are passed the command packet that was sent
+        # You can inspect the command in your checks as follows:
+        #   packet.target_name => target name
+        #   packet.packet_name => packet name (command name)
+        #   packet.read("ITEM") => converted value
+        #   packet.read("ITEM", :RAW) => raw value
         def pre_check(self, command):
             if tlm("TGT PKT ITEM") == 0:
                 return [False, "TGT PKT ITEM is 0"]

data/data/config/interface_modifiers.yaml

@@ -153,7 +153,9 @@ OPTION:
       OPTION LISTEN_ADDRESS 127.0.0.1
 SECRET:
   summary: Define a secret needed by this interface
-  description: Defines a secret for this interface and optionally assigns its value to an option
+  description:
+    Defines a secret for this interface and optionally assigns its value to an option.
+    For more information see [Admin Secrets](/docs/tools/admin#secrets).
   since: 5.3.0
   parameters:
     - name: Type
@@ -164,15 +166,19 @@ SECRET:
       values: .*
     - name: Secret Name
       required: true
-      description: The name of the secret to retrieve
+      description:
+        The name of the secret to retrieve from the Admin / Secrets tab.
+        For more information see [Admin Secrets](/docs/tools/admin#secrets).
       values: .*
     - name: Environment Variable or File Path
       required: true
-      description: Environment variable name or file path to store secret
+      description: Environment variable name or file path to store secret.
+        Note that if you use the Option Name to set an option to the secret value,
+        this value doesn't really matter as long as it is unique.
       values: .*
     - name: Option Name
       required: false
-      description: Interface option to pass the secret value
+      description: Interface option to pass the secret value. This is the primary way to pass secrets to interfaces.
       values: .*
     - name: Secret Store Name
       required: false
@@ -252,3 +258,14 @@ ROUTE_PREFIX:
       values: .*
   example: |
     ROUTE_PREFIX /interface
+SHARD:
+  summary: Operator shard to run target microservices on
+  description: Operator Shard. Only used if running multiple operator containers typically in Kubernetes
+  since: 6.0.0
+  parameters:
+    - name: Shard
+      required: false
+      description: Shard number starting from 0
+      values: \d+
+  example: |
+    SHARD 0

data/data/config/item_modifiers.yaml

@@ -66,7 +66,7 @@ READ_CONVERSION:
             super().__init__()
             self.multiplier = float(multiplier)
         def call(self, value, packet, buffer):
-            return value * multiplier
+            return value * self.multiplier
   parameters:
     - name: Class Filename
       required: true

data/data/config/microservice.yaml

@@ -115,7 +115,7 @@ MICROSERVICE:
           values: .+
     SECRET:
       summary: Define a secret needed by this microservice
-      description: Defines a secret for this microservice
+      description: Defines a secret for this microservice. For more information see [Admin Secrets](/docs/tools/admin#secrets).
       since: 5.3.0
       parameters:
         - name: Type
@@ -126,7 +126,9 @@ MICROSERVICE:
           values: .*
         - name: Secret Name
           required: true
-          description: The name of the secret to retrieve
+          description:
+            The name of the secret to retrieve from the Admin / Secrets tab.
+            For more information see [Admin Secrets](/docs/tools/admin#secrets).
           values: .*
         - name: Environment Variable or File Path
           required: true
@@ -160,3 +162,14 @@ MICROSERVICE:
           required: false
           description: Regex to match against filenames. If match, then no ERB processing
           values: .+
+    SHARD:
+      summary: Operator shard to run target microservices on
+      description: Operator Shard. Only used if running multiple operator containers typically in Kubernetes
+      since: 6.0.0
+      parameters:
+        - name: Shard
+          required: false
+          description: Shard number starting from 0
+          values: \d+
+      example: |
+        SHARD 0

data/data/config/param_item_modifiers.yaml

@@ -52,7 +52,7 @@ OVERLAP:
   since: 4.4.1
 KEY:
   summary: Defines the key used to access this raw value in the packet.
-  description: Keys are often JsonPath or XPath strings
+  description: Keys are often [JSONPath](https://en.wikipedia.org/wiki/JSONPath) or [XPath](https://en.wikipedia.org/wiki/XPath) strings
   example: KEY $.book.title
   parameters:
     - name: Key string

data/data/config/parameter_modifiers.yaml

@@ -107,7 +107,7 @@ WRITE_CONVERSION:
             super().__init__()
             self.multiplier = float(multiplier)
         def call(self, value, packet, buffer):
-            return value * multiplier
+            return value * self.multiplier
   parameters:
     - name: Class Filename
       required: true

data/data/config/table_manager.yaml

@@ -53,7 +53,7 @@ TABLE:
         or a ROW_COLUMN table with identical rows containing different values.
       values:
         KEY_VALUE:
-          summary: Table rows will be unique items (previously ONE_DIMENSIONAL, now deprecated)
+          summary: Table rows will be unique items
           parameters:
             - name: Description
               requires: true
@@ -61,7 +61,7 @@ TABLE:
                 used in mouseover popups and status line information.
               values: "['\"].*['\"]"
         ROW_COLUMN:
-          summary: Table rows will be identical with multiple columns (previously TWO_DIMENSIONAL, now deprecated)
+          summary: Table rows will be identical with multiple columns
           parameters:
             - name: Rows
               requires: true

data/data/config/target.yaml

@@ -196,3 +196,14 @@ TARGET:
           required: false
           description: Regex to match against filenames. If match, then no ERB processing
           values: .+
+    SHARD:
+      summary: Operator shard to run target microservices on
+      description: Operator Shard. Only used if running multiple operator containers typically in Kubernetes
+      since: 6.0.0
+      parameters:
+        - name: Shard
+          required: false
+          description: Shard number starting from 0
+          values: \d+
+      example: |
+        SHARD 0

data/data/config/telemetry_modifiers.yaml

@@ -165,13 +165,29 @@ HIDDEN:
 ACCESSOR:
   summary: Defines the class used to read and write raw values from the packet
   description: Defines the class that is used too read raw values from the packet. Defaults to BinaryAccessor.
-    Provided accessors also include JsonAccessor, CborAccessor, HtmlAccessor, and XmlAccessor.
+    For more information see [Accessors](accessors).
   parameters:
     - name: Accessor Class Name
       required: true
       description: The name of the accessor class
       values: .+
   since: 5.0.10
+TEMPLATE:
+  summary: Defines a template string used to pull telemetry values from a string buffer
+  parameters:
+    - name: Template
+      required: true
+      description: The template string which should be enclosed in quotes
+      values: "['\"].*['\"]"
+  since: 5.0.10
+TEMPLATE_FILE:
+  summary: Defines a template file used to pull telemetry values from a string buffer
+  parameters:
+    - name: Template File Path
+      required: true
+      description: The relative path to the template file. Filename should generally start with an underscore.
+      values: .+
+  since: 5.0.10
 IGNORE_OVERLAP:
   summary: Ignores any packet items which overlap
   description: Packet items which overlap normally generate a warning unless each individual item has the OVERLAP keyword.

data/data/config/tool.yaml

@@ -82,3 +82,15 @@ TOOL:
           required: false
           description: Regex to match against filenames. If match, then no ERB processing
           values: .+
+    IMPORT_MAP_ITEM:
+      summary: Add an item to the import map
+      since: 6.0.0
+      parameters:
+        - name: key
+          required: true
+          description: Import Map Key
+          values: .+
+        - name: value
+          required: true
+          description: Import Map Value
+          values: .+

data/data/config/widgets.yaml

@@ -173,14 +173,6 @@ Decoration Widgets:
         LABEL Over
         HORIZONTALLINE
         LABEL Under
-    SECTIONHEADER:
-      summary: DEPRECATED - Displays a label that is underlined with a horizontal line
-      description: Use a VERTICALBOX or HORIZONTALBOX with title parameter instead of SECTIONHEADER
-      parameters:
-        - name: Text
-          required: true
-          description: Text to display
-          values: .*
     TITLE:
       summary: Displays a large centered title on the screen
       parameters:
@@ -299,7 +291,7 @@ Telemetry Widgets:
           description: The type of the value to display. Default is CONVERTED.
           values: <%= %w(RAW CONVERTED FORMATTED WITH_UNITS) %>
       example: |
-        BLOCK INST IMAGE IMAGE 400 130 "%02X" 4 4 "0x%08X:"
+        BLOCK INST IMAGE IMAGE 620 200 "%02X" 4 4 "0x%08X:"
     # FORMATFONTVALUE:
     #   summary: Displays a box with a value printed inside
     #     that is formatted by the specified string rather than by a format string given
@@ -377,6 +369,7 @@ Telemetry Widgets:
           values: .*
       example: |
         FORMATVALUE INST LATEST TIMESEC %012u CONVERTED 20
+        FORMATVALUE INST LATEST TEMP1 %.2f CONVERTED 20
     LABELLED:
       summary: Displays a LABEL followed by a LED
       parameters:
@@ -978,12 +971,6 @@ Telemetry Widgets:
       example: |
         LINEGRAPH INST HEALTH_STATUS TEMP1
           SETTING ITEM INST ADCS Q1 # Add additional item to graph
-        LINEGRAPH INST HEALTH_STATUS TEMP2 RAW
-        LINEGRAPH INST HEALTH_STATUS TEMP3 CONVERTED REDUCED_MINUTE MIN
-          SETTING SIZE 600 500 # width height
-          SETTING HISTORY 1h # load 1 hour of data into graph
-        LINEGRAPH INST HEALTH_STATUS TEMP4
-          SETTING HISTORY 30m # load 30 minutes of data into graph
       settings:
         # Inject the graph settings
         <%= MetaConfigParser.load('graph_settings.yaml').to_meta_config_yaml(8) %>
@@ -1232,7 +1219,6 @@ Telemetry Widgets:
           values: .*
       example: |
         TEXTBOX INST HEALTH_STATUS PACKET_TIMEFORMATTED 150 70
-        TEXTBOX INST HEALTH_STATUS PACKET_TIMEFORMATTED
     # TRENDBAR:
     #   summary: Provides the same functionality as the LIMITSBAR
     #     widget except that it also keeps a history of the telemetry item and
@@ -1401,10 +1387,20 @@ Interactive Widgets:
           required: true
           description: Text displayed next to the checkbox
           values: .+
+        - name: Checked
+          required: false
+          description:
+            Whether the initial state of the checkbox is checked (default = false).
+            Do not give a value to make the checkbox unchecked.
+          values: .+
       example: |
-        NAMED_WIDGET CHECK CHECKBUTTON 'Ignore Hazardous Checks'
+        NAMED_WIDGET UNCHECKED CHECKBUTTON 'Default Unchecked'
+        NAMED_WIDGET CHECK CHECKBUTTON 'Ignore Hazardous Checks' CHECKED
         BUTTON 'Send' 'screen.getNamedWidget("CHECK").checked() ? ' \
           'api.cmd_no_hazardous_check("INST CLEAR") : api.cmd("INST CLEAR")'
+        # You can programmatically check or uncheck the checkbox
+        BUTTON 'Check' 'screen.getNamedWidget("CHECK").value = true'
+        BUTTON 'Uncheck' 'screen.getNamedWidget("CHECK").value = false'
     COMBOBOX:
       summary: Displays a drop down list of text items
       description:

data/lib/openc3/accessors/form_accessor.rb

@@ -26,11 +26,12 @@ module OpenC3
       value = nil
       ary.each do |key, ary_value|
         if key == item.key
+          # Handle the case of multiple values for the same key
+          # and build up an array of values
           if value
+            # Second time through value is not an Array yet
             if not Array === value
-              value_temp = []
-              value_temp << value
-              value = value_temp
+              value = [value]
             end
             value << ary_value
           else

data/lib/openc3/accessors/html_accessor.rb

@@ -1,6 +1,6 @@
 # encoding: ascii-8bit
 
-# Copyright 2022 OpenC3, Inc.
+# Copyright 2024 OpenC3, Inc.
 # All Rights Reserved.
 #
 # This program is free software; you can modify and/or redistribute it
@@ -13,7 +13,7 @@
 # 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 
+# This file may also be used under the terms of a commercial license
 # if purchased from OpenC3, Inc.
 
 require 'openc3/accessors/xml_accessor'
@@ -28,4 +28,4 @@ module OpenC3
       doc.to_html
     end
   end
-end
+end

data/lib/openc3/accessors/http_accessor.rb

@@ -1,6 +1,6 @@
 # encoding: ascii-8bit
 
-# Copyright 2023 OpenC3, Inc.
+# Copyright 2024 OpenC3, Inc.
 # All Rights Reserved.
 #
 # This program is free software; you can modify and/or redistribute it
@@ -50,10 +50,10 @@ module OpenC3
         return @packet.extra['HTTP_ERROR_PACKET']
       when /^HTTP_QUERY_/
         return nil unless @packet.extra
-        if item.key
-          query_name = item.key
+        if item.key =~ /^HTTP_QUERY_/
+          query_name = item_name[11..-1].downcase
         else
-          query_name = item_name[11..-1]
+          query_name = item.key
         end
         queries = @packet.extra['HTTP_QUERIES']
         if queries
@@ -63,10 +63,10 @@ module OpenC3
         end
       when /^HTTP_HEADER_/
         return nil unless @packet.extra
-        if item.key
-          header_name = item.key
+        if item.key =~ /^HTTP_HEADER_/
+          header_name = item_name[12..-1].downcase
         else
-          header_name = item_name[12..-1]
+          header_name = item.key
         end
         headers = @packet.extra['HTTP_HEADERS']
         if headers
@@ -99,19 +99,19 @@ module OpenC3
         @packet.extra['HTTP_ERROR_PACKET'] = value.to_s.upcase
       when /^HTTP_QUERY_/
         @packet.extra ||= {}
-        if item.key
-          query_name = item.key
+        if item.key =~ /^HTTP_QUERY_/
+          query_name = item_name[11..-1].downcase
         else
-          query_name = item_name[11..-1]
+          query_name = item.key
         end
         queries = @packet.extra['HTTP_QUERIES'] ||= {}
         queries[query_name] = value.to_s
       when /^HTTP_HEADER_/
         @packet.extra ||= {}
-        if item.key
-          header_name = item.key
+        if item.key =~ /^HTTP_HEADER_/
+          header_name = item_name[12..-1].downcase
         else
-          header_name = item_name[12..-1]
+          header_name = item.key
         end
         headers = @packet.extra['HTTP_HEADERS'] ||= {}
         headers[header_name] = value.to_s

data/lib/openc3/accessors/xml_accessor.rb

@@ -1,6 +1,6 @@
 # encoding: ascii-8bit
 
-# Copyright 2022 OpenC3, Inc.
+# Copyright 2024 OpenC3, Inc.
 # All Rights Reserved.
 #
 # This program is free software; you can modify and/or redistribute it
@@ -24,7 +24,13 @@ module OpenC3
     def self.read_item(item, buffer)
       return nil if item.data_type == :DERIVED
       doc = buffer_to_doc(buffer)
-      return convert_to_type(doc.xpath(item.key).first.to_s, item)
+      doc_value = doc.xpath(item.key)
+      # Nokogiri returns a Nokogiri::XML::Text which responds to first
+      # unless they've applied some XPath functions to the result like normalize-space
+      if doc_value.respond_to?(:first)
+        doc_value = doc_value.first
+      end
+      return convert_to_type(doc_value.to_s, item)
     end
 
     def self.write_item(item, value, buffer)
@@ -43,7 +49,13 @@ module OpenC3
         if item.data_type == :DERIVED
           result[item.name] = nil
         else
-          result[item.name] = convert_to_type(doc.xpath(item.key).first.to_s, item)
+          doc_value = doc.xpath(item.key)
+          # Nokogiri returns a Nokogiri::XML::Text which responds to first
+          # unless they've applied some XPath functions to the result like normalize-space
+          if doc_value.respond_to?(:first)
+            doc_value = doc_value.first
+          end
+          result[item.name] = convert_to_type(doc_value.to_s, item)
         end
       end
       return result
@@ -94,4 +106,4 @@ module OpenC3
       return true
     end
   end
-end
+end