...

REMOTE ENOCEAN INTERFACE (BETA) IS SUPPORTED WITH SMARTSERVER 4.3 UPDATE 1 AND HIGHER.

Support for EnOcean devices is available in following interface modes:

• Remote EnOcean (beta) – EnOcean devices are supported in remote mode with SmartServer 4.3 Update 1 and higher. For remote mode, the EnOcean driver supports EnOcean IoT Connector (IoTC) as an EnOcean network interface. Remote mode uses a remote connection to IoTC, and supports a local EnOcean radio with a web security service (WSS) tunnel to IoTC. Remote mode works with or without a local EnOcean radio.
  
  
• Local EnOcean – EnOcean devices are supported in local mode with SmartServer 4.0 and higher. 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.

...

•  
  
  For local EnOcean interface, see (Optional) Add a Local EnOcean Interface.

This section describes how you can use the SmartServer to integrate and manage EnOcean devices in remote mode. This section describes how to get started using remote EnOcean interface and consists of the following:

For local EnOcean interface, see (Optional) Add a Local EnOcean Interface.

Setting up Remote EnOcean Interface

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

...

1. Enable remote mode on your SmartServer as described on this page. For SmartServer IoT 4.3, do Do not use the EnOcean Configuration page to enable remote mode; for this release, remote mode is configured manually as described on this page. If a local EnOcean radio is used, then you will also configure Local Antenna Tunnel settings using the SmartServer EnOcean Configuration page
   
   
2. Optionally add an EnOcean network interface as described on this page.
    
3. Download and modify, or create an EnOcean device interface (XIF) and device type definition as described 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 devices as described in Site Provisioning. See the following section on this page for a step-by-step example as described on this page:
   • Adding Remote EnOcean Devices
     
     
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.

...

Enabling Remote Mode

With SmartServer 4.3 Update 1 and higher, EnOcean IoTC is supported as an EnOcean network interface, where EnOcean devices can be accessed through EnOcean WSS tunnel via access points, gateways, and SmartServers.

You can also optionally attach an EnOcean USB network interface to your SmartServer to add support for communicating with your EnOcean devices. See USB 300, 300U, 400J, and 500U EnOcean Network Interfaces. If a local EnOcean radio is used, then you will also configure Local Antenna Tunnel settings using the SmartServer EnOcean Configuration page as described in the next section.

Image Removed

Enabling Remote Mode

Perform the following steps to enable remote EnOcean interface.

...

To enable remote EnOcean interface, perform the following steps:

1. Open a terminal connection to SmartServer IoT.
   
   

2. If the local EnOcean interface (enocean) was previously enabled, then stop the service, and disable it so that it will not start automatically after reboot, by entering the following commands:
   

   Code Block
   sudo smartserverctl stop enocean sudo smartserverctl disable enocean

   
   

3. Verify that the local EnOcean interface (enocean) and remote EnOcean interface (iotcid) are inactive by entering the following command:
   

   Code Block
   smartserverctl status enocean iotcid

   
   

   Code Block
   title Example result:
   enocean                            inactive iotcid                             inactive

   
   

4. If the interface(s) is active, then stop and disable the interface(s) by entering the following commands:
   

   Code Block
   sudo smartserverctl stop <enocean> <iotcid> sudo smartserverctl disable <enocean> <iotcid>

   
   

5. Edit the remote mode configuration file by entering the following command, followed by the apollo password:
   

   Code Block
   title SmartServer IoT
   sudo nano /var/apollo/conf.d/iotcid/iotcid.conf

   
   

6. Configure and save the remote interface mqtt and iotc (API) settings , including the remote server address and login credentials as shown in the example below.
   Image Removed
   SmartServer IoT example
   If you were previously configured for EnOcean interface local mode, then enter the following commands to stop and disable local EnOcean interface The mqtt parameters define the connection information and authentication credentials to the MQTT broker of IoTC. The clientid parameter provides a way to identify your specific connection. The iotc parameters define the connection information and authentication credentials to the REST API of IoTC. Depending on your environment, the mqtt and iotc credentials (username and password) may be the same or different.
   1. If your IoTC instance is not using security on the MQTT side, then remove the “username” and “password” lines from the mqtt settings section in the iotcid.conf file.
   2. If you are updating from SmartServer 4.3 or 4.3 Update 1 to SmartServer 4.4, then change the parameter keep_alive to keepalive.
   3. If you have more than one SmartServer connecting to a given IoTC instance, then specify a unique clientid for each SmartServer. Every client that connects to the same IoTC instance must have a unique clientid.
      
      Image Added
      SmartServer IoT 4.4 and higher
      
      Image Added
      SmartServer IoT 4.3
      
      

7. Verify that the port you using is open by entering the following command:
   

   Code Block
   sudo smartserverctl stop enocean sudo smartserverctl disable enocean

   Enter the following commands to start and enable remote EnOcean interface

   ufw status

   
   If the port is not allowed, then open the port by entering the command:
   

   Code Block
   sudo ufw allow <port number>

   
   

8. Start the remote EnOcean interface (iotcid), and enable it so that it will start automatically after reboot, by entering the following commands:
   

   Code Block
   sudo smartserverctl start iotcid sudo smartserverctl enable iotcid

   
   

9. Enter the following command to verify that the enocean process (local mode) is inactive and iotcid process (remote mode) is activeVerify that the remote EnOcean interface (iotcid) is active by entering the following command:
   

   Code Block
   sudo smartserverctl status iotcid

   
   

   Code Block
   title Example results to includeresult:
   enocean iotcid                           inactive iotcid                             active since ThuFri 2024-0304-1419 0915:2650:14 EDT; 39s ago6s ago

   
   

The remote EnOcean interface is now enabled on your SmartServer IoT.

