Getting Started

Installation

Installing Spyder tool in Soft JACE - Installer EXE Method

  1. Install Java Runtime Environment (JRE) v1.6 on your system, if not installed already as the installer program requires JRE 1.6.
  2. Stop all running stations and close the workbench. Close any other application accessing the jar files from the NiagaraHome\modules folder.
  3. Browse to the location of the release folder of the tool.
  4. You will find the Installer file called LonBacnetInstaller<versionNo>.exe.
  5. Double click the installer executable file.
  6. License agreement screen appears, read the license agreement and accept it to proceed with the tool installation.
  7. An installation screen appears. The installer detects the current NiagaraHome path and displays it on the screen. If there are more than one Niagara versions installed, the installer picks the higher version. You can change the path to install the jar files using the Browse button next to the WEBs-N4 Home option.
  8. Click Install for the Installer to start the Installation. The installer installs the required jar files in the Niagara modules folder. As the installation proceeds, the installation status is displayed. After the installation is complete, Install Status text in the screen changes to Installation complete and the progress bar indicates 100% completion.
  9. Please see the Installation instructions section in the SRB for more details on the installation procedure.

Note: Existing applications created with versions earlier than 4.xx of the tool need to be migrated using Spyder Migration tool to be compatible with the current version of the tool. See Using Spyder Migration Utility section for information on the migration procedure

Upgrading Hard JACE

You must stop the station running on the JACE and start the workbench before you start upgrading the hard JACE.

  1. Select the dist_JACE_Lon_Bacnet_Spyder.dist file.
  2. Run the file using Niagara Platform’s Distribution File Installer option. The Distribution File Installer installs the required modules in the JACE.

From this release, the following .jar files alone are required:

To free up JACE memory, old, unused .jar files such as the following can be deleted:

Note: Existing applications created with earlier versions of the tool need to be migrated using Spyder Migration tool to be compatible with the current version of the tool.

After installing the new tool version in the JACE, you can migrate the existing Spyder applications in the JACE using the following procedure.

  1. Copy the station running in the JACE to your local PC using the Station Copier option available in the Platform options of the JACE.
  2. Migrate the copied JACE station using the Spyder Migrator tool. See Using Spyder Migration Utility section for information on Spyder Migration tool.
  3. Copy the migrated station back to the JACE using the Station Copier option and restart the JACE.

Using Spyder Migration Utility

Use the honeywellSpyderMigrator.jar to run the migration utility.

To migrate the existing applications:

  1. Launch the workbench after installing the migration tool through the dist file.
  2. Browse to the migration utility on the main menu of the workbench.
  3. Click the migration utility option from the list. The tool allows you to migrate various types of databases.
  4. Select the File Type and then select the Niagara Home Directory where that particular database is stored. The tool automatically lists all the files of the selected file type available in the directory, as shown in the screenshot.
  5. Select the files to be migrated and click Migrate.
  6. Once the migration is completed, click Close to close the migration utility window.

The tool automatically moves the selected existing stations to a folder called LegacyStations. The migrated Stations are given the actual station name so that they are ready to be used. Similarly, the tool moves the existing Lexicon files to a folder called LegacyLexicons and it renames the migrated Lexicon files with the names of existing files.

For other file types, you can choose the Output directory where you want the migrated databases to be stored. By default the tool stores them in a folder by name Migrated<FileType> where FileType is the file type that you have selected for migration. This new directory is created under the input directory.

For example, if the file type selected for migration is of type SpyderLibrary, and the existing library is available in the location C:/Library, then the migrated libraries are stored in C:/Library/MigratedLibraries.

Note:

Launching the Workbench

Click Start > Programs > Niagara > Workbench to launch the workbench.

Adding New Station

On the Workbench:

  1. Click Tools > New Station. The New Station Wizard appears.
  2. Type the Station Name.
  3. The Station Directory path is updated with the name you just entered and displays the location where the files are stored. Click Next.
  4. Type a password in the Admin Password field.
  5. Re-type the same password in the Admin Password Confirm field.
  6. Click Finish to complete adding a station. The station is added and the Property Sheet of the station is displayed on the right portion of your screen.

Starting the Station

