Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

For SmartServer 3.3 and prior releases, see Testing Devices (Release 3.3 and Prior). 

You can test provisioned devices to confirm they are operating correctly.

This page consists of the following sections:

Identifying and Testing a Device

You can use the following actions to identify and test a provisioned device using the Devices widget:

  • Wink – sends a command to the device to perform a device-specific identification operation such as blinking a light on the device. 

  • Test – sends a command to the device to test communication with the device and report key operational statistics for the device.

To perform these verification routines, perform the following steps:

  1. /wiki/spaces/TEMP/pages/44041710.

  2. Open the Devices widget, EDGE DEVICES tab.




  3. Click the Expand button (  ) on the top right of the widget to view all the available information.

  4. Click the Action button () and then select the Wink or Test action.



    For Wink, if the device supports winking, then the device documentation will specify how the device responds to a wink request.

    For Test, the test results appear similar to the example shown below.




  5. To set up another test, scroll down and use the Count slider to set how many times the test will be performed, and then click START.



    An example of the Test results are shown below.




  6. Click CLOSE to exit testing, or set up another test and then click START.

Displaying Device Information

Device State Colors

The SmartServer CMS uses colors to differentiate device states:

  •  Purple represents unlicensed devices. Operations that require communication with a physical device (such as provisioning, reading datapoints, and writing datapoints) will be disabled for unlicensed devices. Operations that do not require device communication (such as creating devices, defining datapoint properties, defining connections, defining BACnet Server configuration, setting up schedules, and defining sequences) will be enabled for both licensed and unlicensed devices. If the device capacity is increased by the addition of a new capacity license, then unlicensed devices will be changed to a licensed device status up to the number of licensed devices enabled by the new device capacity. License management is available with SmartServer 3.3 and higher. See Manage Licenses for more information. 

  •  Blue represents devices that are deprovisioned.

  •  Blue with green spinner represents devices that are being provisioned, or have failed to provision. If this state persists (i.e., for more than 15 minutes), then try re-provisioning the device.

  •  Green represents devices that are provisioned.

  •  Green with red ring represents devices with marginal health status indicating that a failure was reported by the device, typically during provisioning (i.e., the device could be reached but it would not provision due to an error unrelated to communication). For drivers that implement marginal state, this device state is available with SmartServer 3.2.

  • Yellow represents provisioned devices that are not communicating (suspect state).

  •  Red represents provisioned devices that are down.

  •  Light grey represents devices in a pending or failed XIF/creation state.
    • Pending creation state is represented with a temporary light grey color that indicates device creation is in progress and then transitions to blue when the device is loaded. Device creation time will vary depending on the complexity of the devices and the load, but typically finishes within a few minutes.
    • Failed XIF state is represented by a permanent light grey color. In this case, a yellow banner notification will appear at the time of XIF import reporting a problem (requires that notifications are enabled, see Setting Notifications in the /wiki/spaces/TEMP/pages/44631776 section). 
    • Failed creation state is also represented by a permanent light grey color. This state can be resolved by deleting and re-creating the device.

  •  Dark grey represents devices in a pending delete state.

    Light grey and dark grey states only appear if the device is added or deleted using the SmartServer CMS or REST API. These states do not appear if devices are added or deleted using MQTT.

Device Selection Visual Reset

Following a SmartServer IoT upgrade or re-image, if the Devices widget displays a "globe" device (), then you will need to clear the web browser data. The appearance of this device visual is due to cached data from the previous version. 

How to clear cached data

Showing a Device on the Map

To show a device on the map (Locations widget), perform the following steps:

  1. /wiki/spaces/TEMP/pages/44041710.

  2. Open the Devices widget, EDGE DEVICES tab.



  3. Click the Action button () for the desired device and select the Show on Map action.



    The device will appear on the Locations widget (a floor plan in the example below). If the Locations widget is not already displayed on the dashboard, a prompt will appear to confirm opening the Locations widget.

Showing Device Properties

To show device properties, perform the following steps:

  1. /wiki/spaces/TEMP/pages/44041710.

  2. Open the Devices widget, EDGE DEVICES tab.



  3. Click the Action button () and select the View All Properties action.



    A table with all of the devices and their properties is displayed.



          For LON, LON PL, BACnet, and Modbus devices, the following properties may be displayed:

    • Name

    • Category

    • UID

    • Firmware Version

    • Asset Tag

    • Description

    • Installation Date

    • Latitude

    • Longitude
    • SID/UID

  4. Click BACK to return to the Devices widget view.

Viewing Device Datapoints

For SmartServer 4.0, Viewing device datapoints from the Devices widget is not available. To view device datapoints, use the Datapoints widget.

Viewing device datapoints from the Devices widget, EDGE DEVICES tab, displays the following information:

The datapoint information that is displayed is a cached value.

  • Device
  • Block name
  • Block index
  • Datapoint name
  • Value
  • Preset

To view device datapoints, perform the following steps:

  1. /wiki/spaces/TEMP/pages/44041710.

  2. Open the Devices widget, EDGE DEVICES tab.



  3. Click the Action button () for the desired device and select the View Datapoints action.



    Or, to view datapoints for all devices, click the Action button () and select the View All Datapoints action.



    The device datapoints (cached values) are displayed.


    Device datapoints view for a single device


    Device datapoints view for all devices

  4. Use the scroll bar to view all of the device datapoint information.

    More information about using the Datapoints widget appears in the sections below.

  5. Click BACK to return to the Devices widget view.

Resetting a Device

To reset a device, perform the following steps:

  1. /wiki/spaces/TEMP/pages/44041710.

  2. Open the Devices widget, EDGE DEVICES tab.



  3. Click the Action button () for the desired device and select the Reset action.



    Or, to reset selected devices, click the devices (a checkmark will appear), and then click the Action button () and select the Reset Selected action.



    Or, to reset all devices, click the Action button () and select the Reset All action.



    The selected device(s) is reset. If a device that does not support reset operations was selected, then an error message will appear in the upper-right corner similar to the example below.


  • No labels