Difference between revisions of "Viking"

From Voyager Unofficial Wiki
Jump to: navigation, search
(Setup)
Line 1: Line 1:
 
Voyager's companion product, Viking, provides I/O status and control for domotics (control devices used for home automation) and your observatory's I/O devices.
 
Voyager's companion product, Viking, provides I/O status and control for domotics (control devices used for home automation) and your observatory's I/O devices.
 +
 +
<u>Actual release version is 1.0.14</u>
  
 
Viking can be used standalone from its GUI and also integrated with Voyager to check the status and set the values of:
 
Viking can be used standalone from its GUI and also integrated with Voyager to check the status and set the values of:

Revision as of 01:22, 28 November 2019

Voyager's companion product, Viking, provides I/O status and control for domotics (control devices used for home automation) and your observatory's I/O devices.

Actual release version is 1.0.14

Viking can be used standalone from its GUI and also integrated with Voyager to check the status and set the values of:

  • Relay Cards: read status and set on/off Digital (on/off)
  • Analog Input status
  • PWM (Pulse-Width-Modulation) device: read status and set value
  • DAC (Digital to Analog Conversion) device: read status and set value

Viking contains an application server for both local and LAN-based programmatic control

Installation

Download the free trial version of Viking, then locate the downloaded Viking_Setup_X.Y.Z.exe file and double-click to start installation:

Viking download.png

If you get a Windows User Account Control warning message asking if you want to install this application from an unknown publisher, click Yes to continue.

Viking-select-language.png

Select the language for installation and click OK

Viking-license-accept.png

Click the radio button to Accept the agreement and click Next to continue

Viking-select-directory.png

Choose your installation directory or just accept the default and click Next to continue

Viking-start-menu.png

Select your Start Menu folder or accept the default and click Next to continue

Viking-shortcut.png

Check the box to create a desktop shortcut (recommended) and click Next to continue

Viking-confirm-settings-install.png

Confirm your settings and click Install to perform the installation, or Back to make changes

Viking-install-done.png

Click Finish to exit Setup


Licensing

Double click the desktop Viking icon, or type Viking in the Windows menu to find and start the application.

Viking-desktop-icon.png


Viking will start in Demo mode and show the License Manager splash screen

Viking-license-manager-screen.png

In Demo Mode, the number of I/O devices is limited and the application server is not available.

You can use Demo Mode indefinitely to learn the Viking software and work with the included Simulator.

Trial License

When you are ready to start your 45 day free trial, click the Attiva TRIAL button (Activate Trial). If you are connected to the Internet, your trial license will be automatically activated.

If you are not connected to the Internet, follow the instructions under "How to Obtain a Trial License" in the splash screen. You will have to copy and paste the serial number - in the example above it is the set of eight four-digit blocks of letters and numbers - into an email and send it to the email address shown in the message. You will receive a license file within 24-48 hours by email.

Commercial License

Click the Acquista Licenza button (Buy License) to obtain a commercial license. You will have to copy and paste the serial number - in the example above it is the set of eight four-digit blocks of letters and numbers - into the order form when you buy the license. You will receive a license file within 24-48 hours by email.

Installing Your License

Click the Installa Licenza (Install License) button to install your license file.

Viking-install-license.png

Click the Seleziona (Select) button to browse to the license file attached to the email you received.

Click IMPORTA (Import) to import the license file and activate it. Click Annulla (Cancel) to cancel the operation and exit the window.


You can now start Viking and use it with your newly installed license.


Setup

You can setup your I/O controller card on the I/O Card Setting tab of the Viking GUI.

One instance of Viking can control one I/O card.

Viking1 0 14.png

  • I/O Card: Choose your I/O card from the drop-down list of supported devices.


Depending on the I/O card you select, different fields will be displayed directly below the I/O card selection drop-down.

These fields tell Viking how to address the I/O card. Fill them out as appropriate for your card.

In this example, the KMTronic UDP Relay card is selected, and it requires an IP Address and UDP/IP Port number.

Viking-io-card-address.png

Most cards use an IP address and port number, but some have ASCOM drivers or other means of connecting.


Depending on the capabilities of the card you select, one or more of the tabs in the lower half of the screen will have relevant settings for the selected card.

Relays Setup Tab

The number of relays shown on this tab should match the number on the I/O card selected from the drop-down on this tab.

Viking-relay-setting.png

  • Relay X - Description: Provide a meaningful name for the relay. The name you provide here will appear on Viking's Relay control tab

Digital Inputs Setup Tab

Viking-digital-inputs-setup.png

  • In X - Description: Provide a meaningful name for the digital input. The name you provide here will appear on Viking's Input control tab

Analog Inputs Setup Tab

Viking-analog-inputs-setup.png

  • In X - Description: Provide a meaningful name for the analog input. The name you provide here will appear on Viking's Input control tab


PWM Setup Tab

Viking-pwm-setup.png

  • PWM X - Description: Provide a meaningful name for the PWM device. The name you provide here will appear on Viking's PWM control tab


DAC Setup Tab