Once you have added a station, you must start it to begin using it. To start a station:

  1. On the Nav palette, click Platform. The Authentication dialog box appears.
  2. Note: If the Nav palette is not visible on the left pane, from the Menu bar, select Window > Sidebars > Nav to display the Nav palette.

  1. Type the User Name, Password, and click OK. The right portion of your screen displays a list of object names and their description.
  2. Double-click Application Director. The list of available stations appears.
  3. Select the station you have added and click Start. The station you have added appears in the Nav palette under Platform.
  4. Double-click the Station option on the Nav palette. The Authentication dialog box appears.
  5. Type the User Name and Password and click OK. The Station you have added is launched and the Station Summary Property view appears on the right portion of your screen.

Adding a Network

To add a Lon Network:

  1. Click Windows > Side Bars > Palette to add the palette named Palette if it is not visible on the left pane.
  2. Click the Open Palette button on the Palette. The Open Palette dialog box appears.
  3. Select Lonworks from the list if available and click OK.
    or
    Click Browse and select the location this folder is stored and click OK.
  4. Expand Config in the Nav palette to display Drivers.
  5. Select LonNetwork from the Palette and drag it on Drivers in the Nav Palette.
  6. Type a name for the Lon Network you are adding and click OK.
    Expand Drivers and verify to see that the Lon Network is added.

To add a BACnet Network:

  1. Click Windows > Side Bars > Palette to add the palette named Palette if it is not visible on the left pane.
  2. Click the Open Palette button on the Palette. The Open Palette dialog box appears.
  3. Select bacnet from the list if available and click OK.
    or
    Click Browse and select the location this folder is stored and click OK.
  4. Expand Config in the Nav palette to display Drivers.
  5. Select BacnetNetwork from the Palette and drag it on Drivers in the Nav Palette.
  6. Type a name for the BACnet Network you are adding and click OK.
    Expand Drivers and verify to see that the BACnet Network is added.

Adding a Controller

To add a Honeywell Spyder controller:

  1. Click the Open Palette  button on the Palette. The Open Palette dialog box appears.
  2. Select honeywellSpyderTool from the list if available and click OK.
    or
    Click Browse and select the location this folder is stored and click OK.
  3. Select  LonSpyder from the Palette and drag it on Lon Network under Drivers in the Nav palette.
    or
    Select BacnetSpyder from the Palette and drag it on BacnetNetwork under Drivers in the Nav palette.
  4. Type a name for the device you are adding and click OK.
    Expand Lon Network or Bacnet Network and verify to see that the device is added.

Viewing or Modifying Controller Summary Details

To view or modify the summary details of the LonSpyder controller:

  1. Double-click the device name in the Nav palette to display the Controller Summary View on the right portion of your screen.
    Device Name is an editable field.
  2. Click the drop-down menu to select a Device Model from the list.
  3. Select Enable Daylight Savings option and specify the following information when the day light savings must come into effect:
  4. Click Save to save the changes made to the Controller Summary View.

To view or modify the summary details of the BacnetSpyder controller:

  1. Double-click the device name in the Nav palette to display the Controller Summary View on the right portion of your screen.
    Device Name is an editable field.
  2. Click the drop-down menu to select a Device Model from the list.
  3. Click the Set button to change the Global Update Rate.
  4. Note: Setting the Global Update Rate changes all the individual update rates including the update rates for Network Input points, Analog Outputs, Binary Outputs that are enabled for Fail Detect. Global Update Rate has a default value of 60 seconds. The value can range from 0-3600 seconds.

  5. Click the Set button to change the Global Send Heart Beat.
  6. Note: Global Send Heart Beat is set at the device level and the changes made to this value is applied automatically to all the objects. Global Send Heart Beat has a default value of 60 seconds. The value can range from 0-3600 seconds.

  7. Select Enable Daylight Savings option and specify the following information when the day light savings must come into effect:
  8. Click Save to save the changes made to the Controller Summary View.

Migration

From Spyder II to Spyder Micro

