Salvasys DR-SOLAR Driver Dual Axis Slewing Drive Gear Motor Instructions

Salvasys DR-SOLAR Driver Dual Axis Slewing Drive Gear Motor

Specifications

• Product Name: ALVASYS-DR-SOLAR Driver
• Version: 1.1.0.0
• Date: June 26th, 2024
• Author: S. M. Meriano

Product Information

The ALVASYS-DR-SOLAR Driver is a software designed for integration with JACE/HAWK units to facilitate solar energy monitoring and control.

Product Usage Instructions

Installing the Software

1. Unzip the files containing the driver and technical notes.
2. Rename the files to ‘alvassiSolar-rt’ with the .jar extension retained.
3. Copy the two jar files into the modules directory of your Niagara Work Bench.
4. Restart your Work Bench.

Installing the Driver into the JACE/HAWK Unit

1. Connect to a JACE/HAWK running unit using the Work Bench.
2. Transfer the ‘alvassiSolar’ module into the unit under the ‘modules’ folder.

Driver Configuration

1. Install the alvasysSolar Service.
2. Configure the parameters as required.
3. Set the desired value outputs for monitoring and control purposes.

FAQ

Q: What platforms are compatible with the ALVASYS-DR-SOLAR Driver?

A: The driver runs on Niagara 4.x (>= 4.7) platforms and has been tested on versions Niagara 4.10.x to 4.13.

Q: Can I install the driver on multiple locations?

A: Yes, you can add more than one location on the host using your license. For more details, refer to the ALVASYS-DR-SOLAR price list.

History

Filename: ALVASYS-DR-SOLAR_v1.1.0.0.odt

Rev.| Date| Author| Description
1.0| 26.06.2024| M.Marcello| First draft

Confidentiality Notice

The information contained in this document is confidential information of alvasys automation ag (“ALVASYS”). Such information and the software described herein, is furnished under license agreement and may be used only in accordance with that agreement.
The information contained in this document is provided solely for use by ALVASYS employees, licenses and system owners. Contents of this document are not to be released to or reproduced for anyone else.
While every effort has been made to assure the accuracy of this document, ALVASYS is not responsible for damages of any kind, including without limitation consequential damages, arising from the application of the information contained herein. Information and specifications published here current as of the date to this publication and are subject to change without notice. This document may be copied by parties who are authorised to distribute ALVASYS products in connection with distribution of those products, subject to the contracts that authorize such distribution. It may not otherwise, in whole or in part, be copied, photocopied, reproduced, translated or reduced to any electronic medium or machine-readable form without prior written consent from ALVASYS.

Introduction

Requirements

• Niagara 4.x (>= 4.7)
• A license to use the ALVASYS-DR-SOLAR driver. Other device limit or proxy-point limits may apply to your license. For license details and options, see the ALVASYS-DR-SOLAR price list.

Module
The ALVASYS-DR-SOLAR Driver is contained in two files:

• alvassiSolar-rt.jar

Compatibility

Platforms
The ALVASYS-DR-SOLAR driver runs on Niagara 4.x (>= 4.7) platforms.

Tested versions
Niagara 4.10.x +4.13

License

The licence there you need is the only one and you can add more than one location on the Host.

Installing the software

Installing the ALVASYS-DR-SOLAR driver is simple.

• It requires a basic knowledge of the Tridium Niagara 4 and execute a few steps as described hereafter. The driver, a Java “.jar” executable file, is usually shipped in a zip file.
• Its name is generated according to the following structure:
• alvassiSolar-rt_ ( i.e. alvassiSolar-rt_v1.1.0.0)
• The number of the version characterises the features included in the driver and may vary from time to time. An additional text file is normally added to the zip file, in order to explain the main features of the release. Its name may appear as follow:
• Note on SwVer ( i.e. Note on SwVer 1.0.0)

Installing the driver on your PC
The following procedures describe how to set-up the driver.

Step 1| First of all unzip the files which contains the driver and technical notes.
---|---

Step 2

| Rename the files, changing theirs name into alvassiSolar -rt

Extension .jar should remain as well.

Step 3| Copy the two jar files into the modules directory of your Niagara Work Bench.
Step 4| Restart your Work Bench.

Step 5

| After restarting, the file should appears in the list of available software, which can be shown clicking on the Software Manager section of the Platform of your Work Bench.

Installing the driver into the JACE/HAWK unit

modules.

Step 3

| This can be done by activating the standard Tridium procedure for software upgrading or simply copying the jar files by the File Transfer Client procedure, available under the list of the Platform options in your Work Bench.

Destination directory inside the Jace8000 is: /opt/niagara/modules

For further details on how to transfer files from Work Bench to JACE/HAWK units, refer to the official Tridium documentation.

Step 4| After copying the driver into the JACE/HAWK unit, force a reboot.

Driver configuration

Installing the alvasysSolar Service
The first step of the driver configuration is the installation of the alvasysSolar Service under the station running in the JACE/HAWK unit.

A simple way to complete this task is to open the Palette named alvassiSolar (see figure below), select the AlvasysSForcast component and drag and drop it under the Services folder of the running station.
This component is a network-level component in the Niagara architecture.

Configuring the Parameters

To proceed with this task, right click on the AlvasysForcast (just dragged to station Services) and open its

Property Sheet:

• Latitude: of location, -90 (south) … 90 (north); handeled with a precission of 0.0001 or abt. 10 m
• Longitude: of location, -180 (west) … 180 (east) handeled with a precission of 0.0001 or abt. 10 m
• Dec: plane declination, 0 (horizontal) … 90 (vertical) – always in relation to the earth’s surface
• Az: plane azimuth, -180 … 180 (-180 = north, -90 = east, 0 = south, 90 = west, 180 = north)
• Kwp: installed modules power in kilo watt; float

Latitude and Longitude information from https://www.google.ch/maps

1. number is Latitude 47.3943291804062
2. number is Longitude 8.474159297817193

Dec plane declination, 0 (horizontal) … 90 (vertical) – always in relation to the earth’s surface

Az: Azimuth
Please note that e.g. Home Assistant uses internal a 0° … 360° logic, so make sure to translate for direct API calls …

Value Output

All value are arrive from the https://forecast.solar/ and we are using the https://doc.forecast.solar/account_models#public (Public)

Watts Today

Watts Tomorrow:

Watt Hours Today:

Watt Hours Tomorrow:

Watt Hours Period Today

Watt Hours Period Tomorrow:

Watt Hours Day Today and Tomorrow:

API Message:

All Value are in the subfolders

For more information go to this side: https://doc.forecast.solar/api:estimate

+41 (0)44 261 00 70 info@alvasys.ch / www.alvasys.ch / www.alvasys.de

alvasys automation ag / Hermetschloostrasse 75 / CH-8048 Zürich

References

• Startseite | alvasys automation ag
• Startseite | alvasys automation ag
• Account models [Forecast.Solar]
• Solar production estimate [Forecast.Solar]
• Homepage [Forecast.Solar]
• Google Maps

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>