cosmos 4.3.0 → 4.4.0

data/demo/Gemfile

@@ -2,7 +2,7 @@
 
 source 'https://rubygems.org'
 
-gem 'ruby-termios', '~> 0.9' if RbConfig::CONFIG['target_os'] !~ /mswin|mingw|cygwin/i and RUBY_ENGINE=='ruby'
+gem 'ruby-termios', '>= 0.9' if RbConfig::CONFIG['target_os'] !~ /mswin|mingw|cygwin/i and RUBY_ENGINE=='ruby'
 if ENV['COSMOS_DEVEL']
   gem 'cosmos', :path => ENV['COSMOS_DEVEL']
 else

data/demo/Launcher.bat

@@ -1,9 +1 @@
-@ECHO OFF
-
-IF NOT EXIST "%~dp0tools\ToolLaunch.bat" (
-  echo "%~dp0tools\ToolLaunch.bat" does not exist
-  pause
-  exit /b
-)
-
-call "%~dp0tools\ToolLaunch.bat" rubyw.exe %~n0 %*
+call tools\Launcher.bat --config launcher.txt

data/demo/Launcher2.bat

@@ -0,0 +1 @@
+call tools\Launcher.bat --config launcher2.txt --system system2.txt

data/demo/LauncherMini.bat

@@ -0,0 +1 @@
+call tools\Launcher.bat --config launcher_mini.txt --mini

data/demo/config/data/crc.txt

@@ -1,6 +1,6 @@
 "lib/scpi_target.rb" 0x6C94AB0D
 "lib/cmd_sequence_exporter.rb" 0xC16CA178
-"lib/example_background_task.rb" 0xC4D1FF08
+"lib/example_background_task.rb" 0x819D1A2F
 "lib/example_target.rb" 0x50EC8E71
 "lib/user_version.rb" 0x8F282EE9
 "config/targets/DART/target.txt" 0x6648EE0E
@@ -27,19 +27,24 @@
 "config/targets/INST/target.txt" 0x0CA2BFF2
 "config/targets/INST/screens/hs.txt" 0xFCCE1760
 "config/targets/INST/screens/graphs.txt" 0xE93FAC76
-"config/targets/INST/screens/commanding.txt" 0xF7DEBD49
+"config/targets/INST/screens/commanding.txt" 0x3C866E3E
 "config/targets/INST/screens/array.txt" 0x9DC68022
+"config/targets/INST/screens/satellite.gif" 0x26888D25
 "config/targets/INST/screens/_footer.txt" 0xB6C0BC08
+"config/targets/INST/screens/ground_on.gif" 0x97D9A501
 "config/targets/INST/screens/spacing_box.txt" 0xEAB60B6D
 "config/targets/INST/screens/latest.txt" 0xA85B5BEC
-"config/targets/INST/screens/limits.txt" 0x3CFF7821
-"config/targets/INST/screens/ground.txt" 0xD9122BC3
-"config/targets/INST/screens/block.txt" 0x0A6416BE
-"config/targets/INST/screens/adcs.txt" 0xB0145452
+"config/targets/INST/screens/limits.txt" 0x36688AB1
+"config/targets/INST/screens/ground.txt" 0x5F35A0A2
+"config/targets/INST/screens/block.txt" 0x8C5C275E
+"config/targets/INST/screens/adcs.txt" 0x66373AAD
 "config/targets/INST/screens/spacing_grid.txt" 0x3F3738B9
-"config/targets/INST/screens/other.txt" 0xE6368E49
+"config/targets/INST/screens/params.txt" 0x15D67280
+"config/targets/INST/screens/other.txt" 0x362321C5
+"config/targets/INST/screens/ground_off.gif" 0x7BA45A4D
 "config/targets/INST/screens/tabs.txt" 0x576606A8
-"config/targets/INST/cmd_tlm_server.txt" 0x73AB06BE
+"config/targets/INST/screens/ground_error.gif" 0xE2567D15
+"config/targets/INST/cmd_tlm_server.txt" 0x2A52A15A
 "config/targets/INST/procedures/collect.rb" 0xD4CDF449
 "config/targets/INST/procedures/disconnect.rb" 0x5F3A18E5
 "config/targets/INST/procedures/checks.rb" 0x34EEF3E2
@@ -54,22 +59,21 @@
 "config/targets/INST/tools/table_manager/McConfigTable_def.txt" 0x5B6FA631
 "config/targets/INST/tools/data_viewer/data_viewer2.txt" 0x7FFA3A8A
 "config/targets/INST/tools/data_viewer/data_viewer.txt" 0xB25E2644