Adding an EnOcean Network Interface

With SmartServer 4.3 Update 1 and higher, EnOcean IoTC is supported as an EnOcean network interface, where EnOcean devices can be accessed through EnOcean WSS tunnel via access points, gateways, and SmartServers.

You can also optionally attach an EnOcean USB network interface to your SmartServer to add support for communicating with your EnOcean devices. See USB 300, 300U, 400J, and 500U EnOcean Network Interfaces.

Image Added

If a local EnOcean radio is used, then follow the steps below to configure Local Antenna Tunnel settings using the SmartServer EnOcean Configuration page.

1. Plug the EnOcean USB network interface into an available SmartServer USB drive.
   
   
2. 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.
   
   
   SmartServer IoT Network tab
   
   
   SmartServer IoT System tab
   
   
3. Click the EnOcean tab. 
   Image Removed
   If needed, click the Enabled option and/or select Remote mode.
   The settings that you defined configured in the iotcidthe iotcid.conf conf file will appear for in the SmartServer IoT remote Remote server settings area.
   If you are using a local EnOcean radio, then verify that the EnOcean USB network interface is plugged into an available SmartServer USB drive and configure
   
   Image Added
   
   
4. Click Install Local Antenna Tunnel.
   
   Image Added
   
   The Local Antenna Tunnel settings appear.
   
   Image Added
   
   
5. Configure the Local Antenna Tunnel settings as follows:
   
   
   1. Set the Enabled option to enabled status.
   2. Set Auth URL to the EnOcean IoTC cloud URL as supplied by your IoTC provider. Use https:// at the beginning of Auth URL setting.

   3. Use the Host DEV pulldown menu to set the SmartServer USB where the EnOcean radio is connected. To determine which port is being used, enter the following command from a terminal connection to the SmartServer:

      Code Block
      sudo ls -l /dev/serial/by-id/ | grep usb-EnOcean_GmbH

      A response similar to the one shown below is returned, where the port is ttyUSB0:
      

      Code Block
      lrwxrwxrwx 1 root root 13 Mar 17 14:48 usb-EnOcean_GmbH_USB_500U_DA_EO6TD13G-if00-port0 -> ../../ttyUSB0

      
      

   4. Set Username to the EnOcean IoTC username credentials.
   5. Set Password to the EnOcean IoTC password credentials.
   6. Set Client ID to a user-defined client identifier (e.g., userStarterKit). If you have more than one tunnel within the same IoTC instance, then specify a unique Client ID for each tunnel. Every client that connects to the same IoTC instance must have a unique Client ID.
   7. Set Identifier to your SmartServer MAC ID without the colons (e.g., 00d0710d29b5). You can find your SmartServer MAC ID on the SmartServer System Configuration page. See Viewing System Information.
      Image Removed
      SmartServer IoT example.
   8. Optionally for SmartServer 4.4 and higher, set the Skip TLS and hostname verification  option.
   9. Optionally for SmartServer 4.4 and higher, import the Privacy Enhanced Mail (PEM) certification authority file. 
      
      Image Added
      SmartServer IoT 4.4 and higher
      
      Image Added
      SmartServer IoT 4.3 Update 1 
      
      
6. Click Update to save the remote mode local antenna tunnel configuration. 

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 (.iotc), see (Optional) Creating a Remote EnOcean (Beta) Device Interface (XIF) Definition.
   
   
3. To create a custom EnOcean device type definition (.dtd), see Defining Device Types.
   
   
4. If you were previously configured for EnOcean interface local mode, then open the SmartServer IoT CMS and remove local EnOcean interface device types 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.
   
   
   
   When 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.

Adding Remote EnOcean Devices

Once you have enabled remote mode and imported EnOcean device types, you can manually add EnOcean devices and/or discover EnOcean devices. To add EnOcean devices using remote mode, perform the following steps.

1. Open the SmartServer IoT CMS.
   
   
2. Open the Devices widget.
   
   
   
   
3. If you were previously configured for EnOcean interface local mode, then remove the EnOcean devices from the Devices widget. See Discovering, Defining, or Importing Devices.
   
   
4. If you are manually adding EnOcean devices, then define set the Create Edge Devices fields as shown in the example below. See Discovering, Defining, or Importing Devices. 
   
   
   • Name – enter a name for the device
   • UID – enter the ID that is printed on the back of the device (e.g., 04208BA6). Use the 8 least significant bytes of the ID.
      
     
     
     
   • Integration method – select Manual assignment 
   • Driver – select iotc
   • Device Type – select the device type (e.g., STM550-V1-1)
     
     The devices are added and provisioned.
     
     
5. If you are adding EnOcean devices using IoTC, then click the Discover button () on the Devices widget.
   
   
   A
   
   1. For SmartServer 4.4 and higher, a dialog box appears prompting you to select the device protocol for discovery. Select iotc and then click Discover. See Discovering, Defining, or Importing Devices for more information. When device discovery is finished, click Close.
      
      Image Added
       
   2. For SmartServer 4.3 and prior, a confirmation dialog box appears indicating that discovery may take up to 40 minutes to complete.
   
   Image Removed
   Click 
   1.  Click OK to start device discovery.
      
      Image Added
      

      
      The discovered remote EnOcean devices appear in the Devices widget

   .
   Image Removed
   The discovered remote EnOcean devices

   1. and are automatically provisioned.
      
      Image Modified
      
      

      Warning
      If you discover remote EnOcean devices, removing them using the SmartServer CMS Devices widget removes the devices from the remote server.

      
      

6. If discovery continues to run, perform the following:

   1. For SmartServer 4.4 and higher, click the Stop button (Image Added) as described in Discovering, Defining, or Importing Devices.

   2. For SmartServer 4.3 and prior, reboot the SmartServer IoT.