excelon - honeywell · 2018. 7. 27. · excelon 3 en2b-0210 ge51 r0405 excelon v. 3.04.00 user...
TRANSCRIPT
USER GUIDE
EN2B-0210 GE51 R0405
Excelon
EXCELON
EN2B-0210 GE51 R0405 Copyright © 2005 Honeywell Inc. • All Rights Reserved
EXCELON
3 EN2B-0210 GE51 R0405
Excelon V. 3.04.00
USER GUIDE
Software License Advisory This document supports software that is proprietary to Honeywell Inc. and/or to third party software vendors. Before software delivery, the end user must execute a software license agreement that governs software use. Software license agreement provisions include limiting use of the software to equipment furnished, limiting copying, preserving confidentiality, and prohibiting transfer to a third party. Disclosure, use, or reproduction beyond that permitted in the license agreement is prohibited.
Trademark Information Echelon, LON, LONMARK, LONWORKS, LonBuilder, NodeBuilder, LonManager, LonTalk, LonUsers, LonPoint, Neuron, 3120, 3150, the Echelon logo, the LONMARK logo, and the LonUsers logo are trademarks of Echelon Corporation registered in the United States and other countries. LonLink, LonResponse, LonSupport, and LonMaker are trademarks of Echelon Corporation.
EXCELON
EN2B-0210 GE51 R0405 4
5 EN2B-0210 GE51 R0405
CONTENTS
MANUAL STRUCTURE ........................................................................................................................... 7
SYSTEM REQUIREMENTS ........................................................................................................................... 7
FEATURES ........................................................................................................................... 7 Basic Features............................................................................................... 7 Enhanced Features ....................................................................................... 8
INSTALLATION ........................................................................................................................... 8
REGISTRATION ........................................................................................................................... 8 Terminate Excelon License ................................................................................ 11
START EXCELON ........................................................................................................................... 11 Where to Connect to the Network?..................................................................... 13 Excelon and other Network Management Tool Use in Parallel........................... 13 Multiple Instances Use of Excelon...................................................................... 14 Working on Domains .......................................................................................... 14
Start New Excelon Session using Same or Different Domain........................ 14 Create Additional Domain.............................................................................. 15 Switch between Domains............................................................................... 16 Remove Domain............................................................................................ 17
Excelon Environment.......................................................................................... 17 Menu Bar ....................................................................................................... 23
File ............................................................................................................ 23 View.......................................................................................................... 24 Lon............................................................................................................ 24 Web .......................................................................................................... 25 ? ............................................................................................................. 25
Toolbar .......................................................................................................... 25 Set Tree View..................................................................................................... 27 Define LON Default Settings .............................................................................. 29
GO ONLINE/OFFLINE ........................................................................................................................... 31
DETECT AND UPLOAD NODES ........................................................................................................................... 31 Search for Nodes ............................................................................................... 33
Enable/Disable Power Search for 1-Byte Domains........................................ 33 Find Nodes With Router ................................................................................ 34
Enter Neuron ID ................................................................................................. 34 Press Service PIN at Device .............................................................................. 34 Nodes................................................................................................................. 35
Display Node Properties ................................................................................ 35 Router Properties........................................................................................... 45 Set Router for EXCEL 5000 Compliance....................................................... 48 Restart Node Measurement........................................................................... 49 Remove Node................................................................................................ 49 Download Application .................................................................................... 50 Browse NVs................................................................................................... 52 Configure Node.............................................................................................. 52
Display/Change Configuration of XFL Module(s) ...................................... 55 XFL521B................................................................................................... 55 XFL522B................................................................................................... 57 XFL523B................................................................................................... 59 XFL524B................................................................................................... 61
Clear Node Statistics ..................................................................................... 62 Set Node Online / Offline ............................................................................... 62 Set Node Unconfigured ................................................................................. 62 Wink Node ..................................................................................................... 63 Send Service Pin ........................................................................................... 63 Reset Node.................................................................................................... 63 Re-read Node ................................................................................................ 63
EXCELON
EN2B-0210 GE51 R0405 6
Put Node into Diagnostic ............................................................................... 63 Sort Nodes in Node Pane ......................................................................... 65 Enable Polling of Nodes ........................................................................... 65 Disable Polling of Nodes........................................................................... 65 Instant Refresh of Single Node................................................................. 66 Reload Values of All Nodes ...................................................................... 66 Highlight Node in Network Tree ................................................................ 66 Remove Nodes from Node Pane.............................................................. 66 Further Functions ..................................................................................... 67
DISPLAY NETWORK VARIABLES ........................................................................................................................... 67 Sort Network Variables....................................................................................... 69 Enable Polling of Network Variables .................................................................. 69 Disable Polling of Network Variables.................................................................. 69 Watch NVs ......................................................................................................... 69 Instant Refresh of Single Network Variable........................................................ 72 Reload Values of All NVs ................................................................................... 72 Find Associated Node of NV in Network tree ..................................................... 72 Find Bindings of NV ........................................................................................... 72 Update Network Variables.................................................................................. 73 View Details of Network Variable ....................................................................... 74 Remove Network Variables from NV Pane ........................................................ 75
COMMON PANE FUNCTIONS ........................................................................................................................... 76 Clear List ............................................................................................................ 76 Hide Columns of Pane ....................................................................................... 76 Redisplay Hidden Columns of Pane................................................................... 76 Cyclically Refresh Pane ..................................................................................... 76
LONTALK PROTOCOL ANALYZER AND VNI MODE .......................................................................................................... 77 Start LonTalk Protocol Analyzer......................................................................... 78 View Packet Details............................................................................................ 78 Scan this Domain ............................................................................................... 80 Switch to this Domain......................................................................................... 80 Find Destination Node in Network tree............................................................... 81 Find Source Node in Network tree ..................................................................... 81 Highlight NV(s) ................................................................................................... 81 Set Filters........................................................................................................... 82 Remove all Filters .............................................................................................. 85 Show Latest Packets.......................................................................................... 86 Clear Protocol .................................................................................................... 86
AUTOMATIC NETWORK DIAGNOSTIC ........................................................................................................................... 86 Open Diagnostic Record .................................................................................... 88
CHECK PROJECT ........................................................................................................................... 89
EXPORT FUNCTIONS ........................................................................................................................... 90 Export Analyzer Packets of Project .................................................................... 90 Export NVs of Project ......................................................................................... 91 Export all NVs of Log File................................................................................... 93
NEURON CHIP SOFTWARE ERROR CODES ...................................................................................................................... 94
GLOSSARY ........................................................................................................................... 98
INDEX ........................................................................................................................... 115
EXCELON
7 EN2B-0210 GE51 R0405
MANUAL STRUCTURE It is assumed, that the user has basic knowledge about LON technology. Having Advanced knowledge would be desirable. After general descriptions such as system requirements, features, installation, etc. the manual firstly gives a short introduction into the Excelon environment. Then the different software parts are described. One and the same LON item may appear on several program spots. Hence, single LON items themselves are mostly shortly defined than explained in detail. To get detailed information on LON items, if necessary, it is strongly recommended to use the glossary and original Echelon documentation additionally.
SYSTEM REQUIREMENTS For installation and operation of Excelon, the following system requirements are necessary: Hardware Standard LonWorks Network Interface: ● SLTA-10 for serial PC ports (no VNI support) ● PCLTA-10/20 for desktop PCs ● PCC-10 PCMCIA for notebooks ● i.LON 10 / 100 including Open LDV driver 2.0 ● Other non-Echelon standard network interfaces e.g. LON dongle NOTE: The Protocol Analyzer is supported by the PCLTA-10/20 and PCC-10
PCMCIA cards only. Software Network Interface Driver delivered with device e.g.: ● SLTA Link Manager ● LonWorks Plug´n Play in Windows Control Panel Operating System Microsoft Windows: ● 2000 ● XP
FEATURES
Basic Features ● Read all node information when a service pin is received ● Search for all nodes in the network, also on multiple domains ● Parallel operation on loading nodes and reading NV data / node diagnostics in
the background ● Download of executable application (multi-node support) ● Detailed display of all node information e.g. domain table etc. ● Modification of NV values, location string, node state and domain table ● Poll network variable values
EXCELON
EN2B-0210 GE51 R0405 8
Enhanced Features NOTE: For the enhanced features, a license is needed. General ● Automatic network diagnostic ● Binding consistency check ● Multi-domain support:
Top level in the network tree view is the domain. As nodes are found, they are placed in the domain they belong to.
● Searching for all 1-byte domains. ● Change node name stored in location string ● Support of routers ● Display and modification of node buffer settings Nodes ● Multi-node operations: firmware download, reset, wink, statistics clear ● Domain property page with the ability to also change domain settings ● Statistics property page with all statistics information of a node ● Address table property page ● Additional node information:
Number of message tags, aliases, relaxed binding support ● Node diagnostics function:
List view showing statistics, message per sec. rate, and a good ... bad rating depending on error rates (Rx-rating, Tx-Rating, Crc-Rating)
● Configurable node poll rate ● Log-file recording of node statistics and communication rating (good/critical/bad) ● Manual adding of a node by typing Neuron ID NV's ● Support of structured SNVT's ● NV browser takes NV's of multiple nodes, NV's can be added, removed, sorted in
various ways ● All important NV properties in NV browser ● Detailed view of all NV properties from NV context menu ● Configurable NV refresh rate ● Log-file recording of NV data when value changes ● Display and command NV values in convenient format ● Update rating ● Find bound NVs Packet Analyzer ● Full LonTalk packet analyzer when using Echelon PCC / PCLTA card in VNI
driver mode ● Packet information details
INSTALLATION Install Excelon from the Honeywell Tools CD in the same way as any other Windows application by running the Setup.EXE and following the installation procedure.
REGISTRATION Procedure 1. If the Registration dialog box in Excelon is not already open, click on Help
menu, then submenu item Registration.
RESULT: The Excelon Registration dialog box displays.
EXCELON
9 EN2B-0210 GE51 R0405
2. Click on the Registration tab.
On the Registration tab, a reference code is displayed, which is generated from
internal PC data during installation of Excelon. 3. Click into the Reference Code field and highlight the code. 4. Press CTRL+C key to copy the code to the clipboard. 5. Access the Honeywell License Server by entering
http://license.ge51.honeywell.de/ as address in the web browser, for example in Microsoft Internet Explorer.
EXCELON
EN2B-0210 GE51 R0405 10
6. On the Welcome page, click on User Registration. 7. On the User Registration page, enter your user name and the password and
click Continue button. NOTE: The Username will be cut to a max. 8-digit user ID. Excelon will use
this user ID internally in the Registration dialog. 8. In the following fields, enter your personal data and click Send button.
RESULT: You are now registered at the Honeywell license server and the user specific Welcome page is displayed.
9. On the Welcome page, click on New License. 10. Click in the Reference code field and press CTRL+V key to paste the reference
code.
11. Enter the voucher number printed on the Excelon CD label, into the Voucher Number field.
12. Enter a free comment into the Free comment field if desired.
13. Click on Send button.
RESULT: The license key is generated and, in addition, your license data such as product, expiration date and feature is displayed.
14. Highlight the license key and press CTRL+C key to copy the key to the
clipboard.
15. Delete the entry in the License Key field in the Excelon Registration dialog box.
16. Paste the license into the License Key field key by clicking CTRL+V key. 17. Click Register Key button. 18. In the message box, confirm the registration by clicking OK.
EXCELON
11 EN2B-0210 GE51 R0405
19. Click on the License Key Info tab.
RESULT: You are now registered. The expiration date is set as requested and the features displayed in the list are available.
20. Close the Excelon Registration dialog box by clicking Close button.
Terminate Excelon License Purpose To terminate the Excelon license to use on another PC (different or new one).
When ordering Excelon you have got a unique voucher from Honeywell. With the unique voucher number you were allowed getting a license key during the registration procedure on the Honeywell Web Server. When terminating the license you need to get a new license key from the Honeywell Web Server for using Excelon on another PC. You can also give back your license.
START EXCELON Procedure 1. Be sure to have the Network Interface driver running properly. 2. Start Excelon from the corresponding program group in the Windows Start
menu.
RESULT: If Excelon is not licensed yet, a message shows that it is currently running in evaluation mode. In evaluation mode 4 nodes can be monitored for 20 minutes only. To get registered, click OK button. For further information about the registration process, refer to the "Registration" section.
EXCELON
EN2B-0210 GE51 R0405 12
If a connection to LonWorks has not been established yet, the Excelon Network Interface Settings dialog box displays:
3. From the Name drop-down listbox, select the network interface (if multiple
network interfaces can be selected). 4. Click the Set Domain button.
5. From the Size drop-down listbox, select domain size in bytes (max. 6 bytes). 6. Into the Domain ID fields, enter domain number in HEX format (without HEX
indice). NOTE: Fill out all relevant fields when selecting a domain size greater than 0.
7. Enter subnet and node number into the Subnet and Node field, respectively.
8. Clicking the Default button, sets the domain size to "0", that is, the domain ID
has zero-length. 9. Confirm by clicking OK.
EXCELON
13 EN2B-0210 GE51 R0405
RESULT: The Excelon main window is displayed.
10. To connect to the LonWorks network (Online), click icon, if not already done.
For a short introduction into the Excelon environment, please refer the "Excelon Environment" section.
Where to Connect to the Network? When analyzing a complex network, for example, where routers are used, make sure that: • the network is physically connected via the same channel as with the network
management tool in which the project has been engineered. • the same domain ID as in the network management tool is used • the same subnet ID as in the network management tool is used When physically connecting to the network via the same channel as with the network management tool, Excelon is capable of analyzing the network beyond the routers if they are configured properly.
Excelon and other Network Management Tool Use in Parallel When accessing the LonWorks network with Excelon and another network management tool such as CARE, LonMaker etc. in parallel, the same subnet ID and a different node ID must be used. Note, that the default subnet ID/node ID of Excelon is 255/127. IMPORTANT
The parallel use of Excelon and a network management tool using the same subnet ID and the same node ID may result in not reachable devices, inconsistent values and misinterpretation of NV data. Note, that in this
EXCELON
EN2B-0210 GE51 R0405 14
case, the network management tool´s subnet ID/node ID can be seen in the protocol analyzer.
Multiple Instances Use of Excelon When accessing the LonWorks network with Excelon in multiple instances, the same subnet ID and different node IDs must be used for the multiple instances. Note, that the default subnet ID/node ID of Excelon is 255/127. IMPORTANT
The use of Excelon in multiple instances using the same subnet Id and the same node ID may result in not reachable devices, inconsistent values and misinterpretation of NV data. Note, that in this case, the subnet ID/node IDs of the instance(s) can be seen in the protocol analyzer.
Working on Domains Excelon provides different ways to work on domains: • When starting Excelon firstly after installation you are asked by default which
domain you want to work on. • When already working with Excelon you can start a new session using one
certain domain in the same or different way to the previous one. • At any time you can create additional domains. If multiple domains have been
created, it is possible to switch between the domains. IMPORTANT The latest created domain is the active domain, which is highlighted bold in the tree.
To get to the right (desired) domain, make sure to use the same settings for the channel, the domain ID and the subnet ID as in the network management tool (see "Where to Connect to the Network?" section).
Start New Excelon Session using Same or Different Domain Assumption Excelon is already running. Procedure 1. Click menu item File, then submenu item New.
RESULT: The Excelon Network Interface Settings dialog box displays with the
currently selected network interface settings.
2. If the current displayed domain ID is not the one, you want to use, click on the
Set Domain button.
EXCELON
15 EN2B-0210 GE51 R0405
RESULT: The Domain Settings dialog box displays.
3. If desired, select different size from the Size drop-down list box. NOTE: The default setting is the zero-length domain with size 0, which can be
selected by clicking the Default button. 4. Enter the domain ID into the Domain ID field. 5. Confirm settings by clicking the OK button.
RESULT: The Excelon Network Interface Settings dialog box redisplays.
6. Confirm settings by clicking the OK button.
RESULT: The selected domain is displayed in the network tree of the Excelon
main window.
Create Additional Domain Assumption You are already working on a domain. Procedure 1. Select menu item Lon, then submenu item Set domain of Network Interface.
RESULT: The Domain Settings dialog box displays with the currently selected settings.
2. From the Size drop-down list box, select desired size. 3. Into the Domain ID fields, enter IDs.
EXCELON
EN2B-0210 GE51 R0405 16
4. Confirm settings by clicking the OK button.
RESULT: The new domain is displayed in the network tree.
IMPORTANT
The latest created domain is the active domain (indicated in bold). When searching for nodes on the network via the Search for Lon nodes command only nodes residing on the active domain will be loaded, except if the Search nodes also on zero-domain option in the Excelon Settings dialog box is enabled. In this case, nodes residing on the zero-domain will be loaded additionally. The loaded nodes will be arranged under the corresponding domain entries in the network tree.
To work on another domain, refer to the "Switch between Domains" section on
this page.
Switch between Domains Procedure 1. In the network tree, highlight the domain you want to switch to. 2. Click right mouse key and with left mouse key select Switch to this Domain in
the context menu.
EXCELON
17 EN2B-0210 GE51 R0405
IMPORTANT The domain, which had been switched to, is now the active domain (indicated in bold). When searching for nodes on the network via the Search for Lon Nodes command only nodes residing on the active domain will be loaded, except if the Search nodes also on zero-domain option in the Excelon Settings dialog box is enabled. In this case, nodes residing on the zero-domain will be loaded additionally. The loaded nodes will be arranged under the corresponding domain entries in the network tree.
Remove Domain Procedure 1. In the network tree, highlight the domain you want to remove. 2. Click right mouse key and with left mouse key select Remove in the context
menu.
Excelon Environment
EXCELON
EN2B-0210 GE51 R0405 18
The Excelon Main Window consists of the following components: ● Menu bar (A) ● Toolbar (B) ● Network tree pane (C) ● Network variables (NV) pane (D) ● Node pane (E) ● Protocol pane (F) ● Status bar (G)
Menu Bar (A) As in any Microsoft Windows application, the menu bar provides application specific menus (see application specific sections and "Menu Bar" section)
Tool Bar (B) As in any Microsoft Windows application, the tool bar provides application specific
buttons (see application specific sections and "Toolbar" section)
Network Tree Pane (C) In the network tree pane, the domains, devices and nodes being detected during network scanning are displayed in a hierarchical LON structure, shortly named ´network tree`in the following.
EXCELON
19 EN2B-0210 GE51 R0405
Individual icons display nodes with their status. Examples:
Nodes Host-based controller Neuron-based node, LonMark Statuses
configured, online
configured, offline Channels From the network tree pane, further functions can be accessed via context
menu by right-mouse clicking.
EXCELON
EN2B-0210 GE51 R0405 20
Network Variables (NV) Pane (D) The network variables (NV) pane can show all important information of NVs, both
from explicitly selected nodes and from any bound NVs of which values have currently changed. NOTES: To enable NV display, the Watch bound NVo values option in the
Excelon Settings dialog box must be checked (see "Define LON default Settings" section).
The Watch bound NVo values function is only applicable if PCLTA-
10/20 and PCC-10 PCMCIA cards are used.
Individual icons display the network variables: Examples:
SNVTs (on yellow background) nvi (green) nvo (red) For each network variable the following parameters are listed:
• Poll/Index • Logical address of node • NV Name • Value
EXCELON
21 EN2B-0210 GE51 R0405
• SNVT • Network variable type • LonMark object • Selfdocumentation string • NV size • Binding status • Address • Service type • Time • Update rate • Raw Hex
From the NV pane, further functions can be accessed via context menu by right-mouse clicking. Multi-selection of NVs is possible.
Node Pane (E) The node pane gives an overview about the status and the communication situation
of one or more nodes in the network.
Bullets indicate the status of the node as follows: ● Green = Communication of the node is "OK". The node has less than 2 % errors ● Yellow = the node has 2% - 10 % errors (according to definable settings) ● Red = the node has more then 10% errors (according to definable settings) ● Red ring = software error is logged onto the neuron chip.
Nodes can be polled with a definable poll interval. For each node the following parameters are shown: ● Neuron ID ● Channel no.
EXCELON
EN2B-0210 GE51 R0405 22
● Domain ID ● Subnet/Node ID ● Location String ● Device type ● Total messages/sec ● CRC errors (%) ● Rx messages/sec ● Rx errors (%) ● Tx messages/sec ● Tx errors (%) ● Reset status ● Last error code logged onto neuron chip ● Log time since last statistic clear The complete message statistic of each node can be very helpful for "communication tuning" if the network load is high. From the Node pane, further functions can be accessed via context menu by right-mouse clicking. Multi-selection of nodes is possible by using mouse and CTRL or SHIFT key.
Protocol Pane (F) The protocol pane shows the packets being sent on the network. Actions typically include:
requests
responses
NV updates
For each action, the following parameters are shown:
EXCELON
23 EN2B-0210 GE51 R0405
● Packet ● Timestamp ● Domain ● Tag ● Attribute ● From (sender) ● To (receiver) ● Service ● Message ● Data (sent) NOTE: To enable the LonTalk Protocol Analyzer the "VNI-setting" of the network
interface is required (only applicable if Excelon is licensed). The protocol pane gets active by clicking inside the pane. IMPORTANT
The LonTalk Protocol Analyzer is always active and will record all packets even if they are not shown in the protocol pane.
From the Protocol pane, further functions can be accessed via context menu, which is available by right-mouse clicking.
Status Bar (G) The Status line at the bottom shows:
● Action the protocol analyzer is performing or number of selected Items (NVs or nodes)
● Total number of devices already detected ● Current status (offline or online) of the network interface and current driver ● Total packet count ● Actual packet count/sec ● Average packet count/sec ● Percentage of alternate path packets ● Last updated NV with its logical address
Menu Bar The menu bar provides the following menus:
File
New Opens Network Interface Settings dialog box for establishing the connection to LonWorks or connecting to another network interface. Open
EXCELON
EN2B-0210 GE51 R0405 24
Opens an already recorded .LON file. Save Saves the current record in Excelon file format .LON. Save as Saves the current record under different name. Exit Closes Excelon.
View
Toolbar Displays the toolbar below the menu bar (see "Toolbar" section). Status bar Displays status messages in the status bar on the bottom. Clear List Removes all items from NV, Node, or Protocol pane. Show Channels in Tree Displays channels with their nodes in network tree. Show Programs in Tree Displays device types (host-based controllers and neuron-based nodes) with their nodes in network tree. Show Neuron ID in Tree Displays nodes sorted ascending by their neuron IDs in network tree.
Lon
Online Connects Excelon to the LonWorks network. Send Service Pin Sends the service pin of Excelon´s network interface to LonWorks without pressing the service pin. Search for Lon Nodes Searches nodes on the LonWorks network in the active domain and displays detected nodes in the network tree. Search all 1-Byte domains Searches for 1-Byte domains and displays detected nodes in the network tree. Automatic Network Diagnostics Records all relevant network parameters over a certain time period and, if desired, save it in a file. Add a Lon Node Adds a node to the network tree by entering the neuron ID of the node in the Add New Node dialog box. Set domain of Network Interface Defines the domain including domain size, domain ID, subnet ID, node ID, and authentication key. Check Project
Checks the project regarding the following subjects:
EXCELON
25 EN2B-0210 GE51 R0405
• Duplicate device addresses • Broken connections • Devices with high error rates • Devices with high traffic load • NVs with high traffic load
The result will be displayed in HTML format. Settings Defines settings to be applied by default during an Excelon session.
Web
User address mapping Invokes W.O.C. specific dialog for doing the mappings (see W.O.C Installation Instructions, form no. EN2B-0219).
?
Help Contents Invokes Excelon Help. About Excelon Displays version number and copyright of Excelon. Registration Invokes Registration dialog box.
Toolbar The tool bar provides the following tools:
Opens Network Interface Settings dialog box for establishing the connection to LonWorks or connecting to another network interface.
Opens an already recorded .LON file.
Saves the current recording in Excelon file format .LON.
Connects (online) / disconnects (offline) Excelon to/from the LonWorks network. This icon can be used for quickly toggling between Excelon and a second Lon tool such as CARE, both connecting to the LonWorks network.
Searches nodes connected to LonWorks and display them in the network tree on the left. Only available when Excelon is online.
Adds a node to the network tree when service pin at device is pressed.
Starts Automatic Network Diagnostics.
EXCELON
EN2B-0210 GE51 R0405 26
Displays previously hidden columns of the NV, node or protocol pane.
Hides columns of the NV, node or protocol pane.
Clears pane currently selected.
Enbables/Disables Polling of network variables, nodes, or packets.
Reloads the current values of NVs or nodes dependent on the pane currently selected.
Restarts measurement for all nodes being displayed in the node pane.
Invokes W.O.C. (Web Office Console) dialog for editing mappings (see W.O.C Installation Instructions, form no. EN2B-0219).
Displays version number and copyright of Excelon.
EXCELON
27 EN2B-0210 GE51 R0405
Set Tree View You have the following options for setting which items will be visible in the network tree (see also Excelon "Environment" section): Show Channels in Tree Displays channels with their nodes. Note that routers will be shown in both channels.
Show Programs in Tree
EXCELON
EN2B-0210 GE51 R0405 28
Displays device types (host-based controllers and neuron-based nodes) with their nodes.
EXCELON
29 EN2B-0210 GE51 R0405
Show Neuron ID in Tree Displays nodes sorted ascending by their neuron IDs.
Procedure 1. Click menu item View, then select submenu item Show Channels in Tree,
Show Programs in Tree, and/or Show Neuron ID in Tree.
RESULT: The selected items will be displayed in the network tree (see figures above).
Define LON Default Settings Purpose To set general settings to be applied by default during a session.
Procedure 1. Click menu item Lon, the submenu item Settings.
RESULT: The Excelon Settings dialog box displays.
EXCELON
EN2B-0210 GE51 R0405 30
2. Click the Default button to set defaults and/or check desired options under: Load Node on Service Pin If checked, a node will be loaded and displayed in the network tree after the
service pin at the device has been pressed. Highlight Node on Service Pin If checked, a node in the network tree will be highlighted after the service pin at
the device has been pressed. Scan Lon Network on Startup If checked, the network will be scanned automatically on Startup. Note, that
Excelon scans only the domain set for the network interface and in addition the zero-length domain, if the Search nodes also on zero-domain option and/or the Power Search option is checked.
Minimize Window on Startup If checked, the Excelon main window will be minimized on Startup. Search nodes also on zero-domain If checked, nodes will also be searched on zero-length domain, even if the
current network interface is set to another domain. NV Polling and Node Diagnostics NV Polling Rate Enter value in milliseconds for polling NVs. Node Polling Rate Enter value in seconds for polling nodes. Good if less than … % errors Enter value in percent, which determines the display color of the node in
the Node pane. A "good" node, which has less errors than the Bad if more than … % errors Enter value in percent, which determines the display color of the node in
the Node pane. A "bad" node, which has more errors than the entered value, will be displayed in red in the Node pane.
EXCELON
31 EN2B-0210 GE51 R0405
Nodes that have errors in the range between the both values, will be displayed in yellow.
Log NV value changes to file If checked, NV value changes will be saved in the ´nvvalues.log` file in
the Excelon home directory. The columns are tab-separated for an import into MS-Excel.
Log Node diagnostics to file If checked, changed node statistic values will be saved in the
´nodediag.log` file in the Excelon home directory. The columns are tab-separated for an import into MS-Excel.
LonTalk Protocol Analyzer Ringbuffer Size Enter value in packets for the ringbuffer size. When the ringbuffer size is
exceeded, the oldest packet will be overwritten with the latest packet. Show extended information in Analyzer If checked, names of nodes (subnet/node or location string), NV names,
detailed NV messages and data are shown in the protocol pane. Watch bound NVo values If checked, any bound NV which value has been updated is displayed in
the NV pane. Watch foreign NV fetches If checked, any bound NV which has been polled by a network analyzer
tool other than Excelon is displayed in the NV pane. Analyzer Refresh Enter value in seconds when the Analyzer should display updated data. Log Analyzer Packets file If checked, all packets will be saved in the ´packets.log` file in the
Excelon home directory. The columns are tab-separated for an import into MS-Excel.
3. Confirm settings by clicking the OK button.
GO ONLINE/OFFLINE Procedure You can connect/disconnect to the LonWorks network, that is, go online/offline by
simply toggling the icon in the toolbar or the Online submenu item in the Lon menu.
DETECT AND UPLOAD NODES NOTE: To search for nodes on the right domain and get the desired results,
connect to the network correctly as described under the "Where to connect to the network?" section.
Nodes on the network can be detected and uploaded from the network in 3 ways: ● By the "Search for nodes" function ● By pressing the service pin at the device ● By entering the neuron ID manually in the corresponding dialog Uploaded nodes are displayed in the network tree a hierarchical structure as follows:
EXCELON
EN2B-0210 GE51 R0405 32
The symbols have the following meaning: LonWorks Network (may display multiple domains) Host-based controller Neuron-based node, LonMark Neuron-based node, non-LonMark Honeywell XFL521B module (AI) Honeywell XFL522B module (AO) Honeywell XFL523B module (DI) Honeywell XFL524B module (DO) If devices are LonMark, the corresponding functional profile is also shown. The devices are sorted by their program ID. Nodes states are displayed in the network tree as follows:
configured, online
configured, offline
unconfigured
applicationless For each node, the name is displayed either as location string or, if no location
string has been issued, as subnet/node address. To upload nodes, use one of the following procedures as described in the corresponding sections: ● By the "Search for nodes" function ● By pressing the service pin at the device ● By entering the neuron ID manually in the corresponding dialog
EXCELON
33 EN2B-0210 GE51 R0405
Search for Nodes NOTE: To search for nodes on the right domain and get the desired results,
connect to the network correctly as described under the "Where to connect to the network?" section.
Procedure 1. Select menu item Lon, then submenu item Search for Lon Nodes, or click
in the toolbar. If menu item is inactive, Excelon could not connect to LonWorks. Verify driver
settings and re-start Excelon, or select menu item File, then submenu item New.
RESULT: Excelon will find all nodes that reside on the domain set in the
Network Interface Settings dialog box (see also "Where to connect to the network?" section). Normally, a LON network installed with a Lon tool such as LonMaker for Windows will not use the zero-domain used as default in Excelon. To find all nodes of a project, press the service pin of one node and make the node´s domain the default domain for Excelon by using the Switch to this Domain command. When pressing the Search for Nodes icon in the toolbar, Excelon will find all nodes of that project.
Enable/Disable Power Search for 1-Byte Domains You can apply a power search if you want Excelon also to search on 1 Byte-domains when scanning the network for nodes. NOTE: LNS tools such as CARE or LonMaker issue 1-Byte domains by default
for projects with random domain IDs.
Procedure 1. Select menu item Lon, then submenu item Power Search.
RESULT: The Power Search is performed scanning all 1-Byte domains starting with ´00`, then ´01` etc., until ´FF`.
If the Search nodes also on zero-domain option is enabled, the
zero-domain will be scanned in advance. Note that this will take a considerable time. The Power Search can be
aborted by clicking on the Search for Nodes icon .
EXCELON
EN2B-0210 GE51 R0405 34
Find Nodes With Router In case a router is used, nodes that may reside on the channel behind the router can only be found if the domain of the network interface is set to the same domain as the router. NOTE: To search for nodes on the right domain and get the desired results,
connect to the network correctly as described under the "Where to connect to the network?" section.
Enter Neuron ID
Procedure 1. Select menu item Lon, then submenu item Add a Lon Node.
RESULT: The Add New Node dialog box displays.
2. Enter the neuron ID of the node.
3. Click OK button.
RESULT: The node is uploaded and added to the network tree, in this case
´CHC209`.
Press Service PIN at Device
Procedure 1. Click on in the toolbar
2. At the device, press the service pin.
RESULT: The node is uploaded and added to the network tree, in this case ´D_V2D0`.
EXCELON
35 EN2B-0210 GE51 R0405
Nodes
For nodes displayed in the network tree, the following functions are provided via context menu: ● Display node properties ● Browse NVs of node ● Configure node ● Download application into node ● Clear statistics of node ● Set node online/offline ● Set node unconfigured ● Wink to node ● Reset node ● Put node into diagnostic ● Re-read node ● Remove node from network tree
Display Node Properties Node properties are e.g.: • Program and Neuron ID • Selfdoc string • Location string • etc.
EXCELON
EN2B-0210 GE51 R0405 36
Procedure 1. In the network tree or in the Node pane, click on the node, you want to display properties for.
2. Click right mouse key, and with left mouse key click on Node Properties in the
context menu.
RESULT: The Node Properties dialog box displays.
Node
On the Node tab, the following general data is shown: Program ID
A unique identifier stored in the device (Neuron Chip's EEPROM) that identifies the application program running on the node.
Self Doc
Selfdocumentation string: Descriptive information of the node´s program and network variables.
Neuron ID A 48 bit number assigned to each neuron chip at manufacture time. Like a serial number, each neuron chip has a unique Neuron ID.
Location String
Alphanumerical description which could have been issued in the network management tool. The Location string can be modified.
Num. of domains Number of domains the node supports Num. of Addr. Number of supported addresses in the address table of the node Num. of NVs
EXCELON
37 EN2B-0210 GE51 R0405
Number of NVs the node includes Num. of Aliases Number of reserved aliases in the node (see Aliases tab) Num. of Tags Number of reserved message tags Relaxed binding
Whether the node supports relaxed binding or not Host-based
Whether the node is host-based or not Channel ID
Channel ID
Neuron Chip Neuron chip type Firmware Current firmware version Access State Whether the node is accessible (online) or not (offline)
3. If desired, continue by clicking on the Status tab.
Status
On the Status tab the current node status is displayed (pressed icon):
configured, online
configured, offline
unconfigured
EXCELON
EN2B-0210 GE51 R0405 38
applicationless To change a status, click on desired icon. To reset the node click on the Reset button. When resetting the node,
the application in the device will be restarted.
4. If desired, continue by clicking on the Domains tab.
Domains
On the Domains tab, general information about the domain where the node
resides, is shown. A node can reside on max. 2 domains. Domain 0
Subnet Size Subnet ID and subnet size in bytes of domain 0. Node Node ID of domain 0. Domain ID Domain ID of domain 0. Auth Key Shows authentication key of domain 0. Leave Dom 0, Set Dom 0 buttons Click Leave domain 0 button, if you want to take the node out of the domain. If you are sure, confirm the following message box by clicking OK button.
EXCELON
39 EN2B-0210 GE51 R0405
RESULT: The domain is set to ´unconfigured`. As soon as both domains of a node are unconfigured, the node will enter the unconfigured state, indicated by the blue ring in the network tree.
Or, click Set domain 0 button to change the domain for the node. RESULT: The Domain Settings dialog box displays.
In the Domain Settings dialog box, enter the domain settings and confirm by clicking the OK button.
Domain 1 Settings and functions of domain 1 apply in the same way as to Domain
0 (see descriptions for Domain 0).
5. If desired, continue by clicking on the Addresses tab.
EXCELON
EN2B-0210 GE51 R0405 40
Addresses
The Addresses tab gives information about the address table entries
and the timer settings (transport parameter). For each address table entry, the following settings are shown:
Addressing
Addressing type, which gives information about the node´s bindings to other nodes. One of the following addressing options are displayed:
Unused: "no address table entry" S/N: Subnet/Node ID Gp: Group number Broadcast: Domain or subnet broadcast Turnaround: NV is bound to other NV of the same node Unsupported: Address table entry is not supported due to limited memory allocated by the application programmer
Domain
Domain ID Retry
The max. number of retries the node will perform when sending out a message to a recipient. This number typically raises when the receiving node is offline or defect. Applies to acknowledged, unacknowledged-repeated, and request-response service.
Rpt timer
Repeat timer: Time interval in ms between repetitions of an outgoing message. Applies to unacknowledged service and unacknowledged repeated service.
Rx timer
Receive timer: Time interval in ms that expires when the receiving node has allocated a ´receive transaction record` due to an icoming packet.
EXCELON
41 EN2B-0210 GE51 R0405
The receive timer must be greater than the greatest product of retry count and transaction timer. Applies to acknowledged and request-response service.
Tx timer
Transaction timer: Time interval in ms between retries. Applies to acknowledged and request-response service.
6. If desired, continue by clicking on the Statistics tab. Statistics On the Statistics tab, accumulated values of the most important parameters are
displayed. ::
Packet errors detected (CRC) Number of detected packets that have a CRC (Cyclic Redundancy Check) error.
Transaction timeouts
Number of times that the node failed to receive expected acknowledgements or responses after retrying the defined number of times.
Receive trans full errors
Receive transaction full errors: The number of times that an incoming packet was discarded because there was no room in the transaction database.
Lost msgs (no app buff)
Lost messages: Number of times that an incoming message has been discarded due to application buffer overflow.
Missed msgs (no net buff)
Missed messages: Number of times that an incoming message has been discarded due to network buffer overflow.
EXCELON
EN2B-0210 GE51 R0405 42
Packets received by node Number of packets the node has received.
Packets addressed to node
Number of packets that have been addressed to the node. Messages transmitted by node Number of messages that the node has transmitted. Transmission retries Number of times that the node repeatedly transmitted a packet. Backlog overflows Number of times, the backlog reaches its max. value of 63. The backlog
represents the number of nodes with a packet to send during the next packet cycle.
Late acks or responses Number of of acknowledgements or responses that arrived at the node
after the transmit transaction had expired. Collisions detected Number of collisions detected on the network. EEPROM lock State of EEPROM lock: Clear or locked. Last reset cause
Clear: after statistics clear Powerup: after powerup External: Reset by network management tool Watchdog: internally, indication of application error in neuron chip Software: internally, triggered by application
Last error logged Description of the last software error logged onto the neuron chip (see
"Neuron Chip Software Error Codes" section). Comm. Ratings This area shows the communication ratings in percent for the following
errors:
CRC Errors Rate in percent of packets that have a CRC (Cyclic Redundancy Check) error Receive Errors Rate in percent of lost packets Transmit. Errors Rate in percent of failed transmitted packets NOTE: If values can no longer be displayed, the overflow is
indicated by dashes ´---`. Refresh button To get the actual values from the node, click the Refresh button. Clear button To clear the statistic of the node, that is, set the values to zero, click the
Clear button. 7. Click OK button to confirm currently defined settings. 8. If desired, continue by clicking on the Aliases tab (only available, if the node has
aliases).
EXCELON
43 EN2B-0210 GE51 R0405
Aliases
If reserved aliases of the node have been used, they are displayed on the Aliases tab by:
Index Index of the reserved alias NV Name The name of the NV NV Index Index of the NV in the device (config_table) Selector NV selector Service Service type Addr Address of the node in format: <address table entry>, <subnet>, <node>
9. If you are an advanced user and want to change buffer settings, continue by
clicking on the Buffers tab. Buffers
WARNING Modifying these settings may cause serious problems with the device. Hence, authorized and trained personnel should only do modifications. Normally the manufacturer will do these changes.
EXCELON
EN2B-0210 GE51 R0405 44
Type - Count - Size Lists buffer type, buffer count and buffer size (bytes) columnwise as follows:
Receive transaction
Size and number of ´Receive transaction buffer` which defines Incoming transactions, that can be handled concurrently by the network processor.
Transmit transaction
Size and number of Transmit transaction buffer. App buffer in
Size and number of buffers between network and application processors for incoming application messages and network variables.
App buffer out
Size and number of non-priority and priority buffers between application and network processors for outgoing messages and network variables.
Net buffer in
Size and number of buffers between MAC and network processors for incoming explicit messages and network variables.
Net buffer out
Size and number of non-priority and priority buffers between network and MAC processors for outgoing application messages and network variables.
App buff out priority
Number of priority application buffers. Net buff out priority
Number of priority network buffers. Total Memory - Original
Displays the total and the original memory of the buffers.
EXCELON
45 EN2B-0210 GE51 R0405
10. To set changed buffer values, click Set button. 11. To reset the buffer values to their original state, click Reset button. 12. Click OK button to save changes.
Router Properties
WARNING Modifying router settings may cause serious problems with the device. Hence, authorized and trained personnel should only do modifications. Normally the manufacturer will do these changes.
In the following, the additional node properties of routers are described.
Procedure 1. Open the Node Properties dialog box for the router as described in the "Display Node Properties" section.
Node On the Node tab, the following properties are shown additionally: Router Alg Router Algorithm for the near and far side: configured router, learning
router, bridge, repeater Router Mode Router mode for the near and far side:
Normal= returns the router from temporary bridge mode temp_bridge=temporary bridge mode which cause router to temporarily
forward all messages in the domain init_rtr_table=copies forwarding tables from EEPROM tables into RAM
tables or sets all RAM tables to flood
EXCELON
EN2B-0210 GE51 R0405 46
Channel ID Far Channel ID of the far side Access state Whether the router is accessible (online) or not (offline) See also general Node description in the "Display Node Properties"
section. Status See general Status description in the "Display Node Properties" section. Domains near, Domains far Shows the Domains properties for the near and far side of the router. For
general description of the domains properties see Domains description in the "Display Node Properties" section.
Statistics See general Statistics description in the "Display Node Properties" section. Routing EEPROM
The Routing EEPROM tab shows the routing rules for the EEPROM of the
router. The ´x` character means Yes, the ´- -` characters mean No. Routing RAM The Routing RAM tab shows the routing rules for the RAM of the router. The ´x`
character means Yes, the ´- -` characters mean No.
EXCELON
47 EN2B-0210 GE51 R0405
Buffers Near, Buffers Far Shows the Buffers properties for the near and far side of the router. For general
description of the buffers properties see Buffers tab description in the "Display Node Properties" section.
EXCELON
EN2B-0210 GE51 R0405 48
2. After viewing the router properties, close dialog box by clicking OK or Cancel button.
Set Router for EXCEL 5000 Compliance To support "Building Management Functionality" (Scheduling, Alarming, Trending) in a LonWorks network, Excelon provides the automatic configuration of the used router(s) for being compliant with the corresponding EXCEL 5000 requirements. In case the default buffer settings are not sufficient to support EXCEL 5000 Building Management Functionality, the XL 5000 button will be displayed on both tabs.
Procedure 1. Click the XL 5000 button to configure the router as required for EXCEL 5000 compliance on either side, near or far.
RESULT: The buffers will be set to the required values.
EXCELON
49 EN2B-0210 GE51 R0405
2. Click OK button to confirm settings.
RESULT: Excelon will ask to update the opposite router side for EXCEL5000 compliance too. Confirm the update.
Restart Node Measurement Purpose To clear the statistics of all nodes listed in the node pane. That means, that Excelon
resets the accumulated statistic values. Note, that the received, addressed and transmitted values do not stay at ´0` due to
instant reading of the current packet being sent over the network.
Procedure 1. In the network tree or in the Node pane, select a node Or, in the NV pane select a NV.
2. Click on the Restart Measurement icon in the toolbar, or click right mouse button and with left mouse button, click on Restart Measurement in the context menu.
RESULT: The statistics of all nodes displayed in the Node pane are cleared.
3. To view accumulated values, refresh single nodes or set node(s) in cyclic
refresh.
Remove Node Purpose To simplify the arrangement of the nodes in the network tree.
After the node was removed, the node can be added again as described under the "Detect and Upload Nodes" section.
EXCELON
EN2B-0210 GE51 R0405 50
NOTE: Removing a node has no effect on the node itself.
Procedure 1. In the network tree click on the node, you want to remove. 2. Click right mouse key, and with left mouse key click on Remove in the context
menu.
RESULT: The node is removed from the network tree.
Download Application Purpose To download the application into the physical LON device.
Make sure that the LON device is suitable for executing the application you want to download.
CAUTION Attempting a download into a non-suitable LON device, the LON device will be seriously damaged.
Applications to be downloaded can have one the following formats: • APB • NXE + XIF file
We recommend the download via APB file. If an application should be downloaded via NXE file the matching XIF file must be given additionally.
Procedure 1. In the network tree or in the Node pane, click on the node, you want to
download an application to. To download an application into multiple nodes, highlight multiple nodes by concurrently pressing CTRL, respectively SHIFT key.
2. Click right mouse key, and with left mouse key click on Download in the context menu.
RESULT: The Node Program Download dialog box opens showing the
program ID, self-documentation string, neuron chip type and firmware of the node.
NOTE: All neuron chip types also with Flash eprom can be downloaded.
EXCELON
51 EN2B-0210 GE51 R0405
3. Click on Program button.
RESULT: The Open dialog box displays.
4. In the Open dialog box, browse to the folder where the program is saved. Select the application type from the Files of type drop-down list box. Select application in the list and confirm by clicking OK button.
IMPORTANT
In case a NXE file is used for download, make sure that the NXE file and the XIF file match each other in order to avoid destruction of the node.
6. If you are sure that the application file and XIF file match, confirm message by
clicking OK button. RESULT: The application data is displayed in the Node Program Download
dialog box.
7. Compare the new application data with the currently running application data displayed at the top of the dialog box.
EXCELON
EN2B-0210 GE51 R0405 52
8. If desired, select options under
• Set node configured, online after download if checked, the node will be given a default domain (zero-domain) and set online. Note, that the node must be commissioned with the original commissioning tool after it has been downloaded.
• Load executable program if checked, executable part of application will downloaded
• Load configuration if checked, existing bindings and configuration parameters will be overwritten with program defaults
• Fast Flash Download only applicable, if device has a Flash EEPROM. EEPROM will be burned in Honeywell quick burn time.
by checking the corresponding checkbox(es)
9. Confirm by clicking the Load button.
RESULT: The new firmware is downloaded and the node is re-read in Excelon.
NOTE: In some cases, after download the location string will not be displayed
correctly. In such cases re-read the node.
Browse NVs Browsing NVs means to display all network variables of selected nodes in the NV
pane. All important information of the NVs of the selected node(s) is shown. For details, please refer to the "Excelon Environment" and "Display Network Variables" sections.
Configure Node The Configure command is only available if the node contains configuration properties.
Procedure 1. In the network tree, click on the node you want to configure. 2. Click right mouse key, and with left mouse key, click on Configure In the
context menu.
RESULT: The configuration dialog for the node displays.
EXCELON
53 EN2B-0210 GE51 R0405
On the left, the configuration properties are shown. In general, only
the value of the configuration property can be changed. 3. Click on the configuration property you want to change.
RESULT: On the right, the following data are shown.
Definition Displays the LonMark self-documentation string of the configuration
property. CP Type / Index Displays configuration property type, SCPT (Standard Configuration
Property Type or UCPT (User-defined Configuration Property Type) with its index. The index specifies the configuration property index within the specified resource file set. For example, the configuration property index for the SCPTmaxSendTime type in the standard resource file set is specified as “49”.
Object reference Displays the references of the blocks. Configuration flags: 0x80 Displays configuration flags.
Each configuration property on a device may specify optional flags that are used to notify a network tool of whether or not a configuration property can be modified, and if so, when it can be modified. These flags are optional. If a configuration property is declared without any flags, a network tool may assume that the configuration property can be modified at any time.
Obj disable Specifies that a network tool must disable the functional block
containing the configuration property, take the device offline, or ensure that the functional block is already disabled or the device is already offline, before modifying the configuration property. This flag or the Device-Offline flag is recommended for a configuration
EXCELON
EN2B-0210 GE51 R0405 54
property implemented within a configuration file with direct memory read/write access if the application requires update notification, or if the application cannot tolerate updates from the network at the same time the application is reading the configuration property. A network tool may elect not to disable a functional block before modifying a configuration property with the Obj disabled flag if that device is already offline and can be updated while offline. This is allowed because an offline device has all its functional blocks implicitly disabled, and because a functional block cannot be directly disabled when the device is already offline.
Offline Specifies that a network tool must take this device offline, or ensure
the device is already offline, before modifying the configuration property. This flag or the FB-Disabled flag is recommended for a configuration property implemented within a configuration file with direct memory read/write access if the application requires update notification, or if the application cannot tolerate updates from the network at the same time the application is reading the configuration property. This flag should not be used for configuration properties implemented within configuration files that are accessed via FTP, and network tools should ignore this flag for such configuration properties. This is because a device cannot transfer configuration property values via FTP while offline. In fact, an offline application must be placed into the online state for the duration of any FTP configuration property operations.
Constant The configuration property can never be changed by a network tool.
However, network tools may write such configuration properties when they reside in a writeable value file as long as the value is not changed. A network tool may do this as part of an update to another configuration property adjacent to the constant value. Configuration properties with the Constant flag but without the Device-Specific flag can be assumed to have the same value on all devices using the same standard program ID.
Reset Specifies a factory setting that may be read or written when the
device is manufactured, but is not normally (or ever) modified in the field. In this way, a standard installation tool may be used during manufacture to calibrate a device, while a field installation tool would observe the flag in the field and prevent modification of the value, or optionally require a password to modify the value.
Manufacturer Specifies that a network tool must reset the device after changing
the value of the configuration property. If multiple modifications of configuration properties are being made at the same time, then one reset can be completed in lieu of having to reset the device the same number of times as Reset-flagged configuration properties were modified.
Dev.specific The configuration must always be read from the device instead of
relying upon the value in the device interface file or a value stored in a network database. Network tools must never change this property’s value except as a side effect of a new program download. This is used for configuration properties that must be exclusively managed by the device, such as a setpoint that is updated by a local operator interface on the device. This flag is not used for configuration properties that are updated both by the device application as well as by network tools. Such configuration properties must provide an alternate means to determine which copy of the configuration property (the device copy or the network
EXCELON
55 EN2B-0210 GE51 R0405
database copy) is current, or an alternate means to keep both copies synchronized.
Range min max Displays the value range of the configuration property. Only present
if specified for the CP. File Type Offset Size Displays the parameter file type (values, constant), the location
(offset) and the byte length (size) of the configuration parameter Value (raw) Displays current value which can be changed. Write protected
Shows if the CP is allowed to be modified. This results form the manufacturer dependent settings of the configuration flags.
4. Enter the value in the Value (raw) field and click the Set button.
RESULT: The value is written to the node.
5. Click on the OK button.
For detailied information on LON terms, please refer to the "Self-Documentation Syntax and Data Representations" section in the "LonMark Application Layer Interoperability Guidelines".
Display/Change Configuration of XFL Module(s)
In the network tree XFL Modules are named as follows: Device XAI2_2_00: Node 521_03 (location string)
XFL521B
Procedure 1. Open configuration dialog for XFL521B as described in the "Configure Node" section. RESULT: The Honeywell XFL521 Analog Input dialog box displays.
Hardwareversion
Softwareversion
XFL module
Technical address (HEX switch adjustment)
Module type
Module type
EXCELON
EN2B-0210 GE51 R0405 56
The XFL521B analog input module contains 8 identical LonMark Open Loop Sensor Objects. Each Sensor Object can be configured as a voltage input (0..10 V), NTC20 or PT1000 temperature sensor input. For each Sensor Object, there are separate configuration properties for the transmission threshold and wire resistance correction. Each Sensor Object provides two output NVs, one for temperature and the other for voltage. If no temperature sensor was configured, the output NV temperature value is invalid.
Inputs Chan(nel) Sensor Configuration For each channel the current sensor value is displayed. The
Configuration column lists sensor types of the following: 0 – 10.000 mV with pullup-resistor 0 – 10.000 mV without pullup-resistor 0 – 10 V with pullup-resistor 0 – 10 V without pullup-resistor NTC20 PT1000 Not Configured Default values are adopted when pressing Service PIN longer than 3
sec. Modul Displays technical address and hardware and software version.
EXCELON
57 EN2B-0210 GE51 R0405
Timing MIN SEND TIME Defines the minimum period of time between output network variable
updates. Range: 1.0 – 10 sec. (default = 1) MAX SEND TIME Defines the maximum period of time before output network variables are
automatically updated. Range: MinSendTime – 6553 sec (default = 60) Default values are adopted when pressing Service PIN longer than 3
sec.
2. Change configuration parameter, if desired and confirm by clicking OK or Apply button.
XFL522B
Procedure 1. Open configuration dialog for XFL522B as described in the "Configure Node" section. RESULT: The Honeywell XFL522 Analog Output dialog box displays.
EXCELON
EN2B-0210 GE51 R0405 58
The XFL522B analog output module contains 8 identical LonMark Open Loop
Actuator Objects. Each Object can be configured as a 0..10 V output or a motor output. The motor model can be configured with a wide range of properties for use with any floating actuator. A manual override board can be plugged allowing the value commanded from the network to be overwritten. A feedback NV reflects the actual position of the actuator, whether in automatic or in manual operation.
Outputs Chan(nel) Value Man Feedback Mot Runtime Allows checking connected actuators in automatic and manual mode. In automatic mode, enter value into the Value field and press Apply
button. The Feedback field displays the corresponding feedback value in %. When using the manual override board, the Man(ual) box displays a blue hand and feedback values are updated according to the manual override adjustment.
To enter motor runtime for a floating actuator, check Mot checkbox and
enter value into the Runtime field. Runtime specifies the following: TIME TO CLOSE Actuator´s runtime to move from 100 % to 0 %. Range: 10 – 1000 sec (default = 90) and TIME TO OPEN Actuator´s runtime to move from 0 % to 100 %. Range: 10 – 1000 sec (default = 90) Default values are adopted when pressing Service PIN longer than 3
sec.
EXCELON
59 EN2B-0210 GE51 R0405
Module Displays technical address and hardware and software version.
2. Change configuration parameter, if desired and confirm by clicking OK or Apply
button.
XFL523B
Procedure 1. Open configuration dialog for XFL523B as described in the "Configure Node" section.
RESULT: The Honeywell XFL523 Digital Input dialog box displays.
The XFL523B digital input module contains 12 identical LonMark Open Loop Sensor Objects. Each Sensor Object can be configured as a binary or totalizer (counter) sensor input. The max. frequency for totalizers is 20 Hz. For each Sensor Object, there are separate configuration properties for the active direction of the LED. The active direction of the LED does not affect the NV content.
EXCELON
EN2B-0210 GE51 R0405 60
Channel 1-6 - Channel 7-12 LED Invert The result of the LED Mode setting (active direction) depends on the
DIP switch setting at the module, as the following describes:
LED Mode Input Signal level DIP Switch = ON ≤ 2.5V grey (OFF) Normal ≥ 5.0V yellow ≤ 2.5V yellow Invert ≥ 5.0V grey (OFF)
For normal mode, uncheck Invert checkbox. For Inverted mode, check Invert checkbox. Default values are adopted when pressing Service PIN longer than 3
sec. Value Counter Delta Specifies what difference in totalizer count value is required before a
transmission of the value of the sensor object output takes place. Range: 0 – 65535 (default = 0) Check Counter checkbox and enter delta value into the Delta field. In the Value field, the counts are displayed. Confirm by clicking OK or Apply button. Module
Displays technical address and hardware and software version. Timing MIN SEND TIME Defines the minimum period of time between output network variable
updates. Range: 1.0 – 10 sec. (default = 1) MAX SEND TIME Defines the maximum period of time before output network variables are
automatically updated. Range: MinSendTime – 6553 sec (default = 60)
EXCELON
61 EN2B-0210 GE51 R0405
Default values are adopted when pressing Service PIN longer than 3 sec.
2. Change configuration parameter, if desired and confirm by clicking OK or Apply
button.
XFL524B
Procedure 1. Open configuration dialog for XFL5234 as described in the "Configure Node" section.
RESULT: The Honeywell XFL524 Analog Input dialog box dialog displays.
The XFL524B digital output module contains 6 identical LonMark Open Loop Actuator Objects. Each Actuator Object drives a relay with changeover contact and a LED visualizing the state of the output. A manual override board can be plugged allowing the value commanded from the network to be overwritten. A feedback NV reflects the actual position of the actuator, whether in automatic or in manual operation.
Outputs Channel – Manual – Relays Allows to check connected control devices, e.g. pumps in automatic and
manual mode. In automatic mode, the relay trips (yellow display) when pressing the corresponding channel button. When using the manual override board, the Man(ual) box displays a blue hand and the relay status is indicated as in automatic mode.
Configuration Lists actuator types of the following: - Binary (default) - Unused Range: For the binary type the values coming from the input channel
can be as follows:
EXCELON
EN2B-0210 GE51 R0405 62
Default values are adopted when pressing the Service PIN longer than 3 sec. Module Displays technical address and hardware and software version.
2. Change configuration parameter, if desired and confirm by clicking OK or Apply button.
Clear Node Statistics Purpose To clear the statistic values of the node. Procedure 1. In the network tree, click on the node, which you want to clear statistics for.
2. Click right mouse key, and with left mouse key click on Clear Statistics.
RESULT: The statistics have been cleared as indicated on the Statistics tab in the Node Properties dialog box (see "Display Node Properties" section).
Set Node Online / Offline Purpose Nodes can be set online/offline. Setting nodes offline means that the device is
switched to a kind of "Standby mode". In this mode, the communication between the application and the neuron chip of the device is interrupted and the device sends no data on the bus. Setting devices offline is helpful, for example, in order to avoid interfering bus traffic when testing particular sections/devices of the network.
Procedure 1. In the network tree or in the Node pane, click on the node, which you want to set to ´Online or Offline`.
2. Click right mouse key, and with left mouse key click on Set Online or Set
Offline in the context menu.
RESULT: The node is set according to your selection.
Set Node Unconfigured Purpose To disable a node on the network and stop the application program.
EXCELON
63 EN2B-0210 GE51 R0405
Procedure 1. In the network tree or in the Node pane, click on the node, which you want to set to ´unconfigured`.
2. Click right mouse key, and with left mouse key click on Set Unconfigured in
the context menu.
RESULT: The node is set to ´unconfigured` indicated by the the blue ring in the network tree.
Wink Node The wink function can be used to identify a node visually (e.g., service LED is blinking) or audibly. NOTE: The device must support the wink command feature.
Procedure 1. In the network tree or in the Node pane, click on the node, which you want to
send a wink to.
2. Click right mouse key, and with left mouse key click on Wink in the context menu.
RESULT: A wink command will be sent to the selected node. The node can
be identified by its programmed wink function (visually or audibly).
Send Service Pin Procedure Select menu item Lon, then submenu item Send Service Pin.
RESULT: The service pin of the network interface will be sent to the network.
Reset Node Resetting a node means an application restart in the device.
Procedure 1. In the network tree or in the Node pane, click on the node, which you want to reset.
2. Click right mouse key, and with left mouse key click on Reset in the context
menu.
RESULT: The node is reset.
Re-read Node Nodes should be re-read if the domain table or the location string of a node has been modified, for example, when the HEX switch of an XFL module has been changed. Re-reading a node means to remove the node from the network tree and to reload it subsequently in case bindings had been changed.
Procedure 1. In the network tree, click on the node, which you want to re-read.
2. Click right mouse key, and with left mouse key click on Re-Read in the context
menu.
RESULT: The node will be removed from the network tree and reloaded.
Put Node into Diagnostic Putting nodes into diagnostic means to monitor the status and the communication situation of the nodes.
EXCELON
EN2B-0210 GE51 R0405 64
NOTE: The node diagnostic allows the analysis of the network traffic and
communication status of each individual node at its physical location. This can be very helpful for "communication tuning" if the network load is high.
Procedure 1. In the network tree, click on the node, which you want to put into diagnostic.
2. Click right mouse key, and with left mouse key click on Node Diagnostics in the context menu.
Or, in the network tree, select domain, channel, or host-based device of which
nodes you want to put in diagnostic. Drag it to the Node pane and drop it.
RESULT: The nodes are put into the Node pane. To poll a node, click on the
Polling box at the beginning. To poll all nodes, click on in the toolbar.
In the Node pane, the node statistic values/statuses are shown as follows: Bullets indicate the status of the node as follows: ● Green = Communication of the node is "OK". The node has less than 2 % errors ● Yellow = the node has 2% - 10 % errors (according to definable settings) ● Red = the node has more then 10% errors (according to definable settings) ● Red ring = software error is logged onto the neuron chip. ● Exclamation mark after Green bullet: a last error has occurred as indicated in the
last error column The limit of the values for indication can be varied by defining the default settings in the Excelon Settings dialog box (see "Define LON Default Settings" section). For each node the following parameters are shown: ● Name Subnet/node address or location string if issued ● Neuron Id
48-bit unique worldwide identifier of the node
● Channel Id. Channel Id
● Domain Domain Id
● S/N Subnet/Node Id
● Loc. String Location String
● Type Device type
EXCELON
65 EN2B-0210 GE51 R0405
● Total Msgs Total number of messages the node has "seen" on the network. and the average count/sec.
● CRC Err Percentage of all packets "seen" by the node that have a CRC (Cyclic Redundancy Check) error (also available under Communication Ratings on Statistics tab in Node Properties dialog box),
● Rx Msgs Number of messages the node has received and the average count/sec.
● Rx Error Percentage of received packets, that the node has lost (also available under Communication Ratings on Statistics tab in Node Properties dialog box).
● Tx Msgs Number of messages the node has sent and the average count/sec.
● Tx Error
Percentage of failed transmitted packets (also available under Communication Ratings on Statistics tab in Node Properties dialog box).
● Reset Cause for the reset (also available on Statistics tab in Node Properties dialog box)
● Last Error The software error code (number) and the description of the last software error that has been logged onto the neuron chip (also available on Statistics tab in Node Properties dialog box)
● Log time Timer that counts the time since the last statistics clear.
Sort Nodes in Node Pane
Nodes can be sorted ascending and descending according to their parameters by simply clicking on the respective column in the Node pane. NOTE: Nodes cannot be sorted by the longtime.
Enable Polling of Nodes
Procedure 1. To poll single node(s), click checkbox in the Name column of corresponding node. Or, highlight the node with left mouse key in the list. To highlight multiple nodes concurrently use CTRL, respectively SHIFT key. Click right mouse key and with left mouse key click on Refresh enable in the context menu.
2. To poll all nodes, click on in the toolbar.
Or, click right mouse key and with left mouse key click on Refresh enable all in the context menu.
Disable Polling of Nodes
Procedure 1. To disable polling of single node(s), click enabled checkbox in the Name column of corresponding node
EXCELON
EN2B-0210 GE51 R0405 66
Or, highlight the node with left mouse key in the list. To highlight multiple NVs concurrently use CTRL, respectively SHIFT key. Click right mouse key and with left mouse key click on Refresh disable.
2. To disable polling for all nodes which are currently polled, click on in the
toolbar.
Instant Refresh of Single Node
Purpose To show actual values of an node in the Node pane. Procedure 1. To refresh one single node, simply click on the node in the Node pane.
RESULT: The current values will be read and displayed. Note, that the node is not put into cyclic refresh.
Reload Values of All Nodes
Purpose To show actual values of all nodes displayed in the Node pane. Procedure 1. Activate Node pane by selecting a node.
2. Click on in the toolbar.
RESULT: The values of all nodes displayed in the Node pane, will be read and displayed. Note, that the nodes are not automatically put into cyclic refresh.
Highlight Node in Network Tree
Procedure 1. To highlight a node in the network tree, which is selected in the Node pane, do the following:
2. In the Node pane, click on the node. 3. Click right mouse key and with left mouse key, click on Hightlight Node in Tree
in the context menu.
RESULT: The node is highlighted in black in the network tree.
Remove Nodes from Node Pane
To view certain nodes, the number of nodes in the Node pane can be reduced by removing nodes. It is possible to highlight nodes to be removed or the other way round to remove nodes not being highlighted.
Procedure 1. In the Node pane, highlight the node with left mouse key. Concurrently press
CTRL, respectively SHIFT key to highlight further nodes.
2. To remove highlighted nodes, click right mouse key and with left mouse key, click on Remove selected in the context menu. Or,
To remove nodes not being highlighted, click right mouse key and with left,
mouse key click on Remove non-selected in the context menu.
RESULT: The desired nodes will be removed from the pane.
EXCELON
67 EN2B-0210 GE51 R0405
3. To remove all nodes displayed in the Node pane, click right mouse key and with left mouse key, click on Remove all in the context menu.
To remove all nodes from the Node pane, see also the "Clear List" section.
Further Functions
The following functions accessible in the context menu of the Node pane are also available in the context menu of the node in the network tree. In this regard, please refer to the corresponding previous sections: • Display Node Properties • Restart Node Measurement • Download Application • Browse NVs • Set Node Online / Offline • Set Node Unconfigured • Wink Node • Reset Node
DISPLAY NETWORK VARIABLES Network variables are displayed for monitoring both, explicitly selected nodes and
any bound network variables of which values have currently been changed. In the second case initially only output network variables are displayed. NOTE: To enable network variables display, the Watch bound NVo values
option in the Excelon Settings dialog box must be checked. Procedure 1. In the network tree, select the node. 2. Click right mouse key, and with left mouse key click Browse in the context
menu or double-click on node.
Or, in the network tree, select domain, channel, or host-based device which contain the nodes of which NVs you want to display.
Drag it to the NV pane and drop it.
RESULT: The respective network variables are displayed in the NV pane.
The network variables are displayed by the following symbols: SNVTs (on yellow background) nvi (green) nvo (red) SCPTs (on yellow background) nci (blue)
EXCELON
EN2B-0210 GE51 R0405 68
UNVTs (on grey background) nvi (green) nvo (red) UCPTs (on grey background) nci (blue) For each network variable (NV), the following values/statuses are listed:
• Poll/Index The box before the NV symbol displays the polling status of the NV. If the box is checked and repeatedly blinking, the NV will currently be polled. An upward button in the box indicates value changes. The number after the NV symbol shows the index number the NV has in the device. If an nvi cannot be read from LON, an exclamation mark is displayed in the box. To enable/disable polling a node, click on the Polling box before the NV symbol. If bound NVo updates have been received or if another network management tool has polled the NVi or NVo, a green arrow is displayed. To enable/disable polling all nodes, click on in the toolbar.
• Node
Node name consisting of location string and subnet ID/node ID. If no location string has been issued, the subnet ID/node ID is displayed.
• NV Name Name of the network variable
• Value Current value of the NV in decimal format including unit
• SNVT Network variable type
• LM-Obj The LonMark object that the NV belongs to.
• Self Doc Selfdocumentation string from XIF file which describes the node´s program and network variables.
• Size Byte size of the NV
• Bound Indicates whether the NV is bound or not, shows the internal NV selector if bound.
• Address <address table index>: <subnet>/<node ID>. Shows the address table entries, which give information about the node´s bindings to other nodes (unicast, multicast, broadcast).
• Service Service type: - Ack (Acknowledgement) - Ackd (Acknowledged) - Request - Response - Unackd (Unacknowledged) - Repeated (Rpt) - Unackd/Rpt (Unacknowledged/Repeated)
• Rate
NV updates per minute
EXCELON
69 EN2B-0210 GE51 R0405
• Raw Hex Current data value of the NV in HEX format.
2. For further information on NV parameters, view NV Details as described under
"View Details of Network Variable" section.
Sort Network Variables Procedure NVs can be sorted ascending and descending according to their parameters by
simply clicking on the respective column in the NV pane. NOTE: NVs cannot be sorted by: - Value - Address - Service - Raw hex value
Enable Polling of Network Variables Procedure 1. Display NVs as described in the "Display Network Variables" section. 2. To poll single or multiple NVs, click checkbox at the NV(s) in the Poll/Index
column. Or, highlight the NV with left mouse key in the list. To highlight multiple NVs concurrently use CTRL, respectively SHIFT key. Click right mouse key and with left mouse key click on Refresh enable in the context menu.
3. To poll all NVs, click on in the toolbar.
Or, click right mouse key and with left mouse key click on Refresh enable all in the context menu.
Disable Polling of Network Variables Procedure 1. To disable polling for single or multiple NVs, click the enabled checkbox at the
NV(s) in the Poll/Index column. Or, highlight the NV with left mouse key in the list. To highlight multiple NVs concurrently use CTRL, respectively SHIFT key. Click right mouse key and with left mouse key click on Refresh disable.
2. To disable polling for all NVs which are currently polled, click on in the
toolbar.
Watch NVs Purpose Watching NVs means, that Excelon watches the network in order to detect NVs that
send updates and NVs which are polled by a network analyzer tool other than Excelon (foreign NV fetches). All those kind of NVs are displayed in the NV pane.
By default, the options Watch bound NVo values and Watch foreign NV fetches
in the LON Default Settings dialog box are enabled (see "Define LON default Settings" section). Because these options are enabled, all updating and fetched NVs
EXCELON
EN2B-0210 GE51 R0405 70
are automatically displayed in the NV pane when starting to scan a network or after you have opened a project.
In order to distinguish between the display of relevant and non-relevant NV value updates and fetched NVs, you must delete those NVs in the NV pane, you want to exclude from watching. Any NV which is deleted in the NV pane, will no longer be displayed in the NV pane, until the Watch all NVs option will be enable; even if the Watch bound NVo values and Watch foreign NV fetches options are enabled For example, if you want to watch the behavior of a lighting application, you delete all NVs which are not relevant for the lighting application and keep the relevant NVs in the NV pane. All watched NVs are indicated as Watch this NV. If all NVs of the project are watched, a NV is also indicated as Watch all NVs (see procedure).
Prerequisites The node which contains the NVs must be available in the tree and you must be using a network interface in VNI mode.. The options Watch bound NVo values and Watch foreign NV fetches in the LON Default Settings dialog box must be enabled (see "Define LON default Settings" section).
NVs must be bound and must send updates..
Procedure 1. Go Online and scan the network, or open the project you want to analyze.
RESULT: In the NV pane, all relevant, that is updating and fetched NVs are displayed and indicated as "watched".
2. To view the "Watched" status of a NV, click on the NV and click right mouse
button..
RESULT: In the context menu, the Watch this NV and Watch all NVs options are checked.
EXCELON
71 EN2B-0210 GE51 R0405
3. To exclude particular, non-relevant NVs from watching, right-click on the NVs
(multiselection by using CRTL and SHIFT keys are possible). 4. In the context menu, click Remove selected, press Delete key.
RESULT: The NVs are deleted in the NV pane and will no longer be watched. All other NVs are still watched and those of them which send updates are put into the NV pane. When viewing the watched status of a NV, you will see that Watch all NVs is unchecked because at least one NV is excluded from watching.
5. If desired, you can exlude further NVs from watching by deleting them in the NV
pane. 6. If, at a certain point, you want to return to watching all NVs, do the following:
Delete all NVs in the NV pane.
EXCELON
EN2B-0210 GE51 R0405 72
Position cursor in the NV pane, click right mouse button and select Watch all NVs.
Instant Refresh of Single Network Variable Purpose To show actual NV value of an NV in the NV pane. Procedure 1. To refresh one single NV, simply click on the NV in the NV pane.
RESULT: The current NV value will be read and displayed. Note, that the NV is not put into cyclic refresh.
Reload Values of All NVs Purpose To show actual NV value of all NVs displayed in the NV pane. Procedure 1. Activate NV pane by selecting an NV.
2. Click on in the toolbar.
RESULT: The NV values of all NVs displayed in the NV pane, will be read and displayed. Note, that the NVs are not automatically put into cyclic refresh.
Find Associated Node of NV in Network tree Procedure 1. To find the node, which a NV belongs to, do the following: 2. In the NV pane, click on the NV. 3. Click right mouse key and with left mouse key, click on Hightlight Node in Tree
in the context menu.
RESULT: The node is highlighted in black in the network tree.
Find Bindings of NV Procedure 1. To find input NVs that are bound to an output NV displayed in the NV pane, do
the following: 2. In the NV pane, click on the output NV.
EXCELON
73 EN2B-0210 GE51 R0405
3. Click right mouse key and with left mouse key, click on Find Binding(s) in the context menu.
RESULT: All bound input NVs are added below the output NV selected.
NOTE: If there exist no bindings for the output NV, the following message is displayed.
Causes for missing bindings may be: - The partner device for this binding is not loaded in Excelon - Incorrect network engineering or corruption - orphaned device which had been engineered in another project
Update Network Variables Procedure 1. In the NV pane, do one of the following:
double-click on Input NV or, click on Input NV and press ENTER key or, click right mouse key and with left mouse key, click on Command Input NV in the context menu. RESULT: The NV Update dialog box displays showing NV name, NV type,
and currrent value as normal value with unit and as raw value in HEX format.
EXCELON
EN2B-0210 GE51 R0405 74
Values can be entered as "normal" value or as Raw value. The entered
values will be converted.
2. Enter value into the Value and the Raw fields, respectively.
3. Click Convert button (optional).
RESULT: The entered value will be converted. 4. If the value is sufficient, click NV Update ! button.
RESULT: The value is written to the NV and displayed in the NV list.
View Details of Network Variable Procedure 1. In the NV pane, click on the NV.
2. Click left mouse key and with right mouse key, click on NV Details in the
context menu.
RESULT: The NV Details:<NV name> dialog box is displayed showing the following information:
EXCELON
75 EN2B-0210 GE51 R0405
NV Self-documentation Self documentation string of the NV. Average Rate Estimate Estimated sustained message rate, in tenths of messages per second, that the
associated message tag is expected to transmit. Measure of "talkativeness" of the NV.
Maximum Rate Estimate Estimated maximum message rate, in tenths of messages per second, that the
associated message tag is expected to transmit. Measure of "talkativeness" of the NV.
Offline Whether an NV can only be changed in Offline mode or not. Polled The value of the output NV is to be sent only in response to a poll request from
a device that reads this network variable. Sync All Updates to the output NV will be propagated, and in their original order. Binding For information on the following options, please refer to the "Display Network
Variables" section:
Selector ID Service Type Assigned Address Table Entry Update rate
Bound Shows whether the NV is bound to another NV or not. Priority Shows whether the priority of the NV has been modified by a LONWORKS
network management tool or not. Authenticated Shows whether the authentication of the NV has been modified by a LONWORKS
network management tool or not. Turnaround Shows whether the NV has a turnaround binding or not, that is, whether it is
bound to another NV of the same node or not. Has Alias Shows whether an alias has been created for the NV or not. 3. Click the OK button to close the dialog box.
Remove Network Variables from NV Pane To view certain NVs, the NV list can be reduced by removing NVs. It is possible to highlight NVs to be removed or the other way round to remove NVs not being highlighted. In addition NVs of a particular node or all NVs can be removed.
Procedure 1. In the NV pane, highlight the NV with left mouse key. Concurrently press CTRL, respectively SHIFT key to highlight further NVs.
2. To remove highlighted NVs, click right mouse key and with left mouse key, click
on Remove selected in the context menu. Or,
EXCELON
EN2B-0210 GE51 R0405 76
To remove NVs not being highlighted, click right mouse key and with left,
mouse key click on Remove non-selected in the context menu.
RESULT: The desired NVs will be removed from the list. 3. To remove all NVs of a particular node, click right mouse key and with left
mouse key, click on Remove all of this node in the context menu. Or,
4. To remove all NVs displayed in the NV pane, click right mouse key and with left
mouse key, click on Remove all in the context menu.
To remove all NVs from the NV pane, see also the "Clear List" section.
COMMON PANE FUNCTIONS
Clear List
All items (NVs, nodes, or packets) can be removed from their pane in one step. Procedure 1. To remove all items from its pane, select an item in the corresponding pane
(NV, Node, or Protocol pane).
2. Click on in the toolbar or select menu item View, then submenu item Clear List. RESULT: All items will be removed from the corresponding pane.
Hide Columns of Pane
Procedure 1. To hide columns of a pane (NV, Node, or Protocol pane), select an item in the
pane and click on in the toolbar. RESULT: A certain number of columns dependent on the pane will still be
displayed.
Redisplay Hidden Columns of Pane
Procedure 1. To redisplay previoulsy hidden columns, select an item in the corresponding
pane and click on in the toolbar.
RESULT: All columns are displayed.
Cyclically Refresh Pane Purpose To continuously show updated values. Procedure 1. To cyclically (continuously) refresh the values of items (nodes, NVs, packets)
select an item in the corresponding pane (NV, Node, or Protocol pane).
EXCELON
77 EN2B-0210 GE51 R0405
2. Do one of the following: Click right mouse key and with left mouse key, click Cyclic Refresh in the context menu. Or, click on in the toolbar RESULT: The pane will be continuously refreshed according to the refresh
interval settings in the Excelon Settings dialog box (see "Define LON Default Settings" section).
LONTALK PROTOCOL ANALYZER AND VNI MODE When using Echelon PCC / PCLTA cards in VNI driver mode, a virtual network interface (VNI) is supported that allows Monitoring of the LonWorks network without creating any traffic. IMPORTANT
Polling NVs or nodes with Excelon and in with any other Monitoring tool causes network traffic.
Status Bar In Excelon, the current status and resulting packet counts are displayed in the status
bar as follows:
● Current status (offline or online) of the network interface ● Total packet count ● Actual packet count/sec ● Average packet count/sec
LonTalk Protocol Analyzer Based on the VNI mode, Excelon´s integrated LonTalk Protocol Analyzer provides
additional information and details for analyzing network traffic in the Protocol pane. NOTE: To enable the LonTalk Protocol Analyzer the "VNI-setting" of the network
interface is required (only applicable if Excelon is licensed).
IMPORTANT The LonTalk Protocol Analyzer is always active and will record all packets even if they are not shown in the protocol pane.
Protocol Pane In the Protocol pane, the LonTalk Protocol Analyzer shows detailed information of
the packets being sent over the network:
Actions displayed in the protocol pane typically include:
requests
responses
NV updates For each action, the following parameters are shown:
EXCELON
EN2B-0210 GE51 R0405 78
● Packet
Number of packet ● Time
Timestamp, when the packet has been sent ● Domain
Domain ID ● Tag
Message tag ● Attribute
Flag: priority (P), authenticated (#,) or alternate path (A) ● From
Sender ● To
Receiver ● Service
Service type ● Message
Generic message ● Data
HEX value or NV value The protocol pane gets active by clicking inside the pane. Then all actions that already have occurred on the network are shown immediately. NOTE: The packet counts displayed in the Protocol pane and in the status bar
may differ more or less, since Excelon starts monitoring immediately after it is invoked and displays the results in the status bar whereas the detailed and visible results of the LonTalk protocol analyzer are displayed in the protocol pane firstly after explicit activation.
Start LonTalk Protocol Analyzer NOTE: Once Excelon is started respectively running all traffic is logged into the
.LON file. Procedure 1. Click into the empty protocol pane. All messages/actions already occurred on
the network are displayed.
2. To cyclically refresh the messages/actions, do one of the following: Click right mouse key and with left mouse key, click Cyclic Refresh in the context menu. Or, click on in the toolbar Or, press END key.
RESULT: The protocol pane will be continuously refreshed according to the
refresh interval settings in the Excelon Settings dialog box (see "Define LON Default Settings" section).
View Packet Details Procedure 1. In the protocol pane, double-click on the packet of which you want to view
details. Alternatively, click on the NV with left mouse key. Then click right mouse key and with left mouse key, click on View Packet Details in the context menu. RESULT: The LonTalk Packet Details dialog box displays.
EXCELON
79 EN2B-0210 GE51 R0405
General Packet Information Packet No Number of the packet. Packets are numbered ascending dependent on
the time when they were sent. Time stamp Time when the packet was sent Packet Size Size of the packet in bytes Data Size Size of the datablock in bytes TxNo Number of the Tx error CRC HEX code of the CRC error. The CRC is a 16-bit error-check number
added to the end of every packet. Service Service type: ack, ackd, repeated, etc. Flags Priority
EXCELON
EN2B-0210 GE51 R0405 80
Packet was sent with ´Priority` enabled or not. Displayed as ´P` in the Attr column.
Authenticated Packet was sent with ´Authentication` enabled or not. Displayed as ´#` in
the Attr column.
Alternate path Packet was sent with ´Alternate path` bit set. Displayed as ´A` in the Attr
column. Address and Message Information Domain Domain ID
Source Address of the sending source node
Destination Address of the receiving destination node
Message Extented Message text including NV names
Raw Header Raw Header block in HEX format Data Data block in HEX format NV Update Extented information for NV updates: sending and receiving node including NV
names, NV selector, and NV value with NV type. 2. To scroll through the packet list, click on the forward and backward
arrow buttons respectively. 3. To close the dialog box, click on OK button.
Scan this Domain Every message displayed in the protocol pane shows the domain (ID) on which the message has been sent. If this message is of interest, it may be a starting point of network analysis by scanning that domain.
Procedure 1. In the protocol pane, click on the message of which you want to scan the
corresponding domain. 2. Click right mouse key and with left mouse key, click on Scan this domain in the
context menu.
RESULT: Excelon scans the domain, indicated by the pressed icon in the toolbar. Detected nodes will be uploaded and added to the network tree.
Switch to this Domain Every message displayed in the protocol pane shows the domain (ID) on which the message has been sent. If this message is of interest, it may be a starting point of network analysis by switching to that domain.
Procedure 1. In the protocol pane, click on the message of which you want to scan the
corresponding domain.
EXCELON
81 EN2B-0210 GE51 R0405
2. Click right mouse key and with left mouse key, click on Switch to this domain in the context menu. RESULT: Excelon highlights the domain (bold) in the network tree.
IMPORTANT
The domain, which had been switched to, is now the active domain (indicated in bold). When searching for nodes on the network via the Search for Lon Nodes command only nodes residing on the active domain will be loaded, except if the Search nodes also on zero-domain option in the Excelon Settings dialog box is enabled. In this case, nodes residing on the zero-domain will be loaded additionally. The loaded nodes will be arranged under the corresponding domain entries in the network tree.
Find Destination Node in Network tree Procedure 1. To find the destination node in the network tree, which receives the packet, do
the following: 2. In the Protocol pane, click on the packet. 3. Click right mouse key and with left mouse key, click on Hightlight Destination
Node in the context menu.
RESULT: The destination node is highlighted in black in the network tree.
Find Source Node in Network tree Procedure 1. To find the source node in the network tree, which has sent the packet, do the
following: 2. In the Protocol pane, click on the packet. 3. Click right mouse key and with left mouse key, click on Highlight Source Node
in the context menu.
RESULT: The source node is highlighted in black in the network tree.
Highlight NV(s) To highlight the NV in the NV pane that has sent a message as displayed in the Protocol pane, do the following:
Procedure 1. In the Protocol pane, click on the NV message. 2. Click right mouse key and with left mouse key, click on Highlight NV(s) in the
context menu.
RESULT: The NV is highlighted in the NV pane where it can be monitored for getting more information (see "Display Network Variables section").
EXCELON
EN2B-0210 GE51 R0405 82
Set Filters For most of the packet items a filter can be applied by simply clicking on the column title. Examples: Clicking on the Message column title displays the following Packet Filter dialog box.
Clicking on the Service column title displays the following Packet Filter dialog box (see above).
EXCELON
83 EN2B-0210 GE51 R0405
NOTE: A filter can be set as follows: Example: Packet Filter dialog box for Service You can build a filter by using three criteria: Included = the option selected as ´included` is indicated by a green checkmark and will be displayed in the Protocol pane. Excluded = the option selected as ´excluded` is indicated by a red cross and will not be displayed in the Protocol pane. Unselected = the opposite status of the selected option either ´included` or ´excluded`. Defaults to ´included`. The Reset Filter icon sets all options to ´unselected` with default ´included`. A filter criterion can be applied to an option by repeatedly clicking on the box before the option. That toggles between ´Included´, ´Excluded´ and ´Unselected` status for the option. NOTE: All messages are logged into the .LON file, even if a filter is active.
Procedure(s) Clicking, for example, on the (unselected) Ackd checkbox will put all ´Acknowledged` messages into the filter, indicated by the green checkmark.
EXCELON
EN2B-0210 GE51 R0405 84
RESULT: In this case only ´Acknowledged` service messages will be displayed in the protocol pane.
Note, that all unselected messages are automatically set to
´Exclude` in the drop-down list box, that is, they will not be displayed.
Clicking twice on the checked Ackd checkbox will exclude all Ackd messages from the filter, indicated by the red cross.
RESULT: In this case all service messages as displayed in the list, except ´Acknowledged` messages will be displayed in the Protocol pane.
Note, that all unselected messages are automatically set to
´Include` in the drop-down list box, that is, they will be displayed. NOTE: Especially in large lists, the automatic setting of the unselected options of
the opposite allows comfortably filtering only a small number of options to be displayed or not to be displayed.
Clicking on the Include all icon , will include all options from the filter.
RESULT: In this case, all service messages will be displayed in the protocol pane. These settings have the same effect as a filter
EXCELON
85 EN2B-0210 GE51 R0405
reset. Certain options can be excluded, that is. not displayed, by toggling the corresponding checkbox.
Clicking on the Exclude all icon , will exclude all options from the filter.
RESULT: In this case, no service messages will be displayed in the protocol pane. Certain options can be included, that is, displayed, by toggling the corresponding checkbox.
Reset Filter Clicking on the Reset Filter icon , will exclude all options from the filter.
Activate Filter To activate the filter, click OK button.
Protocol Pane Display An applied filter is indicated in the Protocol pane by an asterisk in the corresponding column title.
Remove all Filters
Procedure 1. To remove all active filters from the Protocol pane, activate the protocol pane by highlighting a packet.
2. Click right mouse key and with left mouse key, click on Remove all Filters in
the context menu. RESULT: All filters are removed indicated by the disappeared asterisks.
EXCELON
EN2B-0210 GE51 R0405 86
Show Latest Packets
Procedure 1. To show the latest packets in the Protocol pane if cyclic refresh is disabled, activate the Protocol pane by highlighting a packet.
2. Click right mouse key and with left mouse key, click on Show latest packets in
the context menu. RESULT: The latest packets are displayed at the end of the list.
Clear Protocol To remove all packets from the Protocol pane.
Procedure 1. To remove all packets from the Protocol pane, activate the protocol pane by
highlighting a packet.
2. Click on in the toolbar. Or, click menu item View, then submenu item Clear List.
Or, click right mouse key and with left mouse key, click on Clear Protocol in the context menu. RESULT: All packets will be removed from the Protocol pane.
AUTOMATIC NETWORK DIAGNOSTIC Excelon provides an automatic network diagnostic function per mouse-click that includes the following steps:
1. Scan the network and upload detected nodes 2. Add nodes to the Node pane 3. Clear statistics of the nodes and set them in cyclic refresh 4. Put updating NVs in the NV pane
By using this automatic network diagnostic function, you are able to record all relevant network parameters over a certain time period and, if desired, save it in a file. The recorded file (record) can be sent to Honeywell to give support in case of serious network problems. Of course all of the above steps can be done manually and separately.
Procedure 1. Click on in the toolbar.
RESULT: The Automatic network diagnostics starts.
EXCELON
87 EN2B-0210 GE51 R0405
2. To stop the automatic network diagnostics after a sufficient time period, click on
pressed in the toolbar. 3. To save the record in Excelon file format .LON, click menu item File, then
submenu item Save.
RESULT: The Save As dialog box displays.
4. Enter a file name and click Save button.
EXCELON
EN2B-0210 GE51 R0405 88
If necessary, the recorded file can be sent to Honeywell for analysis. The record can be opened with any Excelon software equal or higher than the Excelon version used for recording.
Open Diagnostic Record NOTE: To open a record, the user has not to be Online necessarily. Opening a
record is also possible in Offline state and without an installed network interface.
Procedure 1. Click menu item File, then submenu item Open,
Or,
click on in the toolbar.
RESULT: The Open dialog box displays.
2. Select desired .lon file and click on Save button.
RESULT: The "frozen" status of the network is displayed.
EXCELON
89 EN2B-0210 GE51 R0405
All Excelon functions are available on principle. Of course, values and statuses may have changed in the meantime, or nodes may not be accessible anymore due to hardware changes on the network, etc.
CHECK PROJECT Purpose Checks the project regarding the following subjects:
• Duplicate device addresses • Broken connections • Devices with high error rates • Devices with high traffic load • NVs with high traffic load
The result will be displayed in HTML format.
Procedure 1. Click on menu item Lon, then submenu item Check Project.
RESULT: The Check Project dialog box displays.
EXCELON
EN2B-0210 GE51 R0405 90
2. Check subjects you want to be checked. 3. If desired, change values of the subjects Devices with high traffic load and/or
NV´s with high traffic load in the corresponding fields. 4. Click the Check button.
RESULT: The result is displayed in HTML format in the Excelon Project Report.
EXPORT FUNCTIONS
Export Analyzer Packets of Project Purpose Exports all analyzer packets of the project at that time into an ASCII file which can
be used for import into MS-Excel. This command is recommended if the general log file option Log Analyzer Packets file (see "Define LON Default Settings" section) is not enabled.
Procedure 1. Click on menu item File, then submenu item Export Analyzer Packets of Project.
RESULT: The Save As dialog box displays.
2. Browse to the destination folder, where you want to save the log file and enter a
file name in the File name field. 3. Click the Save button.
RESULT: The packets are saved in the log file and can be imported into MS-Excel (properties are tab-separated).
EXCELON
91 EN2B-0210 GE51 R0405
Export NVs of Project Purpose Allows selecting NVs of which values have changed for export to MS-Excel. This
command is recommended if the general log file option Log NV value changes to file (see "Define LON Default Settings" section) is not enabled. By using this command, all NVs of the project at that time will be used as basic input for selection. In Excel you can use the data for trending and creating charts.
Procedure 1. Click on menu item File, then submenu item Export NVs of Project.
RESULT: The Excelon Logfile Conversion Utility dialog box displays.
In the Input Excelon NV Logfile field, the source file with path is shown that includes all project NVs. All NVs (use scroll arrows and
EXCELON
EN2B-0210 GE51 R0405 92
scroll bar) are displayed in the underpart of the dialog box and can be selected for export to MS-Excel.
2. If desired, you can choose another file as input source by clicking the >> button
and selecting it in the Open dialog box. 3. In the Output NV Logfile field, click the >> button, choose a destination folder
in the Save As dialog box, and enter a name for the output file (.csv) in the File name field.
4. Under Filter Selection you can apply a filter to customize the display for
showing particular NVs. Do one of the following:
Define a time range, by checking Start Time and End Time checkboxes and setting dates and times. In the list, only NVs covered by the set time range are displayed.
And/Or, enter a string in the Filter field for searching for particular NV names. * matches everything, ? matches any character. In the list, only NVs founding through this search string are displayed.
And/Or, From the drop-down listbox right to the Filter field, select the item of which NVs should be displayed under: Program Displays all NVs of the program which match the search string entered in the Filter field.Node
Node Displays all NVs of the node which match the search string entered in the Filter field.
NV
Displays all NVs which match the search string entered in the Filter field. 5. Click the Apply button to update NV display in the underpart dialog box. 6. Under Output Options you can select options for customizing the data display
in the .csv file. Do the following:
From the Header drop-down listbox, select the header.
From the Date/Time format drop-down listbox, select the date and time format.
From the Decimal separator drop-down listbox, select the separator.
From the Column delimiter drop-down listbox, select the delimiter. The decimal separator and column delimiter settings are set in order to convert the csv. file properly for MS-Excel import. Please consider country-specific conventions for column delimiting and numbers display in MS-Excel. You may need to try different settings until MS-Excel shows the desired result.
7. In the underpart dialog box, select the NVs you want to export to MS-Excel as follows: For the NV, you want to select, click in the column before the Program column.
EXCELON
93 EN2B-0210 GE51 R0405
The selected NV is indicated by green checkbar. Or, to select all NVs, click the Select all button. Or, to deselect already selected NVs, click the Clear all button. Multi-selection by using SHIFT, respectively CTRL key is possible.
8. Click the Convert button and then the MS-Excel button.
RESULT: MS-Excel ís invoked and shows the converted NV data in a .csv file.
9. Shift to the Excelon Logfile Conversion Utility dialog box and click the OK
button.
Export all NVs of Log File Purpose Allows selecting NVs of which values have changed for export to MS-Excel. This
command is recommended if the general log file option Log NV value changes to file (see "Define LON Default Settings" section) has been enabled and a log file was generated automatically. By using this command, all NVs of that particular log file will be used as basic input for selection. In Excel you can use the data for trending and creating charts.
Procedure 1. Click on menu item File, then submenu item Export all NVs of Logfile. 2. Procede with steps 2 to 9 as described in the "Export NVs of Project" section.
EXCELON
EN2B-0210 GE51 R0405 94
NEURON CHIP SOFTWARE ERROR CODES Network diagnostic messages Query Status (Request/Response Only) This message retrieves the network error statistics accumulators, the cause of the last reset, the state of the node, and the last runtime error logged. This message is used after a node has been reset to verify that the reset has occurred, since resets are not acknowledged. no_error = 0 downlink_mip_transfer_lost = 126 bad_event = 129* nv_length_mismatch = 130 nv_msg_too_short = 131 eeprom_write_fail = 132 bad_address_type = 133 preemption_mode_timeout = 134 already_preempted = 135 sync_nv_update_lost = 136* invalid_resp_alloc = 137* invalid_domain = 138 read_past_end_of_msg = 139* write_past_end_of_msg = 140* invalid_addr_table_index = 141 incomplete_msg = 142* nv_update_on_output_nv = 143 no_msg_avail = 144* illegal_send = 145* unknown_PDU = 146* invalid_nv_index = 147* divide_by_zero = 148 invalid_appl_error = 149 memory_alloc_failure = 150* write_past_end_of_net_buffer = 151* appl_cs_error = 152 cnfg_cs_error = 153 invalid_xcvr_reg_addr = 154* xcvr_reg_timeout = 155* write_past_end_of_appl_buffer = 156 io_ready = 157* self_test_failed = 158 subnet_router = 159 Authentication_mismatch = 160 self_inst_semaphore_set = 161 read_write_semaphore_set = 162 appl_signature_bad = 163 router_firmware_version_mismatch = 164 EEPROM recovery occured = 166 Triac clockedge + - not supported = 167 Checksum error over system image = 168 State Byte semaphore = 192-223
All of these system errors are logged by the Neuron Chip firmware. Certain run-time errors are checked only in the development environment. These errors are marked by an asterisk (*) in the following list.
126 downlink_mip_transfer_lost This error indicates that a node running the "Microprocessor Interface Program"
(MIP) failed to send one or more LonTalk packets on the network. 129 bad_event*
The error could occur if the network configuration is invalid, if the network management tool is malfunctioning or the Neuron Chip firmware image is corrupted. If this error occurs, try reloading the node.
130 nv_length_mismatch
EXCELON
95 EN2B-0210 GE51 R0405
The length of the data in a network variable update message is inconsistent with the length expected by the node. Rebuild and reload the images. The error may occur rarely, due to network transmission problems.
131 nv_msg_too_short
This message could occur if a network message is corrupted. The error may occur rarely, due to network transmission problems.
132 eeprom_write_fail
This error occurs if too many erase/write cycles have been performed on the EEPROM or flash memory. Up to 10000 erase/write cycles per byte can be performed in the on_chip EEPROM. This error will also be logged if an EEPROM write is attempted when a node is online and has EEPROM locking enabled. The error may occur rarely due to Neuron Chip, transceiver or application failure.
133 bad_address_type
The error could occur if the network configuration is invalid, if the network management tool is malfunctioning or the Neuron Chip firmware image is corrupted. If this error occurs, try reloading the node.
134 preemption_mode_timeout
The program ran out of buffers and the system gave up trying to get them. Increase the node timeout if this message occurs often. This error causes a reset.
135 already_preempted
If a program is already in preemption mode and tries to initiate another message, this error is generated. This error causes a Neuron Chip reset.
136 sync_nv_update_lost*
A synchronous network variable update was lost because the node was already in preemption mode.
137 invalid_resp_alloc*
This error occurs if an application program tries to allocate (build) a response when it has not received a request.
138 invalid_domain
The error could occur if the network configuration is invalid, if the network management tool is malfunctioning or the Neuron Chip firmware image is corrupted. If this error occurs, try reloading the node.
139 read_past_end_of_msg*
This error occurs if an application program tried to read beyond the specified length of the message.
140 write_past_end_of_msg*
This error occurs if an application program tried to write past the specified end of the message.
141 invalid_addr_table_index
The error could occur if the network configuration is invalid, if the network management tool is malfunctioning or the Neuron Chip firmware image is corrupted. If this error occurs, try reloading the node.
142 incomplete_msg
This error occurs if an application program tries to send a message without first setting the code or data fields of the msg_out structure.
143 nv_update_on_output_nv
Another node tried to update an output network variable. The error may occur rarely, due to network transmission problems.
144 no_msg_avail*
This error occurs if an application program tries to reference the msg_in message object when no msg_arrives event has occurred.
145 illegal_send*
EXCELON
EN2B-0210 GE51 R0405 96
This error occurs if an application program tries to send a response or a message without first building one.
146 unknown_PDU
This error could occur if a packed was corrupted on the network, but the CRC was valid. The error may occur rarely, due to network transmission problems. „Often caused by GATEWAYS“
147 invalid_nv_index*
The error could occur if the network configuration is invalid, if the network management tool is malfunctioning or the Neuron Chip firmware image is corrupted. If this error occurs, try reloading the node.
148 divide_by_zero
The application program executed a division by zero. This error is not reported by the floating point or 32-bit extended arithmetic library functions.
149 invalid_appl_error
This error occurs if an application program tries to log an application error with an error out of range. The legal range is 1 to 127.
150 memory_alloc_failure*
This error occurs if there is not enough RAM availablefor the functions specified in the program. The error could occur if the network configuration is invalid, if the network management tool is malfunctioning or the Neuron Chip firmware image is corrupted. If this error occurs, try reloading the node.
151 write_past_end_of_net_buffer*
The outgoing application message could not fit into the outgoing network buffer. The maximum length is 255 bytes.
152 appl_cs_error
Checksum error over application program. The error may occur rarely due to Neuron Chip, transceiver or application failure
153 cnfg_cs_error
Checksum error over configuration data. The Neuron Chip retains a checksum of the application program and of the configuration data. If it is not the correct value, an error is logged, and the node goes into a blank or unconfigured state. This is usually a hardware problem, although it could be caused by the application writing over itself. See the section Defining Reboot and Integrity Options in Chapter 7 of the LonBuilder User’s Guide for a discussion of checksums and other integrity features. The error may occur rarely due to Neuron Chip, transceiver or application failure
154 invalid_xcvr_reg_addr*
Transceiver register address out of range. The valid range for the transceiver status information is 1 through 7.
155 xcvr_reg_timeout*
Transceiver register operation timeout occurred. A transceiver hardware failure occurred and the transceiver could not be configured. The error may occur rarely due to Neuron Chip, transceiver or application failure
156 write_past_end_of_appl_buffer
Application buffer too small. A message was received into a network buffer but it could not fit into an application buffer. May need to increase the buffer size with the #pragma app_buf_in_size drective. (see Chapter 6 of the Neuron C Programmer’s Guide)
157 io_ready*
io_in or io_out not ready. io_in () or io_out () invoked for a parallel I/O object when not in proper state for input or output, respectively.
158 self_test_failed
EXCELON
97 EN2B-0210 GE51 R0405
The Neuron failed its self-test. The self-test includes tests of RAM and internal timer and counter logic. The error may occur rarely due to Neuron Chip, transceiver or application failure
159 subnet_router
Subnet partition detected. Logged in a Router when a subnet is detected on both sides of that Router. This error only occurs on learning Routers. The error could occur if the network configuration is invalid, if the network management tool is malfunctioning or the Neuron Chip firmware image is corrupted. If this error occurs, try reloading the node.
160 authentication_mismatch
A network variable message or network management was rejected because of an authentication failure. Could be due to an authentication key mismatch or a lack of an authentication indicator in the original message. This error could indicate attempts of an intruder to „break in“ to the network. The error could occur if the network configuration is invalid, if the network management tool is malfunctioning or the Neuron Chip firmware image is corrupted. If this error occurs, try reloading the node.
161 self_inst_semaphore_set
Can appear during invocation of self-installation functions. The error is logged temporarily in the error log and should not be construed as error.
162 read_write_semaphore_set
Can appear during reload of an application. The error is logged temporarily in the error log and should not be construed as error.
163 appl_signature_bad
This error occurs if the application code in ROM is inconsistent with the code in EEPROM. This is most likely due to an attempt to load a new application over the network without first reprogramming the EEPROM.
164 router_firmware_version_mismatch
This error occurs when one attempts to connect two Router halves different software versions. This is a Router only error.
166 EEPROM recovery occurred
This error is logged when the on-chip EEPROM is reloaded following a system error as defined by the EEPROM reboot word. The error may occur rarely due to Neuron Chip, transceiver or application failure
167 Triac clockedge + - not supported
This error is logged when an application using the triac clockedge plus/minus feature is loaded into a 3150 Weich does not support this feature.
168 Checksum error over system image
This error is logged when the node goes applicationless following a checksum error in the system image. The error may occur rarely due to Neuron Chip, transceiver or application failure
192-223 State byte semaphore
This error message appears when a nodes state byte is being modified. The error is logged temporarily in the error log and should not be construed as error.
EXCELON
EN2B-0210 GE51 R0405 98
GLOSSARY A Address A unique identifier that identifies the source and destination node (or nodes) of a LonTalk packet. Address Table A table on a Neuron Chip that defines the groups to which the LonWorks Device belongs and the destinations to which it sends bound network variables and explicit messages. The contents of the address table are filled in by the NSS when it creates connections. Addressing Mode Neuron ID Only supports one-to-one transactions (i.e. no groups) and would require excessively large routing tables to optimize network traffic. Primarily used during installation and configuration, since it allows communications before they have been assigned an address. Alias A network variable alias is a "transparent-to-the-user copy" of a network variable. This alias has the same value as its primary network variable, but a different selector, allowing you to create connections that would not have been possible otherwise.
Node 2Node 1
nvo1' nvi1
nvi2nvo1
nvi1'nvo1
nvi1nvo1
nvi1
Aliases have their own selector value, can have their own address table entry, a network variable update is sent for each alias. Alternate Path The alternate path attribute is a hint to special purpose mode transceivers to try another path (e.g., different frequency, encoding, etc.) to get to the target node(s). It may or may not have any actual effect on the transmission of the packet. The alternate path attribute is set on the last two attempts of an acknowledged or request/response transaction. APB File Application Binary File Downloadable Image File (.APB and .NXE) A file produced by the LonBuilder and NodeBuilder tools that contains the portion of the application image that can be downloaded over the network. This is all the code
EXCELON
99 EN2B-0210 GE51 R0405
and data that resides in on- or off-chip writeable, non-volatile memory (EEPROM, flash, or NVRAM). The ASCII text version of this file (extension .NXE) is used by LonManager API-compatible tools such as the LonMaker Installation Tool. The binary version of this file (extension .APB) is used by tools based on the NSS-10 Module, such as the Nod-eBuilder tool, to load a device's application in a prototype or production network. Applicationless Device A device state where the device has no application image. Program or hardware failure may also cause a device to become applicationless. App buffer in Size and number of buffers between network and application processors for incoming application messages and network variables. App buffer out Size and number of non-priority and priority buffers between application and network processors for outgoing messages and network variables. App buff out priority Number of priority application buffers. Attributes The states of several LonTalk packet attributes: Priority Packet was sent with priority enabled Authenticated Packet was sent with authentication enabled Idempotent Response packet contains data Alternate Path Packet was sent with the alternate path bit set Authentication (Key) / Authenticated A service provided by the LonTalk protocol to verify that the sender of a message is authorized to send the message. A request message sent with Authenticated service is followed by a Challenge and a Reply message prior to the final response. Average Rate Estimate Estimated sustained message rate, in tenths of messages per second, that the associated message tag is expected to transmit. Measure of "talkativeness" of the NV.
B Backlog The backlog represents the number of nodes with a packet to send during the next packet cycle. Binder Any tool that does binding. Binding The process that defines connections between LonWorks Devices. Connections define the data that devices share with one another. Broadcast Broadcasting sends a message to everyone on the network whereas multicasting sends a message to a select list of recipients.
C Channel A channel is a physical transport medium for packets. Every LonWorks node is physically connected to a channel. A LonWorks network is composed of one or more channels. Media can be: twisted pair, powerline, radio frequency (RF), coaxial cable, infrared, and fiber optic.
EXCELON
EN2B-0210 GE51 R0405 100
Channel ID Number of the channel issued by the network management tool. Collisions The situation that occurs when two or more devices attempt to send a signal along the same channel at the same time. The result of a collision is generally a garbled message. Configured Device A device state where the device has both an application image and a network image. This indicates that the device is ready for network operation. Constant Configuration flag of a CP, which specifies that the configuration property can never be changed by a network tool. However, network tools may write such configuration properties when they reside in a writeable value file as long as the value is not changed. A network tool may do this as part of an update to another configuration property adjacent to the constant value. Configuration properties with the Constant flag but without the Device-Specific flag can be assumed to have the same value on all devices using the same standard program ID. CRC (Cyclic Redundancy Check) Error The CRC is a 16-bit error-check number added to the end of every packet. A CRC error indicates that some of the bits detected on the network have been corrupted. CRC errors can occur due to collisions or noise on the network. If they occur frequently they may indicate a hardware transceiver malfunction or an improperly designed network (e.g. improper loading, termination, etc.). A CRC error is logged by a neuron Chip whenever it detects a CRC (Cyclic Redundancy Check) mismatch in the incoming packet.
D Dev.specific Configuration flag of a CP, which specifies that the configuration must always be read from the device instead of relying upon the value in the device interface file or a value stored in a network database. Network tools must never change this property’s value except as a side effect of a new program download. This is used for configuration properties that must be exclusively managed by the device, such as a setpoint that is updated by a local operator interface on the device. This flag is not used for configuration properties that are updated both by the device application as well as by network tools. Such configuration properties must provide an alternate means to determine which copy of the configuration property (the device copy or the network database copy) is current, or an alternate means to keep both copies synchronized. Domain A domain is a logical collection of nodes on one or more channels. Domain ID Identifier for the domain. The domain ID may be configured as 0, 1, 3, or 6 bytes. Six-byte domain IDs can be used to ensure that the domain ID is unique. For example, using the 48-bit neuron ID of one of the neuron chips in the domain as the domain ensures that no other network can have the same domain id, since all neuron IDs are unique. However, six-byte domain IDs add six bytes of overhead to every packet. Using a shorter domain ID may reduce the overhead. In systems where there is no possibility of interference between multiple networks, the domain ID may be configured as zero bytes. For example, LonWorks applications using twisted-pair channels may be configured with zero-byte domains if only one application will be using the pair channels. Domain IDs may be configured as 1 or 3 bytes in systems where a single administrator controls assignment of domain IDs to prevent duplicate IDs. A domain ID can also be used for application-level purposes. For example, a domain ID could be used by service personnel as a system identifier.
EXCELON
101 EN2B-0210 GE51 R0405
E EEPROM Acronym for Electronically Erasable Programmable Read Only Memory also called flash memory. See also Flash EEPROM. External Interface File (XIF) A file produced by the LonBuilder Developer's Workbench or the NodeBuilder tool that documents a device's external interface. After converting the text version of the external interface file to binary using the utility XIF2BIN (supplied with the LNS Developer’s Kit for Microcontrollers and the LNS Developer's Kit for Windows), the host application can import external interface file definitions into the NSS using a set of services. The text version has an extension of XIF, the binary file has an extension of XFB. The XFB file must be version 3.0 or later. See also NXE File Explicit Addressing Low-level messages that application devices use to communicate with one another. Each message contains a message code that identifies the type of message. Application devices use the codes to determine the action to take when the message is received. When using explicit messages, the device is responsible for building, sending, and responding to messages. See also Implicit Addressing
F Fan-In Connection A connection where the outputs on multiple devices are directed to a single input on another device. Fan-Out Connection A connection where the output on a single device is directed to an input on multiple other devices Far Side The half of a router that does not have a direct path to the NSS. The NSS communicates with the far side of a router indirectly through the near side. Flash EEPROM Flash memory (sometimes called "flash RAM") is a type of constantly-powered nonvolatile memory that can be erased and reprogrammed in units of memory called blocks. It is a variation of electrically erasable programmable read-only memory (EEPROM) which, unlike flash memory, is erased and rewritten at the byte level, which is slower than flash memory updating. Flash memory is often used to hold control code such as the basic input/output system (BIOS) in a personal computer. When BIOS needs to be changed (rewritten), the flash memory can be written to in block (rather than byte) sizes, making it easy to update. On the other hand, flash memory is not useful as random access memory (RAM) because RAM needs to be addressable at the byte (not the block) level. Flash memory gets its name because the microchip is organized so that a section of memory cells are erased in a single action or "flash." Fetch Fetch is a synonym to Poll, see Poll and Netvar fetch.
G
EXCELON
EN2B-0210 GE51 R0405 102
Group A group is a logical collection of nodes within a domain. Unlike a subnet, however, nodes are grouped together without regard for their physical location in the domain. The neuron chip allows a node to be configured to be a member of up to 15 groups. Groups are identified by one byte group number, so a single domain may contain up to 256 groups.
H Host A device implementing layer 7 of the LonTalk protocol. A host may be based on the Neuron Chip, in which case it is called a Neuron Chip Hosted Device. A host may be based on another processor, in which case it is called a host-based device. A host-based device uses The Neuron Chip as a network interface to talk to the LonWorks network. Host Application The application program running on the host in a host-based device. An LNS host application is a subset of host applications. Host-Based Controller See Host-Based Device Host-Based Device A device in which layer 7 of the LonTalk protocol runs on a processor other than the Neuron Chip. Host Processor The application processor for a host-based device; typically a micro-controller, microprocessor, or computer. Host Selection A host-based device mode in which network variable processing is performed by the host. Host applications based on the LTM-10 Module or MIP can use either network interface selection or host selection. Host applications based on the NSS-10 Module, PCNSS Interface Card, PC LonTalk Adapter (PCLTA), or Serial LonTalk Adapter always use host selection. Hub/Target End-End definition for connections between two or more NVs or between two or more message tags. The network management tool automatically issues the hub/target definition. Every connection has one hub network variable or message tag and one or more target network variables or message tags. When creating a connection with one input and one output, it does not matter which end of the connection is the hub and which is the target. However, when creating large, e.g. fan-in (multiple outputs connecting to single input) or fan-out (a single output connecting to multiple inputs), making the common network variable the hub will reduce the time required making the connection. For example, in a fan-in connection, the single input should be the hub; in a fan-out connection, the single output should be the hub. Implicit Addressing A form of messaging in which the Neuron Chip firmware builds and sends network variable update and explicit messages using information contained in tables in its EEPROM. Implicit addressing is established during binding. See also Explicit Addressing
L LNS LNS stands for LonWorks Network Services and is a control network architecture that includes hardware and software products for 32-bit Windows and for embedded platforms.
EXCELON
103 EN2B-0210 GE51 R0405
Among its many functions, LNS allows a microprocessor or computer to perform a broad range of services over LonWorks networks. These services include network management, system design/commissioning, and system-wide monitoring/control. There are numerous application programs, like LonMaker for Windows, that are built upon LNS and take advantage of its services. LonMark Brand name for devices that fulfill the interoperability standards of the LonMark Association. LonMark Association An independent organization of LonWorks developers, system-integrators, and end-users that define standards to ensure interoperability between LonWorks devices from multiple manufacturers. LonMark Object A collection of network variables, configuration properties, and associated behavior defined as part of the LonMark interoperability program. LonMark objects define standard formats and semantics for how information is exchanged between devices on a network. LonWorks Device A device that communicates on a LonWorks network. A LonWorks device may be an application device or a router. LonWorks devices are commonly called just devices in LonWorks documentation and are also called nodes. Each LonWorks device includes local processing and input/output (I/O) hardware to process input data from sensors, execute a control task, and control actuators. Each device also includes the capability to communicate with other devices using the LonTalk protocol in firmware. The LonTalk protocol is a complete 7-layer communications protocol that ensures that devices can interoperate using an efficient and reliable communications standard. Each LonWorks device contains an application program and the following hardware: ● A Neuron Chip ● A transceiver ● Application electronics to connect the Neuron Chip to I/O devices such as
sensors, actuators, displays, and keypads. ● An optional host processor. If a host processor is used, the application executes on the host processor and the Neuron Chip is used as a network interface. Two development tools are available for LonWorks devices. The NodeBuilder Development Tool is used to develop LonWorks devices; the LonBuilder Developer's Workbench is used to develop LonWorks systems. Development teams can use a single NodeBuilder tool per developer, and a LonBuilder tool for system integration and test. A LonWorks Router is a special type of LonWorks device. LonWorks Network A collection of LonWorks Devices that communicate and interact with one another. All devices in the same network belong to the same domain or set of domains. A LonWorks network can contain a single channel or multiple channels connected by LonWorks routers. Due to their low cost and flexibility, LonWorks networks are used in many ways. For example, they can be used to instrument relay-controlled systems, saving the time, complexity, and cost associated with running wire from each point back to the monitoring station. They can also be used in conjunction with a central controller or PLC to, for example, provide a sub-system of smart sensors. LonWorks networks can also be used as stand-alone systems, called Peer-To-Peer systems, where each device controls its own actions and shares information with its neighbors as needed to control the entire system. LonWorks Router An active LonWorks Device, which physically connects two LonWorks channels. Each router side can receive a packet, make a decision as to whether the packet
EXCELON
EN2B-0210 GE51 R0405 104
needs to be transmitted, and transmit the packet on the other side’s channel, if required. The router necessarily injects some delay in the packet transmission. A router can be configured to be one of the following: Repeater: all packets are forwarded. Permanent Repeater: all packets are forwarded. Subnets can span permanent repeaters. Bridge: all packets in a given domain are forwarded. Permanent Bridge all packets in a given domain are forwarded. Subnets can span permanent bridges. Learning Router: packets are routed only for a given domain. The router starts as a bridge and reduces forwarding as it learns the topology. Learning routers are vulnerable to failures if configured devices are incorrectly moved within the topology. Configured Router: packets are routed only for a given domain. Forwards packets based on configured tables. This is the most reliable and efficient form of router. Each router side can be addressed by its Neuron ID or by a subnet/node address. The side of the router, which can communicate with the network manager, is referred to as the near side, and the other side as the far side. LonWorks Technology LonWorks technology consists of the tools, modules, and ICs required to build intelligent device and to install them in control networks. Each LonWorks device includes local processing and input/output (I/O) hardware to process input data from sensors, execute a control task, and control actuators. Each device also includes the capability to communicate with other devices using the LonTalk protocol in firmware. Two development tools are available for LonWorks devices. The NodeBuilder Tool is used to develop LonWorks devices; the LonBuilder Developer's Workbench is used to develop LonWorks systems. Development teams can use a single NodeBuilder tool per developer, and a LonBuilder tool for system integration and test. Both the NodeBuilder and LonBuilder tools are used to program Neuron Chip-hosted devices to send messages to one another in response to changes in various conditions, and to take action in response to messages they receive. The NodeBuilder and LonBuilder tools facilitate the independent development of individual devices whose function may be simple or complex, and integration of these devices into LonWorks applications, which might perform complex and sophisticated tasks.
M MAC Media Access Control provided by the MAC Processor, which is part of the neuron chip. The MAC processor handles layers 1 and 2 of the 7-layer network protocol stack. This includes driving the communications subsystem hardware as well as executing the collision avoidance algorithm. Manufacturer Configuration flag of a CP, which specifies that a network tool must reset the device after changing the value of the configuration property. If multiple modifications of configuration properties are being made at the same time, then one reset can be completed in lieu of having to reset the device the same number of times as Reset-flagged configuration properties were modified. Mapping The process of logically connecting an NV to one or more data points or one or more data points to one NV. This includes the data conversion of values. Maximum Rate Estimate Estimated maximum message rate, in tenths of messages per second, that the associated message tag is expected to transmit. Measure of "talkativeness" of the NV.
EXCELON
105 EN2B-0210 GE51 R0405
Message Tag Proprietary telegram exchange between to 2 bound nodes. Similar to NVs, but a message tag has no type, size and direction. Logical input and output ports that nodes use to send and receive explicit messages. A node always contains a msg_in tag and may contain declared message tags as well. Declared message tags are bi-directional (the node can both send and receive messages with them). The msg_in message tag can only be used to receive messages. Generally nodes use network variables to communicate with one another since they are interoperable and produce more efficient code. Message Tag Index A number used to identify a message tag. Message tag indices are assigned by the Neuron C compiler in the order in which the variables are declared. The first message tag in a program is index 0, the second is index 1, and so on. MIP Microprocessor Interface Program. MIP is firmware for the neuron chip that transforms the neuron chip into a high performance communication processor for an attached host. Multicast Messages sent to more than one node. For a multicast message, the address mode is Group, Subnet Broadcast, or Domain Broadcast.
N Near Side The half of a router that has a direct path to the NSS. Net buffer in Size and number of buffers between MAC and network processors for incoming explicit messages and network variables. Net buffer out Size and number of non-priority and priority buffers between network and MAC processors for outgoing application messages and network variables. Net buff out priority Number of priority network buffers. Netvar fetch Network variable fetch, fetch is a synonym to Poll, see Poll. Network Interface A device that provides a layer 6 LonTalk interface to a host. Examples of network interfaces include the PCLTA PC LonTalk Adapter, the Serial LonTalk Adapter, and the NSI-10 and NSS-10 network services interfaces. Network Services Server (NSS) The component in the LNS architecture that processes network services, maintains the network database, and enables and coordinates multiple points of access. Network Variable High-level objects that application devices use to communicate with one another. The types, functions, and number of network variables in each node are determined by the application code within the device. Network variables make it easy to develop networked control applications by eliminating all of the low-level and tedious work of building and sending downlink messages, and receiving and responding to uplink messages. Network Variable Configuration Table A table that maps network variable indices to network variable selectors and, for output network variables, to an address table entry. For Neuron Chip hosted devices, the table is stored in EEPROM on the Neuron Chip. For host-based devices, the table is stored on the host.
EXCELON
EN2B-0210 GE51 R0405 106
Network Variable Index A number used to identify a network variable. Network variables indices are assigned by the Neuron C compiler in the order in which the variables are declared. The first network variable declared is index 0, the second index 1 and so on. The NSS uses the network variable index to refer to the network variables on a node. Neuron Chip hosted devices can declare a maximum of 62 network variables (indices 0 to 61). The NSS for Windows supports host-based devices with up to 4096 network variables (indices 0 to 4095). The NSS-10 module supports host-based nodes with up to 255 network variables (indices 0 to 254). In an array of network variables, each element has a separate index. Network Variable Selector A 14-bit number used to identify connected network variables. Network variable selectors are assigned by the NSS during binding. See also Selector. Network Variable Types A network variable's type defines its structure and contents. A network variable type can be either a SNVT or a user-defined type. Neuron® The chip in which the LonTalk protocol is typically embedded. A Neuron is part of every LonWorks node today - over 2 million installed and counting. Although, beginning in May of 1996, the LonTalk protocol became available for porting to any processor for free (under license agreement). Neuron C The programming language used to write applications for the Neuron Chip is Neuron C, a derivative of ANSI C enhanced to support I/O, event processing, message passing, and distributed data objects. Several major differences between Neuron C and ANSI C are in the area of supported data types. Neuron C has a special run-time library and language syntax extensions that support intelligent distributed control applications using Neuron Chips. Neuron C extensions include software timers, network variables, explicit messages, a multitasking scheduler, and EEPROM variables. Neuron Chip A family of VLSI components that implements the LonTalk protocol. The Neuron Chip can manage I/O devices and execute user-written application code, or alternatively be used to create a network interface to a host processor. Neuron Chip Firmware Firmware required to operate a Neuron Chip and implement the LonTalk protocol. This firmware is contained in the VERxxx subdirectories of the LonWorks IMAGES directory (default C:\LonWorks\IMAGES) in files with the name S*.NX*. A custom system image including the Neuron Chip firmware with extensions for the LTM-10 hardware is included in the LTMSYS.NX file in the VER122 subdirectory of the IMAGES directory. This file does not include the MIP image included in the LTM-10 module. A special Neuron Chip firmware image is provided in a file named EEBLANK.NRI in the NodeBuilder system directory. This image can be used to blank the EEPROM in a Neuron 3150 Chip. See EEBLANK for details. Use of the Neuron Chip firmware is subject to terms and conditions defined in the NodeBuilder software license agreement and the LonWorks OEM license agreement. Neuron Chip-Hosted Device A device in which layer 7 of the LonTalk protocol runs on the Neuron Chip. Neuron-based Node See Neuron Chip-Hosted Device Neuron ID 48-bit identifier that uniquely identifies the neuron chip. The neuron ID is assigned when each neuron chip is manufactured. This ID is guaranteed to be unique world-wide and does not change over its lifetime. NSS See Network Services Server.
EXCELON
107 EN2B-0210 GE51 R0405
Node A LonWorks device. This term is used in the LonWorks Network Services Architecture. Node address Logical address of the device. At installation time each LonWorks device is assigned a logical address by the network management tool (e.g. NSS). Logical addresses are used instead of the physical addresses (neuron IDs) because they support more efficient routing of messages and they simplify replacing failed devices. Logical addresses consist of three components: A domain ID, subnet ID, and node ID. The domain ID identifies a collection of devices that may interoperate. Devices must be in the same domain to exchange packets. Thereby may be up to 32.385 devices in a domain. The subnet ID identifies a collection of up to 127 devices that are on a single channel, or a set of channels connected by repeaters. Subnet IDs are used to support efficient routing packets in large networks. There may be up to 255 subnets in a domain. The node ID identifies an individual device within a subnet. Node ID 7-bit unique node number. The third part of the LonTalk addressing hierarchy of domain/subnet/node. At installation time, each device is assigned a unique node ID in its subnet by the NSS. Node location string A 6-byte field, which is part of the configuration structure located in the EEPROM. The node location string describes the physical location of the node to a network management tool. This string may be read and written over the network using the read memory and write memory network management messages. Some devices can determine their physical location by reading external physical inputs such as DIP switches, keyed connectors, card-cage slot numbers and the like. Such devices us the location field to communicate their physical location information to network management tool that can use this information to identify the physical assignment of the device. NV See network variable. NXE File The ASCII text version of APB file, see APB File. See also External Interface File (XIF)
O Offline Configuration flag of a CP, which specifies that a network tool must take this device offline, or ensure the device is already offline, before modifying the configuration property. This flag or the FB-Disabled flag is recommended for a configuration property implemented within a configuration file with direct memory read/write access if the application requires update notification, or if the application cannot tolerate updates from the network at the same time the application is reading the configuration property. This flag should not be used for configuration properties implemented within configuration files that are accessed via FTP, and network tools should ignore this flag for such configuration properties. This is because a device cannot transfer configuration property values via FTP while offline. In fact, an offline application must be placed into the online state for the duration of any FTP configuration property operations. Obj disable Configuration flag of a CP, which specifies that a network tool must disable the functional block containing the configuration property, take the device offline, or ensure that the functional block is already disabled or the device is already offline, before modifying the configuration property. This flag or the Device-Offline flag is recommended for a configuration property implemented within a configuration file
EXCELON
EN2B-0210 GE51 R0405 108
with direct memory read/write access if the application requires update notification, or if the application cannot tolerate updates from the network at the same time the application is reading the configuration property. A network tool may elect not to disable a functional block before modifying a configuration property with the Obj disabled flag if that device is already offline and can be updated while offline. This is allowed because an offline device has all its functional blocks implicitly disabled, and because a functional block cannot be directly disabled when the device is already offline.
P Packet The basic unit of exchange on a LonWorks network. Every message sent on a LonWorks network is packed into a packet for transmission over a physical medium (for example, a wire or a radio transmitter/receiver). Every packet includes: - Protocol Overhead (Required protocol control and addressing bytes) - User Data (Data that the user application wants to send) Packet Size The total number of bytes in the packet, including user data, protocol overhead, and addressing information. PCC-10 A type II PC (formerly PCMCIA) card NSI that includes an integral FTT-10 transceiver. Other transceiver types can be connected to the PCC-10 via external transceiver "pods". The PCC-10 is the best NSI to use with laptop, notebook, or embedded PCs. PC LonTalk Adapter (PCLTA) A network interface that provides a high-performance 16-bit ISA card interface to connect an IBM PC compatible host processor to a LonWorks network.
PCLTA-10 A 1/2 size ISA card NSI. Unlike the PCNSI, it includes a twisted pair transceiver onboard, eliminating the need to attach a separate SMX transceiver assembly. The PCLTA-10 also supports the Windows plug-and-play standard. The PCLTA-10 is the best NSI to use on a desktop PC host that attaches to a twisted pair channel. Peer-To-Peer A control strategy in which independent intelligent devices share information directly with each other and make their own control decisions without the need or delay of using an intermediate, central or master controller. Because of the enhanced system reliability introduced by eliminating the master (a single point of failure) and the reduced installation and configuration cost inherent in peer-to-peer designs, LonWorks networks often use a peer-to-peer control strategy. Permanent Bridge A LonWorks router configured to operate as a bridge. When marked as a permanent bridge, the NSS for Windows will not allow the routing algorithm to be changed. Since the NSS knows that the routing algorithm will never be changed, it allows the same subnet to exist on both sides of the permanent bridge. Permanent Repeater A LonWorks router configured to operate as a repeater. When marked as a permanent repeater, the NSS for Windows will not allow the routing algorithm to be changed. Since the NSS knows that the routing algorithm will never be changed, it allows the same subnet to exist on both sides of the permanent repeater. Physical Layer Repeater A hardware device that connects two segments of a channel. Unlike a LonWorks router, a physical layer repeater has no intelligence so it cannot selectively forward packets to increase network capacity, and, unlike a router, it forwards damaged packets. Poll An explicit request to a device for the value of one of its network variables.
EXCELON
109 EN2B-0210 GE51 R0405
Polled Network Variable An output network variable that never sends its value unless explicitly polled. Polling Network Variable An input network variable that issues a poll request to the outputs to which it is connected. Power Line To Echelon, the power line is a physical media that LonWorks networks can communicate over. The existing power wiring in your building, factory or home can be used as network wire by a LonWorks network. Priority A mechanism provided by the LonTalk protocol to allow devices priority access to the channel. Priority Attribute Under the LonTalk protocol, a sending node can be given a priority slot. A message sent with priority enabled has a much better chance of getting through on a busy channel without a collision than does a message sent without priority enabled. Program ID A unique identifier stored in the device (Neuron Chip's EEPROM) that identifies the application program running on the node. All nodes with the same program ID must have the same external interface. Devices that conform to the LonMark guidelines contain a program ID in a standard format called a "standard program ID". A standard program ID identifies the manufacturer of the device, the functionality of the device, the transceiver used, as well as the intended usage. Standard program IDs can therefore be used by network tools to functionally identify devices that have the same hardware on a LonWorks network. The fields within the standard program ID are as follows: Format A 4-bit value defining the structure of the program ID. Program ID formats 8 and 10-15 are reserved for interoperable LonMark devices, and can only be used for devices that have passed a LonMark conformance review. Program ID format 8 is used for standard program IDs, and indicate a LonMark certified device. Format 9 indicates a LonMark compliant device that has not passed a LonMark conformance review; it can be used for development, prototyping, and field trials prior to completing a LonMark conformance review. The remaining fields of the program ID are interpreted identically for formats 8 and 9. Manufacturer ID A 20-bit unique ID identifying the manufacturer of the device. This ID is assigned to a manufacturer upon request when it becomes a member of the LonMark Interoperability Association. Manufacturers who do not yet have an ID can use manufacturer ID 0 for development, prototyping and field trials. Device Class A 16-bit ID identifying the device class. This ID is drawn from a registry of pre-defined class definitions. The device class indicates the primary function of the device. If an appropriate class designation is not available, one will be assigned by the LonMark Interoperability Association upon request. Device Subclass A 16-bit ID identifying a subclass within the device class. This ID is drawn from a registry of pre-defined subclass definitions. The device subclass indicates the transceiver type used on the device and also its intended usage, i.e. residential, industrial, commercial building etc. If an appropriate subclass designation is not available, one will be assigned by the LonMark Interoperability Association upon request. Model Number An 8-bit ID identifying the specific product model. Model numbers are assigned by the product manufacturer and must be unique within a device class and subclass for the manufacturer. The model number within the program ID does not necessarily have to conform to the manufacturer´s model number.
EXCELON
EN2B-0210 GE51 R0405 110
Property An attribute of an object. For example, a device's location. Protocol Analyzer A tool that can read every packet on a LonWorks channel. A protocol analyzer is different from a device containing the complete LonTalk protocol stack, in that it can receive every packet on the network, and not only packets that are addressed to it. Protocol analyzers allow users to observe, analyse, and diagnose the behavior of installed LonWorks networks. Both the LonBuilder Protocol Analyzer and the LonManager Protocol Analyzer include the following tools for network analysis and diagnosis: - Packet monitor tool - Network traffic statistics tool - Network diagnostics tool Protocol Transaction Number Every LonTalk packet includes a 4-bit transaction number, which is used to help in uniquely identifying a transaction (this is necessary in order to recognize retransmissions, and potentially in order to match responses to their outgoing original message). A response (or ACK) to a message always contains the same transaction number as the original message. Since it is only 4 bits wide, the transaction number only ranges from 0-15, and is continuously reused. Nodes use timers in conjunction with the transaction number and other information to identify unique transactions.
R Reset Configuration flag of a CP, which specifies a factory setting that may be read or written when the device is manufactured, but is not normally (or ever) modified in the field. In this way, a standard installation tool may be used during manufacture to calibrate a device, while a field installation tool would observe the flag in the field and prevent modification of the value, or optionally require a password to modify the value. Retries The number of times a retry was made when sending out a message to a recipient. This number typically raises when the receiving node if offline or defect. Transmit Error [%] = [(Max value of either Transaction timeout or Transmission Retries) / Packets Transmitted by node] * 100 % Applies to acknowledged, unacknowledged-repeated, and request-response service. Receive transaction Size and number of ´Receive transaction buffer` which defines Incoming transactions, that can be handled concurrently by the network processor. Receive Error / receive trans full errors Receive transaction full errors: The number of times that an incoming packet was discarded because there was no room in the transaction database. This counter is incremented when incoming messages are lost because there is no more space in the transaction database of the neuron chip. An adequate design of the LonWorks device should keep this value near zero. Receive Error [%] = [(Max value of either Lost Messages or Transaction Full) / Packets Addressed to node] * 100 % Relaxed Binding Extended binding rule, where the same NV-selector can be used for multiple input NVs. This binding rule saves selector IDs. Relaxed binding is a feature and function of a network management tool and cannot explicitly done by a user. Response Messages
EXCELON
111 EN2B-0210 GE51 R0405
A response to a Request message. A node that receives a Request message passes the request up to the node's application, which then is responsible for returning the response. Request Messages Messages sent via the LonTalk Request-Response mechanism. The sending node expects a Response message back from the destination node. Router See LonWorks Router. Router Alg Router Algorithm for the near and far side: configured router, learning router, bridge, and repeater. Router Mode Router mode for the near and far side: Normal= returns the router from temporary bridge mode temp_bridge=temporary bridge mode which cause router to temporarily forward all messages in the domain init_rtr_table=copies forwarding tables from EEPROM tables into RAM tables or sets all RAM tables to flood. Rpt timer Repeat timer: Time interval in ms between repetitions of an outgoing message. Applies to unacknowledged service and unacknowledged epeated service. Rx timer Receive timer: Time interval in ms that expires when the receiving node has allocated a ´receive transaction record` due to an icoming packet. The receive timer must be greater than the greatest product of retry count and transaction timer. Applies to acknowledged and request-response service.
S SCPT Standard Configuration Parameter Type. A method of storing application configuration data using files that are read and written using the LonTalk File Transfer Protocol. Segment A segment is a set of channels connected by bridges or repeaters. Self-documentation string A mechanism to provide a node with descriptive information. Self-documentation can be provided for the node's program and network variables. A provider of user-defined services and events may also support self-documentation for itself, its services, events, objects, and properties. When available, the NSS makes self-documentation information available to the host application through properties. The node self-documentation string is at the highest level of the node documentation. The selfdocumentation string is up to 1024 bytes in length. For LonMark products, this string is used to map object indices defined on the node to their LonMark object types. The LonMark self-documentation string begins with a header to identify it as such. The header is the ASCII character ´&` followed by two ASCII numbers that represent the major and minor version number of the interoperability guidelines that the node implements. These two numbers are separated by a period. This sub string is followed by the ASCII character´@`, that is followed by the ASCII encoded numbers of the standard object types defined on the nodes. These numbers are delimited by the ASCII comma and terminated by the ASCII semicolon if additional documentation follows, otherwise the string is terminated by ending the string with the ASCII double quote character ´"`. After the semicolon, the developer is free to include any additional textual information as needed.
EXCELON
EN2B-0210 GE51 R0405 112
For example, suppose a node had the following five LonMark objects defined within in it: One node object (type 0), and four closed loop sensor objects (type2). Suppose that the developer planned to include additional installation information about the node. To set the node self-documentation string in this example node, the compiler directive would be the following: #pragma set_node_sd_string_ "&3.2@0,2,2,2,2;Installation Text". For more information please refer to LonMark Interoperability Guidelines. Selector Network Variable Selector: A 14-bit number used to identify connected network variables. Network variable selectors are assigned by the NSS during binding. A selector associates a network variable with all of the connections in which it participates. If this network variable is not a member of a connection, the selector is set to a value representing an unbound network variable. Service Type Acknowledgement see ´Acknowledged` Acknowledged All receivers of the message are caused to reply with an acknowledgement. The propagation of an Acknowledgement confirms that the incoming message has been received free of errors and that it entered the application input queue. The sender waits for all expected Acknowledgements to come back within a time period described by the transaction timer (tx timer) and enters a configurable number of retries upon failure of completion. The sender has a choice of either retrying the complete transaction or issuing a reminder to individual devices, which fails to Acknowledgement in time. Unacknowledged but repeated The sending device will repeat the outgoing message for a configurable number of repeats, using a configurable time between these attempts (repeat timer). Transaction completion control is limited to local completion. Success is reported as soon as the original packet and all repeats went out on the network, but does not include information about the receipt of such message on the destination nodes. Unacknowledged and not repeated Special form of the Unacknowledged but repeated service that uses a repeat count of zero. Request/Response Similar to Acknowledged service with two key differences. Firstly, the acknowledgement is called a response and carries data. Secondly, the transaction is initiated in the opposite direction: An Acknowledged transaction is initiated by the data source in order to provide up-to-date data for the data consumer, whereas an Request/Response transaction is initiated by the data consumer in order to obtain up-to-date from the data source. Service A request from a client to a server. A service is performed on an object. Services perform a complex sequence of changes in the devices in the network and the NSS's database. Service Pin Each Neuron Chip has a service pin used during installation to acquire the Neuron Chip's Neuron ID. When this pin is grounded, the Neuron Chip sends a broadcast message containing its Neuron ID and program ID. The method used to ground the service pin varies from device to device. Examples of mechanical methods include grounding via a push button or using a magnetic reed switch. By attaching one of the device's I/O pins to the service pin, the service pin can also be put under software control as long as the device is configured. For example, the device can ground the pin when the device is moved or when a predefined series of I/O occurs. The service pin can also be used to driver an LED that indicates the Neuron Chip's state. The service LED is solid on when the Neuron Chip is applicationless, blinks
EXCELON
113 EN2B-0210 GE51 R0405
slowly when the Neuron Chip has an application and is unconfigured, is off when the Neuron Chip has an application and is configured, and blinks once quickly each time the Neuron Chip is reset. SNVT Standard Network Variable Type. SNVTs facilitate interoperability by providing a well-defined interface for communication between devices made by different manufacturers. Standard Program ID see program ID.
Subnet The second level of the LonTalk addressing hierarchy. Subnet ID's are assigned by the NSS. A subnet is a logical collection of up to 127 nodes within a domain. Up to 255 subnets can be defined within a single domain. All nodes in a subnet must be on the same segment. Subnets cannot cross intelligent routers.
Subnet ID The subnet ID identifies a collection of up to 127 devices that are on a single channel, or a set of channels connected by repeaters.
Sync Flag, that defines, that all Updates to an output NV will be propagated, and in the original order.
T Target See Hub/Target Technical Address Internal six-digit number that defines and locates a point in the system. The number is composed of three pairs representing controller number (0-30), module number (1-16), and terminal number (1-12). Example: 010310 meaning Controller 1, Module 3, terminal 10. Operators use the User Address to refer to points. Transaction timeout The number of times the node tried to send a message to a recipient who did not respond. Retries are not counted here. This counter gets incremented after all retries failed. There is no normal range for this counter, because it depends on the application what messages are being sent out. Typically, this number raises, when recipients cannot be reached because they are offline. Transmit transaction Size and number of Transmit transaction buffer. Turnaround One NV is bound to another NV of the same node (turnaround binding). Tx timer Transaction timer: Time interval in ms between retries. Applies to acknowledged and request-response service.
U Unconfigured Device A device state where the device has an application image, but no network image. The device must be configured before it can operate on the network. UCPT
EXCELON
EN2B-0210 GE51 R0405 114
Acronym for User-Defined Configuration Parameter Type: UCPTs resemble SCPTs, but are not of a predefined type, see the Resource File Description delivered with Echelon’s LNS package. Unicast Messages sent to a single node. For a unicast message, the address mode is either Subnet-Node or Neuron ID. UNVT User-Defined Network Variable Type. UNVTs are application-specific Network Variable Types and are thus not SNVTs.
V VNI Mode Virtual Network Interface Mode. A special driver mode of PCLTA-10/20 and PCC-10 PCMCIA cards that provides better performance and the LonTalk Protocol Analyzer functionality.
W Wink Causes the device to generate an application dependant audible or visible response such as flashing a service LED. This command will only have an effect if the device supports the Wink function. This can be useful for identification and testing purposes.
X XIF Acronym for External Interface File. See also External Interface File.
Z Zero-domain The domain with the length ´0´.
EXCELON
115 EN2B-0210 GE51 R0405
INDEX
? ?
About (submenu) 25 Contents (submenu) 25 menu 25 Registration (submenu) 25
A About
submenu 25 Access state
node properties 37 router 46
Acknowledged definition 112
Acknowledged but repeated definition 112
Action status bar 23, 77
Actual packet count/sec status bar 23, 77
Add Lon node 34 Add node by pressing service pin 34 Add node to network tree
toolbar icon 25 Additional domain 15 Address
definition 98 node 20 NV 20, 68
Address information packet 80
Address table definition 98 node properties 40
Address table entries NV 68
Address table entry addressing type 40 domain ID 40 Retry 40 Rpt timer 40 Rx timer 40 Tx timer 40
Addresses node 40 node properties 40
Addresses number node properties 36
Addressing mode definition 98
Addressing type address table entry 40
Alg 45 Algorithm
router 45 Alias
definition 98 index 43
node address 43 NV details 76 NV index 43 NV name 43 NV selector 43 service type 43
Aliases node 43 node properties 43
Aliases number node properties 36
already_preempted software error code 95
Alternate path definition 98, 99 flag 80 packet 80
Add a Lon node sub menu 24
Analyzer packets export 90
Analyzer refresh LON default settings 31
APB file definition 98 download 50
App buff in buffers 44
App buff out buffers 44
App buff out priority buffers 44
App buffer in definition 99
App buffer out definition 99
App buffer out priority definition 99
appl_cs_error software error code 96
appl_signature_bad software error code 97
Application download 50 restart 37
Application download into node 35
Applicationless node status 32, 37
Applicatoinless device definition 99
Associated node find for NV 72
Attribute packet 22, 78
Attributes definition 99
Auth Key 12, 14, 15, 38 Authenticated
definition 99 flag 80 NV details 76 packet 80
EXCELON
EN2B-0210 GE51 R0405 116
Authentication key definition 99
authentication_mismatch software error code 97
Automatic network diagnostic 86 Automatic network diagnostics 24 Average packet count/sec
status bar 23, 77 Average rate estimate
definition 99 NV details 75
B Backlog
definition 99 Backlog overflows
statistics 42 bad_address_type
software error code 95 bad_event
software error code 94 Binder
definition 99 Binding
definition 99 relaxed 36
Binding status NV 20
Bindings find for NV 72 NV details 75
Bound NV 68 NV details 75
Bridge definition 103
Broadcast definition 99
Browse network variables 67 NVs 52, 67
Buffers app buffer in 44 app buffer out 44 app buffer out priority 44 count 44 net buffer in 44 net buffer out 44 net buffer out priority 44 node 44 node properties 44 original memory 44 receive transaction 44 size 44 total memory 44 transmit transaction 44 type 44
Buffers far router 47
Buffers near router 47
C Channel
definition 99 Channel ID
definition 99 node diagnostic 64 node properties 37
Channel ID far router 46
Channel no node 21
Check project 89 Checksum error over system image
software error code 97 Chip
last error code logged onto 21 Clear
network variables list 76 protocol 86 statistics 42
Clear pane toolbar icon 26
cnfg_cs_error software error code 96
Collisions definition 100
Collisions detected statistics 42
Columns hide 77 redisplay 77
Comm. Ratings statistics 42
Configuration flags CP 53
Configure node 35, 52 XFL module 55 XFL521B 55 XFL522B 57 XFL523B 59 XFL524B 61
Configured device definition 100
Configured offline node status 32, 37
Configured online node status 32, 37
Configured router definition 104
Connect to network 13 Connect/disconnect Excelon
toolbar icon 25 Constant
CP 54, 100 Contents
submenu 25 Count
buffers 44 CP
configuration flags 53 constant 54, 100 definition 53 dev.specific 54, 100 fiel type 55 index 53 manufacturer 54, 104 obj disable 53, 107
EXCELON
117 EN2B-0210 GE51 R0405
object reference 53 offline 54, 107 offset 55 range (min .. max) 55 reset 54, 110 size 55 type 53 value (raw) 55 write protected 55
CRC packet 80
CRC Err node diagnostic 65
CRC error definition 100
CRC errors statistics 42
CRC errors (%) node 21
Create domain 16
Cyclically refresh pane 77
D Data
packet 22, 78 packet 80
Data size packet 80
Definition CP 53
Destination node 81 packet 80
Destination node find 81
Detect nodes 31
Detected devices status bar 23
Dev.specific CP 54, 100
Device type node 21
Diagnostic automatically 86 node 64 put node into 35
Diagnostic record 87 open 88 save 87
Display node properties 35
Display hidden columns toolbar icon 26
Display network variables 67 Display version and copyright
toolbar icon 26 divide_by_zero
software error code 96 Domain
additional 15 create 16 definition 100
packet 22, 78 remove 17 scan this 81 set 12, 14, 15 settings 16 switch to 16 switch to this 81
Domain broadcast definition 105
Domain ID 12, 14, 15, 38 address table entry 40 definition 100 node 21 packet 80
Domain properties far side 46 near side 46
Domain settings 14, 15 Domains
node properties 38 Domains 14, 15
leave domain 38 set domain 38
Domains number node properties 36
downlink_mip_transfer_lost software error code 94
Download APB file 50 application 50 node program 50 NXE file 50 XIF file 50
E EEPROM 42
definition 101 EEPROM recovery occured
software error code 97 eeprom_write_fail
software error code 95 Enable/disable polling
toolbar icon 26 Enable/disable power search 33 Environment 18 EXCEL 5000 compliance
set for router 48 Excelon and other network management tool use in parallel
13 Excelon Environment 18 Exclude all
filter criterion 83 Exit
submenu 24 Explicit addressing
definition 101 Export
all NVs of log file 93 analyzer packets of project 90 NVs of project 91
Export functions 90 Extended information in Analyzer
LON default settings 31 External interface file
definition 101
EXCELON
EN2B-0210 GE51 R0405 118
F Fan-in connection
definition 101 Fan-out connection
definition 101 Far side
definition 101 domain properties 46
Fetch definition 101
File exit (submenu) 24 menu 23 new (submenu) 23 open (submenu) 23 save (submenu) 24 save as (submenu) 24
File type CP 55
Filter exclude all criterion 83 include all criterion 83 reset 83 unselected criterion 83
Filters remove 86 reset 83 set 82
Firmware version node properties 37
Flags alternate path 80 authenticated 80 packet 80 priority 80
Flash EEPROM definition 101
G Group
definition 102, 105
H Has Alias
NV details 76 Hide
columns 77 Hide columns
toolbar icon 26 Highlight node on service pin
default settings 30 Highlight NVs in pane 82 Honeywell XFL modules 32 Host
definition 102 Host application
definition 102 Host processor
definition 102 Host selection
definition 102 Host-based controller 19, 32
definition 102 Host-based device
definition 102 Host-based node
node properties 37 Hub/target
definition 102
I Idempotent
definition 99 illegal_send
software error code 96 Implicit addressing
definition 102 Include all
filter criterion 83 incomplete_msg
software error code 95 Index
alias 43 CP 53
Installation 8 invalid_addr.table_index
software error code 95 invalid_appl_error
software error code 96 invalid_domain
software error code 95 invalid_nv_index
software error code 96 invalid_resp_alloc
software error code 95 invalid_xcvr_reg_addr
software error code 96 Invoke W.O.C. dialog
toolbar icon 26 io_ready
software error code 96
L Last error
node diagnostic 65 Last error code
logged on chip 21 Last error logged
statistics 42 Last reset cause
statistics 42 Last updated NV
status bar 23 Late acks or responses
statistics 42 Latest packets
show in protocol pane 86
26 Learning router
definition 103 Leave domain 38 License
terminate 11 LM-obj
LonMark object of NV 68
EXCELON
119 EN2B-0210 GE51 R0405
LNS definition 102
Load node on service pin default settings 30
Loc. string node diagnostic 64
Location string definition 107 node 21 node properties 36
Log analyzer packets file LON default settings 31
Log file export all NVs 93
Log node diagnostics to file LON default settings 31
Log NV value changes to file LON default settings 30
Log time node 21 node diagnostic 65
Lon Add a Lon node (sub menu) 24 automatic network diagnostics (sub menu) 24 menu 24 search all 1-Byte domains (sub menu) 24 search for Lon Nodes (sub menu) 24 send service pin (sub menu) 24 Set domain of network interface (sub menu) 24 Settings (sub menu) 25
LON default settings 29 Analyzer refresh 31 extended information in Analyzer 31 highlight node on service pin 30 Load node on service pin 30 log analyzer packets file 31 Log node diagnostics to file 31 Log NV value changes to file 30 LonTalk Protocol Analyzer 31 minimize window on startup 30 node diagnostics 30 Node polling rate 30 NV Polling 30 NV polling rate 30 Ringbuffer size 31 30 scan Lon network on startup 30 search nodes also on zero domain 30 watch bound NVo values 31 watch foreign NV fetches 31
LON file save 87
LonMark definition 103
LonMark Association definition 103
LonMark object definition 103
LonTalk Protocol Analyzer 77 definition 110 LON default settings 31 protocol pane 78 start 78
LonWorks device definition 103
LonWorks network
definition 103 LonWorks router
definition 103 LonWorks technology
definition 104 Lost msgs (no app buff)
statistics 41
M MAC
definition 104 Manufacturer
CP 54, 104 Mapping
definition 104 Maximum rate estimate
NV details 75 Maximum rate estimate
definition 104 memory_alloc_failure
software error code 96 Menu
? 25 file 23 Lon 24 View (submenu) 24 web 25
Menu bar 18, 23 Menus 23 Message
packet 78, 80 Message information
packet 80 Message tag
definition 105 Message tag index
definition 105 Messages transmitted by node
statistics 41 Minimize window on startup
default settings 30 MIP
definition 105 Missed msgs (no net buff)
statistics 41 Mode
router 45 Multicast
definition 105 Multiple Instances 14
N Name
node diagnostic 64 NV 20
Near side definition 105 domain properties 46
Net buff in buffers 44
Net buff out buffers 44
Net buff out priority buffers 44
EXCELON
EN2B-0210 GE51 R0405 120
definition 105 Net buffer in
definition 105 Net buffer out
definition 105 Netvar fetch
definition 105 Network
connect to 13 Network interface
definition 105 status 23, 77
Network interface and driver status status bar 23, 77
Network Interface Settings 12, 14, 15 Network services server
definition 105 Network tree pane 18 Network variable
definition 105 instant refresh 72 view details 74 watch 70
Network variable configuration table definition 105
Network variable index definition 106
Network variable selector definition 106
Network variable types definition 106
Network variables browse 67 clear list in NV pane 76 disable polling 69 disable refresh 69 display 67 enable polling 69 enable refresh 69 poll 69 reload values 72 remove from NV pane 76 sort 69 update 73
Network variables pane 18 Neuron
definition 106 Neuron C
definition 106 Neuron chip
definition 106 Neuron chip firmware
definition 106 Neuron chip hosted device
definition 106 Neuron chip software error codes 94 Neuron ID
definition 106 node 21 node diagnostic 64 node properties 36
Neuron-based node 19, 32 definition 106
Neuron-chip type node properties 37
New
submenu 23 no_msg_avail
software error code 95 Node
reset 37 Node 12, 14, 15, 38
add by pressing service pin 34 address 20 addresses 40 alias address 43 Aliases 43 browse NVs 35 buffers 44 channel no 21 clear statistics 35, 62 configure 52 configure (XFL modules only) 35 CRC errors (%) 21 definition 107 destination 81 device type 21 display properties 35 domain ID 21 download application 35 highight on service pin 30 highlight in tree 66 instant refresh 66 load on service pin 30 location string 21 log diagnostics to file 31 log time 21 add 34 neuron ID 21 polling rate 30 program download 50 properties 64 put into diagnostic 35, 64 remove 35, 49 re-read 35, 63, 67 reset 35, 63 reset status 21 restart application 37 restart measurement 49 Rx errors (%) 21 Rx messages/sec 21 search also on zero domain (default settings) 30 search for 33 send wink to 63 set offine 35 set offline 62 set online 35, 62 set unconfigured 62 set unfconfigured 35 source 81 statistics 41 timer settings 40 total messages/sec 21 transport parameter 40 Tx errors (%) 21 Tx messages/sec 21 wink 35
Node address definition 107
Node diagnostic channel ID 64 CRC Err 65
EXCELON
121 EN2B-0210 GE51 R0405
last error 65 loc. string 64 log time 65 msgs 65 name of node 64 neuron ID 64 node ID 64 reset 65 Rx error 65 Rx msgs 65 S/N 64 Tx error 65 Tx msgs 65 type 64
Node diagnostics default settings 30
Node ID 21 definition 107 node diagnostic 64
Node location string definition 107
Node name of NV 68
Node pane 18 Node polling rate
default settings 30 Node properties
access state 37 addresses 40 Aliases 43 buffers 44 channel ID 37 display 35 domains 38 Firmware version 37 host-based node 37 location string 36 neuron ID 36 neuron-chip type 37 number of addresses 36 Number of Aliases 36 number of domains 36 Number of NVs 36 Number of tags 36 program ID 36 relaxed binding 36 selfdocumentation string 36 statistics 41
Node status applicationless 32, 37 configured offline 32, 37 configured online 32, 37 unconfigured 32, 37
Nodes detect 31 disable polling 66 enable polling 65 poll 65 refresh 65 reload values 66 sort 65 upload 31
Nodes with router find 34
NSS definition 106
NV address 20 address 68 address table entries 68 binding status 20 bound 68 definition 107 find associated node 72 find bindings 72 LM-obj 68 log value changes to file 30 name 20 node name 68 polling rate 30 self doc 68 selfdocumentation string 20 service (type) 68 service type 20 size 20 size 68 SNVT 68 status bar 23 type 20 update rate 20 updates rate 68 value 20, 68 value in raw hex 69 watch 69
NV details alias 76 authenticated 76 average rate estimate 75 bindings 75 bound 75 has alias 76 maximum rate estimate 75 offline 75 polled 75 priority 76 sync 75 turnaround 76
NV index alias 43
NV name 68 alias 43
NV pane 18 NV polling
default settings 30 NV polling rate
default settings 30 NV selector
alias 43 NV update information
packet 80 NV updates
protocol pane 22, 78 nv_length_mismatch
software error code 95 nv_msg_too_short
software error code 95 nv_update_on_output_nv
software error code 95 nvi 20 nvo 20 NVs
browse 35, 52, 67
EXCELON
EN2B-0210 GE51 R0405 122
export 91 highlight in pane 82 watch all 69
NVs number node properties 36
NVs of log file export 93
NXE file definition 107 download 50
O Obj disable
CP 53, 107 Object reference
CP 53 Offline
NV details 75 Offline
CP 54, 107 Offset
CP 55 Open
diagnostic record 88 record 88 sub menu 23
Open LON file toolbar icon 25
Open network interface settings dialog box toolbar icon 25
Original memory buffers 44
P Packet
address information 80 Alternate path 80 attribute 22, 78 Authenticated 80 CRC 80 data 22, 78, 80 data size 80 definition 108 destination 80 domain 22, 78 domain ID 80 flags 80 message 78, 80 message information 80 no 80 NV update information 80 prioriy 80 protocol pane 22, 78 raw header 80 receiver 22, 78 sender 22, 78 service 80 service type 22, 78 size 80 source 80 tag 22, 78 time stamp 78 time stamp 80 timestamp 22
TxNo 80 Packet details
address information 80 alternate path 80 authenticated 80 CRC 80 data header 80 data size 80 destination 80 domain ID 80 flags 80 message 80 message information 80 NV update information 80 packet no 80 packet size 80 priority 80 raw header 80 service 80 souce 80 time stamp 80 TxNo 80 view 79
Packet errors detected (CRC) node statistics 41
Packet no 80 Packet size
definition 108 Packet size 80 Packets
remove all from protocol pane 86 show latest in protocol pane 86
Packets addressed to node statistics 41
Packets received by node statistics 41
Pane cyclically refresh 77
Parallel use of Excelon and other network management tool 13
PC LonTalk Adapter (PCLTA) definition 108
PCC-10 definition 108
PCLTA definition 108
PCLTA-10 definition 108
Peer-to-Peer definition 108
Permanent bridge definition 108
Permanent repeater definition 103
Physical layer repeater definition 108
Poll definition 108 network variables 69 nodes 65
Poll/Index 20 Polled
NV details 75 Polled network variable
definition 109 Polling
EXCELON
123 EN2B-0210 GE51 R0405
disable for network variables 69 disable for nodes 66 enable for network variables 69 enable for nodes 65
Polling network variable definition 109
Power line definition 109
Power search enable/disable 33
preemption_mode_timeout software error code 95
Prioritiy NV details 76
Priority definition 99, 109 flag 80 packet 80
Priority attribute definition 109
Program ID definition 109 node properties 36
Project check 89 export all NVs 91
Properties node 64 router 45
Property definition 110
Protocol clear 86
Protocol analyzer definition 110
Protocol pane 18, 78 NV updates 22, 78 packet 22, 78 remove all packets 86 requests 22, 78 responses 22, 78 show latest packets 86
Protocol transaction number definition 110
R Range (min .. max)
CP 55 Rate
of NV updates 68 Raw header
packet 80 Raw hex
NV value 69 Read_past_end_of_msg
software error code 95 read_write_semaphore_set
software error code 97 Receive error
definition 110 Receive errors
statistics 42 Receive trans full errors
definition 110 node statistics 41
Receive transaction buffers 44 definition 110
Receiver packet 22, 78
Record 87 open 88 save 87
Redisplay columns 77
Refresh disable for network variables 69 enable for network variables 69 network variable instantly 72 node instantly 66 nodes 65 statistics 42
Registration 8 submenu 25
Relaxed binding definition 110
Reload values of all network variables 72 values of all nodes 66
Reload current values toolbar icon 26
Remove all packets from protocol pane 86 filters 86 network variables from NV pane 76 node 35, 49
Repeater definition 103
Request messages definition 111
Request/Response definition 112
Requests protocol pane 22, 78
Re-read node 35, 63, 67
Reset node 37
Reset CP 54, 110 filter 83 filters 83 node 35, 63 node diagnostic 65
Reset status node 21
Response messages definition 111
Responses protocol pane 22, 78
Restart application 37
Restart measurement node 49
Restart measurement of all nodes toolbar icon 26
Retries definition 110
Retry address table entry 40
Ringbuffer size
EXCELON
EN2B-0210 GE51 R0405 124
LON default settings 31 Router
access state 46 alg 45 algorithm 45 buffers far 47 buffers near 47 channel ID far 46 definition 103, 111 mode 45 nodes with 34 properties 45 routing EEPROM 46 routing RAM 46 set EXCEL 5000 compliance 48 statistics 46 status 46
Router Alg definition 111
Router mode definition 111
router_firmware_version_mismatch software error code 97
Routing EEPROM router 46
Routing RAM router 46
Rpt timer address table entry 40 definition 111
Rx error node diagnostic 65
Rx errors(%) node 21
Rx messages/sec node 21
Rx msgs node diagnostic 65
Rx timer address table entry 40 definition 111
S S/N
node diagnostic 64 Save
diagnostic record 87 LON file 87 record 87 submenu 24
Save as submenu 24
Save LON file toolbar icon 25
Scan domain 81
Scan Lon network on startup default settings 30
SCPT definition 111
SCPTs 67 Search for Lon Nodes
sub menu 24 Search for nodes 33
toolbar icon 25
Search nodes also on zero domain default settings 30
Segment definition 111
Selector definition 112
Self doc NV 68
Self documentation string node properties 36
Self documentation string definition 111 NV 20
self_inst_semaphore_set software error code 97
self_test_failed software error code 97
Send service pin 63 sub menu 24
Sender packet 22, 78
Service definition 112 NV 68 packet 80
Service pin add node by pressing 34 definition 113 send 63
Service type alias 43 definition 112 NV 20 packet 22, 78
Set domain 12, 14, 15, 38 filters 82 node offline 35, 62 node online 35, 62 node unconfigured 35 tree view 27
Set domain of network interface sub menu 24
Settings sub menu 25
Show channels in tree submenu 27
Show Channels in Tree submenu 24
Show neuron ID in tree submenu 29
Show Neuron ID in Tree submenu 24
Show programs in tree submenu 28
Show Programs in Tree submenu 24
Size buffers 44 CP 55 NV 20, 68
SNVT definition 113 type of NV 68
SNVTs 20, 67 Software error code
EXCELON
125 EN2B-0210 GE51 R0405
already_preempted 95 appl_cs_error 96 appl_signature_bad 97 authentication_mismatch 97 bad_address_type 95 bad_event 94 Checksum error over system image 97 cnfg_cs_error 96 divide_by_zero 96 EEPROM recovery occured 97 eeprom_write_fail 95 illegal_send 96 incomplete_msg 95 invalid_addr.table_index 95 invalid_appl_error 96 invalid_domain 95 invalid_nv_index 96 invalid_resp_alloc 95 invalid_xcvr_reg_addr 96 io_ready 96 memory_alloc_failure 96 no_msg_avail 95 nv_length_mismatch 95 nv_msg_too_short 95 nv_update_on_output_nv 95 preemption_mode_timeout 95 read_past_end_of_msg 95 read_write_semaphore_set 97 router_firmware_version_mismatch 97 self_inst_semaphore_set 97 self_test_failed 97 State byte semaphore 97 subnet router 97 sync_nv_update_lost 95 Triac clockedge + - not supported 97 unknown_PDU 96 write_past_end_of_appl_buffer 96 write_past_end_of_msg 95 write_past_end_of_net_buffer 96 xcvr_reg_timeout 96
Software error code downlink_mip_transfer_lost 94
Software error codes 94 Sort
network variables 69 nodes 65
Source node 81 packet 80
Source node find 81
Search all 1-Byte domains sub menu 24
Standard program ID definition 113
Start Excelon 11 LonTalk Protocol Analyzer 78
State byte semaphore software error code 97
Statistics backlog overflows 42 clear 42, 62 clear 62 clear of node 35 collisions detected 42
comm. ratings 42 CRC errors 42 EEPROM lock 42 last error logged 42 last reset cause 42 late acks or responses 42 lost msgs (no app buff) 41 messages transmitted by node 41 missed msgs (no net buff) 41 node 41 node properties 41 packet errors detected (CRC) 41 packets addressed to node 41 packets received by node 41 receive errors 42 receive trans full errors 41 refresh 42 router 46 transaction timeouts 41 transmission retries 42 transmit. errors 42
Status router 46
Status bar action 23, 77 actual packet count/sec 23, 77 average packet count/sec 23, 77 detected devices 23 last updated NV 23 network interface and driver status 23, 77 NV 23 submenu 24 total packet count 23, 77
Submenu show channels in tree
submenu 27 show neuron ID in tree
submenu 29 show programs in tree
submenu 28 Subnet 12, 14, 15, 38
definition 113 Subnet broadcast
definition 105 Subnet ID
definition 113 node 21
subnet router software error code 97
Subnet/Node ID 21 Switch
to domain 16 to this domain 81
Sync definition 113 NV details 75
sync_nv_update_lost software error code 95
System requirements 7
T Tag
packet 22, 78 Tags number
node properties 36
EXCELON
EN2B-0210 GE51 R0405 126
Target definition 113
Technical address 113 definition 113
Terminate license 11 Time stamp
packet 78, 80 Timer settings
node 40 Timestamp
packet 22 Tool bar
submenu 24 Toolbar 18, 25
add node to network tree (icon) 25 clear pane (icon) 26 Connect/disconnect Excelon (icon) 25 display hidden columns (icon) 26 display version and copyright (icon) 26 enable/disable polling (icon) 26 hide columns (icon) 26 invoke W.O.C. dialog (icon) 26 open LON file (icon) 25 Open network interface settings dialog box (icon) 25 reload current values (icon) 26 restart measurement of all nodes (icon) 26 save LON file (icon) 25 search for nodes (icon) 25
Total memory buffers 44
Total messages/sec node 21
Total msgs node diagnostic 65
Total packet count status bar 23, 77
Transaction timeout definition 113
Transaction timeouts node statistics 41
Transmission retries statistics 42
Transmit transaction buffers 44 definition 113
Transmit. errors statistics 42
Transport parameter node 40
Tree view set 27
Triac clockedge + - not supported software error code 97
Turnaround definition 113 NV details 76
Tx error node diagnostic 65
Tx errors(%) node 21
Tx messages/sec node 21
Tx msgs node diagnostic 65
Tx timer address table entry 40
definition 113 TxNo
packet 80 Type
buffers 44 CP 53 node diagnostic 64 NV 20
U UCPT
definition 114 UCPTs 67 Unacknowledged and not repeated
definition 112 Unconfigured
node status 32, 37 set node 62
Unconfigured device definition 113
Unicast definition 114
unknown_PDU software error code 96
Unselected filter criterion 83
UNVT definition 114
UNVTs 67 Update
network variables 73 Update rate
NV 20 Upload
nodes 31 User address mapping
submenu 25
V Value
NV 68 Value (raw)
CP 55 View
24 details of network variable 74 packet details 79 Show Channels in Tree (submenu) 24 Show Neuron ID in Tree (submenu) 24 Show Programs in Tree (submenu) 24 status bar (submenu) 24 submenu 24 toolbar (submenu) 24
VNI 23 VNI mode 77
definition 114
W Watch
network variable 70 Watch all NVs 69 Watch bound NVo values
EXCELON
127 EN2B-0210 GE51 R0405
LON default settings 31 Watch foreign NV fetches
LON default settings 31 Watch this NV 69 Web
menu 25 user address mapping (submenu) 25
Wink definition 114 send to node 63 to node 35
Write protected CP 55
write_past_end_of_appl_buffer software error code 96
write_past_end_of_msg software error code 95
write_past_end_of_net_buffer software error code 96
X xcvr_reg_timeout
software error code 96 XFL module
configure 55 XFL521B
configure 55 XFL522B
configure 57 XFL523B
configure 59 XFL524B
configure 61 XIF
definition 114 XIF file
download 50
Z Zero-domain
definition 114
Automation and Control Solutions Honeywell International Inc. Honeywell Limited-Honeywell Limitee Honeywell AG 1985 Douglas Drive North 35 Dynamic Drive Böblinger Straβe 17 Golden Valley, MN 55422 Scarborough, Ontario M1V 4Z9 D-71101 Schönaich USA Canada Germany http://www.honeywell.com http://www.honeywell.ca http://europe.hbc.honeywell.com EN2B-0210GE51 R0405 printed in Germany Subject to change without notice