cosmos 4.2.4 → 4.5.0

data/demo/config/system/system.txt

@@ -10,22 +10,41 @@ DECLARE_TARGET DART
 DECLARE_TARGET SYSTEM
 
 # Listen Hosts - Ip addresses or hostnames to listen on when running the tools
+# Set these to 0.0.0.0 if you need external connections from other computers
 LISTEN_HOST CTS_API 127.0.0.1
 LISTEN_HOST TLMVIEWER_API 127.0.0.1
-LISTEN_HOST CTS_PREIDENTIFIED 0.0.0.0 # 127.0.0.1 is more secure if you don't need external connections
-LISTEN_HOST CTS_CMD_ROUTER 0.0.0.0 # 127.0.0.1 is more secure if you don't need external connections
+LISTEN_HOST CTS_PREIDENTIFIED 127.0.0.1
+LISTEN_HOST CTS_CMD_ROUTER 127.0.0.1
+LISTEN_HOST REPLAY_API 127.0.0.1
+LISTEN_HOST REPLAY_PREIDENTIFIED 127.0.0.1
+LISTEN_HOST REPLAY_CMD_ROUTER 127.0.0.1
+LISTEN_HOST DART_STREAM 127.0.0.1
+LISTEN_HOST DART_DECOM 127.0.0.1
+LISTEN_HOST DART_MASTER 127.0.0.1
 
 # Connect Hosts - Ip addresses or hostnames to connect to when running the tools
 CONNECT_HOST CTS_API 127.0.0.1
 CONNECT_HOST TLMVIEWER_API 127.0.0.1
 CONNECT_HOST CTS_PREIDENTIFIED 127.0.0.1
 CONNECT_HOST CTS_CMD_ROUTER 127.0.0.1
+CONNECT_HOST REPLAY_API 127.0.0.1
+CONNECT_HOST REPLAY_PREIDENTIFIED 127.0.0.1
+CONNECT_HOST REPLAY_CMD_ROUTER 127.0.0.1
+CONNECT_HOST DART_STREAM 127.0.0.1
+CONNECT_HOST DART_DECOM 127.0.0.1
+CONNECT_HOST DART_MASTER 127.0.0.1
 
 # Ethernet Ports
 PORT CTS_API 7777
 PORT TLMVIEWER_API 7778
 PORT CTS_PREIDENTIFIED 7779
 PORT CTS_CMD_ROUTER 7780
+PORT REPLAY_API 7877
+PORT REPLAY_PREIDENTIFIED 7879
+PORT REPLAY_CMD_ROUTER 7880
+PORT DART_STREAM 8777
+PORT DART_DECOM 8779
+PORT DART_MASTER 8780
 
 # Default Packet Log Writer and Reader
 DEFAULT_PACKET_LOG_WRITER packet_log_writer.rb
@@ -38,6 +57,9 @@ PATH SAVED_CONFIG ./outputs/saved_config
 PATH TABLES ./outputs/tables
 PATH HANDBOOKS ./outputs/handbooks
 PATH PROCEDURES ./procedures
+PATH SEQUENCES ./outputs/sequences
+PATH DART_DATA ./outputs/dart/data
+PATH DART_LOGS ./outputs/dart/logs
 
 ALLOW_ACCESS ALL
 
@@ -48,4 +70,21 @@ ENABLE_SOUND
 # Initialize the metadata dialog using values from the following file:
 META_INIT config/data/meta_init.txt
 
-ADD_MD5_FILE lib/user_version.rb
+ADD_HASH_FILE lib/user_version.rb
+
+# Banner examples
+# Create a banner using an existing COSMOS color (Cosmos::GREEN in this case)
+# CLASSIFICATION UNCLASSIFIED green
+
+# Create a banner using a Qt::Color that doesn't exist in COSMOS
+# CLASSIFICATION "Ball Aerospace COSMOS" teal
+
+# Create a banner using a RGB color values
+# CLASSIFICATION Secret 255 114 0
+
+# ALLOW_ROUTER_COMMANDING # Enable this to chain servers with commanding
+# ALLOW_HOST localhost:7777 # This is provided by default.  Add with HostIP:7777 for chaining
+# ALLOW_ORIGIN 1.2.3.4:8080 # Add this if you have a webserver that should be able to access the COSMOS API
+
+# *** IMPORTANT *** Change this value to a unique value for each project
+X_CSRF_TOKEN SuperSecret # Secret used to secure requests - Change for each project

