Figure 41 shows the property sheet view of a SedonaJen6lpDevice—its default view.
Properties and container slots unique to the SedonaJen6lpDevice include:
Address
Ip — Remapped IPv4 private network address of the Jennic-based device, automatically assigned by the coordinator (under the “Address Map” container slot of SedonaJen6lpNetwork).
Sox Port — The port the device’s Sox service is listening on. Default port is 1876.
Chopan Port — The port the device’s CHoPAN server is listening on. Default port is 1810.
If you know that a Jennic-based device is using a different Sox port and/or Chopan port, change it to match in the address
property.
Credentials
The credentials used to authenticate to the device in a Sox connection.
App File
File ord to an associated Sedona app file (typically .sax
file) for the device, residing in the file space of the station. Initially, there is no associated app file (device is “unassociated”).
However, this field becomes populated in a number of ways. For example, when you Get the app (or Put an app) using Sedona Tools under the device, the app file is populated. Or, you can “directly” associate an app. For related details, see Sedona device Association.
Points
The single device extension, with a default Sedona Point Manager view. For related details, see Sedona Point Manager.
Device Info
The SedonaDeviceInfoExt extension contains read-only properties about a device’s Sedona platform type. For more details, see Sedona Device Info Ext.
Sedona Tools
For Sedona provisioning tools for this device. See Sedona device "tools" views.
Before using these tools, installation of “Sedona environment files” are required on the Niagara host (e.g. JACE) running
this station, using a Niagara platform connection. This is also required for “Sox Gateway” usage. For details, see Sedona environment management.
For details on the various Sedona Tools, refer to the Sedona Framework TXS Sedona Tools Guide.
Sox Gateway
Provides a “gateway” into that device’s Sedona app. For details, see Sox Gateway.
Time Sync Enabled
If enabled, allows for periodic (automatic) time synchronization messages to be sent from the Niagara station to this device. The default value is false. For related details, see Niagara-to-Sedona device time synchronization.
Trace Dasp
If enabled, and you have station logSetup (in spy) set to “trace” for SedonaJen6lpNetwork.sox
, this directs extra device-specific messaging of the Sox traffic over the DASP (Datagram Authenticated Session Protocol)
to the station’s output (visible in platform Application Director).
Mac Address
Read-only. The unique 802.15.4 MAC address of the device, in hexadecimal notation without leading zeroes, for example: 158d00:9b017
.
Node Joined
Read-only. Indicates if the node has joined the Jennic wireless network.
Node Joined Time
Read-only. Timestamp of when the node last joined the Jennic wireless network.
Node Left Time
Read-only. Timestamp of when the node last left the Jennic wireless network.
Parent Pan Info
Container SedonaJen6lpNeighborEntry component for the single parent node for the device, 802.15.4MacAddress LQI n
(for example, 00158d00_0009b50b LQI 255
)
Contains read-only JenNet PAN info about the parent node, including:
Is Sleeping End Device — Always false
. (Whether device is a battery powered (hibernating) end device type (true
) or a continuously powered device (false
).)
Link Quality — Value between 0-255, representing strength of last packet received from this node. Values over 60 represent a good link.
Packets Lost — Number of packets sent to this node for which an ack(nowledgement) was not received. Note an ack is not expected on all packets.
Packets Sent — Number of packets sent to node from this device.
Packets Received — Number of packets device has received from this node.
Mac154 — The unique 802.15.4 MAC address of this node, in hexadecimal notation without leading zeroes, for example: 158d00:9b50b
Stale — Typically false, else true if this node entry is stale, meaning the device represented is no longer the parent. For example, if a device resets and rejoins the JenNet network, it may have a new parent (the coordinator or another router node). In this case, this Stale values shows true.
Child Pan Info
Container for one or more dynamically-added SedonaJen6lpNeighborEntry child components, if applicable. Each contains read-only JenNet PAN info about a direct child node.
If the device has no child nodes, this container is empty.
MAC802.15.4MacAddres
s LQI n
(for example, MAC00158d00_0009b017 LQI 186
)
Is Sleeping End Device — Whether device is a battery powered (hibernating) end device type (true
) or a continuously powered device (false
).
Link Quality — Value between 0-255, representing strength of last packet received from this node. Values over 60 represent a good link.
Packets Lost — Number of packets sent to node for which an ack(nowledgement) was not received. Note an ack is not expected on all packets.
Packets Sent — Number of packets sent to node from this device.
Packets Received — Number of packets this device has received from node.
Mac154 — The unique 802.15.4 MAC address of the node, in hexadecimal notation without leading zeroes, for example: 158d00:9b017
Stale — Typically false, else true if this node entry is stale, meaning the node represented is no longer a child. For example, if a device resets and rejoins the JenNet network, it may have a new parent (say the coordinator or another router node). In this case, this Stale values shows true.
Pan Info Loaded
Read-only indication if JenNet PAN info for this device is available (true
) or if it has been deleted (false
), perhaps from a device action.
Pan Info Load Time
Read-only timestamp of when PAN info last loaded, say from a device action, or from the ongoing PAN info poller mechanism (from coordinator/SedonaJen6lpNetwork).
Device Type
Configuration property that specifies whether the Jennic-based device is either “router capable” (Router), or reduced function “end device” (End Device—perhaps even a hibernating device), or simply “Unknown”. The default is Unknown.
Set this from the default (Unknown) to one of the two other selections (Router or End Device), depending on the Jennic capability
of the device. This is particularly important to allow “PAN info” polling and related data to be used in the Pan Sheet view
of the SedonaJen6lpNetwork.
Maintenance Mode Requested
(Applies to hibernating devices only) This provides indication if a “maintenance mode request” has been given on this device
(true
) or not (false
). The “Request Maintenance Mode” action on the device is typically how a request is given. This value goes to true when the action is invoked, then to false when
maintenance mode becomes active—when in Workbench a modal popup “maintenance mode active” appears. See SedonaJen6lpDevice actions.
Maintenance mode only applies to a device that hibernates (say a battery-powered device), and requires Chopan usage in the
device’s app. If the device does not hibernate, you can safely hide this property, as well as the other two Maintenance Mode properties (and also the “Request Maintenance Mode” action), working
from the SedonaJen6lpDevice’s slot sheet. Currently, Sedona Framework support for hibernating devices is not widely available,
so this is another possible reason to hide these Maintenance Mode properties and action.
Maintenance Mode Active
(Applies to hibernating devices only) Provides indication if “maintenance mode” is currently active on this device (true
) or not (false
). It becomes true only after the modal “maintenance mode active” popup appears in Workbench, and returns to false when the
maintenance mode time out period (configured in the device’s Sedona Framework app) expires. During this period, the device
is not hibernating, which enables it to accept a Sox connection from Workbench. Also see the Note on the “Maintenance Mode Requested” property.
Maintenance Mode Timeout
(Applies to hibernating devices only) Read-only indication of the current maintenance mode timeout period, as configured in the Sedona Framework app of the device. This specifies the duration of the maintenance mode active period. If a Sox connection is not established during an active period, the device returns to normal hibernation operation, until the next maintenance mode request. Also see the Note on the “Maintenance Mode Requested” property.
Chopan Virtual
A “virtual gateway” used to configure “Chopan points” in the device’s Sedona Framework app, via a virtual “Chopan Network” with “Chopan Devices” and “Chopan Points” in the Niagara station. See About the Chopan Virtual gateway.
Sedona Users
This SedonaUsersExt component registers with the station’s SedonaUserManagementService (SedonaUserManager), and internally stores the mapping of Sedona users and roles for the device (as defined in the Sedona User Device Manager view of the parent Sedona network). This component manages synchronization of those mappings down to the app in the represented Sedona device. For related details, see Sedona Device User Manager.
Copyright © 2000-2014 Tridium Inc. All rights reserved.