N4 Sedona Framework Control User Guide

N4 Sedona Framework Control

Product Information

Specifications:

  • Product Name: Ontrol N4 Sedona driver & programming
    tool
  • Version: Rev 011224
  • Files Required: Niagara Modules, Sedona Distribution Package,
    DaspOnSerial Utility

Product Usage Instructions

1. Required Files:

The required files can be downloaded from the following link:
Download Ontrol
Sedona Files
. Always ensure you use the latest versions.

2. Niagara Modules Installation:

Download Niagara Modules as a .zip file and extract them to your
Niagara installation’s modules folder. Restart Workbench if
necessary.

3. Sedona Files Installation:

A Sedona distribution package is provided as a single archive
file named Ontrol Sedona Package yymmdd.zip. Install using the
Sedona Installer tool.

3.1 Sedona Home Folder:

Copy Sedona files to the main Niagara folder (e.g.,
C:Niagarasedona) for initial installation. Copy necessary files
to the running Niagara Daemon’s ‘shared’ folder.

3.2 Sedona Installer Tool:

Access the Ontrol Sedona Installer tool through the
SedonaNetwork view. Options include syncing with Sedona Home folder
or installing from a file.

3.3 Manual Copying (Local Host):

Copy kit and platform files provided by the Sedona device
manufacturer to the Sedona home folder. Use the Sedona Installer
tool to sync new files with the station daemon’s shared folder.

3.4 Daemon Shared Folder:

Copy platform files and kit/manifest files to the Daemon Shared
Folder under home/Niagara/shared/sedona. For Jace stations, the
location will be home/Niagara/shared/Sedona.

Frequently Asked Questions (FAQ)

Q: Where can I download the required files for Ontrol N4 Sedona
driver & programming tool?

A: The required files can be downloaded from
https://www.ontrol.com/OntrolSedonaNet. Make sure to always use the
latest versions.

Q: How do I install the Sedona files using the Sedona Installer
tool?

A: Access the Sedona Installer tool through the SedonaNetwork
view and choose between syncing with the Sedona Home folder or
installing from a file.

“`

Ontrol N4 Sedona driver & programming tool
To program a Sedona device, you connect to it through a running Niagara station. · If the Sedona device is already connected through a remote Jace, you simply open the remote station. · To program a Sedona device directly from your Workbench, you will need to run a station on your local PC.
In either case, the station and workbench will need to be able to access Sedona kit and platform files. Therefore, you need to copy these files to one or more locations.
1 Required Files
The required files can be downloaded from: https://www.ontrol.com/OntrolSedonaNet. Always use the latest versions. The downloadable file sets are:
1. Niagara Modules 2. Sedona Distribution Package 3. DaspOnSerial Utility
2 Niagara Modules
These are downloaded as an archive (.zip file). Extract them to your Niagara installation’s modules folder. You may need to restart Workbench.
Rev 011224

3 Sedona Files
A Sedona distribution package is provided as a single archive file named “Ontrol Sedona Package yymmdd.zip”. This includes core Sedona Framework kit and platform files, as well as additional files to support Ontrol devices. It can easily be installed using the “Sedona Installer” tool (see below).
Other manufacturers’ Sedona files can be installed using the same tool if they are available in a compatible archive file. Otherwise, they can be copied manually to appropriate folders, as described later in this document.
3.1 Sedona Home Folder
Sedona files are primarily maintained directly under your main Niagara folder – typically C:Niagarasedona. This is where you should initially install any received or downloaded Sedona files. Niagara Workbench accesses Sedona files from this location.
However, a running station cannot access this location due to security restrictions. Therefore, these files also need to be copied to the running Niagara Daemon’s ‘shared’ folder (not the whole set, only the `kits’ and `platforms’ folders).
The Sedona Installer tool (see below) makes the whole installation and management easy.
3.2 Sedona Installer Tool
Ontrol Sedona Installer tool is available as a view of the SedonaNetwork on a running station. This can be a station on a local host (your computer) or a remote host (typically a Jace)
Right-click on the SedonaNetwork, expand the Views menu and select “Sedona Installer View.”

The installer provides two options: – Sync with Sedona Home folder – Install from file

Rev 011224

3.2.1 Sedona Installer View ­ Install from File After you select this option, use the File Open button to select the source file. In the file open dialog, you can select: – a Sedona distribution package (zip file containing a folder named `sedona’) – individual kit files (with extension .kit) – individual platform files (named platformManifest.xml) The file open dialog allows selection of multiple files. Once you select a file, click the `Commit’ button on the bottom right. Files will first be extracted/copied to the main Sedona home folder (typically C:Niagarasedona). Existing files will be overwritten. Then, the tool will check which files are missing in the station daemon’s shared folder. Only the missing files will be transferred to the station. The station should be restarted after copying files.
3.2.2 Sedona Installer View ­ Sync with Sedona Folder Use this option if you copied files to the main Sedona home folder manually. This will compare the station daemon’s shared and the main Sedona home folder, identify missing files and copy them to appropriate locations. You can click the “List Missing Files” button before committing to check which files are scheduled for copying. The station should be restarted after copying files.
3.3 Copying Sedona files manually (local host)
A Sedona device manufacturer will provide kit and platform files required for their devices. On a local host (supervisor or engineering PC), these need to be copied to the Sedona home folder – typically “C:Niagarasedona” Make sure you observe the folder structure. After copying files to the Sedona home folder, use the Sedona Installer tool (see above section 3.2.2) to sync the new files with the station daemon’s shared folder.
Rev 011224

3.4 Daemon Shared Folder
A running station cannot access the main Sedona home folder due to security restrictions. The Sedona Installer tool (see above section 3.2) copies the required files for you to the station daemon shared folder. Therefore, you don’t normally need to worry about where this folder is. In case you are interested, this section has some explanation. On a PC, the Daemon User Home can be easily accessed using the shortcut in your Niagara installation folder (This is for the typical case, when you are running a station using Platform > Application Director. If instead, you are starting a station from the Niagara console, the files are copied to the `Workbench User Home’.)
Under the Daemon User Home, the Sedona files need to go under a folder named “shared/sedona/” The copied files will include: – Platform files for the device you are connecting to. – Kit and/or manifest files for the kits used in the app you are connecting to. The folder structure follows a standard Sedona Framework setup.
For a station running on a Jace, the location will be home/Niagara/shared/Sedona. You can use the File Transfer Client under Platform to check this location. Only the kit and platform files are copied to the remote host’s “/home/niagara/shared/sedona” folder:
Rev 011224

4 Programming a Sedona device in N4
To program a sedona device directly from your workbench, you connect to it through a running Niagara station. Therefore, you need to start a station on your engineering PC. Once you have that:
– Add a SedonaNetwork to the Drivers folder. – Discover and add your Sedona device (if the device doesn’t support discovery, you can also
add it manually). – In the navigation pane, expand the sedona device and navigate down to `SoxClient’ – Expanding beyond that, you’ll find the `Sedona Tools’ and `Sedona Gateway’ headings. – `Sedona Gateway’ allows access to property-sheet, wire-sheet views of the app running
within the sedona device. – Sedona Tools’ contains tools for back up, restore and kit management:

5 DaspOnSerial Utility
DaspOnSerial is only required to establish a one-to-one connection to a non-IP Sedona device using USB. This is only required for Ontrol’a R-ION and ORION programmable color touch-screen display devices.
Rev 011224

Documents / Resources

Ontrol N4 Sedona Framework Control [pdf] User Guide
N4 Sedona Framework Control, N4, Sedona Framework Control, Framework Control

References

Leave a comment

Your email address will not be published. Required fields are marked *