(Optional) Add an EnOcean Interface (Release 4.1 and Prior)

EnOcean devices are supported with SmartServer 4.0 and higher.

For SmartServer 4.2 and higher, see (Optional) Add an EnOcean Interface.

You can use the SmartServer to integrate and manage EnOcean devices. To set up and use EnOcean with the SmartServer, follow these steps:

  1. Add an EnOcean network interface as described on this page.
  2. Download, download and modify, or create an EnOcean device interface (XIF) and device type definition as described on this page.
  3. Define datapoint properties for any datapoints to be monitored or logged as described in Setting Datapoint Properties.
  4. Define or discover, and provision devices as described in Site Provisioning.  See the following sections on this page for step-by-step examples:
  5. To optionally provide a BACnet interface for your EnOcean device see Setting up the BACnet Server.  This enables you to use a BACnet workstation with your EnOcean device.

This page includes the following sections:

Adding an EnOcean Network Interface

To add support for communicating with EnOcean devices, attach an EnOcean USB network interface to your SmartServer as described in USB 300, 300U, 400J, and 500U EnOcean Network Interfaces.

Downloading and Creating EnOcean Device Interface (XIF) and Device Type Definitions

You can download and optionally modify EnOcean device interface (XIF) and device type definitions.  You can also manually create custom EnOcean XIF and device type definitions.  To download and modify EnOcean device interface (XIF) and device type definitions, follow these steps:

  1. To download EnOcean XIF definitions, download the EnOcean device type package (.dtp) files from the SmartServer GitHub Repository  You can optionally modify the EnOcean XIF files to hide selected datapoints.

  2. To create a custom EnOcean XIF definition (.eno), see (Optional) Creating a Local EnOcean Device Interface (XIF) Definition.

  3. To create a custom EnOcean device type definition (.dtd), see Defining Device Types.

  4. Import the EnOcean device interface (XIF) and device type definitions using the Import / Export button () on the SmartServer app bar.



    When the EnOcean XIF and device type definitions are loaded, the device type definitions will appear in the Device Types widget.



  5. Define datapoint properties for any datapoints to be monitored or logged as described in Setting Datapoint Properties.

Using Discovery to Add an EnOcean Double Rocker Device

To add an EnOcean double rocker device using discovery, follow these steps:

  1. Plug the EnOcean USB network interface into an available SmartServer USB drive.



  2. Open the SmartServer IoT CMS.

  3. Open the Devices widget.



  4. Click the Discover () button.



    A confirmation dialog box appears indicating that discovery may take up to 40 minutes to complete.



  5. Click OK to start device discovery.

  6. Press the EnOcean double rocker switch to activate it.

  7. The discovered device appears in the Devices widget.

  8. Once discovery is finished, click the device's Action button () and select the Provision action.

    If discovery continues to run, reboot the SmartServer. The devices will appear in the unprovisioned (blue) state in the Devices widget.



    The provisioned device appears in the Devices widget.

Manually Adding an EnOcean Multisensor (STM) Device

To add an EnOcean multisensor (STM) manually, follow these steps:

  1. Plug the EnOcean USB network interface into an available SmartServer USB drive.



  2. Open the SmartServer IoT CMS.

  3. Open the Devices widget.



  4. Click the Create () button.



    The Create Edge Devices view appears.



  5. Enter the following information for the device:

    • Name â€“ enter a name for the device
    • UID â€“ enter the ID that is printed on the back of the device (e.g., 04208BA6)



    • Integration method â€“ select Manual assignment 
    • Driver â€“ select enocean
    • Device Type â€“ select STM550-V1-1




  6. Click Save.

    The manually added device appears in the Devices widget.



  7. Click the device's Action button () and select the Provision action.



    The provisioned device appears in the Devices widget.