/
(Optional) Add a Local EnOcean Interface

(Optional) Add a Local EnOcean Interface

Local EnOcean Interface is supported with SmartServer 4.0 and higher.

For SmartServer 4.1 and prior, see (Optional) Add an EnOcean Interface (Release 4.1 and Prior).

You can use the SmartServer to integrate and manage EnOcean devices in local mode. For local mode, the EnOcean driver supports the EnOcean USB 300 (868MHz for Europe), USB 500U (902MHz for North America), and USB 500J (928 MHz for Japan) network interfaces. Local mode uses the local EnOcean radio and does not require any remote interfaces.

This section describes how to configure and use the SmartServer in local EnOcean mode and consists of the following:

Setting up Local EnOcean Interface

To set up and use local EnOcean interface with the SmartServer, follow these steps:

  1. Add an EnOcean network interface as described in the Adding an EnOcean Network Interface section on this page.

  2. Enable local EnOcean mode on your SmartServer as described in the Enabling the EnOcean Driver section on this page. With SmartServer 4.2 and higher, the EnOcean driver is enabled by default for SmartServer IoT and disabled for SmartConnect.
     

  3. Download and modify (as needed ), or create an EnOcean device interface (XIF) and device type definition as described in the Downloading and Creating EnOcean Device Interface (XIF) and Device Type Definitions section on this page.

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

  5. Define or discover, and provision devices as described in Site Provisioning.  See the step-by-step examples in the following sections on this page:

    • Using Discovery to Add an EnOcean Double Rocker Device

    • Manually Adding an EnOcean Multisensor (STM) Device

  6. 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.

Adding an EnOcean Network Interface

To add support for communicating with EnOcean devices, attach an EnOcean USB network interface to your SmartServer IoT or SmartConnect. See USB 300, 300U, 400J, and 500U EnOcean Network Interfaces. 

Enabling the EnOcean Driver

With SmartServer 4.2 and higher, the EnOcean driver is enabled by default for SmartServer IoT and disabled by default for SmartConnect. 

To verify that the EnOcean driver is enabled, or to enable it if it is disabled, follow these steps:

  1. Open the SmartServer Configuration page as described in Accessing the SmartServer IoT Configuration Page. The Network tab appears as the default SmartServer IoT Configuration page. Once the network settings are configured for the SmartServer system, then the System tab will appear as the default.

    image-20250331-015800.png
    SmartServer IoT Network Tab

     

    image-20250327-230448.png
    SmartServer IoT System Tab


    For SmartConnect, open the SmartServer Configuration page as described in Accessing the SmartConnect Configuration Page. The Configuration page view that appears depends on your cache data. As needed, click the SmartServer IoT tab. The System tab (top) will appear as the default as shown below.

    image-20250327-230611.png
    SmartConnect System Tab

     

  2. Click the EnOcean tab. The EnOcean driver is enabled by default for SmartServer IoT and disabled by default for SmartConnect.

    image-20250327-230743.png
    SmartServer IoT EnOcean Tab

    image-20250327-231039.png
    SmartConnect EnOcean Tab

  3. Set the EnOcean driver to Enabled as needed.

  4. Click Local to set the mode option. For local mode, the EnOcean driver supports the EnOcean USB 300 (868MHz for Europe), USB 500U (902MHz for North America), and USB 500J (928 MHz for Japan) network interfaces. Local mode uses the local EnOcean radio and does not require any remote interfaces.

    image-20250327-230743.png
    SmartServer IoT EnOcean Tab

     

    image-20250327-231238.png
    SmartConnect EnOcean Tab

  5. Click Update to save the configuration.

Local EnOcean interface is now enabled on your SmartServer IoT / SmartConnect.

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. If you are downloading EnOcean XIF definitions, then 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. If you are creating a custom EnOcean XIF definition (.eno), then see (Optional) Creating a Local EnOcean Device Interface (XIF) Definition.

  3. If you are creating a custom EnOcean device type definition (.dtd), then see Defining Device Types.

  4. If you were previously configured for EnOcean remote mode, then open the SmartServer IoT CMS / open the SmartConnect CMS and remove remote EnOcean interface device types (.iotc) from the Device Types widget. See Defining Device Types.

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


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

     

  6. 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 or open the SmartConnect CMS.

  3. If you were previously configured for EnOcean remote mode, then remove remote EnOcean interface device types (.iotc) from the Device Types widget. See Defining Device Types.

  4. Import .eno device types using the CMS Import/Export dialog. See Discovering, Defining, or Importing Devices.

  5. Open the Devices widget.

     

  6. Click the Discover () button. See Discovering, Defining, or Importing Devices for more information about using the discovery feature.

     

  7. Once discovery is started, press the EnOcean double rocker switch to activate it.

    The discovered device appears in the Devices widget.

     

  8. Once discovery is finished, click the device's Action button (image-20250213-224449.png) and select the Provision action. 
    If discovery continues to run, reboot the SmartServer IoT or SmartConnect.


    The provisioned devices appear 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 or open the SmartConnect CMS.

  3. If you were previously configured for EnOcean remote mode, then remove remote EnOcean interface device types (.iotc) from the Device Types widget. See Defining Device Types.

  4. Import .eno device types using the CMS Import/Export dialog. See Discovering, Defining, or Importing Devices.

  5. Open the Devices widget.

     

  6. Click the Create () button.


    The Create Edge Devices view appears.

     

  7. 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

     

     

  8. Click Save.

    The manually added device appears in the Devices widget.

     

  9. Click the device's Action button (image-20250213-224449.png) and select the Provision action.


    The provisioned devices appear in the Devices widget.