cosmos 4.0.1-universal-java-1.8 → 4.0.2-universal-java-1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9b9433a94613d4d9a77b6939bae05616d426ea02e101d41d36c041d547643761
-  data.tar.gz: d9711554e0db9468556d1a3c422d544f62266211d3b541ad3b89b1ca0a14360e
+  metadata.gz: aa743efd88b1f40cbe8b30a4fe554250df894cd5504623922983bb022c94516a
+  data.tar.gz: ca495dc357053842b8d6cf0665a8583c46169b7cf8e7c9eb92b3829603e49258
 SHA512:
-  metadata.gz: 58852d658bdfc1a1d50ffcd386b23db6371e40b17e1f8aed9e5027fc72945309f6770fa75bf9a156107feab2853cf4fd0793f8293f0d7b34acabd65a98670fb6
-  data.tar.gz: 8c2e447d7aa25c58fc7788ebf193ca87c74574bcdbd418f6e1640b8f6b9719749bc5bc82f2e812dd72f6f93bf968e1993925979942206aadf720bda239fa91f9
+  metadata.gz: 91e4cd22b79229e07263e2fd63245b992897d4bd6a08a2227aafd8063b8965654aa47fe9e016735aebc64829b9d32a971710c79e5e52675a94da532d7efe2c13
+  data.tar.gz: 769a8c98697a2bba14dc831e1204b7b890346578f14b09eb1bdd5a8486cce945e1439dc491bf907499860790cb3cb0e1e0fc1f85b7fbea0a14fd88b41e7db6e8

data/data/config/_id_items.yaml

@@ -9,7 +9,7 @@
 - name: Data Type
   required: true
   description: Data Type of this telemetry item
-  values: <%= %w(INT UINT FLOAT STRING BLOCK DERVIED) %>
+  values: <%= %w(INT UINT FLOAT STRING BLOCK DERIVED) %>
 - name: ID Value
   required: true
   description: The value of this telemetry item that uniquely identifies this telemetry packet

data/data/config/_id_params.yaml

@@ -37,7 +37,7 @@
       parameters: *params
     FLOAT:
       parameters: *params
-    DERVIED:
+    DERIVED:
       parameters: *params
     STRING:
       parameters: &sparams

data/data/config/_items.yaml

@@ -9,7 +9,7 @@
 - name: Data Type
   required: true
   description: Data Type of this telemetry item
-  values: <%= %w(INT UINT FLOAT STRING BLOCK DERVIED) %>
+  values: <%= %w(INT UINT FLOAT STRING BLOCK DERIVED) %>
 - name: Description
   required: false
   description: Description for this telemetry item which must be enclosed with quotes

data/data/config/_params.yaml

@@ -37,7 +37,7 @@
       parameters: *params
     FLOAT:
       parameters: *params
-    DERVIED:
+    DERIVED:
       parameters: *params
     STRING:
       parameters: &sparams

data/data/config/cmd_tlm_server.yaml

@@ -17,6 +17,12 @@ PACKET_LOG_WRITER:
     to create log files.
   warning: You should NOT override the default without consulting a COSMOS expert
     as this may break the ability to successfully read and write log files.
+  example: |
+    PACKET_LOG_WRITER DEFAULT packet_log_writer.rb # Default
+    # The default logger filename will be <DATE>_cosmostlm.bin and will create a new log every 1MB
+    PACKET_LOG_WRITER DEFAULT packet_log_writer.rb cosmos true nil 1000000
+    # Create a logger named COSMOS_LOG which creates a new log every 5 min (600s)
+    PACKET_LOG_WRITER COSMOS_LOG packet_log_writer.rb cosmos true 600
   parameters:
     - name: Log Writer Name
       required: true
@@ -40,6 +46,9 @@ AUTO_INTERFACE_TARGETS:
     INTERFACE_TARGET or INTERFACE keyword.
 INTERFACE_TARGET:
   summary: Load the specified target's cmd_tlm_server.txt configuration file
