openc3-cosmos-tool-docs 5.12.0

data/tools/docs/assets/js/aa6b6c1b.6b24256f.js

@@ -0,0 +1 @@
+"use strict";(self.webpackChunkdocs_openc3_com=self.webpackChunkdocs_openc3_com||[]).push([[3940],{1106:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>p,contentTitle:()=>m,default:()=>d,frontMatter:()=>l,metadata:()=>i,toc:()=>o});var n=a(7896),r=(a(2784),a(876));const l={title:"Scripting API Guide"},m=void 0,i={unversionedId:"guides/scripting-api",id:"guides/scripting-api",title:"Scripting API Guide",description:"This document provides the information necessary to write test procedures using the COSMOS scripting API. Scripting in COSMOS is designed to be simple and intuitive. The code completion ability for command and telemetry mnemonics makes Script Runner the ideal place to write your procedures, however any text editor will do. If there is functionality that you don't see here or perhaps an easier syntax for doing something, please submit a ticket.",source:"@site/docs/guides/scripting-api.md",sourceDirName:"guides",slug:"/guides/scripting-api",permalink:"/tools/docs/docs/guides/scripting-api",draft:!1,editUrl:"https://github.com/OpenC3/cosmos/tree/main/docs.openc3.com/docs/guides/scripting-api.md",tags:[],version:"current",frontMatter:{title:"Scripting API Guide"},sidebar:"defaultSidebar",previous:{title:"Script Writing Guide",permalink:"/tools/docs/docs/guides/script-writing"},next:{title:"Development",permalink:"/tools/docs/docs/development"}},p={},o=[{value:"Concepts",id:"concepts",level:2},{value:"Programming Languages",id:"programming-languages",level:3},{value:"Using Script Runner",id:"using-script-runner",level:3},{value:"Telemetry Types",id:"telemetry-types",level:3},{value:"Script Runner API",id:"script-runner-api",level:2},{value:"Migration from COSMOS v4",id:"migration-from-cosmos-v4",level:3},{value:"Retrieving User Input",id:"retrieving-user-input",level:2},{value:"ask",id:"ask",level:3},{value:"ask_string",id:"ask_string",level:3},{value:"message_box",id:"message_box",level:3},{value:"vertical_message_box",id:"vertical_message_box",level:3},{value:"combo_box",id:"combo_box",level:3},{value:"get_target_file",id:"get_target_file",level:3},{value:"put_target_file",id:"put_target_file",level:3},{value:"delete_target_file",id:"delete_target_file",level:3},{value:"open_file_dialog",id:"open_file_dialog",level:3},{value:"open_files_dialog",id:"open_files_dialog",level:3},{value:"Providing information to the user",id:"providing-information-to-the-user",level:2},{value:"prompt",id:"prompt",level:3},{value:"Commands",id:"commands",level:2},{value:"cmd",id:"cmd",level:3},{value:"cmd_no_range_check",id:"cmd_no_range_check",level:3},{value:"cmd_no_hazardous_check",id:"cmd_no_hazardous_check",level:3},{value:"cmd_no_checks",id:"cmd_no_checks",level:3},{value:"cmd_raw",id:"cmd_raw",level:3},{value:"cmd_raw_no_range_check",id:"cmd_raw_no_range_check",level:3},{value:"cmd_raw_no_hazardous_check",id:"cmd_raw_no_hazardous_check",level:3},{value:"cmd_raw_no_checks",id:"cmd_raw_no_checks",level:3},{value:"build_command (since 5.8.0)",id:"build_command-since-580",level:3},{value:"send_raw",id:"send_raw",level:3},{value:"get_all_commands (since 5.0.0)",id:"get_all_commands-since-500",level:3},{value:"get_all_command_names (since 5.0.6)",id:"get_all_command_names-since-506",level:3},{value:"get_command (since 5.0.0)",id:"get_command-since-500",level:3},{value:"get_parameter (since 5.0.0)",id:"get_parameter-since-500",level:3},{value:"get_cmd_buffer",id:"get_cmd_buffer",level:3},{value:"get_cmd_hazardous",id:"get_cmd_hazardous",level:3},{value:"get_cmd_value",id:"get_cmd_value",level:3},{value:"get_cmd_time",id:"get_cmd_time",level:3},{value:"get_cmd_cnt",id:"get_cmd_cnt",level:3},{value:"Handling Telemetry",id:"handling-telemetry",level:2},{value:"check, check_raw, check_formatted, check_with_units",id:"check-check_raw-check_formatted-check_with_units",level:3},{value:"check_tolerance",id:"check_tolerance",level:3},{value:"check_expression",id:"check_expression",level:3},{value:"check_exception",id:"check_exception",level:3},{value:"tlm, tlm_raw, tlm_formatted, tlm_with_units",id:"tlm-tlm_raw-tlm_formatted-tlm_with_units",level:3},{value:"get_tlm_buffer",id:"get_tlm_buffer",level:3},{value:"get_tlm_packet",id:"get_tlm_packet",level:3},{value:"get_tlm_values (modified in 5.0.0)",id:"get_tlm_values-modified-in-500",level:3},{value:"get_all_telemetry (since 5.0.0)",id:"get_all_telemetry-since-500",level:3},{value:"get_all_telemetry_names (since 5.0.6)",id:"get_all_telemetry_names-since-506",level:3},{value:"get_telemetry (since 5.0.0)",id:"get_telemetry-since-500",level:3},{value:"get_item (since 5.0.0)",id:"get_item-since-500",level:3},{value:"get_tlm_cnt",id:"get_tlm_cnt",level:3},{value:"set_tlm",id:"set_tlm",level:3},{value:"inject_tlm",id:"inject_tlm",level:3},{value:"override_tlm",id:"override_tlm",level:3},{value:"normalize_tlm",id:"normalize_tlm",level:3},{value:"get_overrides",id:"get_overrides",level:3},{value:"Packet Data Subscriptions",id:"packet-data-subscriptions",level:2},{value:"subscribe_packets (since 5.0.3)",id:"subscribe_packets-since-503",level:3},{value:"get_packets (since 5.0.3)",id:"get_packets-since-503",level:3},{value:"get_tlm_cnt",id:"get_tlm_cnt-1",level:3},{value:"get_tlm_cnts",id:"get_tlm_cnts",level:3},{value:"get_packet_derived_items",id:"get_packet_derived_items",level:3},{value:"Delays",id:"delays",level:2},{value:"wait",id:"wait",level:3},{value:"wait_tolerance",id:"wait_tolerance",level:3},{value:"wait_expression",id:"wait_expression",level:3},{value:"wait_packet",id:"wait_packet",level:3},{value:"wait_check",id:"wait_check",level:3},{value:"wait_check_tolerance",id:"wait_check_tolerance",level:3},{value:"wait_check_expression",id:"wait_check_expression",level:3},{value:"wait_check_packet",id:"wait_check_packet",level:3},{value:"Limits",id:"limits",level:2},{value:"limits_enabled?, limits_enabled",id:"limits_enabled-limits_enabled",level:3},{value:"enable_limits",id:"enable_limits",level:3},{value:"disable_limits",id:"disable_limits",level:3},{value:"enable_limits_group",id:"enable_limits_group",level:3},{value:"disable_limits_group",id:"disable_limits_group",level:3},{value:"get_limits_groups",id:"get_limits_groups",level:3},{value:"set_limits_set",id:"set_limits_set",level:3},{value:"get_limits_set",id:"get_limits_set",level:3},{value:"get_limits_sets",id:"get_limits_sets",level:3},{value:"get_limits",id:"get_limits",level:3},{value:"set_limits",id:"set_limits",level:3},{value:"get_out_of_limits",id:"get_out_of_limits",level:3},{value:"get_overall_limits_state",id:"get_overall_limits_state",level:3},{value:"get_limits_events",id:"get_limits_events",level:3},{value:"Targets",id:"targets",level:2},{value:"get_target_names",id:"get_target_names",level:3},{value:"get_target",id:"get_target",level:3},{value:"get_target_interfaces",id:"get_target_interfaces",level:3},{value:"Interfaces",id:"interfaces",level:2},{value:"get_interface (since 5.0.0)",id:"get_interface-since-500",level:3},{value:"get_interface_names",id:"get_interface_names",level:3},{value:"connect_interface",id:"connect_interface",level:3},{value:"disconnect_interface",id:"disconnect_interface",level:3},{value:"start_raw_logging_interface",id:"start_raw_logging_interface",level:3},{value:"stop_raw_logging_interface",id:"stop_raw_logging_interface",level:3},{value:"get_all_interface_info",id:"get_all_interface_info",level:3},{value:"map_target_to_interface",id:"map_target_to_interface",level:3},{value:"interface_cmd",id:"interface_cmd",level:3},{value:"interface_protocol_cmd",id:"interface_protocol_cmd",level:3},{value:"Routers",id:"routers",level:2},{value:"connect_router",id:"connect_router",level:3},{value:"disconnect_router",id:"disconnect_router",level:3},{value:"get_router_names",id:"get_router_names",level:3},{value:"get_router (since 5.0.0)",id:"get_router-since-500",level:3},{value:"get_all_router_info",id:"get_all_router_info",level:3},{value:"start_raw_logging_router",id:"start_raw_logging_router",level:3},{value:"stop_raw_logging_router",id:"stop_raw_logging_router",level:3},{value:"router_cmd",id:"router_cmd",level:3},{value:"router_protocol_cmd",id:"router_protocol_cmd",level:3},{value:"Stashing Data",id:"stashing-data",level:2},{value:"stash_set",id:"stash_set",level:3},{value:"stash_get",id:"stash_get",level:3},{value:"stash_all",id:"stash_all",level:3},{value:"stash_keys",id:"stash_keys",level:3},{value:"stash_delete",id:"stash_delete",level:3},{value:"Executing Other Procedures",id:"executing-other-procedures",level:2},{value:"start",id:"start",level:3},{value:"load_utility",id:"load_utility",level:3},{value:"Opening, Closing &amp; Creating Telemetry Screens",id:"opening-closing--creating-telemetry-screens",level:2},{value:"display_screen",id:"display_screen",level:3},{value:"clear_screen",id:"clear_screen",level:3},{value:"clear_all_screens",id:"clear_all_screens",level:3},{value:"delete_screen",id:"delete_screen",level:3},{value:"get_screen_list",id:"get_screen_list",level:3},{value:"get_screen_definition",id:"get_screen_definition",level:3},{value:"create_screen",id:"create_screen",level:3},{value:"local_screen",id:"local_screen",level:3},{value:"Script Runner Settings",id:"script-runner-settings",level:2},{value:"set_line_delay",id:"set_line_delay",level:3},{value:"get_line_delay",id:"get_line_delay",level:3},{value:"set_max_output",id:"set_max_output",level:3},{value:"get_max_output",id:"get_max_output",level:3},{value:"disable_instrumentation",id:"disable_instrumentation",level:3},{value:"Script Runner Suites",id:"script-runner-suites",level:2},{value:"add_group, add_group_setup, add_group_teardown, add_script",id:"add_group-add_group_setup-add_group_teardown-add_script",level:3},{value:"Script Runner Debugging",id:"script-runner-debugging",level:2},{value:"step_mode",id:"step_mode",level:3},{value:"run_mode",id:"run_mode",level:3},{value:"disconnect_script",id:"disconnect_script",level:3},{value:"Metadata",id:"metadata",level:2},{value:"metadata_all",id:"metadata_all",level:3},{value:"metadata_get",id:"metadata_get",level:3},{value:"metadata_set",id:"metadata_set",level:3},{value:"metadata_update",id:"metadata_update",level:3},{value:"metadata_input",id:"metadata_input",level:3},{value:"Settings",id:"settings",level:2},{value:"list_settings",id:"list_settings",level:3},{value:"get_all_settings",id:"get_all_settings",level:3},{value:"get_setting, get_settings",id:"get_setting-get_settings",level:3},{value:"set_setting",id:"set_setting",level:3},{value:"Configuration",id:"configuration",level:2},{value:"config_tool_names",id:"config_tool_names",level:3},{value:"list_configs",id:"list_configs",level:3},{value:"load_config",id:"load_config",level:3},{value:"save_config",id:"save_config",level:3},{value:"delete_config",id:"delete_config",level:3}],u={toc:o},s="wrapper";function d(e){let{components:t,...a}=e;return(0,r.kt)(s,(0,n.Z)({},u,a,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("p",null,"This document provides the information necessary to write test procedures using the COSMOS scripting API. Scripting in COSMOS is designed to be simple and intuitive. The code completion ability for command and telemetry mnemonics makes Script Runner the ideal place to write your procedures, however any text editor will do. If there is functionality that you don't see here or perhaps an easier syntax for doing something, please submit a ticket."),(0,r.kt)("h2",{id:"concepts"},"Concepts"),(0,r.kt)("h3",{id:"programming-languages"},"Programming Languages"),(0,r.kt)("p",null,"COSMOS scripting is implemented using either Ruby or Python. Ruby and Python are very similar scripting languages and in many cases the COSMOS APIs are identical between the two. This guide is written to support both with additional language specific information found in the ",(0,r.kt)("a",{parentName:"p",href:"/tools/docs/docs/guides/script-writing"},"Script Writing Guide"),"."),(0,r.kt)("h3",{id:"using-script-runner"},"Using Script Runner"),(0,r.kt)("p",null,"Script Runner is a graphical application that provides the ideal environment for running and implementing your test procedures. The Script Runner tool is broken into 4 main sections. At the top of the tool is a menu bar that allows you to do such things as open and save files, perform a syntax check, and execute your script."),(0,r.kt)("p",null,'Next is a tool bar that displays the currently executing script and three buttons, "Start/Go", "Pause/Retry", and "Stop". The Start/Go button is used to start the script and continue past errors or waits. The Pause/Retry button will pause the executing script. If an error is encountered the Pause button changes to Retry to re-execute the errored line. Finally, the Stop button will stop the executing script at any time.'),(0,r.kt)("p",null,"Third is the display of the actual script. While the script is not running, you may edit and compose scripts in this area. A handy code completion feature is provided that will list out the available commands or telemetry points as you are writing your script. Simply begin writing a cmd( or tlm( line to bring up code completion. This feature greatly reduces typos in command and telemetry mnemonics."),(0,r.kt)("p",null,"Finally, the bottom of the display is the log messages. All commands that are sent, errors that occur, and user print statements appear in this area."),(0,r.kt)("h3",{id:"telemetry-types"},"Telemetry Types"),(0,r.kt)("p",null,"There are four different ways that telemetry values can be retrieved in COSMOS. The following chart explains their differences."),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Telemetry Type"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Raw"),(0,r.kt)("td",{parentName:"tr",align:null},"Raw telemetry is exactly as it is in the telemetry packet before any conversions. All telemetry items will have a raw value except for Derived telemetry points which have no real location in a packet. Requesting raw telemetry on a derived item will return nil.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Converted"),(0,r.kt)("td",{parentName:"tr",align:null},"Converted telemetry is raw telemetry that has gone through a conversion factor such as a state conversion or a polynomial conversion. If a telemetry item does not have a conversion defined, then converted telemetry will be the same as raw telemetry. This is the most common type of telemety used in scripts.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Formatted"),(0,r.kt)("td",{parentName:"tr",align:null},"Formatted telemetry is converted telemetry that has gone through a printf style conversion into a string. Formatted telemetry will always have a string representation. If no format string is defined for a telemetry point, then formatted telemetry will be the same as converted telemetry except represented as string.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Formatted with Units"),(0,r.kt)("td",{parentName:"tr",align:null},"Formatted with Units telemetry is the same as Formatted telemetry except that a space and the units of the telemetry item are appended to the end of the string. If no units are defined for a telemetry item then this type is the same as Formatted telemetry.")))),(0,r.kt)("h2",{id:"script-runner-api"},"Script Runner API"),(0,r.kt)("p",null,"The following methods are designed to be used in Script Runner procedures. Many can also be used in custom built COSMOS tools. Please see the COSMOS Tool API section for methods that are more efficient to use in custom tools."),(0,r.kt)("h3",{id:"migration-from-cosmos-v4"},"Migration from COSMOS v4"),(0,r.kt)("p",null,"The following API methods are either deprecated (will not be ported to COSMOS 5) or currently unimplemented (eventually will be ported to COSMOS 5):"),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Method"),(0,r.kt)("th",{parentName:"tr",align:null},"Tool"),(0,r.kt)("th",{parentName:"tr",align:null},"Status"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"clear"),(0,r.kt)("td",{parentName:"tr",align:null},"Telemetry Viewer"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use clear_screen")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"clear_all"),(0,r.kt)("td",{parentName:"tr",align:null},"Telemetry Viewer"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use clear_all_screens")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"close_local_screens"),(0,r.kt)("td",{parentName:"tr",align:null},"Telemetry Viewer"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use clear_screen")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"clear_disconnected_targets"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"cmd_tlm_clear_counters"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"cmd_tlm_reload"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"display"),(0,r.kt)("td",{parentName:"tr",align:null},"Telemetry Viewer"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use display_screen")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_all_packet_logger_info"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_all_target_info"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_target_interfaces")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_background_tasks"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_all_cmd_info"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_all_commands")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_all_tlm_info"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_all_telemetry")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_cmd_list"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_all_commands")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_cmd_log_filename"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_cmd_param_list"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_command")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_cmd_tlm_disconnect"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use $disconnect")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_disconnected_targets"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Unimplemented")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_interface_info"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_interface")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_interface_targets"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_output_logs_filenames"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_packet"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_packets")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_packet_data"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_packets")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_packet_logger_info"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_packet_loggers"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_replay_mode"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_router_info"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_router")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_scriptrunner_message_log_filename"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_server_message"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_server_message_log_filename"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_server_status"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_stale"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_target_ignored_items"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_target")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_target_ignored_parameters"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_target")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_target_info"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_target")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_target_list"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_target_names")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_tlm_details"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_tlm_item_list"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_tlm_list"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"get_tlm_log_filename"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"interface_state"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_interface")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"override_tlm_raw"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use override_tlm")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"open_directory_dialog"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"replay_move_end"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"replay_move_index"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"replay_move_start"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"replay_play"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"replay_reverse_play"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"replay_select_file"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"replay_set_playback_delay"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"replay_status"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"replay_step_back"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"replay_step_forward"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"replay_stop"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"require_utility"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated but exists for backwards compatibility, use load_utility")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"router_state"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use get_router")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"save_file_dialog"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"save_setting"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated but exists for backwards compatibility, use set_setting")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"set_cmd_tlm_disconnect"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use disconnect_script")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"set_disconnected_targets"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Unimplemented")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"set_replay_mode"),(0,r.kt)("td",{parentName:"tr",align:null},"Replay"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"set_stdout_max_lines"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"set_tlm_raw"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use set_tlm")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"show_backtrace"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, backtrace always shown")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"shutdown_cmd_tlm"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"start_cmd_log"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"start_logging"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"start_new_scriptrunner_message_log"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"start_new_server_message_log"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"start_tlm_log"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"stop_background_task"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"stop_cmd_log"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"stop_logging"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"stop_tlm_log"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"subscribe_limits_events"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"subscribe_packet_data"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use subscribe_packets")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"subscribe_server_messages"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Unimplemented")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"tlm_variable"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use tlm() and pass type")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"unsubscribe_limits_events"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"unsubscribe_packet_data"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"unsubscribe_server_messages"),(0,r.kt)("td",{parentName:"tr",align:null},"Command and Telemetry Server"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"wait_raw"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use wait(..., type: :RAW)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"wait_check_raw"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use wait_check(..., type: :RAW)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"wait_tolerance_raw"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use wait_tolerance(..., type: :RAW)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"wait_check_tolerance_raw"),(0,r.kt)("td",{parentName:"tr",align:null},"Script Runner"),(0,r.kt)("td",{parentName:"tr",align:null},"Deprecated, use wait_check_tolerance(..., type: :RAW)")))),(0,r.kt)("h2",{id:"retrieving-user-input"},"Retrieving User Input"),(0,r.kt)("p",null,"These methods allow the user to enter values that are needed by the script."),(0,r.kt)("h3",{id:"ask"},"ask"),(0,r.kt)("p",null,'Prompts the user for input with a question. User input is automatically converted from a string to the appropriate data type. For example if the user enters "1", the number 1 as an integer will be returned.'),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'ask("<question>", <blank_or_default>, <password>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"question"),(0,r.kt)("td",{parentName:"tr",align:null},"Question to prompt the user with.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"blank_or_default"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether or not to allow empty responses (optional - defaults to false). If a non-boolean value is passed it is used as a default value.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"password"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether to treat the entry as a password which is displayed with dots and not logged. Default is false.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'value = ask("Enter an integer")\nvalue = ask("Enter a value or nothing", true)\nvalue = ask("Enter a value", 10)\npassword = ask("Enter your password", false, true)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'value = ask("Enter an integer")\nvalue = ask("Enter a value or nothing", True)\nvalue = ask("Enter a value", 10)\npassword = ask("Enter your password", False, True)\n')),(0,r.kt)("h3",{id:"ask_string"},"ask_string"),(0,r.kt)("p",null,'Prompts the user for input with a question. User input is always returned as a string. For exampe if the user enters "1", the string "1" will be returned.'),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'ask_string("<question>", <blank_or_default>, <password>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"question"),(0,r.kt)("td",{parentName:"tr",align:null},"Question to prompt the user with.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"blank_or_default"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether or not to allow empty responses (optional - defaults to false). If a non-boolean value is passed it is used as a default value.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"password"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether to treat the entry as a password which is displayed with dots and not logged. Default is false.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'string = ask_string("Enter a String")\nstring = ask_string("Enter a value or nothing", true)\nstring = ask_string("Enter a value", "test")\npassword = ask_string("Enter your password", false, true)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'string = ask_string("Enter a String")\nstring = ask_string("Enter a value or nothing", True)\nstring = ask_string("Enter a value", "test")\npassword = ask_string("Enter your password", False, True)\n')),(0,r.kt)("h3",{id:"message_box"},"message_box"),(0,r.kt)("h3",{id:"vertical_message_box"},"vertical_message_box"),(0,r.kt)("h3",{id:"combo_box"},"combo_box"),(0,r.kt)("p",null,"The message_box, vertical_message_box, and combo_box methods create a message box with arbitrary buttons or selections that the user can click. The text of the button clicked is returned."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'message_box("<message>", "<button text 1>", ...)\nvertical_message_box("<message>", "<button text 1>", ...)\ncombo_box("<message>", "<selection text 1>", ...)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"message"),(0,r.kt)("td",{parentName:"tr",align:null},"Message to prompt the user with.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"button/selection text"),(0,r.kt)("td",{parentName:"tr",align:null},"Text for a button or selection")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"value = message_box(\"Select the sensor number\", 'One', 'Two')\nvalue = vertical_message_box(\"Select the sensor number\", 'One', 'Two')\nvalue = combo_box(\"Select the sensor number\", 'One', 'Two')\ncase value\nwhen 'One'\n  puts 'Sensor One'\nwhen 'Two'\n  puts 'Sensor Two'\nend\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"value = message_box(\"Select the sensor number\", 'One', 'Two')\nvalue = vertical_message_box(\"Select the sensor number\", 'One', 'Two')\nvalue = combo_box(\"Select the sensor number\", 'One', 'Two')\nmatch value:\n    case 'One':\n        print('Sensor One')\n    case 'Two':\n        print('Sensor Two')\n")),(0,r.kt)("h3",{id:"get_target_file"},"get_target_file"),(0,r.kt)("p",null,"Return a file handle to a file in the target directory"),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_target_file("<File Path>", original: false)\n')),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_target_file("<File Path>", original=False)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"path"),(0,r.kt)("td",{parentName:"tr",align:null},"The path to the file in the target directory. Should assume to start with a TARGET name, e.g. INST/procedures/proc.rb")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"original"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether to get the original file from the plug-in, or any modifications to the file. Default is false which means to grab the modified file. If the modified file does not exist the API will automatically try to pull the original.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'file = get_target_file("INST/data/attitude.bin")\nputs file.read().formatted # format a binary file\nfile.unlink # delete file\nfile = get_target_file("INST/procedures/checks.rb", original: true)\nputs file.read()\nfile.unlink # delete file\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'from openc3.utilities.string import formatted\n\nfile = get_target_file("INST/data/attitude.bin")\nprint(formatted(file.read())) # format a binary file\nfile.close() # delete file\nfile = get_target_file("INST/procedures/checks.rb", original=True)\nprint(file.read())\nfile.close() # delete file\n')),(0,r.kt)("h3",{id:"put_target_file"},"put_target_file"),(0,r.kt)("p",null,"Writes a file to the target directory"),(0,r.kt)("p",null,"Ruby or Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'put_target_file("<File Path>", "IO or String")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"path"),(0,r.kt)("td",{parentName:"tr",align:null},"The path to the file in the target directory. Should assume to start with a TARGET name, e.g. INST/procedures/proc.rb. The file can previously exist or not. Note: The original file from the plug-in will not be modified, however existing modified files will be overwritten.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"data"),(0,r.kt)("td",{parentName:"tr",align:null},"The data can be an IO object or String")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'put_target_file("INST/test1.txt", "this is a string test")\nfile = Tempfile.new(\'test\')\nfile.write("this is a Io test")\nfile.rewind\nput_target_file("INST/test2.txt", file)\nput_target_file("INST/test3.bin", "\\x00\\x01\\x02\\x03\\xFF\\xEE\\xDD\\xCC") # binary\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'put_target_file("INST/test1.txt", "this is a string test")\nfile = tempfile.NamedTemporaryFile(mode="w+t")\nfile.write("this is a Io test")\nfile.seek(0)\nput_target_file("INST/test2.txt", file)\nput_target_file("INST/test3.bin", b"\\x00\\x01\\x02\\x03\\xFF\\xEE\\xDD\\xCC") # binary\n')),(0,r.kt)("h3",{id:"delete_target_file"},"delete_target_file"),(0,r.kt)("p",null,"Delete a file in the target directory"),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'delete_target_file("<File Path>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"path"),(0,r.kt)("td",{parentName:"tr",align:null},"The path to the file in the target directory. Should assume to start with a TARGET name, e.g. INST/procedures/proc.rb. Note: Only files created with put_target_file can be deleted. Original files from the plugin installation will remain.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'put_target_file("INST/delete_me.txt", "to be deleted")\ndelete_target_file("INST/delete_me.txt")\n')),(0,r.kt)("h3",{id:"open_file_dialog"},"open_file_dialog"),(0,r.kt)("h3",{id:"open_files_dialog"},"open_files_dialog"),(0,r.kt)("p",null,"The open_file_dialog and open_files_dialog methods create a file dialog box so the user can select a single or multiple files. The selected file(s) is returned."),(0,r.kt)("p",null,"Note: COSMOS 5 has deprecated the save_file_dialog and open_directory_dialog methods. save_file_dialog can be replaced by put_target_file if you want to write a file back to the target. open_directory_dialog doesn't make sense in new architecture so you must request individual files."),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'open_file_dialog("<title>", "<message>", filter: "<filter>")\nopen_files_dialog("<title>", "<message>", filter: "<filter>")\n')),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'open_file_dialog("<title>", "<message>", filter="<filter>")\nopen_files_dialog("<title>", "<message>", filter="<filter>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Title"),(0,r.kt)("td",{parentName:"tr",align:null},"The title to put on the dialog. Required.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Message"),(0,r.kt)("td",{parentName:"tr",align:null},"The message to display in the dialog box. Optional parameter.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"filter"),(0,r.kt)("td",{parentName:"tr",align:null},'Named parameter to filter allowed file types. Optional parameter, specified as comma delimited file types, e.g. ".txt,.doc". See ',(0,r.kt)("a",{parentName:"td",href:"https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept"},"https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept")," for more information.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'file = open_file_dialog("Open a single file", "Choose something interesting", filter: ".txt")\nputs file # Ruby File object\nputs file.read\nfile.delete\n\nfiles = open_files_dialog("Open multiple files") # message is optional\nputs files # Array of File objects (even if you select only one)\nfiles.each do |file|\n  puts file\n  puts file.read\n  file.delete\nend\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'file = open_file_dialog("Open a single file", "Choose something interesting", filter=".txt")\nprint(file)\nprint(file.read())\nfile.close()\n\nfiles = open_files_dialog("Open multiple files") # message is optional\nprint(files) # Array of File objects (even if you select only one)\nfor file in files:\n    print(file)\n    print(file.read())\n    file.close()\n')),(0,r.kt)("h2",{id:"providing-information-to-the-user"},"Providing information to the user"),(0,r.kt)("p",null,"These methods notify the user that something has occurred."),(0,r.kt)("h3",{id:"prompt"},"prompt"),(0,r.kt)("p",null,"Displays a message to the user and waits for them to press an ok button."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'prompt("<message>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"message"),(0,r.kt)("td",{parentName:"tr",align:null},"Message to prompt the user with.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'prompt("Press OK to continue")\n')),(0,r.kt)("h2",{id:"commands"},"Commands"),(0,r.kt)("p",null,"These methods provide capability to send commands to a target and receive information about commands in the system."),(0,r.kt)("h3",{id:"cmd"},"cmd"),(0,r.kt)("p",null,"Sends a specified command."),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd("<Target Name>", "<Command Name>", "Param #1 Name" => <Param #1 Value>, "Param #2 Name" => <Param #2 Value>, ...)\n')),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd("<Target Name>", "<Command Name>", {"Param #1 Name": <Param #1 Value>, "Param #2 Name": <Param #2 Value>, ...})\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target this command is associated with.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of this command. Also referred to as its mnemonic.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of a command parameter. If there are no parameters then the 'with' keyword should not be given.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Value of the command parameter. Values are automatically converted to the appropriate type.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd("INST COLLECT with DURATION 10, TYPE NORMAL")\n# In Ruby the brackets around parameters are optional\ncmd("INST", "COLLECT", "DURATION" => 10, "TYPE" => "NORMAL")\ncmd("INST", "COLLECT", { "DURATION" => 10, "TYPE" => "NORMAL" })\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd("INST COLLECT with DURATION 10, TYPE NORMAL")\ncmd("INST", "COLLECT", { "DURATION": 10, "TYPE": "NORMAL" })\n')),(0,r.kt)("h3",{id:"cmd_no_range_check"},"cmd_no_range_check"),(0,r.kt)("p",null,"Sends a specified command without performing range checking on its parameters. This should only be used when it is necessary to intentionally send a bad command parameter to test a target."),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_no_range_check("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_no_range_check("<Target Name>", "<Command Name>", "Param #1 Name" => <Param #1 Value>, "Param #2 Name" => <Param #2 Value>, ...)\n')),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd_no_range_check("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_no_range_check("<Target Name>", "<Command Name>", {"Param #1 Name": <Param #1 Value>, "Param #2 Name": <Param #2 Value>, ...})\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target this command is associated with.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of this command. Also referred to as its mnemonic.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of a command parameter. If there are no parameters then the 'with' keyword should not be given.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Value of the command parameter. Values are automatically converted to the appropriate type.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_no_range_check("INST COLLECT with DURATION 11, TYPE NORMAL")\ncmd_no_range_check("INST", "COLLECT", "DURATION" => 11, "TYPE" => "NORMAL")\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd_no_range_check("INST COLLECT with DURATION 11, TYPE NORMAL")\ncmd_no_range_check("INST", "COLLECT", {"DURATION": 11, "TYPE": "NORMAL"})\n')),(0,r.kt)("h3",{id:"cmd_no_hazardous_check"},"cmd_no_hazardous_check"),(0,r.kt)("p",null,"Sends a specified command without performing the notification if it is a hazardous command. This should only be used when it is necessary to fully automate testing involving hazardous commands."),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_no_hazardous_check("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_no_hazardous_check("<Target Name>", "<Command Name>", "Param #1 Name" => <Param #1 Value>, "Param #2 Name" => <Param #2 Value>, ...)\n')),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd_no_hazardous_check("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_no_hazardous_check("<Target Name>", "<Command Name>", {"Param #1 Name": <Param #1 Value>, "Param #2 Name": <Param #2 Value>, ...})\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target this command is associated with.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of this command. Also referred to as its mnemonic.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of a command parameter. If there are no parameters then the 'with' keyword should not be given.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Value of the command parameter. Values are automatically converted to the appropriate type.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_no_hazardous_check("INST CLEAR")\ncmd_no_hazardous_check("INST", "CLEAR")\n')),(0,r.kt)("h3",{id:"cmd_no_checks"},"cmd_no_checks"),(0,r.kt)("p",null,"Sends a specified command without performing the parameter range checks or notification if it is a hazardous command. This should only be used when it is necessary to fully automate testing involving hazardous commands that intentially have invalid parameters."),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_no_checks("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_no_checks("<Target Name>", "<Command Name>", "Param #1 Name" => <Param #1 Value>, "Param #2 Name" => <Param #2 Value>, ...)\n')),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd_no_checks("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_no_checks("<Target Name>", "<Command Name>", {"Param #1 Name": <Param #1 Value>, "Param #2 Name": <Param #2 Value>, ...})\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target this command is associated with.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of this command. Also referred to as its mnemonic.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of a command parameter. If there are no parameters then the 'with' keyword should not be given.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Value of the command parameter. Values are automatically converted to the appropriate type.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_no_checks("INST COLLECT with DURATION 11, TYPE SPECIAL")\ncmd_no_checks("INST", "COLLECT", "DURATION" => 11, "TYPE" => "SPECIAL")\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd_no_checks("INST COLLECT with DURATION 11, TYPE SPECIAL")\ncmd_no_checks("INST", "COLLECT", {"DURATION": 11, "TYPE": "SPECIAL"})\n')),(0,r.kt)("h3",{id:"cmd_raw"},"cmd_raw"),(0,r.kt)("p",null,"Sends a specified command without running conversions."),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_raw("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_raw("<Target Name>", "<Command Name>", "<Param #1 Name>" => <Param #1 Value>, "<Param #2 Name>" => <Param #2 Value>, ...)\n')),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd_raw("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_raw("<Target Name>", "<Command Name>", {"<Param #1 Name>": <Param #1 Value>, "<Param #2 Name>": <Param #2 Value>, ...})\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target this command is associated with.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of this command. Also referred to as its mnemonic.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of a command parameter. If there are no parameters then the 'with' keyword should not be given.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Value of the command parameter. Values are automatically converted to the appropriate type.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_raw("INST COLLECT with DURATION 10, TYPE 0")\ncmd_raw("INST", "COLLECT", "DURATION" => 10, "TYPE" => 0)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd_raw("INST COLLECT with DURATION 10, TYPE 0")\ncmd_raw("INST", "COLLECT", {"DURATION": 10, "TYPE": 0})\n')),(0,r.kt)("h3",{id:"cmd_raw_no_range_check"},"cmd_raw_no_range_check"),(0,r.kt)("p",null,"Sends a specified command without running conversions or performing range checking on its parameters. This should only be used when it is necessary to intentionally send a bad command parameter to test a target."),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_raw_no_range_check("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_raw_no_range_check("<Target Name>", "<Command Name>", "<Param #1 Name>" => <Param #1 Value>, "<Param #2 Name>" => <Param #2 Value>, ...)\n')),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd_raw_no_range_check("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_raw_no_range_check("<Target Name>", "<Command Name>", {"<Param #1 Name>": <Param #1 Value>, "<Param #2 Name>": <Param #2 Value>, ...})\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target this command is associated with.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of this command. Also referred to as its mnemonic.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of a command parameter. If there are no parameters then the 'with' keyword should not be given.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Value of the command parameter. Values are automatically converted to the appropriate type.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_raw_no_range_check("INST COLLECT with DURATION 11, TYPE 0")\ncmd_raw_no_range_check("INST", "COLLECT", "DURATION" => 11, "TYPE" => 0)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd_raw_no_range_check("INST COLLECT with DURATION 11, TYPE 0")\ncmd_raw_no_range_check("INST", "COLLECT", {"DURATION": 11, "TYPE": 0})\n')),(0,r.kt)("h3",{id:"cmd_raw_no_hazardous_check"},"cmd_raw_no_hazardous_check"),(0,r.kt)("p",null,"Sends a specified command without running conversions or performing the notification if it is a hazardous command. This should only be used when it is necessary to fully automate testing involving hazardous commands."),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_raw_no_hazardous_check("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_raw_no_hazardous_check("<Target Name>", "<Command Name>", "<Param #1 Name>" => <Param #1 Value>, "<Param #2 Name>" => <Param #2 Value>, ...)\n')),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd_raw_no_hazardous_check("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_raw_no_hazardous_check("<Target Name>", "<Command Name>", {"<Param #1 Name>": <Param #1 Value>, "<Param #2 Name>": <Param #2 Value>, ...})\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target this command is associated with.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of this command. Also referred to as its mnemonic.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of a command parameter. If there are no parameters then the 'with' keyword should not be given.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Value of the command parameter. Values are automatically converted to the appropriate type.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_raw_no_hazardous_check("INST CLEAR")\ncmd_raw_no_hazardous_check("INST", "CLEAR")\n')),(0,r.kt)("h3",{id:"cmd_raw_no_checks"},"cmd_raw_no_checks"),(0,r.kt)("p",null,"Sends a specified command without running conversions or performing the parameter range checks or notification if it is a hazardous command. This should only be used when it is necessary to fully automate testing involving hazardous commands that intentially have invalid parameters."),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_raw_no_checks("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_raw_no_checks("<Target Name>", "<Command Name>", "<Param #1 Name>" => <Param #1 Value>, "<Param #2 Name>" => <Param #2 Value>, ...)\n')),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd_raw_no_checks("<Target Name> <Command Name> with <Param #1 Name> <Param #1 Value>, <Param #2 Name> <Param #2 Value>, ...")\ncmd_raw_no_checks("<Target Name>", "<Command Name>", {"<Param #1 Name>": <Param #1 Value>, "<Param #2 Name>": <Param #2 Value>, ...})\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target this command is associated with.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of this command. Also referred to as its mnemonic.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of a command parameter. If there are no parameters then the 'with' keyword should not be given.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Param #x Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Value of the command parameter. Values are automatically converted to the appropriate type.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_raw_no_checks("INST COLLECT with DURATION 11, TYPE 1")\ncmd_raw_no_checks("INST", "COLLECT", "DURATION" => 11, "TYPE" => 1)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'cmd_raw_no_checks("INST COLLECT with DURATION 11, TYPE 1")\ncmd_raw_no_checks("INST", "COLLECT", {"DURATION": 11, "TYPE": 1})\n')),(0,r.kt)("h3",{id:"build_command-since-580"},"build_command (since 5.8.0)"),(0,r.kt)("p",null,"Builds a command binary string"),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"build_command(<ARGS>, range_check: true, raw: false)\n")),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"build_command(<ARGS>, range_check=True, raw=False)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"ARGS"),(0,r.kt)("td",{parentName:"tr",align:null},"Command parameters (see cmd)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"range_check"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether to perform range checking on the command. Default is true.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"raw"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether to write the command arguments as RAW or CONVERTED value. Default is CONVERTED.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'x = build_command("INST COLLECT with DURATION 10, TYPE NORMAL")\nputs x  #=> {"id"=>"1696437370872-0", "result"=>"SUCCESS", "time"=>"1696437370872305961", "received_time"=>"1696437370872305961", "target_name"=>"INST", "packet_name"=>"COLLECT", "received_count"=>"3", "buffer"=>"\\x13\\xE7\\xC0\\x00\\x00\\f\\x00\\x01\\x00\\x00A \\x00\\x00\\xAB\\x00\\x00\\x00\\x00"}\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"x = build_command(\"INST COLLECT with DURATION 10, TYPE NORMAL\")\nprint(x)  #=> {'id': '1697298167748-0', 'result': 'SUCCESS', 'time': '1697298167749155717', 'received_time': '1697298167749155717', 'target_name': 'INST', 'packet_name': 'COLLECT', 'received_count': '2', 'buffer': bytearray(b'\\x13\\xe7\\xc0\\x00\\x00\\x0c\\x00\\x01\\x00\\x00A \\x00\\x00\\xab\\x00\\x00\\x00\\x00')}\n")),(0,r.kt)("h3",{id:"send_raw"},"send_raw"),(0,r.kt)("p",null,"Sends raw data on an interface."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"send_raw(<Interface Name>, <Data>)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Interface Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the interface to send the raw data on.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Data"),(0,r.kt)("td",{parentName:"tr",align:null},"Raw ruby string of data to send.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'send_raw("INST_INT", data)\n')),(0,r.kt)("h3",{id:"get_all_commands-since-500"},"get_all_commands (since 5.0.0)"),(0,r.kt)("p",null,"Returns an array of the commands that are available for a particular target. The returned array is an array of hashes which fully describe the command packet."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_all_commands("<Target Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_list = get_all_commands("INST")\nputs cmd_list  #=>\n# [{"target_name"=>"INST",\n#   "packet_name"=>"ABORT",\n#   "endianness"=>"BIG_ENDIAN",\n#   "description"=>"Aborts a collect on the instrument",\n#   "items"=> [{"name"=>"CCSDSVER", "bit_offset"=>0, "bit_size"=>3, ... }]\n# ...\n# }]\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"cmd_list = get_all_commands(\"INST\")\nprint(cmd_list)  #=>\n# [{'target_name': 'INST',\n#   'packet_name': 'ABORT',\n#   'endianness': 'BIG_ENDIAN',\n#   'description': 'Aborts a collect on the INST instrument',\n#   'items': [{'name': 'CCSDSVER', 'bit_offset': 0, 'bit_size': 3, ... }]\n# ...\n# }]\n")),(0,r.kt)("h3",{id:"get_all_command_names-since-506"},"get_all_command_names (since 5.0.6)"),(0,r.kt)("p",null,"Returns an array of the command names for a particular target."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_all_command_names("<Target Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"cmd_list = get_all_command_names(\"INST\")\nputs cmd_list  #=> ['ABORT', 'ARYCMD', 'ASCIICMD', ...]\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"cmd_list = get_all_command_names(\"INST\")\nprint(cmd_list)  #=> ['ABORT', 'ARYCMD', 'ASCIICMD', ...]\n")),(0,r.kt)("h3",{id:"get_command-since-500"},"get_command (since 5.0.0)"),(0,r.kt)("p",null,"Returns a command hash which fully describes the command packet."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_command("<Target Name>", "<Packet Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the packet.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'abort_cmd = get_command("INST", "ABORT")\nputs abort_cmd  #=>\n# [{"target_name"=>"INST",\n#   "packet_name"=>"ABORT",\n#   "endianness"=>"BIG_ENDIAN",\n#   "description"=>"Aborts a collect on the instrument",\n#   "items"=> [{"name"=>"CCSDSVER", "bit_offset"=>0, "bit_size"=>3, ... }]\n# ...\n# }]\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"abort_cmd = get_command(\"INST\")\nprint(abort_cmd)  #=>\n# [{'target_name': 'INST',\n#   'packet_name': 'ABORT',\n#   'endianness': 'BIG_ENDIAN',\n#   'description': 'Aborts a collect on the INST instrument',\n#   'items': [{'name': 'CCSDSVER', 'bit_offset': 0, 'bit_size': 3, ... }]\n# ...\n# }]\n")),(0,r.kt)("h3",{id:"get_parameter-since-500"},"get_parameter (since 5.0.0)"),(0,r.kt)("p",null,"Returns a hash of the given command parameter"),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_parameter("<Target Name>", "<Command Name>", "<Parameter Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the command.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Parameter Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the parameter.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'param = get_parameter("INST", "COLLECT", "TYPE")\nputs param  #=>\n# {"name"=>"TYPE", "bit_offset"=>64, "bit_size"=>16, "data_type"=>"UINT",\n#  "description"=>"Collect type which can be normal or special", "default"=>0,\n#  "minimum"=>0, "maximum"=>65535, "endianness"=>"BIG_ENDIAN", "required"=>true, "overflow"=>"ERROR",\n#  "states"=>{"NORMAL"=>{"value"=>0}, "SPECIAL"=>{"value"=>1, "hazardous"=>""}}, "limits"=>{}}\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"param = get_parameter(\"INST\", \"COLLECT\", \"TYPE\")\nprint(param)  #=>\n# {'name': 'TYPE', 'bit_offset': 64, 'bit_size': 16, 'data_type': 'UINT',\n#  'description': 'Collect type which can be normal or special', 'default': 0,\n#  'minimum': 0, 'maximum': 65535, 'endianness': 'BIG_ENDIAN', 'required': True, 'overflow': 'ERROR',\n#  'states': {'NORMAL': {'value': 0}, 'SPECIAL': {'value': 1, 'hazardous': ''}}, 'limits': {}}\n")),(0,r.kt)("h3",{id:"get_cmd_buffer"},"get_cmd_buffer"),(0,r.kt)("p",null,"Returns a packet hash (similar to get_command) along with the raw packet buffer as a Ruby string."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'buffer = get_cmd_buffer("<Target Name>", "<Packet Name>")[\'buffer\']\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the packet.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'packet = get_cmd_buffer("INST", "COLLECT")\nputs packet  #=>\n# {"time"=>"1697298846752053420", "received_time"=>"1697298846752053420",\n#  "target_name"=>"INST", "packet_name"=>"COLLECT", "received_count"=>"20", "stored"=>"false",\n#  "buffer"=>"\\x13\\xE7\\xC0\\x00\\x00\\f\\x00\\x01\\x00\\x00@\\xE0\\x00\\x00\\xAB\\x00\\x00\\x00\\x00"}\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"packet = get_cmd_buffer(\"INST\", \"COLLECT\")\nprint(packet)  #=>\n# {'time': '1697298923745982470', 'received_time': '1697298923745982470',\n#  'target_name': 'INST', 'packet_name': 'COLLECT', 'received_count': '21', 'stored': 'false',\n#  'buffer': bytearray(b'\\x13\\xe7\\xc0\\x00\\x00\\x0c\\x00\\x01\\x00\\x00@\\xe0\\x00\\x00\\xab\\x00\\x00\\x00\\x00')}\n")),(0,r.kt)("h3",{id:"get_cmd_hazardous"},"get_cmd_hazardous"),(0,r.kt)("p",null,"Returns true/false indicating whether a particular command is flagged as hazardous."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_cmd_hazardous("<Target Name>", "<Command Name>", <Command Params - optional>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the command.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Params"),(0,r.kt)("td",{parentName:"tr",align:null},"Hash of the parameters given to the command (optional). Note that some commands are only hazardous based on parameter states.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"hazardous = get_cmd_hazardous(\"INST\", \"COLLECT\", {'TYPE' => 'SPECIAL'})\nputs hazardous  #=> true\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"hazardous = get_cmd_hazardous(\"INST\", \"COLLECT\", {'TYPE': 'SPECIAL'})\nprint(hazardous) #=> True\n")),(0,r.kt)("h3",{id:"get_cmd_value"},"get_cmd_value"),(0,r.kt)("p",null,"Returns reads a value from the most recently sent command packet. The pseudo-parameters 'PACKET_TIMESECONDS', 'PACKET_TIMEFORMATTED', 'RECEIVED_COUNT', 'RECEIVED_TIMEFORMATTED', and 'RECEIVED_TIMESECONDS' are also supported."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_cmd_value("<Target Name>", "<Command Name>", "<Parameter Name>", <Value Type - optional>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the command.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Parameter Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the command parameter.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Value Type"),(0,r.kt)("td",{parentName:"tr",align:null},"Value Type to read. RAW, CONVERTED, FORMATTED, or WITH_UNITS. NOTE: Symbol in Ruby and str in Python")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'value = get_cmd_value("INST", "COLLECT", "TEMP", :RAW)\nputs value  #=> 0.0\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'value = get_cmd_value("INST", "COLLECT", "TEMP", "RAW")\nprint(value)  #=> 0.0\n')),(0,r.kt)("h3",{id:"get_cmd_time"},"get_cmd_time"),(0,r.kt)("p",null,"Returns the time of the most recent command sent."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_cmd_time("<Target Name - optional>", "<Command Name - optional>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target. If not given, then the most recent command time to any target will be returned")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the command. If not given, then the most recent command time to the given target will be returned")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'target_name, command_name, time = get_cmd_time() # Name of the most recent command sent to any target and time\ntarget_name, command_name, time = get_cmd_time("INST") # Name of the most recent command sent to the INST target and time\ntarget_name, command_name, time = get_cmd_time("INST", "COLLECT") # Name of the most recent INST COLLECT command and time\n')),(0,r.kt)("h3",{id:"get_cmd_cnt"},"get_cmd_cnt"),(0,r.kt)("p",null,"Returns the number of times a specified command has been sent."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_cmd_cnt("<Target Name>", "<Command Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the command.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'cmd_cnt = get_cmd_cnt("INST", "COLLECT") # Number of times the INST COLLECT command has been sent\n')),(0,r.kt)("h2",{id:"handling-telemetry"},"Handling Telemetry"),(0,r.kt)("p",null,"These methods allow the user to interact with telemetry items."),(0,r.kt)("h3",{id:"check-check_raw-check_formatted-check_with_units"},"check, check_raw, check_formatted, check_with_units"),(0,r.kt)("p",null,"Performs a verification of a telemetry item using its specified telemetry type. If the verification fails then the script will be paused with an error. If no comparision is given to check then the telemetry item is simply printed to the script output. Note: In most cases using wait_check is a better choice than using check."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'check("<Target Name> <Packet Name> <Item Name> <Comparison - optional>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Comparison"),(0,r.kt)("td",{parentName:"tr",align:null},"A comparison to perform against the telemetry item. If a comparison is not given then the telemetry item will just be printed into the script log.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'check("INST HEALTH_STATUS COLLECTS > 1")\ncheck_raw("INST HEALTH_STATUS COLLECTS > 1")\ncheck_formatted("INST HEALTH_STATUS COLLECTS > 1")\ncheck_with_units("INST HEALTH_STATUS COLLECTS > 1")\n# Ruby passes type as symbol\ncheck("INST HEALTH_STATUS COLLECTS > 1", type: :RAW)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'check("INST HEALTH_STATUS COLLECTS > 1")\ncheck_raw("INST HEALTH_STATUS COLLECTS > 1")\ncheck_formatted("INST HEALTH_STATUS COLLECTS > 1")\ncheck_with_units("INST HEALTH_STATUS COLLECTS > 1")\n# Python passes type as string\ncheck("INST HEALTH_STATUS COLLECTS > 1", type=\'RAW\')\n')),(0,r.kt)("h3",{id:"check_tolerance"},"check_tolerance"),(0,r.kt)("p",null,"Checks a converted telemetry item against an expected value with a tolerance. If the verification fails then the script will be paused with an error. Note: In most cases using wait_check_tolerance is a better choice than using check_tolerance."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'check_tolerance("<Target Name> <Packet Name> <Item Name>", <Expected Value>, <Tolerance>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Expected Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Expected value of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Tolerance"),(0,r.kt)("td",{parentName:"tr",align:null},"\xb1 Tolerance on the expected value.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"type"),(0,r.kt)("td",{parentName:"tr",align:null},"CONVERTED (default) or RAW (Ruby symbol, Python string)")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'check_tolerance("INST HEALTH_STATUS COLLECTS", 10.0, 5.0)\ncheck_tolerance("INST HEALTH_STATUS TEMP1", 50000, 20000, type: :RAW)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'check_tolerance("INST HEALTH_STATUS COLLECTS", 10.0, 5.0)\ncheck_tolerance("INST HEALTH_STATUS TEMP1", 50000, 20000, type=\'RAW\')\n')),(0,r.kt)("h3",{id:"check_expression"},"check_expression"),(0,r.kt)("p",null,"Evaluates an expression. If the expression evaluates to false the script will be paused with an error. This method can be used to perform more complicated comparisons than using check as shown in the example. Note: In most cases using ",(0,r.kt)("a",{parentName:"p",href:"#waitcheckexpression"},"wait_check_expression")," is a better choice than using check_expression."),(0,r.kt)("p",null,"Remember that everything inside the check_expression string will be evaluated directly and thus must be valid syntax. A common mistake is to check a variable like so (Ruby variable interpolation):"),(0,r.kt)("p",null,(0,r.kt)("inlineCode",{parentName:"p"},"check_expression(\"#{answer} == 'yes'\") # where answer contains 'yes'")),(0,r.kt)("p",null,"This evaluates to ",(0,r.kt)("inlineCode",{parentName:"p"},"yes == 'yes'")," which is not valid syntax because the variable yes is not defined (usually). The correct way to write this expression is as follows:"),(0,r.kt)("p",null,(0,r.kt)("inlineCode",{parentName:"p"},"check_expression(\"'#{answer}' == 'yes'\") # where answer contains 'yes'")),(0,r.kt)("p",null,"Now this evaluates to ",(0,r.kt)("inlineCode",{parentName:"p"},"'yes' == 'yes'")," which is true so the check passes."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'check_expression("<Expression>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Expression"),(0,r.kt)("td",{parentName:"tr",align:null},"An expression to evaluate.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"check_expression(\"tlm('INST HEALTH_STATUS COLLECTS') > 5 and tlm('INST HEALTH_STATUS TEMP1') > 25.0\")\n")),(0,r.kt)("h3",{id:"check_exception"},"check_exception"),(0,r.kt)("p",null,"Executes a method and expects an exception to be raised. If the method does not raise an exception, a CheckError is raised."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'check_exception("<Method Name>", "<Method Params - optional>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Method Name"),(0,r.kt)("td",{parentName:"tr",align:null},"The COSMOS scripting method to execute, e.g. 'cmd', etc.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Method Params"),(0,r.kt)("td",{parentName:"tr",align:null},"Parameters for the method")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'check_exception("cmd", "INST", "COLLECT", "TYPE" => "NORMAL")\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'check_exception("cmd", "INST", "COLLECT", {"TYPE": "NORMAL"})\n')),(0,r.kt)("h3",{id:"tlm-tlm_raw-tlm_formatted-tlm_with_units"},"tlm, tlm_raw, tlm_formatted, tlm_with_units"),(0,r.kt)("p",null,"Reads the specified form of a telemetry item."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'tlm("<Target Name> <Packet Name> <Item Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"type"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter specifying the type. RAW, CONVERTED (default), FORMATTED, WITH_UNITS (Ruby symbol, Python string).")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'value = tlm("INST HEALTH_STATUS COLLECTS")\nvalue = tlm_raw("INST HEALTH_STATUS COLLECTS")\nvalue = tlm_formatted("INST HEALTH_STATUS COLLECTS")\nvalue = tlm_with_units("INST HEALTH_STATUS COLLECTS")\n# Equivalent to tlm_raw\nraw_value = tlm("INST HEALTH_STATUS COLLECTS", type: :RAW)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'value = tlm("INST HEALTH_STATUS COLLECTS")\nvalue = tlm_raw("INST HEALTH_STATUS COLLECTS")\nvalue = tlm_formatted("INST HEALTH_STATUS COLLECTS")\nvalue = tlm_with_units("INST HEALTH_STATUS COLLECTS")\n# Equivalent to tlm_raw\nraw_value = tlm("INST HEALTH_STATUS COLLECTS", type=\'RAW\')\n')),(0,r.kt)("h3",{id:"get_tlm_buffer"},"get_tlm_buffer"),(0,r.kt)("p",null,"Returns a packet hash (similar to get_telemetry) along with the raw packet buffer."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'buffer = get_tlm_buffer("<Target Name>", "<Packet Name>")[\'buffer\']\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the packet.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'packet = get_tlm_buffer("INST", "HEALTH_STATUS")\npacket[\'buffer\']\n')),(0,r.kt)("h3",{id:"get_tlm_packet"},"get_tlm_packet"),(0,r.kt)("p",null,"Returns the names, values, and limits states of all telemetry items in a specified packet. The value is returned as an array of arrays with each entry containing ","[item_name, item_value, limits_state]","."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_tlm_packet("<Target Name>", "<Packet Name>", <type>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the packet.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"type"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter specifying the type. RAW, CONVERTED (default), FORMATTED, or WITH_UNITS (Ruby symbol, Python string).")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'names_values_and_limits_states = get_tlm_packet("INST", "HEALTH_STATUS", type: :FORMATTED)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'names_values_and_limits_states = get_tlm_packet("INST", "HEALTH_STATUS", type=\'FORMATTED\')\n')),(0,r.kt)("h3",{id:"get_tlm_values-modified-in-500"},"get_tlm_values (modified in 5.0.0)"),(0,r.kt)("p",null,"Returns the values and current limits state for a specified set of telemetry items. Items can be in any telemetry packet in the system. They can all be retrieved using the same value type or a specific value type can be specified for each item."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"values, limits_states, limits_settings, limits_set = get_tlm_values(<Items>)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Items"),(0,r.kt)("td",{parentName:"tr",align:null},"Array of strings of the form ","['TGT",(0,r.kt)("strong",{parentName:"td"},"PKT"),"ITEM__TYPE', ... ]")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'values = get_tlm_values(["INST__HEALTH_STATUS__TEMP1__CONVERTED", "INST__HEALTH_STATUS__TEMP2__RAW"])\nprint(values) # [[-100.0, :RED_LOW], [0, :RED_LOW]]\n')),(0,r.kt)("h3",{id:"get_all_telemetry-since-500"},"get_all_telemetry (since 5.0.0)"),(0,r.kt)("p",null,"Returns an array of all target packet hashes."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_all_telemetry("<Target Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'packets = get_all_telemetry("INST")\nprint(packets)\n#[{"target_name"=>"INST",\n#  "packet_name"=>"ADCS",\n#  "endianness"=>"BIG_ENDIAN",\n#  "description"=>"Position and attitude data",\n#  "stale"=>true,\n#  "items"=>\n#   [{"name"=>"CCSDSVER",\n#     "bit_offset"=>0,\n#     "bit_size"=>3,\n#     ...\n')),(0,r.kt)("h3",{id:"get_all_telemetry_names-since-506"},"get_all_telemetry_names (since 5.0.6)"),(0,r.kt)("p",null,"Returns an array of all target packet names."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_all_telemetry_names("<Target Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_all_telemetry_names("INST")  #=> ["ADCS", "HEALTH_STATUS", ...]\n')),(0,r.kt)("h3",{id:"get_telemetry-since-500"},"get_telemetry (since 5.0.0)"),(0,r.kt)("p",null,"Returns a packet hash."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_telemetry("<Target Name>", "<Packet Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the packet.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'packet = get_telemetry("INST", "HEALTH_STATUS")\nprint(packet)\n#{"target_name"=>"INST",\n# "packet_name"=>"HEALTH_STATUS",\n# "endianness"=>"BIG_ENDIAN",\n# "description"=>"Health and status from the instrument",\n# "stale"=>true,\n# "processors"=>\n#  [{"name"=>"TEMP1STAT",\n#    "class"=>"OpenC3::StatisticsProcessor",\n#    "params"=>["TEMP1", 100, "CONVERTED"]},\n#   {"name"=>"TEMP1WATER",\n#    "class"=>"OpenC3::WatermarkProcessor",\n#    "params"=>["TEMP1", "CONVERTED"]}],\n# "items"=>\n#  [{"name"=>"CCSDSVER",\n#    "bit_offset"=>0,\n#    "bit_size"=>3,\n#    ...\n')),(0,r.kt)("h3",{id:"get_item-since-500"},"get_item (since 5.0.0)"),(0,r.kt)("p",null,"Returns an item hash."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_item("<Target Name>", "<Packet Name>", "<Item Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the packet.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the item.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'item = get_item("INST", "HEALTH_STATUS", "CCSDSVER")\nprint(item)\n#{"name"=>"CCSDSVER",\n# "bit_offset"=>0,\n# "bit_size"=>3,\n# "data_type"=>"UINT",\n# "description"=>"CCSDS packet version number (See CCSDS 133.0-B-1)",\n# "endianness"=>"BIG_ENDIAN",\n# "required"=>false,\n# "overflow"=>"ERROR"}\n')),(0,r.kt)("h3",{id:"get_tlm_cnt"},"get_tlm_cnt"),(0,r.kt)("p",null,"Returns the number of times a specified telemetry packet has been received."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_tlm_cnt("<Target Name>", "<Packet Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'tlm_cnt = get_tlm_cnt("INST", "HEALTH_STATUS") # Number of times the INST HEALTH_STATUS telemetry packet has been received.\n')),(0,r.kt)("h3",{id:"set_tlm"},"set_tlm"),(0,r.kt)("p",null,"Sets a telemetry item value in the Command and Telemetry Server. This value will be overwritten if a new packet is received from an interface. For that reason this method is most useful if interfaces are disconnected or for testing via the Script Runner disconnect mode. Manually setting telemetry values allows for the execution of many logical paths in scripts."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'set_tlm("<Target> <Packet> <Item> = <Value>", <type>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target"),(0,r.kt)("td",{parentName:"tr",align:null},"Target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet"),(0,r.kt)("td",{parentName:"tr",align:null},"Packet name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item"),(0,r.kt)("td",{parentName:"tr",align:null},"Item name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Value to set")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"type"),(0,r.kt)("td",{parentName:"tr",align:null},"Value type RAW, CONVERTED (default), FORMATTED, WITH_UNITS (Ruby symbol, Python string)")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'set_tlm("INST HEALTH_STATUS COLLECTS = 5") # type is :CONVERTED by default\ncheck("INST HEALTH_STATUS COLLECTS == 5")\nset_tlm("INST HEALTH_STATUS COLLECTS = 10", type: :RAW)\ncheck("INST HEALTH_STATUS COLLECTS == 10", type: :RAW)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'set_tlm("INST HEALTH_STATUS COLLECTS = 5") # type is CONVERTED by default\ncheck("INST HEALTH_STATUS COLLECTS == 5")\nset_tlm("INST HEALTH_STATUS COLLECTS = 10", type=\'RAW\')\ncheck("INST HEALTH_STATUS COLLECTS == 10", type=\'RAW\')\n')),(0,r.kt)("h3",{id:"inject_tlm"},"inject_tlm"),(0,r.kt)("p",null,"Injects a packet into the system as if it was received from an interface."),(0,r.kt)("p",null,"Ruby / Packet Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'inject_tlm("<target_name>", "<packet_name>", <item_hash>, <type>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target"),(0,r.kt)("td",{parentName:"tr",align:null},"Target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet"),(0,r.kt)("td",{parentName:"tr",align:null},"Packet name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Hash"),(0,r.kt)("td",{parentName:"tr",align:null},"Hash of item name/value for each item. If an item is not specified in the hash, the current value table value will be used. Optional parameter, defaults to nil.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"type"),(0,r.kt)("td",{parentName:"tr",align:null},"Type of values in the item hash, RAW, CONVERTED (default), FORMATTED, WITH_UNITS (Ruby symbol, Python string)")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"inject_tlm(\"INST\", \"PARAMS\", {'VALUE1' => 5.0, 'VALUE2' => 7.0})\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"inject_tlm(\"INST\", \"PARAMS\", {'VALUE1': 5.0, 'VALUE2': 7.0})\n")),(0,r.kt)("h3",{id:"override_tlm"},"override_tlm"),(0,r.kt)("p",null,"Sets the converted value for a telmetry point in the Command and Telemetry Server. This value will be maintained even if a new packet is received on the interface unless the override is canceled with the normalize_tlm method."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'override_tlm("<Target> <Packet> <Item> = <Value>", <type>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target"),(0,r.kt)("td",{parentName:"tr",align:null},"Target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet"),(0,r.kt)("td",{parentName:"tr",align:null},"Packet name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item"),(0,r.kt)("td",{parentName:"tr",align:null},"Item name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Value to set")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"type"),(0,r.kt)("td",{parentName:"tr",align:null},"Type to override, ALL (default), RAW, CONVERTED, FORMATTED, WITH_UNITS (Ruby symbol, Python string)")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'override_tlm("INST HEALTH_STATUS TEMP1 = 5") # All requests for TEMP1 return 5\noverride_tlm("INST HEALTH_STATUS TEMP2 = 0", type: :RAW) # Only RAW tlm set to 0\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'override_tlm("INST HEALTH_STATUS TEMP1 = 5") # All requests for TEMP1 return 5\noverride_tlm("INST HEALTH_STATUS TEMP2 = 0", type=\'RAW\') # Only RAW tlm set to 0\n')),(0,r.kt)("h3",{id:"normalize_tlm"},"normalize_tlm"),(0,r.kt)("p",null,"Clears the override of a telmetry point in the Command and Telemetry Server."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'normalize_tlm("<Target> <Packet> <Item>", <type>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target"),(0,r.kt)("td",{parentName:"tr",align:null},"Target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet"),(0,r.kt)("td",{parentName:"tr",align:null},"Packet name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item"),(0,r.kt)("td",{parentName:"tr",align:null},"Item name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"type"),(0,r.kt)("td",{parentName:"tr",align:null},"Type to normalize, ALL (default), RAW, CONVERTED, FORMATTED, WITH_UNITS (Ruby symbol, Python string)")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'normalize_tlm("INST HEALTH_STATUS TEMP1") # clear all overrides\nnormalize_tlm("INST HEALTH_STATUS TEMP1", type: :RAW) # clear only the RAW override\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'normalize_tlm("INST HEALTH_STATUS TEMP1") # clear all overrides\nnormalize_tlm("INST HEALTH_STATUS TEMP1", type=\'RAW\') # clear only the RAW override\n')),(0,r.kt)("h3",{id:"get_overrides"},"get_overrides"),(0,r.kt)("p",null,"Returns an array of the the currently overriden values set by override_tlm. NOTE: This returns all the value types that are overriden which by default is all 4 values types when using override_tlm."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"get_overrides()\n")),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'override_tlm("INST HEALTH_STATUS TEMP1 = 5")\nputs get_overrides() #=>\n# [ {"target_name"=>"INST", "packet_name"=>"HEALTH_STATUS", "item_name"=>"TEMP1", "value_type"=>"RAW", "value"=>5}\n#   {"target_name"=>"INST", "packet_name"=>"HEALTH_STATUS", "item_name"=>"TEMP1", "value_type"=>"CONVERTED", "value"=>5}\n#   {"target_name"=>"INST", "packet_name"=>"HEALTH_STATUS", "item_name"=>"TEMP1", "value_type"=>"FORMATTED", "value"=>"5"}\n#   {"target_name"=>"INST", "packet_name"=>"HEALTH_STATUS", "item_name"=>"TEMP1", "value_type"=>"WITH_UNITS", "value"=>"5"} ]\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"override_tlm(\"INST HEALTH_STATUS TEMP1 = 5\")\nprint(get_overrides()) #=>\n# [ {'target_name': 'INST', 'packet_name': 'HEALTH_STATUS', 'item_name': 'TEMP1', 'value_type': 'RAW', 'value': 5},\n#   {'target_name': 'INST', 'packet_name': 'HEALTH_STATUS', 'item_name': 'TEMP1', 'value_type': 'CONVERTED', 'value': 5},\n#   {'target_name': 'INST', 'packet_name': 'HEALTH_STATUS', 'item_name': 'TEMP1', 'value_type': 'FORMATTED', 'value': '5'},\n#   {'target_name': 'INST', 'packet_name': 'HEALTH_STATUS', 'item_name': 'TEMP1', 'value_type': 'WITH_UNITS', 'value': '5'} ]\n")),(0,r.kt)("h2",{id:"packet-data-subscriptions"},"Packet Data Subscriptions"),(0,r.kt)("p",null,"Methods for subscribing to specific packets of data. This provides an interface to ensure that each telemetry packet is received and handled rather than relying on polling where some data may be missed."),(0,r.kt)("h3",{id:"subscribe_packets-since-503"},"subscribe_packets (since 5.0.3)"),(0,r.kt)("p",null,"Allows the user to listen for one or more telemetry packets of data to arrive. A unique id is returned which is used to retrieve the data."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"subscribe_packets(packets)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"packets"),(0,r.kt)("td",{parentName:"tr",align:null},"Nested array of target name/packet name pairs that the user wishes to subscribe to.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"id = subscribe_packets([['INST', 'HEALTH_STATUS'], ['INST', 'ADCS']])\n")),(0,r.kt)("h3",{id:"get_packets-since-503"},"get_packets (since 5.0.3)"),(0,r.kt)("p",null,"Streams packet data from a previous subscription."),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"get_packets(id, block: nil, count: 1000)\n")),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"get_packets(id, block=None, count=1000)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"id"),(0,r.kt)("td",{parentName:"tr",align:null},"Unique id returned by subscribe_packets")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"block"),(0,r.kt)("td",{parentName:"tr",align:null},"Number of milliseconds to block while waiting for packets form ANY stream, default nil / None (do not block)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"count"),(0,r.kt)("td",{parentName:"tr",align:null},"Maximum number of packets to return from EACH packet stream")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"id = subscribe_packets([['INST', 'HEALTH_STATUS'], ['INST', 'ADCS']])\nwait 0.1\nid, packets = get_packets(id)\npackets.each do |packet|\n  puts \"#{packet['PACKET_TIMESECONDS']}: #{packet['target_name']} #{packet['packet_name']}\"\nend\n# Reuse ID from last call, allow for 1s wait, only get 1 packet\nid, packets = get_packets(id, block: 1000, count: 1)\npackets.each do |packet|\n  puts \"#{packet['PACKET_TIMESECONDS']}: #{packet['target_name']} #{packet['packet_name']}\"\nend\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"id = subscribe_packets([['INST', 'HEALTH_STATUS'], ['INST', 'ADCS']])\nwait(0.1)\nid, packets = get_packets(id)\nfor packet in packets:\n    print(f\"{packet['PACKET_TIMESECONDS']}: {packet['target_name']} {packet['packet_name']}\")\n\n# Reuse ID from last call, allow for 1s wait, only get 1 packet\nid, packets = get_packets(id, block=1000, count=1)\nfor packet in packets:\n    print(f\"{packet['PACKET_TIMESECONDS']}: {packet['target_name']} {packet['packet_name']}\")\n")),(0,r.kt)("h3",{id:"get_tlm_cnt-1"},"get_tlm_cnt"),(0,r.kt)("p",null,"Get the receive count for a telemetry packet"),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_tlm_cnt("<Target>", "<Packet>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target"),(0,r.kt)("td",{parentName:"tr",align:null},"Target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet"),(0,r.kt)("td",{parentName:"tr",align:null},"Packet name")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_tlm_cnt("INST", "HEALTH_STATUS")  #=> 10\n')),(0,r.kt)("h3",{id:"get_tlm_cnts"},"get_tlm_cnts"),(0,r.kt)("p",null,"Get the receive counts for an array of telemetry packets"),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_tlm_cnts([["<Target>", "<Packet>"], ["<Target>", "<Packet>"]])\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target"),(0,r.kt)("td",{parentName:"tr",align:null},"Target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet"),(0,r.kt)("td",{parentName:"tr",align:null},"Packet name")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_tlm_cnts([["INST", "ADCS"], ["INST", "HEALTH_STATUS"]])  #=> [100, 10]\n')),(0,r.kt)("h3",{id:"get_packet_derived_items"},"get_packet_derived_items"),(0,r.kt)("p",null,"Get the list of derived telemetry items for a packet"),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_packet_derived_items("<Target>", "<Packet>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target"),(0,r.kt)("td",{parentName:"tr",align:null},"Target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet"),(0,r.kt)("td",{parentName:"tr",align:null},"Packet name")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"get_packet_derived_items(\"INST\", \"HEALTH_STATUS\")  #=> ['PACKET_TIMESECONDS', 'PACKET_TIMEFORMATTED', ...]\n")),(0,r.kt)("h2",{id:"delays"},"Delays"),(0,r.kt)("p",null,"These methods allow the user to pause the script to wait for telemetry to change or for an amount of time to pass."),(0,r.kt)("h3",{id:"wait"},"wait"),(0,r.kt)("p",null,"Pauses the script for a configurable amount of time (minimum 10ms) or until a converted telemetry item meets given criteria. It supports three different syntaxes as shown. If no parameters are given then an infinite wait occurs until the user presses Go. Note that on a timeout, wait does not stop the script, usually wait_check is a better choice."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"wait()\nwait(<Time>)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Time"),(0,r.kt)("td",{parentName:"tr",align:null},"Time in Seconds to delay for.")))),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'wait("<Target Name> <Packet Name> <Item Name> <Comparison>", <Timeout>, <Polling Rate (optional)>, type, quiet)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Comparison"),(0,r.kt)("td",{parentName:"tr",align:null},"A comparison to perform against the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Timeout"),(0,r.kt)("td",{parentName:"tr",align:null},"Timeout in seconds. Script will proceed if the wait statement times out waiting for the comparison to be true.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Polling Rate"),(0,r.kt)("td",{parentName:"tr",align:null},"How often the comparison is evaluated in seconds. Defaults to 0.25 if not specified.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"type"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter specifying the type. RAW, CONVERTED (default), FORMATTED, WITH_UNITS (Ruby symbol, Python string).")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"quiet"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter indicating whether to log the result. Defaults to true.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'wait\nwait 5\nwait("INST HEALTH_STATUS COLLECTS == 3", 10)\nwait("INST HEALTH_STATUS COLLECTS == 3", 10, type: :RAW, quiet: false)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'wait()\nwait(5)\nwait("INST HEALTH_STATUS COLLECTS == 3", 10)\nwait("INST HEALTH_STATUS COLLECTS == 3", 10, type=\'RAW\', quiet=False)\n')),(0,r.kt)("h3",{id:"wait_tolerance"},"wait_tolerance"),(0,r.kt)("p",null,"Pauses the script for a configurable amount of time or until a converted telemetry item meets equals an expected value within a tolerance. Note that on a timeout, wait_tolerance does not stop the script, usually wait_check_tolerance is a better choice."),(0,r.kt)("p",null,"Ruby Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'wait_tolerance("<Target Name> <Packet Name> <Item Name>", <Expected Value>, <Tolerance>, <Timeout>, <Polling Rate (optional), type, quiet>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Expected Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Expected value of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Tolerance"),(0,r.kt)("td",{parentName:"tr",align:null},"\xb1 Tolerance on the expected value.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Timeout"),(0,r.kt)("td",{parentName:"tr",align:null},"Timeout in seconds. Script will proceed if the wait statement times out waiting for the comparison to be true.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Polling Rate"),(0,r.kt)("td",{parentName:"tr",align:null},"How often the comparison is evaluated in seconds. Defaults to 0.25 if not specified.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"type"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter specifying the type. RAW, CONVERTED (default), FORMATTED, WITH_UNITS (Ruby symbol, Python string).")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"quiet"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter indicating whether to log the result. Defaults to true.")))),(0,r.kt)("p",null,"Ruby Examples:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'wait_tolerance("INST HEALTH_STATUS COLLECTS", 10.0, 5.0, 10)\nwait_tolerance("INST HEALTH_STATUS COLLECTS", 10.0, 5.0, 10, type: :RAW, quiet: true)\n')),(0,r.kt)("p",null,"Python Examples:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'wait_tolerance("INST HEALTH_STATUS COLLECTS", 10.0, 5.0, 10)\nwait_tolerance("INST HEALTH_STATUS COLLECTS", 10.0, 5.0, 10, type=\'RAW\', quiet=True)\n')),(0,r.kt)("h3",{id:"wait_expression"},"wait_expression"),(0,r.kt)("p",null,"Pauses the script until an expression is evaluated to be true or a timeout occurs. If a timeout occurs the script will continue. This method can be used to perform more complicated comparisons than using wait as shown in the example. Note that on a timeout, wait_expression does not stop the script, usually ",(0,r.kt)("a",{parentName:"p",href:"#waitcheckexpression"},"wait_check_expression")," is a better choice."),(0,r.kt)("p",null,"Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'wait_expression("<Expression>", <Timeout>, <Polling Rate (optional)>, quiet)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Expression"),(0,r.kt)("td",{parentName:"tr",align:null},"A ruby expression to evaluate.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Timeout"),(0,r.kt)("td",{parentName:"tr",align:null},"Timeout in seconds. Script will proceed if the wait statement times out waiting for the comparison to be true.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Polling Rate"),(0,r.kt)("td",{parentName:"tr",align:null},"How often the comparison is evaluated in seconds. Defaults to 0.25 if not specified.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"quiet"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter indicating whether to log the result. Defaults to true.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"wait_expression(\"tlm('INST HEALTH_STATUS COLLECTS') > 5 and tlm('INST HEALTH_STATUS TEMP1') > 25.0\", 10)\n")),(0,r.kt)("h3",{id:"wait_packet"},"wait_packet"),(0,r.kt)("p",null,"Pauses the script until a certain number of packets have been received. If a timeout occurs the script will continue. Note that on a timeout, wait_packet does not stop the script, usually wait_check_packet is a better choice."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'wait_packet("<Target>", "<Packet>", <Num Packets>, <Timeout>, <Polling Rate (optional)>, quiet)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target"),(0,r.kt)("td",{parentName:"tr",align:null},"The target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet"),(0,r.kt)("td",{parentName:"tr",align:null},"The packet name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Num Packets"),(0,r.kt)("td",{parentName:"tr",align:null},"The number of packets to receive")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Timeout"),(0,r.kt)("td",{parentName:"tr",align:null},"Timeout in seconds.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Polling Rate"),(0,r.kt)("td",{parentName:"tr",align:null},"How often the comparison is evaluated in seconds. Defaults to 0.25 if not specified.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"quiet"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter indicating whether to log the result. Defaults to true.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"wait_packet('INST', 'HEALTH_STATUS', 5, 10) # Wait for 5 INST HEALTH_STATUS packets over 10s\n")),(0,r.kt)("h3",{id:"wait_check"},"wait_check"),(0,r.kt)("p",null,"Combines the wait and check keywords into one. This pauses the script until the converted value of a telemetry item meets given criteria or times out. On a timeout the script stops."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'wait_check("<Target Name> <Packet Name> <Item Name> <Comparison>", <Timeout>, <Polling Rate (optional)>, type)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Comparison"),(0,r.kt)("td",{parentName:"tr",align:null},"A comparison to perform against the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Timeout"),(0,r.kt)("td",{parentName:"tr",align:null},"Timeout in seconds. Script will stop if the wait statement times out waiting for the comparison to be true.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Polling Rate"),(0,r.kt)("td",{parentName:"tr",align:null},"How often the comparison is evaluated in seconds. Defaults to 0.25 if not specified.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"type"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter specifying the type. RAW, CONVERTED (default), FORMATTED, WITH_UNITS (Ruby symbol, Python string).")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'wait_check("INST HEALTH_STATUS COLLECTS > 5", 10)\nwait_check("INST HEALTH_STATUS COLLECTS > 5", 10, type: :RAW)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'wait_check("INST HEALTH_STATUS COLLECTS > 5", 10)\nwait_check("INST HEALTH_STATUS COLLECTS > 5", 10, type=\'RAW\')\n')),(0,r.kt)("h3",{id:"wait_check_tolerance"},"wait_check_tolerance"),(0,r.kt)("p",null,"Pauses the script for a configurable amount of time or until a converted telemetry item equals an expected value within a tolerance. On a timeout the script stops."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'wait_check_tolerance("<Target Name> <Packet Name> <Item Name>", <Expected Value>, <Tolerance>, <Timeout>, <Polling Rate (optional)>, type)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Expected Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Expected value of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Tolerance"),(0,r.kt)("td",{parentName:"tr",align:null},"\xb1 Tolerance on the expected value.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Timeout"),(0,r.kt)("td",{parentName:"tr",align:null},"Timeout in seconds. Script will stop if the wait statement times out waiting for the comparison to be true.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Polling Rate"),(0,r.kt)("td",{parentName:"tr",align:null},"How often the comparison is evaluated in seconds. Defaults to 0.25 if not specified.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"type"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter specifying the type. RAW, CONVERTED (default), FORMATTED, WITH_UNITS (Ruby symbol, Python string).")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'wait_check_tolerance("INST HEALTH_STATUS COLLECTS", 10.0, 5.0, 10)\nwait_check_tolerance("INST HEALTH_STATUS COLLECTS", 10.0, 5.0, 10, type: :RAW)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'wait_check_tolerance("INST HEALTH_STATUS COLLECTS", 10.0, 5.0, 10)\nwait_check_tolerance("INST HEALTH_STATUS COLLECTS", 10.0, 5.0, 10, type=\'RAW\')\n')),(0,r.kt)("h3",{id:"wait_check_expression"},"wait_check_expression"),(0,r.kt)("p",null,"Pauses the script until an expression is evaluated to be true or a timeout occurs. If a timeout occurs the script will stop. This method can be used to perform more complicated comparisons than using wait as shown in the example. Also see the syntax notes for ",(0,r.kt)("a",{parentName:"p",href:"#checkexpression"},"check_expression"),"."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'wait_check_expression("<Expression>", <Timeout>, <Polling Rate (optional)>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Expression"),(0,r.kt)("td",{parentName:"tr",align:null},"A ruby expression to evaluate.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Timeout"),(0,r.kt)("td",{parentName:"tr",align:null},"Timeout in seconds. Script will stop if the wait statement times out waiting for the comparison to be true.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Polling Rate"),(0,r.kt)("td",{parentName:"tr",align:null},"How often the comparison is evaluated in seconds. Defaults to 0.25 if not specified.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"wait_check_expression(\"tlm('INST HEALTH_STATUS COLLECTS') > 5 and tlm('INST HEALTH_STATUS TEMP1') > 25.0\", 10)\n")),(0,r.kt)("h3",{id:"wait_check_packet"},"wait_check_packet"),(0,r.kt)("p",null,"Pauses the script until a certain number of packets have been received. If a timeout occurs the script will stop."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'wait_check_packet("<Target>", "<Packet>", <Num Packets>, <Timeout>, <Polling Rate (optional)>, quiet)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target"),(0,r.kt)("td",{parentName:"tr",align:null},"The target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet"),(0,r.kt)("td",{parentName:"tr",align:null},"The packet name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Num Packets"),(0,r.kt)("td",{parentName:"tr",align:null},"The number of packets to receive")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Timeout"),(0,r.kt)("td",{parentName:"tr",align:null},"Timeout in seconds. Script will stop if the wait statement times out waiting specified number of packets.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Polling Rate"),(0,r.kt)("td",{parentName:"tr",align:null},"How often the comparison is evaluated in seconds. Defaults to 0.25 if not specified.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"quiet"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter indicating whether to log the result. Defaults to true.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"wait_check_packet('INST', 'HEALTH_STATUS', 5, 10) # Wait for 5 INST HEALTH_STATUS packets over 10s\n")),(0,r.kt)("h2",{id:"limits"},"Limits"),(0,r.kt)("p",null,"These methods deal with handling telemetry limits."),(0,r.kt)("h3",{id:"limits_enabled-limits_enabled"},"limits_enabled?, limits_enabled"),(0,r.kt)("p",null,"The limits_enabled? method returns true/false depending on whether limits are enabled for a telemetry item."),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'limits_enabled?("<Target Name> <Packet Name> <Item Name>")\n')),(0,r.kt)("p",null,"Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'limits_enabled("<Target Name> <Packet Name> <Item Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry item.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'enabled = limits_enabled?("INST HEALTH_STATUS TEMP1") #=> true or false\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'enabled = limits_enabled("INST HEALTH_STATUS TEMP1") #=> True or False\n')),(0,r.kt)("h3",{id:"enable_limits"},"enable_limits"),(0,r.kt)("p",null,"Enables limits monitoring for the specified telemetry item."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'enable_limits("<Target Name> <Packet Name> <Item Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry item.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'enable_limits("INST HEALTH_STATUS TEMP1")\n')),(0,r.kt)("h3",{id:"disable_limits"},"disable_limits"),(0,r.kt)("p",null,"Disables limits monitoring for the specified telemetry item."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'disable_limits("<Target Name> <Packet Name> <Item Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry item.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'disable_limits("INST HEALTH_STATUS TEMP1")\n')),(0,r.kt)("h3",{id:"enable_limits_group"},"enable_limits_group"),(0,r.kt)("p",null,"Enables limits monitoring on a set of telemetry items specified in a limits group."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'enable_limits_group("<Limits Group Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Limits Group Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the limits group.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'enable_limits_group("SAFE_MODE")\n')),(0,r.kt)("h3",{id:"disable_limits_group"},"disable_limits_group"),(0,r.kt)("p",null,"Disables limits monitoring on a set of telemetry items specified in a limits group."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'disable_limits_group("<Limits Group Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Limits Group Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the limits group.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'disable_limits_group("SAFE_MODE")\n')),(0,r.kt)("h3",{id:"get_limits_groups"},"get_limits_groups"),(0,r.kt)("p",null,"Returns the list of limits groups in the system."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"limits_groups = get_limits_groups()\n")),(0,r.kt)("h3",{id:"set_limits_set"},"set_limits_set"),(0,r.kt)("p",null,"Sets the current limits set. The default limits set is DEFAULT."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'set_limits_set("<Limits Set Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Limits Set Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the limits set.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'set_limits_set("DEFAULT")\n')),(0,r.kt)("h3",{id:"get_limits_set"},"get_limits_set"),(0,r.kt)("p",null,"Returns the name of the current limits set. The default limits set is DEFAULT."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"limits_set = get_limits_set()\n")),(0,r.kt)("h3",{id:"get_limits_sets"},"get_limits_sets"),(0,r.kt)("p",null,"Returns the list of limits sets in the system."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"limits_sets = get_limits_sets()\n")),(0,r.kt)("h3",{id:"get_limits"},"get_limits"),(0,r.kt)("p",null,"Returns limits settings for a telemetry point."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"get_limits(<Target Name>, <Packet Name>, <Item Name>, <Limits Set (optional)>)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Limits Set"),(0,r.kt)("td",{parentName:"tr",align:null},"Get the limits for a specific limits set. If not given then it defaults to returning the settings for the current limits set.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"limits_set, persistence_setting, enabled, red_low, yellow_low, yellow_high, red_high, green_low, green_high = get_limits('INST', 'HEALTH_STATUS', 'TEMP1')\n")),(0,r.kt)("h3",{id:"set_limits"},"set_limits"),(0,r.kt)("p",null,"The set_limits_method sets limits settings for a telemetry point. Note: In most cases it would be better to update your config files or use different limits sets rather than changing limits settings in realtime."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"set_limits(<Target Name>, <Packet Name>, <Item Name>, <Red Low>, <Yellow Low>, <Yellow High>, <Red High>, <Green Low (optional)>, <Green High (optional)>, <Limits Set (optional)>, <Persistence (optional)>, <Enabled (optional)>)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Packet Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry packet of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Item Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the telemetry item.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Red Low"),(0,r.kt)("td",{parentName:"tr",align:null},"Red Low setting for this limits set. Any value below this value will be make the item red.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Yellow Low"),(0,r.kt)("td",{parentName:"tr",align:null},"Yellow Low setting for this limits set. Any value below this value but greater than Red Low will be make the item yellow.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Yellow High"),(0,r.kt)("td",{parentName:"tr",align:null},"Yellow High setting for this limits set. Any value above this value but less than Red High will be make the item yellow.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Red High"),(0,r.kt)("td",{parentName:"tr",align:null},"Red High setting for this limits set. Any value above this value will be make the item red.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Green Low"),(0,r.kt)("td",{parentName:"tr",align:null},"Optional. If given, any value greater than Green Low and less than Green_High will make the item blue indicating a good operational value.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Green High"),(0,r.kt)("td",{parentName:"tr",align:null},"Optional. If given, any value greater than Green Low and less than Green_High will make the item blue indicating a good operational value.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Limits Set"),(0,r.kt)("td",{parentName:"tr",align:null},"Optional. Set the limits for a specific limits set. If not given then it defaults to setting limts for the CUSTOM limits set.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Persistence"),(0,r.kt)("td",{parentName:"tr",align:null},"Optional. Set the number of samples this item must be out of limits before changing limits state. Defaults to no change. Note: This affects all limits settings across limits sets.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Enabled"),(0,r.kt)("td",{parentName:"tr",align:null},"Optional. Whether or not limits are enabled for this item. Defaults to true. Note: This affects all limits settings across limits sets.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"set_limits('INST', 'HEALTH_STATUS', 'TEMP1', -10.0, 0.0, 50.0, 60.0, 30.0, 40.0, 'TVAC', 1, true)\n")),(0,r.kt)("h3",{id:"get_out_of_limits"},"get_out_of_limits"),(0,r.kt)("p",null,"Returns an array with the target_name, packet_name, item_name, and limits_state of all items that are out of their limits ranges."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"out_of_limits_items = get_out_of_limits()\n")),(0,r.kt)("h3",{id:"get_overall_limits_state"},"get_overall_limits_state"),(0,r.kt)("p",null,"Returns the overall limits state for the COSMOS system. Returns 'GREEN', 'YELLOW', or 'RED'."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"get_overall_limits_state(<Ignored Items> (optional))\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Ignored Items"),(0,r.kt)("td",{parentName:"tr",align:null},"Array of arrays with items to ignore when determining the overall limits state. [","['TARGET_NAME', 'PACKET_NAME', 'ITEM_NAME']",", ...]")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"overall_limits_state = get_overall_limits_state()\noverall_limits_state = get_overall_limits_state([['INST', 'HEALTH_STATUS', 'TEMP1']])\n")),(0,r.kt)("h3",{id:"get_limits_events"},"get_limits_events"),(0,r.kt)("p",null,"Returns limits events based on an offset returned from the last time it was called."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"get_limits_event(<Offset>, count)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Offset"),(0,r.kt)("td",{parentName:"tr",align:null},"Offset returned by the previous call to get_limits_event. Default is nil for the initial call")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"count"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter specifying the maximum number of limits events to return. Default is 100")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'events = get_limits_event()\nprint(events)\n#[["1613077715557-0",\n#  {"type"=>"LIMITS_CHANGE",\n#   "target_name"=>"TGT",\n#   "packet_name"=>"PKT",\n#   "item_name"=>"ITEM",\n#   "old_limits_state"=>"YELLOW_LOW",\n#   "new_limits_state"=>"RED_LOW",\n#   "time_nsec"=>"1",\n#   "message"=>"message"}],\n# ["1613077715557-1",\n#  {"type"=>"LIMITS_CHANGE",\n#   "target_name"=>"TGT",\n#   "packet_name"=>"PKT",\n#   "item_name"=>"ITEM",\n#   "old_limits_state"=>"RED_LOW",\n#   "new_limits_state"=>"YELLOW_LOW",\n#   "time_nsec"=>"2",\n#   "message"=>"message"}]]\n# The last offset is the first item ([0]) in the last event ([-1])\nevents = get_limits_event(events[-1][0])\nprint(events)\n#[["1613077715657-0",\n#  {"type"=>"LIMITS_CHANGE",\n#   ...\n')),(0,r.kt)("h2",{id:"targets"},"Targets"),(0,r.kt)("p",null,"Methods for getting knowledge about targets."),(0,r.kt)("h3",{id:"get_target_names"},"get_target_names"),(0,r.kt)("p",null,"Returns a list of the targets in the system in an array."),(0,r.kt)("p",null,"Ruby Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"targets = get_target_names() #=> ['INST', 'INST2', 'EXAMPLE', 'TEMPLATED']\n")),(0,r.kt)("h3",{id:"get_target"},"get_target"),(0,r.kt)("p",null,"Returns a target hash containing all the information about the target."),(0,r.kt)("p",null,"Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_target("<Target Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'target = get_target("INST")\nprint(target)\n#{"name"=>"INST",\n# "folder_name"=>"INST",\n# "requires"=>[],\n# "ignored_parameters"=>\n#  ["CCSDSVER",\n#   "CCSDSTYPE",\n#   "CCSDSSHF",\n#   "CCSDSAPID",\n#   "CCSDSSEQFLAGS",\n#   "CCSDSSEQCNT",\n#   "CCSDSLENGTH",\n#   "PKTID"],\n# "ignored_items"=>\n#  ["CCSDSVER",\n#   "CCSDSTYPE",\n#   "CCSDSSHF",\n#   "CCSDSAPID",\n#   "CCSDSSEQFLAGS",\n#   "CCSDSSEQCNT",\n#   "CCSDSLENGTH",\n#   "RECEIVED_COUNT",\n#   "RECEIVED_TIMESECONDS",\n#   "RECEIVED_TIMEFORMATTED"],\n# "limits_groups"=>[],\n# "cmd_tlm_files"=>\n#  [".../targets/INST/cmd_tlm/inst_cmds.txt",\n#   ".../targets/INST/cmd_tlm/inst_tlm.txt"],\n# "cmd_unique_id_mode"=>false,\n# "tlm_unique_id_mode"=>false,\n# "id"=>nil,\n# "updated_at"=>1613077058266815900,\n# "plugin"=>nil}\n')),(0,r.kt)("h3",{id:"get_target_interfaces"},"get_target_interfaces"),(0,r.kt)("p",null,"Returns the interfaces for all targets. The return value is an array of arrays where each subarray contains the target name, and a String of all the interface names."),(0,r.kt)("p",null,"Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'target_ints = get_target_interfaces()\ntarget_ints.each do |target_name, interfaces|\n  puts "Target: #{target_name}, Interfaces: #{interfaces}"\nend\n')),(0,r.kt)("h2",{id:"interfaces"},"Interfaces"),(0,r.kt)("p",null,"These methods allow the user to manipulate COSMOS interfaces."),(0,r.kt)("h3",{id:"get_interface-since-500"},"get_interface (since 5.0.0)"),(0,r.kt)("p",null,"Returns an interface status including the as built interface and its current status (cmd/tlm counters, etc)."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre"},'get_interface("<Interface Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Interface Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the interface.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'interface = get_interface("INST_INT")\nprint(interface)\n#{"name"=>"INST_INT",\n# "config_params"=>["interface.rb"],\n# "target_names"=>["INST"],\n# "connect_on_startup"=>true,\n# "auto_reconnect"=>true,\n# "reconnect_delay"=>5.0,\n# "disable_disconnect"=>false,\n# "options"=>[],\n# "protocols"=>[],\n# "log"=>true,\n# "log_raw"=>false,\n# "plugin"=>nil,\n# "updated_at"=>1613076213535979900,\n# "state"=>"CONNECTED",\n# "clients"=>0,\n# "txsize"=>0,\n# "rxsize"=>0,\n# "txbytes"=>0,\n# "rxbytes"=>0,\n# "txcnt"=>0,\n# "rxcnt"=>0}\n')),(0,r.kt)("h3",{id:"get_interface_names"},"get_interface_names"),(0,r.kt)("p",null,"Returns a list of the interfaces in the system in an array."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"interface_names = get_interface_names() #=> ['INST_INT', 'INST2_INT', 'EXAMPLE_INT', 'TEMPLATED_INT']\n")),(0,r.kt)("h3",{id:"connect_interface"},"connect_interface"),(0,r.kt)("p",null,"Connects to targets associated with a COSMOS interface."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'connect_interface("<Interface Name>", <Interface Parameters (optional)>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Interface Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the interface.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Interface Parameters"),(0,r.kt)("td",{parentName:"tr",align:null},"Parameters used to initialize the interface. If none are given then the interface will use the parameters that were given in the server configuration file.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'connect_interface("INT1")\nconnect_interface("INT1", hostname, port)\n')),(0,r.kt)("h3",{id:"disconnect_interface"},"disconnect_interface"),(0,r.kt)("p",null,"Disconnects from targets associated with a COSMOS interface."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'disconnect_interface("<Interface Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Interface Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the interface.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'disconnect_interface("INT1")\n')),(0,r.kt)("h3",{id:"start_raw_logging_interface"},"start_raw_logging_interface"),(0,r.kt)("p",null,"Starts logging of raw data on one or all interfaces. This is for debugging purposes only."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'start_raw_logging_interface("<Interface Name (optional)>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Interface Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the Interface to command to start raw data logging. Defaults to 'ALL' which causes all interfaces that support raw data logging to start logging raw data.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'start_raw_logging_interface("int1")\n')),(0,r.kt)("h3",{id:"stop_raw_logging_interface"},"stop_raw_logging_interface"),(0,r.kt)("p",null,"Stops logging of raw data on one or all interfaces. This is for debugging purposes only."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'stop_raw_logging_interface("<Interface Name (optional)>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Interface Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the Interface to command to stop raw data logging. Defaults to 'ALL' which causes all interfaces that support raw data logging to stop logging raw data.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'stop_raw_logging_interface("int1")\n')),(0,r.kt)("h3",{id:"get_all_interface_info"},"get_all_interface_info"),(0,r.kt)("p",null,"Returns information about all interfaces. The return value is an array of arrays where each subarray contains the interface name, connection state, number of connected clients, transmit queue size, receive queue size, bytes transmitted, bytes received, command count, and telemetry count."),(0,r.kt)("p",null,"Ruby Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'interface_info = get_all_interface_info()\ninterface_info.each do |interface_name, connection_state, num_clients, tx_q_size, rx_q_size, tx_bytes, rx_bytes, cmd_count, tlm_count|\n  puts "Interface: #{interface_name}, Connection state: #{connection_state}, Num connected clients: #{num_clients}"\n  puts "Transmit queue size: #{tx_q_size}, Receive queue size: #{rx_q_size}, Bytes transmitted: #{tx_bytes}, Bytes received: #{rx_bytes}"\n  puts "Cmd count: #{cmd_count}, Tlm count: #{tlm_count}"\nend\n')),(0,r.kt)("p",null,"Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'interface_info = get_all_interface_info()\nfor interface in interface_info():\n    # [interface_name, connection_state, num_clients, tx_q_size, rx_q_size, tx_bytes, rx_bytes, cmd_count, tlm_count]\n    print(f"Interface: {interface[0]}, Connection state: {interface[1]}, Num connected clients: {interface[2]}")\n    print(f"Transmit queue size: {interface[3]}, Receive queue size: {interface[4]}, Bytes transmitted: {interface[5]}, Bytes received: {interface[6]}")\n    print(f"Cmd count: {interface[7]}, Tlm count: {interface[8]}")\n')),(0,r.kt)("h3",{id:"map_target_to_interface"},"map_target_to_interface"),(0,r.kt)("p",null,"Map a target to an interface allowing target commands and telemetry to be processed by that interface."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'map_target_to_interface("<Target Name>", "<Interface Name>", cmd_only, tlm_only, unmap_old)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the target")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Interface Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the interface")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"cmd_only"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter whether to map target commands only to the interface (default: false)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"tlm_only"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter whether to map target telemetry only to the interface (default: false)")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"unmap_old"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter whether remove the target from all existing interfaces (default: true)")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'map_target_to_interface("INST", "INST_INT", unmap_old: false)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'map_target_to_interface("INST", "INST_INT", unmap_old=False)\n')),(0,r.kt)("h3",{id:"interface_cmd"},"interface_cmd"),(0,r.kt)("p",null,"Send a command directly to an interface. This has no effect in the standard COSMOS interfaces but can be implemented by a custom interface to change behavior."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'interface_cmd("<Interface Name>", "<Command Name>", "<Command Parameters>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Interface Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the interface")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the command to send")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Parameters"),(0,r.kt)("td",{parentName:"tr",align:null},"Any parameters to send with the command")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'interface_cmd("INST", "DISABLE_CRC")\n')),(0,r.kt)("h3",{id:"interface_protocol_cmd"},"interface_protocol_cmd"),(0,r.kt)("p",null,"Send a command directly to an interface protocol. This has no effect in the standard COSMOS protocols but can be implemented by a custom protocol to change behavior."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'interface_protocol_cmd("<Interface Name>", "<Command Name>", "<Command Parameters>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Interface Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the interface")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the command to send")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Parameters"),(0,r.kt)("td",{parentName:"tr",align:null},"Any parameters to send with the command")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"read_write"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether command gets send to read or write protocols. Must be one of READ, WRITE, or READ_WRITE (Ruby symbols, Python strings). The default is READ_WRITE.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"index"),(0,r.kt)("td",{parentName:"tr",align:null},"Which protocol in the stack the command should apply to. The default is -1 which applies the command to all.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'interface_protocol_cmd("INST", "DISABLE_CRC", read_write: :READ_WRITE, index: -1)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'interface_protocol_cmd("INST", "DISABLE_CRC", read_write=\'READ_WRITE\', index=-1)\n')),(0,r.kt)("h2",{id:"routers"},"Routers"),(0,r.kt)("p",null,"These methods allow the user to manipulate COSMOS routers."),(0,r.kt)("h3",{id:"connect_router"},"connect_router"),(0,r.kt)("p",null,"Connects a COSMOS router."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'connect_router("<Router Name>", <Router Parameters (optional)>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Router Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the router.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Router Parameters"),(0,r.kt)("td",{parentName:"tr",align:null},"Parameters used to initialize the router. If none are given then the router will use the parameters that were given in the server configuration file.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'connect_ROUTER("INST_ROUTER")\nconnect_router("INST_ROUTER", 7779, 7779, nil, 10.0, \'PREIDENTIFIED\')\n')),(0,r.kt)("h3",{id:"disconnect_router"},"disconnect_router"),(0,r.kt)("p",null,"Disconnects a COSMOS router."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'disconnect_router("<Router Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Router Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the router.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'disconnect_router("INT1_ROUTER")\n')),(0,r.kt)("h3",{id:"get_router_names"},"get_router_names"),(0,r.kt)("p",null,"Returns a list of the routers in the system in an array."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"router_names = get_router_names() #=> ['ROUTER_INT']\n")),(0,r.kt)("h3",{id:"get_router-since-500"},"get_router (since 5.0.0)"),(0,r.kt)("p",null,"Returns a router status including the as built router and its current status (cmd/tlm counters, etc)."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_router("<Router Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Router Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the router.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'router = get_router("ROUTER_INT")\nprint(router)\n#{"name"=>"ROUTER_INT",\n# "config_params"=>["router.rb"],\n# "target_names"=>["INST"],\n# "connect_on_startup"=>true,\n# "auto_reconnect"=>true,\n# "reconnect_delay"=>5.0,\n# "disable_disconnect"=>false,\n# "options"=>[],\n# "protocols"=>[],\n# "log"=>true,\n# "log_raw"=>false,\n# "plugin"=>nil,\n# "updated_at"=>1613076213535979900,\n# "state"=>"CONNECTED",\n# "clients"=>0,\n# "txsize"=>0,\n# "rxsize"=>0,\n# "txbytes"=>0,\n# "rxbytes"=>0,\n# "txcnt"=>0,\n# "rxcnt"=>0}\n')),(0,r.kt)("h3",{id:"get_all_router_info"},"get_all_router_info"),(0,r.kt)("p",null,"Returns information about all routers. The return value is an array of arrays where each subarray contains the router name, connection state, number of connected clients, transmit queue size, receive queue size, bytes transmitted, bytes received, packets received, and packets sent."),(0,r.kt)("p",null,"Ruby Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'router_info = get_all_router_info()\nrouter_info.each do |router_name, connection_state, num_clients, tx_q_size, rx_q_size, tx_bytes, rx_bytes, pkts_rcvd, pkts_sent|\n  puts "Router: #{router_name}, Connection state: #{connection_state}, Num connected clients: #{num_clients}"\n  puts "Transmit queue size: #{tx_q_size}, Receive queue size: #{rx_q_size}, Bytes transmitted: #{tx_bytes}, Bytes received: #{rx_bytes}"\n  puts "Packets received: #{pkts_rcvd}, Packets sent: #{pkts_sent}"\nend\n')),(0,r.kt)("p",null,"Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'router_info = get_all_router_info()\n# router_name, connection_state, num_clients, tx_q_size, rx_q_size, tx_bytes, rx_bytes, pkts_rcvd, pkts_sent\nfor router in router_info:\n    print(f"Router: {router[0]}, Connection state: {router[1]}, Num connected clients: {router[2]}")\n    print(f"Transmit queue size: {router[3]}, Receive queue size: {router[4]}, Bytes transmitted: {router[5]}, Bytes received: {router[6]}")\n    print(f"Packets received: {router[7]}, Packets sent: {router[8]}")\n')),(0,r.kt)("h3",{id:"start_raw_logging_router"},"start_raw_logging_router"),(0,r.kt)("p",null,"Starts logging of raw data on one or all routers. This is for debugging purposes only."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'start_raw_logging_router("<Router Name (optional)>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Router Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the Router to command to start raw data logging. Defaults to 'ALL' which causes all routers that support raw data logging to start logging raw data.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'start_raw_logging_router("router1")\n')),(0,r.kt)("h3",{id:"stop_raw_logging_router"},"stop_raw_logging_router"),(0,r.kt)("p",null,"Stops logging of raw data on one or all routers. This is for debugging purposes only."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'stop_raw_logging_router("<Router Name (optional)>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Router Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the Router to command to stop raw data logging. Defaults to 'ALL' which causes all routers that support raw data logging to stop logging raw data.")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'stop_raw_logging_router("router1")\n')),(0,r.kt)("h3",{id:"router_cmd"},"router_cmd"),(0,r.kt)("p",null,"Send a command directly to a router. This has no effect in the standard COSMOS routers but can be implemented by a custom router to change behavior."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'router_cmd("<Router Name>", "<Command Name>", "<Command Parameters>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Router Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the router")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the command to send")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Parameters"),(0,r.kt)("td",{parentName:"tr",align:null},"Any parameters to send with the command")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'router_cmd("INST", "DISABLE_CRC")\n')),(0,r.kt)("h3",{id:"router_protocol_cmd"},"router_protocol_cmd"),(0,r.kt)("p",null,"Send a command directly to an router protocol. This has no effect in the standard COSMOS protocols but can be implemented by a custom protocol to change behavior."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'router_protocol_cmd("<Router Name>", "<Command Name>", "<Command Parameters>", read_write, index)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Router Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the router")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the command to send")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Command Parameters"),(0,r.kt)("td",{parentName:"tr",align:null},"Any parameters to send with the command")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"read_write"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether command gets send to read or write protocols. Must be one of READ, WRITE, or READ_WRITE (Ruby symbols, Python strings). The default is READ_WRITE.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"index"),(0,r.kt)("td",{parentName:"tr",align:null},"Which protocol in the stack the command should apply to. The default is -1 which applies the command to all.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'router_protocol_cmd("INST", "DISABLE_CRC", read_write: :READ_WRITE, index: -1)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'router_protocol_cmd("INST", "DISABLE_CRC", read_write=\'READ_WRITE\', index=-1)\n')),(0,r.kt)("h2",{id:"stashing-data"},"Stashing Data"),(0,r.kt)("p",null,"These methods allow the user to store temporary data into COSMOS and retrieve it. The storage is implemented as a key / value storage (Ruby hash or Python dict). This can be used in scripts to store information that applies across multiple scripts or multiple runs of a single script."),(0,r.kt)("h3",{id:"stash_set"},"stash_set"),(0,r.kt)("p",null,"Sets a stash item."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'stash_set("<Stash Key>", <Stash Value>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Stash Key"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the stash key to set")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Stash Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Value to set")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"stash_set('run_count', 5)\nstash_set('setpoint', 23.4)\n")),(0,r.kt)("h3",{id:"stash_get"},"stash_get"),(0,r.kt)("p",null,"Returns the specified stash item."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'stash_get("<Stash Key>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Stash Key"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the stash key to return")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"stash_get('run_count')  #=> 5\n")),(0,r.kt)("h3",{id:"stash_all"},"stash_all"),(0,r.kt)("p",null,"Returns all the stash items as a Ruby hash or Python dict."),(0,r.kt)("p",null,"Ruby Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"stash_all()  #=> ['run_count' => 5, 'setpoint' => 23.4]\n")),(0,r.kt)("p",null,"Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"stash_all()  #=> ['run_count': 5, 'setpoint': 23.4]\n")),(0,r.kt)("h3",{id:"stash_keys"},"stash_keys"),(0,r.kt)("p",null,"Returns all the stash keys."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"stash_keys()  #=> ['run_count', 'setpoint']\n")),(0,r.kt)("h3",{id:"stash_delete"},"stash_delete"),(0,r.kt)("p",null,"Deletes a stash item. Note this actions is permanent!"),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'stash_delete("<Stash Key>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Stash Key"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the stash key to delete")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'stash_delete("run_count")\n')),(0,r.kt)("h2",{id:"executing-other-procedures"},"Executing Other Procedures"),(0,r.kt)("p",null,"These methods allow the user to bring in files of subroutines and execute other test procedures."),(0,r.kt)("h3",{id:"start"},"start"),(0,r.kt)("p",null,"Starts execution of another high level test procedure. No parameters can be given to high level test procedures. If parameters are necessary, then consider using a subroutine."),(0,r.kt)("p",null,"Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'start("<Procedure Filename>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Procedure Filename"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the test procedure file. These files are normally in the procedures folder but may be anywhere in the Ruby search path. Additionally, absolute paths are supported.")))),(0,r.kt)("p",null,"Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'start("test1.rb")\n')),(0,r.kt)("h3",{id:"load_utility"},"load_utility"),(0,r.kt)("p",null,"Reads in a script file that contains useful subroutines for use in your test procedure. When these subroutines run in ScriptRunner or TestRunner, their lines will be highlighted. If you want to import subroutines but do not want their lines to be highlighted in ScriptRunner or TestRunner, use the standard Ruby 'load' or 'require' statement or Python 'import' statement."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'load_utility("TARGET/lib/<Utility Filename>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Utility Filename"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the script file containing subroutines including the .rb or .py extension. You need to include the full target name and path such as TARGET/lib/utility.rb")))),(0,r.kt)("p",null,"Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'load_utility("TARGET/lib/mode_changes.rb") # Ruby\nload_utility("TARGET/lib/mode_changes.py") # Python\n')),(0,r.kt)("h2",{id:"opening-closing--creating-telemetry-screens"},"Opening, Closing & Creating Telemetry Screens"),(0,r.kt)("p",null,"These methods allow the user to open, close or create unique telemetry screens from within a test procedure."),(0,r.kt)("h3",{id:"display_screen"},"display_screen"),(0,r.kt)("p",null,"Opens a telemetry screen at the specified position."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'display_screen("<Target Name>", "<Screen Name>", <X Position (optional)>, <Y Position (optional)>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Telemetry screen target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Screen Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Screen name within the specified target")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"X Position"),(0,r.kt)("td",{parentName:"tr",align:null},"X coordinate for the upper left hand corner of the screen")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Y Position"),(0,r.kt)("td",{parentName:"tr",align:null},"Y coordinate for the upper left hand corner of the screen")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'display_screen("INST", "ADCS", 100, 200)\n')),(0,r.kt)("h3",{id:"clear_screen"},"clear_screen"),(0,r.kt)("p",null,"Closes an open telemetry screen."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'clear_screen("<Target Name>", "<Screen Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Telemetry screen target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Screen Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Screen name within the specified target")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'clear_screen("INST", "ADCS")\n')),(0,r.kt)("h3",{id:"clear_all_screens"},"clear_all_screens"),(0,r.kt)("p",null,"Closes all open screens."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"clear_all_screens()\n")),(0,r.kt)("h3",{id:"delete_screen"},"delete_screen"),(0,r.kt)("p",null,"Deletes an existing Telemetry Viewer screen."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'delete_screen("<Target Name>", "<Screen Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Telemetry screen target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Screen Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Screen name within the specified target")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'delete_screen("INST", "ADCS")\n')),(0,r.kt)("h3",{id:"get_screen_list"},"get_screen_list"),(0,r.kt)("p",null,"The get_screen_list returns a list of available telemetry screens."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"get_screen_list() #=> ['INST ADCS', 'INST COMMANDING', ...]\n")),(0,r.kt)("h3",{id:"get_screen_definition"},"get_screen_definition"),(0,r.kt)("p",null,"The get_screen_definition returns the text file contents of a telemetry screen definition."),(0,r.kt)("p",null,"Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'get_screen_definition("<Target Name>", "<Screen Name>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Telemetry screen target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Screen Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Screen name within the specified target")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'screen_definition = get_screen_definition("INST", "HS")\n')),(0,r.kt)("h3",{id:"create_screen"},"create_screen"),(0,r.kt)("p",null,"The create_screen allows you to create a screen directly from a script. This screen is saved to Telemetry Viewer for future use in that application."),(0,r.kt)("p",null,"Python / Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'create_screen("<Target Name>", "<Screen Name>" "<Definition>")\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Target Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Telemetry screen target name")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Screen Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Screen name within the specified target")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Definition"),(0,r.kt)("td",{parentName:"tr",align:null},"The entire screen definition as a String")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'screen_def = \'\n  SCREEN AUTO AUTO 0.1 FIXED\n  VERTICAL\n    TITLE "New Screen"\n    VERTICALBOX\n      LABELVALUE INST HEALTH_STATUS TEMP1\n    END\n  END\n\'\n# Here we pass in the screen definition as a string\ncreate_screen("INST", "LOCAL", screen_def)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'screen_def = \'\n  SCREEN AUTO AUTO 0.1 FIXED\n  VERTICAL\n    TITLE "New Screen"\n    VERTICALBOX\n      LABELVALUE INST HEALTH_STATUS TEMP1\n    END\n  END\n\'\n# Here we pass in the screen definition as a string\ncreate_screen("INST", "LOCAL", screen_def)\n')),(0,r.kt)("h3",{id:"local_screen"},"local_screen"),(0,r.kt)("p",null,"The local_screen allows you to create a local screen directly from a script which is not permanently saved to the Telemetry Viewer screen list. This is useful for one off screens that help users interact with scripts."),(0,r.kt)("p",null,"Python / Ruby Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'local_screen("<Screen Name>" "<Definition>", <X Position (optional)>, <Y Position (optional)>)\n')),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Screen Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Screen name within the specified target")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Definition"),(0,r.kt)("td",{parentName:"tr",align:null},"The entire screen definition as a String")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"X Position"),(0,r.kt)("td",{parentName:"tr",align:null},"X coordinate for the upper left hand corner of the screen")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Y Position"),(0,r.kt)("td",{parentName:"tr",align:null},"Y coordinate for the upper left hand corner of the screen")))),(0,r.kt)("p",null,"NOTE: It is possible to specify a X, Y location off the visible display. If you do so and try to re-create the screen it will not display (because it is already displayed). Try issuing a ",(0,r.kt)("inlineCode",{parentName:"p"},"clear_all_screens()")," first to clear any screens off the visible display space."),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'screen_def = \'\n  SCREEN AUTO AUTO 0.1 FIXED\n  VERTICAL\n    TITLE "Local Screen"\n    VERTICALBOX\n      LABELVALUE INST HEALTH_STATUS TEMP1\n    END\n  END\n\'\n# Here we pass in the screen definition as a string\nlocal_screen("TESTING", screen_def, 600, 75)\n')),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},'screen_def = \'\n  SCREEN AUTO AUTO 0.1 FIXED\n  VERTICAL\n    TITLE "Local Screen"\n    VERTICALBOX\n      LABELVALUE INST HEALTH_STATUS TEMP1\n    END\n  END\n\'\n# Here we pass in the screen definition as a string\nlocal_screen("TESTING", screen_def, 600, 75)\n')),(0,r.kt)("h2",{id:"script-runner-settings"},"Script Runner Settings"),(0,r.kt)("p",null,"These methods allow the user to control various Script Runner settings."),(0,r.kt)("h3",{id:"set_line_delay"},"set_line_delay"),(0,r.kt)("p",null,"This method sets the line delay in script runner."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"set_line_delay(<Delay>)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Delay"),(0,r.kt)("td",{parentName:"tr",align:null},"The amount of time script runner will wait between lines when executing a script, in seconds. Should be \u2265 0.0")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"set_line_delay(0.0)\n")),(0,r.kt)("h3",{id:"get_line_delay"},"get_line_delay"),(0,r.kt)("p",null,"The method gets the line delay that script runner is currently using."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"curr_line_delay = get_line_delay()\n")),(0,r.kt)("h3",{id:"set_max_output"},"set_max_output"),(0,r.kt)("p",null,"This method sets the maximum number of characters to display in Script Runner output before truncating. Default is 50,000 characters."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"set_max_output(<Characters>)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Characters"),(0,r.kt)("td",{parentName:"tr",align:null},"Number of characters to output before truncating")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"set_max_output(100)\n")),(0,r.kt)("h3",{id:"get_max_output"},"get_max_output"),(0,r.kt)("p",null,"The method gets the maximum number of characters to display in Script Runner output before truncating. Default is 50,000 characters."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"print(get_max_output()) #=> 50000\n")),(0,r.kt)("h3",{id:"disable_instrumentation"},"disable_instrumentation"),(0,r.kt)("p",null,"Disables instrumentation for a block of code (line highlighting and exception catching). This is especially useful for speeding up loops that are very slow if lines are instrumented.\nConsider breaking code like this into a seperate file and using either require/load to read the file for the same effect while still allowing errors to be caught by your script."),(0,r.kt)("admonition",{title:"Use with Caution",type:"caution"},(0,r.kt)("p",{parentName:"admonition"},"Disabling instrumentation will cause any error that occurs while disabled to cause your script to completely stop.")),(0,r.kt)("p",null,"Ruby Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"disable_instrumentation do\n  1000.times do\n    # Don't want this to have to highlight 1000 times\n  end\nend\n")),(0,r.kt)("p",null,"Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"with disable_instrumentation:\n    for x in range(0:1000):\n        # Don't want this to have to highlight 1000 times\n")),(0,r.kt)("h2",{id:"script-runner-suites"},"Script Runner Suites"),(0,r.kt)("p",null,"Creating Script Runner suites utilizes APIs to add groups to the defined suites. For more information please see ",(0,r.kt)("a",{parentName:"p",href:"/tools/docs/docs/tools/script-runner#running-script-suites"},"running script suites"),"."),(0,r.kt)("h3",{id:"add_group-add_group_setup-add_group_teardown-add_script"},"add_group, add_group_setup, add_group_teardown, add_script"),(0,r.kt)("p",null,"Adds a group's methods to the suite. The add_group method adds all the group methods including setup, teardown, and all the methods starting with 'script","_","' or 'test","_","'. The add_group_setup method adds just the setup method defined in the group class. The add_group_teardown method adds just the teardown method defined in the group class. The add_script method adds an individual method to the suite. NOTE: add_script can add any method including those not named with 'script","_","' or 'test","_","'."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"add_group(<Group Class>)\nadd_group_setup(<Group Class>)\nadd_group_teardown(<Group Class>)\nadd_script(<Group Class>, <Method>)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Group Class"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the previously defined class which inherits from the OpenC3 Group class. The Ruby API passes a String with the name of the group. The Python API passes the Group class directly.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Method"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the method in the OpenC3 Group class. The Ruby API passes a String with the name of the method. The Python API passes the Group class directly.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"load 'openc3/script/suite.rb'\n\nclass ExampleGroup < OpenC3::Group\n  def script_1\n    # Insert test code here ...\n  end\nend\nclass WrapperGroup < OpenC3::Group\n  def setup\n    # Insert test code here ...\n  end\n  def my_method\n    # Insert test code here ...\n  end\n  def teardown\n    # Insert test code here ...\n  end\nend\n\nclass MySuite < OpenC3::Suite\n  def initialize\n    super()\n    add_group('ExampleGroup')\n    add_group_setup('WrapperGroup')\n    add_script('WrapperGroup', 'my_method')\n    add_group_teardown('WrapperGroup')\n  end\nend\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"from openc3.script import *\nfrom openc3.script.suite import Group, Suite\n\nclass ExampleGroup(Group):\n    def script_1(self):\n        # Insert test code here ...\n        pass\nclass WrapperGroup(Group):\n    def setup(self):\n        # Insert test code here ...\n        pass\n    def my_method(self):\n        # Insert test code here ...\n        pass\n    def teardown(self):\n        # Insert test code here ...\n        pass\nclass MySuite(Suite):\n    def __init__(self):\n        super().__init__()\n        self.add_group(ExampleGroup)\n        self.add_group_setup(WrapperGroup)\n        self.add_script(WrapperGroup, 'my_method')\n        self.add_group_teardown(WrapperGroup)\n")),(0,r.kt)("h2",{id:"script-runner-debugging"},"Script Runner Debugging"),(0,r.kt)("p",null,"These methods allow the user to debug scripts with ScriptRunner."),(0,r.kt)("h3",{id:"step_mode"},"step_mode"),(0,r.kt)("p",null,"Places ScriptRunner into step mode where Go must be hit to proceed to the next line."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"step_mode()\n")),(0,r.kt)("h3",{id:"run_mode"},"run_mode"),(0,r.kt)("p",null,"Places ScriptRunner into run mode where the next line is run automatically."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"run_mode()\n")),(0,r.kt)("h3",{id:"disconnect_script"},"disconnect_script"),(0,r.kt)("p",null,"Puts scripting into disconnect mode. In disconnect mode, commands are not sent to targets, checks are all successful, and waits expire instantly. Requests for telemetry (tlm()) typically return 0. Disconnect mode is useful for dry-running scripts without having connected targets."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"disconnect_script()\n")),(0,r.kt)("h2",{id:"metadata"},"Metadata"),(0,r.kt)("p",null,"Metadata allows you to mark the regular target / packet data logged in COSMOS with your own fields. This metadata can then be searched and used to filter data when using other COSMOS tools."),(0,r.kt)("h3",{id:"metadata_all"},"metadata_all"),(0,r.kt)("p",null,"Returns all the metadata that was previously set"),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"metadata_all()\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"limit"),(0,r.kt)("td",{parentName:"tr",align:null},"Amount of metadata items to return. Default is 100.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"metadata_all(limit: 500)\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"metadata_all(limit='500')\n")),(0,r.kt)("h3",{id:"metadata_get"},"metadata_get"),(0,r.kt)("p",null,"Returns metadata that was previously set"),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"metadata_get(start)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"start"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter, time at which to retrieve metadata as integer seconds from epoch")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"metadata_get(start: 500)\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"metadata_get(start='500')\n")),(0,r.kt)("h3",{id:"metadata_set"},"metadata_set"),(0,r.kt)("p",null,"Returns metadata that was previously set"),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"metadata_set(<Metadata>, start, color)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Metadata"),(0,r.kt)("td",{parentName:"tr",align:null},"Hash or dict of key value pairs to store as metadata.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"start"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter, time at which to store metadata. Default is now.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"color"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter, color to display metadat in the calendar. Default is #003784.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"metadata_set({ 'key' => 'value' })\nmetadata_set({ 'key' => 'value' }, color: '#ff5252')\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"metadata_set({ 'key': 'value' })\nmetadata_set({ 'key': 'value' }, color='ff5252')\n")),(0,r.kt)("h3",{id:"metadata_update"},"metadata_update"),(0,r.kt)("p",null,"Updates metadata that was previously set"),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"metadata_update(<Metadata>, start, color)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Metadata"),(0,r.kt)("td",{parentName:"tr",align:null},"Hash or dict of key value pairs to update as metadata.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"start"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter, time at which to update metadata. Default is latest metadata.")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"color"),(0,r.kt)("td",{parentName:"tr",align:null},"Named parameter, color to display metadat in the calendar. Default is #003784.")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"metadata_update({ 'key' => 'value' })\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"metadata_update({ 'key': 'value' })\n")),(0,r.kt)("h3",{id:"metadata_input"},"metadata_input"),(0,r.kt)("p",null,"Prompts the user to set existing metadata values or create new a new one."),(0,r.kt)("p",null,"Ruby / Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"metadata_input()\n")),(0,r.kt)("h2",{id:"settings"},"Settings"),(0,r.kt)("p",null,"COSMOS has several settings typically accessed through the Admin Settings tab. These APIs allow programmatic access to those same settings."),(0,r.kt)("h3",{id:"list_settings"},"list_settings"),(0,r.kt)("p",null,"Return all the current COSMOS setting name. These are the names that should be used in the other APIs."),(0,r.kt)("p",null,"Ruby Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'puts list_settings() #=> ["pypi_url", "rubygems_url", "source_url", "version"]\n')),(0,r.kt)("p",null,"Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"print(list_settings()) #=> ['pypi_url', 'rubygems_url', 'source_url', 'version']\n")),(0,r.kt)("h3",{id:"get_all_settings"},"get_all_settings"),(0,r.kt)("p",null,"Return all the current COSMOS settings along with their values."),(0,r.kt)("p",null,"Ruby Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'puts get_all_settings() #=>\n# { "version"=>{"name"=>"version", "data"=>"5.11.4-beta0", "updated_at"=>1698074299509456507},\n#   "pypi_url"=>{"name"=>"pypi_url", "data"=>"https://pypi.org/simple", "updated_at"=>1698026776574347007},\n#   "rubygems_url"=>{"name"=>"rubygems_url", "data"=>"https://rubygems.org", "updated_at"=>1698026776574105465},\n#   "source_url"=>{"name"=>"source_url", "data"=>"https://github.com/OpenC3/cosmos", "updated_at"=>1698026776573904132} }\n')),(0,r.kt)("p",null,"Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"print(get_all_settings()) #=>\n# { 'version': {'name': 'version', 'data': '5.11.4-beta0', 'updated_at': 1698074299509456507},\n#   'pypi_url': {'name': 'pypi_url', 'data': 'https://pypi.org/simple', 'updated_at': 1698026776574347007},\n#   'rubygems_url': {'name': 'rubygems_url', 'data': 'https://rubygems.org', 'updated_at': 1698026776574105465},\n#   'source_url': {'name': 'source_url', 'data': 'https://github.com/OpenC3/cosmos', 'updated_at': 1698026776573904132} }\n")),(0,r.kt)("h3",{id:"get_setting-get_settings"},"get_setting, get_settings"),(0,r.kt)("p",null,"Return the data from the given COSMOS setting. Returns nil (Ruby) or None (Python) if the setting does not exist."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"get_setting(<Setting Name>)\nget_settings(<Setting Name1>, <Setting Name2>, ...)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Setting Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the setting to return")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"puts get_setting('version') #=> \"5.11.4-beta0\"\nputs get_settings('version', 'rubygems_url') #=> [\"5.11.4-beta0\", \"https://rubygems.org\"]\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"print(get_setting('version')) #=> '5.11.4-beta0'\nprint(get_setting('version', 'rubygems_url')) #=> ['5.11.4-beta0', 'https://rubygems.org']\n")),(0,r.kt)("h3",{id:"set_setting"},"set_setting"),(0,r.kt)("p",null,"Sets the given setting value."),(0,r.kt)("admonition",{title:"Admin Passwork Required",type:"note"},(0,r.kt)("p",{parentName:"admonition"},"This API is only accessible externally (not within Script Runner) and requires the admin password.")),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"set_setting(<Setting Name>, <Setting Value>)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Setting Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the setting to change")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Setting Value"),(0,r.kt)("td",{parentName:"tr",align:null},"Setting value to set")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"set_setting('rubygems_url', 'https://mygemserver')\nputs get_settings('rubygems_url') #=> \"https://mygemserver\"\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"set_setting('pypi_url', 'https://mypypiserver')\nprint(get_settings('pypi_url')) #=> 'https://mypypiserver'\n")),(0,r.kt)("h2",{id:"configuration"},"Configuration"),(0,r.kt)("p",null,"Many COSMOS tools have the ability to load and save a configuration. These APIs allow you to programatically load and save the configuration."),(0,r.kt)("h3",{id:"config_tool_names"},"config_tool_names"),(0,r.kt)("p",null,"List all the configuration tool names which are used as the first parameter in the other APIs."),(0,r.kt)("p",null,"Ruby Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'names = config_tool_names()\npp names #=> ["telemetry_grapher", "data_viewer"]\n')),(0,r.kt)("p",null,"Python Syntax / Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"names = config_tool_names()\nprint(names) #=> ['telemetry_grapher', 'data_viewer']\n")),(0,r.kt)("h3",{id:"list_configs"},"list_configs"),(0,r.kt)("p",null,"List all the saved configuration names under the given tool name."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"list_configs(<Tool Name>)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Tool Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the tool to retrieve configuration names from")))),(0,r.kt)("p",null,"Ruby Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"configs = list_configs('telemetry_grapher')\npp configs #=> ['adcs', 'temps']\n")),(0,r.kt)("p",null,"Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-python"},"configs = list_configs('telemetry_grapher')\nprint(configs) #=> ['adcs', 'temps']\n")),(0,r.kt)("h3",{id:"load_config"},"load_config"),(0,r.kt)("p",null,"Load a particular tool configuration."),(0,r.kt)("admonition",{title:"Tool Configuration",type:"note"},(0,r.kt)("p",{parentName:"admonition"},"Tool configurations are not fully documented and subject to change between releases. Only modify values returned by load_config and do not change any keys.")),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"load_config(<Tool Name>, <Configuration Name>)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Tool Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the tool")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Configuration Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the configuration")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},'config = load_config(\'telemetry_grapher\', \'adcs\')\nprint(config) #=>\n# [ {\n#   "items": [\n#     {\n#       "targetName": "INST",\n#       "packetName": "ADCS",\n#       "itemName": "CCSDSVER",\n# ...\n')),(0,r.kt)("h3",{id:"save_config"},"save_config"),(0,r.kt)("p",null,"Save a particular tool configuration."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"save_config(<Tool Name>, <Configuration Name>, local_mode)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Tool Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the tool")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Configuration Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the configuration")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"local_mode"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether to save the configuration in local mode")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"save_config('telemetry_grapher', 'adcs', config)\n")),(0,r.kt)("h3",{id:"delete_config"},"delete_config"),(0,r.kt)("p",null,"Delete a particular tool configuration."),(0,r.kt)("p",null,"Ruby / Python Syntax:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"delete_config(<Tool Name>, <Configuration Name>, local_mode)\n")),(0,r.kt)("table",null,(0,r.kt)("thead",{parentName:"table"},(0,r.kt)("tr",{parentName:"thead"},(0,r.kt)("th",{parentName:"tr",align:null},"Parameter"),(0,r.kt)("th",{parentName:"tr",align:null},"Description"))),(0,r.kt)("tbody",{parentName:"table"},(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Tool Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the tool")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"Configuration Name"),(0,r.kt)("td",{parentName:"tr",align:null},"Name of the configuration")),(0,r.kt)("tr",{parentName:"tbody"},(0,r.kt)("td",{parentName:"tr",align:null},"local_mode"),(0,r.kt)("td",{parentName:"tr",align:null},"Whether to delete the configuration in local mode")))),(0,r.kt)("p",null,"Ruby / Python Example:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-ruby"},"delete_config('telemetry_grapher', 'adcs')\n")))}d.isMDXComponent=!0},876:(e,t,a)=>{a.d(t,{Zo:()=>u,kt:()=>c});var n=a(2784);function r(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function l(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function m(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?l(Object(a),!0).forEach((function(t){r(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):l(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function i(e,t){if(null==e)return{};var a,n,r=function(e,t){if(null==e)return{};var a,n,r={},l=Object.keys(e);for(n=0;n<l.length;n++)a=l[n],t.indexOf(a)>=0||(r[a]=e[a]);return r}(e,t);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(e);for(n=0;n<l.length;n++)a=l[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(r[a]=e[a])}return r}var p=n.createContext({}),o=function(e){var t=n.useContext(p),a=t;return e&&(a="function"==typeof e?e(t):m(m({},t),e)),a},u=function(e){var t=o(e.components);return n.createElement(p.Provider,{value:t},e.children)},s="mdxType",d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},k=n.forwardRef((function(e,t){var a=e.components,r=e.mdxType,l=e.originalType,p=e.parentName,u=i(e,["components","mdxType","originalType","parentName"]),s=o(a),k=r,c=s["".concat(p,".").concat(k)]||s[k]||d[k]||l;return a?n.createElement(c,m(m({ref:t},u),{},{components:a})):n.createElement(c,m({ref:t},u))}));function c(e,t){var a=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var l=a.length,m=new Array(l);m[0]=k;var i={};for(var p in t)hasOwnProperty.call(t,p)&&(i[p]=t[p]);i.originalType=e,i[s]="string"==typeof e?e:r,m[1]=i;for(var o=2;o<l;o++)m[o]=a[o];return n.createElement.apply(null,m)}return n.createElement.apply(null,a)}k.displayName="MDXCreateElement"}}]);