data/demo/config/system/system2.txt

@@ -8,22 +8,41 @@ DECLARE_TARGET EXAMPLE
 DECLARE_TARGET SYSTEM
 
 # Listen Hosts - Ip addresses or hostnames to listen on when running the tools
+# Set these to 0.0.0.0 if you need external connections from other computers
 LISTEN_HOST CTS_API 127.0.0.1
 LISTEN_HOST TLMVIEWER_API 127.0.0.1
-LISTEN_HOST CTS_PREIDENTIFIED 0.0.0.0 # 127.0.0.1 is more secure if you don't need external connections
-LISTEN_HOST CTS_CMD_ROUTER 0.0.0.0 # 127.0.0.1 is more secure if you don't need external connections
+LISTEN_HOST CTS_PREIDENTIFIED 127.0.0.1
+LISTEN_HOST CTS_CMD_ROUTER 127.0.0.1
+LISTEN_HOST REPLAY_API 127.0.0.1
+LISTEN_HOST REPLAY_PREIDENTIFIED 127.0.0.1
+LISTEN_HOST REPLAY_CMD_ROUTER 127.0.0.1
+LISTEN_HOST DART_STREAM 127.0.0.1
+LISTEN_HOST DART_DECOM 127.0.0.1
+LISTEN_HOST DART_MASTER 127.0.0.1
 
 # Connect Hosts - Ip addresses or hostnames to connect to when running the tools
 CONNECT_HOST CTS_API 127.0.0.1
 CONNECT_HOST TLMVIEWER_API 127.0.0.1
 CONNECT_HOST CTS_PREIDENTIFIED 127.0.0.1
 CONNECT_HOST CTS_CMD_ROUTER 127.0.0.1
+CONNECT_HOST REPLAY_API 127.0.0.1
+CONNECT_HOST REPLAY_PREIDENTIFIED 127.0.0.1
+CONNECT_HOST REPLAY_CMD_ROUTER 127.0.0.1
+CONNECT_HOST DART_STREAM 127.0.0.1
+CONNECT_HOST DART_DECOM 127.0.0.1
+CONNECT_HOST DART_MASTER 127.0.0.1
 
 # Ethernet Ports
-PORT CTS_API 8777
-PORT TLMVIEWER_API 8778
-PORT CTS_PREIDENTIFIED 8779
+PORT CTS_API 7777
+PORT TLMVIEWER_API 7778
+PORT CTS_PREIDENTIFIED 7779
 PORT CTS_CMD_ROUTER 7780
+PORT REPLAY_API 7877
+PORT REPLAY_PREIDENTIFIED 7879
+PORT REPLAY_CMD_ROUTER 7880
+PORT DART_STREAM 8777
+PORT DART_DECOM 8779
+PORT DART_DECOM 8780
 
 # Default Packet Log Writer and Reader
 DEFAULT_PACKET_LOG_WRITER packet_log_writer.rb
@@ -36,6 +55,9 @@ PATH SAVED_CONFIG ./outputs/saved_config
 PATH TABLES ./outputs/tables
 PATH HANDBOOKS ./outputs/handbooks
 PATH PROCEDURES ./procedures
+PATH SEQUENCES ./outputs/sequences
+PATH DART_DATA ./outputs/dart/data
+PATH DART_LOGS ./outputs/dart/logs
 
 ALLOW_ACCESS ALL
 
@@ -44,3 +66,10 @@ ALLOW_ACCESS ALL
 
 # Initialize the metadata dialog using values from the following file:
 # META_INIT config/data/meta_init.txt