+  example: |
+    INTERFACE_TARGET COSMOS # Look in the COSMOS target directory for cmd_tlm_server.txt
+    INTERFACE_TARGET COSMOS config.txt # Look in the COSMOS target directory for config.txt
   parameters:
     - name: Target Name
       required: true
@@ -71,6 +80,8 @@ INTERFACE:
       description: Ruby file to use when instantiating the interface.
       values:
         <%= MetaConfigParser.load('_interfaces.yaml').to_meta_config_yaml(8) %>
+      documentation: Additional parameters are required. Please see the [Interfaces](/docs/interfaces)
+        documentation for more details.
 ROUTER:
   modifiers:
     <%= MetaConfigParser.load('interface_modifiers.yaml').to_meta_config_yaml(4) %>
@@ -89,6 +100,8 @@ ROUTER:
       description: Ruby file to use when instantiating the interface.
       values:
         <%= MetaConfigParser.load('_interfaces.yaml').to_meta_config_yaml(8) %>
+      documentation: Additional parameters are required. Please see the [Interfaces](/docs/interfaces)
+        documentation for more details.
 COLLECT_METADATA:
   summary: Prompts the user for meta data when starting the Command and Telemetry Server
 BACKGROUND_TASK:
@@ -98,6 +111,7 @@ BACKGROUND_TASK:
     is only called once so if your background task is supposed to live on while the
     Server is running, you must implement your code in a loop with a sleep to not
     use all the CPU.
+  example: BACKGROUND_TASK example_background_task.rb
   parameters:
     - name: Filename
       required: true

data/data/config/command.yaml

@@ -3,6 +3,7 @@ COMMAND:
   modifiers:
     <%= MetaConfigParser.load('command_modifiers.yaml').to_meta_config_yaml(4) %>
   summary: Defines a new command packet
+  example: COMMAND SYSTEM STARTLOGGING BIG_ENDIAN "Starts logging both commands and telemetry for an interface"
   parameters:
     - name: Target
       required: true
@@ -27,6 +28,7 @@ SELECT_COMMAND:
   summary: Selects an existing command packet for editing
   description: Typically used in a separate configuration file from where the original
     command is defined to override or add to the existing command definition
+  example: SELECT_COMMAND SYSTEM STARTLOGGING
   parameters:
     - name: Target Name
       required: true

data/data/config/command_modifiers.yaml

@@ -3,6 +3,12 @@ PARAMETER:
   modifiers:
     <%= MetaConfigParser.load('parameter_modifiers.yaml').to_meta_config_yaml(4) %>
   summary: Defines a command parameter in the current command packet
+  example: |
+    PARAMETER SYNC 0 32 UINT 0xDEADBEEF 0xDEADBEEF 0xDEADBEEF "Sync pattern"
+    PARAMETER DATA 32 32 INT MIN MAX 0 "Data value"
+    PARAMETER VALUE 64 32 FLOAT 0 10.5 2.5
+    PARAMETER LABEL 96 96 STRING "COSMOS" "The label to apply"
+    PARAMETER BLOCK 192 0 BLOCK '' "Block of binary data"
   parameters:
     - name: Name
       required: true
@@ -19,6 +25,10 @@ APPEND_PARAMETER:
   modifiers:
     <%= MetaConfigParser.load('parameter_modifiers.yaml').to_meta_config_yaml(4) %>
   summary: Defines a command parameter in the current command packet
+  example: |
+    APPEND_PARAMETER SYNC 32 UINT 0xDEADBEEF 0xDEADBEEF 0xDEADBEEF "Sync pattern"
+    APPEND_PARAMETER VALUE 32 FLOAT 0 10.5 2.5
+    APPEND_PARAMETER LABEL 0 STRING "COSMOS" "The label to apply"
   parameters:
     - name: Name
       required: true
@@ -32,6 +42,7 @@ ID_PARAMETER:
   description: ID parameters are used to identify the binary block of data as a
     particular command. A command packet may have one or more ID_PARAMETERs and all
     must match the binary data for the command to be identified.