-"config/targets/INST/cmd_tlm/inst_tlm.txt" 0x83356727
+"config/targets/INST/cmd_tlm/inst_tlm.txt" 0x0C5E74D8
 "config/targets/INST/cmd_tlm/_ccsds_tlm.txt" 0xE833D935
-"config/targets/INST/cmd_tlm/inst_cmds.txt" 0x7E5C780F
+"config/targets/INST/cmd_tlm/inst_cmds.txt" 0x90C6205D
 "config/targets/INST/cmd_tlm/_ccsds_cmd.txt" 0x7F5572F3
 "config/targets/INST/lib/example_limits_response.rb" 0xB4A746B1
 "config/targets/INST/lib/inst_dump_component.rb" 0x709905AE
-"config/targets/INST/lib/sim_inst.rb" 0x9A93AE49
+"config/targets/INST/lib/sim_inst.rb" 0xF1537547
 "config/targets/EXAMPLE/target.txt" 0xC3682EBF
-"config/targets/EXAMPLE/cmd_tlm_server.txt" 0x6139204A
+"config/targets/EXAMPLE/cmd_tlm_server.txt" 0x069113F0
 "config/targets/EXAMPLE/cmd_tlm/example_tlm.txt" 0x65BF425A
 "config/targets/EXAMPLE/cmd_tlm/example_cmds.txt" 0xB1A6D401
 "config/targets/EXAMPLE/lib/example_interface.rb" 0x87C1C9E0
 "config/data/satellite.gif" 0x26888D25
 "config/data/poweroff.gif" 0xF67A83D3
 "config/data/meta_init.txt" 0x1B132ACE
-"config/data/groundoff.gif" 0x7BA45A4D
 "config/data/poweron.gif" 0x137C8043
 "config/data/hselecton.gif" 0xA824E4FC
 "config/data/vswitchoff.gif" 0xFAE436C9
@@ -80,10 +84,9 @@
 "config/data/hswitchoff.gif" 0xB051B6A3
 "config/data/tada.wav" 0x1ABCFFD1
 "config/data/hselectoff.gif" 0x8A0C192E
-"config/data/groundon.gif" 0x97D9A501
 "config/data/vswitchon.gif" 0xD747AC45
-"config/system/system_alt_ports.txt" 0xB5D194B0
-"config/system/system.txt" 0x84099B85
+"config/system/system_alt_ports.txt" 0x875FB695
+"config/system/system.txt" 0xBC31B9A9
 "config/system/system2.txt" 0x52BFC433
 "config/tools/launcher/launcher2.css" 0x69DA47AB
 "config/tools/launcher/launcher.txt" 0x7060F202
@@ -99,8 +102,8 @@
 "config/tools/table_manager/TLMMonitoringTable_def.txt" 0xF8136D31
 "config/tools/cmd_sequence/cmd_sequence.txt" 0x5F06901D
 "config/tools/tlm_viewer/tlm_viewer.txt" 0x6E6DBC7A
-"config/tools/data_viewer/data_viewer.txt" 0xC62699E8
-"config/tools/test_runner/test_runner.txt" 0x7987DB88
+"config/tools/data_viewer/data_viewer.txt" 0x4A1816FD
+"config/tools/test_runner/test_runner.txt" 0x54608E08
 "config/tools/test_runner/test_runner.css" 0x06987062
 "config/tools/tlm_extractor/tlm_extractor4.txt" 0x068824C2
 "config/tools/tlm_extractor/tlm_extractor3.txt" 0x475006AA
@@ -113,6 +116,22 @@
 "config/tools/tlm_grapher/README.txt" 0x93B2C07E
 "config/tools/opengl_builder/README.txt" 0x93B2C07E
 "config/tools/limits_monitor/README.txt" 0x93B2C07E
+"config/tools/handbook_creator/assets/js/bootstrap.min.js" 0xB3ECDABF
+"config/tools/handbook_creator/assets/js/respond.min.js" 0xD9168C21
+"config/tools/handbook_creator/assets/js/html5shiv.js" 0x15B5CD4D
+"config/tools/handbook_creator/assets/js/jquery-1.10.2.min.js" 0xCDB86103
+"config/tools/handbook_creator/assets/js/bootstrap.js" 0x013B0300
+"config/tools/handbook_creator/assets/css/bootstrap-theme.css" 0x446F3211
+"config/tools/handbook_creator/assets/css/bootstrap.min.css" 0x1BD3585F
+"config/tools/handbook_creator/assets/css/bootstrap.css" 0x3F240B56
+"config/tools/handbook_creator/assets/css/bootstrap-theme.min.css" 0xB49F966D
+"config/tools/handbook_creator/assets/img/ball_logo.jpg" 0xA15FB300
+"config/tools/handbook_creator/assets/img/ball_logo.gif" 0xD8A3D76B
+"config/tools/handbook_creator/assets/img/ball_logo.bmp" 0xAD799C2E
+"config/tools/handbook_creator/assets/fonts/glyphicons-halflings-regular.svg" 0x068A502C
+"config/tools/handbook_creator/assets/fonts/glyphicons-halflings-regular.ttf" 0x063128D6
+"config/tools/handbook_creator/assets/fonts/glyphicons-halflings-regular.woff" 0x946BFB8C
+"config/tools/handbook_creator/assets/fonts/glyphicons-halflings-regular.eot" 0x50687BA4
 "config/tools/handbook_creator/templates/header.html.erb" 0x1E490C2A
 "config/tools/handbook_creator/templates/command_toc.html.erb" 0x9159BCF9
 "config/tools/handbook_creator/templates/footer.html.erb" 0x0E1F9800