Viking-dac-setup.png

  • DAC X - Description: Provide a meaningful name for the DAC device. The name you provide here will appear on Viking's DAC control tab


Uscite Automazione Setup Tab

Note: "Automations" are unique to the MyHome automation device. You can use Voyager's DragScript to automate reading and setting any I/O device controlled by Viking.

Viking-automation-setup.png

  • Automation X - Description: Provide a meaningful name for the Automation device. The name you provide here will appear on Viking's Out Automation control tab


Descriptions and Connection Test

After naming your I/O card's individual controls, you can save the descriptions to a file, reset the descriptions to the default, and test your connection.

The buttons below the descriptions provide these functions:

Viking-io-card-descriptions.png

  • Reset Objects Description: Sets the descriptions back to the default values, e.g. Relay 1, Relay 2, etc. Be sure this is what you want so you don't accidentally lose all your meaningful names
  • Save Objects Description: Saves the descriptions (meaningful names)
  • Connection Test: After selecting your I/O card and configuring its address, click Connection Test to make sure Viking can communicate with your I/O card

Connecting and Status

At the bottom of the Viking GUI you will always find the Connect button and some additional status information.

Viking-connect-status.png

  • Connect: Click to connect to your I/O card. After successfully connecting, the button reads Disconnect. Click to disconnect from your I/O card


Connection status information appears at the bottom of the Viking window:

Viking-status-bar-2.png

  1. The type of I/O control card selected. The LED is black if not connected, green if connected
  2. Viking's Application Server port number. In this example, the application server is on port 4434
  3. Number of clients connected to Viking's application server
  4. License type


Relay Devices

The Out Relays panel shows the current status of connected Relay devices and provides buttons to set individual or all relays on or off.

Viking-relay-2.png

  • Get Status: Click to refresh relay status
  • ALL OFF: Click and then click OK on the confirmation popup window to set all relays to the OFF position
  • ALL ON: Click and then click OK on the confirmation popup window to set all relays to the ON position
  • OFF: Click the OFF button to the left of the relay description to turn an individual relay OFF
  • ON: Click the ON button to the left of the relay description to turn an individual relay ON
  • LED's: The LED's to the left of the descriptions are black if the device is OFF, and red if it is ON




Input Devices

The Input panel shows the current status of connected digital and analog input devices

Viking-input-2.png

  • Get Status: Click to refresh device status
  • LED's: The LED's to the left of the descriptions are black if the device is OFF, and red if it is ON
  • Analog: The value of the Analog input is displayed in the box to the left of the description



Pulse Width Modulation (PWM) Devices

The PWM panel shows the current status of connected PWM devices and provides buttons to set individual or all PWM devices to a specified value or off.

Viking-pwm-2.png

  • Get Status: Click to refresh PWM device status
  • ALL OFF: Click and then click OK on the confirmation popup window to set all PWM devices OFF
  • OFF: Click the OFF button to the left of the relay description to turn an individual PWM device OFF
  • SET: Sets the PWM device to the value specified by the counter field
  • Value: The field to the right of the PWM description label shows the current value of the PWM device



Digital to Analog Conversion (DAC) Devices

The DAC panel shows the current status of connected DAC devices and provides buttons to set individual or all DAC devices to a specified value or off.

Viking-dac-2.png

  • Get Status: Click to refresh DAC device status
  • ALL OFF: Click and then click OK on the confirmation popup window to set all DAC devices OFF
  • OFF: Click the OFF button to the left of the relay description to turn an individual DAC device OFF
  • SET: Sets the DAC device to the value specified by the counter field
  • Value: The field to the right of the DAC description label shows the current value of the DAC device



Home Automation Devices

The Out Automation panel shows the current status of connected Bticino MyHome devices and provides buttons to Open, Close or Stop a MyHome automation

Viking-automation-2.png

  • Get Status: Click to refresh device status
  • OPEN: Open the MyHome automation
  • CLOSE: Close the MyHome automation
  • Stop: Stop the MyHome automation
  • LED: The LED's to the right of the button are black until the button is clicked, then red to indicate the MyHome automation status for that button is active



Viking Settings: Common and Application Server

The Viking Setting tab is where configuration information about Viking itself (not the I/O cards) is stored.

Viking-setting-2.png

  • Common:
    • Language: Choose the interface language, English or Italian
  • Application Server: Settings for the application server contained in Viking
    • Actual Server IP: IP address for the Viking program's application server. This is the IP address of the machine where this instance of Viking is running
      • Update: Click this button to read the IP address of the machine if it has changed since the last setting
    • TCP/IP Port Number from License: Port number of Viking's application server. This is read from your Viking license file.
    • Start Server Automatically: If checked, Viking's application server will start when Viking starts
    • Remote Commands Execution Timeout: How long to wait in seconds before considering a remote command to have timed out

Application Server Monitor Window

The Application Server tab contains a running log of timestamped application server commands and responses:

Viking-application-server-window.png

  • Text Zoom: Move the slider to change the font size for the text in the monitor window