+  example: ID_PARAMETER OPCODE 32 32 UINT 2 2 2 "Opcode identifier"
   parameters:
     - name: Name
       required: true
@@ -51,6 +62,7 @@ APPEND_ID_PARAMETER:
   description: ID parameters are used to identify the binary block of data as a
     particular command. A command packet may have one or more ID_PARAMETERs and all
     must match the binary data for the command to be identified.
+  example: APPEND_ID_PARAMETER OPCODE 32 UINT 2 2 2 "Opcode identifier"
   parameters:
     - name: Name
       required: true
@@ -61,6 +73,7 @@ ARRAY_PARAMETER:
   modifiers:
     <%= MetaConfigParser.load('parameter_modifiers.yaml').to_meta_config_yaml(4) %>
   summary: Defines a command parameter in the current command packet that is an array
+  example: ARRAY_PARAMETER ARRAY 64 64 FLOAT 640 "Array of 10 64bit floats"
   parameters:
     - name: Name
       required: true
@@ -77,6 +90,7 @@ APPEND_ARRAY_PARAMETER:
   modifiers:
     <%= MetaConfigParser.load('parameter_modifiers.yaml').to_meta_config_yaml(4) %>
   summary: Defines a command parameter in the current command packet that is an array
+  example: APPEND_ARRAY_PARAMETER ARRAY 64 FLOAT 640 "Array of 10 64bit floats"
   parameters:
     - name: Name
       required: true
@@ -87,6 +101,9 @@ SELECT_PARAMETER:
   modifiers:
     <%= MetaConfigParser.load('parameter_modifiers.yaml').to_meta_config_yaml(4) %>
   summary: Selects an existing command parameter for editing
+  example: |
+    SELECT_COMMAND SYSTEM STARTLOGGING
+      SELECT_PARAMETER LABEL
   parameters:
     - name: Parameter
       required: true
@@ -107,6 +124,7 @@ META:
   description: Meta data is user specific data that can be used by custom tools
     for various purposes. One example is to store additional information needed
     to generate source code header files.
+  example: META FSW_TYPE "struct command"
   parameters:
     - name: Meta Name
       required: true

data/data/config/item_modifiers.yaml

@@ -6,6 +6,14 @@ STATE:
     you might define states for ON = 1 and OFF = 0. This allows the word ON to be
     used rather than the number 1 when sending the telemetry item and allows
     for much greater clarity and less chance for user error.
+  example: |
+    APPEND_ITEM ENABLE 32 UINT "Enable setting"
+      STATE FALSE 0
+      STATE TRUE 1
+    APPEND_ITEM STRING 1024 STRING "String"
+      STATE "NOOP" "NOOP" GREEN
+      STATE "ARM LASER" "ARM LASER" YELLOW
+      STATE "FIRE LASER" "FIRE LASER" RED
   parameters:
     - name: Key
       required: true
@@ -29,6 +37,23 @@ READ_CONVERSION:
     factor is applied to the raw value in the telemetry packet before it is displayed
     to the user. The user still has the ability to see the raw unconverted value
     in a details dialog.
+  example: |
+    READ_CONVERSION the_great_conversion.rb 1000
+
+    Defined in the_great_conversion.rb:
+
+    require 'cosmos/conversions/conversion'
+    module Cosmos
+      class TheGreatConversion < Conversion
+        def initialize(multiplier)
+          super()
+          @multiplier = multiplier
+        end
+        def call(value, packet, buffer)
+          return value * multiplier
+        end
+      end
+    end
   parameters:
     - name: Class File Name
       required: true
@@ -47,6 +72,7 @@ POLY_READ_CONVERSION:
   description: The conversion factor is applied to raw value in the telemetry
     packet before it is displayed to the user. The user still has the ability
     to see the raw unconverted value in a details dialog.
+  example: POLY_READ_CONVERSION 10 0.5 0.25
   parameters:
     - name: C0
       required: true