@@ -128,7 +147,7 @@
 "config/tools/handbook_creator/templates/pdf_header.html.erb" 0x3020FEE1
 "config/tools/handbook_creator/default_toc.xsl" 0x4122A040
 "config/tools/handbook_creator/handbook_creator.txt" 0xAA806C94
-"config/tools/script_runner/script_runner.txt" 0x1EECD803
+"config/tools/script_runner/script_runner.txt" 0x10A9AF8F
 "config/dart/Gemfile" 0x294591DB
 "tools/TlmExtractor.bat" 0x2B98E027
 "tools/Launcher" 0xFD4E356C
@@ -264,10 +283,11 @@
 "tools/CmdExtractor" 0x96E82AC3
 "tools/OpenGLBuilder" 0x585EA691
 "tools/CmdSender.bat" 0x2B98E027
-"procedures/cosmos_api_test.rb" 0x9D13FFA3
+"procedures/cosmos_api_test.rb" 0xB6C2B579
 "procedures/example_test.rb" 0xEB8B8E79
 "procedures/test.rb" 0xCE4DA55A
 "procedures/replay_test.rb" 0xBB4D6A36
 "procedures/plot_test.rb" 0xF311D562
 "procedures/run_example_test.rb" 0x0F244140
 "procedures/local_screen_example.rb" 0x677D2019
+"procedures/interactive.rb" 0x006A7BD5

data/demo/config/system/system.txt

@@ -66,7 +66,7 @@ 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)

data/demo/config/system/system_alt_ports.txt

@@ -66,4 +66,4 @@ 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

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} %>
@@ -39,6 +39,7 @@ COMMAND INST ASCIICMD BIG_ENDIAN "Enumerated ASCII command"
     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 STRING 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"
@@ -37,7 +37,7 @@ TELEMETRY INST HEALTH_STATUS BIG_ENDIAN "Health and status from the <%= @target_
     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"
@@ -139,7 +139,7 @@ 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 IMAGE 128 131072 BLOCK   "10x10 Image 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'

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.length) { Array(0..15).sample }.pack("C*")
+          packet.buffer = 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
 
 

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

@@ -2,42 +2,80 @@ SCREEN AUTO AUTO 1.0
 
 TITLE "<%= @target_name %> Instrument Limits"
 
