Lynxspring JENEsys Edge 534 User Manual
JENEsys® Edge™ 534
1210 NE Windsor Drive
1 (877) 649-5969
© 2019 Lynxspring, Inc.
USER GUIDE
JENE-EG534
Lee’s Summit, MO 64086
sales@lynxspring.com
www.lynxspring.com
All Rights Reserved
Revised 2/1/2019
JENE-EG534-V2
Page 1 of 31
JENEsys® Edge™ 534
1210 NE Windsor Drive
1 (877) 649-5969
© 2019 Lynxspring, Inc.
USER GUIDE
Trademarks
Onyxx® and the Onyxx logo are U.S. registered trademarks of Lynxspring, Inc.
Lynxspring™ and the Lynxspring logo are U.S. registered trademarks of Lynxspring, Inc.
JENEsys® Edge™ is a trademark of Lynxspring, Inc.
Other brands and product names mentioned in this manual may be trademarks or registered trademarks of their
respective companies and are hereby acknowledged.
Copyright Notice
© 2019 Lynxspring, Inc.
All rights reserved.
This document contains proprietary information which is protected by copyright. No part of this document may be
copied, photocopied, reproduced, translated, or converted to any electronic or machine-readable form in whole or
in part without prior written approval of Lynxspring, Inc.
Disclaimer
NO WARRANTY. This technical documentation is being delivered to you AS-IS, and Lynxspring makes no
warranty as to its accuracy or use. Any use of the technical documentation or the information contained therein is
at the risk of the user. Documentation may include technical or other inaccuracies or typographical errors.
Lynxspring reserves the right to make changes in this document without prior notice, and the reader should in all
cases consult Lynxspring to determine whether any such changes have been made. The information in this
publication does not represent a commitment on the part of Lynxspring.
Lynxspring shall not be liable for incidental or consequential damages resulting from the furnishing, performance,
or use of this material.
This guide contains links and references to third-party websites that are not under the control of Lynxspring, and
Lynxspring is not responsible for the content of any reference material or linked websites. If you access a third
party website mentioned in this guide, then you do so at your own risk. Lynxspring provides these links only as a
convenience, and the inclusion of the link does not imply that Lynxspring endorses or accepts any responsibility for
the content on those third-party sites.
Lynxspring, Inc.
1210 NE Windsor Drive
Lee’s Summit, MO 64086
P 816.347.3500 F 816.437.0780
http://www.lynxspring.com
Lee’s Summit, MO 64086
sales@lynxspring.com
www.lynxspring.com
All Rights Reserved
Revised 2/1/2019
JENE-EG534-V2
Page 2 of 31
JENEsys® Edge™ 534
1210 NE Windsor Drive
1 (877) 649-5969
© 2019 Lynxspring, Inc.
USER GUIDE
Table of Contents
Niagara Documentation Addenda 4
JACE Start Up Addendum ...................................................................................................................................................................... 4
Platform Guide Addendum...................................................................................................................................................................... 5
JENEsys Edge 534 Startup procedure 6
Onyxx Network Quick Start 6
Configure the onyxxNetwork ................................................................................................................................................................... 6
Add an onyxxNetwork ........................................................................................................................................................................ 6
Discover and add Onyxx Devices ....................................................................................................................................................... 6
Manually adding Onyxx Devices ......................................................................................................................................................... 6
Add Onyxx Proxy points ......................................................................................................................................................................... 6
Using online Discover to add Onyxx Proxy points ............................................................................................................................... 7
Manually adding Onyxx Proxy points .................................................................................................................................................. 7
Onyxx Network Concepts 8
About Onyxx Network Architecture ......................................................................................................................................................... 8
About the Onyxx Network .................................................................................................................................................................. 8
Onyxx Network status notes .............................................................................................................................................................. 9
Onyxx Network monitor notes ............................................................................................................................................................ 9
Onyxx Network tuning policy notes .................................................................................................................................................. 10
Onyxx Network poll scheduler notes ................................................................................................................................................ 10
Onyxx Network views ...................................................................................................................................................................... 11
N Device Manager ................................................................................................................................................................................ 11
About the Onyxx Device ....................................................................................................................................................................... 12
Onyxx Device properties .................................................................................................................................................................. 12
Onyxx Point Manager ........................................................................................................................................................................... 13
Onyxx Driver Point Manager usage notes ......................................................................................................................................... 14
About Onyxx Driver Proxy points........................................................................................................................................................... 16
Onyxx Driver point types .................................................................................................................................................................. 16
Onyxx Driver Proxy Ext common properties ..................................................................................................................................... 17
Conversion types in Onyxx Driver Proxy points ................................................................................................................................. 18
Scale and offset calculation (linear) ................................................................................................................................................... 19
Non-linear sensor support ................................................................................................................................................................ 20
Linear Calibration Ext ....................................................................................................................................................................... 22
BooleanInputPoint ........................................................................................................................................................................... 23
BooleanOutputWritable .................................................................................................................................................................... 23
CounterInputPoint ............................................................................................................................................................................ 24
ResistiveInputPoint ........................................................................................................................................................................... 25
ThermistorInputPoint ........................................................................................................................................................................ 26
VoltageInputPoint ............................................................................................................................................................................. 29
VoltageOutputWritable ..................................................................................................................................................................... 29
About the Mini USB Port 29
Onyxx Network Driver Plugin Guides 29
Onyxx Network Driver Plugin Guides Summary ..................................................................................................................................... 29
N Device Manager ........................................................................................................................................................................... 30
Onyxx Driver Point Manager ............................................................................................................................................................. 30
Onyxx Network Troubleshooting 31
Lee’s Summit, MO 64086
sales@lynxspring.com
www.lynxspring.com
All Rights Reserved
Revised 2/1/2019
JENE-EG534-V2
Page 3 of 31
JENEsys® Edge™ 534
1210 NE Windsor Drive
1 (877) 649-5969
© 2019 Lynxspring, Inc.
USER GUIDE
The following are addenda to Niagara Documentation: docJaceStartup and docPlatform
JACE Start Up Addendum
Please note the following amendments to Niagara Documentation “docJaceStartup” in regard to the operation of the
JENEsys Edge 534. Referenced Niagara documentation is included in the installation of ProBuilder™ or Niagara
Framework® and is typically located in a directory on the user’s PC, similar to: C:\JENEsys\JENEsys-3.8.111\docs
Pg. 3 - IP Address:
The JENEsys Edge 534 is shipped with a default address in the range of: 192.168.1.12n, like the JACE-3E,
JACE-6E, JACE-2/6 series.
Pg. 6 – Preparing to commission a new controller (Step 3):
Attach the cable to the primary Ethernet connector.
Pg. 14 - Starting the commissioning Wizard (Step 5):
Please refer to the screen below:
Pg. 15 - Starting the commissioning Wizard (Step 8):
Please refer to this screen below:
Pg. 46 - System Shell:
The JENEsys Edge 534 System Shell will be accessible using the Mini USB port, rather than an RS-232 port.
About the JACE System Shell Menu:
The Shell menu of the JENEsys-Edge 534 does not include the ability to enable/disable SFTP and
Telnet.
Pg. 50 - About serial shell mode - Items Needed for Serial System Shell:
An RS-232 port on your PC is not needed.
The JENEsys-Edge 534 will only require a Mini-USB to USB cable and terminal emulation software
installed on your PC.
The JENEsys-Edge 534 does not use a jumper.
Lee’s Summit, MO 64086
sales@lynxspring.com
www.lynxspring.com
All Rights Reserved
Revised 2/1/2019
JENE-EG534-V2
Page 4 of 31
JENEsys® Edge™ 534
1210 NE Windsor Drive
1 (877) 649-5969
© 2019 Lynxspring, Inc.
Pg. 50 – 51 - Connecting to a serial system shell:
Set the Bits Per Second to 115200 for the JENEsys-Edge 534. (Step 5)
Steps 6 and 7 are not applicable to the JENEsys-Edge 534.
In Step 8, the movement of a jumper is not applicable to the JENEsys-Edge 534.
Platform Guide Addendum
Please note the following amendments to Niagara Documentation “docPlatform” in regards to the operation of the
JENEsys Edge 534:
Pg. 40 - Downgrading a JACE:
While there is a clean dist file for the JENEsys Edge 534 to restore it to a factory-like default, downgrading
beyond 3.8.111 is not available.
Pg. 41
1st Note:
The clean dist file for the JENEsys Edge 534 is only available on Lynxspring’s website.
2nd Note:
The JENEsys Edge 534 – AX is only available in builds 3.8.111 and 3.8.401, as of the date this
document was published.
Pg. 43 - Upgrading a JACE:
The JENEsys Edge 534 – AX can only be upgraded from 3.8.111 to 3.8.401. Lynxspring’s custom core files
and Onyxx drivers are required.
Pg. 47 - GPRS Modem Configuration:
The JENEsys Edge 534 does not support GPRS.
Pg. 95 - Wi-Fi Configuration:
At the time of publication of this document, the JENEsys Edge 534 does not support Wi-Fi.
Pg. 145 - Driver Types:
Some drivers are not supported by the JENEsys Edge 534.
USER GUIDE
Lee’s Summit, MO 64086
sales@lynxspring.com
www.lynxspring.com
All Rights Reserved
Revised 2/1/2019
JENE-EG534-V2
Page 5 of 31
JENEsys® Edge™ 534
1210 NE Windsor Drive
1 (877) 649-5969
© 2019 Lynxspring, Inc.
USER GUIDE
JENEsys Edge 534 Startup procedure
The startup of the JENEsys Edge 534 – AX is a two-step process as follows:
1. Commissioning the controller with 3.8.111 or 3.8.401, installing the latest Onyxx Driver, and;
2. Updating the Onyxx system version
From your PC, use the Niagara Workbench 3.8.111 or 3.8.401 installed with the “installation tool” option (checkbox
“This instance of Workbench will be used as an installation tool”). This option allows you to install necessary core files onto the
controller.
Download the latest Onyxx Driver package from our website, which includes necessary Niagara core files, a cleanDist file,
onyxxDriver.jar, platOnyxx.jar, and instructions. Follow the instructions provided in the driver package to arrange the files
appropriately, then to commission the controller and update the Onyxx system version. A station with an Onyxx Network is
required to initiate the Onyxx system version update. See Onyxx Network Quick Start for details on how.
Onyxx Network Quick Start
This section provides a collection of procedures to use the onyxxDriver to make Onyxx Proxy Points, the station interface to
physical I/O points. As with other NiagaraAX drivers, you can do most configuration from special “manager” views and property
sheets using Workbench.
Configure the onyxxNetwork
To add and configure the onyxxNetwork, perform the following main tasks:
• Add an onyxxNetwork
• Discover and add Onyxx Devices
Add an onyxxNetwork
Use the following procedure to add an onyxxNetwork under the station’s Drivers container.
To add an onyxxNetwork in the station:
Step 1: Double-click the station’s Drivers container, to bring up the Driver Manager.
Step 2: Click the New button to bring up the New DeviceNetwork dialog.
Step 3: Select onyxxNetwork, ensure number to add is 1, and click OK. This brings up a dialog to name this
network.
Step 4: Click OK to add the onyxxNetwork to the station.
Discover and add Onyxx Devices
In the Onyxx Driver architecture, file directories act as “device-level” components.
To discover Onyxx Devices:
Step 1: Double-click the onyxxNetwork to access the Device Manager.
Step 2: Click the Discover button to launch an Onyxx Device Discovery job.
Step 3: When complete, discovered Onyxx Devices are displayed in the top pane in the “Discovered” table. The
bottom pane, labeled “Database,” is a table of Onyxx Devices that are currently mapped into the Niagara station.
The database will remain empty until a device is added.
Step 4: Click to highlight the discovered Onyxx Device(s) you wish to add, then click the Add button. The Add
dialog appears, in which you can accept all defaults (
Step 5: Click OK to add the Onyxx Device(s) to your station.
Figure 3-5).
Manually adding Onyxx Devices
Manually add Onyxx Devices, using the New button in the Device Manager.
Add Onyxx Proxy points
As with device objects in other drivers, each Onyxx Device has a Points extension that serves as the container for Proxy
points. The
This section provides quick start procedures for both tasks, as follows:
onyxxDriver Point Manager is used to create Onyxx Proxy points under any Onyxx Device.
Lee’s Summit, MO 64086
sales@lynxspring.com
www.lynxspring.com
All Rights Reserved
Revised 2/1/2019
JENE-EG534-V2
Page 6 of 31
JENEsys® Edge™ 534
1210 NE Windsor Drive
1 (877) 649-5969
© 2019 Lynxspring, Inc.
• Using online Discover to add Onyxx Proxy points
• Manually adding Onyxx Proxy points
USER GUIDE
Using online Discover to add Onyxx Proxy points
This is the recommended way to accurately add Onyxx Proxy points under an Onyxx Device. Use the following
procedures:
• To discover I/O points
• To add discovered I/O points as Onyxx Proxy points
Note: If your onyxxNetwork has multiple Onyxx Devices, repeat both procedures (discover and add) for each
Device, until you have all I/O points proxied in the station.
To discover I/O points
Step 1: In the N Device Manager, in the Exts column, double-click the Points icon in the row representing the
Onyxx Device you wish to explore. This brings up its Onyxx Driver Point Manager.
Step 2: Click the Discover button to learn what I/O points are on the Onyxx Device. When the discovery job
completes, discovered I/O points are listed in the top pane of the view in the “Discovered” table. Each I/O point
occupies one row.
To add discovered I/O points as Onyxx Proxy points
Step 1: Select the I/O point or points in the Database pane of the Onyxx Driver Point Manager.
Step 2: You can map selected points in the station in different ways:
• Drag from the Discovered pane to the Database pane.
• Double-click an item in the Discovered pane.
• Right-click, then select add.
Note: All these actions will open up an “Add” dialog box.
Step 3: When the “Add” dialog appears, you typically edit a number of fields for each I/O point. For complete
details, see “Onyxx Driver Point Manager usage notes” on page 14.
The following brief summaries explain Add dialog fields:
• Name - This is the Onyxx Proxy point name—you typically change this to describe the I/O purpose.
• Type - This is the Onyxx “type,” which is selectable for any “universal input,” but fixed for any output. See
“Universal Input selection notes” on page 14 and “Output type selection notes” on page 15.
Note: Unlike other entries in the Add dialog, you cannot edit the point’s Type later.
• Address - This is the learned I/O point’s hardware’s port address.
• Poll Frequency - This specifies the point’s poll frequency group (default is Normal).
• Conversion - This specifies the conversion type used between the Onyxx Proxy extension’s “Device Facets”
and the parent point’s facets. See “Conversion types in Onyxx Driver Proxy points” on page 18.
• Facets - These are the Onyxx Proxy point’s facets, for how the value should be displayed in Niagara.
Step 4: When you have Onyxx Proxy point(s) configured properly, click OK. The Proxy points will be added to the
station and appear in the Database pane. For more details, see “About Onyxx Driver Proxy points” on page 16.
Note: In cases where you notice a fault status for input points you have edited with “non-default” facets, it is
likely related to a mismatch of the “Units” in the point’s automatically-appended Linear Calibration Ext. To clear
this fault status, expand the point’s Linear Calibration Ext and edit Units to match the units in the point’s
facets. For more information, see “Linear Calibration Ext” on page 22.
Manually adding Onyxx Proxy points
Manually add Onyxx Proxy points, using the “New” button in the Onyxx Point Manager, or by dragging from the Onyxx
palette. However, this method is generally not recommended as the path for the point will not be automatically populated.
Lee’s Summit, MO 64086
sales@lynxspring.com
www.lynxspring.com
All Rights Reserved
Revised 2/1/2019
JENE-EG534-V2
Page 7 of 31
JENEsys® Edge™ 534
1210 NE Windsor Drive
1 (877) 649-5969
© 2019 Lynxspring, Inc.
USER GUIDE
Onyxx Network Concepts
This section provides conceptual details on the onyxxNetwork driver and its components, including views. onyxxNetwork Driver
components are the station interface to physical I/O points on JENEsys Edge 534 controllers and attachable I/O extender
modules.
About Onyxx Network Architecture
Essentially, the onyxxNetwork is similar in functionality to the NdioNetwork and uses the standard NiagaraAX network
architecture. For example, real-time data is modeled using Onyxx Proxy points, which resides under an Onyxx “device”
within an Onyxx network container in the station’s Driver Container (Drivers in Nav Tree). Hierarchically, the component
architecture is: network, device, point extension, points.
Figure 3-1 onyxxNetwork driver architecture
Similarly to Ndio, “Points” is the only extension under an Onyxx “device,” and the purpose of the onyxxDriver is to configure
(and Proxy) the actual I/O hardware points.
Note: Use “Manager” views of Onyxx container components to add all Onyxx components to your station, including
Proxy points. In these views, the driver provides online “discovery” of available devices and points and will
automatically populate path names for devices and points.
For more details see:
• About the Onyxx Network
• N Device Manager
• About the Onyxx Device
• Onyxx Driver Point Manager
• About Onyxx Driver Proxy points
About the Onyxx Network
The onyxxNetwork is the top-level container component for “everything Onyxx” in a station.
Note: Only one onyxxNetwork component is valid in a station, regardless of how many Onyxx XM 34IOs or Onyxx XM
34IO-Bs are present.
The onyxxNetwork should reside in the station’s Driver Container. Add an onyxxNetwork from the Driver Device Manager
view, using the “New” command.
Lee’s Summit, MO 64086
sales@lynxspring.com
www.lynxspring.com
All Rights Reserved
Revised 2/1/2019
JENE-EG534-V2
Page 8 of 31
JENEsys® Edge™ 534
1210 NE Windsor Drive
1 (877) 649-5969
© 2019 Lynxspring, Inc.
Figure 3-2 onyxxNetwork driver architecture
USER GUIDE
Note: The JENEsys Edge 534 must have the Onyxx module installed.
The onyxxNetwork component has the typical collection of slots and properties as most other network components. The
following sections explain further:
• Onyxx Network status notes
• Onyxx Network monitor notes
• Onyxx Network tuning policy notes
• Onyxx Network poll scheduler notes
• Onyxx Network views
Onyxx Network status notes
Unlike most “fieldbus” drivers such as BACnet and Lonworks, the status of an onyxxNetwork can be “down,” in
addition to the normal “ok” or less typical “fault”. A down status might occur in the case of external I/O where the
physical connection was removed (no communications are possible), or no Onyxx devices were added to the
database.
The Health slot contains historical timestamp properties that record the last network status transitions from “ok” to any
other status. The “Fault Cause” property further explains any fault status.
Note: As in other driver networks, the onyxxNetwork has an available “Alarm Source Info” container slot you can
use to differentiate onyxxNetwork alarms from other component alarms in the station. See “About network Alarm
Source Info” in the Drivers Guide for more details.
Onyxx Network monitor notes
The Onyxx Network monitor ( Onyxx Ping Monitor)contains the basic network monitoring properties. For general
information, see “About Monitor” in the Drivers Guide. This monitor is set to run every 10 seconds and is not editable.
Lee’s Summit, MO 64086
sales@lynxspring.com
www.lynxspring.com
All Rights Reserved
Revised 2/1/2019
JENE-EG534-V2
Page 9 of 31
JENEsys® Edge™ 534
1210 NE Windsor Drive
1 (877) 649-5969
© 2019 Lynxspring, Inc.
Figure 3-3 Monitor properties of onyxxNetwork
USER GUIDE
Onyxx Network tuning policy notes
The onyxxNetwork has the typical network-level Tuning Policy Map slot with a single default Tuning Policy. More
information for this can be found in the “About Tuning Policies” in the Drivers Guide. However, given the small number
of total Onyxx Proxy points supported under an onyxxNetwork, the importance of creating additional tuning policies (or
editing the default tuning policy) is generally lower, relative to other driver networks.
Onyxx Network poll scheduler notes
The onyxxNetwork has the typical network-level Poll Scheduler slot with standard collection of properties, as described
in “About poll components” in the Drivers Guide. The following notes apply to the Poll Scheduler of an onyxxNetwork:
• By default, discovered/added Onyxx Proxy points have a Poll Frequency setting of “Normal” at the default Normal
Rate of 5 seconds. Given the small number of total Onyxx Proxy points supported under an onyxxNetwork, you
can safely assign them to the “Fast” rate (default 1 second).
• The Poll Frequencies of Fast, Normal, and Slow can be increased or decreased as desired.
Collision Arbitration Features
The Onyxx Network relies on values to be sent regularly across the sub-network as a stream. The reciever actively
“listens” for messages that pertain to it. In case the receiver was busy when the original message was sent, two
properties were added to allow for correcting – ‘Resend Interval’ and ‘Inter Point Delay.’
Resend Interval
This property allows the time between needed repeated messages to be increased or decreased. It defaults to
10 seconds (minimum) and has no upper limit. Increasing it may help minimize collisions.
Inter Point Delay
Due to the nature of the receiver, sending multiple messages at nearly the same time can cause messages to
not be received, as the receiver will be busy. This property decreases the speed at which the re-sent
messages for the same receiver are produced. The default is set for 10 seconds and can be lowered to 1
second.
Oversample Tuning
This property allows users to specify the sampling rate for collecting values. In general, values are calculated by
taking x samples of the value across a time period. The value is then calculated by averaging all the values within
the timeperiod. The more number of samples, the less an outlier will affect the value. However, this also increases
the burden on the CPU. This property is set at its max (255) so as to calculate the best value. If performance is a
concern, users can set this value lower. Though, this can allow outliers to skew the calculated value in the outliers’
direction.
Lee’s Summit, MO 64086
sales@lynxspring.com
www.lynxspring.com
All Rights Reserved
Revised 2/1/2019
JENE-EG534-V2
Page 10 of 31
Loading...