@@ -64,6 +90,10 @@ SEG_POLY_READ_CONVERSION:
   description: This conversion factor is applied to the raw value in the telemetry packet
     before it is displayed to the user. The user still has the ability to see the raw
     unconverted value in a details dialog.
+  example: |
+    SEG_POLY_READ_CONVERSION 0 10 0.5 0.25 # Apply the conversion to all values < 50
+    SEG_POLY_READ_CONVERSION 50 11 0.5 0.275 # Apply the conversion to all values >= 50 and < 100
+    SEG_POLY_READ_CONVERSION 100 12 0.5 0.3 # Apply the conversion to all values >= 100
   parameters:
     - name: Lower Bound
       required: true
@@ -96,6 +126,11 @@ GENERIC_READ_CONVERSION_START:
   warning: Generic conversions are not a good long term solution. Consider creating
     a conversion class and using READ_CONVERSION instead. READ_CONVERSION is easier
     to debug and higher performance.
+  example: |
+    APPEND_ITEM ITEM1 32 UINT
+      GENERIC_READ_CONVERSION_START
+        value * 1.5  # Convert the value by a scale factor
+      GENERIC_READ_CONVERSION_END
 GENERIC_READ_CONVERSION_END:
   summary: Complete a generic write conversion
 LIMITS:
@@ -106,6 +141,9 @@ LIMITS:
     The concept of "limits sets" is defined to allow for different limits values
     in different environments. For example, you might want tighter or looser limits
     on telemetry if your environment changes such as during thermal vacuum testing.
+  example: |
+    LIMITS DEFAULT 3 ENABLED -80.0 -70.0 60.0 80.0 -20.0 20.0
+    LIMITS TVAC 3 ENABLED -80.0 -30.0 30.0 80.0
   parameters:
     - name: Limits Set
       required: true
@@ -159,6 +197,7 @@ LIMITS:
       values: .+
 LIMITS_RESPONSE:
   summary: Defines a response class that is called when the limits state of the current item changes
+  example: LIMITS_RESPONSE example_limits_response.rb 10
   parameters:
     - name: Response Class Filename
       required: true

data/data/config/param_item_modifiers.yaml

@@ -1,6 +1,7 @@
 ---
 FORMAT_STRING:
   summary: Adds printf style formatting
+  example: FORMAT_STRING "0x%0X"
   parameters:
     - name: Format
       required: true
@@ -9,6 +10,9 @@ FORMAT_STRING:
       values: .*
 UNITS:
   summary: Add displayed units
+  example: |
+    UNITS Celcius C
+    UNITS Kilometers KM
   parameters:
     - name: Full Name
       required: true
@@ -30,6 +34,7 @@ META:
   description: Meta data is user specific data that can be used by custom tools
     for various purposes. One example is to store additional information needed
     to generate source code header files.
+  example: META TEST "This parameter is for test purposes only"
   parameters:
     - name: Meta Name
       required: true

data/data/config/parameter_modifiers.yaml

@@ -33,6 +33,14 @@ STATE:
     you might define states for ON = 1 and OFF = 0. This allows the word ON to be
     used rather than the number 1 when sending the command parameter and allows
     for much greater clarity and less chance for user error.
+  example: |
+    APPEND_PARAMETER ENABLE 32 UINT 0 1 0 "Enable setting"
+      STATE FALSE 0
+      STATE TRUE 1
+    APPEND_PARAMETER STRING 1024 STRING "NOOP" "String parameter"
+      STATE "NOOP" "NOOP"
+      STATE "ARM LASER" "ARM LASER" HAZARDOUS "Arming the laser is an eye safety hazard"
+      STATE "FIRE LASER" "FIRE LASER" HAZARDOUS "WARNING! Laser will be fired!"
   parameters:
     - name: Key
       required: true
@@ -60,6 +68,23 @@ WRITE_CONVERSION:
     takes extra parameters and must always implement the call method. The conversion
     factor is applied to the value entered by the user before it is written into
     the binary command packet and sent.