-VERTICALBOX
-  SECTIONHEADER "Range Bars 0-100"
-  RANGEBAR INST HEALTH_STATUS TEMP2 0 100
-  VALUERANGEBAR INST HEALTH_STATUS TEMP2 0 100
-  LABELVALUERANGEBAR INST HEALTH_STATUS TEMP2 0 100
-END
-
-VERTICALBOX
-  SECTIONHEADER "Limits Bars"
-  LIMITSBAR INST HEALTH_STATUS TEMP2
-  VALUELIMITSBAR INST HEALTH_STATUS TEMP2
-  LABELVALUELIMITSBAR INST HEALTH_STATUS TEMP2
-END
-
-VERTICALBOX
-  SECTIONHEADER "Range Columns 0-100"
-  HORIZONTAL
-    RANGECOLUMN INST HEALTH_STATUS TEMP2 0 100
-    VALUERANGECOLUMN INST HEALTH_STATUS TEMP2 0 100
-    LABELVALUERANGECOLUMN INST HEALTH_STATUS TEMP2 0 100
+HORIZONTAL
+  VERTICALBOX
+    SECTIONHEADER "Limits Bars"
+    LIMITSBAR INST HEALTH_STATUS TEMP1
+    VALUELIMITSBAR INST HEALTH_STATUS TEMP1
+    LABELVALUELIMITSBAR INST HEALTH_STATUS TEMP1
+    # The TEMP1 limits are defined as follow:
+    # LIMITS DEFAULT 1 ENABLED -80.0 -70.0 60.0 80.0 -20.0 20.0
+    # Thus the following are examples of limiting the limitsbar
+    LABELVALUELIMITSBAR INST HEALTH_STATUS TEMP1
+      SUBSETTING 1 MIN_VALUE -80
+      SUBSETTING 1 MAX_VALUE 80
+    LABELVALUELIMITSBAR INST HEALTH_STATUS TEMP1
+      SUBSETTING 1 MIN_VALUE -75
+      SUBSETTING 1 MAX_VALUE 70
+    LABELVALUELIMITSBAR INST HEALTH_STATUS TEMP1
+      SUBSETTING 1 MIN_VALUE -70
+      SUBSETTING 1 MAX_VALUE 60
+    LABELVALUELIMITSBAR INST HEALTH_STATUS TEMP1
+      SUBSETTING 1 MIN_VALUE -50
+      SUBSETTING 1 MAX_VALUE 50
+    LABELVALUELIMITSBAR INST HEALTH_STATUS TEMP1
+      SUBSETTING 1 MIN_VALUE -20
+      SUBSETTING 1 MAX_VALUE 20
+    LABELVALUELIMITSBAR INST HEALTH_STATUS TEMP1
+      SUBSETTING 1 MIN_VALUE -10
+      SUBSETTING 1 MAX_VALUE 10
+  END
+  VERTICAL
+    VERTICALBOX
+      SECTIONHEADER "Range Bars 0-100"
+      RANGEBAR INST HEALTH_STATUS TEMP2 0 100
+      VALUERANGEBAR INST HEALTH_STATUS TEMP2 0 100
+      LABELVALUERANGEBAR INST HEALTH_STATUS TEMP2 0 100
+    END
+    VERTICALBOX
+      SECTIONHEADER "Limits Colors"
+      LIMITSCOLOR INST HEALTH_STATUS TEMP1 CONVERTED 5 NIL # No label
+      LIMITSCOLOR INST HEALTH_STATUS TEMP2 # Default is label with just item name
+      LIMITSCOLOR INST HEALTH_STATUS GROUND1STATUS CONVERTED 5 TRUE # Full TGT/PKT/ITEM label
+    END
   END
 END
 
-VERTICALBOX
-  SECTIONHEADER "Limits Columns"
-  HORIZONTAL
-    LIMITSCOLUMN INST HEALTH_STATUS TEMP2
-    VALUELIMITSCOLUMN INST HEALTH_STATUS TEMP2
-    LABELVALUELIMITSCOLUMN INST HEALTH_STATUS TEMP2
+HORIZONTAL
+  VERTICALBOX
+    SECTIONHEADER "Limits Columns"
+    HORIZONTAL
+      LIMITSCOLUMN INST HEALTH_STATUS TEMP2
+      VALUELIMITSCOLUMN INST HEALTH_STATUS TEMP2
+      LABELVALUELIMITSCOLUMN INST HEALTH_STATUS TEMP2 WITH_UNITS 8
+      # The TEMP2 limits are defined as follow:
+      # LIMITS DEFAULT 1 ENABLED -60.0 -55.0 30.0 35.0
+      # Thus the following are examples of limiting the limitscolumn
+      LABELVALUELIMITSCOLUMN INST HEALTH_STATUS TEMP2 WITH_UNITS 8
+        SUBSETTING 1 MIN_VALUE -60
+        SUBSETTING 1 MAX_VALUE 35
+      LABELVALUELIMITSCOLUMN INST HEALTH_STATUS TEMP2 WITH_UNITS 8
+        SUBSETTING 1 MIN_VALUE -55
+        SUBSETTING 1 MAX_VALUE 30
+      LABELVALUELIMITSCOLUMN INST HEALTH_STATUS TEMP2 WITH_UNITS 8
+        SUBSETTING 1 MIN_VALUE -20
+        SUBSETTING 1 MAX_VALUE 10
+    END
   END
-END
 
-VERTICALBOX
-  SECTIONHEADER "Limits Colors"
-  LIMITSCOLOR INST HEALTH_STATUS TEMP2
-  LIMITSCOLOR INST HEALTH_STATUS GROUND1STATUS CONVERTED 5 TRUE
+  VERTICALBOX
+    SECTIONHEADER "Range Columns 0-100"
+    HORIZONTAL
+      RANGECOLUMN INST HEALTH_STATUS TEMP2 0 100
+      VALUERANGECOLUMN INST HEALTH_STATUS TEMP2 0 100
+      LABELVALUERANGECOLUMN INST HEALTH_STATUS TEMP2 0 100
+    END
+  END
 END
 
 <%= render "_footer.txt" %>