+
+# ALLOW_ROUTER_COMMANDING # Enable this to chain servers with commanding
+# ALLOW_HOST localhost:7777 # This is provided by default.  Add with HostIP:7777 for chaining
+# ALLOW_ORIGIN 1.2.3.4:8080 # Add this if you have a webserver that should be able to access the COSMOS API
+
+# *** IMPORTANT *** Change this value to a unique value for each project
+X_CSRF_TOKEN SuperSecret # Secret used to secure requests - Change for each project

data/demo/config/system/system_alt_ports.txt

@@ -0,0 +1,80 @@
+# Declare Targets that make up the system
+# DECLARE_TARGET target_name [substitute_name]
+
+# AUTO_DECLARE_TARGETS
+DECLARE_TARGET INST
+DECLARE_TARGET INST INST2
+DECLARE_TARGET EXAMPLE
+DECLARE_TARGET TEMPLATED
+DECLARE_TARGET DART
+DECLARE_TARGET SYSTEM
+
+# Listen Hosts - Ip addresses or hostnames to listen on when running the tools
+# Set these to 0.0.0.0 if you need external connections from other computers
+LISTEN_HOST CTS_API 127.0.0.1
+LISTEN_HOST TLMVIEWER_API 127.0.0.1
+LISTEN_HOST CTS_PREIDENTIFIED 127.0.0.1
+LISTEN_HOST CTS_CMD_ROUTER 127.0.0.1
+LISTEN_HOST REPLAY_API 127.0.0.1
+LISTEN_HOST REPLAY_PREIDENTIFIED 127.0.0.1
+LISTEN_HOST REPLAY_CMD_ROUTER 127.0.0.1
+LISTEN_HOST DART_STREAM 127.0.0.1
+LISTEN_HOST DART_DECOM 127.0.0.1
+LISTEN_HOST DART_MASTER 127.0.0.1
+
+# Connect Hosts - Ip addresses or hostnames to connect to when running the tools
+CONNECT_HOST CTS_API 127.0.0.1
+CONNECT_HOST TLMVIEWER_API 127.0.0.1
+CONNECT_HOST CTS_PREIDENTIFIED 127.0.0.1
+CONNECT_HOST CTS_CMD_ROUTER 127.0.0.1
+CONNECT_HOST REPLAY_API 127.0.0.1
+CONNECT_HOST REPLAY_PREIDENTIFIED 127.0.0.1
+CONNECT_HOST REPLAY_CMD_ROUTER 127.0.0.1
+CONNECT_HOST DART_STREAM 127.0.0.1
+CONNECT_HOST DART_DECOM 127.0.0.1
+CONNECT_HOST DART_MASTER 127.0.0.1
+
+# Ethernet Ports
+PORT CTS_API 9777
+PORT TLMVIEWER_API 9778
+PORT CTS_PREIDENTIFIED 9779
+PORT CTS_CMD_ROUTER 9780
+PORT REPLAY_API 9877
+PORT REPLAY_PREIDENTIFIED 9879
+PORT REPLAY_CMD_ROUTER 9880
+PORT DART_STREAM 10777
+PORT DART_DECOM 10779
+PORT DART_MASTER 10780
+
+# Default Packet Log Writer and Reader
+DEFAULT_PACKET_LOG_WRITER packet_log_writer.rb
+DEFAULT_PACKET_LOG_READER packet_log_reader.rb
+
+# Paths
+PATH LOGS ./outputs/logs
+PATH TMP ./outputs/tmp
+PATH SAVED_CONFIG ./outputs/saved_config
+PATH TABLES ./outputs/tables
+PATH HANDBOOKS ./outputs/handbooks
+PATH PROCEDURES ./procedures
+PATH SEQUENCES ./outputs/sequences
+PATH DART_DATA ./outputs/dart/data
+PATH DART_LOGS ./outputs/dart/logs
+
+ALLOW_ACCESS ALL
+
+ENABLE_SOUND
+# DISABLE_DNS
+# STALENESS_SECONDS 30
+
+# Initialize the metadata dialog using values from the following file:
+META_INIT config/data/meta_init.txt
+
+ADD_HASH_FILE lib/user_version.rb
+
+# ALLOW_ROUTER_COMMANDING # Enable this to chain servers with commanding
+# ALLOW_HOST localhost:7777 # This is provided by default.  Add with HostIP:7777 for chaining
+# ALLOW_ORIGIN 1.2.3.4:8080 # Add this if you have a webserver that should be able to access the COSMOS API
+
+# *** IMPORTANT *** Change this value to a unique value for each project
+X_CSRF_TOKEN SuperSecret # Secret used to secure requests - Change for each project

