SmartServer IoT¶

Overview¶

The EnOcean SmartServer IoT is an edge controller providing connectivity for EnOcean radio devices and integration with Building Management Systems (BMS) and HVAC systems via BACnet, Modbus, and LON protocols. Installed on-premises, the SmartServer IoT enables secure connections between Operational Technology (OT) systems, IT systems, and the EnOcean SmartStudio platform.

The following describes how to configure the SmartServer IoT to pull data from SmartStudio and integrate it into Building Management Systems (BMS) and HVAC systems. How to configure the SmartServer IoT as a gateway for connecting EnOcean radio devices with SmartStudio is described here.

Prerequisites¶

Before deployment, ensure the following prerequisites are met:

1. The SmartServer is mounted and powered up.
2. The SmartServer is connected to the internet.
3. The SmartServer BACnet driver is enabled.

Configuration¶

Step 1: Retrieve SmartStudio Connection Information¶

1. Retrieve the MQTT Password from SmartStudio:
   
   • Go to the Integrations section.
     
   • Select SmartServer.
     
   • Copy the information:

     

Step 2: Log in to the SmartServer configuration page¶

1. Open a web browser and navigate to the SmartServer's configuration page.

2. Log in using your apollo user credentials.

   

Step 3: Navigate to the EnOcean Tab¶

1. Once logged in, go to the EnOcean tab in the SmartServer configuration page.

   

Step 4: Configure the SmartStudio Connection¶

1. Select the Remote With SmartStudio mode.
2. In the Enocean SmartStudio section, enter the information retrieved from SmartStudio above.

3. Click Update to enable remote mode with SmartStudio on your SmartServer IoT.

   

Step 5: Downloading EnOcean Device Interface (XIF) and Device Type Definitions¶

1. Log in to SmartServer CMS:

   

2. Visit the SmartServer GitHub repository.

3. Navigate to the appropriate region folder based on your deployment:
   • EU/Remote for European region
   • US/Remote for United States region
   • JP/Remote for Japanese region
4. Download the required .dtp (Device Type Package) and .btm (BACnet Type Mapping) files from the selected region remote folder.

5. Import the downloaded files in the step above 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.

Step 6: Adding Remote EnOcean Devices¶

Once you have enabled remote mode and imported EnOcean device types, you can discover the EnOcean devices following below:

1. Open the devices widget.
2. Click the Discover button.

3. The Discover Devices dialog box appears as shown in the example below. Deselect all the options and keep only the iotc driver then click discover.

   

Step 7: Discover EnOcean Devices from a BACnet workstation¶

You can view and interact with the EnOcean devices connected to your SmartStudio account using a BACnet client. The following is an example of this using Yabe:

1. Launch Yabe.
2. Click Add device (Search).
3. Under BACnet/IP, set the Local endpoint to your computer’s IP address and use port BAC0. Click Start.
4. In the top menu, navigate to Functions → IP Services → Foreign Device Registration.

5. Enter the following details:

   • Remote IPv4 address: Set this to your SmartServer’s IP address for the eth0 network interface.
   • Port: If you are using a BACnet MS/TP Router with your SmartServer IoT on the LAN port, the port number can be found under the BACnet tab in the SmartServer configuration UI. The default port is 47809 (labeled as BAC1 by default).

   

   6. Click Register.

Once registered, all SmartServer devices and any SmartStudio devices for which .btm files have been imported will appear in Yabe under BACnet devices, allowing you to browse and interact with them.