+  example: |
+    WRITE_CONVERSION the_great_conversion.rb 1000
+
+    Defined in the_great_conversion.rb:
+
+    require 'cosmos/conversions/conversion'
+    module Cosmos
+      class TheGreatConversion < Conversion
+        def initialize(multiplier)
+          super()
+          @multiplier = multiplier
+        end
+        def call(value, packet, buffer)
+          return value * multiplier
+        end
+      end
+    end
   parameters:
     - name: Class File Name
       required: true
@@ -77,6 +102,7 @@ POLY_WRITE_CONVERSION:
   summary: Adds a polynomial conversion factor to the current command parameter
   description: The conversion factor is applied to the value entered by the user
     before it is written into the binary command packet and sent.
+  example: POLY_WRITE_CONVERSION 10 0.5 0.25
   parameters:
     - name: C0
       required: true
@@ -93,6 +119,10 @@ SEG_POLY_WRITE_CONVERSION:
   summary: Adds a segmented polynomial conversion factor to the current command parameter
   description: This conversion factor is applied to the value entered by the user
     before it is written into the binary command packet and sent.
+  example: |
+    SEG_POLY_WRITE_CONVERSION 0 10 0.5 0.25 # Apply the conversion to all values < 50
+    SEG_POLY_WRITE_CONVERSION 50 11 0.5 0.275 # Apply the conversion to all values >= 50 and < 100
+    SEG_POLY_WRITE_CONVERSION 100 12 0.5 0.3 # Apply the conversion to all values >= 100
   parameters:
     - name: Lower Bound
       required: true
@@ -124,6 +154,11 @@ GENERIC_WRITE_CONVERSION_START:
   warning: Generic conversions are not a good long term solution. Consider creating
     a conversion class and using WRITE_CONVERSION instead. WRITE_CONVERSION is easier
     to debug and higher performance.
+  example: |
+    APPEND_PARAMETER ITEM1 32 UINT 0 0xFFFFFFFF 0
+      GENERIC_WRITE_CONVERSION_START
+        (value * 1.5).to_i # Convert the value by a scale factor
+      GENERIC_WRITE_CONVERSION_END
 GENERIC_WRITE_CONVERSION_END:
   summary: Complete a generic write conversion
 OVERFLOW:
@@ -136,6 +171,7 @@ OVERFLOW:
     for that type. Finally you can specify 'ERROR_ALLOW_HEX' which will allow for
     a maximum hex value to be writen, e.g. you can successfully write 255 to a 8
     bit signed value.
+  example: OVERFLOW TRUNCATE
   parameters:
     - name: Behavior
       required: true

data/data/config/protocols.yaml

@@ -224,8 +224,8 @@ TEMPLATE:
       required: false
       description: An initial delay after connecting after which the stream will
         be read till empty and data dropped. Useful for discarding connect headers
-        and initial prompts. Default is nil (no initial read)
-      values: \d+
+        and initial prompts. Default is nil (no initial read).
+      values: .+
     - name: Response Lines
       required: false
       description: The number of lines that make up expected responses.
@@ -241,17 +241,33 @@ TEMPLATE:
       description: The number of bytes to discard from the binary data after
         reading from the stream. Note that this applies to bytes including the
         sync pattern if the sync pattern is being used.
-        Default is 0 (do not discard bytes)
+        Default is 0 (do not discard bytes).
       values: \d+
     - name: Sync Pattern
       required: false
       description: Hex string representing a byte pattern that will be searched
         for in the raw stream. This pattern represents a packet delimiter and all
         data found including the sync pattern will be returned.
-        Default is nil (no sync pattern)
+        Default is nil (no sync pattern).
       values: .+
     - name: Fill Sync Pattern
       required: false
-      description: Whether or not to fill in the sync pattern on outgoing packets
-        Default is false
+      description: Whether or not to fill in the sync pattern on outgoing packets.
+        Default is false.
       values: ['false','true']