If you want to migrate from any of the earlier LonSpyder models, that is, Spyder I (PVL6436A, PVL6438N, or PUL6438) and Spyder II ( PVL6436AS, PVL6438NS, or PUL6438S) to the latest Lon models supported by Spyder, that is Spyder Micro (PVL4024NS, PVL4022AS, PUL4024S, PUL1012S, or PVL0000AS), do the following:

  1. Replace the existing Spyder controller in the field (could be any one of  the Spyder I or Spyder II models) with the new Spyder  Micro controller.
  2. Right-click the Lon network in the Nav palette of the Spyder tool.
  3. Select Views > Lon Device Manager. The list of controllers is displayed on the right portion of the screen.
  4. Select the controller from the list and click Discover. The device appears under Discovered on the top portion of the screen.
  5. Select the controller under Discovered and click Add to add the controller.
  6. Click OK.
  7. Click Match to match the neuron id of the field controller with the device in station.
  8. Select the new model you are migrating to in the Controller Summary View (right-click device in the Nav palette and choose Views > Controller Summary View).
  9. Load an application from the Spyder library.
  10. Download the configuration to the new Spyder Micro controller model by right-clicking the device and selecting Actions > Download.

From LonSpyder to BacnetSpyder

If you want to migrate from any of the LonSpyder models ( Spyder I, Spyder II, or Spyder Micro) to the Bacnet models (PVB6436AS, PVB6438NS, or PUB6438S) supported by Spyder, do the following:

  1. Replace the existing LonSpyder controller in the field (could be any one of  the Spyder I, Spyder II, or Spyder Micro models) with the new BacnetSpyder controller.
  2. Right-click the Bacnet network in the Nav palette of the Spyder tool.
  3. Select Views > Bacnet Device Manager. The list of controllers is displayed on the right portion of the screen.
  4. Select the controller from the list and click Discover. The device appears under Discovered on the top portion of the screen.
  5. Select the controller under Discovered and click Add to add the controller.
  6. Click OK.
  7. Click Match to match the neuron id of the field controller with the device in station.
  8. Select the new model you are migrating to in the Controller Summary View (right-click device in the Nav palette and choose Views > Controller Summary View).
  9. Load an application from the Spyder library.
  10. Download the configuration to the new Spyder Micro controller model by right-clicking the device and selecting Actions > Download.

You can use Bacnet Spyder in one of the following ways.

To create a Bacnet Spyder application:

  1. Drag a BacnetSpyder device to the station under a Bacnet Network.
  2. Double-click the device you have added and right-click on it to choose Views > Controller Summary View.
  3. Select a model from the list.
  4. Browse to the ControlProgram of the BacnetSpyder device.
  5. Drag the required objects from honeywellSpyderTool palette and create an application.
  6. Browse to Bacnet Device Manager view on Bacnet Network and discover the online Bacnet Spyder devices.
  7. Match the device in Niagara to appropriate discovered device.
  8. Note: Alternately, instead of creating an application you can load a suitable application from Spyder library or from Standard Applications Library in palette.

  9. Download the configuration to the online device using Download option on the device.

To use an existing Lon Application in a BacnetSpyder device:

  1. Drag a BacnetSpyder device to the station under a Bacnet Network.
  2. Double-click the device you have added and right-click on it to choose Views > Controller Summary View.
  3. Select a model from the list.
  4. Browse to the ControlProgram of the BacnetSpyder device.
  5. Drag an existing Lon Application from Spyder Library to the Control Program under the BacnetSpyder device. The tool automatically creates a Bacnet interface for the Lon application. ( If it is an application in library, the tool would have automatically created the Bacnet interface in library ). Review the Bacnet interface that the tool has created and make necessary changes, if any.
  6. Browse to Bacnet Device Manager view on Bacnet Network and discover the online Bacnet Spyder devices.
  7. Match the device in Niagara to appropriate discovered device
  8. Download the configuration to the online device using Download option on the device.

From Conventional wall module to SBus wall module

