{"type":"doc","content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Remote EnOcean Interface (Beta) is supported with SmartServer 4.3 Update 1 and higher.","type":"text","marks":[{"type":"em"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"For SmartServer IoT, see ","type":"text"},{"text":"(Optional) Add a Remote EnOcean Interface (Beta) for SmartServer IoT","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/393677097"}}]},{"text":".","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Support for EnOcean devices is available in following interface modes:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remote EnOcean","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":" (beta) – EnOcean devices are supported in","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":" remote mode","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":" 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 ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"local EnOcean radio","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/142057141"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Local EnOcean","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":" – EnOcean devices are supported in","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":" local mode","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":" with SmartServer 4.0 and higher. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"For local mode, t","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"he EnOcean driver supports the EnOcean USB 300 (868MHz for Europe), USB 500U (902MHz for North America), and USB 500J (928 MHz for Japan) ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"network interfaces","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/142057141"}}]},{"text":". Local mode uses the local EnOcean radio and does not require any remote interfaces. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"For local EnOcean interface, see ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"(Optional) Add a Local EnOcean Interface","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/393676817"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"paragraph","content":[{"text":"This section describes how you can use the SmartServer to integrate and manage EnOcean devices in ","type":"text"},{"text":"remote mode","type":"text","marks":[{"type":"strong"}]},{"text":" and consists of the following:","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"3"}},"macroMetadata":{"macroId":{"value":"55a9b664-045f-4427-8897-3a050c60f8af"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"f1e4f94d-ddde-4e08-8a9b-bdf9969ec37a"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Setting up Remote EnOcean Interface","type":"text"}]},{"type":"paragraph","content":[{"text":"To set up and use remote EnOcean interface with the SmartServer, follow these steps:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enable remote mode on your SmartServer","type":"text"},{"text":" as described in the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Enabling Remote Mode","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" section on this page. Do ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"not","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" use the EnOcean Configuration page to enable remote mode; for this release, remote mode is configured manually as described on this page. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optionally add an EnOcean network interface as described in the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Adding an EnOcean Network Interface","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" section on this page.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download and modify, or create an EnOcean device interface (XIF) and device type definition as described in the ","type":"text"},{"text":"Downloading and Creating EnOcean Device Interface (XIF) and Device Type Definitions","type":"text","marks":[{"type":"strong"}]},{"text":" section on this page.","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define datapoint properties for any datapoints to be monitored or logged as described in ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Setting Datapoint Properties","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/915711438"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add or discover devices as described in ","type":"text"},{"text":"Site Provisioning","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/44959510"}}]},{"text":". See the step-by-step example in the ","type":"text"},{"text":"Adding Remote EnOcean Devices","type":"text","marks":[{"type":"strong"}]},{"text":" section on this page.","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optionally, provide a BACnet interface for your EnOcean device; see ","type":"text"},{"text":"Setting up the BACnet Server","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/209403363"}}]},{"text":". This enables you to use a BACnet workstation with your EnOcean device.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Enabling Remote Mode","type":"text"}]},{"type":"paragraph","content":[{"text":"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.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"To enable remote EnOcean interface, perform the following steps:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"O","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"pen the SmartServer Configuration page as described in ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Accessing the SmartConnect Configuration Page","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/348193250"}}]},{"text":". The Configuration page view that appears depends on your cache data. As needed, click the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"SmartServer IoT","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" tab. The System tab (top) will appear as the default as shown below.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":800,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2474,"alt":"image-20250210-221743.png","id":"12e88c70-f9a0-435e-80fa-c7887a0a534c","collection":"contentId-538968393","type":"file","height":1144},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"EnOcean","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" tab. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":800,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2472,"alt":"image-20250210-221650.png","id":"e01c2b52-a720-4ff3-bd04-b3613cce74cf","collection":"contentId-538968393","type":"file","height":782},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If local EnOcean interface is enabled as shown below, then set the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Enabled","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" option to disabled (greyed-out) and click ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Update","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":800,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2482,"alt":"image-20250210-221628.png","id":"34a8fb7b-041f-4767-9a7b-0b3f41f7566c","collection":"contentId-538968393","type":"file","height":924},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open a terminal connection to SmartConnect.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify that the local EnOcean interface (","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"enocean","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":") and remote EnOcean interface (","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"iotcid","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":") are inactive by entering the following command:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","content":[{"text":"smartserverctl status enocean iotcid","type":"text"}]},{"type":"paragraph","content":[{"text":"Example result:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"enocean inactive\niotcid inactive","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the interface(s) is active, then stop and disable the interface(s)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":" by entering the following commands","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":":","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"codeBlock","content":[{"text":"sudo smartserverctl stop \nsudo smartserverctl disable ","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the remote mode configuration file by entering the following command, followed by the apollo password:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"codeBlock","content":[{"text":"sudo nano /var/smartserver/conf.d/iotcid/iotcid.conf","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configure and save the remote interface ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"mqtt","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":" and ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"iotc ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":"(API) settings as shown in the example below. The ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"mqtt ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":"parameters define the connection information and authentication credentials to the MQTT broker of IoTC. The ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"clientid","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" parameter provides a way to identify your specific connection. The ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"iotc","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" parameters define the connection information and authentication credentials to the REST API of IoTC. Depending on your environment, the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"mqtt","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" and ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"iotc","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" credentials (username and password) may be the same or different. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"iotc","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" settings may need to be added to the file following the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"mqtt ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":"settings, where the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"x","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":"'s define the remote server address and login credentials in the example below.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","content":[{"text":"\"iotc\":{\"address\":\"xx.xxxxxxx.xxxxx\",\"username\":\"xxxxxxx\",\"password\":\"xxxxxxxxxx\",\"insecure\":true},","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If your IoTC instance is ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"not","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":" using security on the MQTT side, then remove the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"“username”","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":" and ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"“password”","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":" parameters and from the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"mqtt","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":" settings section in the","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":" iotcid.conf","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":" file.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you are updating from SmartServer 4.3 or 4.3 Update 1 to SmartServer 4.4, then change the parameter ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"keep_alive","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":" to ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"keepalive","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you have more than one SmartServer connecting to a given IoTC instance, then specify a unique ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"clientid ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":"for each SmartServer. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Every client that connects to the same IoTC instance must have a unique ","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"clientid","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":".","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":600,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1610,"alt":"image-20250210-221556.png","id":"30977dd8-f1c7-4ce4-b97a-5827dfb02e05","collection":"contentId-538968393","type":"file","height":1208},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start the remote EnOcean interface (","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"iotcid","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":"), and enable it so that it will start automatically after reboot, by entering the following commands:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","content":[{"text":"sudo smartserverctl start iotcid\nsudo smartserverctl enable iotcid","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify that the remote EnOcean interface (","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"iotcid","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":") is enabled by entering the following command:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","content":[{"text":"smartserverctl status iotcid","type":"text"}]},{"type":"paragraph","content":[{"text":"Example result:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"iotcid active since Fri 2024-04-19 15:50:14 EDT; 6s ago","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The remote EnOcean interface is now enabled on your SmartConnect.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Adding an EnOcean Network Interface","type":"text"}]},{"type":"paragraph","content":[{"text":"You can optionally attach an EnOcean USB network interface to your SmartServer to add support for communicating with your EnOcean devices. See ","type":"text"},{"text":"USB 300, 300U, 400J, and 500U EnOcean Network Interfaces","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/142057141"}}]},{"text":". ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":300,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":670,"id":"dde1f184-1c78-4e63-86e5-af92c332696e","collection":"contentId-538968393","type":"file","height":330}}]},{"type":"paragraph","content":[{"text":"If a local EnOcean radio is used, then follow the steps below to configure","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" Local Antenna Tunnel","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"},{"type":"em"}]},{"text":" settings using the SmartServer EnOcean Configuration page.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Plug the ","type":"text"},{"text":"EnOcean USB network interface","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/142057141"}}]},{"text":" into an available SmartServer USB drive.","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"O","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"pen the SmartServer Configuration page as described in ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Accessing the SmartConnect Configuration Page","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/348193250"}}]},{"text":". The Configuration page view that appears depends on your cache data. As needed, click the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"SmartServer IoT","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" tab. The System tab (top) will appear as the default as shown below.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":910,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2474,"alt":"image-20250210-221500.png","id":"680dc842-e3de-4aa8-b36e-0ed025312722","collection":"contentId-538968393","type":"file","height":1144},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"EnOcean","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" tab and","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" configure the ","type":"text"},{"text":"Local Antenna Tunnel ","type":"text","marks":[{"type":"strong"}]},{"text":"settings as follows:","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":800,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1280,"id":"df191199-2f3e-4262-866c-35ef34575c31","collection":"contentId-538968393","type":"file","height":615},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"Enabled ","type":"text","marks":[{"type":"strong"}]},{"text":"option to enabled status.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"Auth URL ","type":"text","marks":[{"type":"strong"}]},{"text":"to the EnOcean IoTC cloud URL as supplied by your IoTC provider. Use ","type":"text"},{"text":"https:// ","type":"text","marks":[{"type":"strong"}]},{"text":"at the beginning of Auth URL setting.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use the ","type":"text"},{"text":"Host DEV ","type":"text","marks":[{"type":"strong"}]},{"text":"pulldown menu to define the SmartServer USB where the EnOcean radio is connected. To determine which port is being used, enter the following command from a","type":"text"},{"text":" terminal connection to SmartConnect:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","content":[{"text":"sudo ls -l /dev/serial/by-id/ | grep usb-EnOcean_GmbH","type":"text"}]},{"type":"paragraph","content":[{"text":"A response similar to the one shown below is returned, where the port in the example below is ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"ttyUSB0","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":":","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","content":[{"text":"lrwxrwxrwx 1 root root 13 Mar 17 14:48 usb-EnOcean_GmbH_USB_500U_DA_EO6TD13G-if00-port0 -> ../../ttyUSB0","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"Username ","type":"text","marks":[{"type":"strong"}]},{"text":"to the EnOcean IoTC username credentials.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"Password ","type":"text","marks":[{"type":"strong"}]},{"text":"to the EnOcean IoTC password credentials.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"Client ID ","type":"text","marks":[{"type":"strong"}]},{"text":"to a user-defined client identifier (e.g., ","type":"text"},{"text":"userStarterKit","type":"text","marks":[{"type":"strong"}]},{"text":"). ","type":"text"},{"text":"If you have more than one tunnel within the same IoTC instance, then specify a unique ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Client ID ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":"for each tunnel. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Every client that connects to the same IoTC instance must have a unique ","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Client ID","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"strong"}]},{"text":".","type":"text","marks":[{"type":"underline"},{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"Identifier ","type":"text","marks":[{"type":"strong"}]},{"text":"to your SmartServer MAC ID without the colons (e.g., ","type":"text"},{"text":"00d0710d29b5","type":"text","marks":[{"type":"strong"}]},{"text":"). You can find your SmartServer MAC ID on the SmartServer System Configuration page. See ","type":"text"},{"text":"Viewing System Information","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/287506829"}}]},{"text":".","type":"text"},{"type":"hardBreak"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Update ","type":"text","marks":[{"type":"strong"}]},{"text":"to save the local antenna tunnel configuration.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Downloading and Creating EnOcean Device Interface (XIF) and Device Type Definitions","type":"text"}]},{"type":"paragraph","content":[{"text":"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:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To download EnOcean XIF definitions, download the EnOcean device type package (","type":"text"},{"text":".dtp","type":"text","marks":[{"type":"strong"}]},{"text":") files from the ","type":"text"},{"text":"SmartServer GitHub Repository","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/izot/smartserver-iot/tree/master/resources/enocean"}}]},{"text":" You can optionally modify the EnOcean XIF files to hide selected datapoints.","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To create a custom EnOcean XIF definition (","type":"text"},{"text":".iotc","type":"text","marks":[{"type":"strong"}]},{"text":"), see ","type":"text"},{"text":"(Optional) Creating a Remote EnOcean Device Interface (XIF) Definition","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/394006786"}}]},{"text":".","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To create a custom EnOcean device type definition (","type":"text"},{"text":".dtd","type":"text","marks":[{"type":"strong"}]},{"text":"), see ","type":"text"},{"text":"Defining Device Types","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/43817435"}}]},{"text":".","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you were previously configured for EnOcean interface local mode, then ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"open the SmartConnect CMS","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/347865637"}}]},{"text":" and remove local EnOcean interface device types from the Device Types widget. Se","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"e ","type":"text"},{"text":"Defining Device Types","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/43817435"}}]},{"text":".","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Import the EnOcean device interface (XIF) and device type definitions using the Import / Export button (","type":"text"},{"type":"mediaInline","attrs":{"width":52,"id":"db5dec41-4233-47d2-8ecd-ceb15d64ea6c","collection":"contentId-538968393","type":"image","height":48}},{"text":") on the SmartServer app bar.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":532,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1020,"id":"408e8715-3771-4c2a-af86-8ae701a85e47","collection":"contentId-538968393","type":"file","height":954},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"When the EnOcean XIF and device type definitions are loaded, the device type definitions will appear in the Device Types widget.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":800,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1280,"id":"55fbc7ba-bd58-4796-b8e3-bebbd2ac8c91","collection":"contentId-538968393","type":"file","height":567},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define datapoint properties for any datapoints to be monitored or logged as described in ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Setting Datapoint Properties","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/915711438"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Adding Remote EnOcean Devices","type":"text"}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the SmartConnect CMS","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/347865637"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the Devices widget.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":800,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1280,"id":"0b8be258-fd56-46f7-889c-10e1dd13c473","collection":"contentId-538968393","type":"file","height":310},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you were previously configured for EnOcean interface local mode, then remove the EnOcean","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" devices from the Devices widget. See ","type":"text"},{"text":"Discovering, Defining, or Importing Devices","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/44893098"}}]},{"text":".","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you are manually adding EnOcean devices, then define the Create Edge Devices fields as shown in the example below. See ","type":"text"},{"text":"Discovering, Defining, or Importing Devices","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/44893098"}}]},{"text":". ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":" – enter a name for the device","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"UID","type":"text","marks":[{"type":"strong"}]},{"text":" – enter the ID that is printed on the back of the device (e.g., ","type":"text"},{"text":"04208BA6","type":"text","marks":[{"type":"strong"}]},{"text":"). Use the 8 least significant bytes of the ID.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":200,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":640,"alt":"image-20250210-221251.png","id":"cee65da4-8ac4-4e70-90b6-1d0abdd6d906","collection":"contentId-538968393","type":"file","height":635},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Integration method","type":"text","marks":[{"type":"strong"}]},{"text":" – select ","type":"text"},{"text":"Manual assignment ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Driver","type":"text","marks":[{"type":"strong"}]},{"text":" – select ","type":"text"},{"text":"iotc","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Device Type ","type":"text","marks":[{"type":"strong"}]},{"text":"– select the device type (e.g., ","type":"text"},{"text":"STM550-V1-1","type":"text","marks":[{"type":"strong"}]},{"text":")","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"The devices are added and automatically provisioned.","type":"text"},{"type":"hardBreak"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you are adding EnOcean devices using IoTC, then click the Discover button (","type":"text"},{"type":"mediaInline","attrs":{"width":44,"id":"11bd4841-818e-416d-85b9-74f80437e019","collection":"contentId-538968393","type":"image","height":40}},{"text":") on the Devices widget.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":800,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1280,"id":"57089a7b-8074-4e8c-b0ed-40e0ca1a9efc","collection":"contentId-538968393","type":"file","height":310},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"A confirmation dialog box appears indicating that discovery may take up to 40 minutes to complete.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":400,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":962,"id":"34951d11-d6a9-4d60-92d0-8fc598b972bb","collection":"contentId-538968393","type":"file","height":298},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"OK ","type":"text","marks":[{"type":"strong"}]},{"text":"to start device discovery.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"The discovered remote EnOcean devices appear in the Devices widget.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":800,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2422,"alt":"image-20250210-221131.png","id":"639ad013-ed88-40dc-af1e-4b2428afd4a5","collection":"contentId-538968393","type":"file","height":1074},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The discovered remote EnOcean devices are automatically provisioned.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":800,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2422,"alt":"image-20250210-221055.png","id":"e799596b-e03d-4be5-a937-4b079916ddc1","collection":"contentId-538968393","type":"file","height":1076},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

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

","nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"If you discover remote EnOcean devices, removing them using the SmartServer CMS Devices widget removes the devices ","type":"text"},{"text":"from the remote server","type":"text","marks":[{"type":"underline"}]},{"text":". ","type":"text"}]}]}],"version":1}}}},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If discovery continues to run, perform the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For SmartServer 4.4 and higher, click the Stop button (","type":"text"},{"type":"mediaInline","attrs":{"width":40,"alt":"image-20250210-221027.png","id":"b73c763f-9fac-4ac4-8e5e-be2037cbd707","collection":"contentId-538968393","type":"image","height":40}},{"text":" ) as described in ","type":"text"},{"text":"Discovering, Defining, or Importing Devices","type":"text","marks":[{"type":"link","attrs":{"href":"https://enoceanwiki.atlassian.net/wiki/spaces/IEC/pages/44893098"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For SmartServer 4.3 and prior, reboot SmartConnect. ","type":"text"}]}]}]}]}]},{"type":"paragraph"},{"type":"paragraph"}],"version":1}

Browser not supported