Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Remote EnOcean interface (beta) is supported with SmartServer 4.3 Update 1 and higher.
Info

For SmartServer Pi, see (Optional) Add a Remote EnOcean Interface (Beta) for SmartServer Pi.

...

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. Do not use the EnOcean Configuration page to enable remote mode; for this release, remote mode is configured manually as described on this 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:
  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.

...

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

    The settings that you configured in the iotcid.conf file appear in the Remote server settings area.



  4. Click Install Local Antenna Tunnel.



    The Local Antenna Tunnel settings appear.



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


      SmartServer IoT 4.4 and higher


      SmartServer IoT 4.3 Update 1 

  6. Click Update to save the local antenna tunnel configuration. 

...

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

...