WattNode® BACnet® Firmware Upgrade with Tridium® Niagara® WorkPlaceAX

Overview

This article describes how to upgrade the firmware on a WattNode® BACnet® (WNC series) using the Tridium Niagara WorkPlaceAX (formerly called Workbench, part of the AXSupervisor software package). This assumes you are familiar with the WorkPlaceAX software and that the WattNode BACnet meter is already installed on the JACE.

The following table lists each available firmware upgrade and its file size, checksum and MD5 hash which can be used to verify that you received the proper firmware image file intact. Use BACnet-1.04to1.13.bin if you are upgrading from a firmware version earlier than 1.10. If you are upgrading from 1.10 or a later version, use BACnet-1.1xto1.13.bin.

Firmware File File Size
(bytes)
Checksum MD5 Hash Status
BACnet-1.04to1.13.bin 75024 3442439853 ed17e89366946f3848d6f72b83f334f8 Current
BACnet-1.1xto1.13.bin 74944 856368332 d060a874398d1f7ec7d871fdac3a91ea Current
BACnet-1.04to1.10.bin 71440 1458336085 2d5d55e2ee721d388de342efcdc5a024 Obsolete

Baud Rate

This procedure has been tested with baud rates of 38,400 and 76,800. At 38,400 baud, the file write time is approximately 45 seconds. File writes that take more than one minute may result in Station Timeout on the JACE unless the timeout is adjusted. Therefore, baud rates of 9,600 and 19,200 are likely to time out.

Procedure

Obtain the Firmware Image

The latest firmware image can be obtained from Continental Control Systems technical support. Copy the supplied file to a local PC or memory card. In this example the code is stored on a memory card as I:BACnet-1.04to1.10.bin.

NOTE – V1.03 WattNode meters do not support field firmware upgrading and must be returned to the factory to be upgraded.

Transfer the Firmware Image File to the JACE

Copy I:BACnet-1.04 to 1.10.bin to the Station > Files directory using the Nav sidebar as illustrated in Figure 1, where the red line indicates the “drag-and-drop” mouse action that transfers the file from the source directory on the computer file system to the destination folder on the JACE.

FileToStation.PNG

Figure 1: Store firmware file to Station File folder

Select the Meter to Update

In this example a WNC-3Y-208-BN, SN 60813, shown in Figure 2 will be updated.

  • Under this device folder (Station > Config > BacnetNetwork > WNC-3Y-208-BN, 60813) double-click on Config to open the Bacnet Config Manager:
Bacnet ViewConfigManager.PNG

Figure 2: Bacnet Config Manager

Add the “BACnet Firmware Image” File Object

  • In the Bacnet Config Manager click on the Discover button (labeled 1 in the figure).
  • Wait for the device objects to be discovered. The device objects will appear in the Discovered window.
  • Scroll down to the end of the list to find the file object BACnet Firmware Image at the bottom of the list.
  • Click to highlight BACnet Firmware Image.
  • Then right-click and select Add (labeled 2 in the figure).
  • In the Add popup accept the defaults by clicking OK.
BacnetConfigManager Discover2.PNG

Figure 3: Discover and Add “BACnet Firmware Image” to Database

Enable File Write

Enable object file write for BACnet Firmware Image as described in the steps below and illustrated in Figures 7, 8 and 9.

  • In the Nav pane, expand the Config folder (1).
  • Right-click on the BACnet Firmware Image (2).
  • Select Views (3)
  • Select Slot Sheet (4)
Bacnet ViewSlotSheet.PNG

Figure 7: Open Slot Sheet

  • In the Slot Sheet window right-click the writeFile slot and click Config Flags:
BacnetConfig SlotSheet2 whole.PNG

Figure 8: Change WriteFile Flags
In the Config Flags popup click Hidden to remove the check mark then click the OK button.

BacnetConfig SlotSheet3 whole.PNG

Figure 9: Config Flags

Setup File Location

Add the location of the file to be downloaded to the BACnet Firmware Image as described in the following steps and illustrated in Figures 4, 5 and 6.

  • In the Nav pane, under Config, right-click on BACnet Firmware Image, and select Views > Property Sheet.
Bacnet Config ViewSheet.PNG

Figure 4: Open File Object Property Sheet

  • On the line labeled File Ord, click on the small triangle pointing down at the far right.
  • Select File Ord Chooser from the pop up.
BacnetConfig PropertySheet2.PNG