data/demo/config/targets/EXAMPLE/cmd_tlm_server.txt

@@ -4,3 +4,4 @@
 INTERFACE EXAMPLE_INT example_interface.rb localhost 9999
   TARGET EXAMPLE
   DONT_CONNECT
+  LOG_RAW

data/demo/config/targets/INST/cmd_tlm/inst_cmds.txt

@@ -8,7 +8,7 @@ COMMAND INST COLLECT BIG_ENDIAN "Starts a collect on the <%= @target_name %> tar
   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 Celcius C
+    UNITS Celsius C
 
 COMMAND INST ABORT BIG_ENDIAN "Aborts a collect on the <%= @target_name %> instrument"
   <%= render "_ccsds_cmd.txt", locals: {id: 2} %>
@@ -26,7 +26,7 @@ COMMAND INST SETPARAMS BIG_ENDIAN "Sets numbered parameters"
 
   # New more flexible ERB syntax:
   <% (1..5).each do |i| %>
-    APPEND_PARAMETER VALUE<%= i %> 16 UINT 0 5 0 "Value <%= i %> setting"
+    APPEND_PARAMETER VALUE<%= i %> 16 UINT 0 5 1 "Value <%= i %> setting"
   <% end %>
 
   SELECT_PARAMETER VALUE5
@@ -34,11 +34,12 @@ COMMAND INST SETPARAMS BIG_ENDIAN "Sets numbered parameters"
 
 COMMAND INST ASCIICMD BIG_ENDIAN "Enumerated ASCII command"
   <%= render "_ccsds_cmd.txt", locals: {id: 5} %>
-  PARAMETER    STRING         64  2048 STRING "NOOP"    "Enumerated string parameter"
+  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 "ARM LASER" "ARM LASER" HAZARDOUS "Arming the laser poses an eye safety hazard so anyone without laser safety training needs to leave."
     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 INST FLTCMD BIG_ENDIAN "Command with float parameters"
   <%= render "_ccsds_cmd.txt", locals: {id: 6} %>

data/demo/config/targets/INST/cmd_tlm/inst_tlm.txt

@@ -4,29 +4,29 @@ TELEMETRY INST HEALTH_STATUS BIG_ENDIAN "Health and status from the <%= @target_
   APPEND_ITEM TEMP1            16 UINT     "Temperature #1"
     POLY_READ_CONVERSION  -100.0 0.00305
     POLY_WRITE_CONVERSION 32768.885246 327.86885
-    UNITS CELCIUS C
+    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 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 CELCIUS C
+    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 CELCIUS C
+    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 CELCIUS C
+    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"
@@ -35,8 +35,9 @@ TELEMETRY INST HEALTH_STATUS BIG_ENDIAN "Health and status from the <%= @target_
   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 CELCIUS C
+    UNITS CELSIUS C
   APPEND_ITEM ASCIICMD 2048 STRING "Most recent ASCIICMD string"
     STATE "NOOP" "NOOP"
     STATE "FIRE LASER" "FIRE LASER"
@@ -138,7 +139,10 @@ TELEMETRY INST PARAMS BIG_ENDIAN "Params set by SETPARAMS command"
 
 TELEMETRY INST IMAGE BIG_ENDIAN "Packet with image data"
   <%= render "_ccsds_tlm.txt", locals: {apid: 4} %>