+    - name: Response Timeout
+      required: false
+      description: Number of seconds to wait before timing out when waiting for a response.
+        Default is 5 seconds.
+      values: .+
+    - name: Response Polling Period
+      required: false
+      description: Number of seconds to wait between polling for a response.
+        Default is 0.02 seconds.
+      values: .+
+    - name: Error Action
+      required: false
+      description: How to handle errors in the protocol like unexpected responses
+        or response timeouts. 'DISCONNECT' to disconnect after errors. The default
+        is 'LOG' to log an error and continue.
+      values: ['LOG','DISCONNECT']

data/data/config/system.yaml

@@ -12,6 +12,7 @@ DECLARE_TARGET:
   description: Declare target is used in place of AUTO_DECLARE_TARGETS to give more
     fine grained control over how the target folder is loaded and named within COSMOS.
     This is required if AUTO_DECLARE_TARGET is not present.
+  example: DECLARE_TARGET INST INST2 inst.txt
   parameters:
     - name: Target Name
       required: true
@@ -57,6 +58,10 @@ PORT:
     It is not necessary to set this option unless you wish to override the defaults
     (given in the example usage). Overriding ports is necessary if you want to run
     two Command and Telemetry Servers on the same computer simultaneously.
+  example: |
+    PORT CTS_API 7777 # Default
+    PORT TLMVIEWER_API 7778 # Default
+    PORT CTS_PREIDENTIFIED 7779 # Default
   parameters:
     - name: Port Name
       required: true
@@ -121,6 +126,13 @@ PATH:
   warning: The PROCEDURES path must be set for Script Runner and Test Runner to locate your
     procedure files. You can add multiple 'PATH PROCEDURES' lines to your configuration file
     to set multiple locations.
+  example: |
+    PATH LOGS './logs' # Default location of system and tool log files
+    PATH TMP './tmp' # Default location of temporary marshal files
+    PATH SAVED_CONFIG './saved_config' # Default location of saved configurations (see note)
+    PATH TABLES './tables' # Default location of table files
+    PATH PROCEDURES './procedures' # Default location of Script procedure files
+    PATH HANDBOOKS './handbooks' # Default location to place handbook files
   parameters:
     - name: Path Name
       required: true
@@ -134,6 +146,7 @@ DEFAULT_PACKET_LOG_WRITER:
   summary: Set the class used when creating binary packet log files
   warning: Overriding the default log writer can break the ability to write log
     files that COSMOS can interpret. Proceed with caution!
+  example: DEFAULT_PACKET_LOG_WRITER packet_log_writer.rb # Default
   parameters:
     - name: Filename
       required: true
@@ -148,6 +161,7 @@ DEFAULT_PACKET_LOG_READER:
   summary: Set the class used when reading binary packet log file
   warning: Overriding the default log read can break the ability to read log
     files. Proceed with caution!
+  example: DEFAULT_PACKET_LOG_READER packet_log_reader.rb # Default
   parameters:
     - name: Filename
       required: true
@@ -162,6 +176,7 @@ STALENESS_SECONDS:
   summary: Number of seconds before marking the packet stale
   description: A stale packet is identified in telemetry screens by all the telemetry
     items in the stale packet being colored purple..
+  example: STALENESS_SECONDS 30 # Default
   parameters:
     - name: Seconds
       required: true
@@ -186,6 +201,7 @@ ENABLE_SOUND:
   since: 3.5.0
 ALLOW_ACCESS:
   summary: White list machines that are allowed to connect to the Server
+  example: ALLOW_ACCESS ALL # Default
   parameters:
     - name: Name or IP Address
       required: true
@@ -223,6 +239,7 @@ ADD_MD5_FILE:
     MD5 sum calculation. This means that a change in the file will cause COSMOS to
     re-process the cmd/tlm defintions and create a new set of marshal files.
   since: 4.0.0
+  example: ADD_MD5_FILE lib/user_version.rb
   parameters:
     - name: Filename
       required: true