Figure 5: Configure File Location into BACnet Firmware Image
The File Chooser dialog popup will appear.

  • Select the file to be downloaded from the Files on Station directory and select Open.
  • Click on Save in the Property Sheet.
BacnetConfig PropertySheet3.PNG

Figure 6: File Chooser

Set the File Size

These steps are only required when upgrading from firmware versions V1.04 or V1.04A. When upgrading from version V1.10 or later, you can skip setting the file size and proceed directly to update the firmware.

  • On the BACnet Firmware Image property sheet, in the File Size box enter the file size based on the version of firmware being installed as shown in the table at the top of this page (e.g. for BACnet-1.04to1.13.bin, enter 75024).
  • Press Enter or click the Save button.
  • The File Size may read back as zero indicating the internal memory is being prepared for the new image.
  • When ready for file download the File Size will read back (click Refresh button) as the entered File Size. This may take up to fifteen seconds if a previous file download had been attempted.
  • If you are unsure the new file size has been written correctly, you may enter it again.
Bacnet FileSize.PNG

Figure 10: Set File Size

Update Firmware

Proceed to update the firmware in the WattNode by writing the file as described in the following steps and illustrated in Figures 11 and 12.

  • In the Nav pane, under Config, right-click on BACnet Firmware Image and select Actions > Write File.
Bacnet ActionsWriteFile.PNG

Figure 11: Write File to Device

  • In the Write File popup click OK to start file write:
Bacnet WriteFilePopup.PNG

Figure 12: Write File Popup

  • The file write will begin and the mouse will show a busy icon.
  • At baud rate of 38,400 it will take approximately 45 seconds for the transfer. At 76,800 baud, it takes about half as long.
  • Once the firmware has been transferred to the WattNode meter, the meter will reprogram itself, which takes anywhere from 5 to 30 seconds (depending on which version you are upgrading from), during which the WattNode LEDs will transition through several different color and flashing patterns. At the end of a successful upgrade, the normal green flashing will resume. Interrupting line power during the upgrade will leave the firmware partially programmed, requiring that the meter be returned to CCS for reprogramming.
  • After the upgrade is complete, if you check ErrorStatus1, you may see the INFO code 1032, which indicates that the meter completed a reboot following a firmware upgrade.

Retry

If you get a “Write File” error, there are a couple of possible causes:

  1. The file size is incorrect.
  2. The WattNode meter was busy erasing the flash memory it needs to store the new firmware image

If this happens, try writing the file size again; wait 20 seconds; then try the “Write File” operation again.

Troubleshooting

  • If the LEDs stay off or are very dimly lit after the upgrade, then the firmware has become corrupted and the meter will need to be returned to CCS for reprogramming.
  • When upgrading from V1.04 or V1.04A, if file size is set too small or too large, the file download will fail. The firmware will not be updated.
  • If the file download takes longer than one minute (programming at 9600 baud or 19200 baud) the JACE will terminate the file write.

Update Changed Objects

IMPORTANT NOTE: If you are upgrading from 1.04 or 1.04A to 1.10 (or later), the list of objects has changed and some properties have changed (see WattNode BACnet Object Changes V1.10). If you are using ANY of the affected objects, you must rediscover or update your templates.

There are three types of discovery for BACnet objects using the JACE.

  1. From the Bacnet Device Manager, the Discover button will scan the devices on the network.
    • This will also read the “Firmware Rev” and update it for any updated devices. Use this to verify that the upgrade completed successfully.
  2. From the “Bacnet Point Manager” for a given BACnet device, like the WattNode, the Discover button will scan the objects and properties within a device. You should use this to update the points for a WattNode after performing a firmware upgrade.
    • You may either delete all the existing points and replace with the newly discovered points.
    • Alternatively, you may delete only the affected objects (see WattNode BACnet Object Changes V1.10); then perform Discover and add back in the objects you want.
  3. From the “Bacnet Config Manager” for a given BACnet device, like the WattNode, the Discover button will scan the objects and properties within a device. You should use this to update the configuration points for a WattNode after performing a firmware upgrade.

Verify Firmware Update

Once you have discovered the upgraded WattNode meter and variables, there are at least two places you can look to verify the new firmware version:

  1. From the Nav pane, double-click BacnetNetwork to open the Bacnet Device Manager, which will show the “Firmware Rev” for all the devices.
  2. From the Nav pane, under BacnetNetwork, expand the meter you just upgraded, then expand the Config node, and double-click the Device Object. This will bring up all the device object properties, which include “Firmware Revision”.

See Also