-  ITEM IMAGE            128 800 BLOCK   "10x10 Image Data"
+  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'
@@ -147,6 +151,7 @@ TELEMETRY INST IMAGE BIG_ENDIAN "Packet with image data"
 
 TELEMETRY INST 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"

data/demo/config/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 INST 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

data/demo/config/targets/INST/cmd_tlm_server.txt

@@ -4,3 +4,5 @@
 INTERFACE INST_INT simulated_target_interface.rb sim_inst.rb
   TARGET INST
   PROTOCOL READ OverrideProtocol
+  # This will ignore all received ADCS packets
+  #PROTOCOL READ IgnorePacketProtocol INST ADCS

data/demo/config/targets/INST/lib/sim_inst.rb

@@ -13,9 +13,9 @@
 require 'cosmos'
 
 module Cosmos
-
+  # Simulated instrument for the demo. Populates several packets and cycles
+  # the telemetry to simulate an active target.
   class SimInst < SimulatedTarget
-
     SOLAR_PANEL_DFLTS = [-179.0, 179.0, -179.0, 179.0, -95.0] unless defined? SOLAR_PANEL_DFLTS
 
     def initialize(target_name)
@@ -80,6 +80,11 @@ module Cosmos
       packet.enable_method_missing
       packet.CcsdsSeqFlags = 'NOGROUP'
       packet.CcsdsLength = packet.buffer.length - 7
+      packet.value1 = 0
+      packet.value2 = 1
+      packet.value3 = 2
+      packet.value4 = 1
+      packet.value5 = 0
 
       packet = @tlm_packets['IMAGE']
       packet.enable_method_missing
@@ -296,6 +301,11 @@ module Cosmos
         when 'IMAGE'
           packet.timesec = time.tv_sec
           packet.timeus = time.tv_usec
+          # Create an Array the size of the packet and then initialize
+          # using a sample of all possible hex values (0..15)
+          # finally pack it into binary using the Character 'C' specifier
+          data = Array.new(packet.image.length) { Array(0..15).sample }.pack("C*")
+          packet.image = data
           packet.ccsdsseqcnt += 1
 
         when 'MECH'
@@ -310,7 +320,9 @@ module Cosmos
         end
       end
 
-      pending_packets << Packet.new(nil, nil, :BIG_ENDIAN, nil, "\000" * 10) if @get_count == 300
+      # Every 10s throw an unknown packet at the server just to demo that
+      data = Array.new(10) { rand(0..255) }.pack("C*")
+      pending_packets << Packet.new(nil, nil, :BIG_ENDIAN, nil, data) if @get_count % 1000 == 0
 
       @get_count += 1
       pending_packets

data/demo/config/targets/INST/screens/adcs.txt

@@ -1,8 +1,7 @@
 SCREEN AUTO AUTO 1.0 FIXED
 
 VERTICAL
-
-  TITLE "<%= @target_name %> Instrument ADCS Information"
+  TITLE "<%= @target_name %> Instrument ADCS Information" Courier 20 NORMAL true
   # Note @original_target_name is also available
 
   HORIZONTAL
@@ -46,6 +45,7 @@ VERTICAL
 
       LABELPROGRESSBAR INST ADCS POSPROGRESS
       LABELPROGRESSBAR INST ADCS ATTPROGRESS
+      LABELPROGRESSBAR INST ADCS ATTPROGRESS 2 60 RAW # scale by 2
 
       LABEL ""
       LABEL "LEFT"

data/demo/config/targets/INST/screens/block.txt

@@ -2,7 +2,7 @@ SCREEN AUTO AUTO 1.0
 
 VERTICAL
   TITLE "<%= @target_name %> Instrument Block Data"
-  BLOCK INST IMAGE IMAGE 500 200 "%02X" 4 4 "0x%08X:"
+  BLOCK INST IMAGE IMAGE 500 600 "%02X" 4 4 "0x%08X:"
 END
 
 

data/demo/config/targets/INST/screens/commanding.txt