If you want to replace the existing conventional wall module (T7770) with the SBus wall module, do the following:

  1. Replace the existing Spyder controller in the field (could be any of LonSpyder I models: PVL6436A, PVL6438N, or PUL6438 ) with a new LonSpyderII, or Spyder Micro, or  BacnetSpyder controller.
  2. Right-click the Lon or Bacnet network in the Nav palette of the Spyder tool.
  3. Select Views > Lon Device Manager or Bacnet Device Manager. The list of controllers is displayed on the right portion of the screen.
  4. Select the controller from the list and click Discover. The device appears under Discovered on the top portion of the screen.
  5. Select the controller under Discovered and click Add to add the controller.
  6. Click OK.
  7. Click Match to match the neuron id of the field controller with the device in station.
  8. Select the new model you are migrating to in the Controller Summary View (right-click device in the Nav palette and choose Views > Controller Summary).
  9. Download the configuration to the new Spyder controller model.
  10. Replace the existing wall module model to any one of the SBus wall module models (same as hardware attached).
  11. Drag the ConventionalWallModule function block from the Palette onto the wiresheet of the controller.
  12. Right-click the conventional wall module block and select Configure Properties. The General Settings dialog box appears.
  13. Select LCD Display under Model Options on the dialog box. This changes the wall module selection from Conventional to S-Bus wall module.
  14. Make appropriate links in the wire sheet of the application logic where the wall module is being used.
  15. Download the configuration to the controller.

Note: Make sure that the SBusWallModule should be assigned the same address using rotatory Address switch as defined in the SBus wall module function block in Station.

Programming the Honeywell Spyder

The Honeywell Spyder Tool offers a graphical environment to program the Honeywell Spyder controller. You can use the wiresheet view in the Engineering Mode to use Physical points, Software points, and function blocks to build an application in the ControlProgram. The Physical points, Software points, and function blocks can be accessed using the Palette. You can drag these items on to the wiresheet and connect them, based on your need, to develop your application logic. The logic that you create can then be stored in a Spyder Library for reuse. Once you are satisfied with the logic you have created, you can download the same to the controller. The logic thus created can be tested for correctness using the Simulation and Online Debugging modes.

Note: Changing NCI values, configuration of a Schedule block, or Daylight savings option, puts the application in a quick download pending state. As long as the application has been downloaded atleast once to the controller, these changes only trigger a quick download to the controller.

Use the ControlProgram option to program the Honeywell Spyder tool. To do this:

The Palette appears on the left pane with the following items:

You can drag any of these items on to the wiresheet of a ControlProgram in its Engineering Mode and make the connections between Physical points, Software points, and function blocks to create a ControlProgram or an Application.

Use this wiresheet view to drag the Physical points and Function blocks to build your application logic. You can save a logic you created to be used later and also share it with other users.You can build several applications and store them in a Spyder Library along with Honeywell supplied standard applications.

Downloading Application Logic

After you have created your application logic and tested the logic using the simulation feature, you can download the application logic to the controller. To download the application logic:

  1. On the Nav palette, right-click the device and select Actions > Download. The Download dialog box appears.
  2. Select True under Full Download for a full download or False for a quick download.
  3. Note: A Quick Download only downloads the modified items from a previous download where as with a Full Download the entire configuration is downloaded to the controller replacing the existing configuration. However, if changes have been made to the SBus wall module by an operator/tenant locally from the display on the wall module, and a full download is performed, Spyder tool downloads the entire configuration to the controller except the SBus wall module configuration. This is done to avoid losing any changes made locally on the SBus wall module during a download operation.

  4. Click OK. The application logic is downloaded to the controller based on your selection.

Note: Make sure that if you are using the SBus wall module or the ignore invalid option for function blocks , the models selected are LonSpyder II, Spyder Micro, or BacnetSpyder. SBus wall module cannot be downloaded to the LonSpyder I models.

When using Spyder II, Spyder Micro, or BacnetSpyder models, if you modify SBus wall module settings from the display in the wall module, you can also upload the same configuration into the Spyder tool.

Updating Modules

Follow this procedure to install updates of Standard Applications. The StandardApps.jar file that you receive, needs to be installed to begin using the latest Standard Applications provided.

  1. Connect to the platform of the station.
  2. Browse to File transfer Client and transfer the StandardApps.jar file from the local drive to the modules folder of the Station.
  3. Restart the workbench or webworkbench.
  4. Expand StandardApplications in the Spyder palette. The latest Standard Applications are displayed.

Creating Custom Palette File