Safety Monitor Setup

From Voyager Wiki
Revision as of 12:26, 15 July 2023 by Leonardo (talk | contribs) (→‎Other Setup Pages)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Safety Monitor Setup Workspace

Click the Safety Monitor button in the Setup workspace to display the Safety Monitor setup window:

Safety-monitor-setup.png


Color Coding

Throughout the Setup workspace, Voyager uses color to indicate the following:

  • Black: A normal setting
  • Gold or Yellow: Use caution when changing as things may not work well or as expected
  • Red: Use extreme care when changing this setting - the wrong value can damage your equipment or the imaging session may fail


Safety Monitor Choice

Choose your Safety Monitor driver from the Safety Monitor drop-down list:

Sm-choice.png


Click the Ascom-button.png button to configure your Safety Monitor's ASCOM driver.

UnSafe Signal Management

Choose how Voyager should react to an UnSafe signal from the Safety Monitor:

Sm-signal-mgmt.png

  • UnSafe send Emergency Exit Logic Signal to Voyager and DragScript will be finished after running this event. Safe is ignored: If an UnSafe signal is sent to Voyager by the Safety Monitor, a running DragScript will be immediately interrupted and control will pass to the actions in the DragScript Emergency Exit block. The DragScript will terminate once the actions in the Emergency Exit block are executed. A later Safe signal from the Safety Monitor will be ignored. Visit the the DragScript Examples section to see how these DragScript blocks work in an actual DragScript.
  • UnSafe send Emergency Suspend Logic Signal to Voyager and DragScript will be suspend after running this event. Safe Resume it: If an UnSafe signal is sent to Voyager by the Safety Monitor, a running DragScript will be immediately interrupted and control will pass to the actions in the DragScript Emergency Suspend block. DragScript execution will be suspended once the actions in the Emergency Suspend block are executed. A later Safe signal from the Safety Monitor will cause an Emergency Resume signal to the DragScript, and control will pass to the actions in the DragScript Emergency Resume block. Visit the the DragScript Examples section to see how these DragScript blocks work in an actual DragScript.

Safety Manager Options

Optional Safety Manager configuration choices:

Sm-options.png

  • Add Integration time management to conditions: If checked, the number of seconds selected in the counter field must elapse before a change of Safety Monitor status will be acted on by Voyager. This is useful if your safety monitor driver does not already include such a function. It can avoid rapid switching between performing Safe and UnSafe emergency event actions if the safe conditions are changing quickly. However, if your safety monitor is already delaying and you add a delay here, you could delay acting on an important UnSafe event such as rain starting, so be careful when using this option

Text File Safe Monitor

You may optionally read the status of SAFE and UNSAFE from a text string placed in a single-line file updated by programs external to Voyager. This is useful for Observatories shared between multiple setups.

Text-file-safe-monitor-setting.png

  • File Single Line Monitor: The text file to be monitored by Voyager for an SAFE or UNSAFE indication. Type in a fully qualified filename or select the file by clicking the folder icon.
  • Safe String (NOT Case Sensitive): When Voyager reads the File Single Line Monitor file, if it contains this text string, the safety monitor condition will be considered SAFE. If this text string is not found, the safety monitor condition is considered UNSAFE
  • Safe String Match Mode: Define how to search the Safe String in the text.
    • Contained: string in every position of word text and also in a part of word
    • Start With: the word text must start exactly with the string
    • Exactly Match: word must match exactly the string
  • Query File Every: The number of seconds between checks of the single line monitor file
  • Generate UNSAFE if Voyager cannot read file or data not modified for: If Voyager cannot read the single line monitor file or if it has not been written to for this many minutes, consider the safety monitor condition to be UNSAFE. This protects against conditions which may make the single line monitor file unreadable or outdated, such as network or file system failures, or failures of the program that should be updating the single line file
Important Note! Be careful about string match mode. For example if you use SAFE like string and Contained method the word UNSAFE and the word SAFE will return to you the SAFE condition because each of the words contains the text SAFE.


URL Text Safe Monitor

You may optionally read the status of SAFE and UNSAFE from a text downloaded from a Internet/Intranet/Extranet URL. This is useful for Observatories shared between multiple setups. You can get plain text or json text or another kind of general porpouse text format.

Immagineergergerg.png

  • URL: the Url to be monitored by Voyager for an SAFE or UNSAFE indication. Type in a well qualified URL
  • Safe String (NOT Case Sensitive): When Voyager reads the File Single Line Monitor file, if it contains this text string, the safety monitor condition will be considered SAFE. If this text string is not found, the safety monitor condition is considered UNSAFE
  • Safe String Match Mode: Define how to search the Safe String in the text.
    • Contained: string in every position of word text and also in a part of word
    • Start With: the word text must start exactly with the string
    • Exactly Match: word must match exactly the string
  • Query URL Every: The number of seconds between checks of the URL text
  • Generate UNSAFE if Voyager cannot opern URL and/or data not modified for: If Voyager cannot read the content of the URL will consider the safety monitor condition to be UNSAFE. This protects against conditions which may make the URL unreadable, such as network or file system failures
Important Note! In case of URL retrieving is not possibile to evaluate the age of the data readed so its not possible to prevent for outadated data the system. This can create sever damage to your system and Voyager is absolutely not responsible for that. Adopt an alternative system to know if the URL data are not updated with your service provider !!!
Important Note! Be careful about string match mode. For example if you use SAFE like string and Contained method the word UNSAFE and the word SAFE will return to you the SAFE condition because each of the words contains the text SAFE.
Important Note! If the URL is not available or cannot be reached or connectivity of your PC is dwon, the timeout for generate UNSAFE will be started


Other Setup Pages