@@ -36,7 +36,7 @@ VERTICAL
     # Here as an example we're using the BACKGROUNDBUTTON which runs all the code in the background.
     # Note we didn't need to use this here but it's an example of wrapping calls to the GUI in Qt.execute_in_main_thread.
     # You need to use this button if your code blocks or takes a long time to execute so you don't hang the screen.
-    BACKGROUNDBUTTON 'Run Script' 'Cosmos.run_process("#{Cosmos::USERPATH}/tools/ScriptRunner -r #{Qt.execute_in_main_thread { get_named_widget("SCRIPTNAME").text }}")'
+    BACKGROUNDBUTTON 'Run Script' 'script = ""; Qt.execute_in_main_thread { script = get_named_widget("SCRIPTNAME").text }; Cosmos.run_cosmos_tool("ScriptRunner", "-r #{script}")'
   END
   SETTING BACKCOLOR 163 185 163
 END

data/demo/config/targets/INST/screens/ground.txt

@@ -2,24 +2,46 @@ SCREEN AUTO AUTO 1.0
 
 VERTICAL
 SETTING BACKCOLOR white
-
   TITLE "<%= @target_name %> Instrument Ground Station Status"
   SETTING BACKCOLOR white
 
-  CANVAS 650 594
+  CANVAS 650 700
+    # The code inside <% %> is just ruby
+    <% 11.times do |x| %>
+      # Create a dot at various y locations. The <%= %> adds the expression to the file
+      CANVASDOT 5 <%= 50 * x + 50 %> BLUE 5
+    <% end %> # Close our block from above
+    # This is an example of using TLM_AND to && together different logical values
+    # Note you must use RAW for the base value and use SETTING IMAGE true / false
+    # for the two values you wish to display
+    #CANVASIMAGEVALUE INST HEALTH_STATUS GROUND1STATUS
+    #  SETTING TLM_AND INST HEALTH_STATUS GROUND2STATUS VALUE_EQ 1
+    #  SETTING TLM_AND INST HEALTH_STATUS COLLECTS VALUE_EQ 0
+    #  SETTING IMAGE true "ground_on.gif" 100 200
+    #  SETTING IMAGE false "ground_off.gif" 100 200
     CANVASLINE 10 10 640 10 blue 3
     CANVASIMAGE "satellite.gif" 50 150
-    CANVASIMAGEVALUE INST HEALTH_STATUS GROUND1STATUS "ground" 400 100
+    # We're using the converted value and specifing a default of "ground_error.gif"
+    # if none of the IMAGE settings match the value
+    CANVASIMAGEVALUE INST HEALTH_STATUS GROUND1STATUS CONVERTED "ground_error.gif" 400 100
+      SETTING IMAGE CONNECTED "ground_on.gif" 400 100
+      SETTING IMAGE UNAVAILABLE "ground_off.gif" 400 100
+      # If the image is clicked the "INST HS" screen will popup at 100, 100
+      SETTING SCREEN "INST HS" 100 100
     CANVASLABEL 380 300 "Ground Station #1"
     CANVASLABELVALUE INST HEALTH_STATUS GROUND1STATUS 520 300
-    CANVASIMAGEVALUE INST HEALTH_STATUS GROUND2STATUS "ground" 400 350
+    # The default type is RAW and no default means anything over 10 will be blank
+    CANVASIMAGEVALUE INST HEALTH_STATUS GROUND2STATUS
+      SETTING IMAGE 1 "ground_on.gif" 400 350
+      SETTING IMAGE 0 "ground_off.gif" 400 350
+      # This is an example of using a range of values with a particular image
+      SETTING IMAGE 2..10 "ground_error.gif" 400 350
     CANVASLABEL 380 550 "Ground Station #2"
     CANVASLABELVALUE INST HEALTH_STATUS GROUND2STATUS 520 550
     CANVASLINEVALUE INST HEALTH_STATUS GROUND1STATUS 420 135 240 330 green white 3
     CANVASLINEVALUE INST HEALTH_STATUS GROUND2STATUS 420 385 240 330 green white 3
     CANVASLINE 10 584 640 584 blue 3
   END
-
 END